Next Previous Up Contents
Next: Output Formats
Up: Table Formats
Previous: Table Formats

3.1 Input Formats

Some of the tools in this package ask you to specify the format of input tables using the -f or -ifmt flag. The following list gives the values usually allowed for this (matching is case-insensitive):

fits
FITS format - FITS binary or ASCII tables can be read. By default the first table HDU in the file will used, but this can be altered by supplying the HDU index after a '#' sign, so "table.fits#3" means the third HDU extension.
votable
VOTable format - any legal, and many illegal 1.0 or 1.1 format VOTable document can be read. By default the first TABLE element is used, but this can be altered by supplying the 0-based index after a '#' sign, so "table.xml#4" means the fifth TABLE element in the document.
ascii
Plain text file with one row per column in which columns are separated by whitespace.
csv
Comma-Separated Values format, using approximately the convensions used by MS Excel.
wdc
World Datacentre Format (experimental).
For more details on these formats, see the descriptions in SUN/252.

In some cases (when using VOTable or FITS format tables) the tools can detect the table format automatically, and no explicit specification is necessary. If this isn't the case and you omit the format specification, the tool will fail with a suitable error message. It is always safe to specify the format explicitly, and may lead to more helpful error messages in the case that the table can't be read correctly.


Next Previous Up Contents
Next: Output Formats
Up: Table Formats
Previous: Table Formats

STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note 256
STILTS web page: http://www.starlink.ac.uk/stilts/
Author email: m.b.taylor@bristol.ac.uk