/usr/share/doc/stilts/sun256/uk.ac.starlink.ttools.func.Coverage.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>Coverage</title>
</head>
<body>
<hr>
<a href="uk.ac.starlink.ttools.func.CoordsRadians.html">Next</a> <a href="uk.ac.starlink.ttools.func.Lists.html">Previous</a> <a href="staticMethods.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="uk.ac.starlink.ttools.func.CoordsRadians.html">CoordsRadians</a><br>
<b>Up: </b><a href="staticMethods.html">Functions</a><br>
<b>Previous: </b><a href="uk.ac.starlink.ttools.func.Lists.html">Lists</a><br>
<hr>
<h4><a name="uk.ac.starlink.ttools.func.Coverage">10.5.11 Coverage</a></h4>
<p>Functions related to coverage and footprints.</p>
<p>One coverage standard is Multi-Order Coverage maps, described at
<a href="http://www.ivoa.net/Documents/MOC/">http://www.ivoa.net/Documents/MOC/</a>.
MOC positions are always defined in ICRS equatorial coordinates.
</p>
<p>MOC locations may be given as either the filename or the URL of
a MOC FITS file. Alternatively, they may be the identifier of a VizieR
table, for instance "<code>V/139/sdss9</code>" (SDSS DR9).
A list of all the MOCs available from VizieR can
currently be found at
<a href="http://alasky.u-strasbg.fr/footprints/tables/vizier/">http://alasky.u-strasbg.fr/footprints/tables/vizier/</a>.
You can search for VizieR table identifiers from the
VizieR web page
(<a href="http://vizier.u-strasbg.fr/">http://vizier.u-strasbg.fr/</a>);
note you must use
the <em>table</em> identifier (like "<code>V/139/sdss9</code>")
and not the <em>catalogue</em> identifier (like "<code>V/139</code>").
</p>
<p>
<dl>
<dt><strong><code>inMoc( mocLocation, ra, dec )</code></strong></dt>
<dd>Indicates whether a given sky position falls strictly within a given MOC
(Multi-Order Coverage map).
If the given <code>mocLocation</code> value does not represent
a MOC (for instance no file exists or the file is not in MOC format)
a warning will be issued the first time it's referenced, and
the result will be false.
<ul>
<li><code>mocLocation</code> <em>(String)</em>: location of a FITS MOC file:
a filename, a URL, or a VizieR table name
</li>
<li><code>ra</code> <em>(floating point)</em>: ICRS right ascension in degrees
</li>
<li><code>dec</code> <em>(floating point)</em>: ICRS declination in degrees
</li>
<li>return value <em>(boolean)</em>: true iff the given position falls within the given MOC
</li>
</ul>
</dd>
<dt><strong><code>nearMoc( mocLocation, ra, dec, distanceDeg )</code></strong></dt>
<dd>Indicates whether a given sky position either falls within,
or is within a certain distance of the edge of,
a given MOC (Multi-Order Coverage map).
If the given <code>mocLocation</code> value does not represent
a MOC (for instance no file exists or the file is not in MOC format)
a warning will be issued the first time it's referenced, and
the result will be false.
<ul>
<li><code>mocLocation</code> <em>(String)</em>: location of a FITS MOC file:
a filename, a URL, or a VizieR table name
</li>
<li><code>ra</code> <em>(floating point)</em>: ICRS right ascension in degrees
</li>
<li><code>dec</code> <em>(floating point)</em>: ICRS declination in degrees
</li>
<li><code>distanceDeg</code> <em>(floating point)</em>: permitted distance from MOC boundary in degrees
</li>
<li>return value <em>(boolean)</em>: true iff the given position is within <code>distance</code>
degrees of the given MOC
</li>
</ul>
</dd>
</dl>
</p>
<hr><a href="uk.ac.starlink.ttools.func.CoordsRadians.html">Next</a> <a href="uk.ac.starlink.ttools.func.Lists.html">Previous</a> <a href="staticMethods.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="uk.ac.starlink.ttools.func.CoordsRadians.html">CoordsRadians</a><br>
<b>Up: </b><a href="staticMethods.html">Functions</a><br>
<b>Previous: </b><a href="uk.ac.starlink.ttools.func.Lists.html">Lists</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>
|