gaspan.ps

5/26/2018 gaspan.ps

1/16

"gaspan" is a program to analyze spectra with lines of gaussianshape using a peak search routine and a nonlinear fitting algorithm.Tails and nonlinear background might be included into the fit. Thefitting conditions can be tailored by specifying options and parameters 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 thecommand get can not be abbreviated because there is also a commandgenerate. 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=filename2. Definition of fit region: set fit region=firstchannel,lastchannel3. Definition of peak width: set width value=peak_width_value

The fit can be started with either the command fit or go. The resultis written into a file "gsp1filename" and spectrum and fit will bedisplayed on screen assuming the terminal is capable of graphics. Afit can be stopped by typing CTRL C (see fit).1 calibratecalibrate[ filename]

Allows the calibration or recalibration of a gaspan data summaryfile, i.e. energy and/or efficiency calibration. A filename can bespecified in the command but if it is not specified, it will beasked for one. The command is ignored if no calibration is specifiedat 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=filenameor set parameter energy=(value of coefficients) set parameter efficiency=(value of coefficients)No error propagation will be done if the calibration is inserted viathe command set parameters.

1 do

Execute a command in the shell. In order to edit a file named"data.lst" with the editor "vi" typedo vi data.lstTo get a listing of the current directory:do ls1 exit

Exits from "gaspan" and returns to the monitor. Identical to thecommand quit.1 fit Starts the fitting procedure. If no filename has been defined atthis 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 nextfilename. If the program returns to the command interpreter withoutthe message ... working on ...no fit has been done and the analysis region should be checked toinsure that it overlaps with fit regions. The peak data will be written into the file "gspNfilename" where thedigits N equals the Subspectrum number and "filename" is the filenameof the spectrum with any path specifications being stripped. This fileis written in ASCII format and can be printed and edited.

Another file "parNfilename" will be generated if the optionset fit save was given. This file holds binary data and can be usedto reconstruct the fit with the command show fit. Note: The most

, .

Wednesday February 09, 00 1/

5/26/2018 gaspan.ps

2/16

recent fit can be inspected without giving the command set fit save.

The fitting procedure can be stopped by typing CTRL C. The programwill return to the command loop once the current fit cycle is finished.The data of the fit will be saved. No residue search and parameterchecking will be done for a stopped fit.1 generategenerate[ filename]

Allows to construct gate spectrum from a binary "gaspan datasummary" file which has been obtained with the fit optionset file matrix

1 get

The get command reads information for "gaspan" from a file2 optionsget options filename

Reads the options which have been previously saved by the commandsave option orsave options filenameand sets them according to given specifications.If no filename is specified, the default filename "gaspan.sta" isassumed.The default file extension is ".sta".All previous set options are overwritten.2 parametersget parameters filename

Reads the parameters which have been previously saved by the commandsave parameter orsave parameters filenameand sets them according to given specifications. If no filenameis specified, the default filename "gaspan.stp" is assumed. Thedefault file extension is ".stp". All previous set parametersare overwritten. Note: Obsolete in "gaspan" Versions of 1993 andlater.1 go

see fit1 help "gaspan" is a program to analyze spectra with gaussian peaks by aleast square method. Deviations from a gaussian peak shape can behandled by adding left or right exponential tails to the peak. Abackground polynomial of up to fourth degree is included in the fit.Asymmetric background around the peaks can be taken care of byincluding an exponential left side tail with long decay constant("background tail"). Peaks can be either found by a peak searchroutine and a residue search or by defining a list of peaks. Thesame is true for fit regions. The working mode of "gaspan" can bedefined by setting options with the set command. Fit parameterscan 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 arraysizes.1 quit

Exits from "gaspan" and returns to the monitor. Identical to thecommand quit.1 save

Allows to save the current settings of options and parameters.

, .

2/16 Wednesday February 09, 0

5/26/2018 gaspan.ps

3/16

2 optionsave option[ filename]

Saves the current settings of the options and parameters in thespecified file. The default file type is .sta. If no filename isspecified, the default filename "gaspan.sta" is assumed. Theoptions and parameters are not changed.2 parameterssave parameters[ filename]

Saves the current settings of the parameters in the specifiedfile. The default file type is ".stp". If no filename is specified,

the default filename "gaspan.stp" is assumed. The parameters willnot be changed.This command is obsolete in versions of 1993 and later.1 set

Defines "gaspan" analysis modes and/or fit parameters.2 backgroundDefines 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 fitThe 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=valueor 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 nofitset parameters nofit=valueor equivalent fixed=(%f). Fixes the size of thebackground to the specified value. Works only with

the degree of the background polynomial set to 0.3 nofixedEquivalent 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=valuefixes the degree of the background polynomial to thevalue specified.

2 display

, .


5/26/2018 gaspan.ps

4/16

Display of spectrum and fit is possible assuming the terminal usedis capable of handling graphics. At present only TEKTRONIX graphicshas been implemented in "gaspan".3 channels

Displays the peak positions in channels. This qualifier is mutuallyexclusive 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 spectrumor show fit has been given. If the string contains specialcharacters 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 calibrationis given. The energies shown will not include peak tails, even ifthe option set tail include was given. This qualifier is mutuallyexclusive with channels.3 hold

Keeps the display on terminals which switch between alphanumericand graphic display until a character has been typed.3 linear

Displays the spectrum with a linear yscale. The display during thefitting procedure will be always with a linear scale. This qualifieris mutually exclusive with logarithmic.3 logarithmic

Displays the spectrum with a logarithmic yscale. Only effectivewith show spectrum and show fit. This qualifier is mutual exclusivewith 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 fithas been given.3 off

Turns the graphic mode off and brings the terminal back intotransparent mode if any.3 on

Display the spectrum and its fit during the fitting. Meaningless characters will be printed on a terminal not capable tohandle 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 bythe channel number. A header text displays the filename, the degreeof the background polynomial, tails if they are included in the fit,the number of peaks and the normalized chisquare.3 outset display out=output_device

, .


5/26/2018 gaspan.ps

5/16

Allows to define the queue for a laser printer for the output ofthe graphic display. Gaspan versions before May 1993 allow onlyKyocera laser printer. Gaspan versions past May 1993 generatepostscript files which can be printed by any laser printercapable 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 dataformat of the spectrum.

3 ascii_format

The input format for the spectrum is assumed to be in ASCII. Thereare two formats available: A file starting with a header included between two lines of at least20 Symbols "@" will be assumed to consist of data line starting witha channel number and followed by ten data numbers, all numbers beingintegers. 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 @ isassumed to be in a free format: Header lines must begin with a nonnumerical character (i.e. not with , + or a number). The data numbersmust be integers, separated by semicolons or at least one space, withany number of integer in a line. There is a limit of 132 charactersper line. The begin of a new subspectrum is assumed in both formats if datalines 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 eitherone spectrum or several spectra. If a data file contains severalspectra, the first spectrum in the file will be analyzed unlessthe first and last spectrum is specified. If the increment is notspecified it will be assumed to be 1. If the filename is preceded by a concatenation sign (@), it isassumed 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 notin the working directory. "gaspan" will generate an output files in the working directorywith the filename "gspNfilename" where N is the spectrum number inthe file (note, if there is only one spectrum in the file, N = 1).This file contains all information about the analysis done: Theoptions set, the fit regions with degree of the background polynomial,error code and normalized chisquare, followed by peak position witherror, peak area with error and peak width. Peak energy with error and peak width in units of the energy willbe included if an energy calibration has been specified. Intensitieswith errors will be added if an efficiency calibration has beenincluded.

, .


5/26/2018 gaspan.ps

6/16

This file contains ASCII data and can be edited. A parameter file "parNfilename" will be generated if the optionset fit save has been given. This file contains binary data andwill 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. Thefollowing 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 currentversion can be obtained with the command limitations.3 matrix

If the file specified contains several spectra it is assumedthat these spectra are from the same source but with differentgating conditions. There will be one output file ("gspfilename")of binary data. The command generate can be used to proceed withthe analysis of this binary file. This option should be used toanalyze 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 asspecified 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 commandset 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 impliesthat 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 fittingprocedure.3 background

obsolete, use set background ....3 interactive

, .


5/26/2018 gaspan.ps

7/16

Allows interactive fitting. A typical cycle will be: Define a fitregion with set fit reg=n,m, inspect the spectrum in this regionwith the command show spectrum, readjust the fit region ifnecessary and start a fit with the command fit. Peak centroids and peak areas will be output onto the screen afterthe fit is done.

This option can be disabled width the commandset fit nointeractive.

3 nobackground

obsolete, use set background ....3 nointeractive

Disables the option interactive. This option must be set, ifgaspan is used in batch mode, i.e. in the form gaspan < input_filewhere "input_file" is a file containing a set of gaspan commands.3 noout Disables a previous specified option set fit out3 noprintout

Disables the previous command set fit printout and closes thefile "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 aboutthe peak width as a function of channel number for a proper widthcalibration.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 savedin 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 ofthe 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 bespecified when using this option because only the data of the lastspectrum to be fitted will be saved. When overlapping regions are specified in one fit command, thefit 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 thestandard gsp output file.3 printout

Specifies if a printout of the fitting procedure should be doneinto the file "lptgaspan". The printout gives information about thesteps made during the fit procedure: Starting values of the peakcentroids and information about peaks added or rejected by thedifferent fit checking routines (loops) will be given. After eachloop the elapsed time, the normalized chisquare and the total numberof iterations in the loop is printed. At the end of a fit, information 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 leftwith either the command exit or quit. In order to inspect the closed file from gaspan use the command

, .


5/26/2018 gaspan.ps

8/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, orhigh which will leave or restore the priority on the currentlevel.

This option is not active yet.3 region

set fit region=minimum_channel,maximum_channel

Define define an analyzing window in the spectrum. The defaultsetting is from channel 1 to the last channel of the spectrum. This command is identical with the commandset region fit=minimum_channel,maximum_channel

3 residue_search

Poorly resolved doublets are usually not detected by the peaksearch routine but an analysis of the residue spectrum will detectsuch doublets. If this option is set, the fit will proceed untilthere are no structures in the residue spectrum left or the maximumnumber of peaks in a fitting region is exhausted (see limitations).

This option can be disabled with the commandset fit noresidue_search.3 save

This option controls whether the fit parameters are saved for laterinspection with either the command show fit or show parameters. The output will be written in binary format into a file with thename "parNfilename" where filename is the file name for the spectrumand 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 theresult of the fitting procedure.3 background_tailset parameters background_tail=(a0[,a1[,a2],d0[d1,d2]]

Allows to specify polynomial coefficients for the amplitude andthe decay constant of a background tail as a function of the channelnumber "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 peakamplitudes and should be a positive, nonzero number in the orderof 1 or less. The decay constant "dec" is specified in channels

and should also be also a positive, nonzero number. The declineof a background tail will always be to lower channel numbers. The same number of coefficients must be given for both, theamplitude and decay constants. The dependence on the channel numberis only computed for peaks in separate fit regions, all peaksin the same fit region will have the same relative amplitude anddecay 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,

, .


5/26/2018 gaspan.ps

9/16

if a background tail is specified without specifying its size.

3 check

A parameter search with a nonlinear fit procedure to minimize chisquare might not end in the minimum of chisquare. If this option isturned on, it will be checked if the fit parameters minimize chisquare and the program will return to the fit procedure if not so.This option should be handled with some care because it will takequite some time to do parameter checking with very many parameters.

The option can be turned off with the command

set parameters nocheck.3 efficiencyset parameters efficiency=(a1,a2,a3[,a4,[a5,[a6]]])

Allows to input an efficiency calibration by specifying the coefficients 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 calibration 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 uncertainty in an efficiency calibrations. Use the commandset peak efficiency for this purpose. WARNING: This function has changed in version 04.03.933 energyset parameters energy=a0[,a1[,a2[,a3]]]

Allows to input an energy calibration by specifying the coefficientsof the polynomial energy = a0 + a1 * x + a2 * x^2 + a3 * x^3with x being the channel number x. The coefficients areassumed to be free of error. Calibration points must be given in order to include the uncertainty in an energy calibrations. Use the command set peak energyfor 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 amplitudeof the peak and should be a positive, nonzero number in the orderof 1. The decay constant is specified in channels and should also bealso a positive, nonzero number. Channel dependent parameters can beentered via the coefficients of a polynomial in channels up to secondorder 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 anddecay constant. The dependence on the channel x is only computed forpeaks in separate fit regions, all peaks in the same fit region willhave 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_degreeset parameters polynomial_degree=value

obsolete, use set background ....3 right_peak_tail

, .


5/26/2018 gaspan.ps

10/16

set parameters right_peak_tail=(a0[,a1[,a2]],d0[,d1[,d2]]

The amplitude of the peaktail is defined relative to the amplitudeof the peak and should be a positive, nonzero number in the orderof 1. The decay constant is specified in channels and should also bealso a positive, nonzero number. Channel dependent parameters can beentered via the coefficients of a polynomial in channels up to secondorder 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 amplitudeand decay constant. The dependence on the channel x is only computed

for peaks in separate fit regions, all peaks in the same fit regionwill have the same relative amplitude and decay constant.

Default parameters depending on the current width are provided.3 widthset parameters width=a0[,a1[,a2[,a3]]]

Allows to input a width calibration by specifying the coefficientsof the polynomial fwhm = a0 + a1*x + a2*x^2 + a3*x^3 + a4*x^4 + a5*x^5with 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 commandset width calibrate.2 peak Allows to set or reset options concerning the peak positions andpeak 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 commandset peak noappend.3 common

All peak positions are shifted by the same amount to get the bestfit. 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 nocommonis equivalent to individual.3 efficiency

set peak efficiency=filename

Allows one to include data for an efficiency calibration eitherfrom the file "filename" or if filename=tty or tt from the keyboard. 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 filespecifies no degree of the polynomial, a degree with the best fitis searched for. This procedure takes a little bit of time! An energy calibration must be done before trying an efficiencycalibration.

An efficiency calibration may be cancelled with the optionnoefficiency.

WARNING: This function has changed in version 04.03.93

, .


5/26/2018 gaspan.ps

11/16

3 energyset peak energy=filename

Allows the inclusion of an energy calibration into the output dataeither from the file "filename" or if filename=tty or tt from thekeyboard. The input data are fitted to a polynomial of maximum5th degree. If no polynomial degree is specified, the best oneis searched for. The weight is determined by the error of the fit

ted value which implies an iterative procedure. The error of theenergy is calculated from the variancecovariance which takes thecorrelations 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 bevaried in the fit (see also nofit).3 individual

The positions of the peaks are fitted individually. During onefitting cycle the peak position is only varied in an intervalgiven 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 isequivalent to common.3 listset peak list=filename

Allows to define a list of channels contained in the file"filename" which are used as either starting points for peakpositions or as a fit with fixed peak positions. A peak listmight have the following format: peak_position peak_position width peak_position position_error width peak_position position_error peak_area area_error widthFurther 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_polynomialAll numbers must be floats. The variation of a peak positions can be controlled globallywith the command set peak nofit or individually by settingthe error on the peak position to a zero or negative value:such peak positions are kept constant. Any "gaspan" data outputfile 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 optionindividual.3 noefficiency

Disables an efficiency calibration. See option efficiency3 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

, .


5/26/2018 gaspan.ps

12/16

option residue).

The option nofitis only legal if a peaklist was defined.

3 noindividual

Disables the option individual and is identical with the optioncommon.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 specifiedwidth with the spectrum and looking for correlations. The opposite switch is list which allows to specify a list ofpeak positions.

See also list.2 region

Allows one to set analyzing windows and/or fit regions in aspectrum.

3 fitset region fit=minimum_channel,maximum_channel

Define define an analyzing window in the spectrum. The defaultsetting is from channel 1 to the last channel of the spectrum.3 listset 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 leveldensities. 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 limitationsto get information on the maximum number of regions. It is the responsibility of the user to check that the fit regionsprovided by the first and last channels are shorter than the allowedfit 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 shouldnot 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 outputof the fit data.3 allpeaks

With all given, all peaks are accepted for output independentof their statistical meaning. In order to reject peaks with largeerrors use the option noall.3 noallpeaks

, .


5/26/2018 gaspan.ps

13/16

With noall specified, peaks will be rejected in the output ifthe peak area is less than two times the statistical error of thearea.3 nostandard

With nostandard specified, it is assumed that the spectrum underconsideration does not follow a gaussian error distribution (i. e.difference spectra). An attempt will be made to estimate an averagestatistical significance in relation to the square root of theabsolute value of the data points by looking at the variation of thedata points.3 sensitivity

set statistics sensitivity=value

Sets the level of statistical significance in the peak search andresidue 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 computedfrom the square root of the number of counts in each channel.This is correct in all spectra which are not manipulated. Seeoption nostandard in other cases.2 tail

Allows one to specify the addition of left and rightsided peaktails and a long ranged leftsided background tail. Tail amplitudesare defined relative to the peak height and are the same for allpeaks 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_tailset tail background_tail=rangeparameter

Specifies if a background tail is to be added to the fit. Therange parameter allows to define the variation range of the decayconstant 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 areeither provided internally or can be inserted with the command set parameter background_tail.3 enforce_fitset tail enforce_fit

It does not make sense to vary tail parameters at peaks withpoor statistics, especially in gamma ray spectra. This optionenforces the variation of tail parameters at all peaks. The option can be disabled with the commandset tail noenforce_fit, which is the default.3 fitset 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 beon of the strings "background", "left", "right" or "all". Variation of the tail parameters can be inhibited for peaks withpoor statistics. See option noenforce_fit. Note that the variation of the decay constant is controlled viathe range parameter which can be defined in the command set tail (tailkind)=rangeparameter.

The default is fit=all.3 gamma

, .


5/26/2018 gaspan.ps

14/16

Adds a background and a left peak tail to each peak. These arethe most common tails in gammaray spectra.3 include

With the option include given, left and right peak tails areincluded in the computation of the centroid of a peak but not itserror. The contribution of peak tails is always included in thearea of the peaks and its error .he peak marker in the displayedspectrum will be placed at the position of the centroid of a peak.

The default option is noinclude.

3 left_peak_tailset 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 thedecay 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 areeither 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_fitset tail noenforce_fit

It does not make sense to vary tail parameters at peaks withpoor statistics, especially in gamma ray spectra. With thisoption the statistics in the peaks will be checked and novariation of the tail parameters will be done if the statisticsis poor. The option can be disabled with the command set tail enforce_fit.This is the default option.3 nofitset tail nofit=string

Fixes the decay constant of the tail specified by "string" to thesize 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 areaand 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_tailset 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 thedecay 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 areeither provided internally or can be inserted with the command

, .


5/26/2018 gaspan.ps

15/16

set parameter right_peak_tail.

Default is noright_peak_tail.2 width

Sets and resets parameters concerning the width of the peaks.

3 calibrateset width calibrate=filename

Gets a width calibration from the specified file. If this file isconnected 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 thedefault value.3 listset peak list=filename

The option list is only legal together with a peaklist. The widthof the peaks are taken from the width in the peaklist. If the entryfrom this list is a negative value, the width of this peak will betaken as the absolute value and will not be varied. This option isthe only method to allow for small and broad peaks simultaneouslyin a fit region. This option can be disabled with the option nolist, which isthe default.3 nocalibrate

Disables a given width calibration3 nolist

With nolist, the width of the peak is computed either by thespecified value or by a width calibration.3 rangeset width range=value

Defines the range in the width variation: the width is varied inthe region (1.+/ value)*width. The width is kept constant if valueis less than 0.01.

Use the command show option to get the default value.3 valueset 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 gaspansummary data files contains information about the fitting ofthat 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.

, .


5/26/2018 gaspan.ps

16/16

200000. Input value for background tail decay constant too large.2 fit

Displays the spectrum and its fit assuming the fit parametershave been saved with the option set fit save. In addition theresidue spectrum with marks at two standard deviations will beshown. Only the fit regions which fall into the analysis windowset by set region fit can be inspected. The display options on and off are ignored by this commandbut the qualifiers linear or logarithmic select the corresponding y scale. Peak positions are marked either with channelnumbers or with energies depending on the display qualifiers

channel or energy. Proceed to the next fit region by hitting the return key. Printthe current value of width an tail parameters by typing p.Write this fit into a file by typing w. Skip to the next spectrum with ESC. Go back to the maincommand loop width CTRLC.2 option

Shows the currently set options on the terminal.2 parameter

Shows the coefficients of the calibrations and the parameter ofthe tails as far as they are defined. The current values for thewidth and tail parameters as obtained by the last fit or the lastshow fit command are displayed, too.2 spectrum

Shows the part of the spectrum defined by the analyzing windowspecified by the option set region. Linear or logarithmic displaycan be selected by the commands set display linear or set display logarithmic.Proceed to the next spectrum or return to the command interpreterby hitting the return key.2 version

Prints the current version of gaspan1 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!

, .


gaspan.ps

Documents

Transcript of gaspan.ps