| 1 |
<?xml version="1.0" encoding="iso-8859-1"?> |
| 2 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" |
| 3 |
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| 4 |
<html xmlns="http://www.w3.org/1999/xhtml"> |
| 5 |
<head> |
| 6 |
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> |
| 7 |
<title>PixTools</title> |
| 8 |
<link rel="shortcut icon" href="./eag.png" type="image/x-icon" /> |
| 9 |
<meta name="generator" content="amaya 9.0, see http://www.w3.org/Amaya/" /> |
| 10 |
</head> |
| 11 |
|
| 12 |
<body> |
| 13 |
<p><img alt="EAG logo" src="eag.png" /></p> |
| 14 |
|
| 15 |
<h1>HEALPix PixTools.java</h1> |
| 16 |
|
| 17 |
<p><strong>The package gov.fnal.eag.healpix contains four classes - |
| 18 |
PixTools.java , Region.java, service classes BitManipulation.java, and PixInfo.java </strong></p> |
| 19 |
|
| 20 |
<p><strong>These classes in general are translation of the corresponding <a |
| 21 |
href="http://www.eso.org/science/healpix/index.html">HEALPix</a> FORTRAN90 |
| 22 |
programs to Java.</strong></p> |
| 23 |
|
| 24 |
<p><strong>The translation is not straight forward, but included junit tests have |
| 25 |
validated the package.</strong></p> |
| 26 |
|
| 27 |
|
| 28 |
|
| 29 |
<h2></h2> |
| 30 |
|
| 31 |
<p><strong> </strong></p> |
| 32 |
|
| 33 |
<h2>The Package Overview.</h2> |
| 34 |
|
| 35 |
<p><strong>The package creates sky pixelization to a specified resolution. |
| 36 |
The original FORTRAN version has natural limit imposed by HEALPix to the number of |
| 37 |
pixels Npix = 12 x N^2, where N the number of sides is an integer |
| 38 |
power of 2 and <= 8192 (Npix ~ 8.0E8) </strong> </p> |
| 39 |
|
| 40 |
<p><strong>The presented Java version overcomes this limitation boosting the |
| 41 |
resolution to about 0.2 arcsec (Npix ~ 1.3E13) which seems to be sufficient for modern experiments |
| 42 |
like SNAP </strong> </p> |
| 43 |
|
| 44 |
|
| 45 |
<p><strong>These tools permit creation of HEALPix maps as well as use |
| 46 |
of existing maps. There are tools to translate sky coordinates (Ra, Dec) to |
| 47 |
a pixel number, and to generate a list of neighboring pixels within some specified |
| 48 |
radius. More complicated queries are also supported.</strong></p> |
| 49 |
|
| 50 |
<p></p> |
| 51 |
|
| 52 |
<p><strong>The new class Region was added to the package. The class permits to define |
| 53 |
a rectangular area on the sphere providing standard ra,dec (Right ascension and Declination) limits of the area. |
| 54 |
Provided methods permits to pixelize the area with specified size of pixels.</strong></p> |
| 55 |
|
| 56 |
<p></p> |
| 57 |
<h2>Package API.</h2> |
| 58 |
|
| 59 |
<p><strong>For API description see <a |
| 60 |
href="./doc/index.html">Java docs</a>.</strong></p> |
| 61 |
|
| 62 |
<p></p> |
| 63 |
|
| 64 |
<p><strong> To download the self-installing jar file click <a href="http://home.fnal.gov/~kuropat/HEALPIX/eag-HEALPix.jar">here</a>.</strong></p> |
| 65 |
|
| 66 |
<p> To install these jar files and the package documentation use command:</p> |
| 67 |
<p><strong> java -jar eag-HEALPix.jar </strong></p> |
| 68 |
<p><strong> This will create in the installation directory two jar files (vecmath.jar, PixTools.jar) and the "doc" subdirectory. |
| 69 |
<p></p> |
| 70 |
<h2>Optimization.</h2> |
| 71 |
<p><strong>Working with highest resolution is time consuming and can be prohibitive. |
| 72 |
There is an optimized version of this package giving significant improvement in some cases. This version |
| 73 |
was developed by Jan Kotek, and can be found <a href="http://code.google.com/p/healpix-rangeset/">here</a>.</strong></p> |
| 74 |
<p></p> |
| 75 |
<p><em>06/14/2005 Nikolay Kuropatkin.</em></p> |
| 76 |
<p><em>12/19/2007 Nikolay Kuropatkin.</em></p> |
| 77 |
<p><em>04/11/2008 Nikolay Kuropatkin.</em></p> |
| 78 |
<p><em>07/09/2008 Nikolay Kuropatkin. Bug fixed in inRing method</em></p> |
| 79 |
<p><em>02/09/2010 Nikolay Kuropatkin. Bug was found by Jan Kotek in Query-disc with search |
| 80 |
radius smaller than the pixel size. Fixed.</em></p> |
| 81 |
<p><em> 11 Jan 2012 Nikolay Kuropatkin. Make the BitManipulation a static class.</em></p> |
| 82 |
<p><em>11 Jan 2012 modifications were proposed and implemented by Mark Taylor to make the package thread safe.</em></p> |
| 83 |
<p><strong> All methods are thread safe now. This class can be used as a singleton, |
| 84 |
the singleton instance being available from the <em>getInstance</em> method. |
| 85 |
For compatibility with previous versions however it is possible to |
| 86 |
construct new instances using the default constructor.</strong></p> |
| 87 |
<p><strong> Unit tests showing various methods of using the class are provided.</strong></p> |
| 88 |
<p><em> 28 Jul 2012 Nikolay Kuropatkin. To address some silly test of QuertyDisc method |
| 89 |
when two close points over the pole are missing each other in inclusive search the radius modification |
| 90 |
for inclusive search was changed. |
| 91 |
As the pixel shape is changing toward the pole from almost square to triangular the radius modifier should grow. |
| 92 |
In normal case close to equator the modifier is chosen to be half of the angular size of |
| 93 |
the pixel. Now the modifier is a function of the z component of unit vector pointing in the center of disc. |
| 94 |
The modifier value M=a+abs(z)*a, where a is half pixel size. |
| 95 |
In this case no changes in the QueryDisc behavior in the equatorial area is expected, |
| 96 |
while in the polar area one can expect increased number of pixels returned in the |
| 97 |
inclusive search. The maximum number of additional pixels can be estimated as |
| 98 |
2*PI*(radius + M)/(2*a).</em></p> |
| 99 |
|
| 100 |
</body> |
| 101 |
</html> |