Differences

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

--- visual3d:documentation:pipeline:signal_commands:merge_data [2024/07/17 15:23] – sgranger
+++ visual3d:documentation:pipeline:signal_commands:merge_data [2024/10/15 02:05] (current) – Cleaned up page. Still need to meet Pipeline Command format. wikisysop
@@ Line 1: / Line 1: @@
-====== Merge Data ======
+===== Merge Data =====
-This command merges data from more than one data name into a single one either by **APPEND_TO_END** (appending one signal to the end of another signal) or by **MERGE_AS_NEW_COMPONENTS** (treat each original signal as a component of the new signal).
+This command merges data from multiple signals into a single signal in one of two ways:
+  - either via **APPEND_TO_END**, appending one signal to the end of another signal, or
+  - via **MERGE_AS_NEW_COMPONENTS**, treating each original signal as a component of the new signal.
-|<code>\\ 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\\ ;\\ </code>  |  {{:Merge_Data.png}}|
+<code>
+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
+;
+</code>
+{{:Merge_Data.png}}
 ==== Parameters ====
-**COMPONENT_SEQUENCE:** if empty, all components of the signals will be used\\
+**COMPONENT_SEQUENCE:** if empty, all components of the signals will be used
-**MERGE_TYPE:** APPEND_TO_END or MERGE_AS_NEW_COMPONENTS\\
+**MERGE_TYPE:** APPEND_TO_END or MERGE_AS_NEW_COMPONENTS
-APPEND_TO_END append one signal to the end of another signal
+  - APPEND_TO_END append one signal to the end of another signal
-MERGE_AS_NEW_COMPONENTS treat each original signal as a component of the new signal
+  - 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\\
+**IGNORE_MISSING_SIGNALS:**
+**PRE_CLEAR_RESULT_SIGNAL:** Will delete the resulting signal prior to beginning
 ==== Examples ====
-Below are two examples for the Merge_Data command
+Below are some examples for using the Merge_Data command demonstrating both types of merges.
 === Simple Example ===
@@ Line 40: / Line 55: @@
 ;
 </code>
-=== Add a column to a metric ===
-Another example using the Merge_Data command can be found on the [[|Metrics Example 3]] page. In this example, the command is used to add an indexing column to a metric (single values). This will allow the metric to be graphed.
-=== Merge for ASCII export ===
-The example found on [[Visual3D:Documentation:Pipeline:File_Commands:Export_Data_To_ASCII_File#Example_6:_Export_Concatenated_Metric_Signals|Export_Data_To_ASCII_File#Example_6:_Export_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.
 === Create Global List of all Instances ===
@@ Line 72: / Line 77: @@
 </code>
+=== Add a column to a metric ===
+Another [[Metrics Example 3|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 [[Visual3D:Documentation:Pipeline:File_Commands:Export_Data_To_ASCII_File#Example_6:_Export_Concatenated_Metric_Signals|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.