Differences

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

--- visual3d:documentation:kinematics_and_kinetics:external_forces:force_assignment [2024/07/17 15:45] – created sgranger
+++ visual3d:documentation:kinematics_and_kinetics:external_forces:force_assignment [2025/03/18 18:03] (current) – Cleaned page up. wikisysop
@@ Line 1: / Line 1: @@
 ====== Force Assignment ======
-Assignment of Force signals to a Visual3D segment
+Visual3D assigns segments to force platforms based on the estimated contact of a segment with the force platform. Contact is estimated by comparing the path of the segment's center of mass with the center of pressure (COP) on the force platform. Force assignments allow the user to compute the ground reaction force and center of pressure based on specifying a segment rather than the force platform. For example, it is possible to create a report graph for the GRF and COP under the right foot. This means that the user doesn't have to document which segment hit which force platform.
-Visual3D assigns segments to force platforms based on the estimated contact of a segment with the force platform. Contact is estimated by comparing the path of the center of mass of the segment with the center of pressure on the force platform.
+===== Automatic Force Assignments =====
-The assignment allows the user to compute the ground reaction force and center of pressure based on specifying a segment rather than the force platform. For example, it is possible to create a report graph for the GRF and COP under the right foot. This means that the user doesn't have to document which segment hit which force platform.
+At each frame of contiguous COP values, for every segment in the model, the distance between that segment's center of mass and the center of pressure for all Force Platforms/Structures is calculated. The mean value of each of these per-segment signals is computed and the segment with the smallest mean distance is assigned the force.
-When a segment is created in Visual3D, signals are created that contain, at each frame of contiguous COP values, the distance from the center of mass of each segment to the center of pressure from all Force Platforms/Structures. The mean value of each of these signals is computed. The segment with the smallest mean distance is is assigned the force.
+{{:COPDistance.jpg}}
-==== KINETIC_KINEMATIC Forces ====
+The [[Visual3D:Documentation:Modeling:Segments:Segment_to_COFP_Distance|COP Distance]] is a threshold distance that must be satisfied in order to identify a force assignment. If the distance is too small or the COP error is too high then recognizable assignments might not be made. The default value of 0.2 metres has proven to be an acceptable value, so users should refrain from modifying this value unless they have a very good reason.
-If one or more forces are assigned to a segment 3 resultant signals are created.
+==== Updating Assigned Forces Warning ====
-\\
+The automatic force assignments are computed on [[Visual3D:Documentation:Pipeline:File_Commands:Recalc|Recalc]]. If the forces are modified by either changing the parameter or by processing the signals, the force assignments are not updated until [[Visual3D:Documentation:Pipeline:File_Commands:Recalc|Recalc]].
+===== Manual Assignment =====
-  - [[Visual3D:Documentation:Kinematics_and_Kinetics:Force|Force_n]] - Assigned Forces
+Under the Model menu is an option to View/Edit Segment to Force assignments.
-  - [[Visual3D:Documentation:Kinematics_and_Kinetics:COP|COP_n]] - Assigned Center of Pressure
-  - [[Visual3D:Documentation:Kinematics_and_Kinetics:Free_Moment|Free_Moment_n]] - Assigned Free Moment
-==== COP Distance to Segment ====
+{{:AssignForceMenu.jpg}}
-{{:COPDistance.jpg}}
+This allows the user to check that forces have been applied to the appropriate segments for the appropriate number of frames. If, for example, only a partial contact is made between the foot and the force platform, the user should probably delete the force assignment. The dialog allows the specification of any signals to represent the FORCE, COFP, and FREEMOMENT acting on a segment. These signals must be in laboratory coordinates.
-The [[Visual3D:Documentation:Modeling:Segments:Segment_to_COFP_Distance|COP Distance]] is a threshold distance that must be satisfied in order to identify a force assignment.
+{{ForceAssign1.jpg?640}}
-If the distance is too small, and the COP error is a little too high, a recognizable assignment might not be made.
+It is possible to add custom forces through the dialog:
-The default value of 0.2m has proven to be an acceptable value, so users should refrain from modifying this value unless they have a very good reason.
+{{:AddCustomForceDlg.jpg}}
-==== Automatic_Gait_Events ====
+And the following dialog shows the removal of all assignments to the right foot for all frames of the file (i.e. Frame 1 to Frame EOF where [[visual3d:documentation:definitions:eof_end_of_file|EOF=End of File]]):
-Automatic_Gait_Events are based on the force assignments, so if your assignments are bad, or don't exist, the gait events will be incorrect.
+{{RemoveForceAssignment.jpg?450}}
-It is extremely important that users check the assignments carefully. This is one of the most serious challenges to users that would like to have one pipeline process all of the data automatically. The pipeline should always pause after the model template has been applied and the movement trials assigned to the model. This is the time when the force assignments should be "cleaned up". If you compute the automatic gait events before the cleanup, your event labels will be junk.
+**Note: The dialog can only act on one active motion file. If more than one file are active (ALL_FILES or a TAG), the dialog will not appear**
-==== Assigned forces using Evaluate_Expression ====
+===== Pipeline Commands =====
-[[Visual3D:Documentation:Pipeline:Expressions:Expressions_Overview#Assigned_Forces|Evaluate_Expression for assigned forces]]
+Certain operations with force assignments can be automated using pipeline commands:
+  - [[Visual3D:Documentation:Pipeline:Force_Commands:Assign_Segments_To_Force_And_COP|Assign_Segments_To_Force_And_COP]]
+  - [[Visual3D:Documentation:Pipeline:Force_Commands:Remove_Segment_Assignment_To_Force_And_COP|Remove_Segment_Assignment_To_Force_And_COP]]
-\\
+===== General Considerations =====
+Force assignments result in Visual3D doing a lot of different work for the user, so it is important to keep these general considerations in mind.
-==== Updating Assigned Forces Warning ====
+==== KINETIC_KINEMATIC Forces ====
-The automatic force assignments are computed on [[Visual3D:Documentation:Pipeline:File_Commands:Recalc|Recalc]]. If the forces are modified by either changing the parameter or by processing the signals, the force assignments are not updated until [[Visual3D:Documentation:Pipeline:File_Commands:Recalc|Recalc]].
+If one or more forces are assigned to a segment then 3 resultant [[visual3d:documentation:visual3d_signal_types:kinetic_kinematic_data_type|Kinetic_Kinematic]] signals are created:
+  - [[Visual3D:Documentation:Kinematics_and_Kinetics:Force|Force_n]] - Assigned Forces
+  - [[Visual3D:Documentation:Kinematics_and_Kinetics:COP|COP_n]] - Assigned Center of Pressure
+  - [[Visual3D:Documentation:Kinematics_and_Kinetics:Free_Moment|Free_Moment_n]] - Assigned Free Moment
-==== Manual Assignment ====
+==== Animating Force Vectors ====
-Under the Model menu is an option to View/Edit Segment to Force assignments. This allows the user to check that forces have been applied to the appropriate segments for the appropriate number of frames. If, for example, only a partial contact is made between the foot and the force platform, the user should probably delete the force assignment.
+Force vectors are animated in Visual3D's [[visual3d:documentation:reports:3d_animation_viewer|3D animation viewer]], with [[visual3d:documentation:kinematics_and_kinetics:external_forces:force_vector_colors|force vector colours indicating assignment status]]. This is a handy way of quickly visualizing the quality of your force assignments, regardless of the method used.
-**Note: The dialog can only act on one active motion file. If more than one file are active (ALL_FILES or a TAG), the dialog will not appear**
+==== Working with Assigned Forces at the ANALOG Rate ====
-{{:AssignForceMenu.jpg}}
+The model-based items [[visual3d:documentation:pipeline:model_based_data_commands:grf_data|GRF_DATA]] and [[visual3d:documentation:pipeline:model_based_data_commands:cop_path|COP Path]] are signals stored at the [[visual3d:documentation:c3d_signal_types:target_data_type|POINT data rate]] because these signals can be resolved into a Segment Coordinate System and all Segment Coordinate Systems (except the default LAB) are at the POINT data rate. There are times, however, when it would be useful to get the Force, CofP, and FreeMoment for force assignments at the [[visual3d:documentation:c3d_signal_types:analog_data_type|ANALOG sample rate]]. In these cases it is possible to use the [[visual3d:documentation:pipeline:expressions:assigned_force_functions|Assigned Force expressions]].
-{{:AddCustomForceDlg.jpg}}
+==== External Forces ====
-If the Event Label for contact with the force platform are not consistent with the force assignment, spurious results may be observed. It is always good practice, to verify that the force assignments make sense.
+Force platforms are commonly used for biomechanical analyses. In recent years with the introduction of robotics for rehabilitation and the desire to have patients supported during gait (e.g. walkers), we have had many requests to include force transducer data into the Inverse Dynamics calculations. There are no general rules for specifying these external devices in the [[visual3d:documentation:c3d_signal_types:c3d_format|C3D file format]], so we are making this up as we go along. At no point will we violate the C3D file format, but the C3D Parameters that we use may not be recognized by other manufacturers.
-==== Pipeline Command ====
+Under the Model menu item is the option to "View/Edit Force assignments". The user can apply any external force to a segment by providing:
+  - the signal representing the force;
+  - the signal representing the Center of Pressure (which could be a landmark location on a segment); and
+  - the signal representing the free moment.
-[[Visual3D:Documentation:Pipeline:Force_Commands:Assign_Segments_To_Force_And_COP|Assign_Segments_To_Force_And_COP]]
+If the message **You must have an active motion capture file and link model to view force platform assignments!** pops up then you have not selected an Active Movement File. To do this you must switch to Signal and Event processing mode and select the movement file. If you are in Model Builder mode or Workspace mode, there may not be an active file.
-[[Visual3D:Documentation:Pipeline:Force_Commands:Remove_Segment_Assignment_To_Force_And_COP|Remove_Segment_Assignment_To_Force_And_COP]]
+==== Gait Events ====
-==== External Forces ====
+Automatic_Gait_Events are based on the force assignments, so if your assignments are bad, or don't exist, the gait events will be incorrect. It is extremely important that users check the assignments carefully. This is one of the most serious challenges to users that would like to have one pipeline process all of the data automatically. The pipeline should always pause after the model template has been applied and the movement trials assigned to the model. This is the time when the force assignments should be "cleaned up". If you compute the automatic gait events before the cleanup, your event labels will be junk.
-Force Platforms are commonly used for biomechanical analyses. In recent years with the introduction of robotics for rehabilitation and the desire to have patients supported during gait (e.g. walkers), we have had many requests to include force transducer data into the Inverse Dynamics calulations.
-There are no general rules for specifying these external devices in the C3D file format, so we are making this up as we go along. At no point will we violate the C3D file format, but the C3D Parameters that we use may not be recognized by other manufacturers.
-\\
+===== Examples =====
 ==== Example 1: Applying a force to a segment ====
-You can apply recorded external forces to any segment in the model (except kinematic only segments).
+You can apply recorded external forces to any segment in the model (except kinematic only segments) via the dialog below. The user is required to enter signals (containing at least 3 components) in the Force, Center of Pressure, and Free Moment combo boxes, the segment to which the force is applied, and the frames at which the force should be applied.
-The following dialog shows the properties of this command. The user is expected to enter signals (containing at least 3 components) in the Force, Center of Pressure, and Free Moment combo boxes. The Segment that the force is applied to and the frames at which the force should be applied.
 {{:AddCustomForceDlg.jpg}}
 The assignment can be edited by selecting the View/Edit Segment To Force Assignments option under the Model menu item.
-\\
-Apply external forces (other than force plates) to any segment location.
-Under the Model menu item is the option to "View/Edit Force assignments?. The user can apply any external force to a segment by providing the signal representing the force, the signal representing the Center of Pressure (which could be a landmark location on a segment), and a signal representing the free moment.
-If the following message box pops up: You must have an active motion capture file and link model to view force platform assignments! it means that you have not selected an Active Movement File. To do this you must switch to Signal and Event processing mode and select the movement file. If you are in Model Builder mode or Workspace mode, there may not be an active file.
-\\
-Transforming a signal from one coordinate system to another
 ==== Example 2: 3 DOF Force Transducer ====
@@ Line 98: / Line 89: @@
 Given an external force transducer that measures the 3 components of a force and streams the data as 3 analog channels; e.g the force transducer is a handle held in the hand.
-  * Create a 3 component vector from these 3 analog channels. In this example, the analog signals are scaled by a METRIC value.
+<code>
+Create a 3 component vector from these 3 analog channels. In this example, the analog signals are scaled by a METRIC value.
 ! Create a scaled force signal in the Transducer Coordinate System
@@ Line 106: / Line 98: @@
 ! /RESULT_TYPE=DERIVED
 ! /RESULT_FOLDER=PROCESSED
-**;**
+;
 ! Transform the FORCE from the transducer coordinate system to the lab coordinate system
 [[Visual3D:Documentation:Pipeline:Signal_Commands:Transform_Data_Coordinate_System|Transform_Data_Coordinate_System]]
@@ Line 117: / Line 110: @@
 /RESULT_FOLDER= PROCESSED
 /RESULT_SUFFIX= _LAB
-**;**
+;
 ! For convenience, we create a FREEMOMENT signal that contains only zero's. The following
 ! will create the FREEMOMENT signal such that is has the same data rate and number of frames
@@ Line 126: / Line 120: @@
 /RESULT_TYPE=DERIVED
 /RESULT_FOLDER=PROCESSED
-**;**
+;
+</code>
 The signal FORCE_LAB can now be applied to a segment