speye

Matriz identidad dispersa

Sintaxis

S = speye

S = speye(n)

S = speye(n,m)

S = speye(sz)

S = speye(___,typename)

Descripción

S = speye devuelve un escalar disperso 1.

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

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

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

S = speye(___,typename) devuelve una matriz dispersa del tipo de datos especificado. Especifique el tipo de datos además de cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores. (desde R2025a)

Ejemplos

Matriz identidad dispersa cuadrada

Cree una matriz identidad dispersa cuadrada de 1000 por 1000 y visualice el patrón de dispersión.

I = speye(1000);
spy(I)

El resultado es el mismo que sparse(eye(1000)), pero esta última versión requiere almacenamiento temporal para la representación completa antes de convertirse en almacenamiento disperso.

Matriz identidad dispersa rectangular

Cree una matriz identidad dispersa de 400 por 800 y visualice el patrón de elementos distintos de cero.

S = speye(400,800);
spy(S)

Este comando equivale a speye([400 800]).

Argumentos de entrada

n, m — Tamaños de dimensiones

escalares enteros no negativos

Tamaños de dimensiones, especificados como escalares enteros no negativos.

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

• Si n o m son 0, S es una matriz vacía.

• Si n o m son negativos, se trata como 0.

Ejemplo: speye(4) crea una matriz identidad de 4 por 4.

Ejemplo: speye(3,6) crea una matriz identidad de 3 por 6.

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

typename — Tipo de datos de salida

"double" (predeterminado) | "single" | "logical"

Desde R2025a

Tipo de datos de salida, especificado como "double", "single" o "logical".

sz — Tamaños de dimensiones

vector fila de dos elementos

Tamaños de dimensiones, especificados como vector fila de dos elementos. El vector fila tiene el formato [numRows numCols].

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

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

Ejemplo: speye([4 5]) crea una matriz de 4 por 5 y equivale a speye(4,5).

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

Argumentos de salida

S — Matriz de salida

matriz dispersa

Matriz de salida, devuelta como una matriz identidad dispersa.

Capacidades ampliadas

Generación de código C/C++
Genere código C y C++ mediante MATLAB® Coder™.

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 speye es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Para ejecutar esta función en una GPU y obtener una salida gpuArray, utilice cualquiera de estas sintaxis:

  • S = gpuArray.speye.

  • S = gpuArray.speye(n).

  • S = gpuArray.speye(n,m).

  • S = gpuArray.speye(sz).

  • S = gpuArray.speye(___,typename), donde typename especifica el tipo de datos además de las combinaciones de argumentos de entrada de cualquiera de las sintaxis anteriores. (desde R2025a)

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

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2025a: Crear una matriz dispersa de precisión simple

Puede especificar el tipo de datos de salida especificando el argumento typename como "double", "single" o "logical".

Consulte también

Funciones

• spalloc | spones | spdiags | sprand | sprandn | eye