.. highlight:: us

.. index:: Berechnung des Plateaus
.. index:: plateau_computation
.. index:: Berechnung des Plateaus
.. index:: Schrittstatistik

.. _plateau_computation:
 
plateau_computation
========================

.. us.tag plateau_computation math New6803

:ref:`plateau_computation` berechnet für jedes durch rvPlateau definierte
Plateau eine Statistik unter Verwendung der entsprechenden Werte aus rvData.

Auf jedes erkannte Plateau können unabhängig voneinander verschiedene
statistische Operationen angewendet werden (z. B. Mittelwert, Minimum, Maximum,
Standardabweichung).

.. function::  rmXY = plateau_computation(rvPlateau, rvData, rsOperation, bTable);

.. us.return

**Returnwert**

*rmXY* ist ein Vektor, dessen Inhalt von *bTable* abhängt. Bei *bTable* = 0 wird
die berechnete Statistik allen Stichproben jedes Plateaus zugewiesen (alle
anderen Stichproben werden auf #INF gesetzt), während bei *bTable* = 1 ein
einziger Wert pro Plateau zurückgegeben wird, der sich für die tabellarische
Darstellung oder die weitere Verarbeitung eignet.

.. us.params

**Parameter**

.. uparam:: rvPlateau

    *rvPlateau* ist der Kanal, der die Plateaus anzeigt.

.. uparam:: rvData

    *rvData* ist der Kanal, für den die Statistik berechnet werden soll.

.. uparam:: rsOperation

    Ist die Statistik, die für jedes Plateau in *rvPlateau* auf *rvData*
	berechnet werden soll

.. uparam:: bTable

    *bTable* gibt an, ob die Daten bereitgestellt werden:
    
      * als Vektor mit derselben Länge wie die Originaldaten, jedoch mit dem
	    Wert 0 für die Schritte und den Ergebnissen der Berechnung für jedes
		Plateau.
      * als Vektor mit ebenso vielen Punkten wie Schritten, nützlich, um in
	    einem Bericht als Tabelle dargestellt zu werden.

.. us.example

**Beispiel**

Im folgenden Beispiel entspricht das Signal *rvData* (grün) dem Mittelwert auf
jedem Plateau (blau).

  .. image:: S:/uniplot-obj/images/xyfilter_plateau_computation.*
     :width: 100%

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - R2026.3
     - Neu.

.. seealso::
   :ref:`uberblick-mathematik`,
   :ref:`data-plateaus-computation`,
   :ref:`data-find-plateaus`,
   :ref:`find_plateau`,
   :ref:`filter-functions-for-xy-datasets`

:sub:`id-707603`