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

reads the data from table_file, and for each column in the data, computes a histogram of bin_num bins, between the values bin_min and bin_max. The histogram data is written to an output file with a name "similar" to the input file.

Related Programs:

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

TABLE is a format used to store the input and output data.

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

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

TABLE_COLUMNS is an executable FORTRAN90 program which can extract specific columns of data from a table file.

TABLE_COLUMNS_PERMUTE is an executable FORTRAN90 program which permutes the columns of a table file.

TABLE_DELAUNAY is an executable FORTRAN90 program which computes the Delaunay triangulation of a set of points.

TABLE_DIAPHONY is an executable FORTRAN90 program which computes the diaphony of a set of points stored in a table file.

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

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

TABLE_MERGE is a FORTRAN90 program that reads a file of points, and removes duplicates, and points that are close to each other.

TABLE_ORTHONORMALIZE is a FORTRAN90 program that reads a file of points and orthonormalizes the columns.

TABLE_QUALITY is a FORTRAN90 program that reads a file of points and computes the quality of dispersion.

TABLE_READ is a MATLAB script that can read in a TABLE file.

TABLE_RECORD_MATCH is an executable FORTRAN90 program that can be used to find close records in a table file.

TABLE_SCALE is an executable FORTRAN90 program that can be used to multiply the entries of a table file by a scale vector.

TABLE_SHIFT is an executable FORTRAN90 program that can be used to shift the entries of a table file by a shift vector.

TABLE_STATS is an executable FORTRAN90 program that can read a table file and compute certain statistics.

TABLE_TET_MESH is an executable FORTRAN90 program that can read a table file of 3D data, and compute a tetrahedral mesh.

TABLE_TOP is an executable FORTRAN90 program that can read a table file of M-dimensional data and make a table of plots of all pairs of coordinates.

TABLE_UNBORDER is an executable FORTRAN90 program that can be used to remove the border from a table file.

TABLE_UNIFORM_NOISE is an executable FORTRAN90 program that can be used to add a uniform noise term to the data in a table file.

TABLE_VORONOI is an executable 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.csh, 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 program for TABLE_HISTOGRAM.
• CH_CAP capitalizes a single character.
• 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_READ reads data from a double precision table file.
• DTABLE_DATA_WRITE writes data to a double precision table file.
• DTABLE_HEADER_READ reads the header from a double precision table file.
• DTABLE_HEADER_WRITE writes the header to a double precision table file.
• DTABLE_WRITE writes a double precision table file.
• 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.
• 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.
• TIMESTRING writes the current YMDHMS date into a string.

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