DftiCommitDescriptor

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 12/16/2022

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-36BA5016-BE31-4BA0-9CC4-067D6DDA33B8

View Details

DftiCommitDescriptor

Performs all initialization for the actual FFT computation.

Syntax

status = DftiCommitDescriptor( desc_handle )

Include Files

mkl_dfti.f90

Input Parameters

Name	Type	Description
desc_handle	DFTI_DESCRIPTOR	FFT descriptor.

Output Parameters

Name	Type	Description
desc_handle	DFTI_DESCRIPTOR	Updated FFT descriptor.
status	INTEGER	Function completion status.

Description

This function completes initialization of a previously created descriptor, which is required before the descriptor can be used for FFT computations. Typically, committing the descriptor performs all initialization that is required for the actual FFT computation. The initialization done by the function may involve exploring different factorizations of the input length to find the optimal computation method.

If you call the DftiSetValue function to change configuration parameters of a committed descriptor (see Descriptor Configuration Functions), you must re-commit the descriptor before invoking a computation function. Typically, a committal function call is immediately followed by a computation function call (see FFT Computation Functions).

The function returns zero when it completes successfully. See Status Checking Functions for more information on the returned status.

Interface

 
INTERFACE DftiCommitDescriptor
!Note that the body provided here is to illustrate the different
!argument list and types of dummy arguments. The interface
!does not guarantee what the actual function names are.
!Users can only rely on the function name following the
!keyword INTERFACE
 FUNCTION some_actual function_1 ( Desc_Handle )
 INTEGER :: some_actual function_1
 TYPE(DFTI_DESCRIPTOR), POINTER :: Desc_Handle
 END FUNCTION some_actual function_1
END INTERFACE DftiCommitDescriptor

Parent topic: FFT Descriptor Manipulation Functions

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

DftiCommitDescriptor