/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=' '

'' '': 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=' '

'' '': 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.