/usr/share/doc/stilts/sun256/addpixsample.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 107 108 109 110 | <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" type="text/css" href="sun-style.css">
<title>addpixsample</title>
</head>
<body>
<hr>
<a href="addresolve.html">Next</a> <a href="addcol.html">Previous</a> <a href="filterSteps.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="addresolve.html">addresolve</a><br>
<b>Up: </b><a href="filterSteps.html">Processing Filters</a><br>
<b>Previous: </b><a href="addcol.html">addcol</a><br>
<hr>
<h4><a name="addpixsample">6.1.2 <code>addpixsample</code></a></h4>
<p><strong>Usage:</strong>
<pre> addpixsample [-radius <expr-rad>] [-systems <in-sys> <pix-sys>]
<expr-lon> <expr-lat> <healpix-file></pre></p>
<p>Samples pixel data from an all-sky image file
in HEALPix format.
The <code><healpix-file></code> argument must be
the filename of a table containing HEALPix pixel data.
The URL of such a file can be used instead, but local files
are likely to be more efficient.
</p>
<p>The <code><expr-lon></code>
and <code><expr-lat></code> arguments
give expressions for the longitude and latitude in degrees
for each row of the input table;
this is usually just the column names.
The long/lat must usually be in the same coordinate system
as that used for the HEALPix data, so if the one is in
galactic coordinates the other must be as well.
If this is not the case, use the <code>-systems</code> flag
to give the input long/lat and healpix data coordinate system
names respectively.
The available coordinate system names are:
<ul>
<li><code>icrs</code>: ICRS (Hipparcos) (Right Ascension, Declination)
</li>
<li><code>fk5</code>: FK5 J2000.0 (Right Ascension, Declination)
</li>
<li><code>fk4</code>: FK4 B1950.0 (Right Ascension, Declination)
</li>
<li><code>galactic</code>: IAU 1958 Galactic (Longitude, Latitude)
</li>
<li><code>supergalactic</code>: de Vaucouleurs Supergalactic (Longitude, Latitude)
</li>
<li><code>ecliptic</code>: Ecliptic (Longitude, Latitude)
</li>
</ul>
</p>
<p>The <code><expr-rad></code>, if present,
is a constant or expression
giving the radius in degrees over which
pixels will be averaged to obtain the result values.
Note that this averaging is somewhat approximate;
pixels partly covered by the specified disc are weighted
the same as those fully covered.
If no radius is specified, the value of the pixel covering
the central position will be used.
</p>
<p>The <code><healpix-file></code> file is a table
with one row per HEALPix pixel and one or more columns
representing pixel data.
A new column will be added to the output table
corresponding to each of these pixel columns.
This type of data is available in FITS tables for a number of
all-sky data sets, particularly from the
<a href="http://lambda.gsfc.nasa.gov/">LAMBDA</a> archive;
see for instance the page on
<a href="http://lambda.gsfc.nasa.gov/product/foreground/f_products.cfm">foreground products</a>
(including dust emission, reddening etc)
or
<a href="http://lambda.gsfc.nasa.gov/product/map/dr4/ilc_map_get.cfm">WMAP 7 year data</a>.
If the filename given does not appear to point to a file
of the appropriate format, an error will result.
Note the LAMBDA files mostly (all?) use galactic coordinates,
so coordinate conversion using the <code>-systems</code> flag
may be appropriate, see above.
</p>
<p>Syntax for the <a href="jel.html"><code><expr-lon></code></a> , <a href="jel.html"><code><expr-lat></code></a> and <a href="jel.html"><code><expr-rad></code></a> arguments is described in the manual.
</p>
<p>This filter is somewhat experimental, and its usage may be
changed or replaced in a future version.
</p>
<p><strong>Note: you may prefer to use the
<code><a href="pixsample.html">pixsample</a></code>
command instead.
</strong>
</p>
<hr><a href="addresolve.html">Next</a> <a href="addcol.html">Previous</a> <a href="filterSteps.html">Up</a> <a href="index.html">Contents</a> <br> <b>Next: </b><a href="addresolve.html">addresolve</a><br>
<b>Up: </b><a href="filterSteps.html">Processing Filters</a><br>
<b>Previous: </b><a href="addcol.html">addcol</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>
|