.. highlight:: us

.. index:: Erkennt Plateaus
.. index:: find_plateau

.. _find_plateau:
 
find_plateau
============

.. us.tag find_plateau Interpolation New6803

:ref:`find_plateau` in den Daten.
Ein Plateau wird gefunden, wenn die Daten innerhalb der Toleranz von ± dy_tol
liegen. Die Länge in Sekunden (Einheiten wie in ctime verwendet) ist größer als
dx_min und endet bei dem Maximum dx_max oder wenn rvY[i] größer als die Toleranz
ist. 
Es werden nur Plateaus gefunden, die im Bereich von y_min_threshold bis
y_max_threshold liegen. Ein Plateau enthält keine missing_values.
Jedes Plateau wird mit einer fortlaufenden Nummer gekennzeichnet, beginnend mit
1, in Schritten von 1.
Die Rampen zwischen den Plateaus werden auf 0 gesetzt. 

.. function::  idx = find_plateau(rvTime, rvData, dy_tol, dx_min, dx_max, y_min_threshold, y_max_threshold);

.. us.return

**Returnwert**

*idx* ist ein Vektor, in dem jedes Plateau mit einer konstanten Zahl
gekennzeichnet ist, beginnend mit 1 und jeweils um 1 erhöht.

.. us.params

**Parameter**

.. uparam:: rvTime

	*rvTime* ist der Zeitkanal.

.. uparam:: rvData

	 *rvData* ist der Kanal, auf dem nach Plateaus gesucht wird.

.. uparam:: dy_tol

	Ein Plateau wird erkannt, wenn die Daten innerhalb der Toleranz *dy_tol* liegen.

.. uparam:: dx_min

	*dx_min* ist die Mindestdauer zur Erkennung eines Plateaus.

.. uparam:: dx_max

	*dx_max* ist die maximale Dauer zur Erkennung eines Plateaus.

.. uparam:: y_min_threshold

	*y_min_threshold* ist der minimale Y-Wert zur Erkennung eines Plateaus.

.. uparam:: y_max_threshold

	*y_max_threshold* Minimaler Y-Wert zur Erkennung eines Plateaus.

.. us.example

**Beispiel**

Im folgenden Beispiel werden Plateaus im blauen Signal mithilfe der folgenden
find_plateau-Parameter erkannt:

* Y-Bereich: 1 bis 9 (blaue Schwelle)
* Y-Toleranz: 0,1 (rosa Schwelle)
* X-Dauerbedingungen (in der Abbildung nicht dargestellt):

  * X-min: 10 s — nur Plateaus mit einer Dauer von mindestens 10 Sekunden werden als gültig betrachtet.
  * X-max: 500 s — Plateaus mit einer Dauer von mehr als 500 Sekunden werden verworfen.

Mit diesen Einstellungen erkennt der erzeugte Plateau-Channel korrekt die vier
Plateaus, deren Werte im Bereich von 1 bis 9 liegen und deren Dauer die
X-Bedingungen erfüllt. Das nachfolgende Plateau wird erwartungsgemäß nicht
erkannt, da es außerhalb des definierten Y-Bereichs liegt.

  .. image:: S:/uniplot-obj/images/xyfilter_find_plateau.*
    :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-1756718`