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