DocFile_Histogram

DocFile Histogram

Purpose

This program allows you to compute the histogram (which can be plotted withgnuplot) of a column of a document file, or the joint histogram of two columns. Columns are numerated starting at 0. If ranges are not provided the histogram is plotted between the minimum and maximum value of that column, and if they are supplied then values outside these boundaries are not counted at all.

Usage


$ docfile_histogram -i [docfile] ...

Parameters

`` Spider document file
`` Output histogram to a file, by default it is dumped to the screen

For 1D Histograms:

-col [n0] = By default, histogram1D for the first column
`` Range for the first column by default, it is automatic
-steps [N100] = Number of subdivisions for column 1
-percentil [p50] corresponds to the median)

For 2D Histograms:

`` Save histogram as an image
`` If specified, then a 2D histogram is calculated
`` Range for the second column by default, it is automatic
-steps2 [N100] = Number of subdivisions for column 2

Examples and notes

Histogram of column 0, result on screen


$ docfile_histogram -i angles.doc

Histogram of those angles between 0 and 90, in steps of 3 degrees result to a file


$ docfile_histogram -i angles.doc -range 0 90 -steps 30 -o histogram.txt

Joint histogram of tilt (column 1) and rotational (column 0) angles, with 50 steps each angle, save result as a text file and as an image


$ docfile_histogram -i angles.doc -col 1 -col2 0 -steps 50 -steps2 50 \
-o histogram2D.txt -img histogram2D.img

The text aspect of the result for a 2D histogram is like this:


     0          0         12 
     0  89.837502         10 
     0    179.675          8 
     0  269.51251         10 
21.875          0         24 
21.875  89.837502         22 
21.875    179.675         23 
21.875  269.51251         22 
 43.75          0         47 
 43.75  89.837502         46 
 43.75    179.675         46 
 43.75  269.51251         45 
65.625          0         58 
65.625  89.837502         55 
65.625    179.675         57 
65.625  269.51251         55

The first column is the value of the first variable, the second column is the value of the second variable and the third one is the count of times that a hit was achieved for this combination. For plotting it could be understood that is in the format X,Y,Z.

--Main.AlfredoSolano - 17 Jan 2007

DocFile_Histogram