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).

r = -5 + (5+5)*rand(10,1)

r = 10×1

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

Di solito, è possibile generare N numeri casuali nell’intervallo (a,b) con la formula r = a + (b-a).*rand(N,1).

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 = 1x4 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 = 2x2 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])

Suggerimenti

• La sequenza di numeri prodotta da rand è determinata dalle impostazioni interne del generatore di numeri pseudocasuali uniformi 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:

• Il tipo di dati (classe) deve essere un tipo numerico incorporato in MATLAB^®. Per le altre classi, il metodo statico rand non è invocato. Ad esempio, rand(sz,'myclass') non invoca myclass.rand(sz).

• Gli argomenti di grandezza devono avere una grandezza fissa.

• Vedere Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder).

  • Se le chiamate estrinseche sono abilitate e rand dall’interno di un loop parfor, i file MEX generati utilizzano lo stesso stato di numeri casuali di MATLAB nel codice seriale. Diversamente, il codice MEX generato e quello standalone mantengono il proprio stato di numeri casuali che è inizializzato sullo stesso stato di MATLAB.

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™.

Note su utilizzo e limitazioni:

• La sintassi di flusso rand(s,___) non è supportata su una GPU.

• È 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 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’input "like" supporta array di prototipi reali e 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

• Create Arrays of Random Numbers
• Generate Random Numbers That Are Repeatable
• Generate Random Numbers That Are Different
• Numeri casuali entro un intervallo specifico
• Random Numbers Within a Sphere
• Creating and Controlling a Random Number Stream
• Class Support for Array-Creation Functions
• Replace Discouraged Syntaxes of rand and randn
• Why Do Random Numbers Repeat After Startup?