RESTORE:HBOOK

LIST

 Syntax:   RESTORE\HBOOK\LIST filename
           RESTORE\HBOOK\LIST\DIR filename directory
 Examples: RESTORE\HBOOK\LIST FILE.DAT
           RESTORE\HBOOK\LIST\DIR FILE.DAT `/SUB1/SUB2'

 If you use the \LIST qualifer, a listing of the contents of the data
 file will be displayed on your monitor screen.  If the \DIR qualifier
 is used, the ZEBRA RZ directory within the file can be entered, using
 the absolute pathname in the ZEBRA syntax. The listing is produced by
 the HLDIR routine from the CERN library.

Ntuples

 Syntax: RESTORE\HBOOK\RWN filename id
         RESTORE\HBOOK\RWN\DIR filename directory id

 This command will restore the Row Wise Ntuple with identification number
 id from an HBOOK data file.  If the \DIR qualifier is used, the ZEBRA RZ
 directory within the file can be entered, using the absolute pathname in
 the ZEBRA syntax.  By default, a vector will be created for each variable
 in the Ntuple, where the names of these vectors will be the tag names
 of the variables in the Ntuple.

 For now, Column Wise Ntuples cannot be restored in physica.

Additional Information on:

  • MATRIX

    • histograms

     For histogram number j, you get the following PHYSICA variables:

 variable name        type          description
 ------------------------------------------------------------------------
 ID1[j]               vector        histogram identifier
 NBINS[j]             vector        number of bins
 NOENT[j]             vector        number of entries in histogram
 HMEAN[j]             vector        mean value
 HSTD[j]              vector        standard deviation
 HEQUIV[j]            vector        number of equivalent events ???
 HSTART[j]            vector        starting index
 HXLO[j]              vector        xmin
 HXINC[j]             vector        bin size
 HLO[j]               vector        underflow
 HHI[j]               vector        overflow
 STRTHT[j]            vector        starting index for title
 LENHT[j]             vector        length of title

    Additional Information on:

  • NOENT
  • HLO
  • HHI
  • HEQUIV
  • HSTD
  • HMEAN

    • scatterplots

     For scatterplot number j, you get the following PHYSICA variables:

 variable name        type          description
 ------------------------------------------------------------------------
 ID2[j]               vector        scatterplot identifier
 SNOENT[j]            vector        number of entries in scatterplot
                                    (including under/overflows)
 NSBINX[j]            vector        number of bins in x
 NSBINY[j]            vector        number of bins in y
 ISCAT[j]             vector        index of first bin 
 SXLO[j]              vector        x minimum
 SXINC[j]             vector        x increment
 SYLO[j]              vector        y minimum
 SYINC[j]             vector        y increment
 OUTSID[1:8,j]        matrix        underflows and overflows
 STRTST[j]            vector        starting index for title
 LENST[j]             vector        length of title

    Additional Information on:

  • under_overflows

    • 1_example

     To plot histogram n:

 label\xaxis htitle[strtht[n]:strtht[n]+lenht[n]-1]
 scalar\dummy j
 graph\hist loop(hxlo[n]+(j-0.5)*hxinc[n],j,1:nbins[n]) -
  data[hstart[n]:hstart[n]+nbins[n]-1]

 or

 label\xaxis htitle[strtht[n]:strtht[n]+lenht[n]-1]
 generate x hxlo[n] hxinc[n],,nbins[n]
 y = data[hstart[n]:hstart[n]+nbins[n]-1]
 error = herror[hstart[n]:hstart[n]+nbins[n]-1]
 graph x y

    2_example

     To plot scatterplot n, using the diffusion type of density plot:

 label\xaxis stitle[strtst[n]:strtst[n]+lenst[n]-1]
 scalar\dummy j
 x = loop(sxlo[n]+(j-0.5)*sxinc[n],j,1:nsbinx[n])
 y = loop(sylo[n]+(j-0.5)*syinc[n],j,1:nsbiny[n])
 m = fold(data[iscat[n]:iscat[n]+nsbinx[n]*nsbiny[n]-1],nsbinx[n])
 density\profiles\diffusion x y <-m  ! <- is the transpose operator