dpnp.scipy.special.erfinv¶

dpnp.scipy.special.erfinv = <DPNPUnaryFunc 'erfinv'>¶

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{None, dpnp.ndarray, usm_ndarray, tuple of ndarray}, optional

Optional output array for the function values. A tuple (possible only as a keyword argument) must have length equal to the number of outputs.

Default: None.

Returns:

outdpnp.ndarray: The values of the inverse of the error function at the given points x.

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