dpnp.scipy.special.erfinv

dpnp.scipy.special.erfinv(x, out=None)

Calculates the inverse of the Gauss error function of a given input array.

It is defined as \(\operatorname{erf}^{-1}(x)\).

For full documentation refer to scipy.special.erfinv.

Parameters:

x ({dpnp.ndarray, usm_ndarray}) -- Input array, expected to have a real-valued floating-point data type. Domain: [-1, 1].
out ({dpnp.ndarray, usm_ndarray}, optional) -- Optional output array for the function values.

Returns:

out -- The values of the inverse of the error function at the given points x.

Return type:

dpnp.ndarray

See also

dpnp.scipy.special.erf: Gauss error function.
dpnp.scipy.special.erfc: Complementary error function.
dpnp.scipy.special.erfcx: Scaled complementary error function.
dpnp.scipy.special.erfcinv: Inverse of the complementary error function.

Examples

>>> import dpnp as np
>>> x = np.linspace(-1.0, 1.0, num=9)
>>> y = np.scipy.special.erfinv(x)
>>> y
array([       -inf, -0.81341985, -0.47693628, -0.22531206,  0.        ,
        0.22531206,  0.47693628,  0.81341985,         inf])

Verify that erf(erfinv(x)) is x:

>>> np.scipy.special.erf(y)
array([-1.  , -0.75, -0.5 , -0.25,  0.  ,  0.25,  0.5 ,  0.75,  1.  ])