STILTS

Starlink Tables Infrastructure Library Tool Set


Latest (see Version History)

Version 3.0-1 released 13 November 2014

New: GBIN support
Experimental support is provided for reading the Gaia/DPAC GBIN file format. (If you don't know what that means, you can safely ignore it.)
New: tapskymatch
New command tapskymatch helps you do easy upload crossmatches to a remote TAP service.

Version 3.0 released 3 October 2014

New: New-style plotting commands
In this major release, five new plotting commands are added, which let you script all of TOPCAT v4's new-style plots. These are considerably more powerful than the (now deprecated) old STILTS plotting commands. See the new Plotting section of the manual. There's even a poster about it.
New: Programmatic invocation
Some changes have been made to the parameter system and a new Programmatic Invocation section has been added to the manual to facilitate calling STILTS tasks from external java code. This includes including live (resize/pan/zoom) visualisation components in third party application GUIs.


* What is STILTS?

The STIL Tool Set is a set of command-line tools based on STIL, the Starlink Tables Infrastructure Library. It deals with the processing of tabular data; the package has been designed for, but is not restricted to, astronomical tables such as object catalogues. Some of the tools are generic and can work with multiple formats (including FITS, VOTable, CDF, GBIN, CSV, SQL and ASCII), and others are specific to the VOTable format. In some ways, STILTS forms the command-line counterpart of the GUI table analysis tool TOPCAT. The package is robust, fully documented, and designed for efficiency, especially with very large datasets.

Facilities offered include:

A powerful and extensible expression language is used for specifying data calculations. These facilities can be put together in very flexible and efficient ways.

For tasks in which the data can be streamed, the size of table STILTS can process is effectively unlimited. For other tasks, tables of a few million rows usually do not present a problem.

STILTS is written in pure Java (J2SE1.5 or later), and can be run from the command line or from Jython, or embedded into java applications. It is released under the GPL.


* Commands

STILTS currently consists of twelve generic table processing commands:

five plotting commands (as well as three deprecated ones): two VOTable-specific commands: six Virtual Observatory/external data service access commands: two sky pixel-related commands: three SQL-specific commands: and three miscellaneous items:

See also the Commands by Category section of the manual.

More commands and facilities may be added in the future.


* Documentation

The STILTS documentatation is provided in the user document, SUN/256. This is available in the following formats:


* Mailing Lists

Two mailing lists exist for STILTS, TOPCAT and related software:

To subscribe, send a message with the Subject line "subscribe topcat-user" or "subscribe topcat-announce" to sympa@sympa.bristol.ac.uk, or use the Subscribe link on the pages linked above. Archives are available from those pages. There is a bit more information on the mailing list page.

If you have queries or support enquiries you are encouraged to send them to topcat-user. However, I'm still happy to answer mail directly to me if you prefer that.


* Downloads

The easiest way to download STILTS is from the following links:

The stilts.jar file contains all the classes required to run STILTS. If you run "java -jar stilts.jar" you will see a help message; on Unix you also have the choice of downloading the stilts script into the same directory and using that for convenience. For more details on invoking the tools, read SUN/256.

It is also possible to run STILTS commands against an installation of the full Starjava set or of TOPCAT (run "topcat -stilts ...") since the relevant classes are present in each case.

The current release of STILTS is v3.0-1, released 13 November 2014. The full Version History is available in the user document.


* Further Information

Products related to STILTS are:

STIL
Public API underlying the functions of STILTS
TOPCAT
Graphical user tool for interactive table manipulation

If you have any comments, questions, requests, bugs etc, please either post to the topcat-user list or contact me direct:

If you use this software in published work, then citing paper 2006ASPC..351..666T would be appreciated.

And finally...

Q: What do you get if you combine all the Starlink Java table handling applications?
A: TOPCAT STILTS.
Thanks to Proporta and Malcolm Currie for that.