zio_define_distarray

INTERFACE:

         integer function zio_define_distarray(distarray,decomp,n1,n2,n3,&
      &                                        n4,n5)

DESCRIPTION:

Create a descriptor for the distributed array of grid sizes n1,n2,...for the parallel decomposition (up to 5-D) denoted by decomp. If a grid size is not evenly divisible by the respective process count, the excess grid points (that is, remainder) are evenly distributed among the lowest-rank processes along the dimension.

REVISION HISTORY:

       2003-Jan-31 -- first prototype
       2003-Jul-14 -- modified for multiple rectangular blocks per task

USES:

         implicit none

OUTPUT PARAMETERS:

         integer, intent(out) :: distarray

INPUT PARAMETERS:

         integer, intent(in)  :: decomp
         integer, intent(in)  :: n1
         integer, optional, intent(in)  :: n2
         integer, optional, intent(in)  :: n3
         integer, optional, intent(in)  :: n4
         integer, optional, intent(in)  :: n5

\