HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » metric_commands » Temporal Distance Calculations for Gait
visual3d:documentation:pipeline:metric_commands:temporal_distance_calculations_for_gait

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:pipeline:metric_commands:temporal_distance_calculations_for_gait [2025/05/20 16:55] – Started the clean-up. wikisysopvisual3d:documentation:pipeline:metric_commands:temporal_distance_calculations_for_gait [2025/05/20 18:23] (current) – Linked to Metric_Compute_Temporal_Distance commmand page. wikisysop
Line 1: Line 1:
 ====== Temporal Distance Calculations for Gait ====== ====== Temporal Distance Calculations for Gait ======
  
-Visual3D calculates a set of for temporal and distance information based on a set of 4 gait events (Right and Left Heel Strike and Toe Off). These spatiotemporal metrics are part of the common cohort of [[https://www.sciencedirect.com/science/article/abs/pii/0167945796000061|Gait Parameters]].+Visual3D calculates a set of for temporal and distance information based on a set of 4 gait events (Right and Left Heel Strike and Toe Off). These spatiotemporal metrics are part of the common cohort of [[https://www.sciencedirect.com/science/article/abs/pii/0167945796000061|Gait Parameters]]. The [[visual3d:documentation:pipeline:metric_commands:metric_compute_temporal_distance|Metric_Compute_Temporal_Distance]] pipeline command allows users to automate Visual3D's calculation of these metrics.
  
 **Notes**: **Notes**:
Line 7: Line 7:
   * If a Right and Left foot segment do not exist, stride length and stride width cannot be computed.   * If a Right and Left foot segment do not exist, stride length and stride width cannot be computed.
   * The treadmill unit vector refers to the Anterior Direction of walking.   * The treadmill unit vector refers to the Anterior Direction of walking.
- 
-===== Metric_Compute_Temporal_Distance ===== 
- 
-<code> 
-Metric_Compute_Temporal_Distance 
-! /GLOBAL_RESULT_METRIC_FOLDER=TEMPORAL_DISTANCE 
-! /CALCULATE_PER_FILE=FALSE 
-! /CREATE_ALL_INSTANCES=FALSE 
-! /RIGHT_FOOT_LOCATION=KINETIC_KINEMATIC::RFT::ProxEndPos 
-! /LEFT_FOOT_LOCATION=KINETIC_KINEMATIC::LFT::ProxEndPos 
-! /HEIGHT=METRIC::PROCESSED::HEIGHT 
-/RHS_EVENT=RHS 
-/LHS_EVENT=LHS 
-/RTO_EVENT=RTO 
-/LTO_EVENT=LTO 
-! /STRICT_EVENT_SEQUENCE_VALIDATION=FALSE 
-! /INCLUDE_EVENTS= 
-! /EXCLUDE_EVENTS= 
-! /EVENT_INSTANCE=0 
-! /COMPUTE_SPEED=TRUE 
-! /COMPUTE_STATURES_PER_SECOND=TRUE 
-! /COMPUTE_STRIDE_WIDTH=TRUE 
-! /COMPUTE_STRIDE_LENGTH=TRUE 
-! /COMPUTE_CYCLE_TIME=TRUE 
-! /COMPUTE_STEP_LENGTH=TRUE 
-! /COMPUTE_STEP_TIME=TRUE 
-! /COMPUTE_STANCE_TIME=TRUE 
-! /COMPUTE_SWING_TIME=TRUE 
-! /COMPUTE_STEPS_PER_MINUTE=TRUE 
-! /COMPUTE_STRIDES_PER_MINUTE=TRUE 
-! /COMPUTE_DOUBLE_LIMB_SUPPORT_TIME=TRUE 
-! /COMPUTE_RIGHT_INITIAL_DOUBLE_LIMB_SUPPORT_TIME=TRUE 
-! /COMPUTE_RIGHT_TERMINAL_DOUBLE_LIMB_SUPPORT_TIME=TRUE 
-! /TREADMILL_SPEED= 
-! /LEFT_TREADMILL_SPEED= 
-! /TREADMILL_DIRECTION= 
-</code> 
  
 ===== Temporal Distance Dialog ===== ===== Temporal Distance Dialog =====
  
 +^ Dialog ^ Description ^
 |{{:EditTemporalDistancev5_FILES2.jpg}}  |- The default command will create average temporal distance values for the ACTIVE files and results can be found in the GLOBAL workspace\\ - **Calculate For Each File:** Calculate average values across entire trial\\ - **Create All Instances:** value for each sequence (multiple values per trial)\\ \\ **NOTE:** To use the Calculate For Each File option, Calculate for Each Trial must be selected as well.  | |{{:EditTemporalDistancev5_FILES2.jpg}}  |- The default command will create average temporal distance values for the ACTIVE files and results can be found in the GLOBAL workspace\\ - **Calculate For Each File:** Calculate average values across entire trial\\ - **Create All Instances:** value for each sequence (multiple values per trial)\\ \\ **NOTE:** To use the Calculate For Each File option, Calculate for Each Trial must be selected as well.  |
- 
-\\ 
- 
- 
 |{{:EditTemporalDistancev5_Signal.jpg}}  |- If the user would like to define temporal distance metrics using a signal other than the default signal (such as the proximal end of the foot), the user can select a different signal (such as the heel target).\\ \\ - The height is used to calculate [[#Statures.2FSecond|statures/second]]  | |{{:EditTemporalDistancev5_Signal.jpg}}  |- If the user would like to define temporal distance metrics using a signal other than the default signal (such as the proximal end of the foot), the user can select a different signal (such as the heel target).\\ \\ - The height is used to calculate [[#Statures.2FSecond|statures/second]]  |
- 
-\\ 
- 
- 
 |{{:EditTemporalDistancev5_PROPERTIES.jpg}}  |- The event labels may be changed to any events desired.\\ \\ - Selecting **Strict Event Label Sequence** will create temporal distance measures for events that occur within a gait cycle. For example Swing Time which occurs between RTO and RHS will only be calculated if the event sequence is RHS+RTO+RHS.\\ \\ - Explanations of the calculations of the temporal distance items can be found [[visual3d:documentation:pipeline:metric_commands:metric_compute_temporal_distance|here]].  | |{{:EditTemporalDistancev5_PROPERTIES.jpg}}  |- The event labels may be changed to any events desired.\\ \\ - Selecting **Strict Event Label Sequence** will create temporal distance measures for events that occur within a gait cycle. For example Swing Time which occurs between RTO and RHS will only be calculated if the event sequence is RHS+RTO+RHS.\\ \\ - Explanations of the calculations of the temporal distance items can be found [[visual3d:documentation:pipeline:metric_commands:metric_compute_temporal_distance|here]].  |
- 
-\\ 
- 
- 
 |{{:EditTemporalDistancev5_RANGE.jpg}}  |- **Event Instance:** 0 indicates all instances, 1 indicates the first event sequence\\ \\ - **Exclude Sequence:** Creating an event BAD would exclude the trial during which the event occurred  | |{{:EditTemporalDistancev5_RANGE.jpg}}  |- **Event Instance:** 0 indicates all instances, 1 indicates the first event sequence\\ \\ - **Exclude Sequence:** Creating an event BAD would exclude the trial during which the event occurred  |
- 
-\\ 
- 
- 
 |{{:EditTemporalDistancev5_TREADMILL.jpg}}  |- The treadmill unit vector refers to the direction the subject would have been progressing in the lab if there were no treadmill\\ - Speed (positive), (left/right/average) stride and step length, and statures/second are dependent on belt speed  | |{{:EditTemporalDistancev5_TREADMILL.jpg}}  |- The treadmill unit vector refers to the direction the subject would have been progressing in the lab if there were no treadmill\\ - Speed (positive), (left/right/average) stride and step length, and statures/second are dependent on belt speed  |
- 
-\\ 
- 
- 
 |{{:EditTemporalDistancev5_FOLDER.jpg}}  |- The result folder may have any name and will be a subfolder of the METRIC folder.  | |{{:EditTemporalDistancev5_FOLDER.jpg}}  |- The result folder may have any name and will be a subfolder of the METRIC folder.  |
  
-\\+===== Reporting Temporal Distance Metrics =====
  
 +Two chart styles exist for reporting temporal distance metrics: horizontal and vertical. The latter allows the metrics to be compared against control data.
  
-===== Report TD Horizontal Chart =====+==== Report TD Horizontal Chart ====
  
-{{:TemporalDistance.gif}}\\+Temporal distance metrics can be reported graphically in the [[visual3d:documentation:reports:reports_overview|Reports tab]] using the horizontal chart format below.
  
 +{{:TemporalDistance.gif}}
  
 ==== Report TD Vertical Chart ==== ==== Report TD Vertical Chart ====
  
-This chart has the option of linking to a control data set. **Control Data Folder**+Temporal distance metrics can also be reported vertically, which allows the metrics to be linked to and compared against a control data set.
  
-The name of the metric is the same as the Temporal Distance metric signal names created automatically for the report (only the suffix MEAN is removed) +{{:TDVerticalBars.jpg}}
- +
-There are many ways to create these GLOBAL METRIC signals, but many labs have numbers hard coded.+
  
-The following example will create a metric signal with 3 components (mean, min, max)+The name of the metric is the same as the Temporal Distance metric signal names created automatically for the report (only the suffix MEAN is removed). There are many ways to create these GLOBAL METRIC signals, but many labs have numbers hard coded. The following example creates a metric signal with 3 components (mean, min, max):
  
 <code> <code>
Line 105: Line 49:
 </code> </code>
  
-{{:TDVerticalBarsDlg.jpg}} +^ Dialog ^ Description ^ 
- +| {{:TDVerticalBarsDlg.jpg}} | The Global Control Data Folder is selected near the top of the dialog.\\ The vertical bars style is selected at the bottom right of the dialog. |
-**Note** the selection of the Global Control Data Folder near the top of the dialog\\ +
-**Note** the selection of the vertical bars at the bottom right of the dialog. +
- +
-{{:TDVerticalBars.jpg}}+
  
 ===== Metrics Computed ===== ===== Metrics Computed =====
Line 120: Line 60:
 The stance time for a given side of the body is the portion of the gait cycle when that side's leg is in contact with the ground. It is calculated as the time from that foot's heel strike event to its toe off event. The stance time for a given side of the body is the portion of the gait cycle when that side's leg is in contact with the ground. It is calculated as the time from that foot's heel strike event to its toe off event.
  
 +<code>
 Right Stance Time = RHS-RTO Right Stance Time = RHS-RTO
- 
 Left Stance Time= LHS-LTO Left Stance Time= LHS-LTO
 +</code>
  
 ==== Swing Time ==== ==== Swing Time ====
Line 128: Line 69:
 The swing time for a given side of the body is the portion of the gait cycle when that side's leg is not contacting the ground. It is calculated as the time from that foot's toe off event to its heel strike event. The swing time for a given side of the body is the portion of the gait cycle when that side's leg is not contacting the ground. It is calculated as the time from that foot's toe off event to its heel strike event.
  
 +<code>
 Right Swing Time= RTO-RHS Right Swing Time= RTO-RHS
- 
 Left Swing Time= LTO-LHS Left Swing Time= LTO-LHS
 +</code>
  
 ==== Step Time ==== ==== Step Time ====
Line 136: Line 78:
 The step time for a given side of the body is the portion of the gait cycle between the opposite side's heel strike event and the given side's heel strike event. The step time for a given side of the body is the portion of the gait cycle between the opposite side's heel strike event and the given side's heel strike event.
  
 +<code>
 Right Step Time= LHS-RHS Right Step Time= LHS-RHS
- 
 Left Step Time= RHS-LHS Left Step Time= RHS-LHS
 +</code>
  
 ==== Double Limb Support Time ==== ==== Double Limb Support Time ====
Line 144: Line 87:
 The double limb support time for a gait cycle is the total time where both feet are in contact with the ground. This is the sum of an initial double limb support phase and a terminal double limb support phase. The double limb support time for a gait cycle is the total time where both feet are in contact with the ground. This is the sum of an initial double limb support phase and a terminal double limb support phase.
  
 +<code>
 +Right Cycle Double Limb Support = Right Initial Double Limb + Right Terminal Double Limb
 Right Initial Double Limb= RHS to LTO Right Initial Double Limb= RHS to LTO
- 
 Right Terminal Double Limb= LHS to RTO Right Terminal Double Limb= LHS to RTO
 +</code>
  
 The global mean double limb support time (stored in the global workspace as METRIC::TEMPORAL_DISTANCE::Double_Limb_Support_Time_Ave) is calculated via a two-step process. First, the mean Right_Initial_Double_Limb_Support_Time and the mean Right_Terminal_Double_Limb_Support_Time are calculated. Second, these two times are then summed to represent the average time spent during the double limb support phases throughout an entire gait cycle. This calculation captures that during a gait cycle there are two phases during which the individual is supported by both limbs: from RHS to LTO and from LHS to RTO. The global mean double limb support time (stored in the global workspace as METRIC::TEMPORAL_DISTANCE::Double_Limb_Support_Time_Ave) is calculated via a two-step process. First, the mean Right_Initial_Double_Limb_Support_Time and the mean Right_Terminal_Double_Limb_Support_Time are calculated. Second, these two times are then summed to represent the average time spent during the double limb support phases throughout an entire gait cycle. This calculation captures that during a gait cycle there are two phases during which the individual is supported by both limbs: from RHS to LTO and from LHS to RTO.
  
-**Note:**+**Note**: the initial and terminal double limb support phases are inverted between the left and right sides of the body.
  
 +<code>
 Left Initial Double Limb Support (stance) = Right Terminal Double Limb Support (stance) Left Initial Double Limb Support (stance) = Right Terminal Double Limb Support (stance)
- 
 Left Terminal Double Limb Support (stance) = Right Initial Double Limb Support (stance) Left Terminal Double Limb Support (stance) = Right Initial Double Limb Support (stance)
 +</code>
  
 ==== Cycle Time ==== ==== Cycle Time ====
Line 163: Line 109:
  
 Flight time is the average time from LTO to RHS (ensuring no LHS or RTO events occur between LTO and RHS) and RTO to LHS (ensuring no RHS or LTO events occur between RTO and LHS). Flight time is the average time from LTO to RHS (ensuring no LHS or RTO events occur between LTO and RHS) and RTO to LHS (ensuring no RHS or LTO events occur between RTO and LHS).
- +  * Left flight time is calculated from LTO to RHS. 
-Left flight time is calculated from LTO to RHS. +  * Right flight time is calculated from RTO to LHS.
- +
-Right flight time is calculated from RTO to LHS.+
  
 ==== Stride Length ==== ==== Stride Length ====
Line 174: Line 118:
 === Right Stride Length === === Right Stride Length ===
  
-Right Stride length is defined as the length of the Right Stride vector from the Proximal End of the Right Foot Segment at successive RHS events +Right Stride length is defined as the length of the Right Stride vector from the Proximal End of the Right Foot Segment at successive RHS events. Right Stride Length Count is the number of Right Strides.
- +
-Right Stride Length Count is the number of Right Strides.+
  
 === Left Stride Length === === Left Stride Length ===
  
-Left Stride length is defined as the length of the Left Stride vector from the Proximal End of the Left Foot Segment at successive LHS events. +Left Stride length is defined as the length of the Left Stride vector from the Proximal End of the Left Foot Segment at successive LHS events. Left Stride Length Count is the number of Right Strides.
- +
-Left Stride Length Count is the number of Right Strides.+
  
 === Stride Length Count === === Stride Length Count ===
  
-Stride Length Count is the sum of Right Stride length Count and Left Stride Length Count.+Stride Length Count is the sum of Right Stride Length Count and Left Stride Length Count.
  
 === Treadmill === === Treadmill ===
Line 196: Line 136:
 Stride width is the medio-lateral distance between proximal end position of the foot at ipsilateral heel strike to the proximal end position of the foot at the next contralateral heel strike. Calculated by taking a stride vector, and the step in between, and computing the cross product (distance between the stride vector and the opposing step (heel) position Stride width is the medio-lateral distance between proximal end position of the foot at ipsilateral heel strike to the proximal end position of the foot at the next contralateral heel strike. Calculated by taking a stride vector, and the step in between, and computing the cross product (distance between the stride vector and the opposing step (heel) position
  
-Left Stride Width is the perpendicular distance from the proximal end of the Left foot segment to the Right Stride vector. +Left Stride Width is the perpendicular distance from the proximal end of the Left foot segment to the Right Stride vector while Right Stride Width is the perpendicular distance from the proximal end of the Right foot segment to the Left Stride vector. Visual3D doesn't actually report (or store) a left and right stride width, but rather an average stride width.
- +
-Right Stride Width is the perpendicular distance from the proximal end of the Right foot segment to the Left Stride vector. +
- +
-We don't actually report (or store) a left and right stride width, but rather an average stride width.+
  
 ==== Step Length ==== ==== Step Length ====
  
-Step length is the distance between proximal end position of the contralateral foot at the previous contralateral heel strike to the proximal end position of the ipsilateral foot at the ipsilateral heel strike. This is calculated as the distance in the walking path direction. +Step length is the distance between proximal end position of the contralateral foot at the previous contralateral heel strike to the proximal end position of the ipsilateral foot at the ipsilateral heel strike. This is calculated as the distance in the walking path direction. If the person is walking on a treadmill, the distance travelled by the belt under the stance foot is added to the measured distance.
- +
-If the person is walking on a treadmill, the distance traveled by the belt under the stance foot is added to the measured distance.+
  
 ==== Speed ==== ==== Speed ====
Line 220: Line 154:
 Cadence is the rate at which a person walks, expressed in steps per minute. Cadence is the rate at which a person walks, expressed in steps per minute.
  
-In other words: +<code>
 Left Steps Per Minute = 60 / [[#Step_Time|Left Step Time]] Left Steps Per Minute = 60 / [[#Step_Time|Left Step Time]]
- 
 Right Steps Per Minute = 60 / [[#Step_Time|Right Step Time]] Right Steps Per Minute = 60 / [[#Step_Time|Right Step Time]]
 +</code>
  
 ===== Changing the text in the temporal distance chart ===== ===== Changing the text in the temporal distance chart =====
Line 230: Line 163:
 In the folder in which you have placed Visual3D.exe, you should find a folder labeled [[Visual3D:Documentation:Modeling:Segments:Config_Folder|config]]. Inside this folder you will find a file labeled **custom_text.ini** In the folder in which you have placed Visual3D.exe, you should find a folder labeled [[Visual3D:Documentation:Modeling:Segments:Config_Folder|config]]. Inside this folder you will find a file labeled **custom_text.ini**
  
-The contents of this ini file containing a mapping from the text used internally in Visual3D to the text that appears in the report graph.+The contents of this ini file containing a mapping from the text used internally in Visual3D to the text that appears in the report graph. The text appearing to the right of the "=" sign appears in the report and can be customized. The default config file looks like this:
  
-The text appearing to the right of the "=" sign appears in the report. 
- 
-The default config file looks like this. 
- 
-\\ 
 **Temporal Distance**\\ **Temporal Distance**\\
 **Step Length Prompt=**Left Step Length / Right Step Length\\ **Step Length Prompt=**Left Step Length / Right Step Length\\
Line 270: Line 198:
 **Right Terminal Double Limb Support Time=**Right Terminal Double Limb Support Time\\ **Right Terminal Double Limb Support Time=**Right Terminal Double Limb Support Time\\
 **Flight Time=**Flight Time\\ **Flight Time=**Flight Time\\
- 
  
 ===== Subject computation using subject name/prefix parameters ===== ===== Subject computation using subject name/prefix parameters =====
  
-Visual3D is in the process of supporting multiple subjects within the same workspace, and across CMO/Z library workspaces. Older versions of Visual3D will not support the subject prefix extensions of this command.\\ +Versions of Visual3D more recent than v2022.08.1 support [[visual3d:documentation:definitions:multisubject|multiple subjects]] within the same workspace, and across [[visual3d:documentation:definitions:file_formats:cmz_format|CMO/Z]] library workspaces. Visual3D with multisubject support extends these metric calculations to be computed for each subject that is identified in the .C3D parameters SUBJECT section. In this way, the a single CMO/Z [[visual3d:documentation:definitions:global_workspace|GLOBAL workspace]] will contain the computed metrics for each subject within the CMO/Z file, prefixed with the subject's prefix identifier contained in the .C3D parameters. The GLOBAL workspace of the CMO/Z will also contain an unprefixed set of metrics for the average across the subjects contained inside the CMO/Z file. When working across CMO/Z files in the CMO/Z library, multisubject support for this command will treat each subject mean in each CMO/Z file as separate subject averages to be included for calculating the temporal and distance metric averages across all the subjects in the CMO/Z library. 
-\\ + 
-When using a version of Visual3D prior to implementing multisubject support, Visual3D treats each CMO/Z file as a single subject. In this way, the temporal and distance metrics are computed in the CMO/Z GLOBAL for the subject processed within that CMO. In the same manner, when computing the temporal and distance metrics across a library of subjects, each CMO/Z is treated as a single subject and then the subject averages are computed across CMO/Z files and placed into the workspace GLOBAL for the overall mean values across subjects.\\ +Older versions of Visual3D will not support the subject prefix extensions of this command and will treat each CMO/Z file as a single subject. In this way, the temporal and distance metrics are computed in the CMO/Z GLOBAL for the subject processed within that CMO. In the same manner, when computing the temporal and distance metrics across a library of subjects, each CMO/Z is treated as a single subject and then the subject averages are computed across CMO/Z files and placed into the workspace GLOBAL for the overall mean values across subjects.
-\\ +
-Visual3D with multisubject support extends these metric calculations to be computed for each subject that is identified in the .C3D parameters SUBJECT section. In this way, the a single CMO/Z GLOBAL will contain the computed metrics for each subject within the CMO/Z file, prefixed with the subject's prefix identifier contained in the .C3D parameters. The GLOBAL of the CMO/Z will also contain an unprefixed set of metrics for the average across the subjects contained inside the CMO/Z file.\\ +
-\\ +
-When working across CMO/Z files in the CMO/Z library, multisubject support for this command will treat each subject mean in each CMO/Z file as separate subject averages to be included for calculating the temporal and distance metric averages across all the subjects in the CMO/Z library.+
  
 ===== Mimicking the Command ===== ===== Mimicking the Command =====
  
-[[Visual3D:Documentation:Pipeline:Signal_Commands:Mimicking_Temporal_Distance_Command|Mimicking the Temporal Distance Calculations with Metrics]] +These calculations can be mimicked by implementing them manually using [[Visual3D:Documentation:Pipeline:Signal_Commands:Mimicking_Temporal_Distance_Command|pipeline commands]] to calculate the relevant metrics.
- +
- +
  
visual3d/documentation/pipeline/metric_commands/temporal_distance_calculations_for_gait.1747760138.txt.gz · Last modified: 2025/05/20 16:55 by wikisysop