Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

cblas_?gthrz

Gathers a sparse vector's elements into compressed form, replacing them by zeros.

Syntax

void cblas_sgthrz (const MKL_INT nz, float *y, float *x, const MKL_INT *indx);

void cblas_dgthrz (const MKL_INT nz, double *y, double *x, const MKL_INT *indx);

void cblas_cgthrz (const MKL_INT nz, void *y, void *x, const MKL_INT *indx);

void cblas_zgthrz (const MKL_INT nz, void *y, void *x, const MKL_INT *indx);

Include Files

  • mkl.h

Description

The ?gthrz routines gather the elements with indices specified by the array indx from a full-storage vector y into compressed form (nz, x, indx) and overwrite the gathered elements of y by zeros. Other elements of y are not referenced or modified (see also ?gthr).

Input Parameters

nz

The number of elements of y to be gathered.

indx

Specifies indices of elements to be gathered.

Array, size at least nz.

y

Array, size at least max(indx[i]).

Output Parameters

x

Array, size at least nz.

Contains the vector converted to the compressed form.

y

The updated vector y.