.. _auto_curve_get_power_drive_cycles:

*COMPUTER POWER DRIVE CYCLES*
=============================

Segments a power (current/voltage vs. time) drive-cycle curve into individual charge/discharge pulse events by detecting charge intervals, applying a post-charge offset, and locating pulse peaks within a tolerance window. Use this worker to extract structured drive-cycle statistics from battery or EV power traces for downstream analysis or KPI reporting.

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

Classification: **process**.

Tagged: ``battery``, ``charge_detection``, ``drive_cycle``, ``ev``, ``power_curve``, ``pulse_extraction``, ``time_series_segmentation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose The Curve
     - curve_input
     - vector
     - —
     - 
     - Input power/current vs. time curve (vector) representing the drive cycle to be segmented; must contain at least one charge interval to produce meaningful output.
   * - Min Charge Duration
     - min_charge_duration
     - scalar
     - 30.0
     - 
     - Minimum duration (seconds, default 30.0) a charge event must last to be considered valid; shorter charge intervals are silently discarded.
   * - Post Charge Duration
     - post_charge_duration
     - scalar
     - 300.0
     - 
     - Time offset (seconds, default 300.0) added after the detected charge-end timestamp before the worker begins searching for the subsequent pulse peak.
   * - Pulse Peak Tolerance
     - peak_tolerance
     - scalar
     - 40.0
     - 
     - Half-width of the search window (seconds, default 40.0) centred on charge_end + post_charge_duration within which the pulse peak is located.
   * - Ignore First And Last Charge Events
     - ignorefirstandlastchargeevents
     - text
     - no
     - 
     - When set to 'yes', the first and last detected charge events are excluded from the output table; default is 'no' (all events are retained).
   * - Min Pulse Peak
     - min_pulse_peak
     - scalar
     - 0.0
     - 
     - Minimum acceptable pulse-peak amplitude (default 0.0); supply an absolute value in curve Y-units or a percentage string such as '20%' (relative to Y-range) — pulses below this threshold are dropped.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_get_power_drive_cycles_output_1
     - curve_get_power_drive_cycles_output_1
     - dataset
     - Dataset table where each row represents one detected drive-cycle pulse event, containing columns for charge start/end times, post-charge offset timestamp, and peak amplitude within the search window.

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

- data.curve.transform
- data.signal_processing
- engineering.battery

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

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

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