XXX-HIST: Build a histogram for a quantity using data from log files. There is a version of this program for each application (eg, net-hist). Each version allows histograms to be created for the set of quantities defined for that application. The histogram is written to standard output, in a form suitable for plotting. Usage: xxx-hist quantities low high bins { log-file [ range ] } [ / { app-args } ] Here 'xxx' is a prefix identifying the particular incarnation of this program. The 'quantities' specification says what to make a histogram of; 'low' and 'high' give the range, which is divided into 'bins' bins. There follow specifications of where the data comes from; and perhaps further arguments, depending on the application (for which, see the documentation specific to that application - eg, net-hist.doc). For the format of the quantity specifications, see the documentation on generic quantities, quantities for Monte Carlo runs, quantities for neural networks, etc. Many quantities may be given; all their values are merged in one histogram. Data comes from records with indexes in the specified ranges within the log files mentioned. The ranges have the form "[low][:[high]]][%mod]". The low bound defaults to one. If no high bound is given, the range extends to the highest index in the log file. If the "%mod" option is present, only iterations within the range whose index is a multiple of "mod" are used (e.g. "5:12%3" is equivalent to 6 9 12). If no range is given, the default is "1:". The output consists as many lines as bins, with each line giving the value at the centre of the bin and either the count of values falling within the bin or the fraction of values falling within the bin. The latter option is selected by preceding the number of bins with a minus sign. Values falling outside the range are discarded, except that they affect the normalization of counts to give fractions. Copyright (c) 1995-2003 by Radford M. Neal