.. highlightlang:: us

.. index:: sum

.. _sum:

sum
===

.. us.tag  sum GERMAN STR math-base

:ref:`sum` berechnet bei reellen oder komplexen Vektoren die Summe aller
Elemente. Bei String-Vektoren werden alle Strings zu einem skalaren String
verkettet. Wenn das Argument eine Matrix ist, wird ein Zeilen-Vektor erzeugt der
die Summen der Spalten der Matrix enthält.

.. function::  mSum = sum(m)

.. us.return

**Returnwert**

*mSum* ist ein Skalar wenn *m* ein Vektor ist. Der Skalar enthält die Summe der
Elemente des Vektors.Wenn *m* eine Matrix ist, ist *mSum* ein Zeilenvektor
dessen Spalten die Summe der Zeilen der Matrix *m* enthalten.

.. us.params

**Parameter**

.. uparam:: m

   *m* ist eine reelle, komplexe oder String-Matrix.

.. us.comment

**Kommentar**

Es gibt in UniScript eine Reihe von Funktionen die ihr Argument spaltenweise
bearbeiten wenn es eine Matrix ist z. B. :ref:`all`, :ref:`any`, :ref:`max`,
:ref:`min`.

.. us.example

**Beispiel**

::

   * m = rand(4,3)
   * m
       0.3237     0.3530     0.3255
       0.3244     0.1540     0.3401
       0.4934     0.5662     0.8952
       0.2887     0.8207     0.3366
   * sum(m)
       1.4302     1.8939     1.8974
   * sum(sum(m))
       5.2215

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

:sub:`id-1974292`