Differences

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

--- visual3d:documentation:pipeline:model_based_data_commands:joint_angle [2024/08/26 19:45] – [Examples] wikisysop
+++ visual3d:documentation:pipeline:model_based_data_commands:joint_angle [2025/04/30 15:51] (current) – Big reorganization to try to keep related materials together. Work ongoing, especially for the examples. wikisysop
@@ Line 5: / Line 5: @@
 A more insidious problem is that there are joints, such as the shoulder, for which there is no single definition of the joint angle that is anatomically meaningful for the full range of motion of the joint. The consequence is that there is no standard sequence of rotations for describing the shoulder motion, despite the recommendation by the International Shoulder Group.
-Further information about joint angles can be found in the [[https://www.c-motion.com/textbook/|Research Methods in Biomechanics]] textbook and in Tom Kepple's [[https://www.has-motion.com/download/examples/JointAnglesLecture.pdf|lecture]] from the University of Delaware.
+===== Representing Joint Angles =====
-==== Transformation Matrix ====
+A Joint Angle is the transformation between two coordinate system that is described by a rotation matrix. This rotation matrix is rarely used to report the joint angle and it is instead represented as a Cardan/Euler angle, a Helical angle, or a Quaternion. All representations of the transformation are equivalent but the interpretation of the joint angle relative to the anatomy varies with the description.
-A Joint Angle is the transformation between two coordinate system that is described by a rotation matrix.
-This rotation matrix is rarely used to report the joint angle. From the rotation matrix several different representations are possible, such as Cardan/Euler angle, Helical angle, Quaternion. All representations of the transformation are equivalent but the interpretation of the joint angle relative to the anatomy varies with the description.
 ==== Units for Joint Angles ====
@@ Line 17: / Line 13: @@
 Joint Angles, Joint Angular Velocity, and Joint Angular Acceleration are the only signals in Visual3D that don't use standard MKS units. Visual3D uses degrees, degrees/sec, and degrees/sec^2. These are traditional units in Gait Analysis and we have followed the trend.
-==== Visual3D Default Joint Angle Conventions ====
+===== Visual3D Default Joint Angle Conventions =====
-To illustrate the default segment coordinate system in Visual3D, let's look at the right and left legs. The default segment coordinate system in Visual3D is defined as follows:
+To illustrate the default segment coordinate system in Visual3D, let's look at the right and left legs using their [[visual3d:documentation:modeling:coordinate_system|default segment coordinate systems]]. These default coordinate systems are not the same anatomical reference frames due to the effect of the [[visual3d:documentation:definitions:right_hand_rule|right-hand rule]].
-The default Cardan sequence for the calculation of joint angles is **x-y-z**, which is equivalent to:
+^Component^Left Leg^Right Leg^
+|X|Medial|Lateral|
+|Y|Anterior|Anterior|
+|Z|Up|Up|
-**flexion/extension-abduction/adduction-axial rotation**
+The default Cardan sequence for calculating joint angles is **x-y-z**, which is equivalent for each leg to:
-**Right Leg**
+  - X: Flexion/Extension
+  - Y: Abduction/Adduction
+  - Z: Axial Rotation
-x-lateral
+Taking these together, the default sign conventions for describing joint angles mean that positive joint angles for the knee and hip are as follows:
-y-anterior
-z-up
-**Left Leg**
-x-medial
+^ ^  Left Leg  ^^^  Right Leg  ^^^
-y-anterior
+^ Joint ^ X ^ Y ^ Z ^ X ^ Y ^ Z ^
-z-up
+| Knee | Extension | Abduction | External Rotation | Extension | Adduction | Internal Rotation |
-The default sign conventions for describing the joint angles are as follows:
+| Hip | Flexion | Abduction | External Rotation | Flexion | Adduction | Internal Rotation |
-**Right Leg**
-Knee(EXT+) (ADD+) (INTROT+)
-Hip(FL+)(ADD+) (INTROT+)
-**Left Leg**
-Knee(EXT+) (ABD+) (EXTROT+)
-Hip(FL+)(ABD+) (EXTROT+)
-=== The case of the Ankle Angle ===
-The ankle is especially confusing because of differences between the typical kinetic foot and the typical kinematic only foot.
-The typical kinetic foot is displayed here:
-{{:tutorial1_16.jpg}}
-For this representation of the foot segment the z-axis is directed from the metatarsals to the ankle center.
-The sign convention for the ankle angle defined using the kinetic foot relative to the shank segment is:
-**Right Leg**
-Ankle (DFL+) (FFADDUCTION+) (EVER+)
-**Left Leg**
-Ankle (DFL+) (FFABDUCTION+) (INVER+)
-A common kinematic only foot is displayed here:
-{{:RFT_2_Rotated.jpg}}
-For this representation of the virtual foot segment the y-axis is directed from the heel to the toe.
-The sign convention for the ankle angle defined using this kinematic foot relative to the shank segment is:
-**Right Leg**
-Ankle (DFL+) (INVER+) (FFADDUCTION+)
-**Left Leg**
-Ankle (DFL+) (EVER+) (FFABDUCTION+)
 ==== The Effect of the Right Hand Rule ====
-As discussed in the [[#Visual3D_Default_Joint_Angle_Conventions|Visual3D Default Joint Angle Conventions]] section above on this page, the medial and lateral coordinate system directions for left and right sides are different. This will effect the sign convention for joint angles. Meaning that the sign convention is not consistent between left and right sides. For example, inward rotation of the right leg (rotation about the long axis toward medial) is positive, but inward rotation of the left leg (rotation about the long axis toward medial) is negative.
+As mentioned above, the medial and lateral coordinate system directions for left and right sides are different. This affects the sign convention for joint angles such that signs not consistent between left and right sides. For example, inward rotation of the right leg (rotation about the long axis toward medial) is positive, but inward rotation of the left leg (rotation about the long axis toward medial) is negative.
-However, all joint angles are treated the same in Visual3D, so the direction of positive angle is determined with respect to the segment coordinate system of the reference segment; using the Right Hand Rule.
-The result of this decision is that flexion/extension has the same sign for left and right legs, but inward/outward rotation and abduction/adduction have opposite signs.
-The user can change this by negating the necessary terms when the joint angle is defined in the **Compute Model Based Items** Dialog. Refer [[Visual3D:Tutorials:Kinematics_and_Kinetics:Model_Based_Computations#Understanding_the_Knee_Angle_Signal|here]] for an example.
-==== The Joint Coordinate System ====
-As a default, Visual3D calculates Joint Angles using a Cardan sequence of rotations. In the section [[#Visual3D_Default_Joint_Angle_Conventions|Visual3D Default Joint Angle Conventions]] on this page, we detailed the Visual3D default segment coordinate system (z-up, y-anterior). Therefore the cardan sequence X-Y-Z is equivalent to the Joint Coordinate System.
+All joint angles are treated the same in Visual3D, so the direction of positive angle is determined with respect to the segment coordinate system of the reference segment; using the Right Hand Rule. The result of this decision is that flexion/extension has the same sign for left and right legs, but inward/outward rotation and abduction/adduction have opposite signs. The user can change this by negating the necessary terms when the joint angle is defined in the **Compute Model Based Items** Dialog. Refer [[Visual3D:Tutorials:Kinematics_and_Kinetics:Model_Based_Computations#Understanding_the_Knee_Angle_Signal|here]] for an example.
-If the user has modified the Segment Coordinate System from the Visual3D default, then more care must be taken in determining the sequence of rotations that is equivalent to the Joint Coordinate System. The sequence should be selected as flexion/extension - abduction/adduction - axial rotation.
+===== The Joint Coordinate System =====
-For a segment coordinate system defined as y-up and x-anterior, the Cardan Sequence equivalent to the Joint Coordinate system is Z-X-Y.
+As a default, Visual3D calculates Joint Angles using a Cardan sequence of rotations. In the section [[#Visual3D_Default_Joint_Angle_Conventions|Visual3D Default Joint Angle Conventions]] on this page, we detailed the Visual3D default segment coordinate system (z-up, y-anterior). Therefore the Cardan sequence X-Y-Z is equivalent to the Joint Coordinate System.
-In other words, the first rotation is flexion/extension about the reference coordinate system, the last rotation is axial rotation about the other coordinate system, and the middle rotation is about an axis perpendicular to the other two axes.
+If the user has modified the Segment Coordinate System from the Visual3D default, then more care must be taken in determining the sequence of rotations that is equivalent to the Joint Coordinate System. The sequence should be selected as flexion/extension - abduction/adduction - axial rotation. For a segment coordinate system defined as y-up and x-anterior, the Cardan Sequence equivalent to the Joint Coordinate system is Z-X-Y. In other words, the first rotation is flexion/extension about the reference coordinate system, the last rotation is axial rotation about the other coordinate system, and the middle rotation is about an axis perpendicular to the other two axes.
 **Note:** Visual3D will only allow a right hand coordinate system so the positive direction of rotation about an axis will need to be verified by inspecting the Segment Coordinate System visually in Visual3D's Model Builder mode.
@@ Line 112: / Line 62: @@
 ==== Helical Angle ====
-The helical angle calculation is output as vector rather than a unit vector and an angle of rotation.
+The helical angle calculation is output as vector rather than a unit vector and an angle of rotation. Visual3D is simply multiplying the angle of the rotation by the three components of the unit vector.
-Visual3d is simply multiplying the angle of the rotation by the three components of the unit vector.
+Is it possible to calculate a helical axis (vector and angle) in Visual3D? The answer yes by going the opposite way. To do this you would have to first compute the magnitude of the output of the “Compute Model Based Helical_Angle” and then divide each of the components of this vector by the magnitude.
-Is possible to calculate a helical axis (vector and angle) in Visual 3D?
-The answer yes by going the opposite way. To do this you would have to first compute the magnitude of the output of the “Compute Model BasedàHelical_Angle” and then divide each of the components of this vector by the magnitude.
 To actually do this inside Visual3d you would:
+  - Use “Compute Model Based Helical_Angle” to get the helical angle as a vector.
+  - Use the Pipeline command “Signal Magnitude” (which is under Signal Math in the Pipeline) to get the magnitude of the “Compute Model Based Helical_Angle”. This would give you the angle you are looking for.
+  - Use the pipeline command Divide_Signal_BY_Constant to divide the result of “Compute Model Based Helical_Angle” by the result of the Signal Magnitude (Divide_Signal_BY_Constant is also under Signal Math in the Pipeline). This will give you the unit vector you are looking for.
-\\
+===== Joint Angle Normalization =====
-Step 1) Use “Compute Model BasedàHelical_Angle” to get the helical angle as a vector.
-Step 2) Use the Pipleline command “Signal Magnitude” (which is under Signal Math in the Pipeline) to get the magnitude of the “Compute Model BasedàHelical_Angle”. This would give you the angle you are looking for.
-Step 3) Use the pipeline command Divide_Signal_BY_Constant to divide the result of “Compute Model BasedàHelical_Angle” by the result of the Signal Magnitude (Divide_Signal_BY_Constant is also under Signal Math in the Pipeline). This will give you the unit vector you are looking for.
-==== Joint Angle Normalization ====
 Normalization is the process of referencing a joint (or segment) angle to the reference posture. The reference posture is the static posture (often referred to as the standing pose) captured as the model posture (e.g. the C3D file used to define the link model). In Visual3D the reference posture is the static trial used for the link model. Joint angles aren't vectors, which means they can not be added or subtracted. A normalized joint angle is, therefore, not computed as 3 offsets from a reference posture.
@@ Line 140: / Line 82: @@
 Note: In Visual3D joint angles are simply the transformation from one segment coordinate system to another segment coordinate system, so it follows that the definition (e.g. orientation) of the segment coordinate systems matters. For example, if two segment coordinate systems are aligned perfectly (even though they may be displaced from each other) the resulting joint angle signal is zero.
-[[Visual3D:Documentation:Modeling:Segments:Normalizing_the_Pelvis_Segment_Angle_Example|Normalizing the Pelvis Angle]]
+===== Examples =====
-|     **Deprecated examples**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-|**These examples are not recommended for use and are included for backwards compatibility only.**\\ \\ In early version of Visual3D, using default normalization of the knee causes the RKNEE_ANGLE signal to be zero in all 3 components when the subject is in the standing posture. This has not affect on the segment coordinate system definitions, so normalizing the joint angle does not "clean up" any errors in the definition of the segment. It simply sets the posture in which the joint angle is zero.\\ \\ We don't recommend using this normalization because there are situations in which the intermediate pose in the calculations will be in gimbal lock and the normalized angle will be undefined. In addition, it was sensitive to the subject's orientation relative to the lab, and was often being used incorrectly.\\ \\ As of version 5, the **Normalization** option for **Joint_Angle** was removed from the **Compute_Model_Based_Data** drop down list because it was sensitive to the subject's orientation relative to the lab, and was often being used incorrectly.  |
-==== Examples ====
+A collection of examples demonstrating some practical considerations that arise when we define joint angles for the human body.
-=== Pelvis Segment Angle ===
+==== Ankle Angle ====
+The ankle is especially confusing because of differences between the typical kinetic foot and the [[visual3d:tutorials:kinematics_and_kinetics:foot_and_ankle_angles|typical kinematic-only foot]]. The typical kinetic foot is displayed here:
+{{:tutorial1_16.jpg}}
+For this representation of the foot segment the z-axis is directed from the metatarsals to the ankle centre. The sign convention for the ankle angle defined using the kinetic foot relative to the shank segment is:
+**Right Leg**
+Ankle (DFL+) (FFADDUCTION+) (EVER+)
+**Left Leg**
+Ankle (DFL+) (FFABDUCTION+) (INVER+)
+A common kinematic only foot is displayed here:
+{{:RFT_2_Rotated.jpg}}
+For this representation of the virtual foot segment the y-axis is directed from the heel to the toe.
+The sign convention for the ankle angle defined using this kinematic foot relative to the shank segment is:
+**Right Leg**
+Ankle (DFL+) (INVER+) (FFADDUCTION+)
+**Left Leg**
+Ankle (DFL+) (EVER+) (FFABDUCTION+)
+==== Pelvis Angle ====
 The [[visual3d:documentation:modeling:segments:pelvis_segment_angle|Pelvis Angle]] typically refers to the orientation of the Pelvis relative to the Laboratory.
-=== Normalizing the Pelvis Angle ===
+==== Normalizing the Pelvis Angle ====
+[[Visual3D:Documentation:Modeling:Segments:Normalizing_the_Pelvis_Segment_Angle_Example|Normalizing the Pelvis Angle]]. The Coda and Helen Hayes pelvis are tilted forward approximately 20 degrees from the horizontal. In describing the orientation of the pelvis or for describing the hip joint angle, it is often convenient to define a pelvis angle that has a coronal plane parallel to the floor (eg a vertical segment with zero tilt).
-Normalizing the Pelvis Segment Angle. The Coda and Helen Hayes pelvis are tilted forward approximately 20 degrees from the horizontal. In describing the orientation of the pelvis or for describing the hip joint angle, it is often convenient to define a pelvis angle that has a coronal plane parallel to the floor (eg a vertical segment with zero tilt).
+==== Shoulder Angle ====
-=== Shoulder Angle ===
 There is no single definition of the shoulder joint angle that is anatomically meaningful for the full range of motion of the shoulder joint.
@@ Line 161: / Line 131: @@
 A good description of the challenges of the shoulder angle by Jim Richards can be found [[[https://www.google.ca/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&ved=0ahUKEwii9-23y53XAhUf0IMKHZyHA3IQFggqMAA&url=https%3A%2F%2Fwww1.udel.edu%2Fbiology%2Frosewc%2Fkaap686%2Freserve%2Fshoulder%2Fshoulder%2FBluePresentation.ppt&usg=AOvVaw3NJo0eWFaP63Y7eDdV9gGq|here]]]
-=== Computing the Range of Motion ===
+==== Computing the Range of Motion ====
-The Pelvis Angle typically refers to the orientation of the Pelvis relative to the Laboratory.
+The range of motion of the pelvis angle is commonly defined as the range of each component of the segment angle. While this isn't mathematically correct because joint angles are not vectors, it is still quite common.
-=== Creating a Virtual Laboratory: Example 1 ===
+==== Virtual Laboratory Segments ====
+A Virtual Laboratory segment can be created for many modelling conveniences, including [[visual3d:documentation:modeling:virtual_lab:creating_a_virtual_laboratory|normalizing joint angles]].
+===== See Also =====
+Further information about joint angles can be found in the [[https://www.c-motion.com/textbook/|Research Methods in Biomechanics]] textbook and in Tom Kepple's [[https://www.has-motion.com/download/examples/JointAnglesLecture.pdf|lecture]] from the University of Delaware.
+Or, go back to the overview of [[visual3d:documentation:visual3d_signal_types:link_model_based_data_type|Link_Model_Based items]].