Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
v?Erf
Computes the error function value of vector elements.
Syntax
call vserf(n, a, y)
call vserfi(n, a, inca, y, incy)
call vmserf(n, a, y, mode)
call vmserfi(n, a, inca, y, incy, mode)
call vderf(n, a, y)
call vderfi(n, a, inca, y, incy)
call vmderf(n, a, y, mode)
call vmderfi(n, a, inca, y, incy, mode)
Include Files
mkl_vml.f90
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
Specifies the number of elements to be calculated. |
|
a |
Fortran 77: DOUBLE PRECISION for vderf , vmderfFortran 90: REAL , INTENT(IN) for vserf , vmserfFortran 90: DOUBLE PRECISION , INTENT(IN) for vderf , vmderf |
Array, specifies the input vector a . |
inca , incy |
INTEGER, INTENT(IN) |
Specifies increments for the elements of a and y . |
mode |
Overrides global VM mode setting for this function call. See vmlSetMode (Sets a new mode for VM functions according to the mode parameter and stores the previous VM mode to oldmode.) for possible values and their description. |
Output Parameters
Name |
Type |
Description |
|---|---|---|
y |
Fortran 77: DOUBLE PRECISION for vderf , vmderfFortran 90: REAL , INTENT(OUT) for vserf , vmserfFortran 90: DOUBLE PRECISION , INTENT(OUT) for vderf , vmderf |
Array, specifies the output vector y . |
Description
vsErf vdErf vmsErf vmdErf
The Erf function computes the error function values for elements of the input vector a and writes them to the output vector y .
The error function is defined as given by:
Useful relations:
where erfc is the complementary error function.
where
is the cumulative normal distribution function.
where Φ^{-1}(x) and erf^{-1}(x) are the inverses to Φ(x) and erf(x) respectively.
The following figure illustrates the relationships among Erf family functions ( Erf , Erfc , CdfNorm ).