v?Sin

Computes sine of vector elements.

Syntax

FORTRAN:

call vssin( n, a, y )

call vmssin( n, a, y, mode )

call vdsin( n, a, y )

call vmdsin( n, a, y, mode )

call vcsin( n, a, y )

call vmcsin( n, a, y, mode )

call vzsin( n, a, y )

call vmzsin( n, a, y, mode )

vsSin( n, a, y );

vmsSin( n, a, y, mode );

vdSin( n, a, y );

vmdSin( n, a, y, mode );

vcSin( n, a, y );

vmcSin( n, a, y, mode );

vzSin( n, a, y );

vmzSin( n, a, y, mode );

Include Files

FORTRAN 77: mkl_vml.f77
Fortran 90: mkl_vml.f90
C: mkl_vml_functions.h

Input Parameters

Name	Type	Description
n	FORTRAN 77: INTEGER Fortran 90: INTEGER, INTENT(IN) C: const int	Specifies the number of elements to be calculated.
a	FORTRAN 77: REAL for vssin, vmssin DOUBLE PRECISION for vdsin, vmdsin COMPLEX for vcsin, vmcsin DOUBLE PRECISION for vzsin, vmzsin Fortran 90: REAL, INTENT(IN) for vssin, vmssin DOUBLE PRECISION, INTENT(IN) for vdsin, vmdsin COMPLEX, INTENT(IN) for vcsin, vmcsin DOUBLE PRECISION, INTENT(IN) for vzsin, vmzsin C: const float* for vsSin, vmsSin const double* for vdSin, vmdSin const MKL_Complex8* for vcSin, vmcSin const MKL_Complex16* for vzSin, vmzSin	FORTRAN: Array that specifies the input vector a. C: Pointer to an array that contains the input vector a.
mode	FORTRAN 77: INTEGER8 Fortran 90:* INTEGER(KIND=8), INTENT(IN) C: const MKL_INT64	Overrides global VML mode setting for this function call. See vmlSetMode for possible values and their description.

Name

Type

Description

FORTRAN 77: INTEGER

Fortran 90: INTEGER, INTENT(IN)

C: const int

Specifies the number of elements to be calculated.

FORTRAN 77: REAL for vssin, vmssin

DOUBLE PRECISION for vdsin, vmdsin

COMPLEX for vcsin, vmcsin

DOUBLE PRECISION for vzsin, vmzsin

Fortran 90: REAL, INTENT(IN) for vssin, vmssin

DOUBLE PRECISION, INTENT(IN) for vdsin, vmdsin

COMPLEX, INTENT(IN) for vcsin, vmcsin

DOUBLE PRECISION, INTENT(IN) for vzsin, vmzsin

C: const float* for vsSin, vmsSin

const double* for vdSin, vmdSin

const MKL_Complex8* for vcSin, vmcSin

const MKL_Complex16* for vzSin, vmzSin

FORTRAN: Array that specifies the input vector a.

C: Pointer to an array that contains the input vector a.

mode

FORTRAN 77: INTEGER*8

Fortran 90: INTEGER(KIND=8), INTENT(IN)

C: const MKL_INT64

Overrides global VML mode setting for this function call. See vmlSetMode for possible values and their description.

Output Parameters

Name	Type	Description
y	FORTRAN 77: REAL for vssin, vmssin DOUBLE PRECISION for vdsin, vmdsin COMPLEX for vcsin, vmcsin DOUBLE PRECISION for vzsin, vmzsin Fortran 90: REAL, INTENT(OUT) for vssin, vmssin DOUBLE PRECISION, INTENT(OUT) for vdsin, vmdsin COMPLEX, INTENT(OUT) for vcsin, vmcsin DOUBLE PRECISION, INTENT(OUT) for vzsin, vmzsin C: float* for vsSin, vmsSin double* for vdSin, vmdSin MKL_Complex8* for vcSin, vmcSin MKL_Complex16* for vzSin, vmzSin	FORTRAN: Array that specifies the output vector y. C: Pointer to an array that contains the output vector y.

Name

Type

Description

FORTRAN 77: REAL for vssin, vmssin

DOUBLE PRECISION for vdsin, vmdsin

COMPLEX for vcsin, vmcsin

DOUBLE PRECISION for vzsin, vmzsin

Fortran 90: REAL, INTENT(OUT) for vssin, vmssin

DOUBLE PRECISION, INTENT(OUT) for vdsin, vmdsin

COMPLEX, INTENT(OUT) for vcsin, vmcsin

DOUBLE PRECISION, INTENT(OUT) for vzsin, vmzsin

C: float* for vsSin, vmsSin

double* for vdSin, vmdSin

MKL_Complex8* for vcSin, vmcSin

MKL_Complex16* for vzSin, vmzSin

FORTRAN: Array that specifies the output vector y.

C: Pointer to an array that contains the output vector y.

Description

This function is declared in mkl_vml.f77 for FORTRAN 77 interface, in mkl_vml.f90 for Fortran 90 interface, and in mkl_vml_functions.h for C interface.

The function computes sine of vector elements.

Note that arguments abs(a[i]) ≤ 2¹³ and abs(a[i]) ≤ 2¹⁶ for single and double precisions respectively are called fast computational path. These are trigonometric function arguments for which VML provides the best possible performance. Avoid arguments that do not belong to the fast computational path in the VML High Accuracy (HA) and Low Accuracy (LA) functions. Alternatively, you can use VML Enhanced Performance (EP) functions that are fast on the entire function domain. However, these functions provide less accuracy.

Special Values for Real Function v?Sin(x)
Argument	Result	VML Error Status	Exception
+0	+0
-0	-0
+∞	QNAN	VML_STATUS_ERRDOM	INVALID
-∞	QNAN	VML_STATUS_ERRDOM	INVALID
QNAN	QNAN
SNAN	QNAN		INVALID

Specifications for special values of the complex functions are defined according to the following formula

Sin(z) = -i*Sinh(i*z).