/usr/share/doc/stilts/sun256/secB.30.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 | <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="tmatch2.html">Next</a> <a href="tmatch1-usage.html">Previous</a> <a href="tmatch1.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmatch2.html">tmatch2: Crossmatches 2 tables using flexible criteria</a><br>
<b>Up: </b><a href="tmatch1.html">tmatch1: Performs a crossmatch internal to a single table</a><br>
<b>Previous: </b><a href="tmatch1-usage.html">Usage</a><br>
<hr>
<h3><a name="secB.30.2">B.30.2 Examples</a></h3>
<p>Here are some examples of using <code>tmatch1</code>:
<dl>
<dt><strong><pre>
stilts tmatch1 matcher=sky values="RA2000 DE2000" params=20 \
action=keep0 in=crowded.vot out=sparse.vot
</pre></strong></dt>
<dd>Copies an input catalogue "crowded.vot" to an output catalogue
"sparse.vot", but omitting any objects (rows) which are within 20 arcsec
of other objects. The output catalogue will contain no near neighbours.
</dd>
<dt><strong><pre>
stilts tmatch1 matcher=skyerr values="RA2000 DE2000 RADIUS*4" params=40 \
action=keep0 in=crowded.vot out=sparse.vot
</pre></strong></dt>
<dd>This is similar to the previous example, but uses the
<code>skyerr</code> matcher which determines the proximity threshold
on a row-by-row basis from values in the table - in this case 4 times
the value of the RADIUS column (this value must be in arc seconds).
The <code>params=40</code> value does not affect the result, but it
gives the algorithm an idea of the rough scale of object separation.
</dd>
<dt><strong><pre>
stilts tmatch1 matcher=3d values="XPIX YPIX ZPIX" params=10 action=identify \
in=state.fit ocmd='select GroupSize>3' out=groups3+.fit
</pre></strong></dt>
<dd>Uses the "3d" matcher to identify groups of objects
in terms of their proximity in a 3-dimensional Cartesian space,
with positions given by the XPIX, YPIX and ZPIX columns in the input table.
The <code>action=identify</code> parameter means that the input table
is written out with the same rows, but with additional columns indicating
which rows are associated with each other. One of these columns,
"GroupSize" gives the number of objects in each group.
The postprocessing filter <code>ocmd='select GroupSize>3'</code>
selects only those rows which are part of groups of three objects or
larger; singletons and pairs are discarded before writing the output file.
</dd>
<dt><strong><pre>
stilts tmatch1 matcher=sky values="ra dec" params=3 action=wide2 \
ocmd='keepcols "id_1 ra_1 dec_1 id_2 ra_2 dec_2"'
in=galaxy.fits out=binaries.txt ofmt=ascii
</pre></strong></dt>
<dd>Identifies pairs of objects within 3 arcsec of each other from an
input catalogue. Singles, and groups of three or more, will be
discarded. The output table generated is a double-width version of
the input table with pairs of objects next to each other on the same row.
Here, the <code>ocmd</code> post-processing filter discards all of the
columns except the identifiers and sky positions for each object.
The output is to a text file.
</dd>
</dl>
</p>
<hr><a href="tmatch2.html">Next</a> <a href="tmatch1-usage.html">Previous</a> <a href="tmatch1.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmatch2.html">tmatch2: Crossmatches 2 tables using flexible criteria</a><br>
<b>Up: </b><a href="tmatch1.html">tmatch1: Performs a crossmatch internal to a single table</a><br>
<b>Previous: </b><a href="tmatch1-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>
|