Differences

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

--- visual3d:documentation:definitions:global_workspace [2024/06/17 18:15] – created sgranger
+++ visual3d:documentation:definitions:global_workspace [2024/11/15 16:04] (current) – Added screenshots and internal links. wikisysop
@@ Line 1: / Line 1: @@
-Visual3D stores most signals as part of the data file from which they are associated.
+===== Global Workspace =====
-When signals are created from many sources (e.g. as an mean signal across many files), it is no longer possible to assign the signals to any particular file. Visual3D stores these signals in a special repository (coined the Global Workspace) where these signals reside.
+Visual3D stores most signals as part of the C3D file with which they are associated. This ensures that the connection between signals and their original files is preserved.
-For example, the [[Visual3D:Documentation:Pipeline:Metric_Commands:Temporal_Distance_Calculations_for_Gait|gait temporal distance parameters]] are stored in the Global Workspace.
+When signals are created from many sources, e.g., as an mean signal across many files, it is no longer possible to assign the signals to any particular C3D file. In these cases Visual3D will store the resulting signals in a special repository coined the Global Workspace. This is referenced as GLOBAL throughout Visual3D.
-To access these signals (e.g. View or Export), it is necessary to make the Active File the Global Workspace.
+==== Accessing the Global Workspace ====
+The Global Workspace is a part of every CMZ file and is listed in the Workspace tab. To access these signals as a user, e.g., to view or export them, it is necessary to select GLOBAL as the [[visual3d:documentation:definitions:active_files|Active File]].
+{{:visual3d_global_workspace_selection.png}}
+==== Typical GLOBAL Data ====
+The Global Workspace stores data that is associated with more than one C3D file. This commonly includes Frame Numbers, Text Data, and [[visual3d:documentation:definitions:file_formats:p2d_format|P2D Data]].
+{{:visual3d_global_workspace_data.png}}
+Pipeline commands that store their results in the Global Workspace include:
+  - [[visual3d:documentation:pipeline:signal_commands:global_normalized_signal_mean|Global_Normalized_Signal_Mean]]
+  - [[Visual3D:Documentation:Pipeline:Metric_Commands:Temporal_Distance_Calculations_for_Gait|Metric_Compute_Temporal_Distance]]
+  - [[visual3d:documentation:pipeline:metric_commands:metric_mean|Metric_Mean]] when the /Generate_Mean_and_Stddev parameter is set to TRUE
+==== GLOBAL Syntax for Expressions ====
+Signals, metrics, and other data stored in the Global Workspace can be specified in Expressions [[visual3d:documentation:pipeline:expressions:expression_syntax|by prepending the GLOBAL namespace]]:
+<code>
+GLOBAL::SIGNAL_TYPE::SIGNAL_FOLDER::SIGNAL_NAME
+</code>
+**NOTE**: Global data can always be accessed in an [[visual3d:documentation:pipeline:expressions:expressions_overview|Expression]] regardless of the Active Files.