KVDataSet.h

Go to the documentation of this file.

/*
$Id: KVDataSet.h,v 1.26 2009/01/27 08:06:56 franklan Exp $
$Revision: 1.26 $
$Date: 2009/01/27 08:06:56 $
$Author: franklan $
*/
 
#ifndef __KVDATASET_H
#define __KVDATASET_H
 
#include "KVString.h"
#include "KVBase.h"
#include "KVList.h"
#include "KVNumberList.h"
#include "TDatime.h"
#include "TFile.h"
#include "TEnv.h"
#include "TSystem.h"
#include "KVDataAnalysisTask.h"
#include "KVExpDB.h"
 
class KVDataSetManager;
class KVDataRepository;
class KVDBSystem;
class TObjArray;
class KVDBRun;
class KVAvailableRunsFile;
 
class KVDataSet: public KVBase {
 
   friend class KVAvailableRunsFile;
   friend class KVDataSetManager;
 
protected:
    KVDataRepository* fRepository;
    TString fDatatypes;
    KVList fTasks;
    TString fCalibDir;
    Bool_t fDBBuild;
    mutable unique_ptr<TFile> fDBase;
    TString fDBName;
    TString fDBFileName;
    mutable KVExpDB* fDataBase;
    mutable KVList fAvailableRuns;
   enum {
      kAvailable = BIT(14)     //flag set if this dataset is physically present on local machine
   };
    TString fUserGroups;
 
   virtual const Char_t* GetBaseFileName(const Char_t* type, Int_t run) const;
 
   virtual void OpenDataBase(Option_t* opt = "") const;
   virtual void OpenDBFile(const Char_t* full_path_to_dbfile) const;
   virtual void WriteDBFile(const Char_t* full_path_to_dbfile) const;
   void SetDBFileName(const Char_t* name)
   {
      fDBFileName = name;
   }
   const Char_t* GetDBFileName() const;
   void SetDBName(const Char_t* name)
   {
      fDBName = name;
   }
   const Char_t* GetDBName() const;
   const Char_t* GetFullPathToDB() const;
   void SetDataSetSpecificTaskParameters(KVDataAnalysisTask*) const;
   TObject* open_runfile(const Char_t* type, Int_t run);
 
public:
 
   KVAvailableRunsFile* GetAvailableRunsFile(const Char_t* type) const;
 
   KVDataSet();
   virtual ~ KVDataSet() {}
 
   virtual Bool_t CheckUserCanAccess();
 
   virtual void SetDataPathSubdir(const Char_t* s)
   {
      SetLabel(s);
   }
   virtual const Char_t* GetDataPathSubdir() const
   {
      return GetLabel();
   }
   const Char_t* GetDataTypeSubdir(const Char_t* type) const
   {
      KVString snom;
      snom.Form("KVDataSet.DataType.Subdir.%s", type);
      return GetDataSetEnv(snom.Data(), type);
   }
   virtual const Char_t* GetAvailableDataTypes() const
   {
      return fDatatypes.Data();
   }
   virtual void AddAvailableDataType(const Char_t*);
   virtual void SetUserGroups(const Char_t* groups)
   {
      fUserGroups = groups;
   }
   virtual Bool_t IsAvailable() const
   {
      return TestBit(kAvailable);
   }
   virtual void SetAvailable(Bool_t yes = kTRUE)
   {
      SetBit(kAvailable, yes);
   }
   virtual void CheckAvailable();
 
   virtual Bool_t HasDataType(const Char_t* data_type) const
   {
 
      KVString _dt = data_type;
      _dt.Remove(TString::kBoth, ' ');
      return (_dt == "*" || fDatatypes.Contains(_dt));
   }
 
   virtual void ls(Option_t* opt = "") const;
   virtual void Print(Option_t* opt = "") const;
 
   virtual void SetAnalysisTasks(const KVSeqCollection*);
   virtual KVDataAnalysisTask* GetAnalysisTask(Int_t) const;
   virtual KVDataAnalysisTask* GetAnalysisTask(const Char_t* keywords) const;
   virtual std::unique_ptr<KVDataAnalysisTask> GetAnalysisTaskAny(const Char_t* keywords) const;
   virtual Int_t GetNtasks() const;
 
   virtual TList* GetListOfAvailableSystems(const Char_t* datatype,
         KVDBSystem* systol = 0);
   virtual TList* GetListOfAvailableSystems(KVDataAnalysisTask* datan,
         KVDBSystem* systol = 0);
 
   void cd() const;
 
   const Char_t* GetDataSetDir() const;
   void SetName(const char* name);
 
 
   KVExpDB* GetDataBase(Option_t* opt = "") const;
   virtual void SaveDataBase() const;
 
   const Char_t* GetDataSetEnv(const Char_t* type, const Char_t* defval = "") const;
   Double_t GetDataSetEnv(const Char_t* type, Double_t defval) const;
   Bool_t GetDataSetEnv(const Char_t* type, Bool_t defval) const;
 
   TString GetFullPathToRunfile(const Char_t* type, Int_t run) const;
   const Char_t* GetRunfileName(const Char_t* type, Int_t run) const;
   TDatime GetRunfileDate(const Char_t* type, Int_t run);
   template <typename FileType>
   FileType* OpenRunfile(const Char_t* type, Int_t run)
   {
      return dynamic_cast<FileType*>(open_runfile(type, run));
   }
   TObject* OpenRunfile(const Char_t* type, Int_t run)
   {
      return open_runfile(type, run);
   }
 
   Bool_t CheckRunfileAvailable(const Char_t* type, Int_t run);
   void UpdateAvailableRuns(const Char_t* type);
   TFile* NewRunfile(const Char_t* type, Int_t run);
   void CommitRunfile(const Char_t* type, Int_t run, TFile* file);
 
   void CopyRunfilesFromRepository(const Char_t* type, KVNumberList runs, const Char_t* destdir);
 
   void DeleteRunfile(const Char_t* type, Int_t run, Bool_t confirm = kTRUE);
   void DeleteRunfiles(const Char_t* type, KVNumberList lrun = "", Bool_t confirm = kTRUE);
   KVNumberList GetRunList_DateSelection(const Char_t* type, TDatime* min = 0, TDatime* max = 0);
   KVNumberList GetRunList_StageSelection(const Char_t* other_type, const Char_t* base_type, KVDBSystem* sys = 0, Bool_t OnlyCol = kFALSE);
   KVNumberList GetRunList_VersionSelection(const Char_t* type, const Char_t* version, KVDBSystem* sys = 0);
   void SetRepository(KVDataRepository*);
   KVDataRepository* GetRepository() const;
 
   void CheckMultiRunfiles(const Char_t* data_type);
   void CleanMultiRunfiles(const Char_t* data_type, Bool_t confirm = kTRUE);
 
   Bool_t CheckRunfileUpToDate(const Char_t* data_type, Int_t run,
                               KVDataRepository* other_repos);
   Bool_t CheckRunfileUpToDate(const Char_t* data_type, Int_t run,
                               const Char_t* other_repos);
   void CheckUpToDate(const Char_t* data_type,
                      const Char_t* other_repos);
   KVNumberList GetUpdatableRuns(const Char_t* data_type,
                                 const Char_t* other_repos);
 
   KVNumberList GetRunList(const Char_t* data_type,
                           const KVDBSystem* sys = 0) const;
 
   virtual void MakeAnalysisClass(const Char_t* task, const Char_t* classname);
 
   Bool_t OpenDataSetFile(const Char_t* filename, std::ifstream& file);
   static Bool_t OpenDataSetFile(const TString& dataset, const Char_t* filename, std::ifstream& file);
   TString GetFullPathToDataSetFile(const Char_t* filename);
   static TString GetFullPathToDataSetFile(const TString& dataset, const Char_t* filename);
   static Bool_t FindDataSetFile(const TString& dataset, const Char_t* filename);
   Bool_t FindDataSetFile(const Char_t* filename);
 
   virtual Bool_t DataBaseNeedsUpdate() const;
 
   virtual const Char_t* GetReconstructedEventClassName() const
   {
 
      return GetDataSetEnv("ReconstructedEventClassName", "KVReconstructedEvent");
   }
 
   TString GetOutputRepository(const Char_t* taskname) const;
   void CopyRunfilesToRepository(const Char_t* type, KVNumberList runs, const Char_t* destrepo);
 
   Bool_t HasCalibIdentInfos() const
   {
      return GetDataSetEnv("HasCalibIdentInfos", kTRUE);
   }
 
   ClassDef(KVDataSet, 2)       //Describes a set of experimental data which may be analysed with KaliVeda
};
 
R__EXTERN KVDataSet* gDataSet;
 
#endif