# psb_scatter — Scatter Global Dense Matrix

[prev] [prev-tail] [tail] [up]

#### 5.4 psb_scatter — Scatter Global Dense Matrix

These subroutines scatters the portions of global dense matrix owned by a process to all the processes in the processes grid.

where:

glob_x
  is the global matrix glob_x1:m,1:n
loc_xi
  is the local portion of global dense matrix on process i.
scatter
  is the scatter function.

xi,y | Subroutine

Integer | psb_scatter
Short Precision Real | psb_scatter
Long Precision Real | psb_scatter
Short Precision Complex | psb_scatter
Long Precision Complex | psb_scatter

Table 20: Data types

call psb_scatter(glob_x, loc_x, desc_a, info, root, mold)

Type:
  Synchronous.
On Entry
glob_x
  The array that must be scattered into local pieces.
  Scope: global
  Type: required
  Intent: in.
  Specified as: a rank one or two array.
desc_a
  contains data structures for communications.
  Scope: local
  Type: required
  Intent: in.
  Specified as: a structured data of type psb_desc_type.
root
  The process that holds the global copy. If root = -1 all the processes have a copy of the global vector.
  Scope: global
  Type: optional
  Intent: in.
  Specified as: an integer variable -1 ≤ root ≤ np - 1, default psb_root_, i.e. process 0.
mold
  The desired dynamic type for the internal vector storage.
  Scope: local.
  Type: optional.
  Intent: in.
  Specified as: an object of a class derived from psb_T_base_vect_type; this is only allowed when loc_x is of type psb_T_vect_type.
On Return
loc_x
  the local portion of global dense matrix glob_x.
  Scope: local
  Type: required
  Intent: out.
  Specified as: a rank one or two ALLOCATABLE array or an object of type psb_T_vect_type containing numbers of the type indicated in Table 20.
info
  Error code.
  Scope: local
  Type: required
  Intent: out.
  An integer value; 0 means no error has been detected.

[prev] [prev-tail] [front] [up]