evinv
Extreme value inverse cumulative distribution function
Syntax
X = evinv(P,mu,sigma)
[X,XLO,XUP] = evinv(P,mu,sigma,pcov,alpha)
Description
X = evinv(P,mu,sigma)
returns the inverse cumulative distribution function (cdf) for a type 1 extreme value distribution with location parametermu
and scale parametersigma
, evaluated at the values inP
.P
,mu
, andsigma
can be vectors, matrices, or multidimensional arrays that all have the same size. A scalar input is expanded to a constant array of the same size as the other inputs. The default values formu
andsigma
are0
and1
, respectively.
[X,XLO,XUP] = evinv(P,mu,sigma,pcov,alpha)
produces confidence bounds forX
when the input parametersmu
andsigma
are estimates.pcov
is the covariance matrix of the estimated parameters.alpha
is a scalar that specifies 100(1 –alpha
)% confidence bounds for the estimated parameters, and has a default value of 0.05.XLO
andXUP
are arrays of the same size asX
containing the lower and upper confidence bounds.
The functionevinv
computes confidence bounds forP
using a normal approximation to the distribution of the estimate
whereqis theP
th quantile from an extreme value distribution with parametersμ= 0andσ = 1. The computed bounds give approximately the desired confidence level when you estimatemu
,sigma
, andpcov
from large samples, but in smaller samples other methods of computing the confidence bounds might be more accurate.
The type 1 extreme value distribution is also known as the Gumbel distribution. The version used here is suitable for modeling minima; the mirror image of this distribution can be used to model maxima by negatingX
. SeeExtreme Value Distributionfor more details. Ifxhas a Weibull distribution, thenX= log(x) has the type 1 extreme value distribution.