HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » event_commands » Event Global Maximum
visual3d:documentation:pipeline:event_commands:event_global_maximum

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:event_commands:event_global_maximum [2024/06/18 13:30] – sgrangervisual3d:documentation:pipeline:event_commands:event_global_maximum [2025/02/20 20:59] (current) – wikisysop
Line 1: Line 1:
 +====== Event Global Maximum ======
 +
 +==== Overview ====
 +This command identifies the global maximum of a specified signal within a given time range and creates an event at that peak value. This command is useful for detecting peak joint angles, force plate data peaks, or maximum velocity in motion capture trials.
 +
 +==== Pipeline Command ====
 +The following command shows the most recent update, **Version 6**.
 +
 +<code>
 +Event_Global_Maximum
 +/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=
 +;
 +</code>
 +
 +==== Command Parameters ====
 +The following table shows the command parameters and descriptions:
 +
 +|**/RESULT_EVENT_NAME=**     |Specifies the name of the event created at the peak signal value.|
 +|**! /SIGNAL_TYPES=**        |Type of signal from which the maximum value will be extracted (Target, Analog, etc.)|
 +|**! /SIGNAL_FOLDER=ORIGINAL**      |Folder within signal type.|
 +|**! /SIGNAL_NAMES=**    |Defines the signal from which the maximum value will be extracted.|
 +|**! /SIGNAL_COMPONENTS=**    |Component of the named signal which the maximum value will be found in (X, Y, Z)|
 +
 +
 \\ \\
 **Specify an Event Label(s) at the Global Maximum of a signal.** **Specify an Event Label(s) at the Global Maximum of a signal.**
Line 8: Line 45:
 To review the difference between local and global maximum values please see [[Visual3D:Documentation:Pipeline:General_Information:Global_vs_Loca_Max_and_Min|here]]. To review the difference between local and global maximum values please see [[Visual3D:Documentation:Pipeline:General_Information:Global_vs_Loca_Max_and_Min|here]].
  
-====== Version 6 ======+===== Version 6 =====
  
 The **Event_Global_Maximum** command may be used to place an event at the Global maximum value of a signal. If Threshold has a value or expression only global maximum greater than the threshold will be identified. The **Event_Global_Maximum** command may be used to place an event at the Global maximum value of a signal. If Threshold has a value or expression only global maximum greater than the threshold will be identified.
  
 \\ \\
-{{Event_Global_Maximum_v6.png}}+{{:Event_Global_Maximum_v6.png}}
  
-====== Version 5 ======+===== Version 5 =====
  
 The **Event_Global_Maximum** command may be used to place an event label at the Global Maximum value of a signal. The **Event_Global_Maximum** command may be used to place an event label at the Global Maximum value of a signal.
  
-|<code>\\ Event_Global_Maximum\\ /RESULT_EVENT_NAME=\\ ! /SIGNAL_TYPES=\\ ! /SIGNAL_NAMES=\\ ! /SIGNAL_FOLDER= ORIGINAL\\ ! /SIGNAL_COMPONENTS=\\ ! /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 \\ ! /SELECT_X= \\ ! /SELECT_Y= \\ ! /SELECT_Z= \\ ! /SELECT_RESIDUAL= \\ ! /START_AT_EVENT= \\ ! /END_AT_EVENT= \\ ;\\ </code>  |  {{Event_Global_Maximum.jpg{{/images/thumb/9/95/Event_Global_Maximum.jpg/400px-Event_Global_Maximum.jpg?400x444}}|+<code> 
 +Event_Global_Maximum 
 +/RESULT_EVENT_NAME= 
 +! /SIGNAL_TYPES= 
 +! /SIGNAL_NAMES= 
 +! /SIGNAL_FOLDER= ORIGINAL 
 +! /SIGNAL_COMPONENTS= 
 +! /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 
 +! /SELECT_X=  
 +! /SELECT_Y=  
 +! /SELECT_Z=  
 +! /SELECT_RESIDUAL=  
 +! /START_AT_EVENT=  
 +! /END_AT_EVENT= 
 +; 
 +</code>
  
 +{{:Event_Global_Maximum.jpg}}
  
----- +==== Examples ====
- +
-===== Examples =====+
  
 This command may be used to create an event, **RKFlex_Max**, at the GLOBAL maximum value of a signal.\\ This command may be used to create an event, **RKFlex_Max**, at the GLOBAL maximum value of a signal.\\
Line 40: Line 99:
  
  
-==== Example - Dialog Box ====+=== Example - Dialog Box ===
  
 To create the RKFlex_Max event using the Event_Global_Maximum dialog box: To create the RKFlex_Max event using the Event_Global_Maximum dialog box:
Line 47: Line 106:
  
  
-|**1. Enter information into dialog box:**\\ \\ **Event_Name:** RKFlex_Max\\ \\ **Select Frame Offset:**0\\ \\ **Signal Components:**X\\ \\ **Select an event sequence and Instance for the range:**\\ \\ **Event Sequence Instance:**0\\ \\ **Defined Events:**RHS + RHS\\ \\ Click **OK**  |  {{Event_Global_Max_RKFlex_Max.jpg{{/images/thumb/a/ac/Event_Global_Max_RKFlex_Max.jpg/400px-Event_Global_Max_RKFlex_Max.jpg?400x443}}|+|**1. Enter information into dialog box:**\\ \\ **Event_Name:** RKFlex_Max\\ \\ **Select Frame Offset:**0\\ \\ **Signal Components:**X\\ \\ **Select an event sequence and Instance for the range:**\\ \\ **Event Sequence Instance:**0\\ \\ **Defined Events:**RHS + RHS\\ \\ Click **OK**  |  {{:Event_Global_Max_RKFlex_Max.jpg}}|
  
 \\ \\
  
  
-|**2. Select desired signal:**\\ \\ Select **signal from data tree** Right_Knee_Angle\\ \\ Click **Import Selected Signals**  |  {{Event_Global_Max_RKFlex_Max_Import.jpg{{/images/thumb/d/d5/Event_Global_Max_RKFlex_Max_Import.jpg/500px-Event_Global_Max_RKFlex_Max_Import.jpg?500x248}}|+|**2. Select desired signal:**\\ \\ Select **signal from data tree** Right_Knee_Angle\\ \\ Click **Import Selected Signals**  |  {{:Event_Global_Max_RKFlex_Max_Import.jpg}}|
  
 Two instances of **RKFlex_Max** were created, one in between each sequence of **RHS+RHS**.\\ Two instances of **RKFlex_Max** were created, one in between each sequence of **RHS+RHS**.\\
  
  
-|  {{Event_Global_Max_RKFlex_Max_Graph.jpg{{/images/thumb/f/f1/Event_Global_Max_RKFlex_Max_Graph.jpg/600px-Event_Global_Max_RKFlex_Max_Graph.jpg?600x257}}  |+|  {{:Event_Global_Max_RKFlex_Max_Graph.jpg}}  |
  
 \\ \\
Line 65: Line 124:
 ---- ----
  
-==== Example - Exclude Sequence ====+=== Example - Exclude Sequence ===
  
-|Exclude Sequences containing these events can be used to exclude a specific sequence. In this example an event **BAD** was created between one sequence of **RHS + RHS**.\\ \\ Using the same parameters as the previous example, set the **Exclude Sequences containing events** parameter to **BAD**\\   |  {{Event_Global_Max_RKFlex_Max_Exclude.jpg{{/images/thumb/b/bf/Event_Global_Max_RKFlex_Max_Exclude.jpg/400px-Event_Global_Max_RKFlex_Max_Exclude.jpg?400x444}}|+|Exclude Sequences containing these events can be used to exclude a specific sequence. In this example an event **BAD** was created between one sequence of **RHS + RHS**.\\ \\ Using the same parameters as the previous example, set the **Exclude Sequences containing events** parameter to **BAD**\\   |  {{:Event_Global_Max_RKFlex_Max_Exclude.jpg}}|
  
 Only one RKFlex_Max event was created because the second sequence containing the event **BAD** was excluded: Only one RKFlex_Max event was created because the second sequence containing the event **BAD** was excluded:
  
-|  {{Event_Global_Max_RKFlex_Max_Exclude_Graph.jpg{{/images/thumb/5/5f/Event_Global_Max_RKFlex_Max_Exclude_Graph.jpg/600px-Event_Global_Max_RKFlex_Max_Exclude_Graph.jpg?600x251}}  |+|  {{:Event_Global_Max_RKFlex_Max_Exclude_Graph.jpg}}  |
  
 \\ \\
Line 79: Line 138:
 ---- ----
  
-==== Example - Subsequence ====+=== Example - Subsequence ===
  
-|Subsequences can be used to create an event that occurs within a sequence within a sequence. In this example **RKFlex_Max** was created as the maximum value between **LTO + LHS** when these events feel between the **RHS** events.\\ \\ Using the same parameters as the previous example, set the **Subsqeuence** parameter to **LTO + LHS**\\   |  {{Event_Global_Max_RKFlex_Max_Subsequence.jpg{{/images/thumb/8/84/Event_Global_Max_RKFlex_Max_Subsequence.jpg/400px-Event_Global_Max_RKFlex_Max_Subsequence.jpg?400x442}}|+|Subsequences can be used to create an event that occurs within a sequence within a sequence. In this example **RKFlex_Max** was created as the maximum value between **LTO + LHS** when these events feel between the **RHS** events.\\ \\ Using the same parameters as the previous example, set the **Subsqeuence** parameter to **LTO + LHS**\\   |  {{:Event_Global_Max_RKFlex_Max_Subsequence.jpg}}|
  
 **RKFlex_Max** event was created between **RHS** events that contained the **LTO to LHS** subsequence. **RKFlex_Max** event was created between **RHS** events that contained the **LTO to LHS** subsequence.
  
-|  {{Event_Global_Max_RKFlex_Max_Subsequence_Graph.jpg{{/images/thumb/1/15/Event_Global_Max_RKFlex_Max_Subsequence_Graph.jpg/600px-Event_Global_Max_RKFlex_Max_Subsequence_Graph.jpg?600x253}}  |+|  {{:Event_Global_Max_RKFlex_Max_Subsequence_Graph.jpg}}  |
  
 \\ \\
Line 93: Line 152:
 ---- ----
  
-====== Version 4 ======+===== Version 4 ===== 
 + 
 +<code> 
 +Event_Global_Maximum 
 +/Signal_Types= The type of signal to be evaluated 
 +/Signal_Names= The names of the signals to be evaluated 
 +/Signal_Folder= The name of the signal folder 
 +/Event_Name= The name to be given to the threshold event 
 +/Select_X= (True or False)Use this component of the signal 
 +/Select_Y= (True or False)Use this component of the signal 
 +/Select_Z= (True or False)Use this component of the signal 
 +/Radius= The range of frames of data that must be below the maximum 
 +/Start_At_Event= The search begins from the start event 
 +/End_At_Event= The search ends at the end event 
 +</code> 
 + 
 +Dialog that pops up when pipeline selection is edited by double clicking with the left mouse button.
  
-|<code>\\ Event_Global_Maximum\\ /Signal_Types= The type of signal to be evaluated\\ /Signal_Names= The names of the signals to be evaluated\\ /Signal_Folder= The name of the signal folder\\ /Event_Name= The name to be given to the threshold event\\ /Select_X= (True or False)Use this component of the signal\\ /Select_Y= (True or False)Use this component of the signal\\ /Select_Z= (True or False)Use this component of the signal\\ /Radius= The range of frames of data that must be below the maximum\\ /Start_At_Event= The search begins from the start event\\ /End_At_Event= The search ends at the end event\\ </code>  |  Dialog that pops up when pipeline selection is edited by double clicking with the left mouse button.\\ {{Eventglobalminmaxdlg.gif}}\\ |+{{:Eventglobalminmaxdlg.gif}}
  
  
  
visual3d/documentation/pipeline/event_commands/event_global_maximum.1718717401.txt.gz · Last modified: 2024/06/18 13:30 by sgranger