.. _auto_curve_get_resting_times:

*DETECT RESTING TIMES FOR TIME-HISTORY DATA*
============================================

Detects "resting" (near-zero-activity) intervals in a time-history curve by applying configurable Y-value and slope thresholds over a minimum duration. Use it to segment signals — such as battery voltage, load, or displacement traces — and isolate quiescent periods for further analysis.

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

Classification: **process**.

Tagged: ``quiescent``, ``resting_times``, ``segmentation``, ``signal_analysis``, ``slope``, ``spike_removal``, ``threshold``, ``time_history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - Input time-history curve (X = time, Y = signal value) to be scanned for resting intervals; accepts any vector curve supported by the d3VIEW curve schema.
   * - Min Peak Time
     - minduration
     - scalar
     - 600
     - 
     - Minimum continuous duration (in the same time units as the curve X-axis, default 600) that a candidate segment must satisfy to be classified as a resting interval; shorter quiescent regions are discarded.
   * - Y Threshold Value
     - ythresholdvalue
     - scalar
     - 0.01
     - 
     - Y-value threshold (default 0.01) used together with threshold_type to decide whether a point is considered 'at rest'; can be a single value or a colon-separated range (e.g. '0.0:0.05') when threshold_type is 'between'.
   * - Slope Threshold Value
     - slopethresholdvalue
     - scalar
     - 0.0001
     - 
     - Slope (dY/dX) threshold (default 0.0001) below which the curve is considered flat; points whose absolute slope exceeds this value are excluded from resting segments; separate range bounds with a colon.
   * - Threshold Type
     - threshold_type
     - scalar
     - gt
     - 
     - Comparison operator applied to the Y threshold: 'gt' (Y greater than threshold), 'lt' (Y less than threshold), or 'between' (Y within the colon-separated range); default is 'gt'.
   * - Remove Spikes
     - remove_spikes
     - scalar
     - yes
     - 
     - Whether to suppress short transient spikes before resting-time detection ('yes' / 'no', default 'yes'); enabling this prevents isolated noise peaks from breaking otherwise valid resting segments.
   * - MYVBB-BC
     - scale-y
     - scalar
     - no
     - 
     - Multiple Y values by by -1 before computing
   * - Threshold Value Type
     - threshold_value_type
     - scalar
     - range_percentage
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_get_resting_times_output_1
     - curve_get_resting_times_output_1
     - dataset
     - Dataset table listing each detected resting interval with at minimum its start time, end time, and duration; one row per identified quiescent segment.

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

- data.curve.transform
- data.signal_processing
- 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_get_resting_times <https://www.d3view.com/api/workflow/example?id=curve_get_resting_times>`_

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