convert_inplace*

Routine to convert a HEALPix map from NESTED to RING scheme or vice versa. The conversion is done in place, meaning that it doesn't require memory for a temporary map, like the $\htmlref{convert\_nest2ring}{sub:convert_nest2ring}$ or $\htmlref{convert\_ring2nest}{sub:convert_ring2nest}$ routines. But for that reason, this routine is slower and not parallelized. 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.

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

FORMAT

call convert_inplace*( subcall, map )

ARGUMENTS

name & dimensionality	kind	in/out	description
subcall	—	IN	routine to be called by convert_inplace_real. Set this to ring2nest or nest2ring dependent on wether the conversion is RING to NESTED or vice versa.
map(0:npix-1)	I4B/ SP/ DP	INOUT	mono-dimensional full sky map to be converted, the routine finds the size itself.
map(0:npix-1,1:nd)	I4B/ SP/ DP	INOUT	bi-dimensional (nd$> 0$) full sky map to be converted, the routine finds both dimensions itself. Processing a bidimensional map with nd$>1$ should be faster than each of the nd 1D-maps consecutively.

EXAMPLE:

call convert_inplace(ring2nest,map)

Converts an map from RING to NESTED scheme.

MODULES & ROUTINES

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

nest2ring

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

ring2nest

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

RELATED ROUTINES

This section lists the routines related to convert_inplace*

convert_nest2ring

convert from NESTED to RING scheme using a temporary array. Requires more space then convert_inplace, but is faster.

convert_ring2nest

convert from RING to NESTED scheme using a temporary array. Requires more space then convert_inplace, but is faster.