This file is indexed.

/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*='&lt;x&gt; &lt;y&gt; &lt;primary-radius&gt; &lt;secondary-radius&gt;
                            &lt;orientation-angle/degrees&gt;'
                   params='&lt;scale&gt;'
                   tuning='&lt;bin-factor&gt;'</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>