CC_IO
Read and Write Compressed Column (CC) Sparse Matrix Files

CC_IO is a C++ library which reads and writes compressed column (CC) sparse matrix files.

An MxN sparse matrix of NCC nonzero entries in compressed column format is described by three items:

• ccc(), a list of N+1 compressed column indices.
• icc(), a list of NCC row indices.
• acc(), a list of NCC values.

The nonzero entries of column J are stored in locations CCC(J) through CCC(J+1)-1 of ICC and ACC.

Licensing:

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

Languages:

CC_IO is available in a C version and a C++ version and a FORTRAN77 version and a FORTRAN90 version and a MATLAB version.

Related Data and Programs:

CC, a data directory which contains examples of matrix stored in the compressed column (CC) format.

HB_IO, a C++ library which reads and writes sparse linear systems stored in the Harwell Boeing (HB) format for sparse matrices.

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

CC_TO_ST, a C++ library which converts a sparse matrix from compressed column (CC) to sparse triple (ST) format.

Source Code:

• cc_io.cpp, the source code.
• cc_io.hpp, the include file.
• cc_io.sh, BASH commands to compile the source code.

Examples and Tests:

• cc_io_prb.cpp a sample calling program.
• cc_io_prb.sh, BASH commands to compile and run the sample program.
• cc_io_prb_output.txt, the output file.

Test #1 and #2 write and read back the information for the "simple" 5x5 matrix with 12 nonzero entries. There are files associated with this.

• simple_acc.txt, the values.
• simple_ccc.txt, the (0-based) compressed column indices.
• simple_icc.txt, the (0-based) row indices.

List of Routines:

• CC_DATA_READ reads data about a sparse matrix in CC format.
• CC_HEADER_READ reads header information about a sparse matrix in CC format.
• CC_PRINT prints a sparse matrix in CC format.
• CC_PRINT_SOME prints some of a sparse matrix in CC format.
• CC_WRITE writes a sparse matrix in CC format to 3 files.
• FILE_ROW_COUNT counts the number of row records in a file.
• I4VEC_DATA_READ reads the data from an I4VEC file.
• I4VEC_DEC decrements an I4VEC.
• I4VEC_INC increments an I4VEC.
• I4VEC_WRITE writes an I4VEC to a file.
• R8VEC_DATA_READ reads the data from an R8VEC file.
• R8VEC_WRITE writes an R8VEC file.
• S_LEN_TRIM returns the length of a string to the last nonblank.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

You can go up one level to the C++ source codes.