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_{\mathrm{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_{\mathrm{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.