v2.10-0 (21000JUN2005)

Go4Fit
Class TGo4FitMinuit


class TGo4FitMinuit
derived from TGo4FitterAction

Minuit minimization action
Now only TGo4FitMinuit class, provided general minimization routine, is available. It uses standard ROOT TMinuit class [3]. TGo4FitMinuit class includes Minuit commands list, which will be executed during minimizatione. There are several methods of TGo4FitMinuit class to operate with command list:
AddCommand() - add command to commands list;
GetNumCommands() - get number of commands in list;
GetCommand() - get command from list;
ClearCommands() - clear commands list.
To get full description of Minuit commands, see Minuit reference manual [4].
In additional to standard Minuit commands, one adds result command, which get status and results values from Minuit and store them as TGo4FitMinuitResult objects in TGo4FitMinuit results list. The syntax of command is

result [xxxx [result_name]]

where "result"- identifier of this command, "xxxx" - flags field (default - "1000"), "result_name"- optional name of result object (default - "Result"). The each "x" in flags field can be: "0" - option switched off or "1" - switched on. The meanings of flags are:
1. Storing of current parameters values and errors (ParValues and ParError arrays of doubles, TArrayD class).
2. Storing result of Minos error analysis (EPLUS, EMINUS, EPARAB & GLOBCC arrays of doubles). Normally should be used after "MINOs" command of Minuit.
3. Storing error matrice estimations to ERRORMATRIX (TMatrix class). Columns and strings in matrix, corresponds to fixed elements, will be set to 0.
4. Storing contour plot in CONTOX, CONTOY (both are arrays of doubles) and CONTOCH (array of char, TArrayC). Normally should be switched on after "MNContour" command of Minuit.
Result object always store status values of Minuit (see MNSTAT command in Minuit reference manual [4]):
FMIN - the best function value found so far;
FEDM - the estimated vertical distance remaining to minimum;
ERRDEF - the value of UP defining parameter uncertainties;
NPARI - number of currently variable parameters;
NPARX - the highest (external) parameter number defined by user;
ISTAT - a status integer indicating how good is the covariance matrix.
Several result commands can be present in Minuit command list and the same number of TGo4FitMinuitResult object will be present in TGo4FitMinuit object after minimization is finished. Results can be accessed via index, using GetNumResults() and GetResult() methods or via result name, using FindResult() method. The results objects always owned by TGo4FitMinuit object and stored together with it. Thus, if TGo4FitMinuit object will be saved together with fitter, the TGo4FitMinuitResult objects also will be stored and can be accessed later, then fitter will be loaded.


Field Summary
 protected TObjArrayfxCommands
          List of minuit commands, presented by array of TObjString.
 protected TObjArrayfxResults
          List of Tgo4FitMinuitResult objects.

Fields inherited from class TNamed
fName, fTitle

Constructor Summary
TGo4FitMinuit()
          Default constructor.
TGo4FitMinuit(const char * Name)
          Create TGo4FitMinuit object (action) with given name.

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

Method Summary
 voidAddCommand(const char * iCommand)
          Add Minuit command to command list.
 voidAddResult(TGo4FitMinuitResult* res)
          Add result object to results list.
 voidClearCommands()
          Clear Minuit commands list.
 voidClearResults()
          Delete all results objects.
 virtual voidDoAction(TGo4FitterAbstract* Fitter)
          Execute all Minuit commands.
 TGo4FitMinuitResult*FindResult(const char * ResName)
          Find result object with provided name.
 const const char *GetCommand(Int_t n)
          Return command with given index.
 Int_tGetNumCommands()
          Returns number of commands in list.
 Int_tGetNumResults()
          Returns number of result objects.
 TGo4FitMinuitResult*GetResult(Int_t indx)
          Get TGo4FitMinuitResult object with given index.
 virtual const Bool_tNeedBuffers()
           
 virtual const voidPrint(Option_t* option)
          Print information on standard output.
 voidRemoveResult(TGo4FitMinuitResult* res)
          Remove result from results list and delete it.

Methods inherited from class Go4Fit.TGo4FitterAction
CanChangeFitter

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

Field Detail

fxCommands

protected TObjArray fxCommands
List of minuit commands, presented by array of TObjString.

fxResults

protected TObjArray fxResults
List of Tgo4FitMinuitResult objects.
Constructor Detail

TGo4FitMinuit

public TGo4FitMinuit()
Default constructor.

TGo4FitMinuit

public TGo4FitMinuit(const char * Name)
Create TGo4FitMinuit object (action) with given name.
Method Detail

~TGo4FitMinuit

public virtual synchronized ~TGo4FitMinuit()
Destroys TGo4FitMinuit object.
Method Detail

AddCommand

public void AddCommand(const char * iCommand)
Add Minuit command to command list.
To get a full description of possible Minuit commands, see Minuit documentation.

AddResult

public void AddResult(TGo4FitMinuitResult* res)
Add result object to results list.

ClearCommands

public void ClearCommands()
Clear Minuit commands list.

ClearResults

public void ClearResults()
Delete all results objects.

DoAction

public virtual void DoAction(TGo4FitterAbstract* Fitter)
Execute all Minuit commands.

FindResult

public TGo4FitMinuitResult* FindResult(const char * ResName)
Find result object with provided name.

GetCommand

public const const char * GetCommand(Int_t n)
Return command with given index.

GetNumCommands

public Int_t GetNumCommands()
Returns number of commands in list.

GetNumResults

public Int_t GetNumResults()
Returns number of result objects.

GetResult

public TGo4FitMinuitResult* GetResult(Int_t indx)
Get TGo4FitMinuitResult object with given index.

NeedBuffers

public virtual const Bool_t NeedBuffers()

Print

public virtual const void Print(Option_t* option)
Print information on standard output.

RemoveResult

public void RemoveResult(TGo4FitMinuitResult* res)
Remove result from results list and delete it.

Association Links

to Class TObjArray

List of minuit commands, presented by array of TObjString.

to Class TObjArray

List of Tgo4FitMinuitResult objects.

to Class TGo4FitMinuitResult

Label TObjArray
Supplier Cardinality 0..*
Type aggregation

J.Adamczewski, M.Al-Turany, D.Bertini, H.G.Essel, S.Linev

30-06-2005