next up previous contents
Next: psb_geasb Assembly Up: Data management routines Previous: psb_geall Allocates   Contents

psb_geins -- Dense matrix insertion routine

call psb_geins(m, irw, val, x, desc_a, info,dupl)

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 descdatapsb_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_.

On Return
x
the output dense matrix.
Scope: local
Type: required
Intent: inout.
Specified as: a rank one or two array with the ALLOCATABLE attribute, 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.


next up previous contents
Next: psb_geasb Assembly Up: Data management routines Previous: psb_geall Allocates   Contents