hb_io

hb_io, an Octave code which reads and writes files in the Harwell Boeing (HB) sparse matrix format.

Note that the most common "flavor" of an HB 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 and an Octave version.

Related Data and Programs:

hb_io_test

ccs_io, an Octave code which reads and writes sparse linear systems stored in the Compressed Column Storage (CCS) format.

hb, a dataset directory which contains a collection of sparse matrices in the Harwell Boeing (HB) format.

hb_to_mm, an Octave code which converts a sparse matrix from Harwell Boeing (HB) to Matrix Market (MM) format.

hb_to_msm, an Octave code which reads a Harwell Boeing (HB) file and converts it to a MATLAB sparse matrix (MSM).

hb_to_st, an Octave code which converts a sparse matrix from Harwell Boeing (HB) to sparse triplet (ST) format.

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

mm_io, an Octave code which reads and writes matrices in the Matrix Market (MM) format.

mm_to_hb, an Octave code which reads the sparse matrix information from a Matrix Market (MM) file and writes a corresponding Harwell Boeing (HB) file.

mxm_to_hb, an Octave code which takes a MATLAB sparse matrix (MSM) and writes it out in the Harwell Boeing (HB) format.

plasma_matrix, an Octave code which demonstrates how a MATLAB sparse matrix (MSM) can be written to or read from a Harwell-Boeing (HB) sparse matrix file.

st_to_hb, an Octave code which converts a sparse matrix file from sparse triplet (ST) format to Harwell Boeing (HB) format);

Reference:

1. Iain Duff, Roger Grimes, John Lewis,
   User's Guide for the Harwell-Boeing Sparse Matrix Collection,
   October 1992.

Source Code:

• ch_cap.m, returns the uppercase version of a character.
• ch_eqi.m, determines whether two characters are the same, ignoring case.
• ch_is_digit.m, determines whether a character is a digit.
• ch_is_format_code.m, determines whether a character is a one letter FORTRAN format code.
• ch_to_digit.m, converts a character to the digit it represents.
• hb_exact_read.m, reads the exact solution vectors of an HB file.
• hb_exact_write.m, writes the exact solution vectors of an HB file.
• hb_file_read.m, reads an HB file.
• hb_file_write.m, writes an HB file.
• hb_guess_read.m, reads the starting guess vectors of an HB file.
• hb_guess_write.m, writes the starting guess vectors of an HB file.
• hb_header_print.m, prints the header of an HB file.
• hb_header_read.m, reads the header of an HB file.
• hb_header_write.m, writes the header of an HB file.
• hb_matvec_a_mem.m, multiplies an assembled HB matrix times a vector.
• hb_rhs_read.m, reads the right hand sides of an HB file.
• hb_rhs_write.m, writes the right hand sides of an HB file.
• hb_structure_print.m, prints the structure of an HB file.
• hb_structure_read.m, reads the structure of an HB file.
• hb_structure_write.m, writes the structure of an HB file.
• hb_ua_colind.m, constructs a column index vector for an unsymmetric assembled matrix.
• hb_values_print.m, prints the values of an HB file.
• hb_values_read.m, reads the values of an HB file.
• hb_values_write.m, writes the values of an HB file.
• hb_vecmat_a_mem.m, multiplies a vector times an assembled HB matrix.
• i4vec_print.m, prints an I4VEC.
• i4vec_print_some.m, prints some of an I4VEC.
• r8mat_print.m, prints an R8MAT.
• r8mat_print_some.m, prints some of an R8MAT.
• r8vec_print.m, prints an R8VEC.
• r8vec_print_some.m, prints some of an R8VEC.
• s_len_trim.m, determines the length of a string to the last nonblank.
• s_to_format.m, extracts information from a string representing a FORTRAN format.
• s_to_i4.m, converts a string to an I4.
• s_to_r8.m, converts a string to an R8.