HB_TO_ST
Harwell-Boeing => Sparse Triplet Format

HB_TO_ST is a FORTRAN77 program which reads the definition of a sparse matrix from a file in Harwell-Boeing (HB) format, and writes the information into a Sparse Triplet (ST) file.

Usage:

hb_to_st hb.file st.file

• hb.file is the HB file to read;
• st.file is the ST file to create.

Licensing:

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

Languages:

HB_TO_ST is available in a FORTRAN77 version and a FORTRAN90 version and a MATLAB version.

Related Data and Programs:

DLAP_IO, a FORTRAN77 library which reads and writes DLAP sparse matrix files;

DSP_TO_ST, a FORTRAN90 program which converts a sparse matrix file from DSP format (one-based indices) to ST format (zero-based indices);

HB, a data directory which contains examples of HB files, the Harwell Boeing sparse matrix file format;

HB_IO, a FORTRAN90 library which reads and writes sparse linear systems stored in the Harwell-Boeing Sparse Matrix format.

HB_READ, a FORTRAN77 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).

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

MM_IO, a FORTRAN90 library which reads and writes sparse linear systems stored in the Matrix Market format.

SPARSEKIT, a FORTRAN90 library which carries out operations on sparse matrices, by Yousef Saad.

SPARSEPAK, a FORTRAN90 library which forms an obsolete version of the Waterloo Sparse Matrix Package.

ST, a data directory of examples of ST files, the Sparse Triplet format, a sparse matrix file format, storing just (I,J,A(I,J)), and using zero-based indexing.

ST_IO, a FORTRAN77 library which reads and writes sparse linear systems stored in the ST "sparse triplet" Sparse Matrix format.

ST_TO_DSP, a FORTRAN90 program which converts a sparse matrix file from ST format (zero-based indices) to DSP format (one-based indices);

Reference:

1. Timothy Davis,
   Direct Methods for Sparse Linear Systems,
   SIAM, Philadelphia, 2006.
2. Iain Duff, Roger Grimes, John Lewis,
   User's Guide for the Harwell-Boeing Sparse Matrix Collection,
   October 1992.
3. Iain Duff, Roger Grimes, John Lewis,
   The Rutherford-Boeing Sparse Matrix Collection,
   Technical Report RAL-TR-97-031,
   Rutherford Appleton Laboratory, 1997.

Source Code:

• hb_to_st.f, the source code.
• hb_to_st.sh, commands to compile, link and load the source code.

Examples and Tests:

5BY5 is a simple 5 by 5 matrix:

        1.1  0.0  0.0  1.4  0.0
        0.0  2.2  0.0  0.0  0.0
        3.1  3.2  3.3  3.4  3.5
        0.0  0.0  0.0  4.4  4.5
        5.1  5.2  0.0  0.0  5.5
      

• 5by5_rua.hb, the Harwell-Boeing file containing the matrix.
• 5by5.st, is the corresponding sparse triple file;
• 5by5_output.txt, the output file.

KERSHAW is a simple 4 by 4 matrix:

         3  -2   0   2
        -2   3  -2   0
         0  -2   3  -2
         2   0  -2   3
      

• kershaw_rua.hb, the Harwell-Boeing file containing the matrix.
• kershaw.st, is the corresponding sparse triple file;
• kershaw_output.txt, the output file.

List of Routines:

• MAIN is the main program for HB_TO_ST.

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