v?Tanpi

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 6/24/2024

Version

Public

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

Visible to Intel only — GUID: GUID-D38EA443-3625-4A05-838C-F378985FBAB5

View Details

v?Tanpi

Computes the tangent of vector elements multiplied by π.

Syntax

vhTanpi (n, a, y);

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

vmhTanpi (n, a, y, mode);

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

vsTanpi (n, a, y);

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

vmsTanpi (n, a, y, mode);

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

vdTanpi (n, a, y);

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

vmdTanpi (n, a, y, mode);

vmdTanpiI(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 _Float16* for vhTanpi const float* for vsTanpi const _Float16* for vmhTanpi const float* for vmsTanpi const double* for vdTanpi const double* for vmdTanpi	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`	_Float16* for vhTanpi float* for vsTanpi _Float16* for vmhTanpi float* for vmsTanpi double* for vdTanpi double* for vmdTanpi	Pointer to an array containing the output vector `y`.

Name

Type

Description

y

_Float16* for vhTanpi

float* for vsTanpi

_Float16* for vmhTanpi

float* for vmsTanpi

double* for vdTanpi

double* for vmdTanpi

Pointer to an array containing the output vector y.

Description

The v?Tanpi function computes the tangent of vector elements multiplied by π. For an argument x, the function computes tan(π*x).

Special values for Real Function v?Tanpi(x)
Argument	Result	VM Error Status	Exception
+0	+1
-0	+1
±∞	QNAN	VML_STATUS_ERRDOM	INVALID
`n`, even integer	copysign(0.0, `n`)
`n`, odd integer	copysign(0.0, -`n`)
`n` + 0.5, for `n` even integer and `n` + 0.5 representable	+∞
`n` + 0.5, for `n` odd integer and `n` + 0.5 representable	-∞
QNAN	QNAN
SNAN	QNAN		INVALID

The copysign(x, y) function returns the first vector argument x with the sign changed to match that of the second argument y.

Application Notes

If arguments abs(a_i) ≤ 2¹³ for single precision or abs(a_i ) ≤ 2⁶⁷ 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.

Parent topic: Trigonometric Functions

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

v?Tanpi

Syntax

Include Files

Input Parameters

Output Parameters

Description

Application Notes

See Also