dpnp.scipy.special.erfcinv

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

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

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

For full documentation refer to scipy.special.erfcinv.

Parameters:

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

Returns:

out -- The values of the inverse of the complementary 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.erfinv: Inverse of the error function.

Examples

>>> import dpnp as np
>>> x = np.linspace(0.0, 2.0, num=11)
>>> y = np.scipy.special.erfcinv(x)
>>> y
array([        inf,  0.9061938 ,  0.59511608,  0.37080716,  0.17914345,
        0.        , -0.17914345, -0.37080716, -0.59511608, -0.9061938 ,
              -inf])

Verify that erfc(erfcinv(x)) is x:

>>> np.scipy.special.erfc(y)
array([0. , 0.2, 0.4, 0.6, 0.8, 1. , 1.2, 1.4, 1.6, 1.8, 2. ])