Differences

This shows you the differences between two versions of the page.

--- visual3d:documentation:pipeline:signal_commands:transform_data_coordinate_system [2024/06/26 20:29] – created sgranger
+++ visual3d:documentation:pipeline:signal_commands:transform_data_coordinate_system [2024/11/26 20:58] (current) – Work in progress. Created the page, though. wikisysop
@@ Line 1: / Line 1: @@
-Under Construction...
+===== Transform_Data_Coordinate_System =====
+This pipeline command does what its name suggests: it transforms signals from one coordinate system to another. A popular use case for this command is to transform signals from the [[visual3d:documentation:definitions:laboratory_coordinate_system|Lab Coordinate System]] to a [[visual3d:tutorials:modeling:virtual_laboratory|Virtual Lab Coordinate System]], for example when a participant turns around and walks back to their initial point.
+==== Pipeline Command ====
+<code>
+Transform_Data_Coordinate_System
+/SIGNAL_TYPES=FORCE+FORCE+FREEMOMENT+FREEMOMENT
+/SIGNAL_FOLDER=ORIGINAL+PROCESSED+ORIGINAL+PROCESSED
+! /SIGNAL_NAMES=
+/FROM_SEGMENT_CS=VLAB
+/TO_SEGMENT_CS=LAB
+! /RESULT_TYPES=
+! /RESULT_FOLDERS=
+! /RESULT_NAME=
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=TRUE
+/ORIENTATION_ONLY=TRUE
+/USE_DATA_RATE=TRUE
+;
+</code>
+==== Notes ====
+==== Examples ====
+Moving force plates [[visual3d:documentation:kinematics_and_kinetics:external_forces:dynamic_force_platforms#example_2|can be modelled]] using a process that leverages the Transform_Data_Coordinate_System command. The premise is that once you create segments representing the force platform and move it to the lab origin (aligned with the lab coordinate system), you transform your [[Visual3D:Documentation:Visual3D_Signal_Types:FORCE_Data_Type|FORCE]], [[Visual3D:Documentation:Visual3D_Signal_Types:COFP_Data_Type|COFP]] and [[Visual3D:Documentation:Visual3D_Signal_Types:FREEMOMENT_Data_Type|FREEMOMENT]] signals from the force platform at the origin to the moving platforms.
+<code>
+Transform_Data_Coordinate_System
+/SIGNAL_TYPES=FORCE+FORCE+FREEMOMENT+FREEMOMENT
+/SIGNAL_FOLDER=ORIGINAL+PROCESSED+ORIGINAL+PROCESSED
+! /SIGNAL_NAMES=
+/FROM_SEGMENT_CS=VLAB
+/TO_SEGMENT_CS=LAB
+! /RESULT_TYPES=
+! /RESULT_FOLDERS=
+! /RESULT_NAME=
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=TRUE
+/ORIENTATION_ONLY=TRUE
+/USE_DATA_RATE=TRUE
+;
+! Transform COFP - Translation as well (not Orientation only)
+Transform_Data_Coordinate_System
+/SIGNAL_TYPES=FORCE+COFP
+/SIGNAL_FOLDER=ORIGINAL+PROCESSED
+! /SIGNAL_NAMES=
+/FROM_SEGMENT_CS=VLAB
+/TO_SEGMENT_CS=LAB
+! /RESULT_TYPES=
+! /RESULT_FOLDERS=
+! /RESULT_NAME=
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=TRUE
+! /ORIENTATION_ONLY=FALSE
+/USE_DATA_RATE=TRUE
+</code>