stilts-doc 3.1.2-2 / usr / share / doc / stilts / sun256 / EllipseSkyMatchEngine.html

This file is indexed.

/usr/share/doc/stilts/sun256/EllipseSkyMatchEngine.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
101
102
103
104
105
106
<html>
   
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
      <link rel="stylesheet" type="text/css" href="sun-style.css">
      <title>skyellipse:
         Sky Matching of Elliptical Regions
      </title>
   </head>
   
   <body>
      <hr>
      <a href="SphericalPolarMatchEngine.html">Next</a> <a href="SkyMatchEngine-err.html">Previous</a> <a href="MatchEngine.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="SphericalPolarMatchEngine.html">sky3d: Spherical Polar Matching</a><br>
       <b>Up: </b><a href="MatchEngine.html">Match Criteria</a><br>
       <b>Previous: </b><a href="SkyMatchEngine-err.html">skyerr:
         Sky Matching with Per-Object Errors</a><br>
      
      <hr>
      <h4><a name="EllipseSkyMatchEngine">7.1.3 <code>skyellipse</code>:
            Sky Matching of Elliptical Regions</a></h4>
      <p><pre>matcher=skyellipse values*='&lt;ra/degrees&gt; &lt;dec/degrees&gt; &lt;primary-radius/arcsec&gt;
                            &lt;secondary-radius/arcsec&gt;
                            &lt;position-angle/degrees&gt;'
                   params='&lt;scale/arcsec&gt;'
                   tuning='&lt;healpix-k&gt;'</pre>
         <blockquote>
            
            <dl>
               <dt><strong><code>values*</code>:</strong></dt>
               <dd>
                  
                  <ul>
                     <li><code>ra/degrees</code>: Right ascension of centre
                     </li>
                     <li><code>dec/degrees</code>: Declination of centre
                     </li>
                     <li><code>primary-radius/arcsec</code>: Length of ellipse semi-major axis
                     </li>
                     <li><code>secondary-radius/arcsec</code>: Length of ellipse semi-minor axis
                     </li>
                     <li><code>position-angle/degrees</code>: Position angle - measured from north pole to primary axis, in direction of positive
                        RA
                     </li>
                  </ul>
                  
               </dd>
               <dt><strong><code>params</code>:</strong></dt>
               <dd>
                  
                  <ul>
                     <li><code>scale/arcsec</code>: Rough average of ellipse major radius; just used for tuning to set default pixel
                        size
                     </li>
                  </ul>
                  
               </dd>
               <dt><strong><code>tuning</code>:</strong></dt>
               <dd>
                  
                  <ul>
                     <li><code>healpix-k</code>: Controls sky pixel size. Legal range 0 - 20. 0 is 60deg, 20 is 0.2".
                     </li>
                  </ul>
                  
               </dd>
            </dl>
            
         </blockquote>
         
      </p>
      <p>The <code>skyellipse</code> matcher compares elliptical regions
         on the sky for overlap.  Each row has to provide five values,
         giving the centre, the major and minor radii, and the position 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 <code>skyerr</code> matcher, in which the best possible match
         is two concentric ellipses, and the worst allowable match is when the
         circumferences just touch.
         
      </p>
      <p>The calculations are approximate since in some cases they rely on
         projecting the ellipses onto a Cartesian tangent plane before evaluating
         the match, so for larger ellipses the criterion will be less exact.
         For objects the size of most observed stars or galaxies,
         this approximation is not expected to be problematic.
         
      </p>
      <p>The <code>scale</code> parameter must be supplied, and should be
         a rough average value of the major radii.  it is used only to set
         a sensible default for the <code>healpix-k</code> tuning parameter,
         and its value does not affect the result.
         If you set <code>healpix-k</code> directly,
         the value of <code>scale</code> is ignored.
         
      </p>
      <hr><a href="SphericalPolarMatchEngine.html">Next</a> <a href="SkyMatchEngine-err.html">Previous</a> <a href="MatchEngine.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="SphericalPolarMatchEngine.html">sky3d: Spherical Polar Matching</a><br>
       <b>Up: </b><a href="MatchEngine.html">Match Criteria</a><br>
       <b>Previous: </b><a href="SkyMatchEngine-err.html">skyerr:
         Sky 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>

APT Browse - Built by Thomas Orozco.