descriptor<precision, domain>::compute_backward<typename IOType>

Computes the backward FFT. This routine belongs to the mkl::dft namespace.

Syntax

Using SYCL buffers

void descriptor<prec,dom>::compute_backward<IOType>(cl::sycl::buffer<IOType, 1> &inout ) ;

void descriptor<prec,dom>::compute_backward<IOType>(cl::sycl::buffer<IOType, 1> &in , cl::sycl::buffer<IOType, 1> &out ) ;

Using USM pointers

void descriptor<prec,dom>::compute_backward<IOType>(IOType* inout, const cl::sycl::vector_class<cl::sycl::event> &dependencies = {});

void descriptor<prec,dom>::compute_backward<IOType>(IOType* in, IOType* out, const cl::sycl::vector_class<cl::sycl::event> &dependencies = {});

Include Files

Description

The descriptor<precision, domain>::compute_backward<typename IOType> function accepts the descriptor handle parameter and one or more data parameters. Given a successfully configured and committed descriptor, this function computes the backward FFT, that is, the transform with the minus sign in the exponent, δ = +1. This function throws an std::runtime_exception in the case that it fails.

The FFT descriptor must be properly configured prior to the function call. Function calls needed to configure an FFT descriptor for a particular call to an FFT computation function are summarized in Configuring and Computing an FFT in C/C++.

The number of the data parameters that the function requires may vary depending on the configuration of the descriptor. This variation is accommodated by variable parameters.

Input Parameters

Name

Type

Description

inout, in

cl::sycl::buffer<IOType, 1>

IOType*

Sycl buffer or USM pointer containing an array of length no less than specified at during construction of the handle.

The suffix in parameter names corresponds to the value of the configuration parameter mkl::dft::ConfigParam::PLACEMENT as follows:

Output Parameters

Name

Type

Description

inout, out

cl::sycl::buffer<IOType, 1>

IOType*

Sycl buffer or USM pointer containing an array of length no less than specified during construction of the handle.

The suffix in parameter names corresponds to the value of the configuration parameter mkl::dft::config_param::PLACEMENT as follows:

Return Values

The function returns a value indicating whether the operation was successful or not, and why.

Return Value Description
mkl::dft::ErrCode::NO_ERROR

The operation was successful.

mkl::dft::ErrCode::BAD_DESCRIPTOR

DFTI handle provided is invalid.

mkl::dft::ErrCode::INCONSISTENT_CONFIGURATION/

mkl::dft::ErrCode::INVALID_CONFIGURATION

An input value provided is invalid.

mkl::dft::ErrCode::UNIMPLEMENTED

Functionality requested is not implemented.

mkl::dft::ErrCode::MEMORY_ERROR

Internal memory allocation failed.