This is an old revision of the document!
Table of Contents
Event Save TPR Signal
Overview
The 'Event_Save_TPR_Signal' command is used to create and save a Target Pattern Recognition (TPR) file. This file captures the shape of a signal surrounding a specific event and is later used in pattern-matching commands like 'Event_TPR_Signal' or 'Event_TPR_File'.
- Works by taking a window frames around an event and saving that signal segment as a template than can be used for event detection in other tirals.
Requirements:
- A well-defined event must already exist in the file, and the signal around the event must be clearly identifiable and stable.
- The radius (number of frames before/after) should capture the full motion feature.
Pipeline Command
The pipeline command is shown below as seen in the Visual3D application:
Event_Save_TPR_Signal ! /FILE_NAME= ! /PATTERN_FILE= /SIGNAL_TYPES= ! /SIGNAL_FOLDER=ORIGINAL /SIGNAL_NAMES= /PATTERN_EVENT_NAME= ! /PATTERN_EVENT_INSTANCE=1 ! /TPR_RADIUS=7 ;
Command Parameters
The following table shows the command parameters and descriptions:
| Parameter | Description |
| /FILE_NAME= | The name of the `.tpr` file to be created (e.g., `HeelStrikePattern.tpr`). |
| /PATTERN_FILE= | (Optional) Used internally to chain patterns — leave blank when saving a new pattern. |
| /SIGNAL_TYPES= | Type of signal (e.g., `ANALOG`, `LINK_MODEL_BASED`, or `TARGET`). |
| /SIGNAL_FOLDER= | Folder containing the signal data (`FILTERED`, `ORIGINAL`, etc.). |
| /SIGNAL_NAMES= | Name of the signal to extract the pattern from (e.g., `Right_Ankle_Accel`). |
| /PATTERN_EVENT_NAME= | Name of the event at the center of the pattern (e.g., `EMG_Onset`, `LHS`). |
| /PATTERN_EVENT_INSTANCE= | Which instance of the event to use (1 = first, 2 = second, etc.). |
| /TPR_RADIUS= | Number of frames before and after the event to include. A value of 10 creates a 21-frame pattern. |
Dialog
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 pipeline command. The dialog is shown below.
These options are reflected in the parameters table.
Examples
Simple example
Showing functionality of the command, using a diagram possibly to show output.
Complex example
Combine with other commands and show step-by-step process for frequent use case
Notes
- Important considerations (anything included in the page before the reformat)