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 information on this web page is distributed under the MIT 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:
    
    
      
        - 
          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.
        
 
      
    
    
    
      Last revised on 05 June 2023.