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_{\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_nest2ring(256,map)

Converts an $N_{\mathrm{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.