cannam@167: .\" 
cannam@167: .\" Copyright (c) 2003, 2007-14 Matteo Frigo
cannam@167: .\" Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology
cannam@167: .\" 
cannam@167: .\" This program is free software; you can redistribute it and/or modify
cannam@167: .\" it under the terms of the GNU General Public License as published by
cannam@167: .\" the Free Software Foundation; either version 2 of the License, or
cannam@167: .\" (at your option) any later version.
cannam@167: .\" 
cannam@167: .\" This program is distributed in the hope that it will be useful,
cannam@167: .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
cannam@167: .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
cannam@167: .\" GNU General Public License for more details.
cannam@167: .\" 
cannam@167: .\" You should have received a copy of the GNU General Public License
cannam@167: .\" along with this program; if not, write to the Free Software
cannam@167: .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
cannam@167: .\"
cannam@167: .TH FFTW-WISDOM-TO-CONF 1 "February, 2003" "fftw" "fftw"
cannam@167: .SH NAME
cannam@167: fftw\-wisdom\-to\-conf \- generate FFTW wisdom (pre-planned transforms)
cannam@167: .SH SYNOPSIS
cannam@167: \fBfftw\-wisdom\-to\-conf\fR [< \fIINPUT\fR] [> \fIOUTPUT\fR]
cannam@167: .SH DESCRIPTION
cannam@167: .PP
cannam@167: .\" Add any additional description here
cannam@167: .I fftw\-wisdom\-to\-conf
cannam@167: is a utility to generate C
cannam@167: .B configuration
cannam@167: routines from FFTW
cannam@167: .B wisdom
cannam@167: files, where the latter contain saved information about how to
cannam@167: optimally compute (Fourier) transforms of various sizes.  A
cannam@167: configuration routine is a C subroutine that you link into your
cannam@167: program, replacing a routine of the same name in the FFTW library,
cannam@167: that determines which parts of FFTW are callable by your program.
cannam@167: 
cannam@167: The reason to do this is that, if you only need transforms of a
cannam@167: limited set of sizes and types, and if you are statically linking your
cannam@167: program, then using a configuration file generated from wisdom for
cannam@167: those types can substantially reduce the size of your executable.
cannam@167: (Otherwise, because of FFTW's dynamic nature, all of FFTW's transform
cannam@167: code must be linked into any program using FFTW.)
cannam@167: 
cannam@167: FFTW is a free library to compute discrete Fourier transforms in one
cannam@167: or more dimensions, for arbitrary sizes, and of both real and complex
cannam@167: data, among other related operations.  More information on FFTW can be
cannam@167: found at the FFTW home page:
cannam@167: .I http://www.fftw.org
cannam@167: 
cannam@167: .I fftw\-wisdom\-to\-conf
cannam@167: reads wisdom from standard input and writes the configuration to
cannam@167: standard output.  It can easily be combined with the
cannam@167: .I fftw\-wisdom
cannam@167: tool, for example:
cannam@167: 
cannam@167: fftw\-wisdom \-n \-o wisdom cof1024 cob1024
cannam@167: .br
cannam@167: fftw\-wisdom\-to\-conf < wisdom > conf.c
cannam@167: 
cannam@167: will create a configuration "conf.c" containing only those parts of
cannam@167: FFTW needed for the optimized complex forwards and backwards
cannam@167: out-of-place transforms of size 1024 (also saving the wisdom itself in
cannam@167: "wisdom").
cannam@167: 
cannam@167: Alternatively, you can run your actual program, export wisdom for all
cannam@167: plans that were created (ideally in FFTW_PATIENT or FFTW_EXHAUSTIVE
cannam@167: mode), use this as input for \fIfftw\-wisdom\-to\-conf\fR,
cannam@167: and then re-link your program with the resulting configuration routine.
cannam@167: 
cannam@167: Note that the configuration routine does not contain the wisdom, only
cannam@167: the routines necessary to implement the wisdom, so your program should
cannam@167: also import the wisdom in order to benefit from the pre-optimized
cannam@167: plans.
cannam@167: .SH OPTIONS
cannam@167: .TP
cannam@167: \fB\-h\fR, \fB\-\-help\fR
cannam@167: Display help on the command-line options and usage.
cannam@167: .TP
cannam@167: \fB\-V\fR, \fB\-\-version\fR
cannam@167: Print the version number and copyright information.
cannam@167: .SH BUGS
cannam@167: Send bug reports to fftw@fftw.org.
cannam@167: .SH AUTHORS
cannam@167: Written by Steven G. Johnson and Matteo Frigo.
cannam@167: 
cannam@167: Copyright (c) 2003, 2007-14 Matteo Frigo
cannam@167: .br
cannam@167: Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology
cannam@167: .SH "SEE ALSO"
cannam@167: fftw-wisdom(1)