NAME

       stilts-tmultin - Writes multiple processed tables to single container file

SYNOPSIS

       stilts tmultin [nin=<count>] [ifmtN=<in-format>] [inN=<tableN>] [icmdN=<cmds>] [out=<out-file>]
                      [ofmt=<out-format>]

DESCRIPTION

       tmultin takes multiple input tables and writes them to a single output container file. The container file
       must be of some format which can contain more than one table, for instance a FITS file (which can contain
       multiple extensions) or a VOTable document  (which  can  contain  multiple  TABLE  elements).  Individual
       filtering  may  be  performed  on  the  tables  prior to writing them, and their formats may be specified
       individually. If you want to apply the same pre-processing to all the input  tables,  you  may  find  the
       tmulti command more convenient.

OPTIONS

       nin=<count>
              The  number of input tables for this task. For each of the input tables N there will be associated
              parameters ifmtN, inN and icmdN.

       ifmtN=<in-format>
              Specifies the format of input table #N as specified by parameter inN. The known formats are listed
              in  SUN/256. This flag can be used if you know what format your table is in. If it has the special
              value (auto) (the default), then an attempt will be  made  to  detect  the  format  of  the  table
              automatically.  This  cannot always be done correctly however, in which case the program will exit
              with an error explaining which formats were attempted.

       inN=<tableN>
              The location of input table #N. This may take one of the following forms:

                * A filename.

                * A URL.

                * The special value "-", meaning standard input. In this case the input  format  must  be  given
                  explicitly using the ifmtN parameter. Note that not all formats can be streamed in this way.

                * A  system command line with either a "<" character at the start, or a "|" character at the end
                  ("<syscmd" or "syscmd|"). This executes the given pipeline and reads from its standard output.
                  This will probably only work on unix-like systems.
               In  any case, compressed data in one of the supported compression formats (gzip, Unix compress or
              bzip2) will be decompressed transparently.

       icmdN=<cmds>
              Specifies processing to be performed on input table #N as specified by parameter inN,  before  any
              other  processing  has  taken  place.  The  value  of  this parameter is one or more of the filter
              commands described in SUN/256. If more than one is given, they  must  be  separated  by  semicolon
              characters  (";"). This parameter can be repeated multiple times on the same command line to build
              up a list of processing steps. The sequence of commands given in this way defines  the  processing
              pipeline which is performed on the table.

              Commands may alteratively be supplied in an external file, by using the indirection character '@'.
              Thus a value of "@filename" causes the file filename to be read for a list of filter  commands  to
              execute.  The  commands  in the file may be separated by newline characters and/or semicolons, and
              lines which are blank or which start with a '#' character are ignored.

       out=<out-file>
              The location of the output file. This is usually a filename to write to. If it  is  equal  to  the
              special value "-" the output will be written to standard output.

       ofmt=<out-format>
              Specifies  the  format  in  which  the output tables will be written (one of the ones in SUN/256 -
              matching is case-insensitive and you can use just the first few letters). If it  has  the  special
              value  "(auto)" (the default), then the output filename will be examined to try to guess what sort
              of file is required usually by looking at the extension. If it's not  obvious  from  the  filename
              what output format is intended, an error will result.

              Not  all  output formats are capable of writing multiple tables; if you choose one that is not, an
              error will result.

SEE ALSO

       stilts(1)

       If the package stilts-doc is installed, the full documentation SUN/256 is available in HTML format:
       file:///usr/share/doc/stilts-doc/sun256/index.html

VERSION

       STILTS version 3.2-debian

       This is the Debian version of Stilts, which lack the support of some file formats and network  protocols.
       For differences see
       file:///usr/share/doc/stilts/README.Debian

AUTHOR

       Mark Taylor (Bristol University)

                                                    Mar 2017                                   STILTS-TMULTIN(1)