 |
ROOT 6.08/07 Reference Guide |
| |
ROOT 6.08/07 Reference Guide |
Advanced Spectra Processing.
This class contains advanced spectra processing functions for:
The algorithms in this class have been published in the following references:
These NIM papers are also available as doc or ps files from:
See also the online documentation and tutorials.
Definition at line 20 of file TSpectrum.h.
Public Types | |
| enum | { kBackOrder2 =0, kBackOrder4 =1, kBackOrder6 =2, kBackOrder8 =3, kBackIncreasingWindow =0, kBackDecreasingWindow =1, kBackSmoothing3 =3, kBackSmoothing5 =5, kBackSmoothing7 =7, kBackSmoothing9 =9, kBackSmoothing11 =11, kBackSmoothing13 =13, kBackSmoothing15 =15 } |
 Public Types inherited from TObject | |
| enum | { kIsOnHeap = 0x01000000, kNotDeleted = 0x02000000, kZombie = 0x04000000, kBitMask = 0x00ffffff } |
| enum | { kSingleKey = BIT(0), kOverwrite = BIT(1), kWriteDelete = BIT(2) } |
| enum | EStatusBits { kCanDelete = BIT(0), kMustCleanup = BIT(3), kObjInCanvas = BIT(3), kIsReferenced = BIT(4), kHasUUID = BIT(5), kCannotPick = BIT(6), kNoContextMenu = BIT(8), kInvalidObject = BIT(13) } |
Public Member Functions | |
| TSpectrum () | |
| Constructor. More... | |
| TSpectrum (Int_t maxpositions, Double_t resolution=1) | |
| virtual | ~TSpectrum () |
| Destructor. More... | |
| virtual TH1 * | Background (const TH1 *hist, Int_t niter=20, Option_t *option="") |
| One-dimensional background estimation function. More... | |
| const char * | Background (Double_t *spectrum, Int_t ssize, Int_t numberIterations, Int_t direction, Int_t filterOrder, bool smoothing, Int_t smoothWindow, bool compton) |
| This function calculates background spectrum from source spectrum. More... | |
| const char * | Deconvolution (Double_t *source, const Double_t *response, Int_t ssize, Int_t numberIterations, Int_t numberRepetitions, Double_t boost) |
| One-dimensional deconvolution function. More... | |
| const char * | DeconvolutionRL (Double_t *source, const Double_t *response, Int_t ssize, Int_t numberIterations, Int_t numberRepetitions, Double_t boost) |
| One-dimensional deconvolution function. More... | |
| TH1 * | GetHistogram () const |
| Int_t | GetNPeaks () const |
| Double_t * | GetPositionX () const |
| Double_t * | GetPositionY () const |
| virtual void | Print (Option_t *option="") const |
| Print the array of positions. More... | |
| virtual Int_t | Search (const TH1 *hist, Double_t sigma=2, Option_t *option="", Double_t threshold=0.05) |
| One-dimensional peak search function. More... | |
| Int_t | Search1HighRes (Double_t *source, Double_t *destVector, Int_t ssize, Double_t sigma, Double_t threshold, bool backgroundRemove, Int_t deconIterations, bool markov, Int_t averWindow) |
| Old name of SearcHighRes introduced for back compatibility. More... | |
| Int_t | SearchHighRes (Double_t *source, Double_t *destVector, Int_t ssize, Double_t sigma, Double_t threshold, bool backgroundRemove, Int_t deconIterations, bool markov, Int_t averWindow) |
| One-dimensional high-resolution peak search function. More... | |
| void | SetResolution (Double_t resolution=1) |
| NOT USED resolution: determines resolution of the neighbouring peaks default value is 1 correspond to 3 sigma distance between peaks. More... | |
| const char * | SmoothMarkov (Double_t *source, Int_t ssize, Int_t averWindow) |
| One-dimensional markov spectrum smoothing function. More... | |
| const char * | Unfolding (Double_t *source, const Double_t **respMatrix, Int_t ssizex, Int_t ssizey, Int_t numberIterations, Int_t numberRepetitions, Double_t boost) |
| One-dimensional unfolding function. More... | |
| Public Member Functions inherited from TNamed | |
| TNamed () | |
| TNamed (const char *name, const char *title) | |
| TNamed (const TString &name, const TString &title) | |
| TNamed (const TNamed &named) | |
| TNamed copy ctor. More... | |
| virtual | ~TNamed () |
| virtual void | Clear (Option_t *option="") |
| Set name and title to empty strings (""). More... | |
| virtual TObject * | Clone (const char *newname="") const |
| Make a clone of an object using the Streamer facility. More... | |
| virtual Int_t | Compare (const TObject *obj) const |
| Compare two TNamed objects. More... | |
| virtual void | Copy (TObject &named) const |
| Copy this to obj. More... | |
| virtual void | FillBuffer (char *&buffer) |
| Encode TNamed into output buffer. More... | |
| virtual const char * | GetName () const |
| Returns name of object. More... | |
| virtual const char * | GetTitle () const |
| Returns title of object. More... | |
| virtual ULong_t | Hash () const |
| Return hash value for this object. More... | |
| virtual Bool_t | IsSortable () const |
| virtual void | ls (Option_t *option="") const |
| List TNamed name and title. More... | |
| TNamed & | operator= (const TNamed &rhs) |
| TNamed assignment operator. More... | |
| virtual void | SetName (const char *name) |
| Set the name of the TNamed. More... | |
| virtual void | SetNameTitle (const char *name, const char *title) |
| Set all the TNamed parameters (name and title). More... | |
| virtual void | SetTitle (const char *title="") |
| Set the title of the TNamed. More... | |
| virtual Int_t | Sizeof () const |
| Return size of the TNamed part of the TObject. More... | |
| Public Member Functions inherited from TObject | |
| TObject () | |
| TObject constructor. More... | |
| TObject (const TObject &object) | |
| TObject copy ctor. More... | |
| virtual | ~TObject () |
| TObject destructor. More... | |
| void | AbstractMethod (const char *method) const |
| Use this method to implement an "abstract" method that you don't want to leave purely abstract. More... | |
| virtual void | AppendPad (Option_t *option="") |
| Append graphics object to current pad. More... | |
| virtual void | Browse (TBrowser *b) |
| Browse object. May be overridden for another default action. More... | |
| virtual const char * | ClassName () const |
| Returns name of class to which the object belongs. More... | |
| virtual void | Delete (Option_t *option="") |
| Delete this object. More... | |
| virtual Int_t | DistancetoPrimitive (Int_t px, Int_t py) |
| Computes distance from point (px,py) to the object. More... | |
| virtual void | Draw (Option_t *option="") |
| Default Draw method for all objects. More... | |
| virtual void | DrawClass () const |
| Draw class inheritance tree of the class to which this object belongs. More... | |
| virtual TObject * | DrawClone (Option_t *option="") const |
| Draw a clone of this object in the current pad. More... | |
| virtual void | Dump () const |
| Dump contents of object on stdout. More... | |
| virtual void | Error (const char *method, const char *msgfmt,...) const |
| Issue error message. More... | |
| virtual void | Execute (const char *method, const char *params, Int_t *error=0) |
| Execute method on this object with the given parameter string, e.g. More... | |
| virtual void | Execute (TMethod *method, TObjArray *params, Int_t *error=0) |
| Execute method on this object with parameters stored in the TObjArray. More... | |
| virtual void | ExecuteEvent (Int_t event, Int_t px, Int_t py) |
| Execute action corresponding to an event at (px,py). More... | |
| virtual void | Fatal (const char *method, const char *msgfmt,...) const |
| Issue fatal error message. More... | |
| virtual TObject * | FindObject (const char *name) const |
| Must be redefined in derived classes. More... | |
| virtual TObject * | FindObject (const TObject *obj) const |
| Must be redefined in derived classes. More... | |
| virtual Option_t * | GetDrawOption () const |
| Get option used by the graphics system to draw this object. More... | |
| virtual const char * | GetIconName () const |
| Returns mime type name of object. More... | |
| virtual char * | GetObjectInfo (Int_t px, Int_t py) const |
| Returns string containing info about the object at position (px,py). More... | |
| virtual Option_t * | GetOption () const |
| virtual UInt_t | GetUniqueID () const |
| Return the unique object id. More... | |
| virtual Bool_t | HandleTimer (TTimer *timer) |
| Execute action in response of a timer timing out. More... | |
| virtual void | Info (const char *method, const char *msgfmt,...) const |
| Issue info message. More... | |
| virtual Bool_t | InheritsFrom (const char *classname) const |
| Returns kTRUE if object inherits from class "classname". More... | |
| virtual Bool_t | InheritsFrom (const TClass *cl) const |
| Returns kTRUE if object inherits from TClass cl. More... | |
| virtual void | Inspect () const |
| Dump contents of this object in a graphics canvas. More... | |
| void | InvertBit (UInt_t f) |
| virtual Bool_t | IsEqual (const TObject *obj) const |
| Default equal comparison (objects are equal if they have the same address in memory). More... | |
| virtual Bool_t | IsFolder () const |
| Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). More... | |
| Bool_t | IsOnHeap () const |
| Bool_t | IsZombie () const |
| void | MayNotUse (const char *method) const |
| Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). More... | |
| virtual Bool_t | Notify () |
| This method must be overridden to handle object notification. More... | |
| void | Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const |
| Use this method to declare a method obsolete. More... | |
| void | operator delete (void *ptr) |
| Operator delete. More... | |
| void | operator delete[] (void *ptr) |
| Operator delete []. More... | |
| void * | operator new (size_t sz) |
| void * | operator new (size_t sz, void *vp) |
| void * | operator new[] (size_t sz) |
| void * | operator new[] (size_t sz, void *vp) |
| TObject & | operator= (const TObject &rhs) |
| TObject assignment operator. More... | |
| virtual void | Paint (Option_t *option="") |
| This method must be overridden if a class wants to paint itself. More... | |
| virtual void | Pop () |
| Pop on object drawn in a pad to the top of the display list. More... | |
| virtual Int_t | Read (const char *name) |
| Read contents of object with specified name from the current directory. More... | |
| virtual void | RecursiveRemove (TObject *obj) |
| Recursively remove this object from a list. More... | |
| void | ResetBit (UInt_t f) |
| virtual void | SaveAs (const char *filename="", Option_t *option="") const |
| Save this object in the file specified by filename. More... | |
| virtual void | SavePrimitive (std::ostream &out, Option_t *option="") |
| Save a primitive as a C++ statement(s) on output stream "out". More... | |
| void | SetBit (UInt_t f, Bool_t set) |
| Set or unset the user status bits as specified in f. More... | |
| void | SetBit (UInt_t f) |
| virtual void | SetDrawOption (Option_t *option="") |
| Set drawing option for object. More... | |
| virtual void | SetUniqueID (UInt_t uid) |
| Set the unique object id. More... | |
| virtual void | SysError (const char *method, const char *msgfmt,...) const |
| Issue system error message. More... | |
| Bool_t | TestBit (UInt_t f) const |
| Int_t | TestBits (UInt_t f) const |
| virtual void | UseCurrentStyle () |
| Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More... | |
| virtual void | Warning (const char *method, const char *msgfmt,...) const |
| Issue warning message. More... | |
| virtual Int_t | Write (const char *name=0, Int_t option=0, Int_t bufsize=0) |
| Write this object to the current directory. More... | |
| virtual Int_t | Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const |
| Write this object to the current directory. More... | |
Static Public Member Functions | |
| static void | SetAverageWindow (Int_t w=3) |
| Static function: Set average window of searched peaks (see TSpectrum::SearchHighRes). More... | |
| static void | SetDeconIterations (Int_t n=3) |
| Static function: Set max number of decon iterations in deconvolution operation (see TSpectrum::SearchHighRes). More... | |
| static TH1 * | StaticBackground (const TH1 *hist, Int_t niter=20, Option_t *option="") |
| Static function, interface to TSpectrum::Background. More... | |
| static Int_t | StaticSearch (const TH1 *hist, Double_t sigma=2, Option_t *option="goff", Double_t threshold=0.05) |
| Static function, interface to TSpectrum::Search. More... | |
| Static Public Member Functions inherited from TObject | |
| static Long_t | GetDtorOnly () |
| Return destructor only flag. More... | |
| static Bool_t | GetObjectStat () |
| Get status of object stat flag. More... | |
| static void | SetDtorOnly (void *obj) |
| Set destructor only flag. More... | |
| static void | SetObjectStat (Bool_t stat) |
| Turn on/off tracking of objects in the TObjectTable. More... | |
Protected Attributes | |
| TH1 * | fHistogram |
| resulting histogram More... | |
| Int_t | fMaxPeaks |
| Maximum number of peaks to be found. More... | |
| Int_t | fNPeaks |
| number of peaks found More... | |
| Double_t * | fPosition |
| [fNPeaks] array of current peak positions More... | |
| Double_t * | fPositionX |
| [fNPeaks] X position of peaks More... | |
| Double_t * | fPositionY |
| [fNPeaks] Y position of peaks More... | |
| Double_t | fResolution |
| NOT USED resolution of the neighboring peaks More... | |
| Protected Attributes inherited from TNamed | |
| TString | fName |
| TString | fTitle |
Static Protected Attributes | |
| static Int_t | fgAverageWindow = 3 |
| Average window of searched peaks. More... | |
| static Int_t | fgIterations = 3 |
| Maximum number of decon iterations (default=3) More... | |
Private Member Functions | |
| TSpectrum (const TSpectrum &) | |
| TSpectrum & | operator= (const TSpectrum &) |
Additional Inherited Members | |
| Protected Member Functions inherited from TObject | |
| virtual void | DoError (int level, const char *location, const char *fmt, va_list va) const |
| Interface to ErrorHandler (protected). More... | |
| void | MakeZombie () |
#include <TSpectrum.h>
| anonymous enum |
Definition at line 38 of file TSpectrum.h.
|
private |
| TSpectrum::TSpectrum | ( | ) |
Constructor.
Definition at line 50 of file TSpectrum.cxx.
Definition at line 70 of file TSpectrum.cxx.
|
virtual |
Destructor.
Definition at line 87 of file TSpectrum.cxx.
One-dimensional background estimation function.
This function calculates the background spectrum in the input histogram h. The background is returned as a histogram.
NOTE that the background is only evaluated in the current range of h. ie, if h has a bin range (set via h->GetXaxis()->SetRange(binmin,binmax), the returned histogram will be created with the same number of bins as the input histogram h, but only bins from binmin to binmax will be filled with the estimated background.
Definition at line 152 of file TSpectrum.cxx.
| const char * TSpectrum::Background | ( | Double_t * | spectrum, |
| Int_t | ssize, | ||
| Int_t | numberIterations, | ||
| Int_t | direction, | ||
| Int_t | filterOrder, | ||
| bool | smoothing, | ||
| Int_t | smoothWindow, | ||
| bool | compton | ||
| ) |
This function calculates background spectrum from source spectrum.
The result is placed in the vector pointed by spe1945ctrum pointer. The goal is to separate the useful information (peaks) from useless information (background).
new value in the channel "i" is calculated
\[ v_p(i) = min \left\{ v_{p-1}(i)^{\frac{\left[v_{p-1}(i+p)+v_{p-1}(i-p)\right]}{2}} \right\} \]
where p = 1, 2, ..., numberIterations. In fact it represents second order difference filter (-1,2,-1).
One can also change the direction of the change of the clipping window, the order of the clipping filter, to include smoothing, to set width of smoothing window and to include the estimation of Compton edges. On successful completion it returns 0. On error it returns pointer to the string describing error.
In Fig. 1. one can notice that at the edges of the peaks the estimated background goes under the peaks. An alternative approach is to decrease the clipping window from a given value numberIterations to the value of one, which is presented in this example.
The question is how to choose the width of the clipping window, i.e., numberIterations parameter. The influence of this parameter on the estimated background is illustrated in Fig. 3.
in general one should set this parameter so that the value 2*numberIterations+1 was greater than the widths of preserved objects (peaks).
another example for very complex spectrum is given in Fig. 4.
Second order difference filter removes linear (quasi-linear) background and preserves symmetrical peaks. However if the shape of the background is more complex one can employ higher-order clipping filters (see example in Fig. 5)
The estimate of the background can be influenced by noise present in the spectrum. We proposed the algorithm of the background estimate with simultaneous smoothing. In the original algorithm without smoothing, the estimated background snatches the lower spikes in the noise. Consequently, the areas of peaks are biased by this error.
Sometimes it is necessary to include also the Compton edges into the estimate of the background. In Fig. 8 we present the example of the synthetic spectrum with Compton edges. The background was estimated using the 8-th order filter with the estimation of the Compton edges using decreasing clipping window algorithm (numberIterations=10) with smoothing (smoothingWindow=5).
Definition at line 778 of file TSpectrum.cxx.
| const char * TSpectrum::Deconvolution | ( | Double_t * | source, |
| const Double_t * | response, | ||
| Int_t | ssize, | ||
| Int_t | numberIterations, | ||
| Int_t | numberRepetitions, | ||
| Double_t | boost | ||
| ) |
One-dimensional deconvolution function.
This function calculates deconvolution from source spectrum according to response spectrum using Gold deconvolution algorithm. The result is placed in the vector pointed by source pointer. On successful completion it returns 0. On error it returns pointer to the string describing error. If desired after every numberIterations one can apply boosting operation (exponential function with exponent given by boost coefficient) and repeat it numberRepetitions times.
The goal of this function is the improvement of the resolution in spectra, decomposition of multiplets. The mathematical formulation of the convolution system is:
\[ y(i) = \sum_{k=0}^{N-1} h(i-k)x(k), i=0,1,2,...,N-1 \]
where h(i) is the impulse response function, x, y are input and output vectors, respectively, N is the length of x and h vectors. In matrix form we have:
\[ \begin{bmatrix} y(0) \\ y(1) \\ \dots \\ y(2N-2) \\ y(2N-1) \end{bmatrix} = \begin{bmatrix} h(0) & 0 & 0 & \dots & 0 \\ h(1) & h(0) & 0 & \dots & \dots \\ \dots & h(1) & h(0) & \dots & \dots \\ \dots & \dots & h(1) & \dots & \dots \\ \dots & \dots & \dots & \dots & \dots \\ h(N-1) & \dots & \dots &\dots & 0 \\ 0 & h(N-1) & \dots & \dots & h(0) \\ 0 & 0 & h(N-1) & \dots & h(1) \\ \dots & \dots & \dots & \dots & \dots \\ 0 & 0 & 0 & \dots & h(N-1) \end{bmatrix} \begin{bmatrix} x(0) \\ x(1) \\ \dots \\ x(N-1) \end{bmatrix} \]
us assume that we know the response and the output vector (spectrum) of the above given system. The deconvolution represents solution of the overdetermined system of linear equations, i.e., the calculation of the vector x. From numerical stability point of view the operation of deconvolution is extremely critical (ill-posed problem) as well as time consuming operation. The Gold deconvolution algorithm proves to work very well, other methods (Fourier, VanCittert etc) oscillate. It is suitable to process positive definite data (e.g. histograms).
\[ y = Hx \\ H^{T}y = H^{T}Hx \\ y^{'} = H^{'}x \\ x_{i}^{(k+1)} = \frac{y_{i}^{'}}{\sum_{m=0}^{N-1}H_{im}^{'}x_{m}{(k)}}x_{i}{(k)}, i=0,1,2,...,N-1 \\ k = 1,2,3,...,L x^{0} = [1,1, ..., 1]^T \]
L is given number of iterations (numberIterations parameter).
response function (usually peak) should be shifted left to the first non-zero channel (bin) (see Fig. 9)
First let us study the influence of the number of iterations on the deconvolved spectrum (Fig. 12).
For relatively narrow peaks in the above given example the Gold deconvolution method is able to decompose overlapping peaks practically to delta - functions. In the next example we have chosen a synthetic data (spectrum, 256 channels) consisting of 5 very closely positioned, relatively wide peaks (sigma =5), with added noise (Fig. 13). Thin lines represent pure Gaussians (see Table 1); thick line is a resulting spectrum with additive noise (10% of the amplitude of small peaks).
| Peak # | Position | Height | Area |
|---|---|---|---|
| 1 | 50 | 500 | 10159 |
| 2 | 70 | 3000 | 60957 |
| 3 | 80 | 1000 | 20319 |
| 4 | 100 | 5000 | 101596 |
| 5 | 110 | 500 | 10159 |
Table 1 Positions, heights and areas of peaks in the spectrum shown in Fig. 13.
In ideal case, we should obtain the result given in Fig. 14. The areas of the Gaussian components of the spectrum are concentrated completely to delta-functions. When solving the overdetermined system of linear equations with data from Fig. 13 in the sense of minimum least squares criterion without any regularisation we obtain the result with large oscillations (Fig. 15). From mathematical point of view, it is the optimal solution in the unconstrained space of independent variables. From physical point of view we are interested only in a meaningful solution. Therefore, we have to employ regularisation techniques (e.g. Gold deconvolution) and/or to confine the space of allowed solutions to subspace of positive solutions.
When we employ Gold deconvolution algorithm we obtain the result given in Fig. 16. One can observe that the resulting spectrum is smooth. On the other hand the method is not able to decompose completely the peaks in the spectrum.
Further let us employ boosting operation into deconvolution (Fig. 17).
| Peak # | Original/Estimated (max) position | Original/Estimated area |
|---|---|---|
| 1 | 50/49 | 10159/10419 |
| 2 | 70/70 | 60957/58933 |
| 3 | 80/79 | 20319/19935 |
| 4 | 100/100 | 101596/105413 |
| 5 | 110/117 | 10159/6676 |
Table 2 Results of the estimation of peaks in spectrum shown in Fig. 17.
One can observe that peaks are decomposed practically to delta functions. Number of peaks is correct, positions of big peaks as well as their areas are relatively well estimated. However there is a considerable error in the estimation of the position of small right hand peak.
Definition at line 1858 of file TSpectrum.cxx.
| const char * TSpectrum::DeconvolutionRL | ( | Double_t * | source, |
| const Double_t * | response, | ||
| Int_t | ssize, | ||
| Int_t | numberIterations, | ||
| Int_t | numberRepetitions, | ||
| Double_t | boost | ||
| ) |
One-dimensional deconvolution function.
This function calculates deconvolution from source spectrum according to response spectrum using Richardson-Lucy deconvolution algorithm. The result is placed in the vector pointed by source pointer. On successful completion it returns 0. On error it returns pointer to the string describing error. If desired after every numberIterations one can apply boosting operation (exponential function with exponent given by boost coefficient) and repeat it numberRepetitions times (see Gold deconvolution).
For discrete systems it has the form:
\[ x^{(n)}(i) = x^{(n-1)}(i) \sum_{j=0}^{N-1}h(i,j)\frac{y(j)}{\sum_{k=0}^{M-1}h(j,k)x^{(n-1)}(k)} \\ i \in \left<0,M-1\right> \]
positive input data and response matrix this iterative method forces the deconvoluted spectra to be non-negative. The Richardson-Lucy iteration converges to the maximum likelihood solution for Poisson statistics in the data.
When we employ Richardson-Lucy deconvolution algorithm to our data from Fig. 13 we obtain the result given in Fig. 18. One can observe improvements as compared to the result achieved by Gold deconvolution. Nevertheless it is unable to decompose the multiplet.
Further let us employ boosting operation into deconvolution (Fig. 19).
| Peak # | Original/Estimated (max) position | Original/Estimated area |
|---|---|---|
| 1 | 50/51 | 10159/11426 |
| 2 | 70/71 | 60957/65003 |
| 3 | 80/81 | 20319/12813 |
| 4 | 100/100 | 101596/101851 |
| 5 | 110/111 | 10159/8920 |
Table 3 Results of the estimation of peaks in spectrum shown in Fig. 19.
One can observe improvements in the estimation of peak positions as compared to the results achieved by Gold deconvolution.
Definition at line 2138 of file TSpectrum.cxx.
|
inline |
Definition at line 58 of file TSpectrum.h.
|
inline |
Definition at line 59 of file TSpectrum.h.
|
inline |
Definition at line 60 of file TSpectrum.h.
|
inline |
Definition at line 61 of file TSpectrum.h.
Print the array of positions.
Reimplemented from TNamed.
Definition at line 219 of file TSpectrum.cxx.
|
virtual |
One-dimensional peak search function.
This function searches for peaks in source spectrum in hin The number of found peaks and their positions are written into the members fNpeaks and fPositionX. The search is performed in the current histogram range.
By default, the background is removed before deconvolution. Specify the option "nobackground" to not remove the background.
By default the "Markov" chain algorithm is used. Specify the option "noMarkov" to disable this algorithm Note that by default the source spectrum is replaced by a new spectrum
By default a polymarker object is created and added to the list of functions of the histogram. The histogram is drawn with the specified option and the polymarker object drawn on top of the histogram. The polymarker coordinates correspond to the npeaks peaks found in the histogram.
A pointer to the polymarker object can be retrieved later via:
Specify the option "goff" to disable the storage and drawing of the polymarker.
To disable the final drawing of the histogram with the search results (in case you want to draw it yourself) specify "nodraw" in the options parameter.
Definition at line 266 of file TSpectrum.cxx.
| Int_t TSpectrum::Search1HighRes | ( | Double_t * | source, |
| Double_t * | destVector, | ||
| Int_t | ssize, | ||
| Double_t | sigma, | ||
| Double_t | threshold, | ||
| bool | backgroundRemove, | ||
| Int_t | deconIterations, | ||
| bool | markov, | ||
| Int_t | averWindow | ||
| ) |
Old name of SearcHighRes introduced for back compatibility.
This function will be removed after the June 2006 release
Definition at line 3172 of file TSpectrum.cxx.
| Int_t TSpectrum::SearchHighRes | ( | Double_t * | source, |
| Double_t * | destVector, | ||
| Int_t | ssize, | ||
| Double_t | sigma, | ||
| Double_t | threshold, | ||
| bool | backgroundRemove, | ||
| Int_t | deconIterations, | ||
| bool | markov, | ||
| Int_t | averWindow | ||
| ) |
One-dimensional high-resolution peak search function.
This function searches for peaks in source spectrum. It is based on deconvolution method. First the background is removed (if desired), then Markov smoothed spectrum is calculated (if desired), then the response function is generated according to given sigma and deconvolution is carried out. The order of peaks is arranged according to their heights in the spectrum after background elimination. The highest peak is the first in the list. On success it returns number of found peaks.
The goal of this function is to identify automatically the peaks in spectrum with the presence of the continuous background and statistical fluctuations - noise.
The common problems connected with correct peak identification are:
Examples of peak searching method:
The SearchHighRes function provides users with the possibility to vary the input parameters and with the access to the output deconvolved data in the destination spectrum. Based on the output data one can tune the parameters.
| Peak # | Position | Sigma |
|---|---|---|
| 1 | 118 | 26 |
| 2 | 162 | 41 |
| 3 | 310 | 4 |
| 4 | 330 | 8 |
| 5 | 482 | 22 |
| 6 | 491 | 26 |
| 7 | 740 | 21 |
| 8 | 852 | 15 |
| 9 | 954 | 12 |
| 10 | 989 | 13 |
Table 4 Positions and sigma of peaks in the following examples.
Definition at line 2735 of file TSpectrum.cxx.
Static function: Set average window of searched peaks (see TSpectrum::SearchHighRes).
Definition at line 99 of file TSpectrum.cxx.
Static function: Set max number of decon iterations in deconvolution operation (see TSpectrum::SearchHighRes).
Definition at line 108 of file TSpectrum.cxx.
NOT USED resolution: determines resolution of the neighbouring peaks default value is 1 correspond to 3 sigma distance between peaks.
Higher values allow higher resolution (smaller distance between peaks. May be set later through SetResolution.
Definition at line 351 of file TSpectrum.cxx.
One-dimensional markov spectrum smoothing function.
This function calculates smoothed spectrum from source spectrum based on Markov chain method. The result is placed in the array pointed by source pointer. On successful completion it returns 0. On error it returns pointer to the string describing error.
The goal of this function is the suppression of the statistical fluctuations. The algorithm is based on discrete Markov chain, which has very simple invariant distribution:
\[ U_2 = \frac{p_{1,2}}{p_{2,1}}U_1, U_3 = \frac{p_{2,3}}{p_{3,2}}U_2U_1, ... , U_n = \frac{p_{n-1,n}}{p_{n,n-1}}U_{n-1}...U_2U_1 \]
\( U_1\) being defined from the normalization condition \( \sum_{i=1}^{n} U_i=1\). \( n \) is the length of the smoothed spectrum and
\[ p_{i,i\pm 1} = A_i\sum_{k=1}^{m} exp\left[ \frac{y(i\pm k)-y(i)}{y(i\pm k)+y(i)}\right] \]
Definition at line 1489 of file TSpectrum.cxx.
|
static |
Static function, interface to TSpectrum::Background.
Definition at line 3196 of file TSpectrum.cxx.
|
static |
Static function, interface to TSpectrum::Search.
Definition at line 3186 of file TSpectrum.cxx.
| const char * TSpectrum::Unfolding | ( | Double_t * | source, |
| const Double_t ** | respMatrix, | ||
| Int_t | ssizex, | ||
| Int_t | ssizey, | ||
| Int_t | numberIterations, | ||
| Int_t | numberRepetitions, | ||
| Double_t | boost | ||
| ) |
One-dimensional unfolding function.
This function unfolds source spectrum according to response matrix columns. The result is placed in the vector pointed by source pointer. The coefficients of the resulting vector represent contents of the columns (weights) in the input vector. On successful completion it returns 0. On error it returns pointer to the string describing error. If desired after every numberIterations one can apply boosting operation (exponential function with exponent given by boost coefficient) and repeat it numberRepetitions times. For details we refer to [1].
The goal is the decomposition of spectrum to a given set of component spectra.
The mathematical formulation of the discrete linear system is:
\[ y(i) = \sum_{k=0}^{N_y-1} h(i,k)x(k), i = 0,1,2,...,N_x-1 \]
\[ \begin{bmatrix} y(0) \\ y(1) \\ \dots \\ y(N_x-1) \end{bmatrix} = \begin{bmatrix} h(0,0) & h(0,1) & \dots & h(0,N_y-1) \\ h(1,0) & h(1,1) & \dots & h(1,N_y-1) \\ \dots \\ h(N_x-1,0) & h(N_x-1,1) & \dots & h(N_x-1,N_y-1) \end{bmatrix} \begin{bmatrix} x(0) \\ x(1) \\ \dots \\ x(N_x-1) \end{bmatrix} \]
#### References:
Definition at line 2363 of file TSpectrum.cxx.
|
staticprotected |
Average window of searched peaks.
Definition at line 34 of file TSpectrum.h.
|
staticprotected |
Maximum number of decon iterations (default=3)
Definition at line 35 of file TSpectrum.h.
|
protected |
resulting histogram
Definition at line 33 of file TSpectrum.h.
|
protected |
Maximum number of peaks to be found.
Definition at line 27 of file TSpectrum.h.
|
protected |
number of peaks found
Definition at line 28 of file TSpectrum.h.
|
protected |
[fNPeaks] array of current peak positions
Definition at line 29 of file TSpectrum.h.
|
protected |
[fNPeaks] X position of peaks
Definition at line 30 of file TSpectrum.h.
|
protected |
[fNPeaks] Y position of peaks
Definition at line 31 of file TSpectrum.h.
|
protected |
NOT USED resolution of the neighboring peaks
Definition at line 32 of file TSpectrum.h.
ROOT 6.08/07 - Reference Guide Generated on Thu May 31 2018 21:48:03 using Doxygen 1.8.13.