Chris@19: Chris@19:
Chris@19:Chris@19: Next: Tutorial, Chris@19: Previous: Top, Chris@19: Up: Top Chris@19:
This manual documents version 3.3.4 of FFTW, the Chris@19: Fastest Fourier Transform in the West. FFTW is a comprehensive Chris@19: collection of fast C routines for computing the discrete Fourier Chris@19: transform (DFT) and various special cases thereof. Chris@19: Chris@19:
We assume herein that you are familiar with the properties and uses of Chris@19: the DFT that are relevant to your application. Otherwise, see Chris@19: e.g. The Fast Fourier Transform and Its Applications by E. O. Brigham Chris@19: (Prentice-Hall, Englewood Cliffs, NJ, 1988). Chris@19: Our web page also has links to FFT-related Chris@19: information online. Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19: Chris@19:
In order to use FFTW effectively, you need to learn one basic concept Chris@19: of FFTW's internal structure: FFTW does not use a fixed algorithm for Chris@19: computing the transform, but instead it adapts the DFT algorithm to Chris@19: details of the underlying hardware in order to maximize performance. Chris@19: Hence, the computation of the transform is split into two phases. Chris@19: First, FFTW's planner “learns” the fastest way to compute the Chris@19: transform on your machine. The planner Chris@19: produces a data structure called a plan that contains this Chris@19: information. Subsequently, the plan is executed Chris@19: to transform the array of input data as dictated by the plan. The Chris@19: plan can be reused as many times as needed. In typical Chris@19: high-performance applications, many transforms of the same size are Chris@19: computed and, consequently, a relatively expensive initialization of Chris@19: this sort is acceptable. On the other hand, if you need a single Chris@19: transform of a given size, the one-time cost of the planner becomes Chris@19: significant. For this case, FFTW provides fast planners based on Chris@19: heuristics or on previously computed plans. Chris@19: Chris@19:
FFTW supports transforms of data with arbitrary length, rank, Chris@19: multiplicity, and a general memory layout. In simple cases, however, Chris@19: this generality may be unnecessary and confusing. Consequently, we Chris@19: organized the interface to FFTW into three levels of increasing Chris@19: generality. Chris@19:
Besides the automatic performance adaptation performed by the planner, Chris@19: it is also possible for advanced users to customize FFTW manually. For Chris@19: example, if code space is a concern, we provide a tool that links only Chris@19: the subset of FFTW needed by your application. Conversely, you may need Chris@19: to extend FFTW because the standard distribution is not sufficient for Chris@19: your needs. For example, the standard FFTW distribution works most Chris@19: efficiently for arrays whose size can be factored into small primes Chris@19: (2, 3, 5, and 7), and otherwise it uses a Chris@19: slower general-purpose routine. If you need efficient transforms of Chris@19: other sizes, you can use FFTW's code generator, which produces fast C Chris@19: programs (“codelets”) for any particular array size you may care Chris@19: about. Chris@19: For example, if you need transforms of size Chris@19: 513 = 19*33,you can customize FFTW to support the factor 19 efficiently. Chris@19: Chris@19:
For more information regarding FFTW, see the paper, “The Design and Chris@19: Implementation of FFTW3,” by M. Frigo and S. G. Johnson, which was an Chris@19: invited paper in Proc. IEEE 93 (2), p. 216 (2005). The Chris@19: code generator is described in the paper “A fast Fourier transform Chris@19: compiler”, Chris@19: by M. Frigo, in the Proceedings of the 1999 ACM SIGPLAN Conference Chris@19: on Programming Language Design and Implementation (PLDI), Atlanta, Chris@19: Georgia, May 1999. These papers, along with the latest version of Chris@19: FFTW, the FAQ, benchmarks, and other links, are available at Chris@19: the FFTW home page. Chris@19: Chris@19:
The current version of FFTW incorporates many good ideas from the past Chris@19: thirty years of FFT literature. In one way or another, FFTW uses the Chris@19: Cooley-Tukey algorithm, the prime factor algorithm, Rader's algorithm Chris@19: for prime sizes, and a split-radix algorithm (with a Chris@19: “conjugate-pair” variation pointed out to us by Dan Bernstein). Chris@19: FFTW's code generator also produces new algorithms that we do not Chris@19: completely understand. Chris@19: The reader is referred to the cited papers for the appropriate Chris@19: references. Chris@19: Chris@19:
The rest of this manual is organized as follows. We first discuss the Chris@19: sequential (single-processor) implementation. We start by describing Chris@19: the basic interface/features of FFTW in Tutorial. Chris@19: Next, Other Important Topics discusses data alignment Chris@19: (see SIMD alignment and fftw_malloc), Chris@19: the storage scheme of multi-dimensional arrays Chris@19: (see Multi-dimensional Array Format), and FFTW's mechanism for Chris@19: storing plans on disk (see Words of Wisdom-Saving Plans). Next, Chris@19: FFTW Reference provides comprehensive documentation of all Chris@19: FFTW's features. Parallel transforms are discussed in their own Chris@19: chapters: Multi-threaded FFTW and Distributed-memory FFTW with MPI. Fortran programmers can also use FFTW, as described in Chris@19: Calling FFTW from Legacy Fortran and Calling FFTW from Modern Fortran. Installation and Customization explains how to Chris@19: install FFTW in your computer system and how to adapt FFTW to your Chris@19: needs. License and copyright information is given in License and Copyright. Finally, we thank all the people who helped us in Chris@19: Acknowledgments. Chris@19: Chris@19: Chris@19: