/usr/share/doc/stilts/sun256/secB.24.2.html is in stilts-doc 3.1.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Examples</title>
</head>
<body>
<hr>
<a href="tcatn.html">Next</a> <a href="tcat-usage.html">Previous</a> <a href="tcat.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tcatn.html">tcatn: Concatenates multiple tables</a><br>
<b>Up: </b><a href="tcat.html">tcat: Concatenates multiple similar tables</a><br>
<b>Previous: </b><a href="tcat-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.24.2">B.24.2 Examples</a></h3>
<p>Here are some examples of <code>tcat</code>:
<dl>
<dt><strong><pre>
stilts tcat ifmt=ascii in=t1.txt in=t2.txt in=t3.txt out=table.txt
</pre></strong></dt>
<dd>Concatenates the three named ASCII format tables to produce
an output table. All three must have compatible numbers and types
of columns.
</dd>
<dt><strong><pre>
stilts tcat ifmt=ascii in="t1.txt t2.txt t3.txt" out=table.txt
</pre></strong></dt>
<dd>Has exactly the same effect as the previous example.
</dd>
<dt><strong><pre>
stilts tcat ifmt=ascii in=@inlist.lis out=table.txt
</pre></strong></dt>
<dd>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".
</dd>
<dt><strong><pre>
stilts tcat in=r368776.fits#1 in=r368776#2 in=r368776.fits#3 in=r368776.fits#4
out=r368776_all.fits
</pre></strong></dt>
<dd>Concatenates the contents of four tables (the first four extension HDUs)
from a multi-extension FITS file to produce a single FITS table.
Many Unix shells (csh, bash) will allow you to list the input files
using the following shorthand: "<code>in=r368776.fits#{1,2,3,4}</code>".
</dd>
<dt><strong><pre>
stilts tcat in=r368776.fits multi=true out=r368776_all.fits
</pre></strong></dt>
<dd>Concatenates all the tables in the named file together.
Setting <code>multi=true</code> means that instead of picking the first
table from each named <code>in</code> 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.
</dd>
<dt><strong><pre>
stilts tcat in=r368776.fits multi=true out=r368776_all.fits
icmd=progress seqcol=ID
</pre></strong></dt>
<dd>Does the same as the previous example with a couple of additions.
Firstly, progress through each of the input files will be reported
to the console.
Secondly, an additional column "ID" will be appended to the output which
contains 1 for all the rows from the first input table, 2 for the
rows from the second one and so on.
</dd>
<dt><strong><pre>
stilts tcat in='rA.csv rB.csv rC.csv' ifmt=csv \
icmd='keepcols "RA DEC FLUX"' icmd='sorthead 10 FLUX' \
ocmd='sort FLUX'
</pre></strong></dt>
<dd>Takes the 10 rows with highest FLUX values from each of three input
tables (in comma-separated value format) and joins them together to
produce a 30-row output table. This is then sorted in FLUX order,
and the resulting table is output to the console in text format.
Only the columns RA, DEC and FLUX are output; any other columns
are discarded. The input tables don't need to have identical forms
to each other, but each must have at least an RA, DEC and FLUX column.
</dd>
<dt><strong><pre>
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
</pre></strong></dt>
<dd>This processes a VOTable file which may have multiple TABLEs in it,
but for which each of the tables is known to have columns with the
UCDs RECORD, POS_EQ_RA_MAIN and POS_EQ_DEC_MAIN (this is typical of
VOTables retrieved from CDS's VizieR service).
It retains only those columns from each table and writes the result
as a single concatenated table to a CSV file.
</dd>
</dl>
</p>
<hr><a href="tcatn.html">Next</a> <a href="tcat-usage.html">Previous</a> <a href="tcat.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tcatn.html">tcatn: Concatenates multiple tables</a><br>
<b>Up: </b><a href="tcat.html">tcat: Concatenates multiple similar tables</a><br>
<b>Previous: </b><a href="tcat-usage.html">Usage</a><br>
<hr><i>STILTS - Starlink Tables Infrastructure Library Tool Set<br>Starlink User Note256<br>STILTS web page:
<a href="http://www.starlink.ac.uk/stilts/">http://www.starlink.ac.uk/stilts/</a><br>Author email:
<a href="mailto:m.b.taylor@bristol.ac.uk">m.b.taylor@bristol.ac.uk</a><br>Mailing list:
<a href="mailto:topcat-user@jiscmail.ac.uk">topcat-user@jiscmail.ac.uk</a><br></i></body>
</html>
|