.. _auto_curve_contact_duration:

*RETURNS ALL CONTACT FORCES*
============================

Computes the contact duration from a force-time curve by identifying the interval where the force exceeds a minimum threshold and remains below a maximum cutoff. Use this worker to extract meaningful contact windows from crash or impact force signals, filtering out insignificant contact events.

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

Classification: **process**.

Tagged: ``contact_duration``, ``crash``, ``curve``, ``force``, ``impact``, ``signal``, ``trimming``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - Force-time (or force-displacement) curve to be analysed; should be a numeric vector with time as X and force as Y.
   * - X Min
     - min_force
     - float
     - 0.0
     - 
     - Minimum force threshold (same units as curve Y-axis, default 0.0) below which contact is considered not yet started or already ended.
   * - X Max
     - max_force
     - float
     - 1e2.0
     - 
     - Maximum force threshold (same units as curve Y-axis, default 1e2) above which contact is considered to have ended; used to exclude insignificant residual contact tails.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_contact_duration_output_1
     - curve_contact_duration_output_1
     - vector
     - Trimmed force-time curve spanning only the detected contact duration — the sub-interval where force is between min_force and max_force.

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

- data.curve.transform
- data.signal_processing
- engineering.crash.dynamics

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

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

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