naginterfaces.library.stat.inv_​cdf_​students_​t_​vector

naginterfaces.library.stat.inv_cdf_students_t_vector(tail, p, df)[source]

inv_cdf_students_t_vector returns a number of deviates associated with given probabilities of Student’s -distribution with real degrees of freedom.

For full information please refer to the NAG Library document for g01tb

https://www.nag.com/numeric/nl/nagdoc_28.4/flhtml/g01/g01tbf.html

Parameters
tailstr, length 1, array-like, shape

Indicates which tail the supplied probabilities represent. For , for :

The lower tail probability, i.e., .

The upper tail probability, i.e., .

The two tail (confidence interval) probability, i.e., .

The two tail (significance level) probability, i.e., .

pfloat, array-like, shape

, the probability of the required Student’s -distribution as defined by .

dffloat, array-like, shape

, the degrees of freedom of the Student’s -distribution.

Returns
tfloat, ndarray, shape

, the deviates for the Student’s -distribution.

ivalidint, ndarray, shape

indicates any errors with the input arguments, with

No error.

On entry, invalid value supplied in when calculating .

On entry, , or, .

On entry, .

The solution has failed to converge. The result returned should represent an approximation to the solution.

Raises
NagValueError
(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

(errno )

On entry, .

Constraint: .

Warns
NagAlgorithmicWarning
(errno )

On entry, at least one value of , or was invalid, or the solution failed to converge.

Check for more information.

Notes

The deviate, associated with the lower tail probability, , of the Student’s -distribution with degrees of freedom is defined as the solution to

For or the integral equation is easily solved for .

For other values of a transformation to the beta distribution is used and the result obtained from inv_cdf_beta().

For an inverse asymptotic expansion of Cornish–Fisher type is used. The algorithm is described by Hill (1970).

The input arrays to this function are designed to allow maximum flexibility in the supply of vector arguments by re-using elements of any arrays that are shorter than the total number of evaluations required. See the G01 Introduction for further information.

References

Hastings, N A J and Peacock, J B, 1975, Statistical Distributions, Butterworth

Hill, G W, 1970, Student’s -distribution, Comm. ACM (13(10)), 617–619