/usr/share/doc/stilts/sun256/tcatn-examples.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 | <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="tcopy.html">Next</a> <a href="tcatn-usage.html">Previous</a> <a href="tcatn.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tcopy.html">tcopy: Converts between table formats</a><br>
<b>Up: </b><a href="tcatn.html">tcatn: Concatenates multiple tables</a><br>
<b>Previous: </b><a href="tcatn-usage.html">Usage</a><br>
<hr>
<h3><a name="tcatn-examples">B.25.2 Examples</a></h3>
<p>Here are some examples of <code>tcatn</code>:
<dl>
<dt><strong><pre>
stilts tcatn nin=2 in1=obs1.fits in2=obs2.fits out=combined.fits
</pre></strong></dt>
<dd>Concatenates two similar observation catalogues to form a combined one.
In this case, both input and output tables are FITS files.
</dd>
<dt><strong><pre>
stilts tcatn nin=3 omode=stats in1=obs1.txt ifmt1=ascii
in2=obs2.xml ifmt2=votable
in3=obs3.fit ifmt3=fits
</pre></strong></dt>
<dd>Three catalogues with similar forms but in different data formats
are joined. Instead of writing the result to an output file,
the resulting joined catalogue is examined to calculate
its statistics, which are written to standard output.
</dd>
<dt><strong><pre>
stilts tcatn nin=2 in1=survey.vot.gz ifmt2=csv in2=more_data.csv
icmd1='addskycoords fk5 galactic RA2000 DEC2000 GLON GLAT' \
icmd1='keepcols "OBJ_ID GLON GLAT"' \
icmd2='keepcols "ident gal_long gal_lat"' \
loccol=FILENAME
omode=topcat
</pre></strong></dt>
<dd>In this case we are trying to concatenate results from two tables
which are quite dissimilar to each other. In the first place,
one is a VOTable (no <code>ifmt1</code> parameter is required since
VOTables can be detected automatically), and the other is a
comma-separated-values file (for which the <code>ifmt2=csv</code>
parameter must be given).
In the second place, the column structure of the two tables may be
quite different. By pre-processing the two tables using the
<code>icmd1</code> & <code>icmd2</code> parameters, we produce
in each case an input table which consists of three columns of
compatible types and meanings: an integer identifier and floating point
galactic longitude and latitude coordinates.
The second table contains such columns to start with,
but the first table requires an initial step to convert
FK5 J2000.0 coordinates to galactic ones.
<code>tcatn</code> joins the two doctored tables together, to produce
a table which contains only these three columns, with all the rows
from both input tables, and sends the result directly
to a new or running instance of TOPCAT.
An additional column named FILENAME is appended to the table
before sending it; this contains "survey.vot.gz" for all the columns
from the first table and "more_data.csv" for all the columns from
the second one.
</dd>
</dl>
</p>
<hr><a href="tcopy.html">Next</a> <a href="tcatn-usage.html">Previous</a> <a href="tcatn.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tcopy.html">tcopy: Converts between table formats</a><br>
<b>Up: </b><a href="tcatn.html">tcatn: Concatenates multiple tables</a><br>
<b>Previous: </b><a href="tcatn-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>
|