rand

Scilab Function
Last update : 19/11/2004

rand - générateur de nombres aléatoires

### Calling Sequence

  `rand(m1,m2,.. [,key])`
  `rand(x [, key])`
  `rand()`
  ``
  `rand(key)`
  `rand("seed" [,n])`
  `rand("info")`
  ``

### Parameters

- `mi` : entiers
- `key` : chaîne de caractères, `"uniform"` ou `"normal"` ("uniform" par défaut)
- `x` : une matrice, dont uniquement les dimensions sont prises en compte.

### Description

Générateur de nombres aléatoires.

Sans l'argument `key` la syntaxe ci-dessous produit une matrice aléatoire dont chaque élément est la réalisation d'une variable aléatoire suivant une loi donnée (par défaut uniforme sur [0,1]).

  rand(m1,m2) est une matrice aléatoire de dimensions `m1` x `m2`.
  rand(m1,m2,..,mn) est une matrice aléatoire de dimensions `m1` x `m2`,.. x `mn`.
  rand(a) est une matrice aléatoire de mêmes dimensions que a. `rand(a)` est complexe si `a` est une matrice complexe.
  rand() : sans argument, renvoie un scalaire aléatoire.

S'il est présent, l'argument `key` permet de spécifier la loi suivie par défaut par la variable aléatoire.

  rand('uniform') La loi par défaut est uniforme sur l'intervalle [0,1].
  rand('normal') La loi par défaut est une loi normale centrée réduite (moyenne 0, variance 1).
  str=rand('info') renvoie 'uniform' ou 'normal' suivant la loi définie par défaut (voir ci-dessus).

Il est possible de réinitialiser l'état interne du générateur aléatoire (spécifié par un entier de l'intervalle [0,2^31-1]) ):

  rand('seed') Renvoie la valeur courante de l'état interne.
  rand('seed',n) Impose la valeur `n` pour l'état interne (par défaut l'état est initialisé à `n=0` au premier appel).

### Remarque

Il est conseillé d'utiliser plutôt la fonction `grand` qui permet aussi de simuler les lois les plus classiques (binomiale, poisson, ....).

### Examples

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

### See Also

`grand`, `ssrand`,