numpy.fft --- إجراءات تحويل فورييه السريع

يوفّر الوحدة الفرعية numpy.fft إجراءات تحويل فورييه السريع أحادي البعد. يجب أن يكون طول المصفوفة المُدخلة قوة للعدد 2؛ وإلا فسيُطلق الاستثناء ValueError.

عندما يُبنى ulab بدون دعم الأعداد المركبة، يُحتفظ بالجزأين الحقيقي والتخيّلي للتحويل في كائنين منفصلين من النوع numpy.ndarray، وتُرجع الدوال زوجاً ثنائياً (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، تحتوي على الجزء التخيّلي من الإدخال. وإذا حُذفت، فيُفترض أن الجزء التخيّلي يساوي صفراً.

تُرجع:

زوجاً ثنائياً (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، تحتوي على الجزء التخيّلي من الطيف. وإذا حُذفت، فيُفترض أن الجزء التخيّلي يساوي صفراً.

تُرجع:

زوجاً ثنائياً (real, imag) من كائنات numpy.ndarray يحمل الجزأين الحقيقي والتخيّلي للتحويل العكسي. والنتيجة مُعيّرة بالعدد N (عدد العيّنات)، بحيث يُعيد ifft(fft(x)) إنتاج الإدخال الأصلي.

يُطلق:

ValueError -- إذا لم يكن طول الإدخال قوة للعدد اثنين.

عندما يُترجَم ulab مع ضبط ULAB_SUPPORTS_COMPLEX و ULAB_FFT_IS_NUMPY_COMPATIBLE على القيمة 1، تأخذ الدالة مصفوفة واحدة (قد تكون مركبة) وتُرجع مصفوفة مركبة.