NASA - Jet Propulsion Laboratory
    + View the NASA Portal
Search JPL
Jet Propulsion Laboratory Home Earth Solar System Stars & Galaxies Technology
Introduction Background Software Links


same_shape_pixels_XXXX


These IDL facilities provide the ordered list of all HEALPix pixels having the same shape as a given template, for a resolution parameter ${N_{\rm side}}$.


Location in HEALPix directory tree: src/idl/toolkit/same_shape_pixels_nest.pro, src/idl/toolkit/same_shape_pixels_ring.pro


FORMAT

IDL> same_shape_pixels_nest, Nside, Template, List_Pixels_Nest [, Reflexion, NREPLICATIONS=]


FORMAT

IDL> same_shape_pixels_ring, Nside, Template, List_Pixels_Ring [, Reflexion, NREPLICATIONS=]


QUALIFIERS


Nside
(IN, scalar) the HEALPix ${N_{\rm side}}$ parameter.
Template
(IN, scalar) identification number of the template (this number is independent of the numbering scheme considered).
List_Pixel_Nest
(OUT, vector) ordered list of NESTED scheme identification numbers for all pixels having the same shape as the template provided
List_Pixel_Ring
(OUT, vector) ordered list of RING scheme identification numbers for all pixels having the same shape as the template provided
Reflexion
(OUT, OPTIONAL, vector) in {0, 3} encodes the transformation(s) to apply to each of the returned pixels to match exactly in shape and position the template provided. 0: rotation around the polar axis only, 1: rotation + East-West swap (ie, reflexion around meridian), 2: rotation + North-South swap (ie, reflexion around Equator), 3: rotation + East-West and North-South swaps


KEYWORDS


NREPLICATIONS
(OUT, OPTIONAL, scalar) number of pixels having the same shape as the template. It is also the length of the vectors List_Pixel_Nest, List_Pixel_Ring and Reflexion. It is either 8, 16, 4 ${N_{\rm side}}$ or 8 ${N_{\rm side}}$.


DESCRIPTION


same_shape_pixels_XXXX provide the ordered list of all HEALPix pixels having the same shape as a given template, for a resolution parameter ${N_{\rm side}}$. Depending on the template considered the number of such pixels is either 8, 16, 4 ${N_{\rm side}}$ or 8 ${N_{\rm side}}$. The template pixels are all located in the Northern Hemisphere, or on the Equator. They are chosen to have their center located at
$\displaystyle z=\cos(\theta)\ge 2/3,$ $\textstyle \ $ $\displaystyle 0< \phi \leq \pi/2,$  
$\displaystyle %[Nside*(Nside+2)/4]
2/3 > z \geq 0,$ $\textstyle \ $ $\displaystyle \phi=0, \quad{\rm or}\quad \phi=\frac{\pi}{4{N_{\rm side}}}. %[Nside]
$  

They are numbered continuously from 0, starting at the North Pole, with the index increasing in $\phi$, and then increasing for decreasing z.


EXAMPLE:

same_shape_pixels_ring, 256, 1234, list_pixels, reflexion, nrep=np

Returns in list_pixels the RING-scheme index of the all the pixels having the same shape as the template #1234 for ${N_{\rm side}}=256$. Upon return reflexion will contain the reflexions to apply to each pixel returned to match the template, and np will contain the number of pixels having that same shape (16 in that case).

RELATED ROUTINES

This section lists the routines related to same_shape_pixels_XXXX


nside2templates
returns the number of template pixel shapes available for a given ${N_{\rm side}}$.
template_pixel_ring
template_pixel_nest
return the template shape matching the pixel provided

Eric Hivon 2010-06-18
Privacy / Copyright
FIRST GOV Contact: NASA Home Page Site Manager:
Webmaster:

CL 03-2650