.. highlightlang:: us

.. index:: diag

.. _diag:

diag
====

.. us.tag  diag GERMAN math-create-mat Changed5502

:ref:`diag` erzeugt eine Diagonalmatrix oder einen Zeilenvektor.

.. function::   r = diag(m)
                r = diag(m, k)

.. us.return

**Returnwert**

Falls das Argument *m* ein Spalten- oder Zeilenvektor ist, erzeugt :ref:`diag`
eine Diagonalmatrix. Falls *m* eine *nr* * *nc* Matrix ist, erzeugt :ref:`diag`
einen Zeilenvektor mit ``min([nr, nc])`` Spalten.

.. us.params

**Parameter**

.. uparam:: m

   *m* ist ein reeller, complexer oder String-Vektor
   oder Matrix.

.. uparam:: k

   *k* ist ein skalarer Wert, der die Diagonale festlegt.:
   k = 0 ist die Hauptdiagonale, k > 0 oberhalb der Hauptdiagonalen, und k < 0
   unterhalb der Hauptdiagonalen. Defaultwert ist 0.

.. us.example

**Beispiel**

::

   diag([1,2,3])
       1.0000     0.0000     0.0000
       0.0000     2.0000     0.0000
       0.0000     0.0000     3.0000
   [1,2;3,4]
       1.0000     2.0000
       3.0000     4.0000
   diag([1,2;3,4])
       1.0000     4.0000
   diag([1,2,3], 2)
       0.0000     0.0000     1.0000     0.0000     0.0000 
       0.0000     0.0000     0.0000     2.0000     0.0000 
       0.0000     0.0000     0.0000     0.0000     3.0000 
       0.0000     0.0000     0.0000     0.0000     0.0000 
       0.0000     0.0000     0.0000     0.0000     0.0000 

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2013.2
     - Neuer Parameter *k*.

.. seealso::
   :ref:`uberblick-mathematik`

:sub:`id-1146555`