<< distfun_normcdf Normal distfun_normpdf >>

Distfun >> Distfun > Normal > distfun_norminv

distfun_norminv

Normal Inverse CDF

Calling Sequence

x = distfun_norminv ( p )
x = distfun_norminv ( p , mu , sigma )
x = distfun_norminv ( p , mu , sigma , lowertail )

Parameters

p :

a 1x1 or nxm matrix of doubles, the probability

mu :

a 1x1 or nxm matrix of doubles, the mean (default mu = 0)

sigma :

a 1x1 or nxm matrix of doubles, the standard deviation (default sigma = 1)

lowertail :

a 1x1 matrix of booleans, the tail (default lowertail=%t). If lowertail is true (the default), then considers P(X<x) otherwise P(X>x).

x :

a nxm matrix of doubles, the outcome

Description

Computes the inverse Normal cumulated probability distribution function of the Normal (Laplace-Gauss) function.

Any scalar input argument is expanded to a matrix of doubles of the same size as the other input arguments.

Examples

// Test with default mu, sigma
x = distfun_norminv ( [0.5 0.9 0.7] )
expected = [ ..
0.000000000000000 , ..
1.281551565544601 , ..
0.524400512708041 ..
]

// Test argument expansion
x=distfun_norminv([0.5 0.9 0.7],1.0,2.0)
expected = [ ..
1.00000000000000 , ..
3.56310313108920 , ..
2.04880102541608 ..
]

// Test with expanded arguments
x=distfun_norminv([0.5 0.9 0.7],[1 1 1],[2 2 2])
expected = [ ..
1.00000000000000 , ..
3.56310313108920 , ..
2.04880102541608 ..
]

// See upper tail
x=distfun_norminv(0.0001,1.,2.,%f)
// See an extreme case
x=distfun_norminv(1.e-20,1.,2.,%f)

Authors


<< distfun_normcdf Normal distfun_normpdf >>