======IOR Gait Planar Angles======

===== Overview =====
This tutorial is a continuation of the [[visual3d:tutorials:modeling:ior_gait_full_body_model|IOR Gait Full Body Tutorial]]. This tutorial goes through computing planar angles with the IOR model, specifically looking at determining how different parts of the spine move relative to one another.



===== Planar Angles =====
To calculate the orientation of the trunk segments, planar angles are calculated to determine the orientation
of the various segments relative to one another. To calculate a planar angle, you need to either reference the 
ORIGINAL or PROCESSED folder when defining a target. If your targets have not been filtered or interpolated,
you will not have a processed folder and will need to use the ORIGINAL. However, if you plan to process your target
data in any way, you should do this now, prior to creating you planar angles. \\
{{:iorfb_trunksegments.png?500|This image was taken from the Multi-Segment trunk paper}} \\
The following abbreviations are used in naming the planar angles
  * **FE** Flexion/Extension
  * **LB** Lateral Bending
  * **AR** Axial Rotation
==== Spine FE & LB Landmarks ====
{{ :iorfb_rpv_ax.png?300}}
**1. Create RPV_AX:**
  - Click **Landmarks** button
  - Click **Add New Landmark** button
  - Create Landmark: RPV_AX
    * **Landmark Name:** RPV_AX
    * **Define Orientation Using:**
    * **Starting Point:** LV5
  - Offset Using the Following **ML\AP\AXIAL** Offsets:
    * **X:** 0.0 **Y:** 0.0 **Z:** -0.05
  - **Do NOT Check:** Offset by Percent (1.0 = 100%) (Meters when not checked)
  - **Do NOT Check:** Calibration Only Landmark (Not generated for assigned motion file(s))
==== FE Planar Angles ====
Below defines the orientation (flexion/extension) of the adjoining spine segments resolved in the pelvis coordinate system \\
**NOTE:** For the FE Planar Angles, the same definitions for the angles are used for both the left & right side. This
means the different sets of signals do not need to be created for the left and right sides (as with the LB and AR planar angles). \\
**NOTE-2:** To access these dialogs, you need to edit a command pipeline, the [[visual3d:documentation:pipeline:signal_commands:compute_planar_angle|"Compute_Planar_Angle" pipeline command]].
----
==== Spine FE Definitions ====
{{ :iorfb_sp5_sp4_fe.png?300}}
**2. Create Sp5_sp4_FE Planar angle:**
  - Define **Resulting Signal** Name: Sp5_Sp4_FE
  - Calculate a **4 point angle** between the following targets:
    - TARGET::PROCESSED::TV7
    - TARGET::PROCESSED::TV2
    - TARGET::PROCESSED::CV7
    - TARGET::PROCESSED::TV2
    * **Angle Direction:** Left Hand Rule 
    * **3D Space:** Always 0 to 180 degrees
    * **Projected onto Plane:** XY
    * **Note: The Reference segment will need to be changed to RPV within the text option.**
 \\
 \\
 \\
 \\
 \\
----
{{ :iorfb_sp4_sp3_fe.png?300}}
**3. Create Sp4_Sp3_FE planar angle:**
  - Define **Resulting Signal** Name: Sp4_Sp3_FE
  - Calculate a **4 point angle** between the following 
    - TARGET::PROCESSED::LV1
    - TARGET::PROCESSED::TV7
    - TARGET::PROCESSED::TV2
    - TARGET::PROCESSED::TV7
    * **Angle Direction:** Left Hand Rule
    * **3D Space:** Always 0 to 180 degrees
    * **Projected onto Plane:** XY
    * **Note: The reference segment will need to be changed to RPV within the text option**
 \\
 \\
 \\
 \\
 \\
 \\
----
{{ :iorfb_sp3_sp2_fe.png?300}}
**4. Create Sp3_Sp2_FE planar angle:**
  - Define **Resulting Signal** Name: Sp3_Sp2_FE
  - Calculate a **4 point angle** between the following targets:
    - TARGET::PROCESSED::LV3
    - TARGET::PROCESSED::LV1
    - TARGET::PROCESSED::TV7
    - TARGET::PROCESSED::LV1
    * **Angle Direction:** Left Hand Rule
    * **3D Space:** Always 0 to 180 degrees
    * **Projected onto Plane:** XY
    * **Note: The reference segment will need to be changed to RPV within the text option**
 \\ 
 \\ 
 \\
 \\
 \\
 \\
----
{{ :iorfb_sp2_sp1_fe.png?300}}
**5. Create Sp2_Sp1_FE planar angle:**
  - Define **Resulting Signal** Name: Sp2_Sp1_FE
  - Calculate a **4 point angle** between the following targets:
    - TARGET::PROCESSED::LV5
    - TARGET::PROCESSED::LV3
    - TARGET::PROCESSED::LV1
    - TARGET::PROCESSED::LV3
    * **Angle Direction:** Left Hand Rule
    * **3D Space:** Always 0 to 180 degrees
    * **Projected onto Plane:** XY
    * **Note: The reference segment will need to changed to RPV within the text option.**
 \\
 \\
 \\ 
 \\
 \\
 \\
 \\
----
{{ :iorfb_sp1_pel_fe.png?300}}
**6. Create Sp1_Pel_FE planar angle:**
  - Define **Resulting Signal** Name: Sp2_Sp1_FE
  - Calculate a **4 point angle** between the following targets:
    - LANDMARK::ORIGINAL::RPV_AX
    - TARGET::PROCESSED::LV5
    - TARGET::PROCESSED::LV3
    - TARGET::PROCESSED::LV5 
    * **Angle Direction:** Left Hand Rule
    * **3D Space:** Always 0 to 180 degrees
    * **Projected onto Plane:** XY
    * **Note: The reference segment will need to be changed to RPV within the text option.**
 \\
 \\
 \\
 \\
 \\
 \\
----