dreadrb.c File Reference

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

#include <stdio.h>
#include <stdlib.h>
#include "superlu_ddefs.h"

Include dependency graph for dreadrb.c:

Functions
static int	DumpLine (FILE *fp)
	Eat up the rest of the current line. More...
static int	ParseIntFormat (char *buf, int_t *num, int_t *size)
static int	ParseFloatFormat (char *buf, int_t *num, int_t *size)
static int	ReadVector (FILE *fp, int_t n, int_t *where, int_t perline, int_t persize)
static int	dReadValues (FILE *fp, int_t n, double *destination, int_t perline, int_t persize)
static void	FormFullA (int_t n, int_t *nonz, double **nzval, int_t **rowind, int_t **colptr)
void	dreadrb_dist (int iam, FILE *fp, int_t *nrow, int_t *ncol, int_t *nonz, double **nzval, int_t **rowind, int_t **colptr)

Detailed Description

Read a matrix stored in Rutherford-Boeing format.

Copyright (c) 2003, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from U.S. Dept. of Energy)

All rights reserved.

The source code is distributed under BSD license, see the file License.txt at the top-level directory.

-- Distributed SuperLU routine (version 4.0) --
Lawrence Berkeley National Lab, Univ. of California Berkeley.
August 15, 2014

P<h1>urpose

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

Function Documentation

dreadrb_dist()

void dreadrb_dist	(	int	iam,
		FILE *	fp,
		int_t *	nrow,
		int_t *	ncol,
		int_t *	nonz,
		double **	nzval,
		int_t **	rowind,
		int_t **	colptr
	)

Here is the call graph for this function:

dReadValues()

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

static

Here is the caller graph for this function:

DumpLine()

static int DumpLine ( FILE *  fp )

static

Eat up the rest of the current line.

Here is the caller graph for this function:

FormFullA()

static void FormFullA ( int_t  n, int_t *  nonz, double **  nzval, int_t **  rowind, int_t **  colptr  )

static

On input, nonz/nzval/rowind/colptr represents lower part of a symmetric
matrix. On exit, it represents the full matrix with lower and upper parts.

Here is the caller graph for this function:

ParseFloatFormat()

static int ParseFloatFormat ( char *  buf, int_t *  num, int_t *  size  )

static

Here is the caller graph for this function:

ParseIntFormat()

static int ParseIntFormat ( char *  buf, int_t *  num, int_t *  size  )

static

Here is the caller graph for this function:

ReadVector()

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

static

Here is the caller graph for this function: