repmat

Ripetere le copie dell'array

Sintassi

B = repmat(A,n)

B = repmat(A,r1,...,rN)

B = repmat(A,r)

Descrizione

B = repmat(A,n) restituisce un array contenente n copie di A nelle dimensioni di riga e colonna. La grandezza di B è size(A)*n quando A è una matrice.

B = repmat(A,r1,...,rN) specifica un elenco di scalari r1,..,rN, che descrive come sono disposte le copie di A in ciascuna dimensione. Quando A ha le dimensioni di N, la grandezza di B è size(A).*[r1...rN]. Ad esempio, repmat([1 2; 3 4],2,3) restituisce una matrice 4x6.

B = repmat(A,r) specifica lo schema di ripetizione con il vettore riga r. Ad esempio, repmat(A,[2 3]) restituisce lo stesso risultato di repmat(A,2,3).

Esempi

Inizializzazione di matrice con lo stesso valore di elemento

Creare una matrice 3x2 i cui elementi contengano il valore 10.

A = repmat(10,3,2)

A = 3×2

    10    10
    10    10
    10    10

Formato a blocchi quadrati

Ripetere le copie di una matrice in una disposizione a blocchi 2x2.

A = diag([100 200 300])

A = 3×3

   100     0     0
     0   200     0
     0     0   300

B = repmat(A,2)

B = 6×6

   100     0     0   100     0     0
     0   200     0     0   200     0
     0     0   300     0     0   300
   100     0     0   100     0     0
     0   200     0     0   200     0
     0     0   300     0     0   300

Formato a blocchi rettangolari

Ripetere le copie di una matrice in una disposizione a blocchi 2x3.

A = diag([100 200 300])

A = 3×3

   100     0     0
     0   200     0
     0     0   300

B = repmat(A,2,3)

B = 6×9

   100     0     0   100     0     0   100     0     0
     0   200     0     0   200     0     0   200     0
     0     0   300     0     0   300     0     0   300
   100     0     0   100     0     0   100     0     0
     0   200     0     0   200     0     0   200     0
     0     0   300     0     0   300     0     0   300

Array a blocco tridimensionale

Ripetere le copie di una matrice in una disposizione a blocchi 2x3x2.

A = [1 2; 3 4]

A = 2×2

     1     2
     3     4

B = repmat(A,[2 3 2])

B = 
B(:,:,1) =

     1     2     1     2     1     2
     3     4     3     4     3     4
     1     2     1     2     1     2
     3     4     3     4     3     4


B(:,:,2) =

     1     2     1     2     1     2
     3     4     3     4     3     4
     1     2     1     2     1     2
     3     4     3     4     3     4

Impilamento verticale di vettori riga

Impilare verticalmente un vettore riga per quattro volte.

A = 1:4;
B = repmat(A,4,1)

B = 4×4

     1     2     3     4
     1     2     3     4
     1     2     3     4
     1     2     3     4

Impilamento orizzontale di vettori colonna

Impilare orizzontalmente un vettore colonna per quattro volte.

A = (1:3)';  
B = repmat(A,1,4)

B = 3×4

     1     1     1     1
     2     2     2     2
     3     3     3     3

Formato a blocchi tabellari

Creare una tabella con le variabili Age e Height.

A = table([39; 26],[70; 63],'VariableNames',{'Age' 'Height'})

A=2×2 table
    Age    Height
    ___    ______

    39       70  
    26       63  

Ripetere le copie della tabella in un formato a blocchi 2x3.

B = repmat(A,2,3)

B=4×6 table
    Age    Height    Age_1    Height_1    Age_2    Height_2
    ___    ______    _____    ________    _____    ________

    39       70       39         70        39         70   
    26       63       26         63        26         63   
    39       70       39         70        39         70   
    26       63       26         63        26         63   

repmat ripete le voci della tabella e aggiunge un numero ai nuovi nomi delle variabili.

Combinazione di elementi del vettore

Creare due vettori colonna.

A = [1; 3; 5];
B = [2; 4];

Generare tutte le combinazioni di elementi dei due vettori utilizzando repelem e repmat. Ciascuna riga dell'output T è una combinazione con il primo elemento proveniente dal primo vettore e il secondo elemento proveniente dal secondo vettore. Questo comando equivale a trovare il prodotto cartesiano di due vettori.

T = [repelem(A,numel(B)) repmat(B,numel(A),1)]

T = 6×2

     1     2
     1     4
     3     2
     3     4
     5     2
     5     4

A partire dalla release R2023a, è inoltre possibile utilizzare la funzione combinations per generare tutte le combinazioni di elementi di due vettori.

T = combinations(A,B)

T=6×2 table
    A    B
    _    _

    1    2
    1    4
    3    2
    3    4
    5    2
    5    4

Argomenti di input

A — Array di input

scalare | vettore | matrice | array multidimensionale

Array di input, specificato come scalare, vettore, matrice o array multidimensionale.

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | table | datetime | duration | calendarDuration | categorical | cell
Supporto numeri complessi: Sì

n — Numero di volte in cui ripetere l'array di input nelle dimensioni di riga e colonna

valore intero

Numero di volte in cui ripetere l'array di input nelle dimensioni di riga e colonna, specificato come valore intero. Se n è 0 o negativo, il risultato è un array vuoto.

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

r1,...,rN — Fattori di ripetizione per ciascuna dimensione (come argomenti separati)

valori interi

Fattori di ripetizione per ciascuna dimensione, specificati come argomenti separati di valori interi. Se un qualsiasi fattore di ripetizione è 0 o negativo, il risultato è un array vuoto.

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

r — Vettore dei fattori di ripetizione per ciascuna dimensione (come vettore riga)

valori interi

Vettore dei fattori di ripetizione per ciascuna dimensione, specificato come vettore riga di valori interi. Se un qualsiasi valore in r è 0 o negativo, il risultato è un array vuoto.

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

Suggerimenti

• Per costruire array di blocchi formando il prodotto tensoriale dell'input con un array di uno, utilizzare kron. Ad esempio, per impilare il vettore riga A = 1:3 quattro volte verticalmente, si può utilizzare B = kron(A,ones(4,1)).

• Per creare array di blocchi ed eseguire un'operazione binaria in un unico passaggio, utilizzare bsxfun. In alcuni casi, bsxfun fornisce una soluzione più semplice e più efficiente in termini di memoria. Ad esempio, per sommare i vettori A = 1:5 e B = (1:10)' per produrre un array 10x5, utilizzare bsxfun(@plus,A,B) anziché repmat(A,10,1) + repmat(B,1,5).

• Quando A è uno scalare di un certo tipo, è possibile utilizzare altre funzioni per ottenere lo stesso risultato di repmat.

  Sintassi repmat	Alternativa equivalente
  repmat(NaN,m,n)	NaN(m,n)
  repmat(single(inf),m,n)	inf(m,n,'single')
  repmat(int8(0),m,n)	zeros(m,n,'int8')
  repmat(uint32(1),m,n)	ones(m,n,'uint32')
  repmat(eps,m,n)	eps(ones(m,n))

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

Questa funzione supporta i tall array con le seguenti limitazioni:

• Il fattore di replicazione nella prima dimensione deve essere 1. Ad esempio, repmat(TA,1,n,p,...).

Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

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

Note su utilizzo e limitazioni:

• Gli argomenti di grandezza devono avere una grandezza fissa.

• Per le matrici sparse, la funzione repmat non supporta uno finali come input dopo le prime due dimensioni.

Generazione di codice GPU

Genera codice CUDA® per GPU NVIDIA® con GPU Coder™.

Note su utilizzo e limitazioni:

• Gli argomenti di grandezza devono avere una grandezza fissa.

• Per le matrici sparse, la funzione repmat non supporta uno finali come input dopo le prime due dimensioni.

Generazione di codice HDL
Genera codice VHDL, Verilog e SystemVerilog per progetti FPGA e ASIC utilizzando HDL Coder™.

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 repmat supporta completamente gli array di GPU. Per eseguire la funzione su una GPU, specificare i dati di input come un gpuArray (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™.

Questa funzione supporta completamente gli array distribuiti. Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introduzione prima di R2006a

R2019b: Produzione di errori da parte di alcuni argomenti di ripetizione

A partire dalla release R2019b, alcune sintassi che coinvolgono argomenti di ripetizione non scalari o vuoti produrranno un errore. La tabella seguente descrive come aggiornare queste sintassi.

Errori	Utilizzare invece
repmat(A,r1,r2), dove r1 e r2 sono vettori riga	repmat(A,[r1 r2])
repmat(A,empt), dove empt è un array vuoto	repmat(A,1)
repmat(A,empt1,empt2), dove empt1 e empt2 sono array vuoti	repmat(A,1)
repmat(A,n,empt), dove n è un numero intero e empt è un array vuoto	repmat(A,[n 1])

Vedi anche

bsxfun | kron | repelem | reshape | resize | paddata | meshgrid | ndgrid