===== 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>