ANALYSIS/AliAnalysisGrid.h

   1 #ifndef ALIANALYSISGRID_H
   2 #define ALIANALYSISGRID_H
   3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   4  * See cxx source for full Copyright notice                               */
   5
   6 // Author: Mihaela Gheata, 01/09/2008
   7
   8 //==============================================================================
   9 //   AliAnalysisGrid - Base grid utility class. Provides interface for creating
  10 // a personalized JDL, finding and creating a dataset.
  11 //==============================================================================
  12
  13 #ifndef ROOT_TNamed
  14 #include <TNamed.h>
  15 #endif
  16
  17 class TChain;
  18
  19 class AliAnalysisGrid : public TNamed {
  20
  21 public:
  22
  23 enum EPluginRunMode {
  24    kFull     = 0,
  25    kTest     = BIT(14),
  26    kOffline  = BIT(15),
  27    kSubmit   = BIT(16),
  28    kMerge    = BIT(17),
  29    kUseTags  = BIT(18),
  30    kUseESD   = BIT(19),
  31    kUseAOD   = BIT(20),
  32    kUseMC    = BIT(21),
  33    kUsePars  = BIT(22),
  34    kDefaultOutputs = BIT(23)
  35 };
  36 enum EPluginBits {
  37    kBitMask32  = 0xffffffff,
  38    kUseCopy    = BIT(0),
  39    kCheckCopy  = BIT(1),
  40    kKeepLogs   = BIT(2),
  41    kClearPackages = BIT(3),
  42    kUseSubmitPolicy = BIT(4)
  43 };
  44
  45    AliAnalysisGrid() : TNamed(), fSpecialBits(0) {}
  46    AliAnalysisGrid(const char *name) : TNamed(name,""), fSpecialBits(0) {}
  47    virtual ~AliAnalysisGrid() {}
  48    AliAnalysisGrid(const AliAnalysisGrid& other);
  49    AliAnalysisGrid& operator=(const AliAnalysisGrid& other);
  50 // Getters
  51    virtual EPluginRunMode GetRunMode() const;
  52 // Setters
  53    virtual void        AddIncludePath(const char *path)                  = 0;
  54    virtual void        AddRunNumber(Int_t run)                           = 0;
  55    virtual void        AddRunNumber(const char *run)                     = 0;
  56    virtual void        AddDataFile(const char *lfn)                      = 0;
  57    virtual Bool_t      IsSingleOutput() const                            = 0;
  58    virtual void        SetExecutable(const char *name="analysis.sh")     = 0;
  59    virtual void        SetArguments(const char *name="")                 = 0;
  60    virtual void        SetAnalysisMacro(const char *name="myAnalysis.C") = 0;
  61    virtual void        SetAnalysisSource(const char *name="myAnalysisClass.cxx") = 0;
  62    virtual void        SetAdditionalLibs(const char *list)               = 0;
  63    virtual void        SetPrice(Int_t price=1)                           = 0;
  64    virtual void        SetJobTag(const char *tag="")                     = 0;
  65    virtual void        SetSplitMode(const char *type="se")               = 0;
  66    virtual void        SetSplitMaxInputFileNumber(Int_t nfiles=100)      = 0;
  67    virtual void        SetAPIVersion(const char *version)                = 0;
  68    virtual void        SetROOTVersion(const char *version)               = 0;
  69    virtual void        SetAliROOTVersion(const char *version)            = 0;
  70    virtual void        SetUser(const char *user)                         = 0;
  71    virtual void        SetTTL(Int_t ttl=30000)                           = 0;
  72    virtual void        SetGridWorkingDir(const char *name="workdir")     = 0;
  73    virtual void        SetGridDataDir(const char *name)                  = 0;
  74    virtual void        SetDataPattern(const char *pattern)               = 0;
  75    virtual void        SetDefaultOutputs(Bool_t flag=kTRUE)              = 0;
  76    virtual void        SetGridOutputDir(const char *name="output")       = 0;
  77    virtual void        SetOutputArchive(const char *list="log_archive.zip:std*@disk=1 root_archive.zip:*.root@disk=2") = 0;
  78    virtual void        SetOutputFiles(const char *list)                  = 0;
  79    virtual void        SetInputFormat(const char *format="xml-single")   = 0;
  80    virtual void        SetMaxInitFailed(Int_t nfail=5)                   = 0;
  81    virtual void        SetMergeExcludes(const char *list)                = 0;
  82    virtual void        SetMergeViaJDL(Bool_t on=kTRUE)                   = 0;
  83    virtual void        SetMasterResubmitThreshold(Int_t percentage)      = 0;
  84    virtual void        SetNtestFiles(Int_t nfiles)                       = 0;
  85    virtual void        SetJDLName(const char *name="analysis.jdl")       = 0;
  86    virtual void        SetPreferedSE(const char *se)                     = 0;
  87    virtual void        SetProductionMode(Int_t mode=1)                   = 0;
  88    virtual void        SetRunPrefix(const char *prefix)                  = 0;
  89    virtual void        SetOutputSingleFolder(const char *folder)         = 0;
  90    virtual void        SetFastReadOption(Bool_t on=kTRUE)                = 0;
  91    virtual void        SetOverwriteMode(Bool_t on=kTRUE)                 = 0;
  92
  93  // Set run mode.  Can be "full", "test", "offline", "submit" or "merge"
  94    virtual void        SetRunMode(const char *mode="full");
  95 //Utilities
  96    static  Bool_t      CreateToken(const char *username=0);
  97    virtual Bool_t      CreateDataset(const char *pattern)                = 0;
  98    virtual Bool_t      CreateJDL()                                       = 0;
  99    virtual void        EnablePackage(const char *package)                = 0;
 100    virtual Bool_t      MergeOutputs()                                    = 0;
 101    virtual Bool_t      StartAnalysis(Long64_t nentries=123456789, Long64_t firstentry=0) = 0;
 102    virtual void        WriteAnalysisFile()                               = 0;
 103    virtual void        WriteAnalysisMacro()                              = 0;
 104    virtual void        WriteExecutable()                                 = 0;
 105    virtual void        WriteValidationScript(Bool_t merge=kFALSE)        = 0;
 106
 107 // Flags
 108    Bool_t              IsUseCopy() const {return TestSpecialBit(kUseCopy);}
 109    void                SetUseCopy(Bool_t flag=kTRUE) {SetSpecialBit(kUseCopy,flag);}
 110    Bool_t              IsCheckCopy() const {return TestSpecialBit(kCheckCopy);}
 111    void                SetCheckCopy(Bool_t flag=kTRUE) {SetSpecialBit(kCheckCopy,flag);}
 112    Bool_t              IsKeepLogs() const {return TestSpecialBit(kKeepLogs);}
 113    void                SetKeepLogs(Bool_t flag=kTRUE) {SetSpecialBit(kKeepLogs,flag);}
 114    Bool_t              IsUseSubmitPolicy() const {return TestSpecialBit(kUseSubmitPolicy);}
 115    void                SetUseSubmitPolicy(Bool_t flag=kTRUE) {SetSpecialBit(kUseSubmitPolicy,flag);}
 116
 117 // PROOF mode
 118    virtual void        SetProofCluster(const char *cluster)              = 0;
 119    virtual void        SetProofDataSet(const char *dataset)              = 0;
 120    virtual const char *GetProofDataSet() const                           = 0;
 121    virtual void        SetProofReset(Int_t mode)                         = 0;
 122    virtual void        SetClearPackages(Bool_t flag=kTRUE) {SetSpecialBit(kClearPackages,flag);}
 123    virtual void        SetNproofWorkers(Int_t nworkers)                  = 0;
 124    virtual void        SetRootVersionForProof(const char *version)       = 0;
 125    virtual void        SetAliRootMode(const char *mode)                  = 0;
 126    // .txt file containing the list of files to be chained in test mode
 127    virtual void        SetFileForTestMode(const char *filename)          = 0;
 128    virtual TChain     *GetChainForTestMode(const char *treeName) const   = 0;
 129
 130 protected:
 131 // Methods
 132    virtual Bool_t      Connect()                                         = 0;
 133    virtual void        SetDefaults()                                     = 0;
 134    void     SetSpecialBit(UInt_t f) { fSpecialBits |= f & kBitMask32; }
 135    void     ResetSpecialBit(UInt_t f) { fSpecialBits &= ~(f & kBitMask32); }
 136    void     SetSpecialBit(UInt_t f, Bool_t set) {(set)?SetSpecialBit(f):ResetSpecialBit(f);}
 137    Bool_t   TestSpecialBit(UInt_t f) const { return (Bool_t) ((fSpecialBits & f) != 0); }
 138    Int_t    TestSpecialBits(UInt_t f) const { return (Int_t) (fSpecialBits & f); }
 139    void     InvertSpecialBit(UInt_t f) { fSpecialBits ^= f & kBitMask32; }
 140
 141 protected:
 142    UInt_t              fSpecialBits; // special bits
 143
 144
 145    ClassDef(AliAnalysisGrid, 2)   // Base class for GRID utilities
 146 };
 147 #endif