Documentation Center

  • Trial Software
  • Product Updates

stats::lognormalQuantile

Quantile function of the log-normal distribution

Use only in the MuPAD Notebook Interface.

This functionality does not run in MATLAB.

Syntax

stats::lognormalQuantile(m, v)

Description

stats::normalQuantile(m, v) returns a procedure representing the quantile function (inverse) of the cumulative distribution function stats::lognormalCDF(m, v) of the log-normal distribution with location parameter m and shape parameter v > 0: For 0 ≤ x ≤ 1, the solution of stats::lognormalCDF(m, v)(y) = x is given by y = stats::lognormalQuantile(m, v)(x).

The procedure f := stats::lognormalQuantile(m, v) can be called in the form f(x) with an arithmetical expression x. The return value of f(x) is either a floating-point number, 0, infinity, or a symbolic expression:

If x is a real number between 0 and 1 and both m and v can be converted to floating-point numbers, then f(x) returns a real floating-point number approximating the solution y of stats::lognormalCDF(m, v)(y) = x.

The call f(0) returns 0.

The calls f(1) and f(1.0) produce infinity for all values of m and v.

In all other cases, f(x) returns the symbolic call stats::lognormalQuantile(m, v)(x).

Numerical values for m and v are only accepted if they are real and v is positive.

Environment Interactions

The function is sensitive to the environment variable DIGITS which determines the numerical working precision.

Examples

Example 1

We evaluate the quantile function with location parameter m = π and shape parameter v = 11 at various points:

f := stats::lognormalQuantile(PI, 11):
f(0), f(1/10), f(0.5), f(1 - 10^(-10)), f(1)

The value f(x) satisfies stats::lognormalCDF(PI, 11)(f(x)) = x:

stats::lognormalCDF(PI, 11)(f(0.987654))

delete f:

Example 2

We use symbolic arguments:

f := stats::lognormalQuantile(m, v):
f(x), f(9/10)

When numerical values are assigned to m and v, the function f starts to produce floating-point values:

m := 17: v := 6:
f(9/10), f(0.999)

Numerical values for x are only accepted if 0 ≤ x ≤ 1:

f(0.5)

f(2)
Error: An argument x with 0 <= x <= 1 is expected. [f]
delete f, m, v:

Parameters

m

The location parameter: an arithmetical expression representing a real value

v

The shape parameter: an arithmetical expression representing a positive real value

Return Values

procedure.

See Also

MuPAD Functions

Was this topic helpful?