table_io

table_io, a Python code which reads or writes a TABLE file.

A TABLE file is a simple format for storing a double-indexed array of data. We regard this is a situation involving N points in M dimensions, with M relatively small (often just 2 or 3, but possibly 10 or 20) while N can be "enormous" (10, 100, 1,000 or 10,000).

To keep things simple, then, the data is written to an ASCII file, with optional comment lines (which must start with the '#' character) and blank lines (which are ignored). The point data is stored by writing the coordinates of each point on a separate line. No information about M or N is explicitly included in the file. It is up to the I/O program to determine this.

The code supplies routines by which a TABLE file can easily be written or read. A typical write operation simply calls routine R8MAT_WRITE. A typical read operation will probably first want to call R8MAT_HEADER_READ to determine the values of M and N, and then allocate space for the table, and then call r8mat_data_read() to read the data.

Licensing:

The information on this web page is distributed under the MIT license.

Languages:

table_io is available in a C version and a C++ version and a Fortan90 version and a MATLAB version and an Octave version and a Python version.

Related Data and Programs:

table, a format which is used for the files input or output by table_io().

Source Code:

• table_io.py, calls all the tests.
• table_io.sh, runs all the tests.
• table_io.txt, the output file.

• i4mat_write_test.txt, a file created by the test for I4MAT_WRITE.
• i4vec_write_test.txt, a file created by the test for I4VEC_WRITE.
• r8mat_write_test.txt, a file created by the test for R8MAT_WRITE.
• r8vec_write_test.txt, a file created by the test for R8VEC_WRITE.
• r8vec2_write_test.txt, a file created by the test for R8VEC2_WRITE.