ST_TO_HB
Convert Sparse Matrix File from ST to HB Format

ST_TO_HB is a FORTRAN90 program which reads sparse matrix data from an ST (Sparse Triplet) file and writes it to an HB (Harwell-Boeing) file.

Usage:

st_to_hb file.st file.hb

file.st

the ST file to be read;

file.hb

the HB file to be created.

Licensing:

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

Languages:

ST_TO_HB is available in a FORTRAN90 version and a MATLAB version.

Related Data and Programs:

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_TO_ST, a FORTRAN90 program which converts a sparse matrix from Harwell-Boeing to sparse triplet format.

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

MM_TO_HB, a MATLAB program which reads the sparse matrix information from an MM Matrix Market file and writes a corresponding HB Harwell Boeing file.

MSM_TO_HB, a MATLAB program which writes a MATLAB sparse matrix to a Harwell Boeing file;

ST, the format which is used for the input to this program.

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

ST_TO_DSP, a FORTRAN90 program which converts an ST sparse matrix file to DSP format.

ST_TO_MM, a MATLAB program which converts a sparse matrix file from ST format to MM format (Matrix Market format);

ST_TO_MSM, a MATLAB program which reads an ST sparse triplet file and creates a corresponding MATLAB Sparse Matrix.

Reference:

1. Iain Duff, Roger Grimes, John Lewis,
   User's Guide for the Harwell-Boeing Sparse Matrix Collection,
   October 1992,
   Available online at ../../pdf/hbsmc.pdf.

Source Code:

• st_to_hb.f90, the source code.
• st_to_hb.sh, commands to compile the source code.

Examples and Tests:

• st_to_hb_prb.f90, a sample calling program.
• st_to_hb_prb.csh, commands to compile and run the sample program.
• st_to_hb_prb_output.txt, the output file.

List of Routines:

• MAIN is the main program for ST_TO_HB.
• GET_UNIT returns a free FORTRAN unit number.
• SORT_HEAP_EXTERNAL externally sorts a list of items into ascending order.
• ST_DATA_READ reads the data of an ST file.
• ST_HEADER_READ reads the header of an ST file.
• ST_REBASE changes the base of an index array.
• ST_SORT_A sorts the entries of an ST matrix by column.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

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