/usr/share/doc/stilts/sun256/secB.32.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 | <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="tmulti.html">Next</a> <a href="tmatchn-usage.html">Previous</a> <a href="tmatchn.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmulti.html">tmulti: Writes multiple tables to a single container file</a><br>
<b>Up: </b><a href="tmatchn.html">tmatchn: Crossmatches multiple tables using flexible criteria</a><br>
<b>Previous: </b><a href="tmatchn-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.32.2">B.32.2 Examples</a></h3>
<p>Here are some examples of using <code>tmatchn</code>:
<dl>
<dt><strong><pre>
stilts tmatchn multimode=pairs nin=4 matcher=sky params=5 \
in1=transients.txt ifmt1=ascii values1='alpha delta' \
in2=2mass_virgo.fits values2='ra2000 dec2000' \
in3=sdss_virgo.fits values3='ra dec' \
in4=first_virgo.fits values4='pos_eq_ra pos_eq_dec' \
out=matches.xml ofmt=votable-binary
</pre></strong></dt>
<dd>Compares a text-format table "transients.txt" against each of
three other catalogues covering the same region of sky, and outputs
a table which contains a row for each row of "transients.txt" which
matches (is within 5 arcsec) of an object in any of the other tables.
</dd>
<dt><strong><pre>
stilts tmatchn multimode=pairs nin=4 matcher=sky params=5 \
in1=transients.txt ifmt1=ascii suffix1='_t' values1='alpha delta' \
in2=2mass_virgo.fits suffix2='_2mass' values2='ra2000 dec2000' \
in3=sdss_virgo.fits suffix3='_sdss' values3='ra dec' \
in4=first_virgo.fits suffix4='_first' values4='pos_eq_ra pos_eq_dec' \
fixcols=all join1=all \
ocmd='keepcols "*_t designation_2mass SDSSName_sdss id_field_first"' \
out=matches.xml ofmt=votable-binary
</pre></strong></dt>
<dd>Similar to the previous example but with some doctoring of what the
output table will look like. The <code>fixcols=all</code> and
<code>suffixN</code> assignments mean that all the columns from the
input tables will be renamed for output by adding the given suffixes.
The <code>keepcols</code> filter applied to the output table throws out
all the columns except the ones from the reference table (<code>*_t</code>)
and one column from each of the other table giving object identifiers.
This output table will probably be easier to read (though contain less
information) than that from the previous example).
Additionally, the <code>join1=all</code> assignment means that the output
table will have one row for each row of the reference table
(transients.txt), even if no matches are found for it.
</dd>
<dt><strong><pre>
stilts tmatchn multimode=group nin=3 matcher=skyerr params=8 \
in1=Hband.fits values='RA DEC SEEING*2' \
in2=Jband.fits values='RA DEC SEEING*2' \
in3=Kband.fits values='RA DEC SEEING*2' \
omode=topcat
</pre></strong></dt>
<dd>Performs a group-mode match. There is no reference table, so that
an output row will result for each object which is represented in any
two of the input catalogues.
The match takes account of per-object errors equivalent to twice the
recorded seeing, which is in the region of 8 arcsec.
Note that this may not operate as expected if the catalogues contain
multiple distinct objects too close (in comparison to the declared
separation) to each other.
The resulting matched table is sent directly to
<a href="http://www.starlink.ac.uk/topcat/">TOPCAT</a>
(if available).
</dd>
</dl>
</p>
<hr><a href="tmulti.html">Next</a> <a href="tmatchn-usage.html">Previous</a> <a href="tmatchn.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmulti.html">tmulti: Writes multiple tables to a single container file</a><br>
<b>Up: </b><a href="tmatchn.html">tmatchn: Crossmatches multiple tables using flexible criteria</a><br>
<b>Previous: </b><a href="tmatchn-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>
|