NAG Library Routine Document

1Purpose

f06gvf (zgthrz) gathers specified (usually nonzero) elements of a complex vector $y$ in full storage form into a sparse complex vector $x$ in compressed form. The specified elements of $y$ are set to zero.

2Specification

Fortran Interface
 Subroutine f06gvf ( nz, y, x, indx)
 Integer, Intent (In) :: nz, indx(*) Complex (Kind=nag_wp), Intent (Inout) :: y(*), x(*)
#include nagmk26.h
 void f06gvf_ (const Integer *nz, Complex y[], Complex x[], const Integer indx[])
The routine may be called by its BLAS name zgthrz.

None.

4References

Dodson D S, Grimes R G and Lewis J G (1991) Sparse extensions to the Fortran basic linear algebra subprograms ACM Trans. Math. Software 17 253–263

5Arguments

1:     $\mathbf{nz}$ – IntegerInput
On entry: the number of nonzeros in the sparse vector $x$.
2:     $\mathbf{y}\left(*\right)$ – Complex (Kind=nag_wp) arrayInput/Output
Note: the dimension of the array y must be at least $\underset{\mathit{k}}{\mathrm{max}}\phantom{\rule{0.25em}{0ex}}\left\{{\mathbf{indx}}\left(\mathit{k}\right)\right\}$.
On entry: the vector $y$. Only elements corresponding to indices in indx are accessed.
On exit: the elements of $y$ corresponding to indices in indx are set to zero.
3:     $\mathbf{x}\left(*\right)$ – Complex (Kind=nag_wp) arrayOutput
Note: the dimension of the array x must be at least $\mathrm{max}\phantom{\rule{0.125em}{0ex}}\left(1,{\mathbf{nz}}\right)$.
On exit: the compressed vector $x$.
4:     $\mathbf{indx}\left(*\right)$ – Integer arrayInput
Note: the dimension of the array indx must be at least $\mathrm{max}\phantom{\rule{0.125em}{0ex}}\left(1,{\mathbf{nz}}\right)$.
On entry: indx must contain the set of indices $J$.

None.

Not applicable.

8Parallelism and Performance

f06gvf (zgthrz) is not threaded in any implementation.