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>
]>
