next up previous contents
Next: psb_loc_to_glob Local Up: Data management routines Previous: psb_gelp Applies   Contents

psb_glob_to_loc -- Global to local indices convertion

call psb_glob_to_loc(x, y, desc_a, info, iact,owned)
call psb_glob_to_loc(x, desc_a, info, iact,owned)

Type:
Asynchronous.
On Entry
x
An integer vector of indices to be converted.
Scope: local
Type: required
Intent: in, inout.
Specified as: a rank one integer array.
desc_a
the communication descriptor.
Scope:local.
Type:required.
Intent: in.
Specified as: a structured data of type descdatapsb_desc_type.
iact
specifies action to be taken in case of range errors. Scope: global
Type: optional
Intent: in.
Specified as: a character variable Ignore, Warning or Abort, default Ignore.
owned
Specfies valid range of input Scope: global
Type: optional
Intent: in.
If true, then only indices strictly owned by the current process are considered valid, if false then halo indices are also accepted. Default: false.

On Return
x
If $y$ is not present, then $x$ is overwritten with the translated integer indices. Scope: global
Type: required
Intent: inout.
Specified as: a rank one integer array.
y
If $y$ is present, then $y$ is overwritten with the translated integer indices, and $x$ is left unchanged. Scope: global
Type: optional
Intent: out.
Specified as: a rank one integer array.
info
Error code.
Scope: local
Type: required
Intent: out.
An integer value; 0 means no error has been detected.

Notes

  1. If an input index is out of range, then the corresponding output index is set to a negative number;
  2. The default Ignore means that the negative output is the only action taken on an out-of-range input.


next up previous contents
Next: psb_loc_to_glob Local Up: Data management routines Previous: psb_gelp Applies   Contents