/usr/share/doc/stilts/sun256/pixsample.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 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>pixsample: Samples from a HEALPix pixel data file</title>
</head>
<body>
<hr>
<a href="pixsample-usage.html">Next</a> <a href="pixfoot-examples.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="pixsample-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="pixfoot-examples.html">Examples</a><br>
<hr>
<hr>
<h2><a name="pixsample">B.6 <code>pixsample</code>: Samples from a HEALPix pixel data file</a></h2>
<p><code>pixsample</code> samples data at the sky position
represented by each row from an all-sky map contained
in a HEALPix-format pixel data file.
Such files are actually tables (usually in FITS format)
in which the row number corresponds to
a HEALPix pixel index, and the pixel values are cell contents;
one or more columns may be present containing values for one or more
all-sky maps. The result of this command is to add a column to
the input table representing the pixel data at the position of
each input row for each of the data columns in the
HEALPix table.
</p>
<p>This command does not attempt to convert between coordinate systems
except as instructed, so it is important to know what coordinate
system the HEALPix file is in, and ensure that the coordinates
supplied from the input table match this.
You may need to examine the documentation or headers of the HEALPix
file in question to find out.
See the <a href="pixsample-examples.html">Examples</a> section for
some examples.
</p>
<p>There is a choice of how the sampling is done;
the simplest way is just to use the value of the pixel covering
the indicated position. An alternative is to average over a
disc of given radius (perhaps a function of the input row).
Other options (e.g. max/min) could easily be added.
</p>
<p>Although HEALPix is not a common format for storing image
data in general, it is used for storing a number of important all-sky
data sets such as the WMAP results and Schlegel dust maps.
The NASA
<a href="http://lambda.gsfc.nasa.gov/">LAMBDA</a>
(Legacy Archive for Microwave Background Data Analysis)
archive has a number of maps in a suitable format,
including foreground data like predicted reddening as well as CMB maps.
</p>
<ul>
<li><a href="pixsample-usage.html">B.6.1 Usage</a></li>
<li><a href="pixsample-examples.html">B.6.2 Examples</a></li>
</ul>
<hr><a href="pixsample-usage.html">Next</a> <a href="pixfoot-examples.html">Previous</a> <a href="cmdUsage.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="pixsample-usage.html">Usage</a><br>
<b>Up: </b><a href="cmdUsage.html">Command Reference</a><br>
<b>Previous: </b><a href="pixfoot-examples.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>
|