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

v?Cosd

Computes the cosine of vector elements multiplied by π/180.

Syntax

call vscosd (n, a, y)

call vscosdi(n, a, inca, y, incy)

call vmscosd (n, a, y, mode)

call vmscosdi(n, a, inca, y, incy, mode)

call vdcosd (n, a, y)

call vdcosdi(n, a, inca, y, incy)

call vmdcosd (n, a, y, mode)

call vmdcosdi(n, a, inca, y, incy, mode)

Include Files

  • mkl_vml.f90

Input Parameters

Name

Type

Description

n

INTEGER

Specifies the number of elements to be calculated.

a

REAL for vscosd

REAL for vmscosd

DOUBLE PRECISION for vdcosd

DOUBLE PRECISION for vmdcosd

Pointer to the array containing the input vector a.

inca, incy

INTEGER, INTENT(IN)

Specifies increments for the elements of a and y.

mode

INTEGER (KIND=8)

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

Output Parameters

Name

Type

Description

y

REAL for vscosd

REAL for vmscosd

DOUBLE PRECISION for vdcosd

DOUBLE PRECISION for vmdcosd

Pointer to an array containing the output vector y.

Description

The v?Cosd function computes the cosine of vector elements multiplied by π/180. For an argument x, the function computes cos(π*x/180).

Special values for Real Function v?Cosd(x)
Argument Result VM Error Status Exception
+0 +1    
-0 +1    
± QNAN VML_STATUS_ERRDOM INVALID
QNAN QNAN    
SNAN QNAN   INVALID

Application Notes

If arguments abs(ai) ≤ 224 for single precision or abs(ai ) ≤ 252 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