The usage of
stilts <stilts-flags> votlint ucd=true|false unit=true|false maxrepeat=<int-value> validate=true|false version=1.0|1.1|1.2|1.3|1.4 out=<location> [votable=]<location>If you don't have the
stiltsscript installed, write "
java -jar stilts.jar" instead of "
stilts" - see Section 3. The available
<stilts-flags>are listed in Section 2.1. For programmatic invocation, the Task class for this command is
Parameter values are assigned on the command line as explained in Section 2.3. They are as follows:
maxrepeat = <int-value>(Integer)
out = <location>(uk.ac.starlink.util.Destination)
ucd = true|false(Boolean)
ucdattributes on FIELD and PARAM elements etc are checked for conformance against the UCD1+ standard or a list of known UCD1 terms.
unit = true|false(Boolean)
unitattributes on FIELD and PARAM elements are checked for conformance against the VOUnits standard; if false, no such checks are made.
The VOTable 1.4 standard recommends use of VOUnits,
though there are some inconsistencies in the text on this topic.
Earlier VOTable versions refer to a different (CDS) unit syntax,
which is not checked by
So by default unit syntax is checked when the VOTable is 1.4
or greater, and not for earlier versions,
but that can be overridden by giving a
false value for this parameter.
The wording of the VOTable and VOUnit standards do not strictly require use of VOUnit syntax even at VOTable 1.4, so failed checks result in Warning rather than Error reports.
validate = true|false(Boolean)
votlint's own checks, it is validated against an appropriate version of the VOTable DTD which picks up such things as the presence of unknown elements and attributes, elements in the wrong place, and so on. Sometimes however, particularly when XML namespaces are involved, the validator can get confused and may produce a lot of spurious errors. Setting this flag false prevents this validation step so that only
votlint's own checks are performed. In this case many violations of the VOTable standard concerning document structure will go unnoticed.
version = 1.0|1.1|1.2|1.3|1.4(uk.ac.starlink.votable.VOTableVersion)
If no value is provided for this parameter (the default), the version will be determined from the VOTable itself.
votable = <location>(InputStream)