Diag

Extrai a diagonal ou cria uma matriz diagonal.

vector matrix::Diag(
  const int     ndiag=0      // número diagonal
   );
 
void matrix::Diag(
  const vector  v,           // vetor diagonal
  const int     ndiag=0      // número diagonal
   );

Parâmetros

v

[in]  Vetor cujos elementos devem ser inseridos na diagonal correspondente (ndiag=0 – diagonal principal).

ndiag=0

[in]  Diagonal. Por padrão é 0. Para diagonais acima da diagonal principal, é especificado ndiag>0, para diagonais abaixo é ndiag<0.

 

Observação

A diagonal pode ser definida para matrizes não distribuídas (não dimensionadas). Neste caso, será criada uma matriz nula do tamanho do vetor diagonal correspondente, após a qual os valores dos elementos vetoriais serão inseridos na diagonal correspondente. Se uma diagonal for definida em uma matriz existente, as dimensões da matriz permanecerão as mesmas e os valores dos elementos da matriz fora do vetor diagonal não serão alterados.

Exemplo:

   vector v1={1,2,3};
   matrix m1;
   m1.Diag(v1);
   Print("m1\n",m1);
   matrix m2;
   m2.Diag(v1,-1);
   Print("m2\n",m2);
   matrix m3;
   m3.Diag(v1,1);
   Print("m3\n",m3);
   matrix m4=matrix::Full(4,5,9);
   m4.Diag(v1,1);
   Print("m4\n",m4);
   
   Print("diag -1 - ",m4.Diag(-1));
   Print("diag 0 - ",m4.Diag());
   Print("diag 1 - ",m4.Diag(1));
 
  /*
 
  m1
  [[1,0,0]
  [0,2,0]
  [0,0,3]]
  m2
  [[0,0,0]
  [1,0,0]
  [0,2,0]
  [0,0,3]]
  m3
  [[0,1,0,0]
  [0,0,2,0]
  [0,0,0,3]]
  m4
  [[9,1,9,9,9]
  [9,9,2,9,9]
  [9,9,9,3,9]
  [9,9,9,9,9]]
  diag -1 - [9,9,9]
  diag 0 - [9,9,9,9]
  diag 1 - [1,2,3,9]
  */