This command identifies the lowest point (minimum value) of a signal within a specified time range and creates a corresponding event at that frame. It is typically used when a user wants to detect a single lowest value of a signal over an entire trial or within a specific interval defined by events. This command is highly configurable and allows you to:
If the local minima are needed, see the Event_Minimum command
To review the difference between local and global minimum values please see here.
The command below is as seen in the Visual3D application, Version 6.
Event_Global_Minimum /RESULT_EVENT_NAME= ! /SIGNAL_TYPES= ! /SIGNAL_FOLDER=ORIGINAL ! /SIGNAL_NAMES= ! /SIGNAL_COMPONENTS= ! /FRAME_OFFSET=0 ! /TIME_OFFSET= ! /EVENT_SEQUENCE= ! /EXCLUDE_EVENTS= ! /EVENT_SEQUENCE_INSTANCE=0 ! /EVENT_SUBSEQUENCE= ! /SUBSEQUENCE_EXCLUDE_EVENTS= ! /EVENT_SUBSEQUENCE_INSTANCE=0 ! /THRESHOLD= ;
The following table shows the command parameters and descriptions:
Parameter | Description |
/RESULT_EVENT_NAME= | Name of the new event created at the signal's minimum value. |
!/SIGNAL_TYPES= | Type of signal (e.g., `ANALOG`, `LINK_MODEL_BASED`, `TARGET`). |
!/SIGNAL_FOLDER= | Folder where the signal is stored, usually `ORIGINAL` or `NORMALIZED`. |
!/SIGNAL_NAMES= | The specific signal to evaluate (e.g., `Force`, `Left_Ankle_Angle`). |
!/SIGNAL_COMPONENTS= | Component of the signal to check (e.g., X, Y, Z). |
!/FRAME_OFFSET= | Number of frames to shift the new event from the minimum. |
!/TIME_OFFSET= | Time (in seconds) to shift the event forward or backward. |
!/EVENT_SEQUENCE= | Sequence of two events (e.g., `LTO`, `LHS`) to restrict the search range. |
!/EXCLUDE_EVENTS= | If any listed event occurs in the sequence, it is skipped. |
!/EVENT_SEQUENCE_INSTANCE= | Index of the sequence instance to evaluate (0 = all, 1 = first, etc.). |
!/EVENT_SUBSEQUENCE= | Optional inner event window within a broader sequence. |
!/SUBSEQUENCE_EXCLUDE_EVENTS= | Exclude subsequence if certain events are present. |
!/EVENT_SUBSEQUENCE_INSTANCE= | Specify instance of the subsequence to evaluate. |
!/THRESHOLD= | Minimum required signal value to consider a point as the minimum. |
The command can be edited in a text editor or in a dialog form. To edit in the dialog pop-up form either click on the Edit button in the pipeline workshop or double-click on the command. The dialog box is shown below:
The following example will go through the use of the Event_Global_Maximum command in the Visual3D application.
This command may be used to create an event RKFlex_Min, at the GLOBAL minimum value of a signal.
RKFlex_Min is at the minimum knee flexion angle during the gait cycle. The gait cycle is indicated by the RHS events.
Example 1) The minimum value of the signal may be over the entire signal
Example 2) The minimum value of the signal may be during an event sequence
Example 3) A specific event sequence may be excluded
NOTE:
This example will be done showing both the dialog box and corresponding command text.
Other options within the command such as Exclude Event, and Select Subsequence are explained in detail on the Event_Global_Maximum page.
To create the RKFlex_Min event using the Event_Global_Minimum dialog box:
1. Enter information into dialog box:
2. Select desired signal:
RKFlex_Min will be created at the global minimum value during the gait cycle.
This command can be used to find the lowest vertical GRF during swing phase of the left leg and convert that to a metric.
Event_Global_Minimum /RESULT_EVENT_NAME=LeftMinGRF /SIGNAL_TYPES=ANALOG /SIGNAL_FOLDER=ORIGINAL /SIGNAL_NAME=F2Y /FRAME_OFFSET=0 ! /TIME_OFFSET= /EVENT_SEQUENCE=LTO+LHS ! /EXCLUDE_EVENTS= ! /EVENT_SEQUENCE_INSTANCE= ! /EVENT_SUBSEQUENCE ! /SUBSEQUENCE_EXCLUDE_EVENTS= ! /EVENT_SUBSEQUENCE_INSTANCE=0 ! /THRESHOLD= ;
Then convert the signal value at this event to a usable number:
Metric_Signal_Value_At_Event ! /SIGNAL_FOLDER= ! /SIGNAL_LABEL= /EVENT_NAME=LeftMinGRF /RESULT_METRIC_NAME=MinGRF_Left_Swing ;