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 fil‐
       tering may be performed on the tables prior to writing them, and their formats may be specified individu‐
       ally. If you want to apply the same pre-processing to all the input tables, you may find the tmulti  com‐
       mand 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 auto‐
              matically. This cannot always be done correctly however, in which case the program will exit  with
              an  error  explaining which formats were attempted. This parameter is ignored for scheme-specified
              tables.

       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 ex‐
                  plicitly using the ifmtN parameter. Note that not all formats can be streamed in this way.

                * A scheme specification of the form :<scheme-name>:<scheme-args>.

                * 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 com‐
              mands described in SUN/256. If more than one is given, they must be separated by semicolon charac‐
              ters (";"). 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 alternatively 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. A backslash character '\fR'
              at the end of a line joins it with the following line.

       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/sun256/index.html

VERSION

       STILTS version 3.5.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)