Differences

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

--- visual3d:documentation:pipeline:metric_commands:metric_time_of_threshold_from_event [2025/10/01 14:54] – [Examples] wikisysop
+++ visual3d:documentation:pipeline:metric_commands:metric_time_of_threshold_from_event [2025/10/01 15:27] (current) – [Example:] wikisysop
@@ Line 116: / Line 116: @@
-====Example: ====
+====Example: Finding Stance Time Using Gait Events and Force Data====
+This example uses **Automatic Gait Events** and **Metric Time of Threshold From Event** to find the duration of contact between the left foot and the ground (stance time) during a gait trial.
+First, Automatic Gait Events is used to define gait events like heel strikes and toe offs.
+<code>
+Automatic_Gait_Events
+! /FRAME_WINDOW=8
+! /USE_TPR=TRUE
+! /TPR_EVENT_INSTANCE=1
+;
+</code>
+Next, the time between the first left heel strike and vertical ground reaction force returning to 0 under the left foot is computed using **Metric Time of Threshold from Event**. This is an alternative method of finding stance time to just using gait events like seen in other tutorials.
+<code>
+Metric_Time_Of_Threshold_From_Event
+/RESULT_METRIC_TIME=Left_Stance_Time
+! /RESULT_METRIC_VALUE=
+! /RESULT_FOLDER=PROCESSED
+/THRESHOLD=0.1
+! /RESULT_COMPONENTS=ALL
+/SIGNAL_TYPES=FORCE
+/SIGNAL_FOLDER=ORIGINAL
+/SIGNAL_NAMES=FP2
+/SIGNAL_COMPONENTS=Z
+! /FRAME_OFFSET=0
+! /TIME_OFFSET=
+/EVENT_SEQUENCE=LHS
+! /EXCLUDE_EVENTS=
+! /EVENT_SEQUENCE_INSTANCE=0
+! /EVENT_SUBSEQUENCE=
+! /SUBSEQUENCE_EXCLUDE_EVENTS=
+! /EVENT_SUBSEQUENCE_INSTANCE=0
+! /EVENT_INSTANCE=0
+/ON_ASCENT=FALSE
+/ON_DESCENT=TRUE
+! /FRAME_WINDOW=8
+/ENSURE_FRAMES_BEFORE=FALSE
+/ENSURE_FRAMES_AFTER=TRUE
+;
+</code>
+Here the threshold is defined as 0.1N of force in the Z direction. By defining the event sequence as LHS and ON_DESCENT as true we ensure that we are capturing the time between when the left foot first makes contact with the ground and the next instance of no contact force between the left foot and the force plate.
+The result, in the **Metric:Processed** folder, should look like so:
+{{:visual3d:documentation:pipeline:metric_commands:stance_time_grf.png?400|}}