Differences

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

--- visual3d:documentation:kinematics_and_kinetics:external_forces:treadmills [2024/06/19 12:48] – sgranger
+++ visual3d:documentation:kinematics_and_kinetics:external_forces:treadmills [2024/11/29 17:14] (current) – Reorganized content and incorporated content from the legacy "Instrumented Treadmills" tutorial (which was more of a list of things to keep in mind). Next step is to create a new Instrumented Treadmills tutorial. wikisysop
@@ Line 1: / Line 1: @@
-{{{{{{\\
+===== Treadmills =====
-there is a lot of information on the wiki about implementing treadmills in visual3d, this page is designed to organize that information in one place.
-**for the most part, processing treadmill data in visual3d is the same as processing overground data**, but there are times when extra information must be taken into consideration.
+Properly modelling instrumented treadmills in Visual3D and analysing the measurements the record requires an in-depth understanding of the treadmills themselves and careful attention to several factors. This page is designed to organize that information in one place for ease of reference.
-====== kinematics ======
+The general goal when analysing data from instrumented treadmills is to give Visual3D enough information that you can then process these trials in the same way that you would process overground trials.
-treadmill.png
+==== Instrumented Treadmills ====
-if you are using a standard treadmill or an instrumented treadmill, you will need to account for the treadmill speed and direction when calculating certain measures, such as the temporal distance measures.
+In modelling instrumented treadmill data in Visual3D you will need to set appropriate baselines and thresholds, filter your [[visual3d:documentation:c3d_signal_types:analog_data_type|ANALOG]] signals, and use processed [[visual3d:documentation:c3d_signal_types:analog_data_type|ANALOG]] signals for calculating the GRF. You will also need to verify [[visual3d:documentation:kinematics_and_kinetics:external_forces:force_assignment|force assignments]] before continuing on.
-==== temporal distance measures ====
+If you are using an inclined instrumented treadmill then you should read the following section as well.
-visual3d's built in [[visual3d:documentation:pipeline:metric_commands:metric_compute_temporal_distance|temporal distance]] command is designed to handle treadmill data.
+=== Analog Signal Baseline Values ===
-when calculating temporal distance measures while the subject is walking on a treadmill, it is important to specify the orientation of the treadmill in lab space (direction), and the speed of the belts (speed).
+For instrumented treadmills, it is critical to set appropriate baselines for the analog signals that compensate for bias in the amplifiers. For fixed force platforms this is accomplished by specifying a range of frames for which the platform is unloaded (see [[Visual3D:Documentation:Pipeline:Force_Commands:FP_ZERO|Force Platform Zero Parameters]]). Note that this baseline is independent of the minimum force threshold and serves the purpose of removing bias from the analog signals when the force platforms are unloaded.
-for user's using a split belt treadmill with the belts running at different speeds, "use split belt speeds" must be selected and the different speed of each belt must be specified. if both belts are running at the same speed, do not check "use split belt speeds" and only specify one speed.
+This is most easily accomplished using the [[Visual3D:Documentation:Pipeline:Force_Commands:FP_Auto_Baseline|FP_Auto_Baseline]] command, which automatically determines the appropriate baseline values to remove from each analog signal. It accomplishes the following three tasks:
+  - Zeros the force signal without having to specify a [[Visual3D:Tutorials:Kinematics_and_Kinetics:Force_Platforms#Compute_Baselines|frame range]] (AUTO_ZERO);
+  - Defines the [[Visual3D:Documentation:Kinematics_and_Kinetics:External_Forces:Force_Platforms#Minimum_Force|minimum force platform value]] based on the noise in the signal (AUTO_FP_MINIMUM); and
+  - Looks before and after the signal is loaded to find when the signal crosses the reduced FP minimum to ensure as much of the signal is used as possible (USE_REDUCED_FP_MINIMUM_AROUND_FORCE).
-====== kinetics ======
+<code>
+FP_Auto_Baseline
+! /FP_NUMBER=
+! /AUTO_ZERO=TRUE
+! /AUTO_FP_MINIMUM=TRUE
+! /USE_REDUCED_FP_MINIMUM_AROUND_FORCE=TRUE
+! /REDUCED_FP_MINIMUM=5.0
+;
+</code>
-===== zeros =====
+The [[Visual3D:Documentation:Kinematics_and_Kinetics:External_Forces:Force_Platforms#Minimum_Force|minimum force platform value]] is determined by identifying the values of the plate during all the periods where the plate is unloaded. Each force component is used to determine the set of frames containing median values for each component, and a single representative minimum force frame is determined from these values.
-typically, the force platforms are "zeroed" during a specified frame range of each trial. for example, during typical over ground gait, the force platforms are unloaded at the start of the trial, so the average force signal during frames 1-100 would be averaged and subtracted from the trial. for force platform trials, typically the trial starts with the subject on the force platform, so it cannot be assumed that the platform is unloaded during the first 100 frames of the trial.
+=== Set Minimum Force Threshold ===
-the frame range is specified in your force platform parameters (which is specified in your motion capture software).
+The Visual3D Force Menu includes an option to set a threshold for force platform/structure data. This threshold value is used to remove noise from the force signals. Most force platform manufacturers recommend a minimum of **50 N** for treadmill data, which is higher than for overground gait trials.
-**more information about fp zeros and how to implement them, can be found [[visual3d:documentation:pipeline:force_commands:fp_zero|here]].**
+{{:MinimumForceMenu.jpg}}   {{:MinimumForceDlg.jpg}}
-===== locating force platform corners =====
+If the computed force is less than this minimum force threshold, then the [[visual3d:documentation:visual3d_signal_types:force_data_type|FORCE]] and [[visual3d:documentation:visual3d_signal_types:freemoment_data_type|FREEMOMENT]] are set to zero and the [[visual3d:documentation:visual3d_signal_types:cofp_data_type|COFP]] is set to [[Visual3D:Documentation:C3D_Signal_Types:DATA_NOT_FOUND|DATA_NOT_FOUND]].
-when calculating kinetics, it is important that the force platform be accurately located in the motion capture volume. with typical overground force platforms, the user is able to see the force platform corners, making it easier to define the location of the force platforms. with instrumented treadmills, the belts cover the surface of the platform, making it difficult to define the exact location/orientation of the force platforms.
+This value can also be set using the pipeline command **[[Visual3D:Documentation:Pipeline:Force_Commands:Set_Force_Platform_Threshold|Set_Force_Platform_Threshold]]**. In this case the [[visual3d:documentation:pipeline:general_information:recalc_pipeline|RECALC pipeline]] must be run to update any kinetic signals in the workspace.
-the [[caltester:caltesterplus:tutorials:platform|platform mode]] in [[caltester:overview|caltester]] can be very useful to identify the position/orientation of the force platforms. the force platforms should only be located in your lab volume once *****.
+<code>
+Set_Force_Platform_Threshold
+! /THRESHOLD=20
+! /SET_AS_DEFAULT=FALSE
+;
+</code>
-if the force platforms are going to move (for example, an incline/decline treadmill), it will be necessary to update the force platform corners each time the treadmill position has changed. two methods to update the force platform corners are described below in the "inclined treadmill" section.
+=== Filter the ANALOG signals ===
-===== inclined treadmill =====
+If desired, you can filter the ANALOG signals from your instrumented treadmill in the same way that any other signals can be filtered.
-==== background ====
+**1. Filter the ANALOG data.**
+  - Expand the [[visual3d:documentation:visual3d_signal_types:data_tree|data tree]] in the Signal and Event Processing tab.
+  - Right-click the ANALOG data type's [[visual3d:documentation:visual3d_signal_types:data_tree#original_and_processed_data|ORIGINAL folder]].
+  - Left-click the [[visual3d:documentation:pipeline:signal_commands:lowpass_filter|Lowpass]] option.
+  - Select Done to execute the command.
-amti_treadmill.jpg
+{{:Treadmill_Tutorial1.jpg}}
-inclined treadmill
+**2. Specify the desired parameters for the Lowpass Filter Command.** Example:
+  - Cutoff Frequency: 25
+  - Samples Reflected: 0
+  - Samples Extrapolated: 0
+  - Samples in Buffer: 100
+  - Bidirectional Passes: 3
-to calculate dynamics, visual3d must account for gravity. visual3d defines gravity along one of the principal axes of the lab, which means the origin of the motion capture volume should be set level with the ground. if the origin is set by placing an l-frame on the treadmill, the treadmill cannot be inclined when the origin is set (it must be level).
+{{:Treadmill_Tutorial2.jpg}}
-most labs define the position and orientation of the force platforms in the treadmill's level position in the motion capture volume. this makes sense because the treadmill is most often in used in the level position, and many labs set the origin of the lab on the treadmill (and the treadmill must be level if you are going to do this). this means the position and orientation of the force platform corners is incorrect when the treadmill is inclined.
+**3. Check that data was filtered:**
+  - Note that a PROCESSED folder exists under the ANALOG data type in the data tree.
+  - Left-click the PROCESSED folder to expand it and then left-click to select the signal ATFfx. A dialog will appear containing 3 tabs.
+  - In the **Data View tab**, note the column headings SUB1, SUB2, etc. These refer to the subframes of the analog signal that arise because the analog sampling rate is higher than the motion capture point rate.
+  - The Column SUB1 contains the frames of data that are synchronous with the Motion Capture frames.
-two ways to handle this are:
+{{:Treadmill_Tutorial3.jpg}}
-  - use targets to define the force platform corners when the treadmill is inclined
+**4. Select the History tab to display the signal's processing history.**
-  - use a jig to define the location of the force platform when the treadmill is inclined
-these methods are described below.
+{{:Treadmill_Tutorial4.jpg}}
-since targets cannot be placed directly on top of the force platforms (due to the treadmill belts), using a jig should result in more accurate force platform location.
+**5. Hit Recalc to update the workspace**
+  - No changes will be made to dependent signals until Recalc is hit.
-==== motion capture calibration (placing the wand) ====
+**NOTE:** These steps can also be done using the pipeline using the [[Visual3D:Documentation:Pipeline:Signal_Commands:Lowpass_Filter|Lowpass_Filter]] and [[Visual3D:Documentation:Pipeline:File_Commands:Recalc|Recalc]] commands.
-in visual3d, gravity is defined along a principal axis of the lab. when you set the origin in your motion capture software, the vertical axis is perpendicular to the plane the calibration tool (wand or l-frame) is on. this means if you defined the origin of the lab by placing the calibration tool on an inclined surface (like an inclined treadmill), gravity will be pointing in the wrong direction!
+=== Use Processed Analogs for Ground Reaction Force Calculations ===
-treadmillsgravity.png
+Specify that [[[[Visual3D:Documentation:Visual3D_Signal_Types:Used_Process|PROCESSED ANALOG signals should be used]] for computing the Ground Reaction Force. You want use Processed TARGETs and ANALOGs (check these options) but leave Use Processed Forces unchecked.
-==== using targets to define the corners ====
+{{:AMTI_Tutorial5.jpg}}
-targets may be placed on the treadmill to define the force platform corners and the force platform parameters may be updated based on the location of the targets in 3d space.
+=== Force Assignment ===
-an example of this is described [[visual3d:documentation:pipeline:force_commands:fp_corners#example:_using_mocap_markers_to_define_the_corners|here]].
+The force assignments to segments should be computed automatically by Visual3D. It is vitally important that you check these Force Assignments for validity, e.g. that complete stance phase is assigned, that only one foot in contact with a platform at a time, etc., because Visual3D's [[Visual3D:Documentation:Pipeline:Event_Commands:Automatic_Gait_Events|event detection]] is based on Force Platform Assignments, not on the FORCE signals.
-==== using caltester plus ====
+In the figure below the presence of the blue arrow displays the combined force vector from the two platforms.
-a jig (or cluster of 3 targets) can be used to define the location of the force platform. to create a jig, you need a set of three targets that will have the same position/orientation relative to each other, and relative to the force platform. for example, consistently placing three targets in the same location of the treadmill would act as a jig.
+{{:AMTI_Treadmill2.jpg}}
+{{:AMTI_Treadmill3.jpg}}
-when using a jig (a cluster of targets), the user must first define the location of the force platforms in relation to the targets. this step should be done once *****. instructions to complete this step can be found in the caltester [[caltester:caltesterplus:tutorials:jig_location|locate the jig]] tutorial.
+==== Inclined Treadmills ====
-once the location of the force platforms has been found, you can now use the targets to define the force platform corners in 3d space. this would be done during each collection.
+{{:AMTI_Treadmill.jpg}}
-to do this you would calibrate the lab and set the lab origin with the treadmill level. then place the jig on the treadmill. you could then do one of the following: (1) you can then incline the treadmill and collect a trial with just the jig, and update the force platform parameters in your motion collection software, (2) you could also collect an inclined trial with the subject walking on the treadmill where the jig (or a trial with just the jig) and update the force platform parameters in visual3d when post processing. instructions to complete this step can be found in the caltester [[caltester:caltesterplus:tutorials:jig|use jig to define fp corners]] tutorial.
+Inclined treadmills present additional modelling considerations since Visual3D must account for gravity when calculating dynamics. Visual3D defines gravity along one of the principal axes of the lab, which means the origin of the motion capture volume should be set level with the ground. If the origin is set by placing an L-frame on the treadmill, the treadmill cannot be inclined when the origin is set: it must be level.
-\\
+Most labs define the position and orientation of the force platforms in the treadmill's level position in the motion capture volume. This makes sense because the treadmill is most often in used in the level position, and many labs set the origin of the lab on the treadmill (and the treadmill must be level if you are going to do this). This means the position and orientation of the force platform corners is incorrect when the treadmill is inclined.
+There are two ways to handle this:
+  - Use a jig to define the location of the force platform when the treadmill is inclined; or
+  - Use targets to define the force platform corners when the treadmill is inclined
-----
+Since the treadmill's belts will almost certainly prevent you from placing targets directly on top of the force platforms, using a jig is the preferred method and should result in more accurate force platform location.
-*** note:** it is a good practice to use caltester every few months to locate your force platforms. by using caltester periodically, you are able to check that nothing in your lab has changed (the wand is not bent, the lab is not being set differently, etc.)
+=== Using a Jig ===
+In Visual3D, gravity is defined along a principal axis of the lab. When you set the origin in your motion capture software, the vertical axis is perpendicular to the plane the calibration tool (wand or L-frame) is on. This means if you defined the origin of the lab by placing the calibration tool on an inclined surface (like an inclined treadmill), gravity will be pointing in the wrong direction!
+{{:TreadmillsGravity.png}}
+A jig (or cluster of 3 targets) can be used to define the location of the force platform. To create a jig, you need a set of three targets that will have the same position/orientation relative to each other, and relative to the force platform. For example, consistently placing three targets in the same location of the treadmill would act as a jig. When using a jig (a cluster of targets), the user must first define the location of the force platforms in relation to the targets. This step should be done once. Instructions to complete this step can be found in the CalTester [[CalTester:CalTesterPlus:Tutorials:Jig_Location|Locate the Jig]] Tutorial.
+Once the location of the force platforms has been found, you can now use the targets to define the force platform corners in 3D space. This would be done during each collection.
+To do this you would calibrate the lab and set the lab origin with the treadmill level. Then place the jig on the treadmill. You could then do one of the following:
+ - You can then incline the treadmill and collect a trial with just the jig, and update the force platform parameters in your motion collection software
+You could also collect an inclined trial with the subject walking on the treadmill where the jig (or a trial with just the jig) and update the force platform parameters in Visual3D when post processing. Instructions to complete this step can be found in the CalTester [[CalTester:CalTesterPlus:Tutorials:Jig|Use Jig to define FP corners]] Tutorial.
+*** NOTE:** It is a good practice to use [[caltester:caltester_mode_overview|CalTester]] every few months to locate your force platforms. By using CalTester periodically, you are able to check that nothing in your lab has changed (the wand is not bent, the lab is not being set differently, etc.)
+=== Using Targets to Define the Corners ===
+Targets may be placed on the treadmill to define the force platform corners and the force platform parameters may be updated based on the location of the targets in 3D space.
+An example of this is described [[Visual3D:Documentation:Pipeline:Force_Commands:FP_CORNERS#Example:_Using_mocap_markers_to_define_the_corners|here]].
+==== Kinematics ====
+{{:Treadmill.png}}
+If you are using a standard treadmill or an instrumented treadmill, you will need to account for the treadmill speed and direction when calculating certain kinematic measures such as the temporal distance measures.
+Visual3D's built in [[Visual3D:Documentation:Pipeline:Metric_Commands:Metric_Compute_Temporal_Distance|Temporal Distance]] command is designed to handle treadmill data. Accurately calculating temporal distance measures while the subject is walking on a treadmill requires the user to specify the orientation of the treadmill in lab space (direction), and the speed of the belts (speed). For user's using a split belt treadmill with the belts running at different speeds, "Use Split Belt Speeds" must be selected and the different speed of each belt must be specified. If both belts are running at the same speed, do not check "Use Split Belt Speeds" and only specify one speed.
+==== Kinetics ====
+As with all kinetic measures, it is important that the force platform be accurately located in the motion capture volume. With typical overground force platforms, the user is able to see the force platform corners, making it easier to define the location of the force platforms. With instrumented treadmills, the belts cover the surface of the platform, making it difficult to define the exact location/orientation of the force platforms.
+The [[CalTester:CalTesterPlus:Tutorials:Platform|Platform Mode]] in [[CalTester:CalTester_Mode_Overview|CalTester]] can be very useful to identify the position/orientation of the force platforms. The force platforms should only be located in your lab volume once *****.
+If the force platforms are going to move (for example, an incline/decline treadmill), it will be necessary to update the force platform corners each time the treadmill position has changed. Two methods to update the force platform corners are described below in the "Inclined Treadmill" section.
+=== Zeros ===
+Typically, the force platforms are "zeroed" during a specified frame range of each trial. For example, during typical over ground gait, the force platforms are unloaded at the start of the trial, so the average force signal during frames 1-100 would be averaged and subtracted from the trial. For force platform trials, typically the trial starts with the subject on the force platform, so it cannot be assumed that the platform is unloaded during the first 100 frames of the trial. The frame range is specified in your force platform parameters (which is specified in your motion capture software).
+**More information about FP Zeros and how to implement them, can be found [[Visual3D:Documentation:Pipeline:Force_Commands:FP_ZERO|here]].**
+==== Tutorials ====
+The tutorial [[visual3d:tutorials:kinematics_and_kinetics:instrumented_treadmills|Modelling Instrumented Treadmills]] walks through these steps for a sample set of files.
+The tutorial [[sift:tutorials:treadmill_walking_in_healthy_individuals|Treadmill Walking in Healthy Individuals]] demonstrates how Visual3D and Sift can be used together to analyse large-scale treadmill studies.
-}}}}}}