[ HPF Home | Versions | Compilers | Projects | Publications | Applications | Benchmarks | Events | Contact ] |
Optional Arguments. AXIS_TYPE, AXIS_INFO,
PROCESSORS_RANK, PROCESSORS_SHAPE
Description. The HPF_DISTRIBUTION subroutine returns information regarding
the distribution of the ultimate align-target associated with a variable.
Class. Mapping inquiry subroutine.
Arguments.
DISTRIBUTEE may be of any type. It may be scalar or array valued. It must not be an assumed-size array. It must not be a structure component. If it is a member of an aggregate variable group, then it must be an aggregate cover of the group. (See Section for the definitions of ``aggregate variable group'' and ``aggregate cover.'') It must not be a pointer that is disassociated or an allocatable array that is not allocated. It is an INTENT (IN) argument.
AXIS_INFO (optional) must be a rank one array of type default integer, and size at least equal to the rank of the align-target to which DISTRIBUTEE is ultimately aligned (which is returned by HPF_TEMPLATE in TEMPLATE_RANK). It is an INTENT (OUT) argument. The i element of AXIS_INFO contains the block size in the block or cyclic distribution of the i axis of the ultimate align-target of DISTRIBUTEE; if that axis is a collapsed axis, then the value is implementation dependent.
PROCESSORS_RANK (optional) must be scalar and of type default integer. It is set to the rank of the processor arrangement onto which DISTRIBUTEE is distributed. It is an INTENT (OUT) argument.
PROCESSORS_SHAPE (optional) must be a rank one array
of type default integer and of size
at least equal to the value, , returned in PROCESSORS_RANK.
It is an INTENT (OUT) argument.
Its first elements are set to the
shape of the processor arrangement onto which DISTRIBUTEE is mapped.
(It may be necessary to call HPF_DISTRIBUTION twice, the first
time to obtain the value of PROCESSORS_RANK in order to allocate
PROCESSORS_SHAPE.)
Example.
Given the declarations in the example of Section ,
and assuming that the actual mappings are as the directives specify,
the results of HPF_DISTRIBUTION are:
©2000-2006 Rice University | [ Contact Us | HiPerSoft | Computer Science ] |