Call: BOOK_HISTOGRAM

reference

Contains, on successful completion of the procedure, a reference to the histogram that has been created. This reference is a Global variable of type Histogram which is from then on be used when filling the histogram with FILL_HISTOGRAM, and also when doing arithmetic with it. One can for instance add two histograms via a simple + operation between the references of the two histograms.

This parameter should have the format of a normal variable name (e.g. A, REF, B_1) not of e.g. a constant number, string or logical. This parameter can either be a new, unused, variable or one that is already in use. In the latter case, the object related to the global variable will be deleted. Hence, when you issue a BOOK_HISTOGRAM call for an histogram which already exists, you effectively reset the histogram.

This argument is mandatory.

bins

Should contain on input the Number of bins in the histogram.

The maximum number of bins is set at compilation time and equals MXLIST/2, where MXLIST is usually 1000.

This argument is optional, default value is 100 bins.

minimum

The minimum and maximum are Numbers which respectively set the lower limit of the first bin and the upper limit of the last bin of the histogram.

The AUTOSCALE option is implied if these arguments are omitted. The range is ignored if the autoscaling is explicitly requested as one of the options. If you specify the minimum, you must also specify the maximum.

You can later modify the horizontal range of the histogram: CUT_HISTOGRAM will extract a piece of an histogram, and HISTOGRAM_TO_MATRIX combined with MATRIX_TO_HISTOGRAM permits multiplying the horizontal scale by a factor.

maximum

See minimum.

options

A character String that can contain the following options:

Option	Meaning
`AUTOSCALE`	Requests automatic scaling, ignoring min and max
`INTEGER`	Entries will be integers
`MANUAL`	Manual scaling, minimum and maximum respected
`REAL`	Entries will be reals or integers

Additional information on:

AUTOSCALE	INTEGER
MANUAL	REAL

Go to the top level, to Call, to BOOK_HISTOGRAM, to the topic index, to the table of contents, or to the full text.

Formatted on 21/01/18 at 16:55.