.. _auto_curve_event_values:

*SPLIT THE CURVE BASED ON EVENTS*
=================================

Splits an input curve into segments defined by a set of timed events and extracts a representative scalar value (max, min, average, last, or absolute-last) from each segment. Use this worker when you need to summarise curve behaviour within discrete time windows derived from an event table.

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

Classification: **process**.

Tagged: ``average``, ``curve``, ``event``, ``extract``, ``max``, ``min``, ``segment``, ``split``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve In
     - curve_in
     - vector
     - —
     - 
     - The source time-history curve (x = time, y = signal) to be segmented and reduced; supply any single vector curve.
   * - Events
     - events
     - dataset
     - —
     - 
     - Dataset table containing at least one column with the start time of each event that defines the segment boundaries.
   * - Include Last Point
     - includelastpoint
     - list
     - yes
     - 
     - Whether to include the final data point of the curve in the last event segment; choose 'yes' (default) to capture the trailing edge, 'no' to exclude it.
   * - Include Last Point
     - value_type
     - list
     - max
     - 
     - Aggregation method applied to each segment: 'max' (default), 'min', 'average', 'last' (final value), or 'abs_last' (absolute value of the final point).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_event_values_output_1
     - curve_event_values_output_1
     - dataset
     - Dataset where each row corresponds to one event segment and contains the extracted scalar value (per the chosen Value Type) for that segment.

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

- data.curve.pair
- 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_event_values <https://www.d3view.com/api/workflow/example?id=curve_event_values>`_

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