Chris@19: Chris@19:
Chris@19:Chris@19: Next: Real-to-Real Transform Kinds, Chris@19: Previous: Real-data DFT Array Format, Chris@19: Up: Basic Interface Chris@19:
fftw_plan fftw_plan_r2r_1d(int n, double *in, double *out, Chris@19: fftw_r2r_kind kind, unsigned flags); Chris@19: fftw_plan fftw_plan_r2r_2d(int n0, int n1, double *in, double *out, Chris@19: fftw_r2r_kind kind0, fftw_r2r_kind kind1, Chris@19: unsigned flags); Chris@19: fftw_plan fftw_plan_r2r_3d(int n0, int n1, int n2, Chris@19: double *in, double *out, Chris@19: fftw_r2r_kind kind0, Chris@19: fftw_r2r_kind kind1, Chris@19: fftw_r2r_kind kind2, Chris@19: unsigned flags); Chris@19: fftw_plan fftw_plan_r2r(int rank, const int *n, double *in, double *out, Chris@19: const fftw_r2r_kind *kind, unsigned flags); Chris@19:Chris@19:
Chris@19: Plan a real input/output (r2r) transform of various kinds in zero or
Chris@19: more dimensions, returning an fftw_plan
(see Using Plans).
Chris@19:
Chris@19:
Once you have created a plan for a certain transform type and Chris@19: parameters, then creating another plan of the same type and parameters, Chris@19: but for different arrays, is fast and shares constant data with the Chris@19: first plan (if it still exists). Chris@19: Chris@19:
The planner returns NULL
if the plan cannot be created. A
Chris@19: non-NULL
plan is always returned by the basic interface unless
Chris@19: you are using a customized FFTW configuration supporting a restricted
Chris@19: set of transforms, or for size-1 FFTW_REDFT00
kinds (which are
Chris@19: not defined).
Chris@19:
Chris@19:
Chris@19:
rank
is the dimensionality of the transform (it should be the
Chris@19: size of the arrays *n
and *kind
), and can be any
Chris@19: non-negative integer. The ‘_1d’, ‘_2d’, and ‘_3d’
Chris@19: planners correspond to a rank
of 1
, 2
, and
Chris@19: 3
, respectively. A rank
of zero is equivalent to a copy
Chris@19: of one number from input to output.
Chris@19:
Chris@19: n
, or n0
/n1
/n2
, or n[rank]
,
Chris@19: respectively, gives the (physical) size of the transform dimensions.
Chris@19: They can be any positive integer.
Chris@19:
Chris@19: n0
x n1
; or n0
x n1
x n2
; or
Chris@19: n[0]
x n[1]
x ... x n[rank-1]
.
Chris@19: See Multi-dimensional Array Format.
Chris@19: REDFT00
or RODFT00
transform kind in a dimension of
Chris@19: size n, it is n-1 or n+1, respectively, that
Chris@19: should be factorizable in the above form.
Chris@19: in
and out
point to the input and output arrays of the
Chris@19: transform, which may be the same (yielding an in-place transform).
Chris@19: These arrays are overwritten during planning, unless
Chris@19: FFTW_ESTIMATE
is used in the flags. (The arrays need not be
Chris@19: initialized, but they must be allocated.)
Chris@19:
Chris@19: kind
, or kind0
/kind1
/kind2
, or
Chris@19: kind[rank]
, is the kind of r2r transform used for the
Chris@19: corresponding dimension. The valid kind constants are described in
Chris@19: Real-to-Real Transform Kinds. In a multi-dimensional transform,
Chris@19: what is computed is the separable product formed by taking each
Chris@19: transform kind along the corresponding dimension, one dimension after
Chris@19: another.
Chris@19:
Chris@19: flags
is a bitwise OR (‘|’) of zero or more planner flags,
Chris@19: as defined in Planner Flags.
Chris@19:
Chris@19: