Computes the inverse complementary error function value of vector elements.
Syntax
Fortran:
call vserfcinv( n, a, y )
call vmserfcinv( n, a, y, mode )
call vderfcinv( n, a, y )
call vmderfcinv( n, a, y, mode )
C:
vsErfcInv( n, a, y );
vmsErfcInv( n, a, y, mode );
vdErfcInv( n, a, y );
vmdErfcInv( n, a, y, mode );
Include Files
The FORTRAN 77 interfaces are specified in the mkl_vml.f77 include file, the Fortran 90 interfaces are specified in the mkl_vml.f90 include file, and the C interfaces are specified in the mkl_vml_functions.h include file.
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
FORTRAN 77: INTEGER Fortran 90: INTEGER, INTENT(IN) C: const int |
Specifies the number of elements to be calculated. |
a |
FORTRAN 77: REAL for vserfcinv, vmserfcinv DOUBLE PRECISION for vderfcinv, vmderfcinv Fortran 90: REAL, INTENT(IN) for vserfcinv, vmserfcinv DOUBLE PRECISION, INTENT(IN) for vderfcinv, vmderfcinv C: const float* for vsErfcInv, vmsErfcInv const double* for vdErfcInv, vmdErfcInv |
FORTRAN: Array that specifies the input vector a. C: Pointer to an array that contains the input vector a. |
mode |
FORTRAN 77: INTEGER*8 Fortran 90: INTEGER(KIND=8), INTENT(IN) C: const MKL_INT64 |
Overrides global VML mode setting for this function call. See SetMode for possible values and their description. |
Output Parameters
Name |
Type |
Description |
|---|---|---|
y |
FORTRAN 77: REAL for vserfcinv, vmserfcinv DOUBLE PRECISION for vderfcinv, vmderfcinv Fortran 90: REAL, INTENT(OUT) for vserfcinv, vmserfcinv DOUBLE PRECISION, INTENT(OUT) for vderfcinv, vmderfcinv C: float* for vsErfcInv, vmsErfcInv double* for vdErfcInv, vmdErfcInv |
FORTRAN: Array that specifies the output vector y. C: Pointer to an array that contains 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:
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 | VML 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 |