Sift Tutorial: Export Results: Difference between revisions
m (Text replacement - "www.c-motion.com/download" to "www.has-motion.com/download") |
|||
(35 intermediate revisions by 2 users 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/FourSubjectsWalkingData.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 | ==Load the Library== | ||
As with previous tutorials, we begin by loading the library and defining the queries relevant to our question. | As with previous tutorials, we begin by loading the library and defining the queries relevant to our question. | ||
Line 22: | Line 22: | ||
3. Click <b>Load</b> button to import the data. | 3. Click <b>Load</b> button to import the data. | ||
==Load | ==Load Queries and Compute Groups== | ||
For this tutorial we will load previously saved query definitions and use them to calculate our specific groups. | For this tutorial we will load previously saved query definitions and use them to calculate our specific groups. | ||
Line 33: | Line 33: | ||
Three groups will now appear in the <b>Groups</b> list on the Explore page in Sift: 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. | Three groups will now appear in the <b>Groups</b> list on the Explore page in Sift: 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 | ==Visualize the Groups== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[Image:ExportTutPlots.png| | [[Image:ExportTutPlots.png|700px|right]] We can visualize the groups individually and collectively in different plots in the Queried Data area. For a full overview of how to visualize data, see the [tutorial]]. | ||
1. To start, make sure the plot type on the [[Sift_-_Explore_Page:_Plot_Controls|plot control panel]] is set to <b> Signal-Time Plot </b>. | 1. To start, make sure the plot type on the [[Sift_-_Explore_Page:_Plot_Controls|plot control panel]] is set to <b> Signal-Time Plot </b>. | ||
Line 45: | Line 45: | ||
4. Close the Show Options dialog. | 4. Close the Show Options dialog. | ||
5. With the top-left plot selected (this will be indicated with a light-grey border), select the ANKLE_ANGLE_X group, select all workspaces, and then plot | 5. With the top-left plot selected (this will be indicated with a light-grey border), select the ANKLE_ANGLE_X group, select all workspaces, and then plot all traces. | ||
5. Select the top-right plot and plot the raw sequences from the ANKLE_ANGLE_Y group's workspaces. | 5. Select the top-right plot and plot the raw sequences from the ANKLE_ANGLE_Y group's workspaces. | ||
Line 56: | Line 56: | ||
==Export Graphs== | ==Export Graphs== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[Image: | [[Image:ExportTutContext.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. | ||
Line 64: | Line 64: | ||
3. Click <b>Save</b>. | 3. Click <b>Save</b>. | ||
[[ | [[image:ExportTutContext2.png]] | ||
4. Alternatively, export all four graphs collectively by selecting [[Image:sift_export_graphs.png|20px]] <b>Export Graphs</b> on the [[Sift_-_Toolbar|toolbar]]. | 4. Alternatively, export all four graphs collectively by selecting [[Image:sift_export_graphs.png|20px]] <b>Export Graphs</b> on the [[Sift_-_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". | 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". | ||
[[image:ExportAllPlots.png]] | |||
</div> | </div> | ||
==Export | ==Export Data to Text== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[Image: | [[Image:ExportTextResults.png|right]] Alternatively, we can export our signal data to a text format. | ||
1. Click [[Image:sift_export_results.png|20px]] <b>Export Results</b> on the application toolbar. | 1. Click [[Image:sift_export_results.png|20px]] <b>Export Results</b> on the application toolbar. | ||
2. In the Export Results dialog's <b>Definition</b> section, set the <b>Export Type</b> to | 2. In the Export Results dialog's <b>Definition</b> section, set the <b>Export Type</b> to Data, the <b>Input Data</b> to All Queried Data, and select both <b>Workspace Mean</b> and Workspace Std. Dev.</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>. | 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>. | ||
Line 85: | Line 87: | ||
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. | ||
==Export | ==Export Summary Statistics to Text== | ||
We can also export metrics based on the data to a text format. | We can also export metrics based on the data to a text format. | ||
1. Returning to the Export Results dialog's <b>Definition</b> section, set the <b>Export Type</b> to | 1. Returning to the Export Results dialog's <b>Definition</b> section, set the <b>Export Type</b> to Summary Statistics, set <b>Calculate results for</b> to Workspaces, and select both <b>Minimum</b> and <b>Maximum</b>. | ||
2. In the Export Results dialog's <b>Export Result Options</b> section, click <b>Generate Preview</b>. For each signal group, we can see that the table contains each workspace's minimum mean value and maximum mean value. | 2. In the Export Results dialog's <b>Export Result Options</b> section, click <b>Generate Preview</b>. For each signal group, we can see that the table contains each workspace's minimum mean value and maximum mean value. | ||
Line 103: | Line 105: | ||
==Perform PCA== | ==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 | 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 this [[Sift_Tutorial:_Perform_Principal_Component_Analysis|tutorial]]. | ||
[[Image:ExportResults-pca1.png|right]] | |||
1. Ensure that all groups and workspaces are selected in the <b>Groups</b> and <b>Workspaces</b> lists. | 1. Ensure that all groups and workspaces are selected in the <b>Groups</b> and <b>Workspaces</b> lists. | ||
2. Open the [[Image:sift_run_pca.png|30px]] <b>PCA | 2. Open the [[Image:sift_run_pca.png|30px]] <b>Run PCA</b> dialog on the [[Sift_-_Toolbar|toolbar]]. | ||
3. Set <b>Number PCs</b> to 4 and ensure that <b>Use Workspace Mean</b> is checked. | 3. Set <b>Number PCs</b> to 4 and ensure that <b>Use Workspace Mean</b> is checked. | ||
Line 113: | Line 115: | ||
4. Click <b>Run PCA</b>. | 4. Click <b>Run PCA</b>. | ||
5. | 5. A summary of the PCA results will appear in the PCA dialog, and the results of these calculations will automatically populate the PCA graphs on the [[Sift - Analyse Page|Analysis Page]]. 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:Sift_PCA_Export.png|800px]] | ||
==Export PCA Results== | ==Export PCA Results== | ||
<div style="overflow: hidden"> | <div style="overflow: hidden"> | ||
[[Image: | [[Image:Sift_PCA_Export2.png|400px|right]] Now that we have performed PCA, we have results to export. | ||
1. Click [[Image:sift_export_results.png|20px]] <b>Export Results</b> on the application toolbar. | 1. Click [[Image:sift_export_results.png|20px]] <b>Export Results</b> on the application toolbar. | ||
Line 129: | Line 131: | ||
4. Click <b>Generate Preview</b>. We can see that each signal's Group PC Score Mean and Standard Deviation is shown for each of the selected principal components and that the variance explained is shown for all computed principal components. Note here that each row in the export table is now a principal component and not a normalized time point as for the other export types. Also note that Inspect3D does have the ability to export information about all of the principal components that were calculated, not only the ones that were selected. | 4. Click <b>Generate Preview</b>. We can see that each signal's Group PC Score Mean and Standard Deviation is shown for each of the selected principal components and that the variance explained is shown for all computed principal components. Note here that each row in the export table is now a principal component and not a normalized time point as for the other export types. Also note that Inspect3D does have the ability to export information about all of the principal components that were calculated, not only the ones that were selected. | ||
</div> | </div> | ||
==Exporting SPM, Curve Registration, and DTW Results== | |||
All tools that are available on the analysis page produce results and graphs that can be exported by the two exporting dialogs presented in this tutorial. Various definitions and settings for the exporting options are available for each particular analysis type. The following images present the three remaining exporting settings for [[Sift - Statistical Parametric Mapping|SPM]], [[Sift - Curve Registration|Curve Registration]], and [[Sift - Dynamic Time Warping|DTW]]. | |||
[[image: ExportSPM2.png|350px]] [[image:ExportRegistered.png|300px]] [[image:ExportDTW2.png|350px]] | |||
==Recap== | ==Recap== | ||
In this tutorial you learned how to export the traces visualized in Sift to common image formats. You also learned how to export three types of data to text: Signals, Metrics, and PCA Results. | In this tutorial you learned how to export the traces visualized in Sift to common image formats. You also learned how to export three types of data to text: Signals, Metrics, and PCA Results. In addition, you learned that any analysis method can be exported to text files or images. | ||
==Navigate Tutorials== | ==Navigate Tutorials== |
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 Sift.
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 Builder icon on the toolbar and then click on Load Query Definitions.
2. Select the AnkleAngles.q3d file with the saved query definitions and Open them.
3. Select Calculate All Queries.
Three groups will now appear in the Groups list on the Explore page in Sift: 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 Data 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 this tutorial.
1. Ensure that all groups and workspaces are selected in the Groups and Workspaces lists.
2. Open the Run PCA dialog on the toolbar.
3. Set Number PCs to 4 and ensure that Use Workspace Mean is checked.
4. Click Run PCA.
5. A summary of the PCA results will appear in the PCA dialog, and the results of these calculations will automatically populate the PCA graphs on the Analysis Page. 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
Exporting SPM, Curve Registration, and DTW Results
All tools that are available on the analysis page produce results and graphs that can be exported by the two exporting dialogs presented in this tutorial. Various definitions and settings for the exporting options are available for each particular analysis type. The following images present the three remaining exporting settings for SPM, Curve Registration, and DTW.
Recap
In this tutorial you learned how to export the traces visualized in Sift to common image formats. You also learned how to export three types of data to text: Signals, Metrics, and PCA Results. In addition, you learned that any analysis method can be exported to text files or images.