/*
* Free FFT and convolution (C)
*
* Copyright (c) 2021 Project Nayuki. (MIT License)
* https://www.nayuki.io/page/free-small-fft-in-multiple-languages
*
* Permission is hereby granted, free of charge, to any person obtaining a copy of
* this software and associated documentation files (the "Software"), to deal in
* the Software without restriction, including without limitation the rights to
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is furnished to do so,
* subject to the following conditions:
* - The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
* - The Software is provided "as is", without warranty of any kind, express or
* implied, including but not limited to the warranties of merchantability,
* fitness for a particular purpose and noninfringement. In no event shall the
* authors or copyright holders be liable for any claim, damages or other
* liability, whether in an action of contract, tort or otherwise, arising from,
* out of or in connection with the Software or the use or other dealings in the
* Software.
*/
#pragma once
#include
#include
#ifdef __cplusplus
extern "C" {
#define restrict
#endif
/*
* Computes the discrete Fourier transform (DFT) of the given complex vector, storing the result back into the vector.
* The vector can have any length. This is a wrapper function. Returns true if successful, false otherwise (out of memory).
*/
bool Fft_transform(double real[restrict], double imag[restrict], size_t n);
/*
* Computes the inverse discrete Fourier transform (IDFT) of the given complex vector, storing the result back into the vector.
* The vector can have any length. This is a wrapper function. This transform does not perform scaling, so the inverse is not a true inverse.
* Returns true if successful, false otherwise (out of memory).
*/
bool Fft_inverseTransform(double real[restrict], double imag[restrict], size_t n);
/*
* Computes the discrete Fourier transform (DFT) of the given complex vector, storing the result back into the vector.
* The vector's length must be a power of 2. Uses the Cooley-Tukey decimation-in-time radix-2 algorithm.
* Returns true if successful, false otherwise (n is not a power of 2, or out of memory).
*/
bool Fft_transformRadix2(double real[restrict], double imag[restrict], size_t n);
/*
* Computes the discrete Fourier transform (DFT) of the given complex vector, storing the result back into the vector.
* The vector can have any length. This requires the convolution function, which in turn requires the radix-2 FFT function.
* Uses Bluestein's chirp z-transform algorithm. Returns true if successful, false otherwise (out of memory).
*/
bool Fft_transformBluestein(double real[restrict], double imag[restrict], size_t n);
/*
* Computes the circular convolution of the given real vectors. Each vector's length must be the same.
* Returns true if successful, false otherwise (out of memory).
*/
bool Fft_convolveReal(const double xvec[restrict], const double yvec[restrict], double outvec[restrict], size_t n);
/*
* Computes the circular convolution of the given complex vectors. Each vector's length must be the same.
* Returns true if successful, false otherwise (out of memory).
*/
bool Fft_convolveComplex(const double xreal[restrict], const double ximag[restrict], const double yreal[restrict], const double yimag[restrict], double outreal[restrict], double outimag[restrict], size_t n);
#ifdef __cplusplus
#undef restrict
}
#endif