Abstract
This is a draft version of the eventual reference manual for DAVE-ML syntax and markup. DAVE-ML syntax is specified by the DAVEfunc.dtd Document Type Definition file; the version number above refers to the version of the DAVEfunc.dtd.
DAVE-ML is an open standard, being developed by an informal team of members of the American Institute of Aeronautics and Astronautics (AIAA). Contact the editor above for more information or comments regarding further refinement of DAVE-ML.
Table of Contents
Added a quadraticSpline enum value to the interpolate attributes of the <independentVarPts> and <independentVarRef> elements in response to a request from Goeff Brian of DSTO; fixed typo in cubicSpline attribute string. Added reference to Wikipedia article on spline interpolation.
Added a classification attribute to the <reference> element; added a date attribute to the <modificationRecord> element, per suggestions by Geoff Brian of DSTO.
Added two-D and three-D ungridded table examples and figures; corrected typo on ungridded table definition syntax (thanks to Dr. Peter Grant of U. Toronto's UTIAS and Geoff Brian of Australia's DSTO).
Reintroduced <!ENTITY> to include MathML2 DTD (complete) in body of this DTD. This entity definition quietly went away in version 1.6 due to a misunderstanding of proper way to include external DTDs; it is reintroduced to assist validating parsers.
Added <description> subelement to the <provenance> element, so the provenance entry can contain more information about change justification documents; made <provenance> or <provenanceRef> acceptable subelements to <variableDef> and <checkData> elements after a request from Geoff Brian of DSTO.
Renamed docID attribute to refID of the <modificationRecord> so the attribute name is consistent; docID attribute is deprecated but remains for compatibility with older documents.
Added <correlatesWith> and <correlation> subelements of <uncertainty> element to allow for multiple-dimensioned linear correlation of uncertainty of selected functions and variables.
Added a new element, <contactInfo>, to replace the single <address> element. This format supports multiple ways to indicate the means of contacting the author of a document or reference. <address> is deprecated but is retained for backwards compatibility. This element also replaces the email and xns attributes of <author>.
Fixed typographical error in <ungriddedTableRef> element: incorrect gtID attributed corrected to utID.
Allowed multiple <author> elements wherever one was allowed before.
Added a new tag, <isStdAIAA/>, to indicate a variableDef refers to one of the standard AIAA variables.
Removed <[un]griddedTable[Ref|Def]> subelements of the <confidenceBound> element since this leads to circular logic.
Changed SYSTEM ID to reflect new daveml.nasa.gov domain availability.
Removed e-mail URLs to protect privacy of individual contributors.
Added a new attribute, interpolate, to the <independentVarPts> element to indicate whether the table interpolation should be linear or cubic spline in the given dimension [modified to include quadratic in version 1.9].
Added a new tag, <isState/>, to indicate a variableDef refers to a state variable in the model.
Added a new tag, <isStateDeriv/>, to indicate a <variableDef> refers to a state derivative variable in the model.
Added <checkData> and associated elements. Added <description> subelement to <reference> element.
Added <uncertainty> element. Emphasized MathML content markup over presentation markup. Several grammatical and typographical errors fixed; added figure 1. Added ISO 8601 (Dates and Times) reference.
Added Bill Cleveland (NASA Ames' SimLab) and Brent York (NAVAIR's Manned Flight Simulator) to the acknowledgements section, to thank them for their pioneering initial trials of DAVE-ML.
Added <provenanceRef> element and changed all parents of <provenance> elements to be able to use a <provenanceRef> reference instead (these were <function>, <griddedTableDef> and <ungriddedTableDef>) to eliminate duplicate <provenance> elements.
Realization dawned that there was little difference between <griddedTable> and <griddedTableDef>s but the latter was more flexible (ditto <ungriddedTable> and <ungriddedTableDef>s). By making the gtID and utID attributes "implied" instead of "required," we can use the Def versions in both referenced-table and embedded-table <function>s. Thus the original <griddedTable> and <ungriddedTable> elements have been marked as "Deprecated." They are still supported in this DTD for backwards compatibility but should be avoided in future use; the easiest way to modify older DAVE-ML models would be to rename all <griddedTable>s as <griddedTableDef>s.
Fixed typos (thanks, Bill)!
Added <fileVersion> element to <fileHeader> element, so each version of a particular DAVEfunc model can be uniquely identified. Format of the version identifier is undefined.
Added an email attribute to the <author> element. The eXtensible Name Service (xns) standard doesn't appear to be catching on as rapidly as hoped, so a static e-mail link will have to do for now.
Added a mandatory varID attribute to both <independentVarPts> and <dependentVarPts> so these can be associated with an input and output signal name (<variableDef>), respectively.
Added an optional <extraDocRef> element to the <modificationRecord> element so more than one document can be associated with each modification event; if only one document needs to be referenced, use of the optional refID in the <modificationRecord> itself will suffice.
The editors would like to acknowledge the contributions, encouragement and helpful suggestions from Jon Berndt (Jacobs Sverdrup), Brent York (Indra), Bill Cleveland (NASA Ames), Geoff Brian (DSTO), J. Dana McMinn (NASA Langley) and Peter Grant (UTIAS).