TRANSFORM SET OF CURVES FROM GLOBAL TO LOCAL COORDINATE SYSTEM BASED ON THE REFERENCE X,Y,Z CURVES. USEFUL TO COMPUTE DISPLACEMENTS WITH RESPECT TO A LOCAL SYSTEM¶
Transforms a set of global X/Y/Z coordinate curves for multiple points into a local coordinate system defined by three reference nodes (origin, node 2, node 3). Use this worker to compute displacements or coordinates relative to a moving or fixed local frame, such as a vehicle body or occupant reference system.
When to use¶
Classification: process.
Tagged: coordinate_transform, curves, displacement, global_to_local, local_frame, lsdyna, multi_point, reference_system.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Reference Origin X Y Z Coord Curves | reference_origin_xyz_coord_curves | vector | — | Time-history curves [length units] for the X, Y, and Z coordinates of the local coordinate system origin (Node 1); supply three curves in X-Y-Z order; optional if no translation component is needed. | |
| Reference Node2 X Y Z Coord Curves | reference_node2xyz_coord_curves | vector | — | Time-history curves [length units] for the X, Y, and Z coordinates of the second reference node that defines the local system’s primary axis; supply three curves in X-Y-Z order. | |
| Reference Node3 X Y Z Coord Curves | reference_node3xyz_coord_curves | vector | — | Time-history curves [length units] for the X, Y, and Z coordinates of the third reference node that defines the local system’s secondary axis (completes the triad with Node 1 and Node 2); supply three curves in X-Y-Z order. | |
| Global X Y Z Curves of Multiple Points in XYZ order | global_xyz_curvesof_multiple_pointsin_xy_zorder | vector | — | Ordered list of time-history curves [length units] representing the global X, Y, Z coordinates of all points to be transformed; curves must be provided in repeating X-Y-Z triplet order across all points. | |
| Reference System | reference_system | local_fixed | coord | Transformation mode: ‘local_fixed’ freezes the frame at t=0, ‘local_translate’ applies translation only, ‘local_rotate_translate’ applies full rigid-body motion, ‘no_transform’ returns global values unchanged; defaults to ‘local_fixed’. | |
| Return type | returntype | string | coordinates | Output quantity selector: ‘coordinates’ returns absolute local-frame positions, ‘displacements’ returns positions relative to the initial local-frame location; defaults to ‘coordinates’. | |
| Coordinate Definition Type | coorddefinitiontype | string | lsdyna | ||
| Rotate Z (deg) | rotate_z | string | 0.0 | Rotation the local system around local Z before transforming |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_coordtransform_groups_output_1 | curves_coordtransform_groups_output_1 | vector | Ordered collection of time-history curves [length units] containing the transformed X, Y, Z values for each input point in the local coordinate frame, preserving the same X-Y-Z triplet order as the input. |
Disciplines¶
- data.curve.pair
- data.curve.transform
- data.units
- 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_coordtransform_groups
Auto-generated from transformation schema. Worker id: curves_coordtransform_groups. Schema hash: 300228b6ce6a. Hand-curated docs in workerexamples/ override this page when present.