/HISTOGRAM_CREATE


Creation ('booking') of HBOOK objects in memory.

 /HISTOGRAM/CREATE/1DHISTO id title ncx xmin xmax [ valmax ]
 

 ID
         C
           Histogram Identifier Loop
 TITLE
         C
           Histogram title D=' '
 NCX
         I
           Number of channels D=100
 XMIN
         R
           Low edge D=0.
 XMAX
         R
           Upper edge D=100.
 VALMAX
         R
           Maximum bin content D=0.
 

Create a one dimensional histogram. The contents are set to zero. If VALMAX=0, then a full word is allocated per channel,
else VALMAX is used as the maximum bin content allowing several channels to be stored into the same machine word.

 /HISTOGRAM/CREATE/PROFILE id title ncx xmin xmax ymin ymax [ chopt ]
 

 ID
        C
          Histogram Identifier
 TITLE
        C
          Histogram title D=' '
 NCX
        I
          Number of channels D=100
 XMIN
        R
          Low edge in X D=0.
 XMAX
        R
          Upper edge in X D=100.
 YMIN
        R
          Low edge in Y D=-1.E30
 YMAX
        R
          Upper edge in Y D=1.E30
 CHOPT
        C
          Options D=' '
 

CHOPT:

 '' ''
       Error on mean
 'S'
       Spread option
 

Create a profile histogram. Profile histograms accumulate statistical quantities of a variable y in bins of a variable x. The
contents are set to zero.

 /HISTOGRAM/CREATE/BINS id title ncx xbins [ valmax ]
 

 ID
         C
           Histogram Identifier
 TITLE
         C
           Histogram title D=' '
 NCX
         I
           Number of channels D=100
 XBINS
         C
           Vector of NCX+1 low-edges
 VALMAX
         R
           Maximum bin content D=0.
 

Create a histogram with variable size bins. The low-edge of each bin is given in vector XBINS (NCX+1) values. The
contents are set to zero. See 1DHISTO for VALMAX.

 /HISTOGRAM/CREATE/2DHISTO id title ncx xmin xmax ncy ymin ymax [ valmax ]
 

 ID
         C
           Histogram Identifier Loop
 TITLE
         C
           Histogram title D=' '
 NCX
         I
           Number of channels in X D=40
 XMIN
         R
           Low edge in X D=0.
 XMAX
         R
           Upper edge in X D=40.
 NCY
         I
           Number of channels in Y D=40
 YMIN
         R
           Low edge in Y D=0.
 YMAX
         R
           Upper edge in Y D=40.
 VALMAX
         R
           Maximum bin content D=0.
 

Create a two dimensional histogram. The contents are set to zero. See 1DHISTO for VALMAX.

 /HISTOGRAM/CREATE/PROX id
 

 ID
      C
        Histogram (2-Dim) Identifier Loop
 

Create the projection onto the x axis. The projection is not filled until the Histo/Project command is executed. To plot
projection X of ID type:

 
      PAW > HI/PLOT ID.PROX

 /HISTOGRAM/CREATE/PROY id
 

 ID
      C
        Histogram (2-Dim) Identifier Loop
 

Create the projection onto the y axis. The projection may be filled with Histo/Project. To plot projection Y of ID type:

 
      PAW > HI/PLOT ID.PROY

 /HISTOGRAM/CREATE/SLIX id nslices
 

 ID
         C
           Histogram (2-Dim) Identifier Loop
 NSLICES
         I
           Number of slices
 

Create projections onto the x axis, in y-slices. The projection may be filled with Histo/Project. To plot slice 3 in X of ID type:

 
      PAW > HI/PLOT ID.SLIX.3

 /HISTOGRAM/CREATE/SLIY id nslices
 

 ID
         C
           Histogram (2-Dim) Identifier Loop
 NSLICES
         I
           Number of slices
 

Create projections onto the y axis, in x-slices. The projection may be filled with Histo/Project. To plot slice 2 in Y of ID type:

 
      PAW > HI/PLOT ID.SLIY.2

 /HISTOGRAM/CREATE/BANX id ymin ymax
 

 ID
       C
         Histogram (2-Dim) Identifier Loop
 YMIN
       R
         Low edge in Y
 YMAX
       R
         Upper edge in Y
 

Create a projection onto the x axis, in a band of y. Several bands can be defined on the one histogram. The projection may be
filled with Histo/Project. To plot band 1 in X of ID type:

 
      PAW > HI/PLOT ID.BANX.1

 /HISTOGRAM/CREATE/BANY id xmin xmax
 

 ID
       C
         Histogram (2-Dim) Identifier Loop
 XMIN
       R
         Low edge in X
 XMAX
       R
         Upper edge in X
 

Create a projection onto the y axis, in a band of x. Several bands can be defined on the one histogram. The projection may be
filled with Histo/Project. To plot band 1 in Y of ID type:

 
      PAW > HI/PLOT ID.BANY.1

 /HISTOGRAM/CREATE/TITLE_GLOBAL [ chtitl chopt ]
 

 CHTITL
        C
          Global title D=' '
 CHOPT
        C
          Options D=' '
 

CHOPT:

 '' ''
       The global title is plotted at the top of each picture.
 'U'
       If the option 'UTIT' is on, a user title is plotted at the bottom of each histogram.
 

Set the global title. The size and the Y position of the global title may be changed by the commands SET GSIZ and SET
YGTI respectively. The size and the Y position of the user title may be changed by the commands SET TSIZ and SET YHTI
respectively.