User Tools

Site Tools


other:inspect3d:documentation:files:e3d_export_setting_file

Table of Contents

E3D Export Setting File

The .e3d file format is an method of storing Inspect3D export settings as XML, ensuring that they are both human- and machine-readable. Inspect3D allows users to save export settings from the Export Results dialog. Previously-saved export settings can also be loaded and used from this dialog.

Format

As an XML document, an .e3d file is made up of hierarchical elements that are demarcated by tags, indicated by the < and > characters. An element consists of a start tag, <elementname>, and end tag, </elementname>, and all of the characters in between. Alternatively, an element can be defined by a single tag, <elementname />.

Tags can also contain attributes in the name=“value” format, further describing the associated element.

1. The top-level element in an .e3d file is exportFiles. It contains one folderpath element, one or more exportFileelements, and one I3D_Info element.

2. The folderPath element has a single attribute, path which is the path to the folder to which all of the exported files will be saved.

3. The exportFile elements each describe a single exported file. These have a single attribute, name, which is the name of exported file. These also contain two elements: exportData and settings.

4. The exportData element records the position of the active plot, whether all groups and workspaces were selected, and provides a list of selected groups and a list of selected workspaces. This element is not read in when applying export settings again, but it provides a potentially useful record of the original export.

5. The settings element records the specific settings from the Export Results dialog. Only those settings from the active Export_Type will be included.

6. The I3D_Info element has a single attribute, version which is the version of Inspect3D used to create the .e3d file. This can be used for troubleshooting if the format of an .e3d file changes in the future.

DTD

Formally, an .e3d file respects the Document Type Definition (DTD):

<!DOCTYPE exportFiles [
  <!ELEMENT exportFiles (folderpath,exportFile+,I3D_Info)>
  <!ELEMENT folderpath ()>
  <!ATTLIST folderpath path CDATA #REQUIRED>
  <!ELEMENT exportFile (exportData,settings)>
  <!ELEMENT exportData ()>
  <!ATTLIST exportData col  CDATA #REQUIRED
    exportData row CDATA #REQUIRED
    exportData SelAllGrp CDATA #REQUIRED
    exportData SelAllWrkspc CDATA #REQUIRED
    exportData SelGrps CDATA #REQUIRED
    exportData SelWrspcs CDATA #REQUIRED
  >
  <!ELEMENT settings ()>
  <!ATTLIST settings Export_Type CDATA #REQUIRED
    settings Export_Data CDATA #REQUIRED
    settings Group_Mean CDATA #IMPLIED
    settings Group_StdDev CDATA #IMPLIED
    settings Wrksp_Mean CDATA #IMPLIED
    settings Wrkspc_StdDev CDATA #IMPLIED
    settings Normalized_Sequences CDATA #IMPLIED
    settings TimeBased_Sequences CDATA #IMPLIED
    settings Normalized_Events CDATA #IMPLIED
    settings Original_Events CDATA #IMPLIED
    settings Normalized_Points CDATA #IMPLIED
    settings Wrkspc_Scores CDATA #IMPLIED
    settings Group_Scores CDATA #IMPLIED
    settings Group_Scores_StdDev CDATA #IMPLIED
    settings Variance_Explained CDATA #IMPLIED
    settings Eigenvectors CDATA #IMPLIED
    settings Mean_1SD CDATA #IMPLIED
    settings Mean_5_and_95 CDATA #IMPLIED
    settings Calculate_metrics_for CDATA #IMPLIED
    settings Mean CDATA #IMPLIED
    settings StdDev CDATA #IMPLIED
    settings Min CDATA #IMPLIED
    settings Min_StdDev CDATA #IMPLIED
    settings Min_Event CDATA #IMPLIED
    settings Max CDATA #IMPLIED
    settings Max_StdDev CDATA #IMPLIED
    settings Max_Event CDATA #IMPLIED
    settings Add_Metrics_Column CDATA #IMPLIED
    settings Use_Normalized_Data CDATA #IMPLIED
    settings Precision CDATA #REQUIRED
    settings Export_Format CDATA #REQUIRED
  >
  <!ELEMENT I3D_Info ()>
  <!ATTLIST I3D_Info version CDATA #REQUIRED>
]>
other/inspect3d/documentation/files/e3d_export_setting_file.txt · Last modified: 2024/07/17 11:44 by sgranger