ExecX1D

Computes convolution or correlation for one-dimensional case with the fixed first operand vector.

Syntax

Fortran:

status = vslsconvexecx1d(task, y, ystride, z, zstride)

status = vsldconvexecx1d(task, y, ystride, z, zstride)

status = vslcconvexecx1d(task, y, ystride, z, zstride)

status = vslzconvexecx1d(task, y, ystride, z, zstride)

status = vslscorrexecx1d(task, y, ystride, z, zstride)

status = vsldcorrexecx1d(task, y, ystride, z, zstride)

status = vslccorrexecx1d(task, y, ystride, z, zstride)

status = vslzcorrexecx1d(task, y, ystride, z, zstride)

C:

status = vslsConvExecX1D(task, y, ystride, z, zstride);

status = vsldConvExecX1D(task, y, ystride, z, zstride);

status = vslcConvExecX1D(task, y, ystride, z, zstride);

status = vslzConvExecX1D(task, y, ystride, z, zstride);

status = vslsCorrExecX1D(task, y, ystride, z, zstride);

status = vslcCorrExecX1D(task, y, ystride, z, zstride);

status = vslzCorrExecX1D(task, y, ystride, z, zstride);

status = vsldCorrExecX1D(task, y, ystride, z, zstride);

Include Files

The FORTRAN 77 interfaces are specified in the mkl_vsl.f77 include file, the Fortran 90 interfaces are specified in the mkl_vsl.f90 include file, and the C interfaces are specified in the mkl_vsl_functions.h include file.

Input Parameters

Name

Type

Description

task

FORTRAN 77: INTEGER*4 task(2) for vslsconvexecx1d, vsldconvexecx1d, vslcconvexecx1d, vslzconvexecx1d

INTEGER*4 task(2) for vslscorrexecx1d, vsldcorrexecx1d, vslccorrexecx1d, vslzcorrexecx1d

Fortran 90: TYPE(VSL_CONV_TASK) for vslsconvexecx1d, vsldconvexecx1d, vslcconvexecx1d, vslzconvexecx1d

TYPE(VSL_CORR_TASK) for vslscorrexecx1d, vsldcorrexecx1d, vslccorrexecx1d, vslzcorrexecx1d

C: VSLConvTaskPtr for vslsConvExecX1D, vsldConvExecX1D, vslcConvExecX1D, vslzConvExecX1D

VSLCorrTaskPtr for vslsCorrExecX1D, vsldCorrExecX1D, vslcCorrExecX1D, vslzCorrExecX1D

Pointer to the task descriptor.

x , y

FORTRAN 77: REAL*4 for vslsconvexecx1d and vslscorrexecx1d,

REAL*8 for vsldconvexecx1d and vsldcorrexecx1d,

COMPLEX*8 forvslcconvexecx1d and vslccorrexecx1d,

COMPLEX*16 forvslzconvexecx1d and vslzcorrexecx1d

Fortran 90: REAL(KIND=4), DIMENSION(*) for vslsconvexecx1d and vslscorrexecx1d,

REAL(KIND=8), DIMENSION(*) for vsldconvexecx1d and vsldcorrexecx1d,

COMPLEX(KIND=4), DIMENSION (*) forvslcconvexecx1d and vslccorrexecx1d,

COMPLEX(KIND=8), DIMENSION (*) for vslzconvexecx1d and vslzcorrexecx1d

C: const float[] for vslsConvExecX1D and vslsCorrExecX1D,

const double[] for vsldConvExecX1D and vsldCorrExecX1D,

const MKL_Complex8[] for vslcConvExecX1D and vslcCorrExecX1D,

const MKL_Complex16[] for vslzConvExecX1D and vslzCorrExecX1D

Pointer to array containing input data (for the second operand vector). See Data Allocation for more information.

ystride, zstride

FORTRAN 77: INTEGER

Fortran 90: INTEGER

C: const int

Strides for input and output data. For more information, see stride parameters.

Output Parameters

Name

Type

Description

z

FORTRAN 77: REAL*4 for vslsconvexecx1d and vslscorrexecx1d,

REAL*8 for vsldconvexecx1d and vsldcorrexecx1d,

COMPLEX*8 forvslcconvexecx1d and vslccorrexecx1d,

COMPLEX*16 forvslzconvexecx1d and vslzcorrexecx1d

Fortran 90: REAL(KIND=4), DIMENSION(*) for vslsconvexecx1d and vslscorrexecx1d,

REAL(KIND=8), DIMENSION(*) for vsldconvexecx1d and vsldcorrexecx1d,

COMPLEX(KIND=4), DIMENSION (*) forvslcconvexecx1d and vslccorrexecx1d,

COMPLEX(KIND=8), DIMENSION (*) for vslzconvexecx1d and vslzcorrexecx1d

C: const float[] for vslsConvExecX1D and vslsCorrExecX1D,

const double[] for vsldConvExecX1D and vsldCorrExecX1D,

const MKL_Complex8[] for vslcConvExecX1D and vslcCorrExecX1D,

const MKL_Complex16[] for vslzConvExecX1D and vslzCorrExecX1D

Pointer to the array that stores output data. See Data Allocation for more information.

status

FORTRAN 77: INTEGER

Fortran 90: INTEGER

C: int

Set to VSL_STATUS_OK if the task is executed successfully or set to non-zero error code otherwise.

Description

Each of the ExecX1D routines computes convolution or correlation of one-dimensional (assuming that dims =1) data provided by the arrays x and y and then stores the results in the array z. These routines represent a special version of the operation, which expects that the first operand vector was set on the task construction stage.

Parameters of the operation are read from the task descriptor created previously by a corresponding NewTaskX1D constructor and pointed to by task. If task is NULL, no operation is done.

Using this form of execution routines is recommended when you need to compute multiple one-dimensional convolutions or correlations with the same data vector in array x against different vectors in array y. This helps improve performance by eliminating unnecessary overhead in repeated computation of intermediate data required for the operation.


Submit feedback on this help topic

Copyright © 1994 - 2011, Intel Corporation. All rights reserved.