read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataread_fft_optimization_data (Operator)
read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataread_fft_optimization_data — Load FFT speed optimization data from a file.
Signature
read_fft_optimization_data( : : FileName : )
Herror read_fft_optimization_data(const char* FileName)
Herror T_read_fft_optimization_data(const Htuple FileName)
void ReadFftOptimizationData(const HTuple& FileName)
static void HMisc::ReadFftOptimizationData(const HString& FileName)
static void HMisc::ReadFftOptimizationData(const char* FileName)
static void HMisc::ReadFftOptimizationData(const wchar_t* FileName)
(
Windows only)
def read_fft_optimization_data(file_name: str) -> None
Description
read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataread_fft_optimization_data loads data for optimizing the
runtime of the FFT from the file given by FileNameFileNameFileNamefileNamefile_name. The
optimization data must have been determined previously with
optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedoptimize_fft_speed and must have been stored with
write_fft_optimization_datawrite_fft_optimization_dataWriteFftOptimizationDataWriteFftOptimizationDatawrite_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_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedoptimize_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_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedoptimize_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_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataread_fft_optimization_data influences the runtime of the
following operators, which use the FFT: fft_genericfft_genericFftGenericFftGenericfft_generic,
fft_imagefft_imageFftImageFftImagefft_image, fft_image_invfft_image_invFftImageInvFftImageInvfft_image_inv, sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandsfs_pentland,
sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrsfs_mod_lr, sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrsfs_orig_lrwiener_filterwiener_filterWienerFilterWienerFilterwiener_filter.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
FileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
File name of the optimization data.
Default:
'fft_opt.dat'
"fft_opt.dat"
"fft_opt.dat"
"fft_opt.dat"
"fft_opt.dat"
Result
read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataread_fft_optimization_data returns 2 (
H_MSG_TRUE)
if all parameters
are correct. If necessary, an exception is raised.
Possible Successors
fft_genericfft_genericFftGenericFftGenericfft_generic,
fft_imagefft_imageFftImageFftImagefft_image,
fft_image_invfft_image_invFftImageInvFftImageInvfft_image_inv,
rft_genericrft_genericRftGenericRftGenericrft_generic,
wiener_filterwiener_filterWienerFilterWienerFilterwiener_filter,
wiener_filter_niwiener_filter_niWienerFilterNiWienerFilterNiwiener_filter_ni,
photometric_stereophotometric_stereoPhotometricStereoPhotometricStereophotometric_stereo,
sfs_pentlandsfs_pentlandSfsPentlandSfsPentlandsfs_pentland,
sfs_mod_lrsfs_mod_lrSfsModLrSfsModLrsfs_mod_lr,
sfs_orig_lrsfs_orig_lrSfsOrigLrSfsOrigLrsfs_orig_lr
Alternatives
optimize_fft_speedoptimize_fft_speedOptimizeFftSpeedOptimizeFftSpeedoptimize_fft_speed,
optimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeedoptimize_rft_speed
See also
write_fft_optimization_datawrite_fft_optimization_dataWriteFftOptimizationDataWriteFftOptimizationDatawrite_fft_optimization_data
Module
Foundation