/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.

The histogram titles may have the following form:

'Histogram_title ; XXX ; YYY'

Where 'XXX' and 'YYY' are respectively the X, and axis titles.

/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.

The histogram titles may have the following form:

'Histogram_title ; XXX ; YYY ; ZZZ'

Where 'XXX', 'YYY' and 'ZZZ' are respectively the X, Y and Z axis titles.

/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.