/usr/share/doc/stilts/sun256/EllipseCartesianMatchEngine.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>2d_ellipse:
Cartesian Matching of Elliptical Regions
</title>
</head>
<body>
<hr>
<a href="sec7.1.11.html">Next</a> <a href="ErrorCartesianMatchEngine.html">Previous</a> <a href="MatchEngine.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="sec7.1.11.html">Custom Matchers</a><br>
<b>Up: </b><a href="MatchEngine.html">Match Criteria</a><br>
<b>Previous: </b><a href="ErrorCartesianMatchEngine.html">1d_err, 2d_err, ...:
Cartesian Matching with Per-Object Errors</a><br>
<hr>
<h4><a name="EllipseCartesianMatchEngine">7.1.10 <code>2d_ellipse</code>:
Cartesian Matching of Elliptical Regions</a></h4>
<p><pre>matcher=2d_ellipse values*='<x> <y> <primary-radius> <secondary-radius>
<orientation-angle/degrees>'
params='<scale>'
tuning='<bin-factor>'</pre>
<blockquote>
<dl>
<dt><strong><code>values*</code>:</strong></dt>
<dd>
<ul>
<li><code>x</code>: X coordinate of centre
</li>
<li><code>y</code>: Y coordinate of centre
</li>
<li><code>primary-radius</code>: Length of ellipse semi-major axis
</li>
<li><code>secondary-radius</code>: Length of ellipse semi-minor axis
</li>
<li><code>orientation-angle/degrees</code>: Angle from X axis towards Y axis of semi-major axis
</li>
</ul>
</dd>
<dt><strong><code>params</code>:</strong></dt>
<dd>
<ul>
<li><code>scale</code>: Rough average of per-object error distance; just used for tuning in conjunction
with bin factor
</li>
</ul>
</dd>
<dt><strong><code>tuning</code>:</strong></dt>
<dd>
<ul>
<li><code>bin-factor</code>: Scaling factor to adjust bin size; larger values mean larger bins
</li>
</ul>
</dd>
</dl>
</blockquote>
</p>
<p>The <code>2d_ellipse</code> matcher compares elliptical regions
in a 2d plane for overlap. Each row has to specify five values,
giving the centre, the major and minor radii, and the orientation angle
of an ellipse.
Rows are considered to match if there is any overlap between the ellipses.
The goodness of match is a normalised generalisation of the symmetrical case
used by the isotropic matcher, in which the best possible match is
two concentric ellipses, and the worst allowable match is when
the circumferences just touch.
</p>
<p>Note the orientation angle is measured anticlockwise from the horizontal,
unlike the position angle used by the
<a href="EllipseSkyMatchEngine.html"><code>skyellipse</code></a> matcher.
</p>
<p>The <code>scale</code> parameter must be supplied, and should be
approximately the characteristic size of the per-object major radius.
In conjunction with the <code>bin-factor</code> tuning parameter
its value affects the performance of the match, but not the result.
</p>
<hr><a href="sec7.1.11.html">Next</a> <a href="ErrorCartesianMatchEngine.html">Previous</a> <a href="MatchEngine.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="sec7.1.11.html">Custom Matchers</a><br>
<b>Up: </b><a href="MatchEngine.html">Match Criteria</a><br>
<b>Previous: </b><a href="ErrorCartesianMatchEngine.html">1d_err, 2d_err, ...:
Cartesian Matching with Per-Object Errors</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>
|