.. highlightlang:: us

.. index:: integral

.. _integral:

integral
========

.. us.tag  integral NOTREADYENGLISH math-lin-alg

:ref:`integral` berechnet das Integral mit Hilfe der Trapezregel.

.. function::  rvIntegral = integral(rvY)
    rvIntegral = integral(rvY, bOnlyTotalValue)
    rvIntegral = integral(rvX, rvY)
    rvIntegral = integral(rvX, rvY, bOnlyTotalValue)

.. us.return

**Returnwert**

**Return Value**

Falls *bOnlyTotalValue* TRUE (1) ist, liefert die Funktion nur den Endwert 
(Fläche unter der Kurve). Andernfalls liefert die Funktion den Verlauf.

.. us.params

**Parameter**

**Parameters**

.. uparam:: rvX 

   *rvX* ist ein Vektor mit den x-Koordinaten.

.. uparam:: rvY

   *rvY* ist ein Vektor mit den Y-Koordianten. Bei Aufruf ohne den
   Parameter *rvX* wird mit einem Punktabstand von 1 gerechnet.

.. uparam:: bOnlyTotalValue

   Falls *bOnlyTotalValue* TRUE (1) ist, liefert die Funktion den skalaren 
   Integralwert. Defaultwert ist FALSE (0).

.. us.example

**Beispiel**

::

   * rvX = 0:PI/100:PI
   * rvY = sin(X)
   * integral(rvX, rvY, 1)
        1.9998 

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

:sub:`id-675636`