ndgrid

Griglia rettangolare nello spazio N-D

Sintassi

[X1,X2,...,Xn] = ndgrid(x1,x2,...,xn)

[X1,X2,...,Xn] = ndgrid(xg)

Descrizione

[X1,X2,...,Xn] = ndgrid(x1,x2,...,xn) replica i vettori della griglia x1,x2,...,xn per produrre una griglia completa n-dimensionale.

[X1,X2,...,Xn] = ndgrid(xg) specifica un singolo vettore della griglia xg da utilizzare per tutte le dimensioni. Il numero di argomenti di output specificati determina la dimensionalità n dell'output.

Esempi

Creazione di una griglia bidimensionale

Creare una griglia bidimensionale dai vettori [1 3 5 7 9 11 13 15 17 19] e [2 4 6 8 10 12].

[X,Y] = ndgrid(1:2:19,2:2:12)

X = 10×6

     1     1     1     1     1     1
     3     3     3     3     3     3
     5     5     5     5     5     5
     7     7     7     7     7     7
     9     9     9     9     9     9
    11    11    11    11    11    11
    13    13    13    13    13    13
    15    15    15    15    15    15
    17    17    17    17    17    17
    19    19    19    19    19    19

Y = 10×6

     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12
     2     4     6     8    10    12

Perfezionamento della griglia utilizzando l'interpolazione

Creare una griglia rettangolare e calcolare i valori della funzione sulla griglia. Interpolare tra i valori assegnati per perfezionare la griglia.

Creare una griglia approssimativa per $$(x,y)$$, dove l'intervallo di $$x$$ è $$[-6,6]$$ e l'intervallo di $$y$$ è $$[-3,3]$$.

[X,Y] = ndgrid(-6:0.5:6,-3:0.5:3);

Valutare la funzione nelle posizioni definite nella griglia. Quindi, visualizzare la funzione utilizzando un grafico di superficie. In alternativa, dalla release R2016b, è possibile utilizzare l'espansione implicita per questa attività.

f = sin(X.^2) .* cos(Y.^2);
surf(Y,X,f)

Interpolare tra i punti su una griglia maggiormente perfezionata (Xq,Yq). Quindi, visualizzare i valori interpolati utilizzando un grafico di superficie.

[Xq,Yq] = ndgrid(-6:0.125:6,-3:0.125:3);
F = interpn(X,Y,f,Xq,Yq,"spline");
surf(Yq,Xq,F)

Argomenti di input

x1,x2,...,xn — Vettori della griglia (come argomenti separati)

vettori

Vettori della griglia, specificati come vettori contenenti le coordinate della griglia per ciascuna dimensione. I vettori della griglia definiscono la griglia in modo implicito. Ad esempio, nello spazio bidimensionale:

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Supporto numeri complessi: Sì

xg — Vettore della griglia per tutte le dimensioni

vettori

Vettore della griglia per tutte le dimensioni, specificato come vettore contenente le coordinate della griglia. ndgrid utilizza xg come vettore della griglia per ciascuna dimensione.

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Supporto numeri complessi: Sì

Argomenti di output

X1,X2,...,Xn — Rappresentazione completa della griglia

array

Rappresentazione completa della griglia, restituita come array separati. Per ciascun array di output Xi, l'i-esima dimensione contiene le copie del vettore della griglia xi.

Ulteriori informazioni

Conversione tra i formati meshgrid e ndgrid

meshgrid e ndgrid creano griglie utilizzando formati di output diversi. Nello specifico, le prime due dimensioni di una griglia creata utilizzando una di queste funzioni vengono scambiate rispetto all'altro formato di griglia. Alcune funzioni di MATLAB^® utilizzano griglie in formato meshgrid, mentre altre utilizzano il formato ndgrid; risulta quindi normale convertire le griglie tra i due formati.

La conversione tra questi due formati di griglia è possibile utilizzando pagetranspose (dalla release R2020b) o permute per scambiare le prime due dimensioni degli array della griglia. Ad esempio, creare una griglia tridimensionale con meshgrid.

[X,Y,Z] = meshgrid(1:4,1:3,1:2);

Ora trasporre le prime due dimensioni di ciascun array della griglia per convertirla nel formato ndgrid e confrontare i risultati ottenuti con gli output di ndgrid.

Xt = pagetranspose(X);
Yt = pagetranspose(Y);
Zt = pagetranspose(Z);
[Xn,Yn,Zn] = ndgrid(1:4,1:3,1:2);
isequal(Xt,Xn) & isequal(Yt,Yn) & isequal(Zt,Zn)

ans =

  logical

   1

L’utilizzo di pagetranspose equivale a permutare le prime due dimensioni lasciando invariate le altre. È possibile eseguire questa operazione anche con permute(X,[2 1 3:ndims(X)]).

Funzionalità estese

Generazione di codice C/C++
Genera codice C e C++ con MATLAB® Coder™.

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

Ambiente basato su thread

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

La funzione ndgrid 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 ndgrid supporta l'input di array GPU con queste note su utilizzo e limitazioni:

• La sintassi monodimensionale, X = ndgrid(x), restituisce un vettore colonna gpuArray X he contiene gli elementi dell'input gpuArray x da utilizzare come griglia monodimensionale.

• Gli input devono essere doppi o singoli in virgola mobile.

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

La funzione ndgrid supporta array distribuiti con le seguenti note su utilizzo e limitazioni:

• La sintassi monodimensionale X = ndgrid(x), restituisce un vettore colonna dell'array distribuitoX che contiene gli elementi dell'array distribuito di input x da utilizzare come griglia monodimensionale.

• Gli input devono essere doppi o singoli in virgola mobile.

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

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

griddedInterpolant | mesh | meshgrid | combinations | surf

Argomenti

• Interpolating Gridded Data