TABLE_TOP
Plot Pairs of M-dimensional Data

TABLE_TOP is a FORTRAN90 program which displays patterns in a set of N points in M dimensions.

The program simply creates an array of M² two dimensional subplots. Plot (I,J) plots the I-th and J-th coordinate values against each other. Simple patterns in the data may show up in the plots.

TABLE_TOP then creates a PostScript file containing the plots, using routines from the PS_WRITE library.

Usage:

table_top data.txt

reads the data in data.txt and makes the plots.

Licensing:

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

Languages:

TABLE_TOP is available in a FORTRAN90 version.

Related Data and Programs:

PS_WRITE, a FORTRAN90 library which creates a PostScript graphics file. This library is used by TABLE_TOP.

TABLE_BARPLOT_PPMA, a FORTRAN90 program which reads a table file and creates a PPMA bargraph of the data.

TABLE_BORDER, a FORTRAN90 program which can be used to add a border (of zero values) to a table file.

TABLE_COLUMNS, a FORTRAN90 program which can extract specific columns of data from a table file.

TABLE_DELAUNAY, a FORTRAN90 program which computes the Delaunay triangulation of a set of points.

TABLE_HISTOGRAM, a FORTRAN90 program which can make a histogram of a set of points stored in a table file.

TABLE_IO, a FORTRAN90 library which supplies the routines used to read the TABLE file.

TABLE_LATINIZE, a FORTRAN90 program which reads a file of points and creates a "latinized" version by adjusting the data.

TABLE_MERGE, a FORTRAN90 program which reads a file of points and can delete points that are identical or close.

TABLE_ORTHONORMALIZE, a FORTRAN90 program which reads a file of points and orthonormalizes the columns.

TABLE_QUALITY, a FORTRAN90 program which reads a file of points and computes the quality of dispersion.

TABLE_RECORD_MATCH, a FORTRAN90 program which can be used to find close records in a table file.

TABLE_SCALE, a FORTRAN90 program which can be used to multiply the entries of a table file by a scale vector.

TABLE_SHIFT, a FORTRAN90 program which can be used to shift the entries of a table file by a shift vector.

TABLE_STATS, a FORTRAN90 program which can read a table file and compute certain statistics.

TABLE_TET_MESH, a FORTRAN90 program which can read a table file of 3D data, and compute a tetrahedral mesh.

TABLE_UNBORDER, a FORTRAN90 program which can be used to remove the border from a table file.

TABLE_UNIFORM_NOISE, a FORTRAN90 program which can be used to add a uniform noise term to the data in a table file.

TABLE_VORONOI, a FORTRAN90 program which can be used to compute information about the Voronoi diagram of the points.

Source Code:

• table_top.f90, the source code.

Examples and Tests:

POWERS.TXT is a set of data that does not lie between 0 and 1. (The TABLE_TOP program used to assume, in fact, that the data did lie between 0 and 1.) Test files you may copy include:

• powers.txt, a set of 4 dimensional sample data.
• powers_output.txt, the printed output from running TABLE_TOP on the data.
• powers.png, a PNG image of the sample data.

TABLE_TOP_INPUT.TXT is a dummy set of data. There are 10 4 dimensional points. Test files you may copy include:

• table_top_input.txt, a set of 4 dimensional sample data.
• table_top_test.txt, the printed output from running TABLE_TOP on the data.
• table_top_test.png, a PNG image of the sample data.

CVT_03_00007.TXT is a set of 3 dimensional data, generated by a centroidal Voronoi tessellation process. We were interested in seeing how the 2D projections looked. Test files you may copy include:

• cvt_03_00007.txt, a set of 3 dimensional sample data.
• cvt_03_00007_output.txt, the printed output from running TABLE_TOP on the data.
• cvt_03_00007.png, a PNG image of the sample data.
• cvt_03_00007.latin.txt, a "latinized" version of the data set.
• cvt_03_00007.latin.png, a PNG image of the "latinized" version of the data set.

CVT_03_00056.TXT is 8 times as much data as CVT_03_00007.TXT. We really hoped that we would see a pattern, and for once, our hopes were rewarded. The 2D projections clearly indicate the formation of a roughly regular grid that divides the faces into cells. Test files you may copy include:

• cvt_03_00056.txt, a set of 3 dimensional sample data.
• cvt_03_00056_output.txt, the printed output from running TABLE_TOP on the data.
• cvt_03_00056.png, a PNG image of the sample data.
• cvt_03_00056.latin.txt, a "latinized" version of the data set.
• cvt_03_00056.latin.png, a PNG image of the "latinized" version of the data set.

CVT_07_00100.TXT is a set of 7 dimensional data, generated by a centroidal Voronoi tessellation process. It is desirable to have the data points well spread out. However, the facts of 7 dimensional geometry fight against this (let alone any defects in the CVT algorithm)! Test files you may copy include:

• cvt_07_00100.txt, a set of 4 dimensional sample data.
• cvt_07_00100_output.txt, the printed output from running TABLE_TOP on the data.
• cvt_07_00100_0.png, a PNG image of the "page 0" of the sample data.
• cvt_07_00100_1.png, a PNG image of the "page 1" of the sample data.
• cvt_07_00100_2.png, a PNG image of the "page 2" of the sample data.
• cvt_07_00100_3.png, a PNG image of the "page 3" of the sample data.
• cvt_07_00100.latin.txt, a "latinized" version of the data set.
• cvt_07_00100.latin_0.png, a PNG image of the "page 0" of the "latinized" data.
• cvt_07_00100.latin_1.png, a PNG image of the "page 1" of the "latinized" data.
• cvt_07_00100.latin_2.png, a PNG image of the "page 2" of the "latinized" data.
• cvt_07_00100.latin_3.png, a PNG image of the "page 3" of the "latinized" data.

List of Routines:

• MAIN is the main program for TABLE_TOP.
• CH_EQI is a case insensitive comparison of two characters for equality.
• CH_TO_DIGIT returns the integer value of a base 10 digit.
• DTABLE_DATA_PRINT_SOME prints some of a double precision table dataset.
• DTABLE_DATA_READ reads double precision table data from a file.
• FILE_COLUMN_COUNT counts the number of columns in the first line of a file.
• FILE_NAME_EXT_GET determines the "extension" of a file name.
• FILE_NAME_EXT_SWAP replaces the current "extension" of a file name.
• FILE_ROW_COUNT counts the number of row records in a file.
• GET_UNIT returns a free FORTRAN unit number.
• PAIR_PLOT plots pairs of coordinates.
• S_BLANK_DELETE removes blanks from a string, left justifying the remainder.
• S_INDEX_LAST finds the LAST occurrence of a given substring.
• S_TO_R8 reads an R8 from a string.
• S_TO_R8VEC reads an R8VEC from a string.
• S_WORD_COUNT counts the number of "words" in a string.
• TABLE_HEADER_READ reads header data from a file.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

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