SSCTR(3)                MathKeisan SPARSE BLAS routine                SSCTR(3)



NAME
       SSCTR - Scatter a sparse vector from compressed form

SYNOPSIS
       SUBROUTINE SSCTR( NZ, X, INDX, Y )

           INTEGER        NZ, INDX

           REAL           X, Y

PURPOSE
       Scatter(copy)  the  components  of a sparse vector stored in compressed
       form into specified components of a vector in full-storage form.  If  y
       is initially the zero vector, then SSCTR performs

                     y := x

       which is represented by the following FORTRAN

                Y( INDX(I) ) = X(I)

                for I = 1, ..., NZ.

       In  typical use of full-form temporary vectors, the vector is initially
       set to zero. SSCTR is used to initialize the  interesting  entries  for
       processing. At the completion of processing, SGTHRZ is used to move the
       interesting values back into the sparse data structures and  simultane-
       ously  reset the full-form vector to its initial, zero, state for later
       use.

       The values of INDX must be distinct to allow consistent vector or  par-
       allel execution.


ARGUMENTS
       NZ      (input) INTEGER
               Number of elements to be scattered from compressed form.

       X       (input) REAL
               Array containing the values to be scattered from the compressed
               form into full storage form.

       INDX    (input) INTEGER
               Array containing the indices of the values to be scattered from
               compressed  form.  It  is assumed that the elements in INDX are
               distinct.

       Y       (output) REAL
               Array whose elements specified by INDX have  been  set  to  the
               corresponding  entries of X. Only the elements corresponding to
               the indices in INDX have been modified.

FURTHER DETAILS
       Sparse BLAS algorithm is from  ACM  algorithm  692  by  D.  Dodson,  R.
       Grimes, and J. Lewis.


SEE ALSO
       sblas(3)



MathKeisan                         June 1991                          SSCTR(3)