FORWARD_DISTANCE and BACKWARD_DISTANCE¶
The FFT interface enables computation of multiple transforms. To compute multiple transforms, you need to specify the data distribution of the multiple sets of data. The distance between the first data elements of consecutive data sets, FORWARD_DISTANCE
for forward domain data or BACKWARD_DISTANCE
for backward domain data, specifies the distribution. The configuration setting is a value of std::int64_t
data type.
The default value for both configuration settings is one. You must set this parameter explicitly if the number of transforms is greater than one (see Number of Transforms ).
The distance is counted in elements of the data type defined by the descriptor configuration (rather than by the type of the variable passed to the computation functions). Specifically, the domain template parameter, and the COMPLEX_STORAGE
, REAL_STORAGE
and CONJUGATE_EVEN_STORAGE
configuration parameters described in Storage Formats define the type of the elements as shown in the complex_storage, real_storage and conjugate_even_storage tables.
For in-place transforms ( PLACEMENT=INPLACE
), the configuration set by FORWARD_DISTANCE
and BACKWARD_DISTANCE
should be consistent, that is, the locations of the data sets for input and output must coincide.
Parent topic: Configuration Parameters and Enums