Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 12/16/2022
Public

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

Document Table of Contents

v?Sinpi

Computes the sine of vector elements multiplied by π.

Syntax

vsSinpi (n, a, y);

vsSinpiI(n, a, inca, y, incy);

vmsSinpi (n, a, y, mode);

vmsSinpiI(n, a, inca, y, incy, mode);

vdSinpi (n, a, y);

vdSinpiI(n, a, inca, y, incy);

vmdSinpi (n, a, y, mode);

vmdSinpiI(n, a, inca, y, incy, mode);

Include Files
  • mkl.h
Input Parameters

Name

Type

Description

n

const MKL_INT

Specifies the number of elements to be calculated.

a

const float* for vsSinpi

const float* for vmsSinpi

const double* for vdSinpi

const double* for vmdSinpi

Pointer to the array containing the input vector a.

inca, incy

const MKL_INT

Specifies increments for the elements of a and y.

mode

const MKL_INT64

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

Output Parameters

Name

Type

Description

y

float* for vsSinpi

float* for vmsSinpi

double* for vdSinpi

double* for vmdSinpi

Pointer to an array containing the output vector y.

Description

The v?Sinpi function computes the sine of vector elements multiplied by π. For an argument x, the function computes sin(π*x).

Special values for Real Function v?Sinpi(x)
Argument Result VM Error Status Exception
+0 +0    
-0 -0    
+n, positive integer +0    
-n, negative integer -0    
± QNAN VML_STATUS_ERRDOM INVALID
QNAN QNAN    
SNAN QNAN   INVALID
Application Notes

If arguments abs(ai) ≤ 222 for single precision or abs(ai) ≤ 251 for double precision, they belong to the fast computational path: arguments for which VM provides the best possible performance. Avoid arguments with do not belong to the fast computational path in VM High Accuracy (HA) or Low Accuracy (LA) functions. For arguments which do not belong to the fast computational path you can use VM Enhanced Performance (EP) functions, which are fast on the entire function domain. However, these functions provide lower accuracy.

See Also