naginterfaces.library.stat.prob_students_t_vector¶
- naginterfaces.library.stat.prob_students_t_vector(tail, t, df)[source]¶
prob_students_t_vector
returns a number of one or two tail probabilities for the Student’s -distribution with real degrees of freedom.For full information please refer to the NAG Library document for g01sb
https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/g01/g01sbf.html
- Parameters
- tailstr, length 1, array-like, shape
Indicates which tail the returned probabilities should represent. For , for :
The lower tail probability is returned, i.e., .
The upper tail probability is returned, i.e., .
The two tail (confidence interval) probability is returned, i.e., .
The two tail (significance level) probability is returned, i.e., .
- tfloat, array-like, shape
, the values of the Student’s variates.
- dffloat, array-like, shape
, the degrees of freedom of the Student’s -distribution.
- Returns
- pfloat, ndarray, shape
, the probabilities 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, .
- 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.
Check for more information.
- Notes
The lower tail probability for the Student’s -distribution with degrees of freedom, is defined by:
Computationally, there are two situations:
when , a transformation of the beta distribution, is used
or
when , an asymptotic normalizing expansion of the Cornish–Fisher type is used to evaluate the probability, see 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
Abramowitz, M and Stegun, I A, 1972, Handbook of Mathematical Functions, (3rd Edition), Dover Publications
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