RESTORE

PHYSICA

 Syntax: RESTORE filename
 Qualifiers: \TTBUFFERS
 Defaults: \TTBUFFERS

 The RESTORE\PHYSICA command, or RESTORE with no qualifiers, restores a
 previously saved PHYSICA run. The current run will be lost in the process
 of restoring the previous session. Normally RESTORE would be used
 immediately after entering PHYSICA to continue a previous session that was
 saved with the SAVE command. An attempt is made to restore the plots that
 were active at the time the SAVE command was issued, similar to entering
 the REPLOT\ALLWINDOWS command. The hardcopy device as chosen with the
 DEVICE command is restored, as well as the orientation. User defined
 function information is not restored, but must be regenerated explicitly in
 the restored session. By default, the input line recall buffers are
 restored. If you do not want to restore these buffers when resuming a
 PHYSICA session, use the \NOTTBUFFERS qualifier.

NOVA

 Syntax: RESTORE\NOVA
 Qualifiers: \LIST, \SCATTERPLOT, \HISTOGRAM

 This is only available under DEC VAX/VMS. To access NOVA histograms, you
 must have NOVA running in the background. NOVA can be running in the same
 session or window or in another session or window. The MAP command maps to
 the global section. No name need be given. Use the RESTORE\NOVA to take a 
 "snapshot" of the data in the global section. To access the most current
 data, re-enter the RESTORE\NOVA command.

 RESTORE\NOVA will restore all of the histograms and scatterplots.
 RESTORE\NOVA\LIST  will list all of the histograms and scatterplots.
 RESTORE\NOVA\NOSCAT will restore the histograms only.
 RESTORE\NOVA\NOSCAT N will restore the histogram N only.
 RESTORE\NOVA\NOHIST N will restore the scatterplot N only.

 For 1D spectra, the vertical axis ("Counts") is actually the name of
 the spectrum.  The horizontal axis is the name of the variable.  So if
 you had done:   DEF1D/XSIZE=100/XDATA=X SX   the appropriate PHYSICA
 command would be something like: GRAPH X SX 
 HOWEVER!!! there is a real potential for confusion.  If you have different
 spectra of the same variable (X in this example) and you RESTORE more than
 one of them, what you appear to get is the most recent (i.e. last read)
 value for the vector X. This is an outstanding problem that will be fixed
 at some point in the future. The underflows and overflows for 1d histograms
 are contained in scalars named LO_name and HI_name, e.g. for histogram
 TEST, they are LO_TEST and HI_TEST.

YBOS

 Syntax: RESTORE\YBOS filename
 Qualifier: \DOTPLOT
 Default: \NODOTPLOT

 The RESTORE\YBOS restores YBOS type data files containing histograms or
 dotplots. Use the \DOTPLOT qualifier to specify that you want to restore
 a file containing dotplots. By default, the file is assumed to contain
 histogram data.

Additional Information on:

  • histograms
  • dotplots
  • 1_example
  • 2_example
  • FIOWA

     Syntax: RESTORE\FIOWA filename
    
     The RESTORE\FIOWA restores FIOWA type data files containing histograms
     and scatterplots. No special qualifiers are need to restore data sets
     made with the "big" version of FIOWA. When you restore a file (or map
     to shared memory), you get the following PHYSICA variables:
    
     variable name        type          description
     -------------------------------------------------------------------------
     DATA                 vector        all the histogram and scatterplot data
     NHIST                scalar        number of histograms
     NSCAT                scalar        number of scatterplots
     HTITLE               text          string containing all the histo. titles
     HXLABEL              text          string containing all the histo. labels
     STITLE               text          string containing all the scatp. titles
     SXLABEL              text          string containing all the scatp. xlabels
     SYLABEL              text          string containing all the scatp. ylabels
    

    Additional Information on:

  • histograms
  • scatterplots
  • 1_example
  • 2_example
  • XFIOWA

     Syntax: RESTORE\XFIOWA filename
    
     The RESTORE\XFIOWA restores eXpanded FIOWA type data files containing
     histograms and scatterplots. No special qualifiers are need to restore
     data sets made with the "big" version of FIOWA. When you restore a file
     you get the following PHYSICA variables:
    
     variable name        type          description
     -------------------------------------------------------------------------
     DATA                 vector        all the histogram and scatterplot data
     NHIST                scalar        number of histograms
     NSCAT                scalar        number of scatterplots
     HTITLE               text          string containing all the histo. titles
     HXLABEL              text          string containing all the histo. labels
     STITLE               text          string containing all the scatp. titles
     SXLABEL              text          string containing all the scatp. xlabels
     SYLABEL              text          string containing all the scatp. ylabels
    

    Additional Information on:

  • histograms
  • scatterplots
  • 1_example
  • 2_example
  • MUD

     Syntax: RESTORE\MUD filename
    
     The RESTORE\MUD command restores muSR MUD type data files containing
     histograms.  The actual histogram data is stored in a vector, HISTDATA,
     and histogram number j can be extracted using:
      HISTDATA[HISTSTART[j]:HISTEND[j]]
    

    Additional Information on:

  • general
  • comments
  • histograms
  • scalers
  • independent_variables
  • MSR

     Syntax: RESTORE\MSR filename
    
     The RESTORE\MSR command restores MSR type data files containing histograms.
     Histogram number j is stored in column j of matrix IH.  The global title is
     in a scalar text variable called TITLE.  The title for histogram number j
     is in the array text variable HTITLE[j]. There are also associated scalars
     and vectors.
    
     To plot histogram j: GRAPH\HISTOGRAM [0:(NBINS-1)*NSBIN:NSBIN] IH[1:NBINS,J]
    

    Additional Information on:

  • scalars
  • vectors
  • IMSR

     Syntax: RESTORE\IMSR filename
    
     The RESTORE\IMSR command allows you to restore IMSR type data files.
     Histogram number j is stored in column j of matrix IX. The run number
     is stored in a scalar called IRUNNO.  The version number is stored in
     a scalar called IVERS. The global title is stored in a scalar text
     variable called ITITLE. The subtitle is stored in a scalar text variable
     called ISUBTITLE. The title for histogram number j is in the array text
     variable XTITLE[j].
    
     To plot histogram J:  GRAPH\HISTOGRAM [1:VLEN(M)(1)] IX[*,J]
    

    CHAOS

     Syntax: RESTORE\CHAOS filename
    
     The RESTORE\CHAOS restores CHAOS type data files containing  histograms.
     The run number is stored in a scalar variable named RUN_NUMBER. The number
     of analyzed events is stored in a scalar variable named I_ANALYZED. The
     number of histograms and the number of channels are stored in scalar
     variables named NHIST and NCHAN. The vectors XLO, XHI, NBINS, and HSTART
     will be created. Each of these will have NHIST elements. The histogram
     data will be stored in a vector named HIST, with NCHAN elements. The
     array text variable HNAMES will be created, with NHIST elements.
     HNAMES[i] is the name of histogram number i. The array text variable
     TITLES will be created, with NHIST elements.  TITLES[i] is the title of
     histogram number i.
    
     The data for histogram i is located in HIST[HSTART[i]:NBINS[i]+HSTART[i]-1] 
     To make an x vector for plotting histogram number i, enter:
     GENERATE X XLO[I],,XHI[I] NBINS[I]+HSTART[I]-1
    

    HBOOK

     Syntax:   RESTORE\HBOOK filename
               RESTORE\HBOOK\DIR filename directory
     Examples: RESTORE\HBOOK FILE.DAT
               RESTORE\HBOOK\DIR FILE.DAT `/SUB1/SUB2'
    
     The RESTORE\HBOOK restores HBOOK type data files containing 1d histograms
     and 2d histograms (scatterplots).  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 following variables are always created.
    
     variable name        type          description
     -------------------------------------------------------------------------
     DATA                 vector        histogram and scatterplot data
     HERROR               vector        histogram and scatterplot errors
     NHIST                scalar        number of histograms
     NSCAT                scalar        number of scatterplots
     HTITLE               text          string containing all the histo. titles
     STITLE               text          string containing all the scatp. titles
    

    Additional Information on:

  • LIST
  • Ntuples
  • histograms
  • scatterplots
  • 1_example
  • 2_example