System properties are a way of getting information into the
Java runtime - they are a bit like environment variables.
There are two ways to set them when using STILTS: either
on the command line using arguments of the form
-Dname=value (see Section 3.2)
or in a file in your home directory named
.starjava.properties, in the form of a
Thus submitting the flag
-Dvotable.strict=trueon the command line is equivalent to having the following in your
# Force strict interpretation of the VOTable standard. votable.strict=true
The following system properties have special significance to STILTS:
true" if running the plotting tasks on a headless server. You only need to worry about this if you see error messages complaining about headlessness.
-diskflag has been specified (see Section 2.1).
reset()methods of some java
InputStreamclasses. These are rather common, including in Sun's J2SE system libraries. Use this if you are seeing errors that say something like "
Resetting to invalid mark". Currently defaults to "false".
disk" has basically the same effect as supplying the "
-disk" argument on the command line (see Section 2.1). Other possible values are "
sideways" and "
discard"; see SUN/252. The default is "
adaptive", which means storing smaller tables in memory, and larger ones on disk.
sun" (the default) or "
none". In most cases you are advised to leave this alone, but in the event of unmapping-related JVM crashes (not expected!), setting it to
none" (no namespacing, xmlns declarations in VOTable document will probably confuse parser), "
lax" (anything that looks like it is probably a VOTable element will be treated as a VOTable element) and "
strict" (VOTable elements must be properly declared in one of the correct VOTable namespaces). May also be set to the classname of a
uk.ac.starlink.votable.Namespacingimplementation. The default is "
truefor strict enforcement of the VOTable standard when parsing VOTables. This prevents the parser from working round certain common errors, such as missing
datatype="char". False by default.
1.2" or "
1.3". By default, version 1.3 VOTables are written.