eye

Matriz identidad

Sintaxis

I = eye

I = eye(n)

I = eye(n,m)

I = eye(sz)

I = eye(___,typename)

I = eye(___,like=p)

Descripción

I = eye devuelve el escalar 1.

I = eye(n) devuelve una matriz identidad de n por n con unos en la diagonal principal y ceros en los demás lugares.

I = eye(n,m) devuelve una matriz de n por m con unos en la diagonal principal y ceros en los demás lugares.

I = eye(sz) devuelve un arreglo con unos en la diagonal principal y ceros en los demás lugares. El vector de tamaño, sz, define size(I). Por ejemplo, eye([2,3]) devuelve un arreglo de 2 por 3 con unos en la diagonal principal y ceros en los demás lugares.

I = eye(___,typename) también especifica el tipo de datos (clase) de I para cualquiera de las sintaxis anteriores. Por ejemplo, eye(5,"int8") devuelve una matriz identidad de 5 por 5 que consta de enteros de 8 bits.

I = eye(___,like=p) especifica que I tiene el mismo tipo de datos, dispersión y complejidad (real o complejo) que la variable numérica p.

Ejemplos

Matriz identidad cuadrada

Cree una matriz identidad de 4 por 4.

I = eye(4)

I = 4×4

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

Matriz rectangular

Cree una matriz identidad de 2 por 3.

I = eye(2,3)

I = 2×3

     1     0     0
     0     1     0

Vector identidad

Cree un vector identidad de 3 por 1.

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

I = 3×1

     1
     0
     0

Tipo de datos numéricos no predeterminado

Cree una matriz identidad de 3 por 3 cuyos elementos sean enteros sin signo de 32 bits.

I = eye(3,"uint32")

I = 3×3 uint32 matrix

   1   0   0
   0   1   0
   0   0   1

class(I)

ans = 
'uint32'

Matriz identidad compleja

Cree una matriz identidad de 2 por 2 que no tenga valor real, sino que sea compleja como un arreglo existente.

Defina un vector complejo.

p = [1+2i 3i];

Cree una matriz identidad que sea compleja como 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

Matriz identidad dispersa

Defina una matriz dispersa de 5 por 5.

p = sparse(5,5,pi);

Cree una matriz identidad de 5 por 5 que sea dispersa como 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

Tamaño y tipo de datos numéricos definidos por un arreglo existente

Cree una matriz de 2 por 2 de precisión simple.

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

Cree una matriz identidad que tenga el mismo tamaño y tipo de datos que p.

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

I = 2×2 single matrix

     1     0
     0     1

class(I)

ans = 
'single'

Argumentos de entrada

n — Tamaño de la primera dimensión de I

valor entero

Tamaño de la primera dimensión de I, especificado como valor entero.

• Si n es el único argumento de entrada entero, I es una matriz identidad cuadrada de n por n.

• Si n es 0, I es una matriz vacía.

• Si n es negativo, se trata como 0.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

m — Tamaño de la segunda dimensión de I

valor entero

Tamaño de la segunda dimensión de I, especificado como valor entero.

• Si m es 0, I es una matriz vacía.

• Si m es negativo, se trata como 0.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — Tamaño de I

vector fila de no más de dos valores enteros

Tamaño de I, especificado como vector fila de no más de dos valores enteros.

• Si un elemento de sz es 0, I es una matriz vacía.

• Si un elemento de sz es negativo, el elemento se trata como 0.

Ejemplo: sz = [2 3] define I como una matriz de 2 por 3.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — Clase de salida

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

Clase de salida, especificada como "double", "single", "logical", "int8", "uint8", "int16", "uint16", "int32", "uint32", "int64" o "uint64".

p — Prototipo

variable numérica

Prototipo, especificado como variable numérica.

Tipos de datos: double | single | logical | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Soporte de números complejos: Sí

Argumentos de salida

I — Matriz identidad

escalar | matriz

Matriz identidad, devuelta como escalar o matriz.

Capacidades ampliadas

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• typename debe ser un tipo numérico de MATLAB^® integrado. No invoca el método eye estático para otras clases. Por ejemplo, eye(m, n, 'myclass') no invoca myclass.eye(m,n).

• Los argumentos de tamaño deben tener un tamaño fijo.

Generación de código de GPU

Genere código CUDA® para GPU NVIDIA® mediante GPU Coder™.

Notas y limitaciones de uso:

• typename debe ser un tipo numérico de MATLAB integrado. No invoca el método eye estático para otras clases. Por ejemplo, eye(m, n, 'myclass') no invoca myclass.eye(m,n).

• Los argumentos de tamaño deben tener un tamaño fijo.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función eye es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Puede especificar typename como 'gpuArray'. Si especifica typename como 'gpuArray', el tipo subyacente predeterminado del arreglo es double.

  Para crear un arreglo de GPU con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, I = eye(3,datatype,'gpuArray') crea una matriz identidad de GPU de 3 por 3 con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• También puede especificar la variable numérica p como gpuArray.

  Si especifica p como gpuArray, el tipo subyacente del arreglo devuelto es el mismo que p.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Puede especificar typename como 'codistributed' o 'distributed'. Si especifica typename como 'codistributed' o 'distributed', el tipo subyacente predeterminado del arreglo devuelto es double.

  Para crear un arreglo distribuido o codistribuido con el tipo subyacente datatype, especifique el tipo subyacente como argumento adicional antes de typename. Por ejemplo, I = eye(3,datatype,'distributed') crea una matriz identidad distribuida de 3 por 3 con el tipo subyacente datatype.

  Puede especificar el tipo subyacente datatype como una de estas opciones:

  • 'double'

  • 'single'

  • 'logical'

  • 'int8'

  • 'uint8'

  • 'int16'

  • 'uint16'

  • 'int32'

  • 'uint32'

  • 'int64'

  • 'uint64'

• También puede especificar p como arreglo codistributed o distributed.

  Si especifica p como arreglo codistributed o distributed, el tipo subyacente del arreglo devuelto es el mismo que p.

• Para ver sintaxis codistributed adicionales, consulte eye (codistributed) (Parallel Computing Toolbox).

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

speye | ones | zeros

Temas

• Class Support for Array-Creation Functions