optimize_rft_speedoptimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeed (Operator)

Name

optimize_rft_speedoptimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeed — Optimize the runtime of the real-valued FFT.

Signature

Description

optimize_rft_speedoptimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeed determines a method that achieves an optimum runtime of the real-valued FFT for an image of size WidthWidthWidthWidthwidth x HeightHeightHeightHeightheight. The data that are determined for one image size do not influence the methods used for other image sizes. Consequently, optimize_rft_speedoptimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeed can be called multiple times with different values for WidthWidthWidthWidthwidth and HeightHeightHeightHeightheight to achieve an optimum runtime for all image sizes that are used in an application. The parameter ModeModeModeModemode determines the thoroughness of the search for the fastest method. For ModeModeModeModemode = 'standard'"standard""standard""standard""standard" a fast search is used, which typically takes a few seconds. The method thus determined results in very good runtimes, which are not always optimal. For ModeModeModeModemode = 'patient'"patient""patient""patient""patient" a more thorough search is performed, which typically takes several seconds and in most cases leads to optimum runtimes. For ModeModeModeModemode = 'exhaustive'"exhaustive""exhaustive""exhaustive""exhaustive" an exhaustive search is performed, which typically takes several minutes and always results in the optimum runtime. In most applications, ModeModeModeModemode = 'standard'"standard""standard""standard""standard" results in the best compromise between the runtime of the real-valued FFT and the time required for the search of the optimum runtime. The data determined with optimize_rft_speedoptimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeed can be saved with write_fft_optimization_datawrite_fft_optimization_datawrite_fft_optimization_dataWriteFftOptimizationDataWriteFftOptimizationData and can be loaded with read_fft_optimization_dataread_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationData.

optimize_rft_speedoptimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeed influences the runtime of rft_genericrft_genericrft_genericRftGenericRftGeneric.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

optimize_rft_speedoptimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeed returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Possible Successors

rft_genericrft_genericrft_genericRftGenericRftGeneric, write_fft_optimization_datawrite_fft_optimization_datawrite_fft_optimization_dataWriteFftOptimizationDataWriteFftOptimizationData

Alternatives

read_fft_optimization_dataread_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationData

See also

optimize_fft_speedoptimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeed

Module

Foundation