"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