.. highlight:: us

.. index:: find plateau
.. index:: find_plateau
.. index:: plateau

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

.. us.tag find_plateau Interpolation New6803

:ref:`find_plateau` in the data.
A plateau is found, if the data is inside the tolerance of
+- dy_tol. The length in seconds (units as used in ctime) is longer than dx_min
and ends at the maximum dx_max or if rvY[i] is greater than the tolerance. 
Finds only plateaus that are in the range from y_min_threshold to
y_max_threshold. A plateau does not contain missing_values.

Each plateau is marked with a constant number, starting with 1, increment 1.
The ramps between the plateaus are set to 0. 

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

.. us.return

**Return Value**

*idx* is a vector where each plateau is marked with a constant number, starting
with 1 and increment by 1.
 
.. us.params

**Parameters**

.. uparam:: rvTime

	*rvTime* is the time channel.

.. uparam:: rvData

	*rvData* is the channel on which plateau are being looked for.

.. uparam:: dy_tol

	Plateau is found if data is whitn *dy_tol* tolerance.

.. uparam:: dx_min

	*dx_min* minimum duration to detect a plateau

.. uparam:: dx_max

	*dx_max* dx_max duration to detect a plateau

.. uparam:: y_min_threshold

	*y_min_threshold* minimum Y value to detect a plateau.

.. uparam:: y_max_threshold

	*y_max_threshold* minimum Y value to detect a plateau.

.. us.example

**Example**

In the example below, plateaus are detected on the blue signal using the
following find_plateau parameters:

* Y range: 1 to 9 (blue threshold)
* Y tolerance: 0.1 (pink threshold)
* X duration constraints (not shown in the figure):

  * X-min: 10 s — only plateaus lasting at least 10 seconds are considered valid.
  * X-max: 500 s — plateaus longer than 500 seconds are rejected.

With these settings, the generated plateau channel correctly identifies the four
plateaus whose values lie within the range 1 to 9 and whose durations satisfy
the X constraints. The subsequent plateaus are not detected because they falls
outside the specified Y range, as expected.

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

.. us.history

**History**

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

   * - Version
     - Description
   * - R2026.3
     - New.

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

:sub:`id-1756718`