This file is docs/intro.txt in the ATD /code/cvs/dataspace module.

The source for the dataspace library is in src/dataspace.

src/ncdm contains a program to import models from netcdf into dataspace
xml.  Run it with no arguments to see usage info.  Here's an example:

cd src/ncdm
ln -s ../dataspace/dataspace.dtd
ncdm eldora /radars /code/granger/p3/src/ncdm/ncswp_TF*

The file eldora.xml will contain the xml for (much of) the eldora data
model in the netcdf file.

The dsgen program in src/dsgen loads a datamodel and writes out an example
class definition for a datastream generated from the datamodel.

cd src/dsgen
ln -s ../dataspace/dataspace.dtd
dsgen ../ncdm/eldora.xml /radars/eldora

The output from dsgen does not compile yet.

The documentation available so far is in the docs subdirectory.  The API
docs generated by doxygen can be browsed at docs/api/html/index.html,
or on the web:

	http://www.atd.ucar.edu/~granger/dataspace

The real root of the information tree is the Entity class, so that would be
one place to start in the API documentation.  However, at this point the
library can represent information and data models but its not doing much
with them yet, and so there's nothing about that in the API docs.  For
examples of using the API, see the test source files in src/tests and the
ncdm and dsgen programs.

The DTD for the dataspace is in the file src/dataspace/dataspace.dtd.  It's
not really very strict, just a general layout for the elements and their
content without any enforcement of order or number.  The current 'default'
dataspace is the file src/dataspace/dimensions.xml.  It has examples of
defining units, dimensions, and a few simple models, and examples of
deriving (prototyping) from the global entities through dataspace
references.  So far the best way I've found to browse the dataspace xml
files is with KDE Konqueror 3.x.  Choose Tools->Show DOM Tree when visiting
dimensions.xml to get a hierarchical element view.  There must be other
ways though.