Description Usage Arguments Details Value Note Author(s) References See Also Examples
Density, distribution function, quantile function, and random generation
for the threeparameter lognormal distribution with parameters meanlog
,
sdlog
, and threshold
.
1 2 3 4 
x 
vector of quantiles. 
q 
vector of quantiles. 
p 
vector of probabilities between 0 and 1. 
n 
sample size. If 
meanlog 
vector of means of the distribution of the random variable on the log scale.
The default is 
sdlog 
vector of (positive) standard deviations of the random variable on the log scale.
The default is 
threshold 
vector of thresholds of the random variable on the log scale. The default
is 
The threeparameter lognormal distribution is simply the usual twoparameter lognormal distribution with a location shift.
Let X be a random variable with a threeparameter lognormal distribution
with parameters meanlog=
μ, sdlog=
σ, and
threshold=
γ. Then the random variable Y = X  γ
has a lognormal distribution with parameters
meanlog=
μ and sdlog=
σ. Thus,
dlnorm3
calls dlnorm
using the arguments
x = x  threshold
, meanlog = meanlog
,
sdlog = sdlog
plnorm3
calls plnorm
using the arguments
q = q  threshold
, meanlog = meanlog
, sdlog = sdlog
qlnorm3
calls qlnorm
using the arguments
q = q
, meanlog = meanlog
, sdlog = sdlog
and then adds
the argument threshold
to the result.
rlnorm3
calls rlnorm
using the arguments
n = n
, meanlog = meanlog
, sdlog = sdlog
and then adds
the argument threshold
to the result.
The threshold parameter γ affects only the location of the threeparameter lognormal distribution; it has no effect on the variance or the shape of the distribution.
Denote the mean, variance, and coefficient of variation of Y = X  γ by:
E(Y) = θ
Var(Y) = η^2
CV(Y) = τ = η/θ
Then the mean, variance, and coefficient of variation of X are given by:
E(X) = θ + η
Var(X) = η^2
CV(X) = \frac{η}{θ + γ} = \frac{τ θ}{θ + γ}
The relationships between the parameters μ, σ, θ, η, and τ are as follows:
θ = β √{ω}
η = β √{ω (ω  1)}
τ = √{ω  1}
μ = log(\frac{θ}{√{τ^2 + 1}})
σ = √{log(τ^2 + 1)}
where
β = e^μ, ω = exp(σ^2)
Since quantiles of a distribution are preserved under monotonic transformations, the median of X is:
Median(X) = γ + β
dlnorm3
gives the density, plnorm3
gives the distribution function,
qlnorm3
gives the quantile function, and rlnorm3
generates random
deviates.
The twoparameter lognormal distribution is the distribution of a random variable whose logarithm is normally distributed. The two major characteristics of the twoparameter lognormal distribution are that it is bounded below at 0, and it is skewed to the right. The threeparameter lognormal distribution is a generalization of the twoparameter lognormal distribution in which the distribution is shifted so that the threshold parameter is some arbitrary number, not necessarily 0.
The threeparameter lognormal distribution was introduced by Wicksell (1917) in a study of the distribution of ages at first marriage. Both the two and threeparameter lognormal distributions have been used in a variety of fields, including economics and business, industry, biology, ecology, atmospheric science, and geology (Crow and Shimizu, 1988). Royston (1992) has discussed the application of the threeparameter lognormal distribution in the field of medicine.
The twoparameter lognormal distribution is often used to characterize chemical concentrations in the environment. Ott (1990) has shown mathematically how a series of successive random dilutions gives rise to a distribution that can be approximated by a twoparameter lognormal distribution.
The threepararameter lognormal distribution starts to resemble a normal distribution as the parameter σ (the standard deviation of log(Xγ) tends to 0.
Steven P. Millard (EnvStats@ProbStatInfo.com)
Aitchison, J., and J.A.C. Brown (1957). The Lognormal Distribution (with special references to its uses in economics). Cambridge University Press, London, 176pp.
Crow, E.L., and K. Shimizu. (1988). Lognormal Distributions: Theory and Applications. Marcel Dekker, New York, 387pp.
Forbes, C., M. Evans, N. Hastings, and B. Peacock. (2011). Statistical Distributions. Fourth Edition. John Wiley and Sons, Hoboken, NJ.
Johnson, N. L., S. Kotz, and N. Balakrishnan. (1994). Continuous Univariate Distributions, Volume 1. Second Edition. John Wiley and Sons, New York.
Ott, W.R. (1990). A Physical Explanation of the Lognormality of Pollutant Concentrations. Journal of the Air and Waste Management Association 40, 1378–1383.
Ott, W.R. (1995). Environmental Statistics and Data Analysis. Lewis Publishers, Boca Raton, FL, Chapter 9.
Royston, J.P. (1992b). Estimation, Reference Ranges and Goodness of Fit for the ThreeParameter LogNormal Distribution. Statistics in Medicine 11, 897–912.
Wicksell, S.D. (1917). On Logarithmic Correlation with an Application to the Distribution of Ages at First Marriage. Medd. Lunds. Astr. Obs. 84, 1–21.
Lognormal, elnorm3
,
Probability Distributions and Random Numbers.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31  # Density of the threeparameter lognormal distribution with
# parameters meanlog=1, sdlog=2, and threshold=10, evaluated at 10.5:
dlnorm3(10.5, 1, 2, 10)
#[1] 0.278794
#
# The cdf of the threeparameter lognormal distribution with
# parameters meanlog=2, sdlog=3, and threshold=5, evaluated at 9:
plnorm3(9, 2, 3, 5)
#[1] 0.4189546
#
# The median of the threeparameter lognormal distribution with
# parameters meanlog=2, sdlog=3, and threshold=20:
qlnorm3(0.5, 2, 3, 20)
#[1] 27.38906
#
# Random sample of 3 observations from the threeparameter lognormal
# distribution with parameters meanlog=2, sdlog=1, and threshold=5.
# (Note: the call to set.seed simply allows you to reproduce this example.)
set.seed(20)
rlnorm3(3, 2, 1, 5)
#[1] 18.6339749 0.8873173 39.0561521

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.
Please suggest features or report bugs in the GitHub issue tracker.
All documentation is copyright its authors; we didn't write any of that.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.