rand

Numeri casuali distribuiti uniformemente

Sintassi

X = rand

X = rand(n)

X = rand(sz1,...,szN)

X = rand(sz)

X = rand(___,typename)

X = rand(___,like=p)

X = rand(s,___)

Descrizione

X = rand restituisce uno scalare casuale estratto dalla distribuzione uniforme nell'intervallo (0,1).

X = rand(n) restituisce una matrice n per n di numeri casuali distribuiti uniformemente.

X = rand(sz1,...,szN) restituisce un array sz1 x...x szN di numeri casuali dove sz1,...,szN indica la grandezza di ciascuna dimensione. Ad esempio, rand(3,4) restituisce una matrice 3x4.

X = rand(sz) restituisce un array di numeri casuali dove il vettore di dimensione sz definisce size(X). Ad esempio, rand([3 4]) restituisce una matrice 3x4.

X = rand(___,typename) restituisce un array di numeri casuali del tipo di dati typename. L’input typename può essere "single" o "double". È possibile utilizzare uno qualsiasi degli argomenti di input nelle sintassi precedenti.

X = rand(___,like=p) restituisce un array di numeri casuali come p; ossia, dello stesso tipo di dati e della stessa complessità (reale o complessa) di p. È possibile specificare typename o like, ma non entrambi.

X = rand(s,___) genera numeri dal flusso di numeri casuali s anziché dal flusso globale predefinito. Per creare un flusso, utilizzare RandStream. È possibile specificare s seguito da una qualsiasi combinazione di argomenti di input nelle sintassi precedenti.

Esempi

Matrice di numeri casuali

Generare una matrice 5x5 di numeri casuali distribuiti uniformemente tra 0 e 1.

r = rand(5)

r = 5×5

    0.8147    0.0975    0.1576    0.1419    0.6557
    0.9058    0.2785    0.9706    0.4218    0.0357
    0.1270    0.5469    0.9572    0.9157    0.8491
    0.9134    0.9575    0.4854    0.7922    0.9340
    0.6324    0.9649    0.8003    0.9595    0.6787

Numeri casuali entro un intervallo specificato

Generare un vettore colonna 10x1 di numeri distribuiti uniformemente nell'intervallo (-5,5). È possibile generare n numeri casuali nell'intervallo (a,b) con la formula r = a + (b-a).*rand(n,1).

a = -5;
b = 5;
n = 10;
r = a + (b-a).*rand(n,1)

r = 10×1

    3.1472
    4.0579
   -3.7301
    4.1338
    1.3236
   -4.0246
   -2.2150
    0.4688
    4.5751
    4.6489

Numeri interi casuali

Utilizzare la funzione randi (anziché rand) per generare 5 numeri interi casuali distribuiti uniformemente tra 10 e 50.

r = randi([10 50],1,5)

r = 1×5

    43    47    15    47    35

Reset del generatore di numeri casuali

Salvare lo stato attuale del generatore di numeri casuali e creare un vettore 1x5 di numeri casuali.

s = rng;
r = rand(1,5)

r = 1×5

    0.8147    0.9058    0.1270    0.9134    0.6324

Ripristinare lo stato del generatore di numeri casuali su s, quindi creare un nuovo vettore 1x5 di numeri casuali. I valori sono uguali a quelli precedenti.

rng(s);
r1 = rand(1,5)

r1 = 1×5

    0.8147    0.9058    0.1270    0.9134    0.6324

Array tridimensionale di numeri casuali

Creare un array 3x2x3 di numeri casuali.

X = rand([3,2,3])

X = 
X(:,:,1) =

    0.8147    0.9134
    0.9058    0.6324
    0.1270    0.0975


X(:,:,2) =

    0.2785    0.9649
    0.5469    0.1576
    0.9575    0.9706


X(:,:,3) =

    0.9572    0.1419
    0.4854    0.4218
    0.8003    0.9157

Specificare il tipo di dati dei numeri casuali

Creare un vettore 1x4 di numeri casuali i cui elementi sono a precisione singola.

r = rand(1,4,"single")

r = 1×4 single row vector

    0.8147    0.9058    0.1270    0.9134

class(r)

ans = 
'single'

Grandezza definita dall'array esistente

Creare una matrice di numeri casuali distribuiti uniformemente con la stessa dimensione di un array esistente.

A = [3 2; -2 1];
sz = size(A);
X = rand(sz)

X = 2×2

    0.8147    0.1270
    0.9058    0.9134

È prassi comune combinare le due righe di codice precedenti in un'unica riga:

X = rand(size(A));

Dimensione e tipo di dati definiti dall’array esistente

Creare una matrice 2x2 di numeri casuali a precisione singola.

p = single([3 2; -2 1]);

Creare un array di numeri casuali della stessa dimensione e dello stesso tipo di dati di p.

X = rand(size(p),like=p)

X = 2×2 single matrix

    0.8147    0.1270
    0.9058    0.9134

class(X)

ans = 
'single'

Numeri complessi casuali

Generare 10 numeri complessi casuali dalla distribuzione uniforme su un dominio quadrato con parti reali e immaginarie comprese nell'intervallo (0,1).

a = rand(10,1,like=1i)

a = 10×1 complex

   0.8147 + 0.9058i
   0.1270 + 0.9134i
   0.6324 + 0.0975i
   0.2785 + 0.5469i
   0.9575 + 0.9649i
   0.1576 + 0.9706i
   0.9572 + 0.4854i
   0.8003 + 0.1419i
   0.4218 + 0.9157i
   0.7922 + 0.9595i

Argomenti di input

n — Dimensione della matrice quadrata

valore intero

Dimensione della matrice quadrata, specificata come valore intero.

• Se n è 0, X è una matrice vuota.

• Se n è negativo, viene trattato come 0.

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz1,...,szN — Grandezza di ciascuna dimensione (come argomenti separati)

valori interi

Grandezza di ciascuna dimensione, specificata come argomenti separati di valori interi.

• Se la grandezza di qualsiasi dimensione è 0, X è un array vuoto.

• Se la grandezza di qualsiasi dimensione è negativa, viene trattata come 0.

• Oltre la seconda dimensione, rand ignora le dimensioni finali con grandezza pari a 1. Ad esempio, rand(3,1,1,1) produce un vettore 3x1 di numeri casuali.

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Grandezza di ciascuna dimensione (come un vettore riga)

valori interi

Grandezza di ciascuna dimensione, specificata come vettore riga di valori interi. Ciascun elemento di questo vettore indica la grandezza della dimensione corrispondente:

• Se la grandezza di qualsiasi dimensione è 0, X è un array vuoto.

• Se la grandezza di qualsiasi dimensione è negativa, viene trattata come 0.

• Oltre la seconda dimensione, rand ignora le dimensioni finali con grandezza pari a 1. Ad esempio, rand([3 1 1 1]) produce un vettore 3x1 di numeri casuali.

Esempio sz = [2 3 4] crea un array 2x3x4.

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Tipo di dati (classe) da creare

"double" (predefinito) | "single"

Tipo di dati (classe) da creare, specificato come "double", "single" o il nome di un’altra classe che fornisce supporto rand.

Esempio rand(5,"single")

p — Prototipo di array da creare

array numerico

Prototipo di array da creare, specificato come un array numerico.

Esempio rand(5,like=p)

Tipi di dati: single | double
Supporto numeri complessi: Sì

s — Flusso di numeri casuali

Oggetto RandStream

Flusso di numeri casuali, specificato come oggetto RandStream.

Esempio s = RandStream("dsfmt19937"); rand(s,[3 1])

Argomenti di output

X — Array di output

scalare | vettore | matrice | array multidimensionale

Array di output, restituito come scalare, vettore, matrice o array multidimensionale.

Ulteriori informazioni

Generatore di numeri pseudocasuali

Il generatore di numeri sottostante a rand è un generatore di numeri pseudocasuali, che crea una sequenza deterministica di numeri che sembrano casuali. Questi numeri sono prevedibili se il seed e l'algoritmo deterministico del generatore sono noti. Sebbene non siano veramente casuali, i numeri generati superano i vari test statistici di casualità, soddisfacendo la condizione di indipendenza e distribuzione identica (i.i.d.) e giustificando il nome pseudocasuali.

Suggerimenti

• La sequenza di numeri prodotta da rand è determinata dalle impostazioni interne del generatore di numeri pseudocasuali uniforme che è alla base di rand, randi e randn. È possibile controllare quel generatore di numeri casuali condiviso utilizzando rng.

Funzionalità estese

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• Se utilizzato, l'argomento di input typename deve essere "double", "single", "int8", "uint8", "int16", "uint16", "int32", "uint32" o "logical". Le altre classi non sono supportate, anche se la classe definisce un metodo statico rand.

• Se utilizzati, gli argomenti di grandezza n, sz e sz1,...,szN devono essere di grandezza fissa.

• Il generatore di codice utilizza la matematica a doppia precisione per calcolare gli output a precisione singola.

• Nella maggior parte dei casi, i file MEX generati utilizzano lo stesso stato di numeri casuali di MATLAB^®. Se si disabilitano le chiamate estrinseche o si chiama rand dall'interno di un parfor loop, il codice MEX generato e il codice autonomo mantengono il loro stato di numero casuale inizializzato al valore predefinito di MATLAB, ossia rng(0,"twister").

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

Questa funzione supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array GPU

Accelera il codice mediante esecuzione su un’unità di elaborazione grafica (GPU) con Parallel Computing Toolbox™.

La funzione rand supporta l'input di array GPU con queste note su utilizzo e limitazioni:

• È possibile specificare typename come 'gpuArray'. Se typename è specificato come 'gpuArray', il tipo sottostante predefinito dell'array è double.

  Per creare un array di GPU con tipo sottostante datatype, specificare il tipo sottostante come ulteriore argomento prima di typename. Ad esempio, X = rand(3,datatype,'gpuArray') crea un array di GPU 3x3 di numeri casuali con tipo sottostante datatype.

  È possibile specificare il tipo sottostante datatype come una di queste opzioni:

  • 'double'

  • 'single'

• È inoltre possibile specificare la variabile numerica p come un gpuArray.

  Se p specificato come un gpuArray, il tipo sottostante dell’array restituito è lo stesso di p.

• Per utilizzare la sintassi dello stream rand(s,___), su una GPU, s deve essere un oggetto parallel.gpu.RandStream (Parallel Computing Toolbox).

Per maggiori informazioni, vedere Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

Note su utilizzo e limitazioni:

• La sintassi di flusso rand(s,___) non è supportata per gli array codistributed o distributed.

• È possibile specificare typename come 'codistributed' o 'distributed'. Se typename è specificato come 'codistributed' o 'distributed', il tipo sottostante predefinito dell'array restituito è double.

  Per creare un array distribuito o co-distribuito con tipo sottostante datatype, specificare il tipo sottostante come ulteriore argomento prima di typename. Ad esempio, X = rand(3,datatype,'distributed') crea una matrice distribuita 3x3 di numeri casuali con tipo sottostante datatype.

  È possibile specificare il tipo sottostante datatype come una di queste opzioni:

  • 'double'

  • 'single'

• È inoltre possibile specificare p come un array codistributed o distributed.

  Se p è specificato come un array codistributed o distributed, il tipo sottostante dell'array restituito è lo stesso di p.

• Per ulteriori sintassi codistributed, vedere rand (codistributed) (Parallel Computing Toolbox).

Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

R2022a: Abbinamento della complessità con like e utilizzo di like con l’oggetto RandStream

L'argomento nome-valore like supporta array prototipo sia reali che complessi. Ad esempio:

r = rand(2,2,like=1i)

r =

   0.8147 + 0.9058i   0.6324 + 0.0975i
   0.1270 + 0.9134i   0.2785 + 0.5469i

Tutte le sintassi supportano questa feature. Inoltre, è ora possibile utilizzare like con un oggetto RandStream come primo input di rand.

R2014a: Abbinamento del tipo di dati di una variabile esistente con 'like'

Per generare numeri casuali con lo stesso tipo di dati di una variabile esistente, utilizzare la sintassi rand(__,'like',p). Ad esempio:

A = single(pi);
r = rand(4,4,'like',A);
class(r)

ans = 
single

Questa feature non è disponibile quando un oggetto RandStream viene passato come primo input di rand.

R2013b: Input non supportati di dimensioni non intere

La specifica di una dimensione che non è un numero intero, comporta un errore. Utilizzare floor per convertire gli input di dimensione non intera in numeri interi.

R2008b: Input non consigliati: 'seed', 'state' e 'twister'

Non è prevista la rimozione di questi input che controllano il generatore di numeri casuali alla base di rand, randi e randn. Tuttavia, per questi motivi si consiglia di utilizzare invece la funzione rng:

• I generatori 'seed' e 'state' sono imperfetti.

• I termini 'seed' e 'state' sono nomi fuorvianti per i generatori. 'seed' si riferisce al generatore MATLAB v4, non al valore di inizializzazione di seed. 'state' si riferisce ai generatori v5, non allo stato interno del generatore.

• Questi tre input utilizzano inutilmente generatori diversi per rand e randn.

Per informazioni sull’aggiornamento del codice, vedere Replace Discouraged Syntaxes of rand and randn.

Vedi anche

randi | randn | rng | RandStream | sprand | sprandn | randperm

Argomenti

• Creazione di array di numeri casuali
• Controlling Random Number Generation
• Numeri casuali entro un intervallo specifico
• Class Support for Array-Creation Functions
• Why Do Random Numbers Repeat After Startup?