Differences

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

--- visual3d:documentation:pipeline:event_commands:event_threshold [2025/04/28 17:12] – wikisysop
+++ visual3d:documentation:pipeline:event_commands:event_threshold [2025/08/21 18:14] (current) – wikisysop
@@ Line 2: / Line 2: @@
 ===== Overview =====
-The **Event_Threshold** command is used to detect threshold crossings (when signal crosses a specified value) in biomechanical signals and label events accordingly. This command provides extensive control over event placement by allowing users to define frame or time offsets, include or exclude sequences, and refine detections using component selection and event constraints.
+The **Event_Threshold** command is used to detect threshold crossings (when signal crosses a specified value) in a signals and label events accordingly. This command provides extensive control over event placement by allowing users to define frame or time offsets, include or exclude sequences, and refine detections using component selection and event constraints.
 This command is particularly useful for defining critical events based on signal thresholds, such as peak force occurrences, velocity changes, or acceleration-based triggers.
@@ Line 47: / Line 47: @@
 |**!/FRAME_OFFSET=0**|Shifts the event forward or backward by a specified number of frames.|
 |**!/TIME_OFFSET=**|Shifts the event forward or backward by a specified time in seconds.|
-|**!/EVENT_SEQUENCE=**|Sequence of events within which the command is performed (i.e. RHS + RHS).|
+|**[[visual3d:documentation:c3d_signal_types:event_label_data_type|!/EVENT_SEQUENCE=]]**|Sequence of events within which the command is performed (i.e. RHS + RHS).|
-|**!/EXCLUDE_EVENTS=**|Events to be excluded from sequence.|
+|**[[visual3d:documentation:c3d_signal_types:event_label_data_type|!/EXCLUDE_EVENTS=]]**|Events to be excluded from sequence.|
 |**!/EVENT_SEQUENCE_INSTANCE=0**|Which instance of an event sequence to use.|
 |**!/EVENT_SUBSEQUENCE=**|Subsequence of events to analyze (i.e. LTO + LHS).|
 |**!/SUBSEQUENCE_EXCLUDE_EVENTS=**|Events to exclude from the subsequence.|
 |**!/EVENT_SUBSEQUENCE_INSTANCE=0**|Instance of the event subsequence to analyze.|
-|**!/EVENT_INSTANCE=**|Determines how many event occurrences to consider (0 for all, positive for sequential selection, negative for reverse selection).|
+|**[[visual3d:documentation:c3d_signal_types:event_label_data_type|!/EVENT_INSTANCE=]]**|Determines how many event occurrences to consider (0 for all, positive for sequential selection, negative for reverse selection).|
 |**!/THRESHOLD=**|Threshold value to trigger event detection.|
 |**!/ON_ASCENT=**|Determine if the event is detected when the signal crosses the threshold in an upward direction.|
@@ Line 65: / Line 65: @@
 {{:visual3d:documentation:pipeline:event_commands:event_thr_dialog.png?400|}}
+  * **New Event Label Name**: Name to assign event that reaches threshold value.
+  * **Signal Component**: Direction of signal to use (X, Y, Z, ALL)
+  * **Frame Window**: Number of frames to check for threshold condition.
+  * **Frame Offset**: Shift event by a specified number of frames.
+  * **Time Offset**: Shift event by time (in seconds).
+  * **Threshold**: Value the signal must cross to trigger the event.
+  * **Event Instance**: Specify which instance of the event to label. (0 = all)
+  * **Label on Ascent/Descent**: Choose to place event when threshold is cross in an increasing signal (ascent) or decreasing signal (descent).
+  * **Ensure Window Before/After**: Full frame window is available before or after detected point to avoid errors.
+  * **Event Sequence**: Specify range in which to search for threshold crossings.
+  * **Event Subsequence**: Specify subrange in which to search for threshold crossings.
 ===== Examples =====