EZBin -- An easy to use histogram interface.
This class allows the user to easily histogram data generated by a collection of objects. In addition the class will generate some standard statistics over the resulting dataset.
(const char * const *)colors count:
Set a custom vector of colors for the histogram bars
The setUpperBound method sets the non-inclusive upper bound on the histogram range.
The setLowerBound method sets the inclusive lower bound on the histogram range.
The setBinCount method sets the number of bins the histogram will have.
The setMonoColorBars method specifies whether all bars should be shown in a single color (blue). The default is differently colored bars.
(const char *)xl Y:
(const char *)yl
The setAxisLabels:X:Y method sets the horizontal and vertical labels on the histogram in the graphical version of EZBin. (Only relevant if the state of setGraphics is set to 1.)
(const char *)fileName
The setFileName method sets the name used for disk file data output. (Only relevant if the state of seFileOutput is set to 1.) If not set, the filename defaults to be the same as the graph title.
(const char *)title
The setTitle method uses a title string to label a graph window in the graphical version of EZBin. The label appears at the top of the graph window. (Only relevant if the state of setGraphics is set to 1.)
The setFileOutput method sets the state of file I/O. Set the state to 1 if data for the sequences is to be sent to a file. The default state is 0 meaning that by default no file I/O is carried out by the EZBin class.
The setProbedSelector method sets the selector that will be applied to the objects in the specified collection in order to generate the dataset (inherited from MessageProbe.)
- setCollection: aCollection
The setCollection method sets the collection of target objects which will be requested to generate the dataset for the histogram.
The setGraphics method sets the state of the display. Set the state to 0 if a graphical display of the graph is not required. The default state is 1 meaning that by default the data appears graphically in a window.
- (const char *)getFileName
Return the filename string.
- (const char *)getTitle
Return the title string.
- (id <Histogram>)getHistogram
Return the histogram widget.
The getStd method gets the standard deviation in the dataset. The value is read out of the object, not computed everytime it is asked for.
The getAverage method gets the average value in the dataset. The value is read out of the object, not computed everytime it is asked for.
The getMax method gets the maximum value in the dataset.
The getMin method gets the minimum value in the dataset.
The getUpperBound method gets the upper bound on the histogram range.
The getLowerBound method gets the lower bound on the histogram range.
The getBinColorCount method gets the number of distinct bin colors allocated (by default, or by the user).
The getBinCount method gets the number of bins in the histogram.
The getOutliers method gets the number of entries which landed out of the bounds of the histogram. Pressing the "o" key on the graphical representation of the histogram will display this value both as an integer and as a percentage of the total number of attempted entries.
The getCount method gets the number of entries which landed within the bounds of the histogram.
- (unsigned *)getDistribution
The getDistribution method returns an array of integers containing the number of entries which landed in each bin of the histogram.
The output: method combines the actions of -outputGraph and -outputToFile. If graph updates and file output need to happen at different frequencies, schedule calls to -outputGraph and -outputToFile instead of -output.
The outputToFile method causes the number of entries per bin to be sent to the output file, using the data extracted by the previous call to update. If setFileOutput==0, nothing is done.
The ouputGraph method causes the graphical display to be updated with the information extracted by the previous call to update. If setGraphics==0, nothing is done.
The update method polls the collection of objects and adds the data to the final data set. It is possible to poll the same collection of objects repeatedly, thus increasing the amount of data included in the final dataset, before generating output.
The reset method resets the histogram.
Sets the number of significant figures shown for major-tick labels.