mm_to_hb/mm_to_hb.html

<html>

  <head>
    <title>
      MM_TO_HB - Matrix Market Sparse Matrix File to Harwell Boeing Sparse Matrix File
    </title>
  </head>

  <body bgcolor="#EEEEEE" link="#CC0000" alink="#FF3300" vlink="#000055">

    <h1 align = "center">
      MM_TO_HB <br> Matrix Market Sparse Matrix File to Harwell Boeing Sparse Matrix File
    </h1>

    <hr>

    <p>
      <b>MM_TO_HB</b> 
      is a MATLAB library which
      reads the information stored in a Matrix Market file, and writes it to a
      corresponding Harwell-Boeing sparse matrix file.
    </p>

    <p>
      It is conceivable that the Matrix Market file will include (unnecessary)
      information associated with zero entries of the matrix.  <b>MM_TO_HB</b>
      will automatically drop such information from the Harwell-Boeing file
      that it creates.
    </p>

    <h3 align = "center">
      Usage:
    </h3>

    <p>
      <blockquote>
        <b>mm_to_hb</b> ( <i>'input.mm'</i>, <i>'output.hb'</i> )
      </blockquote>
      where
      <ul>
        <li>
          <i>'input.mm'</i> is the Matrix Market file to be read;
        </li>
        <li>
          <i>'output.hb'</i> is the Harwell-Boeing file to be created;
        </li>
      </ul>
    </p>

    <h3 align = "center">
      Languages:
    </h3>

    <p>
      <b>MM_TO_HB</b> is available in
      <a href = "../../m_src/mm_to_hb/mm_to_hb.html">a MATLAB version</a>.
    </p>

    <h3 align = "center">
      Related Data and Programs:
    </h3>

    <p>
      <a href = "../../data/hb/hb.html">
      HB</a>, 
      a data directory which
      contains examples of HB files,
      the Harwell Boeing sparse matrix file format;
    </p>

    <p>
      <a href = "../../m_src/hb_io/hb_io.html">
      HB_IO</a>,
      a MATLAB library which
      reads and writes sparse linear systems stored in the Harwell-Boeing Sparse Matrix format.
    </p>

    <p>
      <a href = "../../m_src/hb_to_mm/hb_to_mm.html">
      HB_TO_MM</a>,
      a MATLAB program which 
      reads an HB file and writes a corresponding MM file.
    </p>

    <p>
      <a href = "../../datasets/hbsmc/hbsmc.html">
      HBSMC</a>,
      a dataset directory which
      contains matrices stored in the
      Harwell-Boeing format.
    </p>

    <p>
      <a href = "../../data/mm/mm.html">
      MM</a>,
      a data directory which
      contains examples of Matrix Market (MM) files for sparse matrices.
    </p>

    <p>
      <a href = "../../m_src/mm_io/mm_io.html">
      MM_IO</a>,
      a MATLAB library which
      reads and writes sparse linear systems stored in the Matrix Market format.
    </p>

    <p>
      <a href = "../../m_src/mm_to_hb/mm_to_hb.html">
      MM_TO_HB</a>,
      a MATLAB program which
      reads the sparse matrix information from an MM Matrix Market file 
      and writes a corresponding HB Harwell Boeing file.
    </p>

    <p>
      <a href = "../../m_src/mm_to_msm/mm_to_msm.html">
      MM_TO_MSM</a>,
      a MATLAB program which
      reads a Matrix Market file defining a sparse matrix, and creates
      a corresponding MATLAB sparse matrix data structure.
    </p>

    <p>
      <a href = "../../m_src/mm_to_st/mm_to_st.html">
      MM_TO_ST</a>,
      a MATLAB program which
      reads the sparse matrix information from an MM Matrix Market file 
      and writes a corresponding ST Sparse Triplet file.
    </p>

    <p>
      <a href = "../../m_src/plasma_matrix/plasma_matrix.html">
      PLASMA_MATRIX</a>,
      a MATLAB library which
      demonstrates how a large sparse MATLAB matrix can be written to
      or read from a Harwell-Boeing sparse matrix file.
    </p>

    <h3 align = "center">
      Reference:
    </h3>

    <p>
      <ol>
        <li>
          Iain Duff, Roger Grimes, John Lewis,<br>
          User's Guide for the Harwell-Boeing Sparse Matrix Collection,<br>
          October 1992.
        </li>
        <li>
          Ronald Boisvert, Roldan Pozo, Karin Remington,<br>
          The Matrix Market Exchange Formats: Initial Design,<br>
          National Institute of Standards and Technology,<br>
          NISTIR 5935, December 1996.
        </li>
        <li>
          <a href = "http://math.nist.gov/MatrixMarket/">
                     http://math.nist.gov/MatrixMarket/</a>,
          the Matrix Market web site.
        </li>
      </ol>
    </p>

    <h3 align = "center">
      Source Code:
    </h3>

    <p>
      <ul>
        <li>
          <a href = "mm_to_hb.m">mm_to_hb.m</a>,
          the program.
        </li>
      </ul>
    </p>

    <h3 align = "center">
      Examples and Tests:
    </h3>

    <p>
      <ul>
        <li>
          <a href = "wathen_29_29_adg.mm">wathen_29_29_adg.mm</a>,
          a Matrix Market file containing a 29x29 Wathen Finite Element matrix.
        </li>
        <li>
          <a href = "wathen_29_29_adg.hb">wathen_29_29_adg.hb</a>,
          the corresponding HB file created by MM_TO_HB.
        </li>
      </ul>
    </p>

    <p>
      You can go up one level to <a href = "../m_src.html">
      the MATLAB source codes</a>.
    </p>

    <hr>

    <i>
      Last revised on 13 February 2010.
    </i>

    <!-- John Burkardt -->

  </body>

</html>