Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
Contents

Convolution and Correlation Task Editors

Task editors in convolution and correlation API of
Intel® oneAPI Math Kernel Library
 are routines intended for setting up or changing the following task parameters (seeTable
"Convolution and Correlation Task Parameters"
):
  • mode
  • internal_precision
  • start
  • decimation
For setting up or changing each of the above parameters, a separate routine exists.
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
Changes the value of the parameter
mode
 for the operation of convolution or correlation.
Changes the value of the parameter
internal_precision
 for the operation of convolution or correlation.
Sets the value of the parameter
start
 for the operation of convolution or correlation.
Sets the value of the parameter
decimation
 for the operation of convolution or correlation.
You can use the
NULL
 task pointer in calls to editor routines. In this case, the routine is terminated and no system crash occurs.

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804