PROJECT THE LINE IN 3D FORMED BETWEEN TWO-POINTS ONTO A PLANE PASSING THROUGH P1¶
Projects the 3D line segment formed between two points (P1 and P2) onto a specified plane passing through P1, then computes the angle of that projected line. Use this worker when you need to measure the planar angle of a spatial line — for example, tracking limb or component rotation in a crash event within a chosen projection plane.
When to use¶
Classification: process.
Tagged: 3d, angle, degrees, incremental, line, plane, project, projection.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| P1 XYZ | p1xy_z | vector | — | 3-component XYZ position vector for the first point (P1), which also defines the origin of the projection plane; provide as [x, y, z] in model length units. | |
| P2 XYZ | p2xy_z | vector | — | 3-component XYZ position vector for the second point (P2) that, together with P1, defines the line to be projected; provide as [x, y, z] in model length units. | |
| Measurement Type | measurement_type | select | total | Controls whether the output angle is the cumulative total rotation from the initial orientation (‘total’) or the frame-to-frame incremental change (‘incremental’); defaults to ‘total’. | |
| Plane | plane | select | yz | The plane onto which the P1→P2 line is projected before computing the angle; currently only ‘yz’ (the YZ plane) is supported; defaults to ‘yz’. | |
| Units | units | fixed | deg | Angular unit for the output angle — ‘deg’ for degrees or ‘radians’ for radians; fixed at ‘deg’ by default. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_project_line_to_plane_output_1 | curves_project_line_to_plane_output_1 | vector | Time-history vector of the projected line’s angle on the specified plane, expressed in the selected units (degrees or radians); each element corresponds to one input time step. |
Disciplines¶
- data.curve.transform
- 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_project_line_to_plane
Auto-generated from transformation schema. Worker id: curves_project_line_to_plane. Schema hash: a16797f0a33c. Hand-curated docs in workerexamples/ override this page when present.