set_pixelization

subroutine set_pixelization( pixchoice, pixpars, pixelization)

Purpose:

Allocates and defines the S2HAT pixeltype structure, pixelization, for storing all the info about the pixelization and needed for calculating all the transforms later on.
It can be either called by all procs, or by one proc, e.g., root and later broadcasts to all other procs via a call to mpi_pixelizationbcast. The pixelization structure has to be defined on all procs for the transforms.


Parameters:

input:

pixchoice-- [integer(4b)], determines the choice of a pixelization scheme, (=0, for HEALpix);

pixpars-- [type( pixparameters)], define the pixelization parameters (e.g., nside for HEALpix) which is assumed to determine uniquely the pixel properties for the given pixelization as given by pixchoice.

output:

pixelization-- [pixeltype], a S2HAT structure storing all the properties of the pixelization needed by the transforms later on.