distribute_mask/TITLE> <META NAME="description" CONTENT="distribute_mask"> <META NAME="keywords" CONTENT="S2HATdocs"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="STYLESHEET" HREF="S2HATdocs.css"> </HEAD> <BODY >  <BR> <B> Next:</B> <A NAME="tex2html231" HREF="f90distrWghts.html">distribute_w8ring</A> <B> Up:</B> <A NAME="tex2html229" HREF="f90gathScat.html">Gather/scatter routines</A> <B> Previous:</B> <A NAME="tex2html223" HREF="f90distrPartMap.html">distribute_partialmap</A> <BR> <BR>  <HR> <table width=750 border=0 cellpadding=1 cellspacing=0> <tbody> <tr><td> <H3><A NAME="SECTION00015300000000000000"> distribute_map</A> </H3> subroutine <tt>distribute_mask( pixelization, nmasks, masknum, ncomp, first_ring, last_ring, mask_size, local_mask, mask, myid, numprocs, root, comm) </tt><BR> <BR> <U>Purpose:</U><br><br> The routine distributes a full sky mask <tt>mask</tt> of <tt>ncomp</tt> components stored in the memory of the proc <tt>root</tt> over all processors. The result is stored it in the distributed form on each proc in a vector <tt>local_mask</tt> as a <tt>masknum</tt> mask. To distribute <tt>nmasks</tt> the routines needs to be called <tt>nmasks</tt> times, however in this way it does not require storing all the <tt>nmasks</tt> full sky masks in the memory of the single proc <tt>root</tt> prior to the distribution. <BR> The mask is assumed to be a vector of 0 and 1 integers delineating the observed patch of the sky. For the float-valued map-like objects (windows, apodization) use <tt>distribute_map</tt>. <BR> To be called by all procs of the communicator <tt>comm</tt>. Blocking. <BR> <BR> <BR><U>Parameters:</U> <BR> <BR> input: <DL> <DD><tt><b>pixelization(*)--</b> [pixeltype]</tt>, an S2HAT structure containing the info about the pixelization; </DD> <BR> <DD><tt><b>masknum(*)--</b> [integer(4b)]</tt>, a current number of a mask which is being now distributed; </DD> <BR> <DD><tt><b>nmasks(*)--</b></tt> [integer(4b)], a total number of masks to be distributed and later processed; </DD> <br> <DD><tt><b>ncomp(*)--</b> [integer(4b)]</tt>, a number of components of the masks to be distributed <tt>(=1,2,3)</tt>; </DD> <BR> <DD><tt><b>first_ring, last_ring--</b> [integer(4b)]</tt>, a number of a first and last ring which define a distibuted map (both included) to be stored on a given proc; </DD> <BR> <DD><tt><b>mask_size--</b> [integer(4b)]</tt>, a number of pixels corresponding to a set of rings defined by <tt>first_ring</tt> and <tt>last_ring</tt> above; </DD> <BR> <DD><tt><b>mask--</b> [real(dp)]</tt>, an allocated pointer to a 2dim array of dimensions <tt>(0:npixall-1, 1:ncomp)</tt> storing a single full sky mask on the proc <tt>root</tt> and which is to be distributed; </DD> <BR> <DD><tt><b>myid--</b> [integer(4b)]</tt>, proc id <tt>(0,...,numprocs-1)</tt>; </DD> <BR> <DD><tt><b>numprocs(*)--</b> [integer(4b)]</tt>, total number of procs used; </DD> <BR> <DD><tt><b>root(*)--</b> [integer(4b)]</tt>, defines a proc <tt>root</tt> on which the full mask <tt>mask</tt> is stored; </DD> <BR> <DD><tt><b>comm(*)--</b> [integer(4b)]</tt>, an mpi communicator for the numprocs procs. </DD> </DL> <font size = 2pt> (*)The value must be the same on all procs of the communicator <tt>comm</tt>. </font> <P> output: <DL> <DD><tt><b>local_mask--</b> [integer(4b)]</tt>, an allocated pointer of a 3dim array of a size <tt>(0:mask_size-1,1:ncomp,1:nmasks)</tt> storing the distributed mask. </DD> </DL> <U>Comments:</U> <BR><BR><DD> <LI>On the proc <tt>root</tt> a full sky mask is always assumed, even if only parts of it (as defined by <tt>first_ring</tt> and <tt>last_ring</tt>) may actually be distributed. </DD><br> <DD><LI>On all procs the sub-mask, <tt>local_mask,</tt> is made of complete rings of both northern and southern hemispheres with numbers falling between <tt>first_ring</tt> and the <tt>last_ring</tt>, inclusive. </DD> <BR> </tr></td> </tbody> </table> <HR> <BR> <BR> <B> Next:</B> <A NAME="tex2html231" HREF="f90distrWghts.html">distribute_w8ring</A> <B> Up:</B> <A NAME="tex2html229" HREF="f90gathScat.html">Gather/scatter routines</A> <B> Previous:</B> <A NAME="tex2html223" HREF="f90distrPartMap.html">distribute_partialmap</A> <ADDRESS> <BR> radek stompor 2008-10-22 </ADDRESS> </BODY> </HTML>