numpy.fft — שגרות התמרת פורייה מהירה

תת-המודול numpy.fft מספק שגרות התמרת פורייה מהירה חד-ממדיות. אורך מערך הקלט חייב להיות חזקה של 2; אחרת מורמת חריגת ValueError.

כאשר ulab נבנה ללא תמיכה במספרים מרוכבים, החלק הממשי והחלק המדומה של ההתמרה נשמרים באובייקטים נפרדים מסוג numpy.ndarray, והפונקציות מחזירות זוג (2-tuple) (real, imag). כאשר ulab נבנה עם האפשרויות ULAB_SUPPORTS_COMPLEX ו-ULAB_FFT_IS_NUMPY_COMPATIBLE מאופשרות, השגרות מקבלות ומחזירות מערכים מרוכבים באופן תואם ל-numpy.

פונקציות

numpy.fft.fft(r: ndarray, c: ndarray | None = None) tuple[ndarray, ndarray]

חישוב התמרת פורייה הבדידה החד-ממדית של r.

פרמטרים:
  • r – מערך חד-ממדי שאורכו הוא חזקה של שתיים. מחזיק את החלק הממשי של אות הקלט.

  • c – מערך חד-ממדי אופציונלי באותו אורך כמו r, המכיל את החלק המדומה של הקלט. אם הושמט, מניחים שהחלק המדומה הוא אפס.

החזרות:

זוג (2-tuple) (real, imag) של אובייקטים מסוג numpy.ndarray המחזיקים את החלק הממשי והמדומה של ההתמרה.

מרים:

ValueError – אם אורך הקלט אינו חזקה של שתיים.

כאשר ulab מהודר עם ULAB_SUPPORTS_COMPLEX ו-ULAB_FFT_IS_NUMPY_COMPATIBLE מוגדרים ל-1, הפונקציה מקבלת במקום זאת מערך יחיד (אפשר שמרוכב) ומחזירה מערך מרוכב, באותו אופן כמו numpy.fft.fft.

numpy.fft.ifft(r: ndarray, c: ndarray | None = None) tuple[ndarray, ndarray]

חישוב התמרת פורייה הבדידה ההפוכה החד-ממדית.

פרמטרים:
  • r – מערך חד-ממדי שאורכו הוא חזקה של שתיים. מחזיק את החלק הממשי של הספקטרום.

  • c – מערך חד-ממדי אופציונלי באותו אורך כמו r, המכיל את החלק המדומה של הספקטרום. אם הושמט, מניחים שהחלק המדומה הוא אפס.

החזרות:

זוג (2-tuple) (real, imag) של אובייקטים מסוג numpy.ndarray המחזיקים את החלק הממשי והמדומה של ההתמרה ההפוכה. התוצאה מנורמלת ב-N (מספר הדגימות), כך ש-ifft(fft(x)) משחזר את הקלט המקורי.

מרים:

ValueError – אם אורך הקלט אינו חזקה של שתיים.

כאשר ulab מהודר עם ULAB_SUPPORTS_COMPLEX ו-ULAB_FFT_IS_NUMPY_COMPATIBLE מוגדרים ל-1, הפונקציה מקבלת מערך יחיד (אפשר שמרוכב) ומחזירה מערך מרוכב.