Changeset 3574 for trunk/MagicSoft/Mars/mbase

Timestamp:

03/22/04 14:49:21 (21 years ago)

Author:

tbretz

Message:

*** empty log message ***

Location:

trunk/MagicSoft/Mars/mbase

Files:

• MParContainer.cc (modified) (2 diffs)
• MParContainer.h (modified) (3 diffs)

trunk/MagicSoft/Mars/mbase/MParContainer.cc

@@ -16 +16 @@
 !
 !
-!   Author(s): Thomas Bretz  12/2000 <mailto:tbretz@uni-sw.gwdg.de>
+!   Author(s): Thomas Bretz  12/2000 <mailto:tbretz@astro.uni-wuerzburg.de>
 !
-!   Copyright: MAGIC Software Development, 2000-2002
+!   Copyright: MAGIC Software Development, 2000-2004
 !
 !
@@ -24 +24 @@
 
 //////////////////////////////////////////////////////////////////////////////
-//                                                                          //
-// MParContainer                                                            //
-//                                                                          //
-// The MParContainer class is the base class for all MARS parameter         //
-// containers. At the moment it is almost the same than ROOT's TNamed.      //
-// A TNamed contains the essential elements (name, title)                   //
-// to identify a derived object in lists like our MParList or MTaskList.    //
-// The main difference is that the name and title isn't stored and read     //
-// to and from root files ("//!")                                           //
-//                                                                          //
+//
+// MParContainer
+//
+// The MParContainer class is the base class for all MARS parameter
+// containers. At the moment it is almost the same than ROOT's TNamed.
+// A TNamed contains the essential elements (name, title)
+// to identify a derived object in lists like our MParList or MTaskList.
+// The main difference is that the name and title isn't stored and read
+// to and from root files ("//!")
+//
+// MParContainer has several enhancements compared to TNamed:
+//  - GetDescriptor():        returns name and class type
+//  - GetUniqueName():        returns a unique name (used in StreamPrimitive)
+//  - SetLogStream(MLog *lg): Set a logging stream to which loggingis stored
+//  - Reset():                Reset content of class in an eventloop
+//  - IsReadyToSave():        The contents are ready to be saved to a file
+//  - IsSavedAsPrimitive():   A unique name for this instance is already
+//                            existing
+//  - SetVariables():         Can be overloaded if the containers stores
+//                            coefficients (to be used in fits)
+//  - SetDisplay():           Set a display for redirecting graphical output
+//  - GetNames():             Get Name/Title from instance and store it in
+//                            a TObjArray (used to store the names of the
+//                            conteiners in a file
+//  - SetNames():             vice versa
+//  - ReadEnv(), WriteEnv():  Function which is used for automatical setup
+//    IsEnvDefined()          from a TEnv file
+//
 //////////////////////////////////////////////////////////////////////////////
 #include "MParContainer.h"

trunk/MagicSoft/Mars/mbase/MParContainer.h

@@ -25 +25 @@
 
 class TEnv;
+class TArrayD;
 class TDataMember;
 class TMethodCall;
@@ -83 +84 @@
     virtual Bool_t        IsSortable() const    { return kTRUE; }
 
-    virtual void        SetName(const char *name); // *MENU*
-    virtual void        SetObject(const char *name, const char *title);
-    virtual void        SetTitle(const char *title=""); // *MENU*
-    virtual void        ls(Option_t *option="") const;
-    virtual void        Print(Option_t *option="") const;
-    virtual Int_t       Sizeof() const;
-    virtual void        SavePrimitive(ofstream &out, Option_t *o="");
+    virtual void   SetName(const char *name); // *MENU*
+    virtual void   SetObject(const char *name, const char *title);
+    virtual void   SetTitle(const char *title=""); // *MENU*
+    virtual void   ls(Option_t *option="") const;
+    virtual void   Print(Option_t *option="") const;
+    virtual Int_t  Sizeof() const;
+    virtual void   SavePrimitive(ofstream &out, Option_t *o="");
 
     virtual MParContainer *New() const;
@@ -99 +100 @@
     virtual void   EnableGraphicalOutput(Bool_t flag=kTRUE) { flag ? SetBit(kEnableGraphicalOutput) : ResetBit(kEnableGraphicalOutput);}
     virtual Bool_t IsGraphicalOutputEnabled() const  { return TestBit(kEnableGraphicalOutput); }
+    virtual void   SetVariables(const TArrayD &)     { AbstractMethod("SetVariables(const TArrayD&)"); }
 
     virtual void SetDisplay(MStatusDisplay *d) { fDisplay = d; }