Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: Français - Português do Brasil - 日本語 -

Please note that the recommended version of Scilab is 5.5.0. This page might be outdated.
See the recommended documentation of this function

Scilab help >> Elementary Functions > Elementary matrices > rand

rand

random number generator

Calling Sequence

rand(m1,m2,.. [,key])
rand(x [, key])
rand()

rand(key)
rand("seed" [,n])
rand("info")

Arguments

mi

integers

key

character string with value in "uniform", "normal"

x

a matrix. Only its dimensions are taken into account.

Description

random matrix generator.

Warning: without a seed, the sequence will remain the same from a session to the other.

At the beginning of each script using rand function, you should use:

rand('seed',getdate('s'))

Without key argument the syntaxes below produce random matrices with the current random generator (default is "uniform")

rand(m1,m2)

is a random matrix of dimension m1 by m2.

rand(m1,m2,..,mn)

is a random matrix of dimension m1 by m2,.. by mn.

rand(a)

is a random matrix of same size as a. rand(a) is complex if a is a complex matrix.

rand() : with no arguments gives a scalar whose value changes

each time it is referenced.

If present, the key argument allows to specifie an other random distribution.

rand('uniform')

The current random generator is set to a uniform random generator. Random numbers are uniformly distributed in the interval (0,1).

rand('normal')

The current random generator is set to a Gaussian (with mean 0 and variance 1) random number generator.

str=rand('info')

return the type of the default random generator ('uniform' or 'normal')

IT is possible to (re-)initialize the seed of the rand generator:

rand('seed')

returns the current value of the seed.

rand('seed',n)

puts the seed to n. (by default n=0 at first call).

Remark

Use the more powerful function grand instead.

Examples

x=rand(10,10,'uniform')
rand('normal')
rand('info')
y=rand(x,'normal');
x=rand(2,2,2)

See Also

  • grand — Random number generator(s)
  • ssrand — random system generator

Comments


Add a comment:
Please login to comment this page.

<< ones Elementary matrices sub2ind >>

Scilab Enterprises
Copyright (c) 2011-2014 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:09:38 CEST 2011