cc_io.md

CC_IO
Read and Write Compressed Column (CC) Sparse Matrix Files {#cc_io-read-and-write-compressed-column-cc-sparse-matrix-files align="center"}

---

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: {#licensing align="center"}

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

Languages: {#languages align="center"}

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: {#related-data-and-programs align="center"}

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: {#source-code align="center"}

• cc_io.cpp, the source code.
• cc_io.hpp, the include file.

Examples and Tests: {#examples-and-tests align="center"}

• cc_io_prb.cpp a sample calling 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: {#list-of-routines align="center"}

• 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.

---

Last revised on 18 July 2014.