Table of Contents

Merge Data

This command merges data from multiple signals into a single signal in one of two ways:

  1. either via APPEND_TO_END, appending one signal to the end of another signal, or
  2. via MERGE_AS_NEW_COMPONENTS, treating each original signal as a component of the new signal.
Merge_Data
\SIGNAL_TYPES=
\SIGNAL_FOLDER=
\SIGNAL_NAMES=
!\COMPONENT_SEQUENCE=
!\RESULT_TYPES=DERIVED
!\RESULT_FOLDERS=PROCESSED
!\RESULT_NAME=
!\MERGE_TYPE=APPEND_TO_END
!\IGNORE_MISSING_SIGNALS=FALSE
!\PRE_CLEAR_RESULT_SIGNAL=FALSE
;

Parameters

COMPONENT_SEQUENCE: if empty, all components of the signals will be used

MERGE_TYPE: APPEND_TO_END or MERGE_AS_NEW_COMPONENTS

  1. APPEND_TO_END append one signal to the end of another signal
  2. MERGE_AS_NEW_COMPONENTS treat each original signal as a component of the new signal

IGNORE_MISSING_SIGNALS:

PRE_CLEAR_RESULT_SIGNAL: Will delete the resulting signal prior to beginning

Examples

Below are some examples for using the Merge_Data command demonstrating both types of merges.

Simple Example

The command below will create a vector named Vector from 3 analog signals. This is an example of merging 3 signals into one signal. 

Merge_Data
/SIGNAL_NAMES=Analog1+Analog2+Analog3 
/SIGNAL_TYPES=ANALOG+ANALOG+ANALOG 
/SIGNAL_FOLDER=ORIGINAL+ORIGINAL+ORIGINAL 
/SIGNAL_COMPONENTS=0+0+0 
/RESULT_NAME=Vector 
/RESULT_TYPE=DERIVED 
/RESULT_FOLDER=PROCESSED 
/MERGE_TYPE=MERGE_AS_NEW_COMPONENTS 
;

Create Global List of all Instances

Select_Active_File
/FILE_NAME=ALL_FILES
;

Merge_Data
/SIGNAL_TYPES=METRIC
/SIGNAL_FOLDER=PROCESSED
/SIGNAL_NAMES=GLOBAL::List_of_Instances+L_Ankle_Stiffness
/COMPONENT_SEQUENCE=ALL
/RESULT_TYPES=METRIC
! /RESULT_FOLDERS=PROCESSED
/RESULT_NAME=GLOBAL::List_of_Instances
! /MERGE_TYPE=APPEND_TO_END
/IGNORE_MISSING_SIGNALS=FALSE
/PRE_CLEAR_RESULT_SIGNAL=TRUE
;

Add a column to a metric

Another example adds an indexing column to a metric (single values). This will allow the metric to be graphed.

Merge for ASCII export

The example found on Exporting Concatenated Metric Signals will concatenate metrics signals prior to exporting to an ASCII file.

When exporting, all signals are exported to separate columns in the exported file. For metric signals (e.g. signals with only one or two entries/frames) this can be inconvenient. It is not possible to concatenate the signals in the export command, but it is possible to concatenate the signals explicitly before export.