Next Previous Up Contents
Next: tmultin: Writes multiple processed tables to single container file
Up: tmulti: Writes multiple tables to a single container file
Previous: Usage

B.39.2 Examples

Here are some examples of using tmulti:

stilts tmulti ifmt=ascii in=t1.txt in=t2.txt in=t3.txt
              ofmt=fits out=tables.fits
Takes the three named ASCII format tables and writes them into a multi-extension FITS file, as three separate BINTABLE HDUs. These tables do not need to be of the same shape or otherwise similar.
stilts tmulti ifmt=ascii in="t1.txt t2.txt t3.txt"
              ofmt=fits out=tables.fits
Does exactly the same as the previous example.
stilts tmulti ifmt=ascii in=@inlist.lis
              ofmt=fits out=tables.fits
This will have the same effect as the previous two examples if a file name "inlist.lis" in the current directory contains three lines, "t1.txt", "t2.txt" and "t3.txt".
stilts tmulti in=extract.fits multi=true out=extract.vot
This takes the table extensions from a multi-extension FITS file and writes them out as a multi-TABLE VOTable document. The multi=true setting is required, since this means that all the tables from the input file are used as input; if it was set false, only the first table HDU from the input file would be used.
stilts tmulti in=extract.fits multi=true out=extract.vot
              icmd='badval -999 *MAG'
Does the same as the previous example, but additionally replaces with a blank value occurrences of the value "-999" in columns whose name ends with "MAG" in any of the input tables before copying them.


Next Previous Up Contents
Next: tmultin: Writes multiple processed tables to single container file
Up: tmulti: Writes multiple tables to a single container file
Previous: Usage

STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note256
STILTS web page: http://www.starlink.ac.uk/stilts/
Author email: m.b.taylor@bristol.ac.uk
Mailing list: topcat-user@jiscmail.ac.uk