Reading and writing histograms to a direct access file

CALL HRPUT (ID,CHFILE,CHOPT)

Action: Write a histogram to a given direct access file. This routine cannot be used for Ntuples.  

Input parameters:

ID

Histogram identifier. ID=0 writes all histograms in the current directory to the output file.

CHFILE

Character variable or constant defining the filename.
If CHFILE=' ' the histogram is saved in the current working directory on disk.

CHOPT

Character option specifying the desired option.

'N'

Write the histogram to a New file.

'T'

Can be used together with ID=0. All histograms in the current directory and all subdirectories in memory are written to the output file.

'U'

Write the histogram to an already existing HBOOK file. When an histogram with the same identifier already exists on the output file, then a new cycle is added.

CALL HRGET (ID,CHFILE,CHOPT)

Action: Read a histogram from a given direct access file. This routine cannot be used for Ntuples.  

Input parameters:

ID

Histogram identifier. ID=0 read all histograms into the current directory.

CHFILE

Character variable or constant defining the input filename.
If CHFILE=' ' the histogram is read from the current working directory on disk.

CHOPT

Character option specifying the desired option.

'A'

Add to the current histogram in memory.

'T'

Get a complete tree (not yet implemented)

Remarks:

The following remarks apply to both HRPUT and HRGET.

• HRGET and HRPUT issue automatically Fortran OPEN and CLOSE calls.
• With HRPUT the file is created with LREC=1024 machine words.
• On VM/CMS no FILEDEF statement should be given.   The filename CHFILE can be given in either of the forms Filename Filetype Filemode or Filename.Filetype.Filemode
• On Unix the filename CHFILE will be translated to lowercase.  
• Fortran logical unit 88 is used by these routines.
• HRPUT calls HROPEN, HROUT and HREND.
• HRGET calls HROPEN, HRIN and HREND.