Go4Fit
Class TGo4FitData

Direct Known Subclasses:

TGo4FitDataGraph, TGo4FitDataHistogram, TGo4FitDataProfile, TGo4FitDataRidge

class TGo4FitData

derived from TGo4FitComponent

Basic abtract class for representing data, which should be fitted.

Fields inherited from class Go4Fit.TGo4FitSlotList

fbUpdateSlotList, fxSlotList

Constructor Summary

TGo4FitData()           Default constructor.

TGo4FitData(const char * iName, const char * iTitle, Int_t iDataType, Bool_t AddAmpl)           Creates TGo4FitData object with given name and title.

Destructor Summary
virtual synchronized	~TGo4FitData()           Destroys TGo4FitData object.

Method Summary
void	AddAxisTrans(TGo4FitAxisTrans* Trans, Bool_t TransOwned)           Add transformation object to data.
void	ApplyRangesForModelMask(TGo4FitComponent* model, Char_t* ModelMask)           Exclude points from model according model range conditions.
protected const Bool_t	BuffersAllocated()           Checks, if buffers allocated for data.
virtual Bool_t	CanAmplTouch()           Always return kTRUE.
TObject*	CreateDrawObject(const char * ObjName)           Creates object, which can be drawn on canvas by ROOT.
Int_t	DefineBinsSize()           Define number of selected bins in data Create iterator and secuantially checks all points
Int_t	DefineDimensions()           Define dimension number of data Create iterator and checks number of dimension
Bool_t	DefineScaleMinMax(Int_t naxis, Double_t& min, Double_t& max)           Return scales minimum and maximum for specified axis.
virtual void	FillSlotList(TSeqCollection* list)           Copy pointers on all slots of data object to list.
protected virtual void	Finalize()           Removes all buffers, created in initialize() routine.
TGo4FitAxisTrans*	GetAxisTrans(Int_t nslot)           Return transformation object for given slot.
TGo4FitSlot*	GetAxisTransSlot(Int_t nslot)           Return slot for transformation object.
protected Double_t*	GetBinsDevs()           Returns pointer on buffer with standard deviations for each data bins.
protected Double_t*	GetBinsResult()           Returns pointer on buffer with complete model of data bins.
protected const Int_t	GetBinsSize()           Return number of data bins in buffers.
protected Double_t*	GetBinsValues()           Returns pointer on buffer with data bins values.
const const Int_t	GetDataType()           Returns type of data source. 0 - histogramic, 1 - points (scale values have no width)
const Double_t	GetExcludeLessThen()           Returns limit, which uses to exclude bins, less then this limit.
protected const const Int_t*	GetFullIndex(Int_t nbin)           Return indexes values for specified data bin from buffer.
protected const Int_t	GetIndexesSize()           Returns dimension of indexes arrays.
Int_t	GetNumberOfTransSlots()           Return number of slots for scale transformation objects.
protected const Int_t	GetScalesSize()           Returns number of axis values for each point.
protected const const Double_t*	GetScaleValues(const Int_t nbin)           Return scale values for specified index from buffer.
const Int_t	GetSigmaSource()           Return source of sigma values.
const Double_t	GetSigmaValue()           Return constant sigma value.
Bool_t	GetUseBinScale()           Returns kTRUE, if binary numbers used as scale values.
protected const const Double_t*	GetWidthValues(const Int_t nbin)           Return scales width values for specified index from buffer.
protected virtual Bool_t	Initialize(Int_t UseBuffers)           Initialize data object.
virtual Bool_t	IsAnyDataTransform()           Return kTRUE, if either initial data axis or data bins are transformed by TGo4FitData object.
Bool_t	IsCompatibleData(TGo4FitData* data)           Checks, if data has same dimensions number and size of each dimensions.
virtual TGo4FitDataIter*	MakeIter()           Creates iterator for data object.
virtual const void	Print(Option_t* option)           Display information about data object on standard output.
private void	ReleaseAllPointers()           Release all memory, allocated for buffers.
private void	ResetAllPoinetrs()           Clears (sets to 0) all pointers, used for buffer allocations.
void	SetAxisTrans(Int_t nslot, TGo4FitAxisTrans* Trans, Bool_t TransOwned)           Sets transformation object for given slot.
void	SetAxisTransNeeded(Int_t nslot, Bool_t iNeeded)           Specified, when iNeeded = kTRUE, that trsnaformation object should always be provided to data.
void	SetExcludeLessThen(Double_t limit)           Sets limit to exclude bins, which not less then this limit.
Bool_t	SetNumberOfTransSlots(Int_t nslots)           Sets number of slots for scale transformation objects.
void	SetSigmaSource(Int_t TakeFrom, Double_t SigmaValue)           Sets source of sigma for data.
void	SetSigmaValue(Double_t SigmaValue)           Set constant sigma value.
void	SetUseBinScale(Bool_t iUseBinScale)           If kTRUE, binary numbers will be used as scale values.

Methods inherited from class Go4Fit.TGo4FitComponent

AddRangeCondition, AddRangeCut, CheckRangeConditions, ClearRanges, CollectParsTo, ExcludeRange, GetAmplError, GetAmplFullName, GetAmplIndex, GetAmplName, GetAmplPar, GetAmplValue, GetNumRangeCondition, GetNumRangeCut, GetRangeCondition, GetRangeCut, GetRangeMax, GetRangeMin, GetUseBuffers, IsAnyRangeLimits, IsRangeCutExcluding, MakeAmpl, NewAmplitude, NewParameter, RemoveAmpl, RemoveRangeCondition, RemoveRangeCut, SetAmplError, SetAmplIndex, SetAmplValue, SetRange, SetRangeCondition, SetRangeCutExcluding, SetRangeMax, SetRangeMin, SetUseBuffers

Methods inherited from class Go4Fit.TGo4FitParsList

AddPar, CanRollbackPars, ClearPars, ClearParsBlocking, CreatePar, Find, Find, Find, FindPar, FindPar, FindPar, Get, GetPar, GetParEpsilon, GetParError, GetParFixed, GetParFullName, GetParIndex, GetParName, GetParRange, GetParsValues, GetParValue, InsertPar, IsAllParsFixed, MemorizePars, NumFixedPars, NumFreePars, NumPars, PrintPars, RememberPars, RemovePar, RemovePar, RemoveParByIndex, SetParEpsilon, SetParError, SetParFixed, SetParName, SetParRange, SetParsNames, SetParsOwner, SetParsValues, SetParsValues, SetParValue

Methods inherited from class Go4Fit.TGo4FitNamed

GetFullName, GetOwner, GetOwnerFullName, SetOwner

Methods inherited from class TNamed

operator=, Clear, Clone, Compare, Copy, FillBuffer, GetName, GetTitle, Hash, IsSortable, SetName, SetNameTitle, SetTitle, ls, Sizeof, Class, Class_Name, Class_Version, Dictionary, IsA, ShowMembers, Streamer, StreamerNVirtual, DeclFileName, ImplFileLine, ImplFileName, DeclFileLine

Methods inherited from class Go4Fit.TGo4FitSlotList

CheckDuplicatesOnSlot, CheckObjects, ClearObjects, ClearSlot, ConnectSlots, ConnectSlots, FindSlot, GetSlot, GetSlotList, IsEmptySlots, IsObjectInSlots, NumSlots, PrepareSlotsForWriting, SetObject, SetObject, SetSaveFlagForObjects, SetUpdateSlotList

Field Detail

fbUseBinScale

protected Bool_t fbUseBinScale

Use binary numbers as scale values.
if this flag set, bin numbers are used as scale values

protected Double_t fdExcludeLessThen

Sets limit for exclude bins, which less then this limit

protected Double_t fdSigmaValue

Value of sigma when fiTakeSigmasFrom = 2

private Int_t fiBinsSize

Number of entries in buffers.

protected Int_t fiDataType

Specified type of data:
0 - Histogram, 1 - graphics, 2 and so on - user defined

private Int_t fiIndexesSize

Number of indexes for each point.

private Int_t fiScalesSize

Number of scales values for each point.

protected Int_t fiTakeSigmasFrom

Specify sigma source.
0 - no sigmas, 1 - try take from data, 2 - const value (fdSigmaValue)

protected TObjArray fxAxisTrans

Array of slots for scale transformation objects.

private Double_t* fxBinsResult

Buffer for complete model of bins values.

private Int_t* fxFullIndex

Store combination of indexes for each data bins.
Size of [GetBinsSize()][NumDimension()].
Used in case of maximum memory usage.

private Double_t* fxFullScale

Array of axis values for each bins.
Used in case of maximum memory usage.
Size [BinsSize * AxisNumber]

private Double_t* fxFullWidth

Array of width values for each bin.
Used in case of maximum memory usage.
Size [BinsSize * AxisNumber]

private Double_t* fxStandDev

Buffer for standard devations of bins values.

private Double_t* fxValues

Buffer for bins values.

public TGo4FitData()

Default constructor.

public TGo4FitData(const char * iName, const char * iTitle, Int_t iDataType, Bool_t AddAmpl)

Creates TGo4FitData object with given name and title.
Type of data (histogramic or points) and usage of amplitude can be specified.
TGo4FitData object should not be created directly. Implementation of this class like TGo4FitDataHistogram,
TGo4FitDataGraph and so on should be used.

public virtual synchronized ~TGo4FitData()

Destroys TGo4FitData object.

public void AddAxisTrans(TGo4FitAxisTrans* Trans, Bool_t TransOwned)

Add transformation object to data.
First new slot reserved for this object.

public void ApplyRangesForModelMask(TGo4FitComponent* model, Char_t* ModelMask)

Exclude points from model according model range conditions.
Primary range conditions defines for data. No any model, associated to this data, can exceed it's ranges.
But not full data range can be used for explicit model evaluation. This functions fill model mask (array of chars) inside data range, where model should be evaluated.
Can be used only after Initialize() method.

protected const Bool_t BuffersAllocated()

Checks, if buffers allocated for data.

public virtual Bool_t CanAmplTouch()

Always return kTRUE.
This specify that any data object may has or hasnot amplitude.
Amplitude parameter (if exist) will be used to scale bins values.

public TObject* CreateDrawObject(const char * ObjName)

Creates object, which can be drawn on canvas by ROOT.
This method creates either TH1 (in case of histogramic data) or TGraph object and fills bins by content of data.

public Int_t DefineBinsSize()

Define number of selected bins in data
Create iterator and secuantially checks all points

public Int_t DefineDimensions()

Define dimension number of data
Create iterator and checks number of dimension

public Bool_t DefineScaleMinMax(Int_t naxis, Double_t& min, Double_t& max)

Return scales minimum and maximum for specified axis.
Can be used before or after Initialize() method.

public virtual void FillSlotList(TSeqCollection* list)

Copy pointers on all slots of data object to list.

protected virtual void Finalize()

Removes all buffers, created in initialize() routine.

public TGo4FitAxisTrans* GetAxisTrans(Int_t nslot)

Return transformation object for given slot.

public TGo4FitSlot* GetAxisTransSlot(Int_t nslot)

Return slot for transformation object.

protected Double_t* GetBinsDevs()

Returns pointer on buffer with standard deviations for each data bins.
Buffer has GetBinsSize() values. Return 0, if buffers were not allocated.

protected Double_t* GetBinsResult()

Returns pointer on buffer with complete model of data bins.
Buffer has GetBinsSize() values. Return 0, if buffers were not allocated.

protected const Int_t GetBinsSize()

Return number of data bins in buffers.

protected Double_t* GetBinsValues()

Returns pointer on buffer with data bins values.
Buffer has GetBinsSize() values. Return 0, if buffers were not allocated.

public const const Int_t GetDataType()

Returns type of data source. 0 - histogramic, 1 - points (scale values have no width)

public const Double_t GetExcludeLessThen()

Returns limit, which uses to exclude bins, less then this limit.

protected const const Int_t* GetFullIndex(Int_t nbin)

Return indexes values for specified data bin from buffer.
Can be used only if buffers were allocated, otherwise return 0. nbin should be from 0 to GetBinsSize()-1

protected const Int_t GetIndexesSize()

Returns dimension of indexes arrays.
Can be used after Initialize() method, otherwise TGo4FitDataIter::IndexesSize() method should be used.

public Int_t GetNumberOfTransSlots()

Return number of slots for scale transformation objects.

protected const Int_t GetScalesSize()

Returns number of axis values for each point.
Can be used after Initialize() method, otherwise TGo4FitDataIter::ScalesSize() method should be used.

protected const const Double_t* GetScaleValues(const Int_t nbin)

Return scale values for specified index from buffer.
Can be used only if buffers were allocated, otherwise return 0. nbin should be from 0 to GetBinsSize()-1

public const Int_t GetSigmaSource()

Return source of sigma values.
Possible values are:
0 - no sigma sources;
1 - sigma should be taken from data source object;
2 - sigma is constant and defined by GetSigmaValue() funcion.

public const Double_t GetSigmaValue()

Return constant sigma value.
Uses, when GetSigmaSource() returns 2.

public Bool_t GetUseBinScale()

Returns kTRUE, if binary numbers used as scale values.

protected const const Double_t* GetWidthValues(const Int_t nbin)

Return scales width values for specified index from buffer.
Can be used only if buffers were allocated, otherwise return 0. nbin should be from 0 to GetBinsSize()-1

protected virtual Bool_t Initialize(Int_t UseBuffers)

Initialize data object.
This routine should be used to allocate memory for internal buffers.
Its automatically calls in DoActions() routine of fitter.
if UseBuffers>0 or ( GetUseBuffers() && UseBuffers<0) internal buffers will be created.
Concuming more memory may dramaticaly decrease time for fitting.

public virtual Bool_t IsAnyDataTransform()

Return kTRUE, if either initial data axis or data bins are transformed by TGo4FitData object.
For instance, if SetUseBinScales() is used.

public Bool_t IsCompatibleData(TGo4FitData* data)

Checks, if data has same dimensions number and size of each dimensions.
Used, when one data objects used to be a model component of another data object.
Should be used only after Initialize() method for current data object.

public virtual TGo4FitDataIter* MakeIter()

Creates iterator for data object.
For detailed description see TGo4FitDataIter class.

public virtual const void Print(Option_t* option)

Display information about data object on standard output.

private void ReleaseAllPointers()

Release all memory, allocated for buffers.

private void ResetAllPoinetrs()

Clears (sets to 0) all pointers, used for buffer allocations.

public void SetAxisTrans(Int_t nslot, TGo4FitAxisTrans* Trans, Bool_t TransOwned)

Sets transformation object for given slot.
If not enougth slots was reserved, SetNumberOfTransSlots(nslot+1) will be called first.

public void SetAxisTransNeeded(Int_t nslot, Bool_t iNeeded)

Specified, when iNeeded = kTRUE, that trsnaformation object should always be provided to data.

public void SetExcludeLessThen(Double_t limit)

Sets limit to exclude bins, which not less then this limit.

public Bool_t SetNumberOfTransSlots(Int_t nslots)

Sets number of slots for scale transformation objects.
By default, TGo4FitData has no place (slots) for transformation objects.
In this case scale values can be taken from data source (TAxis of TH1) or just bins numbers can be used.
To use transformation of these values, inherited from TGo4FitAxisTrans class should be used.
Slots fot such objects can be reserved first.

public void SetSigmaSource(Int_t TakeFrom, Double_t SigmaValue)

Sets source of sigma for data.
For description see GetSigmaSource() function.

public void SetSigmaValue(Double_t SigmaValue)

Set constant sigma value.
Value wil be used, if GetSigmaSource()==2.

public void SetUseBinScale(Bool_t iUseBinScale)

If kTRUE, binary numbers will be used as scale values.

Association Links

to Class TObjArray

Array of slots for scale transformation objects.

to Class TGo4FitAxisTrans

Supplier Cardinality 0..*

Type aggregation

to Class TGo4FitSlot

Label TObjArray fxCalibrations

Supplier Cardinality 0..*

Type aggregation