Inspect3D Tutorial: Export Results: Difference between revisions
(→Visualize the groups: Updated for v2023.08.22) |
m (Text replacement - "www.c-motion.com/download" to "www.has-motion.com/download") |
||
(4 intermediate revisions by one other user not shown) | |||
Line 8: | Line 8: | ||
==Data== | ==Data== | ||
This tutorial uses overground walking data from four subjects. The subjects walked at three different speeds: slow, normal and fast. The data was processed using a pipeline with automatic event detection and link model based item calculations (most notably the knee joint angles). [[https://www. | This tutorial uses overground walking data from four subjects. The subjects walked at three different speeds: slow, normal and fast. The data was processed using a pipeline with automatic event detection and link model based item calculations (most notably the knee joint angles). [[https://www.has-motion.com/download/examples/inspect3d_samples.zip Four Subjects Walking Data Set]]. | ||
This tutorial also uses query definitions that have been previously saved in a [[Q3D Query File|.q3d file]]. [[https://www. | This tutorial also uses query definitions that have been previously saved in a [[Q3D Query File|.q3d file]]. [[https://www.has-motion.com/download/examples/AnkleAngles.q3d AnkleAngles.q3d]]. | ||
==Load the library== | ==Load the library== | ||
Line 52: | Line 52: | ||
==Export Graphs== | ==Export Graphs== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[Image:Export ExportGraphOption.png|right]] It is possible now to export the visualizations to | [[Image:Export ExportGraphOption.png|right]] It is possible now to export the visualizations to one of four image formats: JPG, PDF vector graphic, PNG, or BMP. | ||
1. Right-click the bottom-right plot and select <b>Export Graph</b> from the context menu. | 1. Right-click the bottom-right plot and select <b>Export Graph...</b> from the context menu. | ||
2. In the Export Graph dialog, choose your desired <b>Export Path</b>, leave <b>Use Current Size</b> checked, and set the <b>Format</b> to ".pdf (vector graphics)". | 2. In the Export Graph dialog, choose your desired <b>Export Path</b>, leave <b>Use Current Size</b> checked, and set the <b>Format</b> to ".pdf (vector graphics)". | ||
Line 60: | Line 60: | ||
3. Click <b>Save</b>. | 3. Click <b>Save</b>. | ||
[[Image: | [[Image:Inspect3D_Export_Graph_Menu.png]] | ||
4. Alternatively, export all four graphs collectively by selecting [[Image:I3D_file_export_graphs.png|20px]] <b>Export Graphs</b> on the [[Inspect3D_Documentation_ToolBar|toolbar]]. | |||
5. In the Export Graph dialog, choose your desired <b>Export Path</b>, uncheck <b>Use Current Size</b>, specify Height and Width to be 400 pixels each, and set the <b>Format</b> to ".jpg". | |||
</div> | </div> | ||
==Export Signals to Text== | ==Export Signals to Text== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[Image: | [[Image:Inspect3D_Export_Results_Settings.png|right]] Alternatively, we can export our signal data to a text format. | ||
1. Click [[Image:I3DExportPCAResults.png|20px]] <b>Export Results</b> on the application toolbar. | 1. Click [[Image:I3DExportPCAResults.png|20px]] <b>Export Results</b> on the application toolbar. | ||
Line 73: | Line 77: | ||
3. In the Export Results dialog's <b>Export Result Options</b> section, leave the default <b>Export Format</b> and <b>Precision</b> and click <b>Generate Preview</b>. | 3. In the Export Results dialog's <b>Export Result Options</b> section, leave the default <b>Export Format</b> and <b>Precision</b> and click <b>Generate Preview</b>. | ||
4. The <b>Table</b> of results will populate and you can scroll in both directions to inspect the text that will be exported. For each signal group, we can see in the table that each | 4. The <b>Table</b> of results will populate and you can scroll in both directions to inspect the text that will be exported. For each signal group, we can see in the table that each Workspace's Mean and Standard Deviation gets its own column and that there are 101 rows, one for each normalized time point. Note that resizing the dialog prioritizes any additional space for the table to make it easier to view large output files. | ||
5. Specify a <b>Results File Name</b> and then click <b>Export Results</b> to finalize the export. | 5. Specify a <b>Results File Name</b> and then click <b>Export Results</b> to finalize the export. | ||
Line 107: | Line 111: | ||
5. The results of these calculations will automatically populate the PCA graphs. If these aren't already displayed, click [[Image:I3D_PCAShowGraphs.png|20px]] <b>Show PCA Graphs</b> in the [[Image:I3D_PCAOptions2.png|30px]] <b>PCA Options</b> dropdown menu. Because the traces for each signal cluster around a distinctive mean value, almost all of the variance in these groups can be captured by a single principal component. | 5. The results of these calculations will automatically populate the PCA graphs. If these aren't already displayed, click [[Image:I3D_PCAShowGraphs.png|20px]] <b>Show PCA Graphs</b> in the [[Image:I3D_PCAOptions2.png|30px]] <b>PCA Options</b> dropdown menu. Because the traces for each signal cluster around a distinctive mean value, almost all of the variance in these groups can be captured by a single principal component. | ||
[[Image: | [[Image:Inspect3D_Four_Plots_PCA_(Four_Subjects_Walking).png|800px]] | ||
==Export PCA Results== | ==Export PCA Results== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[Image: | [[Image:Inspect3D_Export_Results_Settings_PCA.png|400px|right]] Now that we have performed PCA, we have results to export. | ||
1. Click [[Image:I3DExportPCAResults.png|20px]] <b>Export Results</b> on the application toolbar. | 1. Click [[Image:I3DExportPCAResults.png|20px]] <b>Export Results</b> on the application toolbar. |
Latest revision as of 11:20, 22 May 2024
Language: | English • français • italiano • português • español |
---|
This tutorial will show you how to export the results of your analysis. This allows users to report specific signals, metrics, or events from a data set and to share results from analysis conducted within Inspect3D.
Data
This tutorial uses overground walking data from four subjects. The subjects walked at three different speeds: slow, normal and fast. The data was processed using a pipeline with automatic event detection and link model based item calculations (most notably the knee joint angles). [Four Subjects Walking Data Set].
This tutorial also uses query definitions that have been previously saved in a .q3d file. [AnkleAngles.q3d].
Load the library
As with previous tutorials, we begin by loading the library and defining the queries relevant to our question.
1. Click Load Library in the toolbar to open the Load Library dialog.
2. Click Browse and select the folder where the data is stored.
3. Click Load button to import the data.
Load queries and compute groups
For this tutorial we will load previously saved query definitions and use them to calculate our specific groups.
1. Click on the Query Definitions icon on the toolbar and then click on Load Query Def & Compute Groups.
2. Select the AnkleAngles.q3d file with the saved query definitions and Open them.
Three groups will now appear in the Groups list: ANKLE_ANGLE_X, ANKLE_ANGLE_Y, and ANKLE_ANGLE_Z. Clicking on any of the groups will show that each of the four workspaces is associated with that group.
Visualize the groups
Export Graphs
Export Signals to Text
Perform PCA
In order to export Principal Component Analysis (PCA)results, we have to first calculate the PCA results! For a full overview of how to perform PCA and interpret some of the results, see the tutorial.
1. Ensure that all groups and workspaces are selected in the Groups and Workspaces lists.
2. Open the PCA Options dropdown menu on the toolbar.
3. Set Number PCs to 4 and ensure that Use Workspace Mean is checked.
5. The results of these calculations will automatically populate the PCA graphs. If these aren't already displayed, click Show PCA Graphs in the PCA Options dropdown menu. Because the traces for each signal cluster around a distinctive mean value, almost all of the variance in these groups can be captured by a single principal component.
Export PCA Results
Recap
In this tutorial you learned how to export the traces visualized in Inspect3D to common image formats. You also learned how to export three types of data to text: Signals, Metrics, and PCA Results.