Booking

[HBOOKING]

One-dimensional case

                +----------------------------------------+
                | CALL  HBOOK1 (ID,CHTITL,NX,XMI,XMA,VMX) |
                +----------------------------------------+
                                  

Action: Books a one-dimensional histogram.

Input parameter(s)

ID

histogram identifier, integer non zero

CHTITL

histogram title (character variable or constant up to 80 characters)

NX

number of channels

XMI

lower edge of first channel

XMA

upper edge of last channel

VMX

upper limit of single channel content (see below). VMX=0. means 1 word per channel (no packing).

Special values:

1. If XMA<=XMI, origin and binwidth are calculated automatically, and one word is reserved per channel. 
2. Zero (0) is an illegal histogram identifier.
3. If the histogram ID already exists it will be deleted and recreated with the new specifications. A warning message is printed.
4. VMX is used to compute the number of bits to be allocated per histogram channel. If VMX<1. then one full word is reserved per channel. When filling a histogram with weights the latter are truncated to the nearest integer unless one full word is reserved per channel (i.e. VMX = 0.). Filling with negative weights will give meaningless results unless one word per channel has been allocated. Automatic calculation of limits (XMA<=XMI) forces one word per channel.

   Two-dimensional case

              +--------------------------------------------------+
              |CALL  HBOOK2 (ID,CHTITL,NX,XMI,XMA,NY,YMI,YMA,VMX) |
              +--------------------------------------------------+
                                     

   Action: Books a two-dimensional histogram.

   Input parameter(s)

   ID

   histogram identifier, integer

   CHTITL

   histogram title (character variable or constant up to 80 characters)

   NX

   number of channels in X

   XMI

   lower edge of first X channel

   XMA

   upper edge of last X channel

   NY

   number of channels in Y

   YMI

   lower edge of first Y channel

   YMA

   upper edge of last Y channel

   VMX

   maximum population to store in 1 cell. 

   Remarks:

   1. Similar to HBOOK1, apart from automatic binning.
   2. By default, a 2-dimensional histogram will be printed as a scatterplot.
   3. If the option TABL is selected via CALL HIDOPT(ID,'TABL') TABL the 2-dimensional histogram will be printed as a table.
   4. When editing the table, the number of columns NCOL used to write the content of one cell depends on the value of VMX as follows NCOL = ALOG10(VMX) + 2. When VMX is zero, the contents is printed in 10 columns in floating point format (including sign). If necessary, all contents are multiplied by a power of 10, this number being reported at the bottom of the table.