convert_nest2ring*


Routine to convert a HEALPix map from NESTED to RING 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_nest2ring*( 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_nest2ring(256,map)
Converts an ${N_{\rm side}}=256$ map given in array map from NESTED to RING scheme.


MODULES & ROUTINES

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

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

RELATED ROUTINES

This section lists the routines related to convert_nest2ring*

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

Version 3.31, 2017-01-06