HB_IO
Harwell Boeing Matrix File
Read and Write Utilities


HB_IO is a FORTRAN90 library which reads and writes files in the Harwell Boeing sparse matrix format.

A special feature of HB_IO is the routine HB_FILE_READ, which can read all the information from an HBSMC file of arbitrary size. The data can then be accessed by the user by "using" the module HB_FILE_MODULE. Suggestions on how to compile, store and access the module are sketched out in the sample problem source code and in the command files.

Note that the most common "flavor" of HBSMC file is an assembled sparse matrix, but that there are some lesser used options, including storage of the matrix as unassembled finite element matrices, and corresponding storage of vectors. These secondary options are less well documented, and are only marginally supported in this package.

Licensing:

The computer code and data files described and made available on this web page are distributed under the GNU LGPL license.

Languages:

HB_IO is available in a C version and a C++ version and a FORTRAN90 version and a MATLAB version.

Related Data and Programs:

CC_IO, a FORTRAN90 library which reads and writes sparse linear systems stored in the Compressed Column (CC) format.

DLAP_IO, a FORTRAN90 library which reads and writes matrices in a variety of formats, and includes a routine for reading matrices in HB format.

HB, a dataset directory which contains a collection of sparse matrices in the HB format.

HB_READ, a FORTRAN90 library which reads files in the Harwell Boeing (HB) sparse matrix format; This is a simplified interface intended to handle only the most common format, complex unsymmetric assembled (CUA) or real unsymmetric assembled (RUA).

HB_TO_MSM, a MATLAB program which reads an HB file and converts the matrix to MATLAB's sparse matrix format.

HB_TO_ST, a FORTRAN90 program which converts the sparse matrix information stored in a Harwell-Boeing file into a sparse triplet file.

HBSMC, a dataset directory which contains the Harwell Boeing Sparse Matrix Collection;

LINPLUS, a FORTRAN90 library which contains some routines to manipulate matrices stored in the HB sparse matrix format.

MM_IO, a FORTRAN90 library which reads and writes matrices in the Matrix Market format.

MSM_TO_HB, a MATLAB program which takes a matrix in MATLAB's sparse matrix format and writes it out in the HB format.

ST_IO, a FORTRAN90 library which reads and writes sparse linear systems stored in the Sparse Triplet (ST) format.

SUPERLU, FORTRAN90 programs which illustrate how to use the SUPERLU library, which applies a fast direct solution method to solve sparse linear systems, by James Demmel, John Gilbert, and Xiaoye Li.

Reference:

  1. Iain Duff, Roger Grimes, John Lewis,
    User's Guide for the Harwell-Boeing Sparse Matrix Collection,
    Technical Report TR/PA/92/86, CERFACS,
    October 1992.
  2. Iain Duff, Roger Grimes, John Lewis,
    The Rutherford-Boeing Sparse Matrix Collection,
    Technical Report RAL-TR-97-031,
    Rutherford Appleton Laboratory, 1997.
  3. Iain Duff, Roger Grimes, John Lewis,
    Sparse Matrix Test Problems,
    ACM Transactions on Mathematical Software,
    Volume 15, pages 1-14, March 1989.
  4. http://math.nist.gov/MatrixMarket/data/Harwell-Boeing/ the Harwell-Boeing area of the MatrixMarket web site.

Source Code:

Examples and Tests:

List of Routines:

You can go up one level to the FORTRAN90 source codes.


Last revised on 01 January 2011.