Miscellaneous utilities for working with local data dictionaries in PDS4
The first utility is IngestLddView, which will convert an Ingest LDD file into files that are easier for a non-XML user to use and visualize.
You will need an XML stylesheet processor such xsltproc or saxon to transform your dictionary.
xsltproc is available at http://xmlsoft.org/XSLT/xsltproc2.html
Saxon is available at https://sourceforge.net/projects/saxon/files/Saxon-HE/9.8/
If you want to be able to visualize the dictionary, you will need Graphviz, which is available at https://www.graphviz.org/
Mitch Gordon at SETI has provided some additional notes on using IngestLDDView with windows.
You can download both stylesheets from GitHub. Unless you have GitHub experience, use the links below:
IngestLddView will convert an Ingest LDD file into a (more) human-readable html document.
This will include every class in the dictionary, starting from any class that has the element flag. From there, it will show nested classes and attributes. If the namespace prefix is correct, it will also show the XPath expression for each element, and the human readable description of the schematron rules for that element.
IngestLddView can be invoked with the following command
xsltproc IngestLddView.xsl [ingest ldd file] > [htmlfile]
or
saxon -xsl:IngestLddView.xsl -s:[ingest ldd file] -o:[htmlfile]
A graphviz companion to IngestLddView is IngestLddDot. This will convert an Ingest LDD file into a graphviz dot file, which can be used to quickly visualize the relationships between classes, as well as find problems such as orphaned classes, attributes or rules. IngestLDDDot is invoked the same way as IngestLDDView:
xsltproc IngestLddDot.xsl [ingest ldd file] > [dotfile]
or
saxon -xsl:IngestLddDot.xsl -s:[ingest ldd file] -o:[dotfile]
From there, your dot file can be converted to a graphical format.
For instance, to get a pdf, run:
dot -O -Tpdf [dotfile]
A UML companion to IngestLddView is IngestLddDot. This will convert an Ingest LDD file into a PlantUML file, which can be used to quickly visualize the relationships between classes. IngestLDDPlantUML is invoked the same way as IngestLDDView:
xsltproc IngestLddPlantUml.xsl [ingest ldd file] > [umlfile]
or
saxon -xsl:IngestLddPlantUml.xsl -s:[ingest ldd file] -o:[umlfile]
From there, your uml file can be converted to a graphical format.
For instance, to get an svg, run:
plantuml -tsvg [uml]
Need to add support for xs:any The output is not exactly attractive. Need to format it for easier comprehension.