numpy.fft — Rotinas de Transformada Rápida de Fourier

O submódulo numpy.fft fornece rotinas unidimensionais de Transformada Rápida de Fourier. O comprimento do array de entrada deve ser uma potência de 2; caso contrário, um ValueError é levantado.

Quando o ulab é compilado sem suporte a números complexos, as partes real e imaginária da transformada são mantidas em objetos numpy.ndarray separados, e as funções retornam uma 2-tupla (real, imag). Quando o ulab é compilado com as opções ULAB_SUPPORTS_COMPLEX e ULAB_FFT_IS_NUMPY_COMPATIBLE habilitadas, as rotinas aceitam e retornam arrays complexos de maneira compatível com o numpy.

Funções

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

Calcula a Transformada Discreta de Fourier unidimensional de r.

Parâmetros:

  • r – um array unidimensional cujo comprimento é uma potência de dois. Contém a parte real do sinal de entrada.

  • c – um array unidimensional opcional, com o mesmo comprimento de r, contendo a parte imaginária da entrada. Se omitido, a parte imaginária é considerada zero.

Retorna:

uma 2-tupla (real, imag) de objetos numpy.ndarray contendo as partes real e imaginária da transformada.

Levanta:

ValueError – se o comprimento da entrada não for uma potência de dois.

Quando o ulab é compilado com ULAB_SUPPORTS_COMPLEX e ULAB_FFT_IS_NUMPY_COMPATIBLE definidos como 1, a função, em vez disso, recebe um único array (possivelmente complexo) e retorna um array complexo, da mesma maneira que numpy.fft.fft.

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

Calcula a Transformada Discreta de Fourier inversa unidimensional.

Parâmetros:

  • r – um array unidimensional cujo comprimento é uma potência de dois. Contém a parte real do espectro.

  • c – um array unidimensional opcional, com o mesmo comprimento de r, contendo a parte imaginária do espectro. Se omitido, a parte imaginária é considerada zero.

Retorna:

uma 2-tupla (real, imag) de objetos numpy.ndarray contendo as partes real e imaginária da transformada inversa. O resultado é normalizado por N (o número de amostras), de modo que ifft(fft(x)) reproduz a entrada original.

Levanta:

ValueError – se o comprimento da entrada não for uma potência de dois.

Quando o ulab é compilado com ULAB_SUPPORTS_COMPLEX e ULAB_FFT_IS_NUMPY_COMPATIBLE definidos como 1, a função recebe um único array (possivelmente complexo) e retorna um array complexo.