Debian Codegraph @

doc/PixTools.html

raw
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 &lt;= 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>