read_fft_optimization_data ( : : FileName : )

Load FFT speed optimization data from a file.

read_fft_optimization_data loads data for optimizing the runtime of the FFT from the file given by FileName. The optimization data must have been determined previously with optimize_fft_speed and must have been stored with write_fft_optimization_data. If the stored data have been determined for the image sizes to be used in the application, a call to optimize_fft_speed is unnecessary. It should be noted that the data should only be used on the same machine on which they were determined with optimize_fft_speed. If this is not observed the runtimes will not be optimal. Furthermore, it should be noted that optimization data that were created with Standard HALCON cannot be used with Parallel HALCON and vice versa.

read_fft_optimization_data influences the runtime of the following operators, which use the FFT: fft_generic, fft_image, fft_image_inv, wiener_filter, wiener_filter_ni, phot_stereo, sfs_pentland, sfs_mod_lr, sfs_orig_lr.


Parameters

FileName (input_control)
string -> string
File name of the optimization data.
Default value: ''fft_opt.dat''


Result

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


Parallelization Information

read_fft_optimization_data is reentrant and processed without parallelization.


Possible Successors

fft_generic, fft_image, fft_image_inv, rft_generic, wiener_filter, wiener_filter_ni, phot_stereo, sfs_pentland, sfs_mod_lr, sfs_orig_lr


Alternatives

optimize_fft_speed, optimize_rft_speed


See also

write_fft_optimization_data


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH