v?Sinh
v?Sinh
Computes hyperbolic sine of vector elements.
Syntax
vsSinh
(
n
,
a
,
y
)
;
vsSinhI(n, a, inca, y, incy);
vmsSinh
(
n
,
a
,
y
,
mode
)
;
vmsSinhI(n, a, inca, y, incy, mode);
vdSinh
(
n
,
a
,
y
)
;
vdSinhI(n, a, inca, y, incy);
vmdSinh
(
n
,
a
,
y
,
mode
)
;
vmdSinhI(n, a, inca, y, incy, mode);
vcSinh
(
n
,
a
,
y
)
;
vcSinhI(n, a, inca, y, incy);
vmcSinh
(
n
,
a
,
y
,
mode
)
;
vmcSinhI(n, a, inca, y, incy, mode);
vzSinh
(
n
,
a
,
y
)
;
vzSinhI(n, a, inca, y, incy);
vmzSinh
(
n
,
a
,
y
,
mode
)
;
vmzSinhI(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 vsSinh , vmsSinh const double* for vdSinh , vmdSinh const MKL_Complex8* for vcSinh , vmcSinh const MKL_Complex16* for vzSinh , vmzSinh | Pointer to an array that contains the input vector a . |
inca , incy | const MKL_INT | Specifies increments for the elements of a and y . |
mode | const MKL_INT64 | Overrides global VM mode setting for this function call. See vmlSetMode for possible values and their description. |
Data Type | Threshold Limitations on Input Parameters |
---|---|
single precision | -Ln(FLT_MAX)-Ln2
< a [i] < Ln(FLT_MAX)+Ln2 |
double precision | -Ln(DBL_MAX)-Ln2 < a [i] < Ln(DBL_MAX)+Ln2 |
Precision overflow thresholds for the complex
v?Sinh
function are beyond the scope of this document.Output Parameters
Name | Type | Description |
---|---|---|
y | float* for vsSinh , vmsSinh double* for vdSinh , vmdSinh MKL_Complex8* for vcSinh , vmcSinh MKL_Complex16* for vzSinh , vmzSinh | Pointer to an array that contains the output vector y . |
Description
The
v?Sinh
function computes hyperbolic sine of vector elements.Argument | Result | VM Error Status | Exception |
---|---|---|---|
+0 | +0 | ||
-0 | -0 | ||
X > overflow | + ∞ | VML_STATUS_OVERFLOW | OVERFLOW |
X < -overflow | - ∞ | VML_STATUS_OVERFLOW | OVERFLOW |
+ ∞ | + ∞ | ||
- ∞ | - ∞ | ||
QNAN | QNAN | ||
SNAN | QNAN | INVALID |
See
Special Value Notations
for the conventions used in the table below.
RE(z) i · IM(z) | - ∞ | -X | -0 | +0 | +X | + ∞ | NAN |
---|---|---|---|---|---|---|---|
+i · ∞ | - ∞ +i· QNANINVALID | QNAN+i · QNANINVALID | -0+i · QNANINVALID | +0+i · QNANINVALID | QNAN+i · QNANINVALID | + ∞ +i· QNANINVALID | QNAN+i · QNAN |
+i · Y | - ∞ · Cos(Y)+ i· ∞ · Sin(Y) | + ∞ · | QNAN+i · QNAN | ||||
+i · 0 | - ∞ +i· 0 | -0+i · 0 | +0+i · 0 | + ∞ +i· 0 | QNAN+i · 0 | ||
-i · 0 | - ∞ -i· 0 | -0-i · 0 | +0-i · 0 | + ∞ -i· 0 | QNAN-i · 0 | ||
-i · Y | - ∞ · Cos(Y)+ i· ∞ · Sin(Y) | + ∞ · | QNAN+i · QNAN | ||||
-i · ∞ | - ∞ +i· QNANINVALID | QNAN+i · QNANINVALID | -0+i · QNANINVALID | +0+i · QNANINVALID | QNAN+i · QNANINVALID | + ∞ +i· QNANINVALID | QNAN+i · QNAN |
+i · NAN | - ∞ +i· QNAN | QNAN+i · QNAN | -0+i · QNAN | +0+i · QNAN | QNAN+i · QNAN | + ∞ +i· QNAN | QNAN+i · QNAN |
Notes:
- raises theINVALIDexception when the real or imaginary part of the argument isSNAN
- raises theOVERFLOWexception and sets the VM Error Status toVML_STATUS_OVERFLOWin the case of overflow, that is, whenRE(z),IM(z)are finite non-zero numbers, but the real or imaginary part of the exact result is so large that it does not meet the target precision.
- Sinh(CONJ(z))=CONJ(Sinh(z))
- Sinh(-z)=-Sinh(z).