sgthrz (3p)

Name

sgthrz - Gather and zero.

Synopsis

SUBROUTINE SGTHRZ(NZ, Y, X, INDX)

REAL Y(*), X(*)
INTEGER NZ
INTEGER INDX(*)

SUBROUTINE SGTHRZ_64(NZ, Y, X, INDX)

REAL Y(*), X(*)
INTEGER*8 NZ
INTEGER*8 INDX(*)


F95 INTERFACE
SUBROUTINE GTHRZ(NZ, Y, X, INDX)

REAL, DIMENSION(:) :: Y, X
INTEGER :: NZ
INTEGER, DIMENSION(:) :: INDX

SUBROUTINE GTHRZ_64(NZ, Y, X, INDX)

REAL, DIMENSION(:) :: Y, X
INTEGER(8) :: NZ
INTEGER(8), DIMENSION(:) :: INDX





C INTERFACE
#include <sunperf.h>

void sgthrz (const int nz, float* y, float* x, const int* indx);

void sgthrz_64 (const long nz, float* y, float* x, const long* indx);

Description

Oracle Solaris Studio Performance Library                           sgthrz(3P)



NAME
       sgthrz - Gather and zero.

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

        REAL Y(*), X(*)
        INTEGER NZ
        INTEGER INDX(*)

        SUBROUTINE SGTHRZ_64(NZ, Y, X, INDX)

        REAL Y(*), X(*)
        INTEGER*8 NZ
        INTEGER*8 INDX(*)


   F95 INTERFACE
        SUBROUTINE GTHRZ(NZ, Y, X, INDX)

        REAL, DIMENSION(:) :: Y, X
        INTEGER :: NZ
        INTEGER, DIMENSION(:) :: INDX

        SUBROUTINE GTHRZ_64(NZ, Y, X, INDX)

        REAL, DIMENSION(:) :: Y, X
        INTEGER(8) :: NZ
        INTEGER(8), DIMENSION(:) :: INDX





   C INTERFACE
       #include <sunperf.h>

       void sgthrz (const int nz, float* y, float* x, const int* indx);

       void sgthrz_64 (const long nz, float* y, float* x, const long* indx);




PURPOSE
       SGTHRZ - Gathers the specified elements from a vector y in full storage
       form into a vector x in compressed form.  The gathered elements of y
       are set to zero.  Only the elements of y whose indices are listed in
       indx are referenced.

        do i = 1, n
          x(i) = y(indx(i))
          y(indx(i)) = 0
        enddo


ARGUMENTS
       NZ (input) - INTEGER
               Number of elements in the compressed form.  Unchanged on exit.

       Y (input/output)
               Vector in full storage form.  Gathered elements are set to
               zero.

       X (output)
               Vector in compressed form.  Contains elements of y whose
               indices are listed in indx on exit.

       INDX (input) - INTEGER
               Vector containing the indices of the compressed form.  It is
               assumed that the elements in INDX are distinct and greater than
               zero.  Unchanged on exit.



3rd Berkeley Distribution         7 Nov 2015                        sgthrz(3P)