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 X/Y/Z curves from the global coordinate system into a user-defined local coordinate system specified by three reference node trajectories. Use this worker to compute displacements, velocities, or coordinates relative to a moving or fixed local frame (e.g., vehicle body, sled, or dummy segment).
When to use¶
Classification: process.
Tagged: coordinate_transform, curves, displacement, global_to_local, group_transform, kinematics, local_frame, lsdyna.
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, Z global coordinates of the local frame’s origin node (Node 1 / N1); typically three curves ordered X, Y, Z — leave empty only if no moving origin is needed. | |
| Reference Node2 X Y Z Coord Curves | reference_node2xyz_coord_curves | vector | — | Time-history curves [length units] for the X, Y, Z global coordinates of Node 2, which defines the primary axis direction of the local frame together with N1; required for any rotating or translating local system. | |
| Reference Node3 X Y Z Coord Curves | reference_node3xyz_coord_curves | vector | — | Time-history curves [length units] for the X, Y, Z global coordinates of Node 3, which defines the secondary axis direction of the local frame together with N1 and N2; required for fully 3-D local frame definitions. | |
| Global X Y Z Curves | global_xyz_curves | vector | — | Time-history curves [length units] for the X, Y, Z global coordinates (or velocities/displacements) of the point(s) to be transformed into the local frame; must share the same time axis as the reference node curves. | |
| Reference System | reference_system | local_fixed | coord | Enumerated local-frame type controlling how the frame evolves in time: ‘local_fixed’ (default, frame fixed at t=0), ‘local_translate’ (origin follows N1 translation only), ‘local_rotate_translate’ (full 6-DOF tracking), or ‘no_transform’ (pass-through); default is ‘local_fixed’. | |
| Return type | returntype | string | coordinates | Quantity to return after transformation: ‘coordinates’ (default, absolute position in local frame), ‘displacements’ (position relative to initial local position), or ‘velocities’ (time-differentiated local-frame motion). | |
| Coord definitiontype | coorddefinitiontype | string | clsdyna |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_coordtransform_group_output_1 | curves_coordtransform_group_output_1 | vector | Transformed time-history curves expressed in the local coordinate system, in the same units and quantity type (coordinates, displacements, or velocities) as requested via ‘returntype’; one curve per input global channel. |
Disciplines¶
- data.curve.transform
- data.units
- engineering.crash.dynamics
- engineering.multibody
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curves_coordtransform_group
Auto-generated from transformation schema. Worker id: curves_coordtransform_group. Schema hash: a6400f75db0f. Hand-curated docs in workerexamples/ override this page when present.