convert_ring2nest*


Routine to convert a HEALPix map from RING to NESTED scheme.
The routine is a wrapper for 6 different routines and can threfore process integer, single precision and double precision maps as well as mono or bi dimensional arrays.
This routine is fast, and is parallelized for shared memory architecture, but requires extra memory to store a temporary map in.

Location in HEALPix directory tree: src/f90/mod/pix_tools.F90 


FORMAT

call convert_ring2nest*( nside, map )


ARGUMENTS

name & dimensionality kind in/out description
       
nside I4B IN the ${N_{\rm side}}$ parameter of the map to be converted.
map(0:12*nside**2-1) I4B/ SP/ DP INOUT mono-dimensional full sky map to be converted to RING scheme.
map(0:12*nside**2-1,1:nd) I4B/ SP/ DP INOUT bi-dimensional full sky map to be converted to RING scheme. The routine finds the second dimension (nd) by itself. Processing a bidimensional map with nd>1 should be faster than each of the nd 1D-maps consecutively.


EXAMPLE:

call convert_ring2nest(256,map)
Converts an ${N_{\rm side}}=256$ map given in array map from RING to NESTED scheme.


MODULES & ROUTINES

This section lists the modules and routines used by convert_ring2nest*.

ring2nest
routine to convert a RING pixel index to NESTED pixel number.

RELATED ROUTINES

This section lists the routines related to convert_ring2nest*

convert_nest2ring
convert between NESTED and RING schemes.
convert_inplace
convert between RING and NESTED schemes inplace. This routine is slower than convert_ring2nest*, but doesn't require as much memory.

Version 3.31, 2017-01-06