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.35.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