.. _auto_curve_sustained_ymax:

*COMPUTE THE MAXIMUM Y-VALUE THAT IS MAINTAINED OVER THE DURATION SPECIFIED*
============================================================================

Computes the maximum y-value that is continuously sustained over a specified x-axis duration on a given curve. A minimum threshold (absolute or percentage of peak) filters out insignificant values, and an optional early-exit flag stops the search at the first qualifying sustained maximum found.

When to use
-----------

Classification: **process**.

Tagged: ``curve``, ``duration``, ``max_value``, ``signal_analysis``, ``sustained_ymax``, ``threshold``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - Input curve (x/y vector) on which the sustained maximum y-value is evaluated; must be a valid d3VIEW curve object.
   * - Y Min
     - duration
     - float
     - 0.0
     - 
     - Minimum x-axis span (in the curve's native x-units, e.g. seconds or milliseconds) over which the y-value must be continuously maintained; defaults to 0.0 (instantaneous peak).
   * - Min Threshold
     - min_threshold
     - float
     - 10%
     - 
     - Minimum acceptable y-value for consideration; supply as an absolute numeric value or as a percentage string (e.g. '10%') relative to the curve's global maximum — values below this threshold are skipped; defaults to '10%'.
   * - Stop At First Value
     - stop_at_first_value
     - float
     - yes
     - 
     - When set to 'yes' (default), the search terminates as soon as the first qualifying sustained maximum is found; set to 'no' to scan the entire curve and return the global sustained maximum.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_sustained_ymax_output_1
     - curve_sustained_ymax_output_1
     - scalar
     - Scalar y-value representing the highest magnitude that is continuously maintained for at least the specified duration, filtered by the minimum threshold.

Disciplines
-----------

- data.curve.transform
- data.signal_processing

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curve_sustained_ymax <https://www.d3view.com/api/workflow/example?id=curve_sustained_ymax>`_

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>curve_sustained_ymax</code>. Schema hash: <code>66685dcb0c40</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>