Here are some examples of tcat
:
stilts tcat ifmt=ascii in=t1.txt in=t2.txt in=t3.txt out=table.txt
stilts tcat ifmt=ascii in="t1.txt t2.txt t3.txt" out=table.txt
stilts tcat ifmt=ascii in=@inlist.lis out=table.txt
stilts tcat in=@infits.lis out=gaia_source.colfits lazy=true countrows=true
lazy=true
is a good idea if there is a large number
of input files listed.
stilts tcat in=r368776.fits#1 in=r368776#2 in=r368776.fits#3 in=r368776.fits#4 out=r368776_all.fits
in=r368776.fits#{1,2,3,4}
".
stilts tcat in=r368776.fits multi=true out=r368776_all.fits
multi=true
means that instead of picking the first
table from each named in
table, all tables will be selected.
So, if the input FITS file in this example has just four table HDUs,
then this example does exactly the same as the previous one,
but with less typing.
The same thing works with multi-TABLE VOTable documents, but most other
file formats (CSV etc) do not have the facility for storing multiple
tables in a single file.
stilts tcat in=r368776.fits multi=true out=r368776_all.fits icmd=progress seqcol=ID
stilts tcat in='rA.csv rB.csv rC.csv' ifmt=csv \ icmd='keepcols "RA DEC FLUX"' icmd='sorthead 10 FLUX' \ ocmd='sort FLUX'
stilts tcat in=vizier.xml multi=true icmd='keepcols "ucd$RECORD ucd$POS_EQ_RA_MAIN ucd$POS_EQ_DEC_MAIN"' uloccol=TID out=all.csv