/usr/share/doc/stilts/sun256/tmatchn.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>tmatchn: Crossmatches multiple tables using flexible criteria</title>
</head>
<body>
<hr>
<a href="tmatchn-usage.html">Next</a> <a href="secB.31.2.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmatchn-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="secB.31.2.html">Examples</a><br>
<hr>
<hr>
<h2><a name="tmatchn">B.32 <code>tmatchn</code>: Crossmatches multiple tables using flexible criteria</a></h2>
<p><code>tmatchn</code> performs efficient and flexible crossmatching
between multiple tables.
It can match rows on the basis of their relative position in the sky,
or alternatively using many other criteria such as separation in
in some isotropic or anisotropic Cartesian space,
identity of a key value, or some combination of these;
the full range of match criteria is dicussed in <a href="MatchEngine.html">Section 7.1</a>.
</p>
<p>Since the match criteria define what counts as a match between two
objects, it is not immediately obvious what is meant by a multi-table
match. In fact the command can work in one of two distinct modes,
controlled by the <code>multimode</code> parameter.
In <code>pairs</code> mode, one table (by default the first input table)
is designated the reference table, and pair matches between each of the
other tables and that one are identified.
In <code>group</code> mode groups of objects from all the input tables are
identified, as discussed in <a href="matchGroup.html">Section 7.2</a>.
Currently, in both cases an output matched row cannot contain more
than one object from each input table.
Options for output of multiple rows per input table per match may be
forthcoming in future releases if there is demand.
</p>
<p><code>tmatchn</code> is intended for use with more than two input tables -
see <a href="tmatch1.html"><code>tmatch1</code></a>
and <a href="tmatch2.html"><code>tmatch2</code></a>
for 1- and 2-table crossmatching respectively.
</p>
<ul>
<li><a href="tmatchn-usage.html">B.32.1 Usage</a></li>
<li><a href="secB.32.2.html">B.32.2 Examples</a></li>
</ul>
<hr><a href="tmatchn-usage.html">Next</a> <a href="secB.31.2.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="tmatchn-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="secB.31.2.html">Examples</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>
|