MM_IO
Matrix Market
Read and Write Utilities

MM_IO is a FORTRAN90 library of routines for reading and writing files in the Matrix Market format.

Related Data and Programs:

DLAP_IO is a library of FORTRAN90 routines reading and writing files describing sparse matrices used by DLAP.

HB_IO is a FORTRAN90 library of routines for reading and writing sparse matrices stored in the Harwell-Boeing format.

HB_TO_ST is an executable FORTRAN77 program which converts the sparse matrix information stored in a Harwell-Boeing file into a sparse triplet file.

MM is a data directory which contains a description and examples of the Matrix Market format for storing matrices.

MM_IO is also available in a MATLAB version.

TEMPLATES is a library of MATLAB routines for iterative solution of linear systems. It includes a routine mm_to_msm which can read a Matrix Market file and store it as a MATLAB sparse matrix.

TEST_MAT is a library of FORTRAN90 routines that define various test matrices.

Reference:

1. Ronald Boisvert, Roldan Pozo, Karin Remington,
   The Matrix Market Exchange Formats: Initial Design,
   National Institute of Standards and Technology,
   NISTIR 5935, December 1996,
   Available online at ../../pdf/mm_format.pdf
2. http://math.nist.gov/MatrixMarket/, the Matrix Market web site.

Source Code:

• mm_io.f90, the source code.
• mm_io.csh, commands to compile the source code.

Examples and Tests:

• mm_io_prb.f90, a sample calling program.
• mm_io_prb.csh, commands to compile and run the sample program.
• mm_io_prb.out, the output from a run of the sample program.
• matrix_05_05_crg.txt, a 5 by 5 matrix in COORDINATE REAL GENERAL form read by some routines, and written by others.
• wathen_29_28_adg.txt, a 29 by 29 matrix in ARRAY DOBULE GENERAL form written by one of the test routines.

List of Routines:

• CH_CAP capitalizes a single character.
• GET_UNIT returns a free FORTRAN unit number.
• MM_COMMENT_PRINT prints a comment from a Matrix Market file.
• MM_COMMENT_READ reads a comment from a Matrix Market file.
• MM_COMMENT_WRITE writes a comment to a Matrix Market file.
• MM_FILE_READ reads data from a Matrix Market file.
• MM_FILE_WRITE writes data to a Matrix Market file.
• MM_HEADER_CHECK checks the header strings for a Matrix Market file.
• MM_HEADER_PRINT prints header information from a Matrix Market file.
• MM_HEADER_READ reads the header line from a Matrix Market file.
• MM_HEADER_WRITE prints header information to a Matrix Market file.
• MM_NNZ_SET sets the value of NNZ for the ARRAY representation.
• MM_SIZE_PRINT prints size information from a Matrix Market file.
• MM_SIZE_READ_FILE reads size information from a Matrix Market file.
• MM_SIZE_READ_STRING reads size information from a string.
• MM_SIZE_WRITE writes size information to a Matrix Market file.
• MM_VALUES_PRINT prints the matrix values of a Matrix Market file.
• MM_VALUES_PRINT_SOME prints some matrix values of a Matrix Market file.
• MM_VALUES_READ reads matrix values from a Matrix Market file.
• MM_VALUES_WRITE writes matrix values to a Matrix Market file.
• S_EQI is a case insensitive comparison of two strings for equality.
• S_NEQI compares two strings for non-equality, ignoring case.
• S_TO_I4 reads an I4 from a string.
• S_TO_I4VEC reads an I4VEC from a string.
• S_W_NEXT "reads" words from a string, one at a time.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

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