next up previous contents
Next: MY_PROCESSOR() Up: HPF Local Routine Library Previous: GLOBAL_TO_LOCAL(ARRAYG_INDEX, L_INDEX, LOCAL,

GLOBAL_TO_LOCAL(ARRAY, G_INDEX, L_INDEX,
LOCAL, NCOPIES, PROCS)

Optional arguments. L_INDEX, LOCAL, NCOPIES, PROCS

Description. Converts a set of global coordinates within a global HPF actual argument array to an equivalent set of local coordinates within the associated local dummy array.

Class. Subroutine.

Arguments.

ARRAY may be of any type; it must be a dummy array that is associated with a global HPF array actual argument. It is an INTENT(IN) argument.

G_INDEX must be a rank-1 integer array whose size is equal to the rank of ARRAY. It is an INTENT(IN) argument. It contains the coordinates of an element within the global HPF array actual argument associated with the local dummy array ARRAY. The value of the ith element must be in the range 1 to ei, where ei is the extent of the ith dimension of the global HPF actual argument array associated with ARRAY.

L_INDEX (optional) must be a rank-1 integer array whose size is equal to the rank of ARRAY. It is an INTENT(OUT) argument. It receives the coordinates within a local dummy array of the element identified within the global actual argument array by G_INDEX. (These coordinates are identical on any processor that holds a copy of the identified global array element.)

The value of the ith element will be in the range 1 to ei, where ei is the extent of the ith dimension of ARRAY.

LOCAL (optional) must be scalar and of type LOGICAL. It is an INTENT(OUT) argument. It is set to .TRUE. if the local array contains a copy of the global array element and to .FALSE. otherwise.

NCOPIES (optional) must be scalar and of type integer. It is an INTENT(OUT) argument. It is set to the number of processors that hold a copy of the identified element of the global actual array.

PROCS (optional) must be a rank-1 integer array whose size is at least the number of processors that hold copies of the identified element of the global actual array. The identifying numbers of those processors are placed in PROCS. The order in which they appear is implementation dependent.


next up previous contents
Next: MY_PROCESSOR() Up: HPF Local Routine Library Previous: GLOBAL_TO_LOCAL(ARRAYG_INDEX, L_INDEX, LOCAL,