HAS-Motion Software Documentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Export Results ======
===== Dialog =====
Inspect3D's Export Results dialog contains three sections.

  - The **Export Settings File** section allows the user to load or save export settings so that they can be applied to future analysis.
  - The **Definition** section allows the user to define which results will be exported. There are three export types that can be defined: Signals, Metrics, and PCA Results.
  - The **Export Results Options** section allows the user to specify how the results will be exported. It is also possible to preview the export before saving it to text.

{{ :I3DExportDialog.png }}

==== Export Settings File ====

The **Export Settings File** section allows users to specify multiple export settings at once and to save these export settings to an .e3d file for reuse.

  * **Export Settings File**: Select an .e3d file from which to load export settings and save the current settings to the specified file.
  * **Export test files to folder and filenames**: Specify the folder where results files will be saved; add, remove, and rename individual results files.

==== Definition ====

The **Definition** section is where the user defines which data should be exported. This begins by specifying the type of export, either Signals, Metrics or PCA results, each of which gives the user further options. The user is also able to select which data to export: All Queried Data, All Plotted Data, Active Plot Data, or All Highlighted Data.


=== Signals ===

{{ :I3D_ExportResults_Definition_Signal.png}}

The Signals option exports previously defined waveforms. The user controls the Number of Points that will be used to normalize the data; the default setting is 101. The types of data that can be exported include both individual and group data as well as raw and processed data. The five options, including the header information for each export type, are:

  - **Group Mean:** Exports the normalized mean for the defined group (a group corresponds to a single query). The exported file will contain the normalized mean for each group. The normalized mean for each workspace is taken, and mean is taken across the workspace means.
  - **Group Std. Dev.:** Exports the standard deviation for the group using the mean workspace curves as the input data (ie. N = the number of workspaces/CMZ files contained within the group). The normalized mean for each workspace is taken, and the standard deviation is taken across the workspace means.
  - **Workspace Mean:** Exports the normalized mean data for each workspace in each of the groups.
  - **Workspace Std. Dev.:** Exports the standard deviation for each workspace in each of the groups.
  - **All Sequences (Normalized)**: Exports the normalized data for each trace for every workspace in each of the groups.
    - **Events (Normalised)**: This option becomes visible when **All Sequences (Normalized)** is selected. It exports the normalized events that occur within this sequence (intermediate events). The data is normalized to the percentage of the signals.
  - **All Sequences (Time Based)**: Exports the time based (un-normalized) data for each trace for every workspace in each of the groups.
    - **Events (Original)**: This option becomes visible when **All Sequences (Time Based)** is selected. This exports the normalized (to 101 points) events that occur within this sequence.


=== Metrics ===

{{ :I3D_ExportResults_Definition_Metrics.png}}

The second export type is Metrics. This export type is useful when certain aspects of a waveform, such as the minimum or the maximum, are desired and not the entire waveform. The **Calculate results for** drop-down menu allows the user to specify whether these metrics should be calculated on the basis of Groups, Workspaces, or Instances. This is important since the interpretation of mean and standard deviation values changes depending on what these values represent.

  * If the 'Groups' option is selected then the chosen metrics are calculated for each workspace in the group using the mean waveform for each workspace as the input data. The mean value of these workspace-level metrics is then calculated and reported for the group.
  * If the 'Workspaces' option is selected then the chosen metrics are calculated for each workspace in the group using the mean waveform for each workspace as the input data.
  * If the 'Instances' option is selected then the chosen metrics are calculated for each trace in each of the group's workspaces, using the individual traces as input data.

The user can also specify which metrics to export:

  - **Mean**: Calculates and exports the mean value(s).
    - **Std. Dev.**: Calculates and exports the standard deviation about the selected metric.
  - **Min**: Calculates and exports the minimum value.
    - **Std. Dev.**: Calculates and exports the standard deviation about the minimum point.
    - **Event Point**: Calculates and exports the position(s) (index) of the minimum value.
  - **Max**: Calculates and exports the maximum value.
    - **Std. Dev.**: Calculates and exports the standard deviation about the maximum point.
    - **Event Point**: Calculates and exports the position(s) (index) of the minimum value.
  - **Add Metrics Columns**: Adds and removes additional columns of metrics to the export.
  - **Use normalized data to calculate metrics**: If checked, then the input data is normalized before calculating the specified metrics.

=== PCA Results ===

{{ :I3D_ExportResults_Definition_PCA.png}}

PCA Results allows the user to export results from [[Sift:Principal_Component_Analysis:Principal_Component_Analysis|Principal Component Analysis]] (PCA) calculations. PCA Results must exist before they can be exported.

  - **Subject Scores**: This exports the mean workspace scores for each group. The number of values exported is equal to the number of PCs selected.
  - **Group Scores**: This exports the mean group scores for each group. The number of values exported is equal to the number of PCs selected.
  - **Group Score Std. Dev**: This exports the standard error for each group. The number of points is equal to the number of PCs used in the analysis.
  - **Variance Explained**: This exports the variance explained (as a percentage of the total variance) by each principal component.
  - **Eigenvectors**: This exports the eigenvectors for each PC. The number of points exported is 101 and the number of signals depends on the number of PCs used in the analysis.
  - **Mean +/- 1 SD**: This exports the mean group score plus and minus one standard deviation for each group. The number of values exported is equal to the number of PCs selected.
  - **Mean +- 5 and 95%**: This exports the 5th and 95th percentile score for each group. The number of values exported is equal to the number of PCs selected.

==== Export Result Options ====

{{ :I3D_ExportResults_Options.png}}

The **Export Result Options** section allows the user to specify how the export should occur.
  - **Export Format**: Specifies the formatting for the text file. Options are:
    - [[Visual3D:Documentation:Definitions:File_Formats:Visual3D_ASCII_Format|Standard ASCII]], exports the signals in a row centric format.
    - Transposed ASCII, exports the signals in a column centric format.
    - SPSS ASCII, allows the exported file to be read by [[http://www.ibm.com/analytics/us/en/technology/spss/|SPSS]].
    - [[Visual3D:Documentation:Definitions:File_Formats:P2D_Format|P2D]], which is a legacy file format from the MOVE3D software application.
  - **Precision**: Specifies the number of digits after the decimal to include for the text file export. This preview is identical to the format of the file that will be exported.
  - **Generate Preview**: Populates the Table with a preview of the export results according to the dialog's current settings.
  - **Results File Name**: Allows the user to specify the path to the export results file.