System properties are a way of getting information into Java (they are the Java equivalent of environment variables). The following ones have special significance within TOPCAT:
truefor TOPCAT, so menus mostly appear at the top of the screen (though it's not true to say that TOPCAT obeys the Mac look and feel completely); if you prefer the more Java-like look and feel, set it to
https.proxyHostetc. See the appropriate java documentation (e.g. by googling for "http.proxyHost") for details.
/tmpon Unix), so if working with large unmapped (e.g. CSV) tables on a machine with limited space on the default disk, it may be necessary to change it.
-exthubflag or from the GUI). The value is a comma-separated list of profile specifiers; options are "
std" for Standard Profile, "
web" for Web Profile or the name of a class implementing the
org.astrogrid.samp.hub.HubProfileinterface. The default setting runs just a Standard Profile hub, but, for instance, setting it to "
std,web" would run a Web Profile as well. Note you should include
stdin the list, otherwise TOPCAT will not be able to talk to the hub. See the JSAMP documentation for more detail.
127.0.0.1". However, if this property is set (presumably to the local host's fully- or partly-qualified domain name) its value will be used instead. Two special values may also be set: "
[hostname]" for the host's fully qualified domain name, and "
[hostnumber]" for the IP number.
xml-log" or "
rpc-log" then all XML-RPC communications will be logged in very or fairly verbose terms respectively to standard output. The classname of an
org.astrogrid.samp.xmlrpc.XmlRpcKitimplementation may be given instead to use a custom implementation.
1.0 1.0 0.0 1.0 0.0 1.0would give a colour map that fades from yellow to magenta. Any number of samples may be given; the scale is interpolated.
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".
If these properties are not set, then on encountering a 401 in the application will pop up a dialogue window asking for username and password.
uk.ac.starlink.connect.Connectorinterface which specifies how you can log on to such a service and provides a hierarchical view of the filespace it contains.
uk.ac.starlink.table.gui.TableLoadDialoginterface and naming them in this property. See STIL documentation for more detail.
uk.ac.starlink.table.TableSchemeinterface, and must have a no-arg constructor. The schemes thus named will be available alongside the standard ones listed in Section 4.3.
disk" has basically the same effect as supplying the "
-disk" argument on the TOPCAT command line (see Section 10.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), "
unsafe" 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
uk.ac.starlink.topcat.activate.ActivationTypeinterface, and which has a no-arg constructor.
uk.ac.starlink.topcat.TopcatToolActioninterface and have a no-arg constructor. The actions corresponding to any such classes will be added to toolbar. This is an experimental extensibility feature, which may be modified or withdrawn in a future release.
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 "
PARAMelement with a
unicodeChar, and no
arraysizeattribute. The VOTable standard says this indicates a single character, but some VOTables omit arraysize specification by accident when they intend
true, a missing arraysize will be interpreted as meaning a single character, and if
false, it will be interpreted as a variable-length array of characters (a string). The default is
1.3" or "
1.4". By default, version 1.4 VOTables are written.
To define these properties on the command line
you use the
-D flag, which has the form
-D<property-name>=<value>If you're using the TOPCAT startup script, you can write something like:
topcat -Djdbc.drivers=org.postgresql.Driver ...or if you're using the
java -Djdbc.drivers=org.postgresql.Driver ...
Alternatively you may find it more convenient to
write these definitions in a file named
.starjava.properties in your home directory; the above
command-line flag would be equivalent to inserting the line: