eye

Matrici di identità

Sintassi

I = eye

I = eye(n)

I = eye(n,m)

I = eye(sz)

I = eye(___,typename)

I = eye(___,like=p)

Descrizione

I = eye restituisce lo scalare 1.

I = eye(n) restituisce una matrice di identità n x n con elementi uno sulla diagonale principale ed elementi zero altrove.

I = eye(n,m) restituisce una matrice n x m con elementi uno sulla diagonale principale ed elementi zero altrove.

I = eye(sz) restituisce un array con elementi uno sulla diagonale principale ed elementi zero altrove. Il vettore di grandezza sz, definisce size(I). Ad esempio, eye([2,3]) restituisce un array 2x3 con elementi uno sulla diagonale principale ed elementi zero altrove.

I = eye(___,typename) specifica inoltre il tipo di dati (classe) di I per qualsiasi sintassi precedente. Ad esempio, eye(5,"int8") restituisce una matrice di identità 5x5 composta da numeri interi a 8 bit.

I = eye(___,like=p) specifica che I ha lo stesso tipo di dati, sparsità e complessità (reale o complessa) della variabile numerica p.

Esempi

Matrice quadrata di identità

Creare una matrice di identità 4x4.

I = eye(4)

I = 4×4

     1     0     0     0
     0     1     0     0
     0     0     1     0
     0     0     0     1

Matrice rettangolare

Creare una matrice di identità 2x3.

I = eye(2,3)

I = 2×3

     1     0     0
     0     1     0

Vettore di identità

Creare un vettore di identità 3x1.

sz = [3,1];
I = eye(sz)

I = 3×1

     1
     0
     0

Tipi di dati numerici non predefiniti

Creare una matrice di identità 3x3 i cui elementi sono numeri interi senza segno a 32 bit.

I = eye(3,"uint32")

I = 3×3 uint32 matrix

   1   0   0
   0   1   0
   0   0   1

class(I)

ans = 
'uint32'

Matrice complessa di identità

Creare una matrice di identità 2x2 che non ha valore reale, ma è complessa come una array esistente.

Definire un vettore complesso.

p = [1+2i 3i];

Creare una matrice di identità che sia complessa come p.

I = eye(2,like=p)

I = 2×2 complex

   1.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   1.0000 + 0.0000i

Matrici di identità rade

Definire una matrice rada 5x5.

p = sparse(5,5,pi);

Creare una matrice di identità 5x5 che sia rada come P.

I = eye(5,like=p)

I = 5×5 sparse double matrix (5 nonzeros)
   (1,1)        1
   (2,2)        1
   (3,3)        1
   (4,4)        1
   (5,5)        1

Grandezza e tipo di dati numerici definiti dall'array esistente

Definire una matrice 2x2 a precisione singola.

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

Creare una matrice di identità che abbia la stessa dimensione e tipo di dati di p.

I = eye(size(p),like=p)

I = 2×2 single matrix

     1     0
     0     1

class(I)

ans = 
'single'

Argomenti di input

n — Grandezza della prima dimensione di I

valore intero

Grandezza della prima dimensione di I, specificata come valore intero.

• Se n è l'unico argomento di input intero, I è una matrice quadrata di identità n x n.

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

• Se n è negativo, viene trattato come 0.

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

m — Grandezza della seconda dimensione di I

valore intero

Grandezza della seconda dimensione di I, specificata come valore intero.

• Se m è 0, I è una matrice vuota.

• Se m è negativo, viene trattato come 0.

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

sz — Grandezza di I

vettore riga con non più di due valori interi

Grandezza di I, specificata come vettore riga con non più di due valori interi.

• Se un elemento di sz è 0, I è una matrice vuota.

• Se un elemento di sz è negativo, viene trattato come 0.

Esempio sz = [2 3] definisce I come una matrice 2x3.

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

typename — Classe di output

"double" (predefinito) | "single" | "logical" | "int8" | "uint8" | ...

Classe di output, specificata come "double", "single", "logical", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64" o "uint64".

p — Prototipo

variabile numerica

Prototipo, specificato come variabile numerica.

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

Argomenti di output

I — Matrici di identità

scalare | matrice

Matrice di identità, restituita come scalare o matrice.

Funzionalità estese

Generazione di codice C/C++

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

Note su utilizzo e limitazioni:

• typename deve essere un tipo numerico incorporato in MATLAB^®. Non invoca il metodo statico eye per altre classi. Ad esempio, eye(m, n, 'myclass') non invoca myclass.eye(m,n).

• Gli argomenti di grandezza devono avere una grandezza fissa.

Generazione di codice GPU

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

Note su utilizzo e limitazioni:

• typename deve essere un tipo numerico incorporato in MATLAB. Non invoca il metodo statico eye per altre classi. Ad esempio, eye(m, n, 'myclass') non invoca myclass.eye(m,n).

• Gli argomenti di grandezza devono avere una grandezza fissa.

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 eye 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, I = eye(3,datatype,'gpuArray') crea una matrice di identità GPU 3x3 con tipo sottostante datatype.

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

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• È 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:

• È 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, I = eye(3,datatype,'distributed') crea una matrice di identità distribuita 3x3 con tipo sottostante datatype.

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

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• È 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 eye (codistributed) (Parallel Computing Toolbox).

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

Cronologia versioni

Introduzione prima di R2006a

Vedi anche

speye | ones | zeros

Argomenti

• Class Support for Array-Creation Functions