Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

stats::lognormalQuantile

Quantile function of the log-normal distribution

MuPAD® notebooks are not recommended. Use MATLAB® live scripts instead.

MATLAB live scripts support most MuPAD functionality, though there are some differences. For more information, see Convert MuPAD Notebooks to MATLAB Live Scripts.

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: Argument x must be between 0 and 1. [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.

Was this topic helpful?