Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 7/13/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

vslConvSetMode/vslCorrSetMode

Changes the value of the parameter mode in the convolution or correlation task descriptor.

Syntax

status = vslconvsetmode(task, newmode)

status = vslcorrsetmode(task, newmode)

Include Files

  • mkl.fi, mkl_vsl.f90

Input Parameters

Name

Type

Description

task

FORTRAN 77: INTEGER*4 task(2) for vslconvsetmode

INTEGER*4 task(2) for vslcorrsetmode

Fortran 90: TYPE(VSL_CONV_TASK) for vslconvsetmode

TYPE(VSL_CORR_TASK) for vslcorrsetmode

Pointer to the task descriptor.

newmode

FORTRAN 77: INTEGER

Fortran 90: INTEGER

New value of the parameter mode.

Output Parameters

Name

Type

Description

status

FORTRAN 77: INTEGER

Fortran 90: INTEGER

Current status of the task.

Description

This function is declared in mkl_vsl.f90 for the Fortran interface.

The function routine changes the value of the parameter mode for the operation of convolution or correlation. This parameter defines whether the computation should be done via Fourier transforms of the input/output data or using a direct algorithm. Initial value for mode is assigned by a task constructor.

Predefined values for the mode parameter are as follows:

Values of mode parameter

Value

Purpose

VSL_CONV_MODE_FFT

Compute convolution by using fast Fourier transform.

VSL_CORR_MODE_FFT

Compute correlation by using fast Fourier transform.

VSL_CONV_MODE_DIRECT

Compute convolution directly.

VSL_CORR_MODE_DIRECT

Compute correlation directly.

VSL_CONV_MODE_AUTO

Automatically choose direct or Fourier mode for convolution.

VSL_CORR_MODE_AUTO

Automatically choose direct or Fourier mode for correlation.