.. _auto_curve_percentile:

*COMPUTE THE PERCENTILE FOR THE CURVE*
======================================

Computes a specified percentile value from the Y-data of a curve, optionally restricted to a defined X-axis window. Use this worker to extract a single scalar statistic (e.g., the 50th or 95th percentile) from any time-history or XY curve.

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

Classification: **process**.

Tagged: ``curve``, ``percentile``, ``scalar``, ``statistic``, ``transform``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - Input XY curve (vector) whose Y-values will be sampled for the percentile calculation; supports any time-history or signal curve.
   * - Percentile
     - percentile
     - float
     - 0.0
     - 
     - Percentile to compute from the curve's Y-values, expressed as a value in [0, 100] (e.g., 50.0 for the median); defaults to 0.0.
   * - Xmin
     - xmin
     - float
     - 0.0
     - 
     - Lower bound of the X-axis window over which the percentile is evaluated; set to 0.0 (default) together with xmax=0.0 to use the full curve range.
   * - Xmax
     - xmax
     - float
     - 0.0
     - 
     - Upper bound of the X-axis window over which the percentile is evaluated; set to 0.0 (default) together with xmin=0.0 to use the full curve range.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_percentile_output_1
     - curve_percentile_output_1
     - scalar
     - Scalar value representing the computed percentile of the curve's Y-data within the specified X-axis window.

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

- data.curve.transform
- data.statistics

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

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

.. 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_percentile</code>. Schema hash: <code>8767747aef65</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>