.. _auto_lsdyna_contact_time_history:

*LSDYNA CONTACT TIME HISTORY*
=============================

Extracts full time-history contact force curves from LS-DYNA rcforc (binout) output for a given simulation, then computes per-interval interaction matrices and rich curve statistics (peak force, impulse, max slope, etc.) for every contact part-pair. Use this worker to understand how contact forces evolve across time intervals and which part interactions are most significant.

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

Tagged: ``binout``, ``contact``, ``contact_force``, ``curve_stats``, ``d3hsp``, ``interval_matrix``, ``lsdyna``, ``part_pair``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - 
     - Reference to the LS-DYNA simulation record whose binout and d3hsp files will be read; select from the remote simulation lookup.
   * - Number of Time Intervals
     - num_intervals
     - integer
     - 10
     - 
     - Number of equal-width time intervals to divide the simulation duration into for the interval matrices (integer 1–100; default 10).
   * - Interval Range
     - interval_range
     - string
     - —
     - 
     - Optional colon-delimited slice of intervals to include in the interval_matrices output (e.g. '4:10' returns intervals 4 through 10 inclusive); leave empty to return all intervals.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Contact Force Profiles
     - contact_force_profiles
     - dataset
     - Dataset of one row per contact, containing contact metadata (name, slave/master part IDs) and full-simulation resultant-force curve statistics (peak force, impulse, max slope, number of time points), sorted by peak force descending.
   * - Interval Matrices
     - interval_matrices
     - dataset
     - Dataset of per-interval, per-part-pair interaction rows (filtered to the requested interval_range), each containing interval index, time bounds, and curve statistics computed over that interval window.
   * - Summary
     - summary
     - string
     - Human-readable string reporting the number of contacts extracted, interval count, active interval range shown, count of contacts with non-zero peak force, and any range-clamping warnings.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- engineering.crash.dynamics

.. raw:: html

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