.. _auto_complexcurve_percentile:

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

Computes the percentile value of a curve's Y-data over an optional X range. Use this worker when you need a single scalar statistic (e.g. the 50th or 95th percentile) extracted from a time-history or XY curve.

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

Classification: **process**.

Tagged: ``complex_curve``, ``curve``, ``percentile``, ``scalar``, ``statistics``, ``transformation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - The input XY curve (vector of X/Y pairs) whose Y-values will be used to compute the percentile; connect a time-history or any complex curve output from an upstream worker.
   * - Percentile
     - percentile
     - float
     - 0.0
     - 
     - The desired percentile to compute (0.0–100.0, e.g. 50.0 for the median or 95.0 for the 95th percentile); defaults to 0.0.
   * - Xmin
     - xmin
     - float
     - 0.0
     - 
     - Lower bound of the X range over which the percentile is evaluated; leave at 0.0 to start from the beginning of the curve.
   * - Xmax
     - xmax
     - float
     - 0.0
     - 
     - Upper bound of the X range over which the percentile is evaluated; leave at 0.0 to extend to the end of the curve.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - complexcurve_percentile_output_1
     - complexcurve_percentile_output_1
     - scalar
     - Scalar value representing the computed percentile of the curve's Y-data within the specified X range; inherits the Y-axis units of the input curve.

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

- data.curve.transform
- data.statistics

.. raw:: html

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