SRC/dreadrb.c File Reference

Read a matrix stored in Rutherford-Boeing format. More...

#include "slu_ddefs.h"

Functions
static int	dDumpLine (FILE *fp)
	Eat up the rest of the current line.
static int	dParseIntFormat (char *buf, int *num, int *size)
static int	dParseFloatFormat (char *buf, int *num, int *size)
static int	ReadVector (FILE *fp, int n, int *where, int perline, int persize)
static int	dReadValues (FILE *fp, int n, double *destination, int perline, int persize)
void	dreadrb (int *nrow, int *ncol, int *nonz, double **nzval, int **rowind, int **colptr)

---

Detailed Description

 -- SuperLU routine (version 4.0) --
 Lawrence Berkeley National Laboratory.
 June 30, 2009
 

Purpose =======

Read a DOUBLE PRECISION matrix stored in Rutherford-Boeing format as described below.

Line 1 (A72, A8) Col. 1 - 72 Title (TITLE) Col. 73 - 80 Matrix name / identifier (MTRXID)

Line 2 (I14, 3(1X, I13)) Col. 1 - 14 Total number of lines excluding header (TOTCRD) Col. 16 - 28 Number of lines for pointers (PTRCRD) Col. 30 - 42 Number of lines for row (or variable) indices (INDCRD) Col. 44 - 56 Number of lines for numerical values (VALCRD)

Line 3 (A3, 11X, 4(1X, I13)) Col. 1 - 3 Matrix type (see below) (MXTYPE) Col. 15 - 28 Compressed Column: Number of rows (NROW) Elemental: Largest integer used to index variable (MVAR) Col. 30 - 42 Compressed Column: Number of columns (NCOL) Elemental: Number of element matrices (NELT) Col. 44 - 56 Compressed Column: Number of entries (NNZERO) Elemental: Number of variable indeces (NVARIX) Col. 58 - 70 Compressed Column: Unused, explicitly zero Elemental: Number of elemental matrix entries (NELTVL)

Line 4 (2A16, A20) Col. 1 - 16 Fortran format for pointers (PTRFMT) Col. 17 - 32 Fortran format for row (or variable) indices (INDFMT) Col. 33 - 52 Fortran format for numerical values of coefficient matrix (VALFMT) (blank in the case of matrix patterns)

The three character type field on line 3 describes the matrix type. The following table lists the permitted values for each of the three characters. As an example of the type field, RSA denotes that the matrix is real, symmetric, and assembled.

First Character: R Real matrix C Complex matrix I integer matrix P Pattern only (no numerical values supplied) Q Pattern only (numerical values supplied in associated auxiliary value file)

Second Character: S Symmetric U Unsymmetric H Hermitian Z Skew symmetric R Rectangular

Third Character: A Compressed column form E Elemental form

 -- SuperLU routine (version 4.0) --
 Lawrence Berkeley National Laboratory.
 June 30, 2009
 

---

Function Documentation

static int dDumpLine

(

FILE *

fp

)

[static]

static int dParseFloatFormat	(	char *	buf,
		int *	num,
		int *	size
	)			[static]

static int dParseIntFormat	(	char *	buf,
		int *	num,
		int *	size
	)			[static]

void dreadrb	(	int *	nrow,
		int *	ncol,
		int *	nonz,
		double **	nzval,
		int **	rowind,
		int **	colptr
	)

static int dReadValues	(	FILE *	fp,
		int	n,
		double *	destination,
		int	perline,
		int	persize
	)			[static]

static int ReadVector	(	FILE *	fp,
		int	n,
		int *	where,
		int	perline,
		int	persize
	)			[static]