Difference between revisions of "RandomGenerator:randomNormal"

m (Added missing second argument)
(Added examples of uniform/normal distributions (same as in love.math.randomNormal))
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=function}}
 
{{newin|[[0.9.0]]|090|type=function}}
Get a normally distributed pseudo random number.
+
Generates a [https://en.wikipedia.org/wiki/Normal_distribution normally-distributed] pseudo-random number.
 +
 
 +
While a typical uniform distribution looks like this:
 +
 
 +
[[File:uniform_distribution.png|frameless|border|A 1D example of a uniform distribution]]
 +
 
 +
[[File:uniform_distribution_2d.png|frameless|border|A 2D example of a uniform distribution]]
 +
 
 +
A typical normal distribution looks like this (note the values aggregating at the center, and the shape of a bell curve):
 +
 
 +
[[File:normal_distribution.png|frameless|border|A 1D example of a normal distribution]]
 +
 
 +
[[File:normal_distribution_2d.png|frameless|border|A 2D example of a normal distribution]]
 +
 
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 7: Line 20:
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|number|stddev|Standard deviation of the distribution.}}
+
{{param|number|stddev (1)|Standard deviation of the distribution.}}
 
{{param|number|mean (0)|The mean of the distribution.}}
 
{{param|number|mean (0)|The mean of the distribution.}}
 
=== Returns ===
 
=== Returns ===

Latest revision as of 20:07, 5 July 2022

Available since LÖVE 0.9.0
This function is not supported in earlier versions.

Generates a normally-distributed pseudo-random number.

While a typical uniform distribution looks like this:

A 1D example of a uniform distribution

A 2D example of a uniform distribution

A typical normal distribution looks like this (note the values aggregating at the center, and the shape of a bell curve):

A 1D example of a normal distribution

A 2D example of a normal distribution

Function

Synopsis

number = RandomGenerator:randomNormal( stddev, mean )

Arguments

number stddev (1)
Standard deviation of the distribution.
number mean (0)
The mean of the distribution.

Returns

number number
Normally distributed random number with variance (stddev)² and the specified mean.

See Also

Other Languages