Global Filling

A vector or matrix can be transferred into a histogram with a single call.

CALL HPAK (ID,CONTEN)

Action: Transfer the contents of an array as channel contents into an histogram. The original contents of the histogram are overwritten.

Input parameters:

ID

an existing histogram identifier

CONTEN

a user array, suitably dimensioned

Remark:

• In the case of a 1-dimensional histogram, the dimension of the array must at least be equal to the number of histogram channels (NCHAN), i.e. DIMENSION CONTEN(NX) with NX>NCHAN
• In the case of a 2-dimensional histogram, the dimensions of the array must exactly be equal to the number of histogram channels (NCHANX and NCHANY),
  i.e. DIMENSION CONTEN(NX,NY) with NX=NCHAN and NY=NCHANY
  Projections and slices, if present for the given histogram, are not filled.    

CALL HPAKAD (ID,CONTEN)

Action: Similar to HPAK, but instead of overwriting the channel contents, the array values are added to the respective channel contents.

CALL HPAKE (ID,ERRORS)

Action: Store the contents of an array as the errors for the bins of the 1-dimensional histogram for which the option HBARX has been invoked.

Input parameters:

ID

histogram identifier

ERRORS

user array containing the errors to be assigned to the histogram bin contents. Its dimension should be at least equal to the number of channels in histogram ID.

Remark:

If the HBARX option was not set for the given histogram, then it is activited by a call to HPAKE.