Differences

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

--- visual3d:documentation:pipeline:event_commands:event_maximum [2025/04/28 16:49] – wikisysop
+++ visual3d:documentation:pipeline:event_commands:event_maximum [2025/04/29 19:04] (current) – wikisysop
@@ Line 57: / Line 57: @@
 {{:visual3d:documentation:pipeline:event_commands:event_max_dialog.png?400|}}
+  * **New Event Label Name**: Name of event created at the local maximum points.
+  * **Signal Component**: Which direction of the signal to analyze.
+  * **Frame Window**: Size of window to look for a local maximum around each frame.
+  * **Frame Offset**: Shift the resulting event by a number of frames.
+  * **Time Offset**: Move the event by a time shift (in seconds)
+  * **Threshold**: Only create an event if the maximum exceeds this value.
+  * **Event Instance to Create**: Choose which maximum to create if there are multiple peaks in a search window
+  * **Event Sequence and Instance for Range**: Limits where to search for maxima
+  * **Subsequence and Instance within Event Sequence**: Further limits search inside smaller phase within main event range.
 ----
@@ Line 70: / Line 81: @@
 **Select Frame Offset:** 0\\
 **Signal Components:** X\\
-**Event Sequence:**RHS -> RHS (use arrows to move from defined events list into sequence.) \\
 **Event Sequence Instance:**0\\
-{{:Event_Max_RKFlex_MaxLocal.jpg?400}}
+|{{:visual3d:documentation:pipeline:event_commands:eventmax_ex1_dialogbox.png?600|}}|<code>
+Event_Maximum
+/RESULT_EVENT_NAME=RKFlex_MaxLocal
+/SIGNAL_TYPES=KINETIC_KINEMATIC
+/SIGNAL_FOLDER=RFT
+/SIGNAL_NAMES=AngAcc
+/SIGNAL_COMPONENTS=X
+! /FRAME_OFFSET=0
+! /TIME_OFFSET=
+! /EVENT_SEQUENCE=
+! /EXCLUDE_EVENTS=
+! /EVENT_SEQUENCE_INSTANCE=0
+! /EVENT_SUBSEQUENCE=
+! /SUBSEQUENCE_EXCLUDE_EVENTS=
+! /EVENT_SUBSEQUENCE_INSTANCE=0
+! /EVENT_INSTANCE=0
+/FRAME_WINDOW=40
+! /THRESHOLD=
+;
+</code>|
 . Close the dialog, on the Signals and Events tab, select the desired signal from the data tree, in this case **Right_Knee_Angle**. Navigate into the LINK_MODEL_BASED items folder, and select the checkbox beside the signal.
@@ Line 81: / Line 110: @@
 {{:Event_Max_RKFlex_MaxLocal_Import.jpg?600}}
-**RKFlex_Max** will be created at the minimum value during the gait cycle within the specified frame window.
+**RKFlex_MaxLocal** will be created at the maximum values during the full gait cycle. As seen below:
+|{{:visual3d:documentation:pipeline:event_commands:eventmax_ex1_corrected_graph.png?600|}}|
+==== Example 2: Complex ====
+In this example, the local maxima of the right foot angular acceleration during the full trial is identified. Then, the values of this event are extracted.
+Use the Event_Maximum command to find the peaks in the acceleration signal, the component is set to Y and frame window is increased to 60.
+The signal used to represent the acceleration was taken from the KINETIC_KINEMATIC folder - RFT (Right Foot)
+<code>
+Event_Maximum
+/RESULT_EVENT_NAME=Right_Accel_Peak_Stance
+/SIGNAL_TYPES=KINETIC_KINEMATIC
+/SIGNAL_FOLDER=RFT
+/SIGNAL_NAMES=AngAcc
+/SIGNAL_COMPONENTS=Y
+! /FRAME_OFFSET=0
+! /TIME_OFFSET=
+/EVENT_SEQUENCE=
+! /EXCLUDE_EVENTS=
+! /EVENT_SEQUENCE_INSTANCE=0
+! /EVENT_SUBSEQUENCE=
+! /SUBSEQUENCE_EXCLUDE_EVENTS=
+! /EVENT_SUBSEQUENCE_INSTANCE=0
+! /EVENT_INSTANCE=0
+/FRAME_WINDOW=60
+! /THRESHOLD=
+;
+</code>
+Then use Metric_Signal_Value_At_Event to extract the actual Y-acceleration values at these peaks for analysis:
+<code>
+Metric_Signal_Value_At_Event
+/SIGNAL_TYPES=KINETIC_KINEMATIC
+/SIGNAL_FOLDER=RFT
+/SIGNAL_NAMES=AngAcc
+! /RESULT_METRIC_FOLDER=PROCESSED
+/RESULT_METRIC_NAME=Right_Accel_Peak_Stance_Times
+! /APPLY_AS_SUFFIX_TO_SIGNAL_NAME=FALSE
+/SIGNAL_COMPONENTS=Y
+! /COMPONENT_SEQUENCE=
+/EVENT_NAME=Right_Accel_Peak_Stance
+! /EVENT_INSTANCE=0
+! /SCALE_FACTORS=1
+! /GENERATE_GLOBAL_MEAN_AND_STDDEV=TRUE
+! /GENERATE_LOCAL_MEAN_AND_STDDEV=TRUE
+! /APPEND_TO_EXISTING_VALUES=FALSE
+! /GENERATE_VECTOR_LENGTH_METRIC=FALSE
+! /RETAIN_NO_DATA_VALUES=FALSE
+;
+</code>
-----
 ===== Notes =====