TABLE_HISTOGRAM
Histogram Table Data

TABLE_HISTOGRAM is a FORTRAN90 program which reads a table of data from a TABLE file, and computes a histogram for each column of data.

The user specifies the number of bins, and the minimum and maximum values of data to bin. This interval is divided up into equal intervals or "bins", and the number of data items in each bin is counted.

The program writes the histogram data to an output TABLE file, consisting of one column of bin center values, and a column of population counts for each column of input data.

Usage:

table_histogram table_file bin_num bin_min bin_max

• table_file, the file containing the data.
• bin_num, the number of bins.
• bin_min, bin_max, the range of values to bin.

Licensing:

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

Languages:

TABLE_HISTOGRAM is available in a FORTRAN90 version.

Related Programs:

HISTOGRAM_DISPLAY, is a MATLAB program which can read the histogram data file created by table_histogram and display it as a stacked bar plot.

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_COLUMNS_PERMUTE, a FORTRAN90 program which permutes the columns of a table file.

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

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 removes duplicates, and points that are close to each other.

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_TOP, a FORTRAN90 program which can read a table file of M-dimensional data and make a table of plots of all pairs of coordinates.

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_histogram.f90, the source code;
• table_histogram.sh, commands to compile and load the source code;

Examples and Tests:

• p01_00050_quality.txt, a sample text file of 5 columns and 129 lines;
• p01_00050_quality.txt.histo, the histogram file with 10 bins between 0 and 1;
• p01_00400_quality.txt, a sample text file of 5 columns and 1675 lines;
• p01_00400_quality.txt.histo, the histogram file with 10 bins between 0 and 1;
• p01_03200_quality.txt, a sample text file of 5 columns and 16595 lines;
• p01_03200_quality.txt.histo, the histogram file with 10 bins between 0 and 1;

List of Routines:

• MAIN is the main routine for the TABLE_HISTOGRAM program.
• CH_CAP capitalizes a single character.
• CH_EQI is a case insensitive comparison of two characters for equality.
• CH_TO_DIGIT returns the integer ( kind = 4 ) value of a base 10 digit.
• FILE_COLUMN_COUNT counts the number of columns in the first line of a file.
• FILE_ROW_COUNT counts the number of rows in a file.
• GET_UNIT returns a free FORTRAN unit number.
• R8MAT_DATA_READ reads data from an R8MAT file.
• R8MAT_HEADER_READ reads the header from an R8MAT file.
• R8MAT_WRITE writes an R8MAT file.
• R8VEC_HISTOGRAM histograms an R8VEC.
• S_BLANK_DELETE removes blanks from a string, left justifying the remainder.
• S_TO_I4 reads an I4 from a string.
• 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.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

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