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

VERSION

       STILTS version 3.4.9-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)