KaliVeda  1.13/01
Heavy-Ion Analysis Toolkit
KVBase.h
Go to the documentation of this file.
1 /***************************************************************************
2  kvbase.h - description
3  -------------------
4  begin : Thu May 16 2002
5  copyright : (C) 2002 by J.D. Frankland
6  email : frankland@ganil.fr
7 
8 $Id: KVBase.h,v 1.42 2009/03/12 13:59:40 franklan Exp $
9 ***************************************************************************/
10 
11 #ifndef KVBASE_H
12 #define KVBASE_H
13 
14 #include "KVConfig.h"
15 #include "KVMacros.h"
16 #include "TRandom3.h"
17 #include "TNamed.h"
18 #include "RVersion.h"
19 #include "TString.h"
20 #include "KVLockfile.h"
21 #include "Riostream.h"
22 #include "TPluginManager.h"
23 #include "TFile.h"
24 #include "TF1.h"
25 class KVString;
26 #ifdef WITH_RSQLITE
27 namespace KVSQLite {
28  class database;
29 }
30 #endif
31 
141 class KVBase: public TNamed {
142 
143 private:
144  static UInt_t fNbObj;
146 protected:
148 
149 private:
152 
153  void init();
154  static void ReadGUIMimeTypes();
155  static void ReadConfigFiles();
156 
157 public:
158 
159  static void Deprecated(const char* method, const char* advice);
160 
162  kIsKaliVedaObject = BIT(23) //all KVBase-derived objects have this bit set in TObject::fBits
163  };
164 
165  static void InitEnvironment();
166  KVBase();
167  KVBase(const Char_t* name, const Char_t* title = "");
168  KVBase(const KVBase&);
169  KVBase& operator=(const KVBase&);
170  virtual ~ KVBase();
171 
172  virtual void SetType(const Char_t* str)
173  {
174  SetTitle(str);
175  }
176  virtual const Char_t* GetType() const
177  {
178  return GetTitle();
179  }
180  static const Char_t* WorkingDirectory()
181  {
182  return fWorkingDirectory.Data();
183  }
184  virtual Bool_t IsType(const Char_t* typ) const
185  {
187  return !strcmp(GetType(), typ);
188  }
189  virtual Bool_t IsCalled(const Char_t* name) const
190  {
192  return !strcmp(GetName(), name);
193  }
194  void SetLabel(const Char_t* lab)
195  {
196  fLabel = lab;
197  }
198  const Char_t* GetLabel() const
199  {
200  return fLabel;
201  }
202  Bool_t HasLabel() const
203  {
204  return fLabel.Length();
205  }
206  Bool_t IsLabelled(const Char_t* l) const
207  {
209  return fLabel == l;
210  }
211  virtual void Print(Option_t* option = "") const;
212  virtual void List()
213  {
214  }
215  virtual void SetNumber(UInt_t num)
216  {
217  fNumber = num;
218  }
220  {
221  return fNumber;
222  }
224  {
225  return fNbObj;
226  }
227  virtual void Clear(Option_t* opt = "");
228 #if ROOT_VERSION_CODE >= ROOT_VERSION(3,4,0)
229  virtual void Copy(TObject&) const;
230 #else
231  virtual void Copy(TObject&);
232 #endif
233 
234  static Bool_t SearchKVFile(const Char_t* name, TString& fullpath,
235  const Char_t* kvsubdir = "");
236 #ifdef WITH_RSQLITE
237  static Bool_t SearchAndOpenKVFile(const Char_t* name, KVSQLite::database& dbfile,
238  const Char_t* kvsubdir = "");
239 #endif
240  static Bool_t SearchAndOpenKVFile(const Char_t* name, std::ifstream& file,
241  const Char_t* kvsubdir = "", KVLockfile* locks = 0);
242  static Bool_t SearchAndOpenKVFile(const Char_t* name, std::ofstream& file,
243  const Char_t* kvsubdir = "", KVLockfile* locks = 0);
244  static void BackupFileWithDate(const Char_t* path);
245  static TPluginHandler* LoadPlugin(const Char_t* base,
246  const Char_t* uri = "0");
247  static const Char_t* GetPluginURI(const Char_t* base, const Char_t* plugin);
248  static const Char_t* GetListOfPlugins(const Char_t* base);
249  static const Char_t* GetListOfPluginURIs(const Char_t* base);
250  static Bool_t IsThisAPlugin(const TString& uri, TString& base);
251  static void OpenTempFile(TString& base, std::ofstream& fp); /* open temp file with basename 'base' */
252  static void GetTempFileName(TString& base);
253 
254  static const Char_t* GetKVVersion();
255  static const Char_t* GetKVBuildDate();
256  static const Char_t* GetKVBuildTime();
257  static const Char_t* GetKVBuildType();
258  static const Char_t* GetKVBuildUser();
259  static const Char_t* GetKVSourceDir();
260  static const Char_t* GetKVBuildDir();
261 
262 #ifdef WITH_GIT_INFOS
263  static const Char_t* gitBranch();
264  static const Char_t* gitCommit();
265 #endif
266 
267  static const Char_t* GetETCDIRFilePath(const Char_t* namefile = "");
268  static const Char_t* GetDATADIRFilePath(const Char_t* namefile = "");
269  static const Char_t* GetDATABASEFilePath();
270  static const Char_t* GetLIBDIRFilePath(const Char_t* namefile = "");
271  static const Char_t* GetINCDIRFilePath(const Char_t* namefile = "");
272  static const Char_t* GetBINDIRFilePath(const Char_t* namefile = "");
273  static const Char_t* GetWORKDIRFilePath(const Char_t* namefile = "");
274  static const Char_t* GetTEMPLATEDIRFilePath(const Char_t* namefile = "");
275  static const Char_t* GetExampleFilePath(const Char_t* library, const Char_t* namefile);
276  static bool is_gnuinstall()
277  {
281 #ifdef WITH_GNU_INSTALL
282  return true;
283 #else
284  return false;
285 #endif
286  }
287 
288  static Bool_t FindExecutable(TString& exec, const Char_t* path =
289  "$(PATH)");
290 
291  static const Char_t* FindFile(const Char_t* search, TString& wfil);
292  static Bool_t FindClassSourceFiles(const Char_t* class_name, KVString& imp_file,
293  KVString& dec_file, const Char_t* dir_name = ".");
294 
295  static Bool_t AreEqual(Double_t x, Double_t y, Long64_t maxdif = 1);
296 
297  static Bool_t OpenContextMenu(const char* method, TObject* obj, const char* alt_method_name = "");
298 
299  static void CombineFiles(const Char_t* file1, const Char_t* file2, const Char_t* newfilename, Bool_t keep = kTRUE);
300 
301  virtual TObject* GetObject() const;
302 
303  static void PrintSplashScreen();
304  static const Char_t* GetDataSetEnv(const Char_t* dataset, const Char_t* type, const Char_t* defval);
305  static Double_t GetDataSetEnv(const Char_t* dataset, const Char_t* type, Double_t defval);
306  static Bool_t GetDataSetEnv(const Char_t* dataset, const Char_t* type, Bool_t defval);
307 
308  Double_t ProtectedGetX(const TF1* func, Double_t val, int& status, Double_t xmin = 0.0, Double_t xmax = 0.0) const;
309 
310  ClassDef(KVBase, 4) //Base class for all KaliVeda objects
311 };
312 
315 extern void AssignAndDelete(TString& target, char* tobedeleted);
317 Bool_t SearchFile(const Char_t* name, TString& fullpath, int ndirs, ...);
318 #endif
unsigned int UInt_t
#define str(s)
Definition: KVBase.cpp:57
void AssignAndDelete(TString &target, char *tobedeleted)
Bool_t SearchFile(const Char_t *name, TString &fullpath, int ndirs,...)
Search for file in an arbitrary number of locations, return kTRUE if file found and put full path to ...
Definition: KVBase.cpp:486
char Char_t
bool Bool_t
double Double_t
const char Option_t
#define ClassDef(name, id)
#define BIT(n)
Base class for KaliVeda framework.
Definition: KVBase.h:141
static TString fWorkingDirectory
user working directory for e.g. database files
Definition: KVBase.h:151
static const Char_t * WorkingDirectory()
Definition: KVBase.h:180
static UInt_t fNbObj
Total number of KaliVeda objects (actually counts number of calls to default ctor)
Definition: KVBase.h:144
void SetLabel(const Char_t *lab)
Definition: KVBase.h:194
UInt_t fNumber
for numbering objects
Definition: KVBase.h:145
virtual const Char_t * GetType() const
Definition: KVBase.h:176
static Bool_t FindClassSourceFiles(const Char_t *class_name, KVString &imp_file, KVString &dec_file, const Char_t *dir_name=".")
Definition: KVBase.cpp:1102
static const Char_t * GetBINDIRFilePath(const Char_t *namefile="")
Definition: KVBase.cpp:118
static void OpenTempFile(TString &base, std::ofstream &fp)
Definition: KVBase.cpp:827
static const Char_t * GetDATADIRFilePath(const Char_t *namefile="")
Definition: KVBase.cpp:74
static const Char_t * GetDATABASEFilePath()
Definition: KVBase.cpp:92
static const Char_t * GetKVBuildDate()
Returns KaliVeda build date.
Definition: KVBase.cpp:900
static const Char_t * FindFile(const Char_t *search, TString &wfil)
Definition: KVBase.cpp:1060
static const Char_t * GetINCDIRFilePath(const Char_t *namefile="")
Definition: KVBase.cpp:109
static const Char_t * gitCommit()
Returns last git commit of sources.
Definition: KVBase.cpp:976
static const Char_t * GetWORKDIRFilePath(const Char_t *namefile="")
Definition: KVBase.cpp:127
void init()
Default initialisation.
Definition: KVBase.cpp:138
UInt_t GetNumberOfObjects() const
Definition: KVBase.h:223
static Bool_t FindExecutable(TString &exec, const Char_t *path="$(PATH)")
Definition: KVBase.cpp:1001
static const Char_t * GetKVBuildUser()
Returns username of person who performed build.
Definition: KVBase.cpp:887
static void BackupFileWithDate(const Char_t *path)
Definition: KVBase.cpp:753
static void ReadConfigFiles()
Definition: KVBase.cpp:272
static const Char_t * gitBranch()
Returns git branch of sources.
Definition: KVBase.cpp:964
static const Char_t * GetListOfPluginURIs(const Char_t *base)
Definition: KVBase.cpp:1327
TString fLabel
label for the object
Definition: KVBase.h:147
virtual void Clear(Option_t *opt="")
Clear object properties : name, type/title, number, label.
Definition: KVBase.cpp:380
KVBase()
Default constructor.
Definition: KVBase.cpp:317
static const Char_t * GetListOfPlugins(const Char_t *base)
Definition: KVBase.cpp:1260
static Bool_t fEnvIsInit
set when environment is initialised
Definition: KVBase.h:150
Bool_t HasLabel() const
Definition: KVBase.h:202
static Bool_t AreEqual(Double_t x, Double_t y, Long64_t maxdif=1)
Comparison between two 64-bit floating-point values.
Definition: KVBase.cpp:1442
virtual Bool_t IsType(const Char_t *typ) const
Definition: KVBase.h:184
KVBase & operator=(const KVBase &)
copy assignment operator
Definition: KVBase.cpp:355
static void CombineFiles(const Char_t *file1, const Char_t *file2, const Char_t *newfilename, Bool_t keep=kTRUE)
Definition: KVBase.cpp:1527
const Char_t * GetLabel() const
Definition: KVBase.h:198
virtual void SetNumber(UInt_t num)
Definition: KVBase.h:215
static bool is_gnuinstall()
Definition: KVBase.h:276
static const Char_t * GetTEMPLATEDIRFilePath(const Char_t *namefile="")
Definition: KVBase.cpp:83
static const Char_t * GetKVSourceDir()
Returns top-level directory of source tree used for build.
Definition: KVBase.cpp:938
Bool_t IsLabelled(const Char_t *l) const
Definition: KVBase.h:206
static void InitEnvironment()
Definition: KVBase.cpp:181
virtual void Print(Option_t *option="") const
Definition: KVBase.cpp:410
virtual void SetType(const Char_t *str)
Definition: KVBase.h:172
static const Char_t * GetDataSetEnv(const Char_t *dataset, const Char_t *type, const Char_t *defval)
Definition: KVBase.cpp:1619
static const Char_t * GetKVBuildTime()
Returns KaliVeda build time.
Definition: KVBase.cpp:912
static void PrintSplashScreen()
Prints welcome message and infos on version etc.
Definition: KVBase.cpp:1593
virtual void List()
Definition: KVBase.h:212
static const Char_t * GetLIBDIRFilePath(const Char_t *namefile="")
Definition: KVBase.cpp:100
static const Char_t * GetExampleFilePath(const Char_t *library, const Char_t *namefile)
Return full path to example file for given library (="KVMultiDet", "BackTrack", etc....
Definition: KVBase.cpp:1577
virtual Bool_t IsCalled(const Char_t *name) const
Definition: KVBase.h:189
Double_t ProtectedGetX(const TF1 *func, Double_t val, int &status, Double_t xmin=0.0, Double_t xmax=0.0) const
Definition: KVBase.cpp:1691
static const Char_t * GetKVBuildDir()
Returns top-level directory used for build.
Definition: KVBase.cpp:951
static void ReadGUIMimeTypes()
Definition: KVBase.cpp:1397
static Bool_t IsThisAPlugin(const TString &uri, TString &base)
Definition: KVBase.cpp:1357
EKaliVedaBits
Definition: KVBase.h:161
@ kIsKaliVedaObject
Definition: KVBase.h:162
virtual TObject * GetObject() const
Definition: KVBase.cpp:1560
static void GetTempFileName(TString &base)
Definition: KVBase.cpp:848
static Bool_t SearchKVFile(const Char_t *name, TString &fullpath, const Char_t *kvsubdir="")
Definition: KVBase.cpp:538
static const Char_t * GetKVBuildType()
Returns KaliVeda build type (cmake build: Release, Debug, RelWithDebInfo, ...)
Definition: KVBase.cpp:925
static const Char_t * GetPluginURI(const Char_t *base, const Char_t *plugin)
Definition: KVBase.cpp:1177
static const Char_t * GetETCDIRFilePath(const Char_t *namefile="")
Definition: KVBase.cpp:65
virtual ~ KVBase()
static Bool_t OpenContextMenu(const char *method, TObject *obj, const char *alt_method_name="")
Definition: KVBase.cpp:1495
static Bool_t SearchAndOpenKVFile(const Char_t *name, KVSQLite::database &dbfile, const Char_t *kvsubdir="")
Definition: KVBase.cpp:649
virtual void Copy(TObject &) const
Make a copy of this object.
Definition: KVBase.cpp:394
static TPluginHandler * LoadPlugin(const Char_t *base, const Char_t *uri="0")
Definition: KVBase.cpp:793
static const Char_t * GetKVVersion()
Returns KaliVeda version string.
Definition: KVBase.cpp:874
static void Deprecated(const char *method, const char *advice)
Definition: KVBase.cpp:1734
UInt_t GetNumber() const
Definition: KVBase.h:219
Interface to (Linux) system lockfile command.
Definition: KVLockfile.h:69
Interface to ROOT SQLite database backend ,.
Definition: SQLiteDB.h:389
Extension of ROOT TString class which allows backwards compatibility with ROOT v3....
Definition: KVString.h:72
virtual const char * GetName() const
virtual void SetTitle(const char *title="")
virtual const char * GetTitle() const
Ssiz_t Length() const
const char * Data() const
long long Long64_t
auto * l