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 ).