Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

diag

Crear matriz diagonal o obtener elementos diagonales de Matrix

Sintaxis

D = diag(v)

D = diag(v,k)

x = diag(A)

x = diag(A,k)

Descripción

D = diag(v) devuelve una matriz diagonal cuadrada con los elementos del vector v en la Diagonal principal.

D = diag(v,k) coloca los elementos del vector v en el kTH diagonal. k=0 representa la Diagonal principal, k>0 está por encima de la Diagonal principal y k<0 está por debajo de la Diagonal principal.

x = diag(A) devuelve un vector de columna de los elementos diagonales principales de A.

x = diag(A,k) devuelve un vector de columna de los elementos de la kTH diagonal de A.

Ejemplos

Crear matrices diagonales

Crear un vector 1-por-5.

v = [2 1 -1 -2 -5];

Utilice diag para crear una matriz con los elementos de v en la Diagonal principal.

D = diag(v)

D = 5×5

     2     0     0     0     0
     0     1     0     0     0
     0     0    -1     0     0
     0     0     0    -2     0
     0     0     0     0    -5

Cree una matriz con los elementos de v en la primera diagonal Super (k=1).

D1 = diag(v,1)

D1 = 6×6

     0     2     0     0     0     0
     0     0     1     0     0     0
     0     0     0    -1     0     0
     0     0     0     0    -2     0
     0     0     0     0     0    -5
     0     0     0     0     0     0

El resultado es una matriz de 6 por 6. Cuando se especifica un vector de longitud n como una entrada, diag devuelve una matriz cuadrada de tamaño n+abs(k).

Obtener elementos diagonales

Consigue los elementos en la Diagonal principal de una matriz aleatoria de 6 por 6.

A = randi(10,6)

A = 6×6

     9     3    10     8     7     8
    10     6     5    10     8     1
     2    10     9     7     8     3
    10    10     2     1     4     1
     7     2     5     9     7     1
     1    10    10    10     2     9

x = diag(A)

x = 6×1

     9
     6
     9
     1
     7
     9

Obtenga los elementos de la primera subdiagonal (k=-1) de A. El resultado tiene un menos elemento que la Diagonal principal.

x1 = diag(A,-1)

x1 = 5×1

    10
    10
     2
     9
     2

Al llamar a diag dos veces se devuelve una matriz diagonal compuesta por los elementos diagonales de la matriz original.

A1 = diag(diag(A))

A1 = 6×6

     9     0     0     0     0     0
     0     6     0     0     0     0
     0     0     9     0     0     0
     0     0     0     1     0     0
     0     0     0     0     7     0
     0     0     0     0     0     9

Argumentos de entrada

v — Elementos diagonales

Vector

Elementos diagonales, especificados como vectores. Si v es un vector con elementos N , diag(v,k) es una matriz cuadrada de orden N+abs(k).

diag([]) devuelve una matriz vacía, [].

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

A — Matriz de entrada

Matriz

Matriz de entrada. diag devuelve un error si ndims(A) > 2.

diag([]) devuelve una matriz vacía, [].

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

k — Número diagonal

Entero

Número diagonal, especificado como un entero. k=0 representa la Diagonal principal, k>0 está por encima de la Diagonal principal y k<0 está por debajo de la Diagonal principal.

Para una matriz m-by-n , k está en el intervalo $$(-m+1)\le k\le (n-1).$$

Sugerencias

• El trace de una matriz es igual a sum(diag(A)).

Capacidades ampliadas

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

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

Notas de uso y limitaciones:

• Si proporciona k, debe ser un valor entero real y escalar.

• Para las entradas de tamaño variable que son vectores de longitud variable (1-por-: or:-by-1), diag:

  • Trata la entrada como una entrada vectorial

  • Devuelve una matriz con el vector dado a lo largo de la diagonal especificada

• Para las entradas de tamaño variable que no son vectores de longitud variable, diag:

  • Trata la entrada como una matriz

  • No admite entradas que son vectores en tiempo de ejecución

  • Devuelve un vector de longitud variable

  Si la entrada es de tamaño variable (: m-by-: n) y tiene la forma 0-por-0 en tiempo de ejecución, entonces la salida es 0-por-1 no 0-por-0. Sin embargo, si la entrada es un tamaño constante de 0 por 0, la salida es [].

• Para las entradas de tamaño variable que no son vectores de longitud variable (1-por-: o:-por-1), diag trata la entrada como una matriz desde la que se extrae un vector diagonal. Este comportamiento se produce incluso si la matriz de entrada es un vector en tiempo de ejecución. Para forzar a diag a que construya una matriz a partir de entradas de tamaño variable que no sean 1 por: o:-por-1, utilice:

  • diag(x(:)) en lugar de diag(x)

  • diag(x(:),k) en lugar de diag(x,k)

• (Consulte Variable-Sizing Restrictions for Code Generation of Toolbox Functions (MATLAB Coder)).

Consulte también

blkdiag | isdiag | istril | istriu | spdiags | tril | triu

Introducido antes de R2006a

×

Open Example (es)

A modified version of this example exists on your system. Do you want to open this version instead? (es)

No, overwrite the modified version (es) Yes (es)