Differences

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

--- sift:tutorials:load_and_view_data [2024/06/26 20:14] – removed sgranger
+++ sift:tutorials:load_and_view_data [2024/11/28 19:13] (current) – [Load and View Data] wikisysop
@@ Line 1: / Line 1: @@
+====== Load and View Data ======
+This tutorial begins by assuming that you have a [[Visual3D:Documentation:Definitions:File_Formats:CMZ_Format_|CMZ]] file for each subject.session from [[Visual3D:Visual3D_Overview|Visual3D]]. If necessary you can use our [[Sift:Tutorials:OpenBiomechanics_Project:Build_CMZ_Files|build CMZ feature]] or work through the Visual3D tutorial for [[Visual3D:Tutorials:Pipeline:Generic_Pipeline_to_Create_CMZ|building a CMZ file]].
+If you prefer, a video tutorial is available outlining the same process. It is available at this link: [[https://youtu.be/FSAosi30w1Y?feature=shared|Sift Tutorial Video 1: Load and View Data]]
+===== Data =====
+This tutorial can be completed with any CMZ file. One possibility is a data set from a Visual3D Workshop at a recent ASB meeting: [[https://www.has-motion.com/download/examples/V3D_Workshop.zip|V3D Workshop @ ASB]].
+===== Load Library =====
+{{ :sift_load_page.png?800}}
+To start, you need to tell Sift where to look for you data. After opening Sift:
+  - Click the {{:sift_library_load.png?20}}**Load Library** on the toolbar or the top left of the [[Sift:Application:Load_Page|load page]]:
+    - Click {{:sift_browser.png?20}}**Browse** to open a dialog that allows you to select a file path
+    - Select the top level folder/root directory which contains the CMZ file NOTE: the CMZ file's associated CMX file must also be present for Sift to be able to load the library;
+    - Click **Select Folder**
+  - Click **Load**
+  - One the library is loaded, you will be able to do initial exploration on the [[Sift:Application:Load_Page|Load page]]:
+    - Verify which CMZ file have been loaded in the 3D Viewer, as well as which C3D files are associated with each CMZ;
+    - Verify which file tags are present in the library;
+    - If you have loaded [[Visual3D:Documentation:Definitions:Multisubject|multisubject data]], verify which [[Visual3D:Documentation:Definitions:Multisubject#Important_Terms|subject prefixes]] and [[Visual3D:Documentation:Definitions:Multisubject#Important_Terms|subject tags]] are present in the library; and
+    - Animate the data contained in any loaded C3D file.
+===== Define queries and group signals =====
+{{ :sift_query_builder_dialog.png?800}}
+Once you have loaded the library, navigate to the explore page, where you can automatically or manually define queries that will group the signals in your library. To do this:
+  - Click on the {{:sift_query_builder.png?20}}**Query Builder Dialog...** button.
+  - Either manually create group definitions by
+    - Clicking the {{:sift_action_add.png?20}} addition button to name a new group and add it
+    - While your new group is selected, click the {{:sift_action_add.png?20}} addition button to name and define a new condition
+    - Repeat these steps until you have created all of your groups
+  - OR click **Auto-Populate Queries**
+    - Accept the default settings and click {{:sift_apply.png?20}}**Create**
+  - Once you have created your query definitions: Click **Calculate All Queries** to apply the queries you have defined to the loaded library.
+  - Close the Query Builder dialog. Note that if Sift has not finished computing all of the groups then it will ask you if you want to continue. Click **Compute Groups**.
+===== Visualize your data =====
+{{ :sift_explore_page.png?800}}
+Now that the signals in the library have been grouped, it is now possible to visually examine them and begin exploring your data in the [[Sift:Application:Explore_Page|explore page]]:
+  - Select a particular group in the **Groups** of the explore page to determine what signals you would like to view
+  - Selecting different explore pages' **Workspaces** widget determines which are displayed. Checking the **Select All Workspaces** box conveniently displays all of the workspaces associated with the selected group(s)
+  - Set the plot type to **Signal-Time** and check the appropriate boxes to plot all sequences, workspace means/standard deviations, and group means/standard deviations
+  - Click **Refresh Plot**
+===== Interact with your data =====
+You can highlight a trace by left-clicking on it. This causes the trace to become more visually prominent than non-highlighted traces and produces a tooltip that includes:
+  * The trace's group name
+  * The trace's workspace name
+  * The name of the specific C3D file for that trace
+  * The trace's frame range from that C3D file
+  * The trace's sub-group name
+  * The x- and y- values of the trace where you left-clicked it
+A trace can be excluded from the plot by:
+  - left-clicking on the trace to highlight it; then
+  - right-clicking and selecting **Exclude -> Exclude Trace(raw data)** from the context menu.
+You can confirm that the trace has been excluded in the **Workspaces** widget: excluded traces will be marked with a red X and workspaces containing excluded traces will have their check-mark icon replaced with an X.
+===== Save the application workspace =====
+Click {{:sift_save.png?20}} **Save Workspace As** to save the work you've done so far. This saves the application workspace as and .i3d file, which is an XML file.
+NOTE: if you have excluded data then you CMZ files are out of sync with you Sift workspace at this point. This eans that if you re-queried the loaded library, you would need to exclude that traces again. To avoid this, click the {{:sift_update_cmz.png?20}} **Update CMZ files** icon on the toolbar to update you CMZ files at any point.