SAVED*ATA -- This command
is similar to SAVE (see above), but has one major difference.
It will save the data in the spectra as well, as the definitions. To restore
the contents of a SAVEDATA file, the procedure is the same as that for
the SAVE command. (See note below).
‘Save file name? ‘ asks you for
a file name that you wish the save file data to be written out to. It is
very important to NOT specify the file extension as the program will be
generating more than one file and they will have their file types defined
for them. When restoring the setup, the file is to be entered as an @ file
should have a .DAT file extension and it will load in all the other files.
All of the files generated from this command will have the same name, but
different file extensions. SA*VE does not generate more than one file.
SDEF*INE-- This is the command
to define a spectrum or histogram.
‘Spc?’ asks for each spectrum you
wish to define individually. (This process will continue until you type
return to get back to the main command level).
i.) One Dimensional Spectrum format
spc-name : par / div [off:len/type]
c-nam
spc-name : par [len/type] c-nam
spc-name-- The name of the spectra,
terminated by the symbol
par-- The parameter that the spectrum
is making a histogram of.
div-- The division factor for the
parameter. The value must be power of two. If absent, one is assumed.
Off-- The offset value for the channels
to take data for (0 is assumed if absent).
len-- The number of channels of
the histogram.
type - Specifies the BPC of the
spectrum
c-nam-- An optional condition that
is to be satisfied before the spectrum can be incremented.
ii.) Two Dimensional Spectrum format
spc-name : x-par/x-div,y-par/y-div[x-off:x-len,y-off:y-len/type]
c-nam
spc-name : x-par , y-par (x-off:x-len,
y-off:y-len/type] c-nam
spc-name-- The name of the spectra,
terminated by the symbol.
x-par-- The x parameter that the
spectrum is making a histogram of.
x-div-- The division factor for
the x parameter 1 absent)
x-off-- The offset in the x direction
for the channels 0 if absent)
x-len-- The number of channels in
the x direction of the spectrum.
y-par-- The y parameter that the
spectrum is making a histogram of.
y-div-- The division factor for
the y parameter
y-off-- The offset in the y direction
for the channels
y-len-- The number of channels in
the y direction of the spectrum. type-- Specifies the BPC for the spectrum
c-nam-- An optional condition that is to be satisfied before the spectrum
can be incremented.
iii.) Bit Spectrum Format
spc-name : par B c-nam
spc-name-- The name of the spectra,
terminated by the : symbol.
par-- The parameter that the spectrum
is making a histogram of.
c-nam-- An optional condition that
is to be satisfied before the spectrum can be incremented.
A bit spectrum is unusual in that the channels are not incremented according to the value of the parameter being used, but by the bits that are set within that parameter. A bit spectrum is always eighty-five channels long, although only every fifth channel actually gets used. The rest are for spacing purposes. If bit zero of the parameter being examined is set, then channel 80 is incremented. If bit one is set, then channel 75 is set, etc. It’s usually used in examining which bits are getting set in the event bitmask.
SDEL*ETE-- This will delete
a spectrum from the program.
‘Spc to delete?’ asks for the name
of the spectra that the user wishes the program to delete. "ALL"
will cause the program to select all the current spectra.
S*LIST-- This types out a list of all spectra and their definitions.
SLISTF*ULL-- This is a debug style list command that will act as SLIST but will in addition display pointer values that the user is not normally interested in. This function can also accessed by typing SLF.
SPCO*FF-- This will deactivate the user written subroutine SPCSU3 from the program's data processing sequence.
SPC*SUB-- This will activate the user written subroutine SPCSUB into the program’s data processing sequence. The routine be called just before the program starts checking the event data for sorting.
SP*RINT -- This will print all of the spectrum definitions out to the machine’s console.
SRE*NAME -- This will allow the user to replace a spectrum’s present name with a different name that is of the same or shorter length. See BRE for an explanation of the prompt.
STOP-- This will, allow the user to exit from SMAUG. As a reminder SMAUG will prompt: ‘Do you want to dump the present spectrum files (ren=no)?' Answering Yes will cause SMAUG to execute the command DUMP before exiting. SMAUG will exit if a carriage return is typed.
SWR*ITE-- This will write all of
the spectrum definitions out to a file.
‘File name? ‘ asks for the file
name that it is to write the definitions out to.