diff options
| -rwxr-xr-x | doc/html/XML_DTD/DesignNotes.html | 39 |
1 files changed, 26 insertions, 13 deletions
diff --git a/doc/html/XML_DTD/DesignNotes.html b/doc/html/XML_DTD/DesignNotes.html index 3085b46..d27c7d3 100755 --- a/doc/html/XML_DTD/DesignNotes.html +++ b/doc/html/XML_DTD/DesignNotes.html @@ -12,18 +12,21 @@ </font> <a href="http://hdf.ncsa.uiuc.edu/DTDs/HDF5-File.dtd"><font size=-1 face=courier>HDF5-File.dtd</font></a> + <h2> The XML DTD for HDF5: Design Notes</h2> -April 28, 2000 +June 12, 2000 +<br>Feedback to: <a href="mailto:hdfdev@ncsa.uiuc.edu">hdfdev@ncsa.uiuc.edu</a> <h3> <b>1. Introduction</b></h3> -The XML "Document Type Definition" (DTD) [17] for HDF5 is a markup language -to describe the contents of an HDF5 file.[<a href="#R1">1</a>] This -DTD specifies a standard for using XML to describe the structure and contents -of a <i>single</i> HDF5 file. The DTD can be used in a variety of -ways, by standard software and by application specific software that builds -on standard XML features. The DTD will enable descriptions of HDF5 -files to be used with and translated to other similar XML markup languages. +The XML "Document Type Definition" (DTD) [<a href="#R17">17</a>] for HDF5 +is a markup language to describe the contents of an HDF5 file.[<a href="#R1">1</a>] +This DTD specifies a standard for using XML to describe the structure and +contents of a <i>single</i> HDF5 file. The DTD can be used in a variety +of ways, by standard software and by application specific software that +builds on standard XML features. The DTD will enable descriptions +of HDF5 files to be used with and translated to other similar XML markup +languages. <p>This document discusses some of the key features of the HDF5 DTD, and some of the design decisions that were considered during its development. <p>The HDF5 data model is somewhat complex, with a great deal of flexibility @@ -311,7 +314,8 @@ makes no sense according to the rules of HDF5, and those rules must be enforced by the applications that create and use the XML description. <p><b>3.3 The Data Values</b> <p>While representing metadata with XML was fairly straightforward, it -was less obvious what should be done with the data values. For different +was +less obvious what should be done with the data values. For different purposes, it may be better to: <ul> <li> @@ -362,6 +366,12 @@ specified. file for the first release. The initial version of the DTD has a limited <tt><Data> </tt>element, which does not support all the desired features. This will be revised in a future release. +<p>We were not able to create a satisfactory markup for data in the HDF5 +file for the first release. The initial version of the DTD has a limited +<tt><Data></tt> +element, which does not support all the desired features. Details of this +limited <tt><Data></tt> element can be found in [<a href="#R18">18</a>]. +This will be revised in a future release. <p><b>3.4 File Format Details</b> <p>The DTD must be able to support applications that need to fully describe the details of a specific HDF5 file. For example, in order to verify @@ -437,17 +447,20 @@ These elements are only partly defined in the first release of the DTD. Definition Language (ODL) Specification and Usage", <a href="http://pds.jpl.nasa.gov/stdref/chap12.htm">http://pds.jpl.nasa.gov/stdref/chap12.htm</a></li> <li> -<a NAME="R14"></a>SAX 1.0: The Simple API for XML, -<a href="http://www.megginson.com/sAX/index.html">http://www.megginson.com/sAX/index.html</a></li> +<a NAME="R14"></a>SAX 1.0: The Simple API for XML, <a href="http://www.megginson.com/sAX/index.html">http://www.megginson.com/sAX/index.html</a></li> <li> -<a NAME="R15"></a> Document Object Model (DOM), <a href="http://www.w3.org/DOM/">http://www.w3.org/DOM/</a></li> +<a NAME="R15"></a>Document Object Model (DOM), <a href="http://www.w3.org/DOM/">http://www.w3.org/DOM/</a></li> <li> -<a NAME="R16"></a> OpenGIS, <a href="http://opengis.org/">http://opengis.org/</a></li> +<a NAME="R16"></a>OpenGIS, <a href="http://opengis.org/">http://opengis.org/</a></li> <li> <a NAME="R17"></a>XML, <a href="http://www.w3.org/XML">http://www.w3.org/XML</a></li> + +<li> +<a NAME="R18"></a>Mike Folk, "Proposal for representing simple data in +HDFXML DTD", <a href="XML_data_spec_Rev_3.pdf">http://hdf.ncsa.uiuc.edu/HDF5/XML/XML_data_spec_Rev_3.pdf</a></li> </ol> </body> |