Package org.arakhne.afc.math.stochastic
Class LogNormalStochasticLaw
- java.lang.Object
-
- org.arakhne.afc.math.stochastic.StochasticLaw
-
- org.arakhne.afc.math.stochastic.LogNormalStochasticLaw
-
- All Implemented Interfaces:
MathFunction
,MathInversableFunction
,JsonableObject
public class LogNormalStochasticLaw extends StochasticLaw
Law that representes a gaussian density.Reference: Log-Normal Distribution.
This class uses the gaussian random number distribution provided by
Random
.- Since:
- 13.0
- Version:
- 17.0 2020-01-04 14:41:41
- Author:
- Christophe BOHRHAUER
- Maven Group Id:
- org.arakhne.afc.core
- Maven Artifact Id:
- mathstochastic
-
-
Field Summary
-
Fields inherited from class org.arakhne.afc.math.stochastic.StochasticLaw
NAME_NAME
-
-
Constructor Summary
Constructors Constructor Description LogNormalStochasticLaw(double mean1, double standardDeviation)
Constructor.LogNormalStochasticLaw(Map<String,String> parameters)
Construct a law with the following parameters.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description double
f(double x)
Replies the value of the function.MathFunctionRange[]
getRange()
Replies the range of the function.double
inverseF(double u)
Replies the x according to the value of the distribution function.protected double
inverseF(Random u)
Replies the x according to the value of the inverted cummulative distribution functionF<sup>-1</sup>(u)
whereu = U(0, 1)
.static double
random(double mean, double standardDeviation)
Replies a random value that respect the current stochastic law.void
toJson(JsonBuffer buffer)
Replies the Json representation of this node.-
Methods inherited from class org.arakhne.afc.math.stochastic.StochasticLaw
generateRandomValue, getLawName, paramBoolean, paramDouble, toString
-
-
-
-
Constructor Detail
-
LogNormalStochasticLaw
public LogNormalStochasticLaw(Map<String,String> parameters) throws OutsideDomainException, LawParameterNotFoundException
Construct a law with the following parameters.mean
standardDeviation
- Parameters:
parameters
- is the set of accepted paramters.- Throws:
LawParameterNotFoundException
- if the list of parameters does not permits to create the law.OutsideDomainException
- when standardDevisition is negative or nul.
-
LogNormalStochasticLaw
public LogNormalStochasticLaw(double mean1, double standardDeviation) throws OutsideDomainException
Constructor.- Parameters:
mean1
- is the mean of the normal distribution.standardDeviation
- is the standard deviation associated to the nromal distribution.- Throws:
OutsideDomainException
- when standardDevisition is negative or nul.
-
-
Method Detail
-
random
@Pure public static double random(double mean, double standardDeviation) throws MathException
Replies a random value that respect the current stochastic law.- Parameters:
mean
- is the mean of the normal distribution.standardDeviation
- is the standard deviation associated to the nromal distribution.- Returns:
- a value depending of the stochastic law parameters
- Throws:
MathException
- when error in the math definition.
-
f
@Pure public double f(double x) throws MathException
Description copied from interface:MathFunction
Replies the value of the function.- Parameters:
x
- the x.- Returns:
- the value of
f(x)
. - Throws:
MathException
- in casef(x)
could not be computed
-
getRange
@Pure public MathFunctionRange[] getRange()
Description copied from interface:MathFunction
Replies the range of the function.- Returns:
- a array of ranges. It corresponds to a list of couples that defined the set of valid values.
-
inverseF
@Pure public double inverseF(double u) throws MathException
Replies the x according to the value of the distribution function.- Specified by:
inverseF
in interfaceMathInversableFunction
- Specified by:
inverseF
in classStochasticLaw
- Parameters:
u
- is a value given by the uniform random variable generatorU(0, 1)
.- Returns:
F<sup>-1</sup>(u)
- Throws:
MathException
- in caseF<sup>-1</sup>(u)
could not be computed
-
inverseF
protected final double inverseF(Random u) throws MathException
Replies the x according to the value of the inverted cummulative distribution functionF<sup>-1</sup>(u)
whereu = U(0, 1)
.- Overrides:
inverseF
in classStochasticLaw
- Parameters:
u
- is the uniform random variable generatorU(0, 1)
.- Returns:
F<sup>-1</sup>(u)
- Throws:
MathException
- in caseF<sup>-1</sup>(u)
could not be computed
-
toJson
@Pure public void toJson(JsonBuffer buffer)
Description copied from interface:JsonableObject
Replies the Json representation of this node.- Parameters:
buffer
- the Json buffer.
-
-