6.12 psb_geall — Allocates a dense matrix

call psb_geall(x, desc_a, info[, dupl, bldmode, n, lb])

Type:

Synchronous.

On Entry

desc_a

The communication descriptor.
Scope: local
Type: required
Intent: in.
Specified as: a variable of type psb_desc_type.

n

The number of columns of the dense matrix to be allocated.
Scope: local
Type: optional
Intent: in.
Specified as: Integer scalar, default 1. It is not a valid argument if x is a rank-1 array.

lb

The lower bound for the column index range of the dense matrix to be allocated.
Scope: local
Type: optional
Intent: in.
Specified as: Integer scalar, default 1. It is not a valid argument if x is a rank-1 array.

dupl

How to handle duplicate coefficients.
Scope: global.
Type: optional.
Intent: in.
Specified as: integer, possible values: psb_dupl_ovwrt_, psb_dupl_add_; psb_dupl_err_ has no effect.

bldmode

Whether to keep track of matrix entries that do not belong to the current process.
Scope: global.
Type: optional.
Intent: in.
Specified as: an integer value psb_matbld_noremote_, psb_matbld_remote_. Default: psb_matbld_noremote_.

On Return

x

The dense matrix to be allocated.
Scope: local
Type: required
Intent: out.
Specified as: a rank one or two array with the ALLOCATABLE attribute or an object of type psb_T_vect_type, of type real, complex or integer.

info

Error code.
Scope: local
Type: required
Intent: out.
An integer value; 0 means no error has been detected.

Notes

1. Using psb_matbld_remote_ is likely to cause a runtime overhead at assembly time;