int MatGetRow(Mat mat,int row,int *ncols,int **cols,Scalar **vals)Not Collective
mat | - the matrix |
row | - the row to get |
ncols | - the number of nonzeros in the row |
cols | - if nonzero, the column numbers |
vals | - if nonzero, the values |
MatGetRow() always returns 0-based column indices, regardless ofwhether the internal representation is 0-based (default) or 1-based.
For better efficiency, set cols and/or vals to PETSC_NULL if you donot wish to extract these quantities.
The user can only examine the values extracted with MatGetRow(); the values cannot be altered. To change the matrix entries, onemust use MatSetValues().
You can only have one call to MatGetRow() outstanding for a particularmatrix at a time.
MatGetRow(matrix,row,ncols,cols,values,ierr) Mat matrix (input) integer row (input) integer ncols (output) integer cols(maxcols) (output) double precision (or double complex) values(maxcols) outputwhere maxcols >= maximum nonzeros in any row of the matrix.
Location: src/mat/interface/matrix.c
Matrix Index
Table of Contents