Visible to Intel only — GUID: GUID-896EBA1F-7FA5-4F4F-9497-07900BF5A452
Visible to Intel only — GUID: GUID-896EBA1F-7FA5-4F4F-9497-07900BF5A452
v?ErfcInv
Computes the inverse complementary error function value of vector elements.
Syntax
call vserfcinv( n, a, y )
call vserfcinvi(n, a, inca, y, incy)
call vmserfcinv( n, a, y, mode )
call vmserfcinvi(n, a, inca, y, incy, mode)
call vderfcinv( n, a, y )
call vderfcinvi(n, a, inca, y, incy)
call vmderfcinv( n, a, y, mode )
call vmderfcinvi(n, a, inca, y, incy, mode)
Include Files
- mkl_vml.f90
Input Parameters
Name |
Type |
Description |
---|---|---|
n |
INTEGER, INTENT(IN) |
Specifies the number of elements to be calculated. |
a |
DOUBLE PRECISION for vderfcinv, vmderfcinv REAL, INTENT(IN) for vserfcinv, vmserfcinv DOUBLE PRECISION, INTENT(IN) for vderfcinv, vmderfcinv |
Array that specifies the input vector a. |
inca, incy |
INTEGER, INTENT(IN) |
Specifies increments for the elements of a and y. |
mode |
INTEGER(KIND=8), INTENT(IN) |
Overrides global VM mode setting for this function call. See vmlSetMode for possible values and their description. |
Output Parameters
Name |
Type |
Description |
---|---|---|
y |
DOUBLE PRECISION for vderfcinv, vmderfcinv REAL, INTENT(OUT) for vserfcinv, vmserfcinv DOUBLE PRECISION, INTENT(OUT) for vderfcinv, vmderfcinv |
Array that specifies the output vector y. |
Description
The ErfcInv function computes the inverse complimentary error function values for elements of the input vector a and writes them to the output vector y.
The inverse complementary error function is defined as given by:
![Equation](/content/dam/docs/us/en/developer-reference-fortran/2023-2/9BCB2B87-3DED-4764-A182-30A4FAA4A2E2-low.gif)
![Equation](/content/dam/docs/us/en/developer-reference-fortran/2023-2/5F24679E-82BB-4ECB-AC87-02FC7CF3C77F-low.jpg)
![Equation](/content/dam/docs/us/en/developer-reference-fortran/2023-2/788A8218-34E5-4625-8E51-A5D36A113D23-low.gif)
where erf(x) denotes the error function and erfinv(x) denotes the inverse error function.
See also Figure "ErfInv Family Functions Relationship" in ErfInv function description for ErfcInv function relationship with the other functions of ErfInv family.
Argument | Result | VM Error Status | Exception |
---|---|---|---|
+1 | +0 | ||
+2 | -∞ | VML_STATUS_SING | ZERODIVIDE |
-0 | +∞ | VML_STATUS_SING | ZERODIVIDE |
+0 | +∞ | VML_STATUS_SING | ZERODIVIDE |
X < -0 | QNAN | VML_STATUS_ERRDOM | INVALID |
X > +2 | QNAN | VML_STATUS_ERRDOM | INVALID |
+∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
-∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
QNAN | QNAN | ||
SNAN | QNAN | INVALID |