6.13 psb_geins — Dense matrix insertion routine

Type:

Asynchronous.

On Entry

m

Number of rows in val to be inserted.
Scope:local.
Type:required.
Intent: in.
Specified as: an integer value.

irw

Indices of the rows to be inserted. Specifically, row i of val will be inserted into the local row corresponding to the global row index irw(i). Scope:local.
Type:required.
Intent: in.
Specified as: an integer array.

val

the dense submatrix to be inserted.
Scope:local.
Type:required.
Intent: in.
Specified as: a rank 1 or 2 array. Specified as: an integer value.

desc_a

the communication descriptor.
Scope:local.
Type:required.
Intent: in.
Specified as: a structured data of type psb_desc_type.

dupl

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

local

Whether the entries in the index vector irw, are already in local numbering.
Scope:local.
Type:optional.
Specified as: a logical value; default: .false..

On Return

x

the output dense matrix.
Scope: local
Type: required
Intent: inout.
Specified as: a rank one or two array 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. Dense vectors/matrices do not have an associated state;
2. Duplicate entries are either overwritten or added, there is no provision for raising an error condition.