3.7.10 metals.inc, golds.inc |
POV-Ray 3.6 for UNIX documentation 3.7.11 rand.inc |
3.7.12 shapes.inc, shapes_old.inc, shapes2.inc, shapesq.inc |
A collection of macros for generating random numbers, as well as 4 predefined random number streams: RdmA,
RdmB, RdmC,
and RdmD
. There are macros for creating random numbers in a flat distribution (all
numbers equally likely) in various ranges, and a variety of other distributions.
SRand(Stream)
. "Signed rand()", returns random numbers in the range [-1, 1].
Parameters:
Stream
= Random number stream.
RRand(Min, Max, Stream)
. Returns random numbers in the range [Min, Max].
Parameters:
Min
= The lower end of the output range.
Max
= The upper end of the output range.
Stream
= Random number stream.
VRand(Stream)
. Returns random vectors in a box from < 0, 0, 0> to < 1, 1, 1>
Parameters:
Stream
= Random number stream.
VRand_In_Box(PtA, PtB, Stream)
. Like VRand(), this macro returns a random vector in a box, but this
version lets you specify the two corners of the box.
Parameters:
PtA
= Lower-left-bottom corner of box.
PtB
= Upper-right-top corner of box.
Stream
= Random number stream.
VRand_In_Sphere(Stream)
. Returns a random vector in a unit-radius sphere located at the origin.
Parameters:
Stream
= Random number stream.
VRand_On_Sphere(Stream)
. Returns a random vector on the surface of a unit-radius sphere located at the
origin.
Parameters:
Stream
= Random number stream.
VRand_In_Obj(Object, Stream)
This macro takes a solid object and returns a random point that is inside
it. It does this by randomly sampling the bounding box of the object, and can be quite slow if the object occupies a
small percentage of the volume of its bounding box (because it will take more attempts to find a point inside the
object). This macro is best used on finite, solid objects (non-solid objects, such as meshes and bezier patches, do
not have a defined "inside", and will not work).
Parameters:
Object
= The object the macro chooses the points from.
Stream
= Random number stream.
Rand_Cauchy(Mu, Sigma, Stream)
. Cauchy distribution.
Parameters:
Mu
= Mean.
Sigma
= Standard deviation.
Stream
= Random number stream.
Rand_Student(N, Stream)
. Student's-t distribution.
Parameters:
N
= degrees of freedom.
Stream
= Random number stream.
Rand_Normal(Mu, Sigma, Stream)
. Normal distribution.
Parameters:
Mu
= Mean.
Sigma
= Standard deviation.
Stream
= Random number stream.
Rand_Gauss(Mu, Sigma, Stream)
. Gaussian distribution. Like Rand_Normal(), but a bit faster.
Parameters:
Mu
= Mean.
Sigma
= Standard deviation.
Stream
= Random number stream.
Rand_Spline(Spline, Stream)
. This macro takes a spline describing the desired distribution. The T
value of the spline is the output value, and the .y value its chance of occuring.
Parameters:
Spline
= A spline determining the distribution.
Stream
= Random number stream.
Rand_Gamma(Alpha, Beta, Stream)
. Gamma distribution.
Parameters:
Alpha
= Shape parameter > 0.
Beta
= Scale parameter > 0.
Stream
= Random number stream.
Rand_Beta(Alpha, Beta, Stream)
. Beta variate.
Parameters:
Alpha
= Shape Gamma1.
Beta
= Scale Gamma2.
Stream
= Random number stream.
Rand_Chi_Square(N, Stream)
. Chi Square random variate.
Parameters:
N
= Degrees of freedom (integer).
Stream
= Random number stream.
Rand_F_Dist(N, M, Stream)
. F-distribution.
Parameters:
N, M
= Degrees of freedom.
Stream
= Random number stream.
Rand_Tri(Min, Max, Mode, Stream)
. Triangular distribution
Parameters:
Min, Max, Mode
: Min < Mode < Max.
Stream
= Random number stream.
Rand_Erlang(Mu, K, Stream)
. Erlang variate.
Parameters:
Mu
= Mean >= 0.
K
= Number of exponential samples.
Stream
= Random number stream.
Rand_Exp(Lambda, Stream)
. Exponential distribution.
Parameters:
Lambda
= rate = 1/mean.
Stream
= Random number stream.
Rand_Lognormal(Mu, Sigma, Stream)
. Lognormal distribution.
Parameters:
Mu
= Mean.
Sigma
= Standard deviation.
Stream
= Random number stream.
Rand_Pareto(Alpha, Stream)
. Pareto distribution.
Parameters:
Alpha
= ?
Stream
= Random number stream.
Rand_Weibull(Alpha, Beta, Stream)
. Weibull distribution.
Parameters:
Alpha
= ?
Beta
= ?
Stream
= Random number stream.
Rand_Bernoulli(P, Stream)
and Prob(P, Stream)
. Bernoulli distribution. Output is true
with probability equal to the value of P and false with a probability of 1 - P.
Parameters:
P
= probability range (0-1).
Stream
= Random number stream.
Rand_Binomial(N, P, Stream)
. Binomial distribution.
Parameters:
N
= Number of trials.
P
= Probability (0-1)
Stream
= Random number stream.
Rand_Geo(P, Stream)
. Geometric distribution.
Parameters:
P
= Probability (0-1).
Stream
= Random number stream.
Rand_Poisson(Mu, Stream)
. Poisson distribution.
Parameters:
Mu
= Mean.
Stream
= Random number stream.
3.7.10 metals.inc, golds.inc | 3.7.11 rand.inc | 3.7.12 shapes.inc, shapes_old.inc, shapes2.inc, shapesq.inc |