.. _auto_curves_axial_crush:

*COMPUTE THE AXIAL CRUSH OF A SET OF NODES*
===========================================

Computes the axial crush (structural deformation along a crush axis) from a set of nodal coordinate or displacement time-history curves. Accepts raw coordinates or displacements in multiple interleaved formats and returns the resulting axial crush curve, optionally scaled and expressed as a relative or percentage value.

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

Classification: **process**.

Tagged: ``axial_crush``, ``crush``, ``curves``, ``deformation``, ``displacement``, ``nodal_coordinates``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Axial Crush Nodal Coordinates Or Displacements
     - axialcrushnodalcoordinatesordisplacements
     - vector
     - —
     - 
     - One or more time-history curves representing nodal coordinates or displacements (mm or model units); format depends on `input_type` — supply raw d3plot/binout extractions here.
   * - Coordinates Input Type
     - input_type
     - string
     - coord
     - 
     - Format of the input curves: `disp` for displacement time histories, `coords_xyzxyz` for interleaved X1Y1Z1X2Y2Z2 coordinate pairs, or `coords_xxyyzz` for grouped XX…YY…ZZ coordinate pairs; default is `coord`.
   * - Sort Curves
     - sort_curves
     - string
     - no
     - 
     - Whether to sort the input curves before computing axial crush (`yes`) or use them in the order supplied (`no`); default is `no`.
   * - Sort Order
     - sort_order
     - string
     - asc
     - 
     - Sort direction applied when `sort_curves` is `yes`: `asc` (ascending) or `desc` (descending); default is `asc`.
   * - Scale Factor
     - scale_factor
     - string
     - 1.0
     - 
     - Multiplicative scale factor applied to the computed axial crush curve; use values other than `1.0` to convert units or normalise results; default is `1.0`.
   * - Value Type
     - value_type
     - string
     - relative
     - 
     - Output value representation: `relative` for absolute crush distance (model units), `percentage` for crush expressed as a percentage of the original span; default is `relative`.
   * - Num Dig
     - num_dig
     - string
     - 100
     - 
     - Number of digitized points

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_axial_crush_output_1
     - curves_axial_crush_output_1
     - vector
     - Computed axial crush time-history curve (model length units or percentage, depending on `value_type`), scaled by `scale_factor`, ready for downstream KPI extraction or visualisation.

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

- cae.postprocessing.extraction
- data.curve.transform
- 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=curves_axial_crush <https://www.d3view.com/api/workflow/example?id=curves_axial_crush>`_

.. raw:: html

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