Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
FFTW-WISDOM-TO-CONF(1)		     fftw		FFTW-WISDOM-TO-CONF(1)

NAME
       fftw-wisdom-to-conf - generate FFTW wisdom (pre-planned transforms)

SYNOPSIS
       fftw-wisdom-to-conf [< INPUT] [>	OUTPUT]

DESCRIPTION
       fftw-wisdom-to-conf  is	a utility to generate C	configuration routines
       from FFTW wisdom	files, where  the  latter  contain  saved  information
       about  how  to optimally	compute	(Fourier) transforms of	various	sizes.
       A configuration routine is a C subroutine that you link into your  pro-
       gram,  replacing	 a  routine of the same	name in	the FFTW library, that
       determines which	parts of FFTW are callable by your program.

       The reason to do	this is	that, if you only need transforms of a limited
       set of sizes and	types, and if you are statically linking your program,
       then using a configuration file generated from wisdom for  those	 types
       can  substantially reduce the size of your executable.  (Otherwise, be-
       cause of	FFTW's dynamic nature, all of FFTW's transform	code  must  be
       linked into any program using FFTW.)

       FFTW is a free library to compute discrete Fourier transforms in	one or
       more dimensions,	for arbitrary sizes, and  of  both  real  and  complex
       data,  among other related operations.  More information	on FFTW	can be
       found at	the FFTW home page: http://www.fftw.org

       fftw-wisdom-to-conf reads wisdom	from standard  input  and  writes  the
       configuration  to  standard output.  It can easily be combined with the
       fftw-wisdom tool, for example:

       fftw-wisdom -n -o wisdom	cof1024	cob1024
       fftw-wisdom-to-conf < wisdom > conf.c

       will create a configuration "conf.c" containing	only  those  parts  of
       FFTW  needed  for  the optimized	complex	forwards and backwards out-of-
       place transforms	of size	1024 (also saving the wisdom itself  in	 "wis-
       dom").

       Alternatively,  you  can	run your actual	program, export	wisdom for all
       plans that were created (ideally	 in  FFTW_PATIENT  or  FFTW_EXHAUSTIVE
       mode), use this as input	for fftw-wisdom-to-conf, and then re-link your
       program with the	resulting configuration	routine.

       Note that the configuration routine does	not contain the	 wisdom,  only
       the  routines necessary to implement the	wisdom,	so your	program	should
       also import the wisdom in  order	 to  benefit  from  the	 pre-optimized
       plans.

OPTIONS
       -h, --help
	      Display help on the command-line options and usage.

       -V, --version
	      Print the	version	number and copyright information.

BUGS
       Send bug	reports	to fftw@fftw.org.

AUTHORS
       Written by Steven G. Johnson and	Matteo Frigo.

       Copyright (c) 2003, 2007-14 Matteo Frigo
       Copyright (c) 2003, 2007-14 Massachusetts Institute of Technology

SEE ALSO
       fftw-wisdom(1)

fftw				February, 2003		FFTW-WISDOM-TO-CONF(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | BUGS | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=fftw-wisdom-to-conf&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help