B.42.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.