Scale Definition and Normalization

Note that, whenever a multiplication by a power of ten appears in the output, it means that the quantity it refers to has been multiplied by that factor before being printed.

The scaling of the contents while outputing a 1-dimensional histogram is chosen by default to be linear and to span the interval between the minimum and the maximum of the contents of the channels.

The options described below allow:

• the choice of a logarithmic contents scale
• the definition of the limits of the scale
• the choice of the minimum step of the scale to be an integer
• the choice of the same scale for several histograms so that they can be compared more easily
• the normalisation of the total contents to a given value

If the identifier corresponds to a 2-dimensional histogram, they act on projections, slices, bands if any.

CALL HMINIM (ID,FMIN)

Action: The scale limits for a histogram are not calculated automatically, but they as set to the specified values. The histogram contents are left intact.

Input parameters:

ID

Histogram identifier.
ID=0 Meams apply limit to all existing histograms.

FMAX(FMIN)

Maximum (minimum) for contents scale of given histogram.
When FMAX$\le$ FMIN then the maximum and minimum values of the scale are computed automatically.

These routines can be called as often as desired for a given histogram.

CALL HCOMPA (IDVECT,N)

Action: Compare the contents of all histograms whose identifiers are contained in array IDVECT and assign them the same vertical scale. The comparison is made on the basis of the contents at the time routine is called.

Input parameters:

IDVECT

Array of N elements that contain the identifiers of the histograms to be compared The array must be dimensioned in the calling program to a length larger or equal to N.

N

Number of histograms to be compared
N=0 Means compare all existing 1-dimensional histograms.

Remark:

This routine can be called as often as desired to recompute the histogram scales.

CALL HNORMA (ID,XNORM)

Action: Normalizes the total contents of a 1-dimensional histogram when printing it. Original contents are left intact.

Input parameters:

ID

Histogram identifier
ID=0 Meams apply normalization factor to all existing histograms

XNORM

Normalization factor to be applied to histogram when printing.
XNORM=0 is illegal.

Remark:

• If a function is superimposed, it is not affected by the normalization
• The histogram can have error bars
• The normalization factor can be redefined at any time.

CALL HSCALE (ID,FACTOR)

Action: The contents scale for a scatter plot is multiplied by a given factor.

Input parameters:

ID

Histogram identifier
ID=0 Means apply scaling factor to to all existing 2-dimensional histograms.

FACTOR

Scaling factor to be applied to the contents scale.
FACTOR=0 means automatic scaling. The range will be from the minimum to the maximum of the actual contents.

In a scatter-plot the contents scale starts at 0. and increases in steps of 1. The content of each channel is represented by one character, using the following scheme:

|>r@>l@>l<l<$l<$