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¶
| 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¶
| 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
Auto-generated from transformation schema. Worker id: curves_axial_crush. Schema hash: d37660a524b5. Hand-curated docs in workerexamples/ override this page when present.