Generate a random number generator for Student deviates (tdeviates)
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.
stats::tRandom(a
, <Seed = s
>)
stats::tRandom(a)
returns a procedure that
produces tdeviates (random numbers)
with shape parameter ('degrees of freedom') a>0
.
The procedure f := stats::tRandom(a)
can
be called in the form f()
. The return value of f()
is
either a floatingpoint number or a symbolic expression:
If a
can be converted to a positive floating
point number, then f()
returns a real floating
point number.
In all other cases, stats::tRandom(a)()
is
returned symbolically.
Numerical values of a
are only accepted if
they are real and positive.
The values X = f()
are distributed randomly
according to the cumulative distribution function of the tdistribution
with shape parameter a
. For any real x,
the probability that X ≤ x is
given by
.
Without the option Seed
= s
,
an initial seed is chosen internally. This initial seed is set to
a default value when MuPAD^{®} is started. Thus, each time MuPAD is
started or reinitialized with the reset
function, random generators produce
the same sequences of numbers.
Note:
In contrast to the function 
For efficiency, it is recommended to produce sequences of K random numbers via
f := stats::tRandom(a): f() $k = 1..K;
rather than by
stats::tRandom(a)() $k = 1..K;
The latter call produces a sequence of generators each of which is called once. Also note that
stats::tRandom(a, Seed = n)() $k = 1..K;
does not produce a random sequence, because a sequence of freshly initialized generators would be created each of them producing the same number.
The function is sensitive to the environment variable DIGITS
which
determines the numerical working precision.
We generate tdeviates with shape parameter a
= 23:
f := stats::tRandom(23): f() $ k = 1..4
delete f:
With symbolic parameters, no random floatingpoint numbers can be produced:
f := stats::tRandom(a): f()
When the shape parameter a
evaluates to a
positive real number, f
starts to produce random
floatingpoint numbers:
a := sqrt(99): f() $ k = 1..4
delete f, a:
We use the option Seed
= s
to
reproduce a sequence of random numbers:
f := stats::tRandom(PI, Seed = 1): f() $ k = 1..4
g := stats::tRandom(PI, Seed = 1): g() $ k = 1..4
f() = g(), f() = g()
delete f, g:

The shape parameter: an arithmetical expression representing a positive real value 

Option, specified as Initializes the random generator with the integer seed This option serves for generating generators that return predictable
sequences of pseudorandom numbers. The generator is initialized with
the seed When this option is used, the shape parameter 