Inspect3D Tutorial: Load and View Data: Difference between revisions
mNo edit summary |
m (Update terminology for v2023.08.22.) |
||
Line 26: | Line 26: | ||
Once you have loaded the library, the Group definition dialog will be activated. You now have the ability to automatically or manually define queries that will group the signals in your library. To do this: | Once you have loaded the library, the Group definition dialog will be activated. You now have the ability to automatically or manually define queries that will group the signals in your library. To do this: | ||
# Click on the [[Image:I3DGroups.png|20px]] <b> | # Click on the [[Image:I3DGroups.png|20px]] <b>Query Definitions</b> icon on the [[Inspect3D_Documentation_ToolBar|toolbar]] | ||
# Click on [[Image:I3DGroups.png|20px]] <b> | # Click on [[Image:I3DGroups.png|20px]] <b>Query Definitions</b> to define group definitions for the first time and open the [[Inspect3D_Advanced_Query_Section|Query Builder Dialog]] | ||
# | # Alternatively, if you have previously saved query definitions, you can click on [[Image:I3DOpenGroupDef.png|20px]] <b>Load Query Def & Compute Groups</b> to load a [[Q3D_Query_File|.q3d]] file containing query definitions and then automatically calculate the groups for the loaded library. | ||
Once the [[Inspect3D_Advanced_Query_Section| | Once the [[Inspect3D_Advanced_Query_Section|Query Builder dialog]] is open there are two options for creating group definitions: | ||
# Either manually create group definitions by | # Either manually create group definitions by | ||
## Clicking the [[Image:ActionAdd48x48.png|20px]] green addition button to name a new group and add it | ## Clicking the [[Image:ActionAdd48x48.png|20px]] green addition button to name a new group and add it | ||
Line 38: | Line 38: | ||
## Accept the default settings and click <b>Create</b> | ## Accept the default settings and click <b>Create</b> | ||
Once you have created your | Once you have created your query definitions: | ||
# Click <b>Calculate All | # Click <b>Calculate All Queries</b> to apply the queries you have defined to the loaded library. | ||
# Close the | # Close the Query Builder dialog | ||
## If Inspect3D has not finished computing all of the groups then it will ask you if you want it to continue. Click <b>Compute Groups</b>. | ## If Inspect3D has not finished computing all of the groups then it will ask you if you want it to continue. Click <b>Compute Groups</b>. | ||
Line 54: | Line 54: | ||
Now that the signals in the library have been grouped, it is now possible to visually examine them and begin exploring your data: | Now that the signals in the library have been grouped, it is now possible to visually examine them and begin exploring your data: | ||
# Select a particular group in the <b>Groups</b> widget to determine which signals you would like to view | # Select a particular group in the <b>Groups</b> widget of the Queried Data subwindow to determine which signals you would like to view | ||
# Selecting different workspaces in the <b>Workspaces</b> widget determines which are displayed. Checking the <b>Select All Workspaces</b> box conveniently displays all of the workspaces associated with | # Selecting different workspaces in the Queried Data subwindow's <b>Workspaces</b> widget determines which are displayed. Checking the <b>Select All Workspaces</b> box conveniently displays all of the workspaces associated with your selected group(s) | ||
# Check the appropriate boxes to plot all sequences, workspace means/standard deviations, and group means/standard deviations. | # Check the appropriate boxes to plot all sequences, workspace means/standard deviations, and group means/standard deviations. | ||
# Click <b>Refresh Plot</b> | # Click <b>Refresh Plot</b> | ||
The [[Inspect3D_Documentation_Options_Dialogue|Options dialog]] allows you to modify the [[Inspect3D_Queried_Data#Plotting_Options|plot options]] to determine what is displayed. For example, you can choose to display | The [[Inspect3D_Documentation_Options_Dialogue|Options dialog]] allows you to modify the [[Inspect3D_Queried_Data#Plotting_Options|plot options]] to determine what is displayed. For example, you can choose the number and layout of plots to display, change how lines are coloured and styled, and modify axis labels among many other things. | ||
If you have multiple plots, then a gray bounding box will appear around the active plot, identifying | If you have multiple plots, then a gray bounding box will appear around the active plot, identifying which plot is currently being modified. | ||
</div> | </div> | ||
Line 90: | Line 90: | ||
Click [[Image:I3DSaveWorkspaceAs.png|20px]] <b>Save Workspace As</b> to save the work you've done so far. This saves the application workspace as an [[I3D_Workspace_File|.i3d file]], which is an XML file. | Click [[Image:I3DSaveWorkspaceAs.png|20px]] <b>Save Workspace As</b> to save the work you've done so far. This saves the application workspace as an [[I3D_Workspace_File|.i3d file]], which is an XML file. | ||
NOTE: If you have excluded data then your CMZ files are out of sync with your | NOTE: If you have excluded data then your CMZ files are out of sync with your Inspect3D workspace at this point. This means that if you re-queried the loaded library, you would need to exclude the traces again. To avoid this, click the [[Image:I3DUpdateCMOsWithBadEvents.png|20px]] <b>Update CMZ files</b> icon on the [[Inspect3D_Documentation_ToolBar|toolbar]] to update your CMZ files at any point. | ||
[[Category:Inspect3D]] | [[Category:Inspect3D]] | ||
[[Category:Tutorials]] | [[Category:Tutorials]] |
Revision as of 14:05, 23 August 2023
Language: | English • français • italiano • português • español |
---|
This tutorial begins by assuming that you have a CMZ file for each subject/session from Visual3D. If necessary you can use our build CMZ feature or work through the Visual3D tutorial for building a CMZ file.
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: V3D Workshop @ ASB.
Set the library path to the data directory
To start, you need to tell Inspect3D where to look for your data. After opening Inspect3D:
Click the Load Library button on the toolbar to open the Library dialog:
- Click Browse to open a dialog that allows you to select a file path
- Select the top level folder/root directory which contains the CMZ files
- Click Select Folder
- Click Load
- Close the Library dialog
NOTE: the CMZ files' associated CMX files must also be present for Inspect3D to be able to load the library.
Define queries and group signals
Once you have loaded the library, the Group definition dialog will be activated. You now have the ability to automatically or manually define queries that will group the signals in your library. To do this:
- Click on the
Query Definitions icon on the toolbar
- Click on
Query Definitions to define group definitions for the first time and open the Query Builder Dialog
- Alternatively, if you have previously saved query definitions, you can click on
Load Query Def & Compute Groups to load a .q3d file containing query definitions and then automatically calculate the groups for the loaded library.
Once the Query Builder dialog is open there are two options for creating group definitions:
- Either manually create group definitions by
- OR Click Auto-Populate Groups
- Accept the default settings and click 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
- If Inspect3D has not finished computing all of the groups then it will ask you if you want it to continue. Click Compute Groups.
Manually Create Group Definitions (Video) |
---|
Visualize your data
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 checkmark icon replaced by an X.
Manually View Group Definitions (Video) |
---|
Save the application workspace
Click Save Workspace As to save the work you've done so far. This saves the application workspace as an .i3d file, which is an XML file.
NOTE: If you have excluded data then your CMZ files are out of sync with your Inspect3D workspace at this point. This means that if you re-queried the loaded library, you would need to exclude the traces again. To avoid this, click the Update CMZ files icon on the toolbar to update your CMZ files at any point.