Task Editors

Task editors in convolution and correlation API of Intel MKL are routines intended for setting up or changing the following task parameters (see Table "Convolution and Correlation Task Parameters"):

  • mode

  • internal_precision

  • start

  • decimation

For setting up or changing each of the above parameters, a separate routine exists.

Note

Fields of the task descriptor structure are accessible only through the set of task editor routines provided with the software.

The work data computed during the last commitment process may become invalid with respect to new parameter settings. That is why after applying any of the editor routines to change the task descriptor settings, the task loses its commitment status and goes through the full commitment process again during the next execution or copy operation. For more information on task commitment, see the Introduction to Convolution and Correlation.

Table "Task Editors" lists available task editors.

Task Editors

Routine

Description

vslConvSetMode/vslCorrSetMode

Changes the value of the parameter mode for the operation of convolution or correlation.

vslConvSetInternalPrecision/vslCorrSetInternalPrecision

Changes the value of the parameter internal_precision for the operation of convolution or correlation.

vslConvSetStart/vslCorrSetStart

Sets the value of the parameter start for the operation of convolution or correlation.

vslConvSetDecimation/vslCorrSetDecimation

Sets the value of the parameter decimation for the operation of convolution or correlation.

Note

You can use the NULL task pointer in calls to editor routines. In this case, the routine is terminated and no system crash occurs.

For more complete information about compiler optimizations, see our Optimization Notice.