You are on page 1of 16

"gaspan" is a program to analyze spectra with lines of gaussian

shape using a peak search routine and a nonlinear fitting algorithm.


Tails and nonlinear background might be included into the fit. The
fitting conditions can be tailored by specifying options and para
meters of the fit.
The general structure of a command is:
command [subcommand] [option]=[parameter]
All input can be abbreviated to the amount that it is still unique,
i.e. the command help can be abbreviated to hel, he or h whereas the
command get can not be abbreviated because there is also a command
generate. Gaspan command lines are subject to a history mechanism,
i.e. old commands can be retrieved with the arrow keys.
A minimum input is needed for a rough fit:
1. Definition of Data: set file file=filename
2. Definition of fit region: set fit region=firstchannel,lastchannel
3. Definition of peak width: set width value=peak_width_value
The fit can be started with either the command fit or go. The result
is written into a file "gsp1filename" and spectrum and fit will be
displayed on screen assuming the terminal is capable of graphics. A
fit can be stopped by typing CTRL C (see fit).
1 calibrate
calibrate[ filename]
Allows the calibration or recalibration of a gaspan data summary
file, i.e. energy and/or efficiency calibration. A filename can be
specified in the command but if it is not specified, it will be
asked for one. The command is ignored if no calibration is specified
at the time of its issue and an error message will be given.
Calibrations can be specified with the commands
set peak energy=filename
set peak efficiency=filename
or
set parameter energy=(value of coefficients)
set parameter efficiency=(value of coefficients)
No error propagation will be done if the calibration is inserted via
the command set parameters.
1 do
Execute a command in the shell. In order to edit a file named
"data.lst" with the editor "vi" type
do vi data.lst
To get a listing of the current directory:
do ls
1 exit
Exits from "gaspan" and returns to the monitor. Identical to the
command quit.
1 fit
Starts the fitting procedure. If no filename has been defined at
this point, the user will be asked for. If the file is not present,
an error message will be given and the program proceeds to the next
filename. If the program returns to the command interpreter without
the message
... working on ...
no fit has been done and the analysis region should be checked to
insure that it overlaps with fit regions.
The peak data will be written into the file "gspNfilename" where the
digits N equals the Subspectrum number and "filename" is the filename
of the spectrum with any path specifications being stripped. This file
is written in ASCII format and can be printed and edited.
Another file "parNfilename" will be generated if the option
set fit save was given. This file holds binary data and can be used
to reconstruct the fit with the command show fit. Note: The most
Feb 09, 98 15:31 Page 1/16 gaspan.hlp
Wednesday February 09, 00 1/16
recent fit can be inspected without giving the command set fit save.

The fitting procedure can be stopped by typing CTRL C. The program
will return to the command loop once the current fit cycle is finished.
The data of the fit will be saved. No residue search and parameter
checking will be done for a stopped fit.
1 generate
generate[ filename]
Allows to construct gate spectrum from a binary "gaspan data
summary" file which has been obtained with the fit option
set file matrix
1 get
The get command reads information for "gaspan" from a file
2 options
get options filename
Reads the options which have been previously saved by the command
save option or
save options filename
and sets them according to given specifications.
If no filename is specified, the default filename "gaspan.sta" is
assumed.
The default file extension is ".sta".
All previous set options are overwritten.
2 parameters
get parameters filename
Reads the parameters which have been previously saved by the command
save parameter or
save parameters filename
and sets them according to given specifications. If no filename
is specified, the default filename "gaspan.stp" is assumed. The
default file extension is ".stp". All previous set parameters
are overwritten. Note: Obsolete in "gaspan" Versions of 1993 and
later.
1 go
see fit
1 help
"gaspan" is a program to analyze spectra with gaussian peaks by a
least square method. Deviations from a gaussian peak shape can be
handled by adding left or right exponential tails to the peak. A
background polynomial of up to fourth degree is included in the fit.
Asymmetric background around the peaks can be taken care of by
including an exponential left side tail with long decay constant
("background tail"). Peaks can be either found by a peak search
routine and a residue search or by defining a list of peaks. The
same is true for fit regions. The working mode of "gaspan" can be
defined by setting options with the set command. Fit parameters
can be saved to review the fit at a later time.
2 info

No information written at the moment
1 limitations
Gives a printout of the restrictions to "gaspan" imposed by array
sizes.
1 quit
Exits from "gaspan" and returns to the monitor. Identical to the
command quit.
1 save
Allows to save the current settings of options and parameters.
Feb 09, 98 15:31 Page 2/16 gaspan.hlp
2/16 Wednesday February 09, 00
2 option
save option[ filename]
Saves the current settings of the options and parameters in the
specified file. The default file type is .sta. If no filename is
specified, the default filename "gaspan.sta" is assumed. The
options and parameters are not changed.
2 parameters
save parameters[ filename]
Saves the current settings of the parameters in the specified
file. The default file type is ".stp". If no filename is specified,
the default filename "gaspan.stp" is assumed. The parameters will
not be changed.
This command is obsolete in versions of 1993 and later.
1 set
Defines "gaspan" analysis modes and/or fit parameters.
2 background

Defines the parameters for calculating a background in the
fit region. The background can be a polynomial in channel
number up to 4th degree and in addition a tail on the left
side of a peak proportional to the height of the peak.
See option set tail background. The size of the
background can be fixed to a specified value if the
polynomial degree of the background is chosen to be 0.
Default is a maximum polynomial degree of 2 and no
background tail.
3 fit

The background polynomial is fitted with a degree
specified by either set background polynomial_degree
or set background max_polynomial_degree.
3 fixed=(%f)
set parameters fixed=value

or equivalent nofit=(%f). Fixes the size of the
background to the specified value. Works only with
the degree of the background polynomial set to 0.
3 nofit
set parameters nofit=value

or equivalent fixed=(%f). Fixes the size of the
background to the specified value. Works only with
the degree of the background polynomial set to 0.
3 nofixed

Equivalent to set background fit
3 max_polynomial_degree=(%d)
set parameters max_polynomial_degree=value

allows to specify the maximum polynomial degree which is
to be used in the fit. A smaller polynomial degree might
actually be used because "gaspan" tries to get an estimate
for the polynomial degree using the size of the fit region
and the quality of the statistics.
3 polynomial_degree=(%d)
set parameters polynomial_degree=value

fixes the degree of the background polynomial to the
value specified.

2 display
Feb 09, 98 15:31 Page 3/16 gaspan.hlp
Wednesday February 09, 00 3/16
Display of spectrum and fit is possible assuming the terminal used
is capable of handling graphics. At present only TEKTRONIX graphics
has been implemented in "gaspan".
3 channels
Displays the peak positions in channels. This qualifier is mutually
exclusive with energy.
3 comment
set display comment=string
Allows to specify a comment in the display of the spectrum.
"string" will be shown in the display if a command show spectrum
or show fit has been given. If the string contains special
characters it should be put into quotes "". A comment can be
erased by just using the option comment.
3 energy
Displays the peak positions in energies if an energy calibration
is given. The energies shown will not include peak tails, even if
the option set tail include was given. This qualifier is mutually
exclusive with channels.
3 hold

Keeps the display on terminals which switch between alphanumeric
and graphic display until a character has been typed.
3 linear
Displays the spectrum with a linear yscale. The display during the
fitting procedure will be always with a linear scale. This qualifier
is mutually exclusive with logarithmic.
3 logarithmic
Displays the spectrum with a logarithmic yscale. Only effective
with show spectrum and show fit. This qualifier is mutual exclusive
with linear.
3 nohold
Disables the option hold. Default setting for Xwindow terminals
3 nosingle_peak
Draws only spectrum, fit and background fit if the command show fit
has been given.
3 off
Turns the graphic mode off and brings the terminal back into
transparent mode if any.
3 on
Display the spectrum and its fit during the fitting. Meaning
less characters will be printed on a terminal not capable to
handle TEKTRONIX 4014 graphics.
On each fitting sequence the following spectra will be shown:
The fit spectrum and the background polynomial as continuous lines,
the fitted spectrum as a histogram, and
the residue spectrum with the statistical limit corresponding to
two standard deviations.
The peaks included in the fit are shown by vertical bars marked by
the channel number. A header text displays the filename, the degree
of the background polynomial, tails if they are included in the fit,
the number of peaks and the normalized chisquare.
3 out
set display out=output_device
Feb 09, 98 15:31 Page 4/16 gaspan.hlp
4/16 Wednesday February 09, 00
Allows to define the queue for a laser printer for the output of
the graphic display. Gaspan versions before May 1993 allow only
Kyocera laser printer. Gaspan versions past May 1993 generate
postscript files which can be printed by any laser printer
capable of postscript.
Possible output queues for Kyocera type are:
BL: set display out="lpr Purwald"
set display out="lpr Ptraum"
set display out="lpr Ptraum_white"
LMU: set display out="lpr Pdeb_kyocera"
for postscript:
LMU: set display out="lpr Zp Pdeb_ljsi"
3 single_peak
Draws each single peak if the command show fit has been given.
This mode can be switched off with the option nosingle_peak.
2 files
Allows to specify a filename for the spectrum and defines the data
format of the spectrum.
3 ascii_format
The input format for the spectrum is assumed to be in ASCII. There
are two formats available:
A file starting with a header included between two lines of at least
20 Symbols "@" will be assumed to consist of data line starting with
a channel number and followed by ten data numbers, all numbers being
integers. Numbers must be separated by either spaces or semicolons.
The width of the numbers is free.
A file starting with a header not included in a row of @ is
assumed to be in a free format: Header lines must begin with a non
numerical character (i.e. not with , + or a number). The data numbers
must be integers, separated by semicolons or at least one space, with
any number of integer in a line. There is a limit of 132 characters
per line.
The begin of a new subspectrum is assumed in both formats if data
lines are followed by a new header.
This qualifier is the complement to the online_format qualifier;
both are mutually exclusive.
3 file
set files file=filename[,firstspectrum,lastspectrum[,increment]]
set files file=path/filename[,firstspectrum,lastspectrum[,increment]]
set files file=@filename
The parameter specifies the filename of the file containing either
one spectrum or several spectra. If a data file contains several
spectra, the first spectrum in the file will be analyzed unless
the first and last spectrum is specified. If the increment is not
specified it will be assumed to be 1.
If the filename is preceded by a concatenation sign (@), it is
assumed that this file contains a list of filenames to be worked at.
The user must have write permission in the directory, "gaspan"
has been started. A path can be specified if the data file is not
in the working directory.
"gaspan" will generate an output files in the working directory
with the filename "gspNfilename" where N is the spectrum number in
the file (note, if there is only one spectrum in the file, N = 1).
This file contains all information about the analysis done: The
options set, the fit regions with degree of the background polynomial,
error code and normalized chisquare, followed by peak position with
error, peak area with error and peak width.
Peak energy with error and peak width in units of the energy will
be included if an energy calibration has been specified. Intensities
with errors will be added if an efficiency calibration has been
included.
Feb 09, 98 15:31 Page 5/16 gaspan.hlp
Wednesday February 09, 00 5/16
This file contains ASCII data and can be edited.
A parameter file "parNfilename" will be generated if the option
set fit save has been given. This file contains binary data and
will be needed for later viewing of the fit!
A history of the fit procedure will be written in the file
"lptgaspan.dat" if the option set fit print was set.
3 format
set file format=FORMAT
Allows to specify the data format in the input file. The
following file formats are standard:
FORMAT = ascii: The file is assumed to be an ascii file with
a header (i.e line which contain at least one
non numerical character) and a sequence of
channel contents, at least one per line, and
a length of line less than 130 characters.
Several spectra might be in one file,
separated by headers. Subspectra are addressed
by the subspectrum number.
FORMAT = dat: The file is assumed to be an ascii file with
a header followed by lines containing either
channel contents
channel number and channel contents
channel number_x channel number_y channel contents
The numbers can be either integers or floats.
Only one spectrum per file is allowed.
The information about special formats included in the current
version can be obtained with the command limitations.
3 matrix
If the file specified contains several spectra it is assumed
that these spectra are from the same source but with different
gating conditions. There will be one output file ("gspfilename")
of binary data. The command generate can be used to proceed with
the analysis of this binary file. This option should be used to
analyze matrices of spectra.
This qualifier is the complement to the single_spectrum qualifier;
both are mutually exclusive.
3 online_format
Assumes the spectrum file is written in the a binary mode as
specified by the local online Format specification.
This qualifier is the complement to the ascii_format qualifier;
both qualifiers are mutually exclusive.
3 reset
Deletes a filename specification given with a previous command
set file file=filename.
3 single_spectrum
If the file specified contains several spectra it is assumed
that these spectra are independent from each other. This implies
that there will be one output file ("gspNfilename") for each spectrum.
This qualifier is the complement to the matrix qualifier;
both are mutually exclusive.
2 fit
Allows one to set and cancel different options during the fitting
procedure.
3 background
obsolete, use set background ....
3 interactive
Feb 09, 98 15:31 Page 6/16 gaspan.hlp
6/16 Wednesday February 09, 00
Allows interactive fitting. A typical cycle will be: Define a fit
region with set fit reg=n,m, inspect the spectrum in this region
with the command show spectrum, readjust the fit region if
necessary and start a fit with the command fit.
Peak centroids and peak areas will be output onto the screen after
the fit is done.
This option can be disabled width the command
set fit nointeractive.
3 nobackground
obsolete, use set background ....
3 nointeractive
Disables the option interactive. This option must be set, if
gaspan is used in batch mode, i.e. in the form
gaspan < input_file
where "input_file" is a file containing a set of gaspan commands.
3 noout
Disables a previous specified option set fit out
3 noprintout
Disables the previous command set fit printout and closes the
file "lptgaspan"
3 noresidue_search

Disables the search for unresolved peaks in the residue spectrum.
This option should be used only for a rough fit to get an idea about
the peak width as a function of channel number for a proper width
calibration.
3 nosave
Disables the saving of the fit parameters for later inspection.
3 out
The fit spectrum and the background spectrum of a fit will be saved
in a file "filenamefit.dat" and "filenamebck.dat" in datformat i.e.
channel and contents as integers. The spectrum data are preceded
by a line starting with a #sign and containing the filename of
the spectrum the fit belongs to.
The file will contain all the fit data of the most recent fit
command.
Multiple filenames in the option set fit file= should not be
specified when using this option because only the data of the last
spectrum to be fitted will be saved.
When overlapping regions are specified in one fit command, the
fit data of the first fit region will be contained in the over
lapping region.
The peak data, i.e. centroid and area, can be obtained from the
standard gsp output file.
3 printout
Specifies if a printout of the fitting procedure should be done
into the file "lptgaspan". The printout gives information about the
steps made during the fit procedure: Starting values of the peak
centroids and information about peaks added or rejected by the
different fit checking routines (loops) will be given. After each
loop the elapsed time, the normalized chisquare and the total number
of iterations in the loop is printed. At the end of a fit, informa
tion about the peak width and tails is given, if tails are included
in the fit.
The file "lptgaspan" will be closed (and ready for inspection)
if the command set fit noprint is given or if the program is left
with either the command exit or quit.
In order to inspect the closed file from gaspan use the command
Feb 09, 98 15:31 Page 7/16 gaspan.hlp
Wednesday February 09, 00 7/16
do pg lptgaspan.
This option can be disabled with the command set fit noprintout.
3 priority
Allows to define the level of priority during the fitting.
Legal parameters are normal which will lower the priority, or
high which will leave or restore the priority on the current
level.
This option is not active yet.
3 region
set fit region=minimum_channel,maximum_channel
Define define an analyzing window in the spectrum. The default
setting is from channel 1 to the last channel of the spectrum.
This command is identical with the command
set region fit=minimum_channel,maximum_channel
3 residue_search
Poorly resolved doublets are usually not detected by the peak
search routine but an analysis of the residue spectrum will detect
such doublets. If this option is set, the fit will proceed until
there are no structures in the residue spectrum left or the maximum
number of peaks in a fitting region is exhausted (see limitations).
This option can be disabled with the command
set fit noresidue_search.
3 save
This option controls whether the fit parameters are saved for later
inspection with either the command show fit or show parameters.
The output will be written in binary format into a file with the
name "parNfilename" where filename is the file name for the spectrum
and N is the number of the subspectrum in this file.
Note: The last fit can be always inspected!
This option is disabled with the command set fit nosave.
2 parameters
Allows one to define and change fit parameters and control the
result of the fitting procedure.
3 background_tail
set parameters background_tail=(a0[,a1[,a2],d0[d1,d2]]
Allows to specify polynomial coefficients for the amplitude and
the decay constant of a background tail as a function of the channel
number "x":
amp = a0 + a1 * x + a2 + x^2
dec = d0 + d1 * x + d2 * x^2
The amplitude "amp" of the tail is defined relatively to the peak
amplitudes and should be a positive, nonzero number in the order
of 1 or less. The decay constant "dec" is specified in channels
and should also be also a positive, nonzero number. The decline
of a background tail will always be to lower channel numbers.
The same number of coefficients must be given for both, the
amplitude and decay constants. The dependence on the channel number
is only computed for peaks in separate fit regions, all peaks
in the same fit region will have the same relative amplitude and
decay constant.
Warning: The decay constants of the combined options
background_tail and left_peak_tail should be
well distinct in size.
Default parameters depending on the current width are provided,
Feb 09, 98 15:31 Page 8/16 gaspan.hlp
8/16 Wednesday February 09, 00
if a background tail is specified without specifying its size.
3 check
A parameter search with a nonlinear fit procedure to minimize chi
square might not end in the minimum of chisquare. If this option is
turned on, it will be checked if the fit parameters minimize chi
square and the program will return to the fit procedure if not so.
This option should be handled with some care because it will take
quite some time to do parameter checking with very many parameters.
The option can be turned off with the command
set parameters nocheck.
3 efficiency
set parameters efficiency=(a1,a2,a3[,a4,[a5,[a6]]])
Allows to input an efficiency calibration by specifying the coef
ficients of the polynomial
eff = 0.5*erfc[a1^2*(xa2)] * 10**(a3 + a4*lx + a5*lx^2 + a6*lx^3)
lx = log10(x)
with the efficiency eff and the energy e, i.e. an efficiency calib
ration is only possible if an energy calibration has been included.
The coefficients are assumed to be free of error.
Calibration points must be given in order to include the uncer
tainty in an efficiency calibrations. Use the command
set peak efficiency for this purpose.
WARNING: This function has changed in version 04.03.93
3 energy
set parameters energy=a0[,a1[,a2[,a3]]]
Allows to input an energy calibration by specifying the coefficients
of the polynomial
energy = a0 + a1 * x + a2 * x^2 + a3 * x^3
with x being the channel number x. The coefficients are
assumed to be free of error.
Calibration points must be given in order to include the uncer
tainty in an energy calibrations. Use the command set peak energy
for this purpose.
3 left_peak_tail
set parameters left_peak_tail=(a0[,a1[,a2]],d0[,d1[,d2]]
The amplitude of the peaktail is defined relative to the amplitude
of the peak and should be a positive, nonzero number in the order
of 1. The decay constant is specified in channels and should also be
also a positive, nonzero number. Channel dependent parameters can be
entered via the coefficients of a polynomial in channels up to second
order in the form
amp = a0 + a1 * x + a2 + x^2
dec = d0 + d1 * x + d2 * x^2
The same number of coefficients must be given for both amplitude and
decay constant. The dependence on the channel x is only computed for
peaks in separate fit regions, all peaks in the same fit region will
have the same relative amplitude and decay constant.
Warning: The decay constants of the combined option left_peak_tail
and background_tail should be well distinct in size.
Default parameters depending on the current width are provided.
3 nocheck
Disables the option check.
3 polynomial_degree
set parameters polynomial_degree=value
obsolete, use set background ....
3 right_peak_tail
Feb 09, 98 15:31 Page 9/16 gaspan.hlp
Wednesday February 09, 00 9/16
set parameters right_peak_tail=(a0[,a1[,a2]],d0[,d1[,d2]]
The amplitude of the peaktail is defined relative to the amplitude
of the peak and should be a positive, nonzero number in the order
of 1. The decay constant is specified in channels and should also be
also a positive, nonzero number. Channel dependent parameters can be
entered via the coefficients of a polynomial in channels up to second
order in the form
amp = a0 + a1 * x + a2 + x^2
dec = d0 + d1 * x + d2 * x^2
The same number of coefficients must be given for both amplitude
and decay constant. The dependence on the channel x is only computed
for peaks in separate fit regions, all peaks in the same fit region
will have the same relative amplitude and decay constant.
Default parameters depending on the current width are provided.
3 width
set parameters width=a0[,a1[,a2[,a3]]]
Allows to input a width calibration by specifying the coefficients
of the polynomial
fwhm = a0 + a1*x + a2*x^2 + a3*x^3 + a4*x^4 + a5*x^5
with the full width half maximum "fwhm" and the channel number x.
The coefficients are assumed to be free of error.
Calibration points can be used with the command
set width calibrate.
2 peak
Allows to set or reset options concerning the peak positions and
peak data.
3 append
The fit information will be appended to a previous file
"gspNfilename" and "parNfilename" if they exist.
Note: Fit options and parameters will not be appended.
The append mode can be disabled with the command
set peak noappend.
3 common
All peak positions are shifted by the same amount to get the best
fit. This option is only legal if a peak list was specified before.
This option can be turned off with the command set peak nocommon.
The option common is equivalent to noindividual and nocommon
is equivalent to individual.
3 efficiency
set peak efficiency=filename
Allows one to include data for an efficiency calibration either
from the file "filename" or if filename=tty or tt from the key
board. The input data are fitted by the following function:
eff = 0.5 * erfc[a1^2*(xa2)] * 10^(a3 + a4*lx + a5*lx^2 + a6*lx^3)
with lx = log10(x)
where the energy should be specified in keV. If the input file
specifies no degree of the polynomial, a degree with the best fit
is searched for. This procedure takes a little bit of time!
An energy calibration must be done before trying an efficiency
calibration.
An efficiency calibration may be cancelled with the option
noefficiency.
WARNING: This function has changed in version 04.03.93
Feb 09, 98 15:31 Page 10/16 gaspan.hlp
10/16 Wednesday February 09, 00
3 energy
set peak energy=filename
Allows the inclusion of an energy calibration into the output data
either from the file "filename" or if filename=tty or tt from the
keyboard. The input data are fitted to a polynomial of maximum
5th degree. If no polynomial degree is specified, the best one
is searched for. The weight is determined by the error of the fit
ted value which implies an iterative procedure. The error of the
energy is calculated from the variancecovariance which takes the
correlations of the coefficients into account.
An energy calibration can be undone with the option noenergy.
3 fit
The option fit specifies that the peak positions are to be
varied in the fit (see also nofit).
3 individual
The positions of the peaks are fitted individually. During one
fitting cycle the peak position is only varied in an interval
given by the width of the peaks. The negation of this option
(noindividual) is only legal if a peaklist was defined.
individual is equivalent to nocommon and noindividual is
equivalent to common.
3 list
set peak list=filename
Allows to define a list of channels contained in the file
"filename" which are used as either starting points for peak
positions or as a fit with fixed peak positions. A peak list
might have the following format:
peak_position
peak_position width
peak_position position_error width
peak_position position_error peak_area area_error width
Further numbers in a line are ignored.
The list or part of the list might be preceded by a region
definition
R channel_min channel_max degree_of_background_polynomial
All numbers must be floats.
The variation of a peak positions can be controlled globally
with the command set peak nofit or individually by setting
the error on the peak position to a zero or negative value:
such peak positions are kept constant. Any "gaspan" data output
file can be used as input file.
This option can be disabled with the option search.
3 noappend

Switches the append mode off.
3 nocommon
Disables the option commonand is identical with the option
individual.
3 noefficiency
Disables an efficiency calibration. See option efficiency
3 noenergy
Disables an energy calibration. See option energy.
3 nofit
With nofit specified, no variation of the peak position is done,
although peaks might be added by a search of the residue (see the
Feb 09, 98 15:31 Page 11/16 gaspan.hlp
Wednesday February 09, 00 11/16
option residue).

The option nofitis only legal if a peaklist was defined.
3 noindividual
Disables the option individual and is identical with the option
common.
3 nolist
Disables a peak list. Equivalent with search.
3 search
Peak positions are searched for by a peak searching routine.
This is done by folding a zero area gaussian with the specified
width with the spectrum and looking for correlations.
The opposite switch is list which allows to specify a list of
peak positions.
See also list.
2 region
Allows one to set analyzing windows and/or fit regions in a
spectrum.
3 fit
set region fit=minimum_channel,maximum_channel
Define define an analyzing window in the spectrum. The default
setting is from channel 1 to the last channel of the spectrum.
3 list
set region list=filename
Allows one to specify a file which contains a list of regions.
A list of regions should be provided for spectra with high level
densities.
The format of this list must be:
any number of comment lines
R, first channel, last channel, degree of background polynomial
All numbers in floating point format, use the command limitations
to get information on the maximum number of regions.
It is the responsibility of the user to check that the fit regions
provided by the first and last channels are shorter than the allowed
fit region as specified in "limitations."
list is the complement of search which is equivalent to nolist.
3 nolist
Disables a region list. Equivalent with search.
3 search
The fit regions are determined by the program. This option should
not be used if the spectrum is characterized by a high level density.
search is identical to nolist.
2 statistics
Allows to define statistical conditions for the fit and the output
of the fit data.
3 allpeaks
With all given, all peaks are accepted for output independent
of their statistical meaning. In order to reject peaks with large
errors use the option noall.
3 noallpeaks
Feb 09, 98 15:31 Page 12/16 gaspan.hlp
12/16 Wednesday February 09, 00
With noall specified, peaks will be rejected in the output if
the peak area is less than two times the statistical error of the
area.
3 nostandard
With nostandard specified, it is assumed that the spectrum under
consideration does not follow a gaussian error distribution (i. e.
difference spectra). An attempt will be made to estimate an average
statistical significance in relation to the square root of the
absolute value of the data points by looking at the variation of the
data points.
3 sensitivity
set statistics sensitivity=value
Sets the level of statistical significance in the peak search and
residue search routine to either 3 times the statistical error
(value=normal) or 2 times the statistical error (value=high).
3 standard
With standard, the weight in calculating chisquare is computed
from the square root of the number of counts in each channel.
This is correct in all spectra which are not manipulated. See
option nostandard in other cases.
2 tail
Allows one to specify the addition of left and rightsided peak
tails and a long ranged leftsided background tail. Tail amplitudes
are defined relative to the peak height and are the same for all
peaks in a fit region.
By default, no tails are added to the fit (i. e. set tail none)
3 all
Adds all three tails to the fit.
3 background_tail
set tail background_tail=rangeparameter
Specifies if a background tail is to be added to the fit. The
range parameter allows to define the variation range of the decay
constant of the tail which should be a number in the interval
[0.;0.8]. The decay constant is fixed if the range parameter is 0.
The default value is 0.8. Decay constant and tail amplitude are
either provided internally or can be inserted with the command
set parameter background_tail.
3 enforce_fit
set tail enforce_fit
It does not make sense to vary tail parameters at peaks with
poor statistics, especially in gamma ray spectra. This option
enforces the variation of tail parameters at all peaks.
The option can be disabled with the command
set tail noenforce_fit, which is the default.
3 fit
set tail fit=string
Specifies if tail amplitudes are to be varied to get the best fit.
Variation of the relative amplitude extends over any positive number.
The parameter string allows to select a specific tail and should be
on of the strings "background", "left", "right" or "all".
Variation of the tail parameters can be inhibited for peaks with
poor statistics. See option noenforce_fit.
Note that the variation of the decay constant is controlled via
the range parameter which can be defined in the command
set tail (tailkind)=rangeparameter.
The default is fit=all.
3 gamma
Feb 09, 98 15:31 Page 13/16 gaspan.hlp
Wednesday February 09, 00 13/16
Adds a background and a left peak tail to each peak. These are
the most common tails in gammaray spectra.
3 include
With the option include given, left and right peak tails are
included in the computation of the centroid of a peak but not its
error. The contribution of peak tails is always included in the
area of the peaks and its error .he peak marker in the displayed
spectrum will be placed at the position of the centroid of a peak.
The default option is noinclude.
3 left_peak_tail
set tail left_peak_tail=rangeparameter
Specifies if a left tail at the peak is to be added to the fit.
The range parameter allows to define the variation range of the
decay constant of the tail and should be a number in the interval
[0.;0.8]. The decay constant is fixed if the range parameter is 0.
The default value is 0.8. Decay constant and tail amplitude are
either provided internally or can be inserted with the command
set parameter left_peak_tail.
The default option is noleft_peak_tail.
3 nobackground_tail
Eliminates a background tail from the fit.
3 noenforce_fit
set tail noenforce_fit
It does not make sense to vary tail parameters at peaks with
poor statistics, especially in gamma ray spectra. With this
option the statistics in the peaks will be checked and no
variation of the tail parameters will be done if the statistics
is poor.
The option can be disabled with the command set tail enforce_fit.
This is the default option.
3 nofit
set tail nofit=string

Fixes the decay constant of the tail specified by "string" to the
size specified by the command set parameters string=(values).
"string" may take the values "all", "background_tail",
"left_peak_tail" or right_peak_tail".
3 noinclude
Does not include the area of the peak tails into the peak area
and centroid given by the output after a fit.
3 noleft_peak_tail
Eliminates a left tail to the peaks from the fit.
3 none
Eliminates all tails from the fit.
3 noright_peak_tail
Eliminates a righttail to the peaks from the fit.
3 right_peak_tail
set tail right_peak_tail=rangeparameter
Specifies if a right tail at the peak is to be added to the fit.
The range parameter allows to define the variation range of the
decay constant of the tail and should be a number in the interval
[0.;0.8]. The decay constant is fixed if the range parameter is 0.
The default value is 0.8. Decay constant and tail amplitude are
either provided internally or can be inserted with the command
Feb 09, 98 15:31 Page 14/16 gaspan.hlp
14/16 Wednesday February 09, 00
set parameter right_peak_tail.
Default is noright_peak_tail.
2 width
Sets and resets parameters concerning the width of the peaks.
3 calibrate
set width calibrate=filename
Gets a width calibration from the specified file. If this file is
connected to a terminal (i.e. filename = tt or tty), the calibration
can be typed in interactively and an output file can be generated.
If a filename is not specified, the width will be reset to the
default value.
3 list
set peak list=filename
The option list is only legal together with a peaklist. The width
of the peaks are taken from the width in the peaklist. If the entry
from this list is a negative value, the width of this peak will be
taken as the absolute value and will not be varied. This option is
the only method to allow for small and broad peaks simultaneously
in a fit region.
This option can be disabled with the option nolist, which is
the default.
3 nocalibrate
Disables a given width calibration
3 nolist
With nolist, the width of the peak is computed either by the
specified value or by a width calibration.
3 range
set width range=value
Defines the range in the width variation: the width is varied in
the region (1.+/ value)*width. The width is kept constant if value
is less than 0.01.
Use the command show option to get the default value.
3 value
set width value=value
Allows the definition of a starting value for the width.
Warning: This option overrides a width calibration.
Use the command show option to get the default value.
1 show
Displays options or current settings or shows spectrum and fit.
2 error
The 4th number in the lines starting with "R" of the gaspan
summary data files contains information about the fitting of
that fit region. The following error indicators are ored to
gether in this number:
0. No problems encountered during fit.
1. Lines too close to define a fit region:
Some lines at lower channels have been dropped.
10. Too many lines in a fit region:
The residue search had to be stopped.
100. Input value for width too small.
200. Input value for width too large.
1000. Input value for left tail decay constant too small.
2000. Input value for left tail decay constant too large.
10000. Input value for right tail decay constant too small.
20000. Input value for right tail decay constant too large.
100000. Input value for background tail decay constant too small.
Feb 09, 98 15:31 Page 15/16 gaspan.hlp
Wednesday February 09, 00 15/16
200000. Input value for background tail decay constant too large.
2 fit
Displays the spectrum and its fit assuming the fit parameters
have been saved with the option set fit save. In addition the
residue spectrum with marks at two standard deviations will be
shown. Only the fit regions which fall into the analysis window
set by set region fit can be inspected.
The display options on and off are ignored by this command
but the qualifiers linear or logarithmic select the corres
ponding y scale. Peak positions are marked either with channel
numbers or with energies depending on the display qualifiers
channel or energy.
Proceed to the next fit region by hitting the return key. Print
the current value of width an tail parameters by typing p<cr>.
Write this fit into a file by typing w<cr>.
Skip to the next spectrum with ESC<cr>. Go back to the main
command loop width CTRLC.
2 option
Shows the currently set options on the terminal.
2 parameter
Shows the coefficients of the calibrations and the parameter of
the tails as far as they are defined. The current values for the
width and tail parameters as obtained by the last fit or the last
show fit command are displayed, too.
2 spectrum
Shows the part of the spectrum defined by the analyzing window
specified by the option set region. Linear or logarithmic display
can be selected by the commands
set display linear or set display logarithmic.
Proceed to the next spectrum or return to the command interpreter
by hitting the return key.
2 version
Prints the current version of gaspan
1 test
Allows to test the correct operation of the fit procedure of
gaspan
2 spectrum
Generates spectra which can be analyzed by gaspan.
2 printout
Only for the purpose of debugging!
Feb 09, 98 15:31 Page 16/16 gaspan.hlp
16/16 Wednesday February 09, 00