8 Paths.hpp

Renata Kopecná edited this page 2022-02-10 11:37:42 +01:00

Table of Contents

• Table of Contents
• Functions and their parameters
• Preselection files
• string getOriginalFiles()
• string GetInputFile()
• string GetInputFileBkg()
• string GetInputFile()
• string GetHistosFile()
• string GetHistosFileBkg()
• Generator level files
• string GetGenLevelFile()
• MVA files
• string GetBDTinputFile()
• string GetBDToutputFile()
• string GetBDToutputFile()
• string GetBDTConfigFile()
• Final selection files
• string GetFinalOutputFile()
• string GetFinalOutputFile()
• Mass fit files
• string GetControlPlots()
• string GetMassFitFile()
• string GetMassFitFile()
• string GetMassFitFile()
• Efficiency files
• string GetEfficiencyMassFitFile()
• string GetEfficiencyPi0MassFitFile()
• string GetEfficiencyFile()
• string GetEfficiencyFileTM()
• string GetEfficiencyFilePi0TM()
• string GetEfficiencyFile()
• string GetEfficiencyFile()
• string GetEfficiencyFile()
• string GetEfficiencyFile()
• string GetBDTScanFile()
• string GetBDTScanBackgroundFitFile()
• TMVA plots
• string GetTMVAplotsFolder()
• Resolution plots
• string getResolutionFile()
• Other paths
• string returnFileAddress()
• Truth matching control plots
• std::string dataTypeString()
• string getTMplotsFolder()
• string getTMplotsPath()
• Restoring preselected data from backup
• bool restore_from_backup()
• bool restore_allYears_from_backup()
• bool restore_allData_from_backup()
• int restore_allMCsig_from_backup()
• int restore_allMCref_from_backup()
• int restore_allPHSP_from_backup()
• int restore_allMC_from_backup()
• Create backups
• bool create_backup()
• bool create_allYears_backup()
• bool create_allData_backup()
• int create_allMCsig_backup()
• int create_allMCref_backup()
• int create_allPHSP_backup()
• int create_allMC_backup()
• bool create_backup_MCsig()
• int create_backup_All_MCsig()

In this file, the functions returning paths of various files are defined. Unfortunately, as we are trying to compile and run things within ROOT, it is orders of magnitute easier to have the funcitons defined fully in the header. Including cross-refrences with Utils.hpp.

Table of Contents

• Functions and their parameters
  • Preselection files
    • string getOriginalFiles()
    • string GetInputFile()
    • string GetInputFileBkg()
    • string GetInputFile()
    • string GetHistosFile()
    • string GetHistosFileBkg()
  • Generator level files
    • string GetGenLevelFile()
  • MVA files
    • string GetBDTinputFile()
    • string GetBDToutputFile()
    • string GetBDToutputFile()
    • string GetBDTConfigFile()
  • Final selection files
    • string GetFinalOutputFile()
    • string GetFinalOutputFile()
  • Mass fit files
    • string GetControlPlots()
    • string GetMassFitFile()
    • string GetMassFitFile()
    • string GetMassFitFile()
  • Efficiency files
    • string GetEfficiencyMassFitFile()
    • string GetEfficiencyPi0MassFitFile()
    • string GetEfficiencyFile()
    • string GetEfficiencyFileTM()
    • string GetEfficiencyFilePi0TM()
    • string GetEfficiencyFile()
    • string GetEfficiencyFile()
    • string GetEfficiencyFile()
    • string GetEfficiencyFile()
    • string GetBDTScanFile()
    • string GetBDTScanBackgroundFitFile()
  • TMVA plots
    • string GetTMVAplotsFolder()
  • Resolution plots
    • string getResolutionFile()
  • Other paths
    • string returnFileAddress()
  • Truth matching control plots
    • std::string dataTypeString()
    • string getTMplotsFolder()
    • string getTMplotsPath()
  • Restoring preselected data from backup
    • bool restore_from_backup()
    • bool restore_allYears_from_backup()
    • bool restore_allData_from_backup()
    • int restore_allMCsig_from_backup()
    • int restore_allMCref_from_backup()
    • int restore_allPHSP_from_backup()
    • int restore_allMC_from_backup()
  • Create backups
    • bool create_backup()
    • bool create_allYears_backup()
    • bool create_allData_backup()
    • int create_allMCsig_backup()
    • int create_allMCref_backup()
    • int create_allPHSP_backup()
    • int create_allMC_backup()
    • bool create_backup_MCsig()
    • int create_backup_All_MCsig()

Functions and their parameters

Preselection files

string getOriginalFiles()

• Parameters
  • string year
  • string magnet
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool smallSample
• Return
  • Returns the address of the stripped files (wildcard instead of the file numbers, if smallSample, returns one specific file path).

string GetInputFile()

• Parameters
  • string year/int year
  • string magnet
  • bool preSelected
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool smallSample
• Return
  • Returns file path ot the required sample.

string GetInputFileBkg()

Dedicated function needed as the background samples were saved in a different place than the resto of the files.

• Parameters
  • string year/int year
  • string magnet
  • bool preSelected
  • bool ReferenceChannel
  • bool B0
  • bool K1
  • bool Inc
• Return
  • Returns file path ot the required background sample.

string GetInputFile()

• Parameters
  • string year
  • string magnet
  • bool preSelected
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool B0
  • bool K1
  • bool Inc
  • bool smallSample
• Return
  • Either GetInputFile() or GetInputFileBkg()

string GetHistosFile()

• Parameters
  • string year/int year
  • string magnet
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool smallSample
• Return
  • The path of the histogram file created by preSelection().

string GetHistosFileBkg()

• Parameters
  • string year/int year
  • string magnet
  • bool ReferenceChannel
  • bool B0
  • bool K1
  • bool Inc
• Return
  • The path of the histogram file created by preSelection()

Generator level files

string GetGenLevelFile()

• Parameters
  • bool ReferenceChannel
  • bool PHSP
• Return
  • Path to the generator-level MC samples

MVA files

string GetBDTinputFile()

• Parameters
  • string year/int year
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
• Return
  • Path to the preselected data/MC files created by preSelection()

string GetBDToutputFile()

• Parameters
  • string year/int year
  • int Run
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
  • bool UseLowQ2Range
  • bool reweighted
• Return
  • Path to the files containing the MVA response created by TMVAClassificationApplication_b2kmm().

string GetBDToutputFile()

• Parameters
  • int Run
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
  • bool UseLowQ2Range
  • bool reweighted
• Return
  • string GetBDToutputFile() with no year

string GetBDTConfigFile()

• Parameters
  • bool SplitYears
  • int year
  • int Run
  • bool KShortDecaysInVelo
  • int nConfiguration
  • bool UseLowQ2Range
  • string customTMbranch
  • bool gammaTM
• Return
  • Path to the config file created by MVA_b2kmm().

Final selection files

string GetFinalOutputFile()

• Parameters
  • string year/int year
  • int Run
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
  • bool UseLowQ2Range
• Return
  • Patht to the tuple files containing the trees after applying the MVA cut.

string GetFinalOutputFile()

• Parameters
  • int year
  • int Run
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
  • bool UseLowQ2Range
• Return
  • string GetFinalOutputFile() with no year

Mass fit files

string GetControlPlots()

• Parameters
  • string year
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
  • bool sWeightUse
  • int canvas
• Return
  • Adress of control plots when applying weighting

string GetMassFitFile()

• Parameters
  • std::string year
  • string magnet
  • int Run
  • bool MC
  • bool Preselected
  • bool TM
  • bool PHSP
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool GetShapeFromMC
  • string SignalType
  • string BckGndType
  • bool ConstrainParameters
  • bool KshortDecaysInVelo
  • bool UseLowQ2Range
  • Double_t TMVAcut
  • int randomSubset
  • bool fixedMassRegion
  • bool yieldOverFullRange
  • string sExtraVar
  • int nExtraBin
  • binned
  • bool removeMultiple
  • bool weighted
  • bool weightedFromPi0
  • string whichWeight
  • bool notTM
  • string customTMbranch
  • bool gammaTM
  • bool InclusiveSample
• Return
  • Return the path to the file with the mass fit created by massFit().

string GetMassFitFile()

• Parameters
  • std::string year
  • bool MC
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool KshortDecaysInVelo
  • bool GetShapeFromMC
  • string SignalType
  • string BckGndType
  • bool ConstrainParameters
  • bool fixedMassRegion
  • bool weighted
• Return
  • Return the path to the file with the mass fit created by quickFit().

string GetMassFitFile()

• Parameters
  • std::string year
  • int Run
  • bool MC
  • bool PHSP
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool GetShapeFromMC
  • string SignalType
  • string BckGndType
  • bool ConstrainParameters
  • bool KshortDecaysInVelo
  • bool UseLowQ2Range
  • Double_t TMVAcut
  • bool fixedMassRegion
  • bool removeMultiple
• Return
  • Return the path to the file with the mass fit created by basicYieldFit().

Efficiency files

string GetEfficiencyMassFitFile()

• Parameters
  • std::string year
  • string magnet
  • int Run
  • bool Preselected
  • bool TM
  • bool PHSP
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool GetShapeFromMC
  • string SignalType
  • string BckGndType
  • bool ConstrainParameters
  • bool KshortDecaysInVelo
  • bool UseLowQ2Range
  • Double_t TMVAcut
  • bool fixedMassRegion
  • string sExtraVar
  • int nExtraBin
  • bool removeMultiple
  • bool weighted
  • bool weightedFromPi0
  • string whichWeight
  • string customTMbranch
  • bool gammaTM
• Return
  • Calls GetMassFitFile(). In the path, replaces the folder MassFits to Efficiencies/MassFits

string GetEfficiencyPi0MassFitFile()

• Parameters
  • bool fromPi0
  • string year
  • string magnet
  • int Run
  • string customTMbranch
  • bool gammaTM
  • int nBins
  • bool fixSigma
  • bool fixMass
  • bool useFancyFit
  • bool simFit
  • bool binnedFit
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool RemoveMultiple
  • bool weighted
  • bool weightedFromPi0
  • string whichWeight
  • string sExtraVar
  • int nExtraBin
• Return
  • Returns a path for the efficinecy mass fit files with extra tags used to check the pi0 TM and using pi0 weights.

string GetEfficiencyFile()

• Parameters
  • string effType
  • string year
  • string magnet
  • int Run
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool KshortDecayInVelo
  • bool RemoveMultiple
  • bool weighted
  • bool weightedFromPi0
  • string whichWeight
  • bool UseLowQ2Range
  • bool useFancyFit
  • string sExtraVar
  • string customTMbranch
  • bool gammaTM
  • int nBins
  • bool fixSigma
  • bool fixMass
  • bool simFit
  • bool binnedFit
  • bool sigEff
• Return
  • Path to the efficeny file defined by the options.

string GetEfficiencyFileTM()

• Parameters
  • string effType
  • string year
  • string magnet
  • int Run
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool KshortDecayInVelo
  • bool RemoveMultiple
  • bool weighted
  • bool weightedFromPi0
  • string whichWeight
  • bool UseLowQ2Range
  • bool useFancyFit
  • string sExtraVar
  • bool sigEff
  • string customTMbranch
  • bool gammaTM
• Return
  • Calls string GetEfficiencyFile() with settings set to truth matching efficiency.

string GetEfficiencyFilePi0TM()

• Parameters
  • string year
  • int Run
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool weightedFromPi0
  • string whichWeight
  • bool useFancyFit
  • string sExtraVar
  • bool sigEff
• Return
  • Calls string GetEfficiencyFile() with settings set to pi0-related truth matching efficiency.

string GetEfficiencyFile()

• Parameters
  • string effType
  • string year
  • string magnet
  • int Run
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool KshortDecayInVelo
  • bool RemoveMultiple
  • bool weighted
  • bool UseLowQ2Range
  • bool useFancyFit
  • string sExtraVar
  • string customTMbranch
  • bool gammaTM
• Return
  • Calls string GetEfficiencyFile() with settings ignoring the pi0 tests.

string GetEfficiencyFile()

Calls string GetEfficiencyFile().

• Parameters
  • string effType
  • string year
  • string magnet
  • int Run
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool KshortDecayInVelo
  • bool RemoveMultiple
  • bool weighted
  • bool UseLowQ2Range
  • bool useFancyFit
  • string sExtraVar
• Return
  • Path to the default efficiency files used to calculate the expected yield in BDTcutScanner.cpp, for given year and run.

string GetEfficiencyFile()

• Parameters
  • string effType
  • string year
  • string magnet
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool KshortDecayInVelo
  • bool RemoveMultiple
  • bool weighted
  • bool UseLowQ2Range
  • bool useFancyFit
  • string sExtraVar
• Return
  • Path to the default efficiency files used to calculate the expected yield in BDTcutScanner.cpp, for given year.

string GetEfficiencyFile()

• Parameters
  • string effType
  • string magnet
  • int Run
  • bool UseOnlyJpsiEvents
  • bool UseOnlyMuMuEvents
  • bool PHSP
  • bool KshortDecayInVelo
  • bool RemoveMultiple
  • bool weighted
  • bool UseLowQ2Range
  • bool useFancyFit
  • string sExtraVar
• Return
  • Path to the default efficiency files used to calculate the expected yield in BDTcutScanner.cpp, for given Run.

string GetBDTScanFile()

• Parameters
  • string year
  • string magnet
  • int Run
  • bool KshortDecayInVelo
  • bool UseLowQ2Range
  • bool fineScan
• Return
• Path to the default efficiency files used to calculate the expected yield in BDTcutScanner.cpp, for given year.

string GetBDTScanBackgroundFitFile()

• Parameters
  • string year
  • int Run
  • bool KshortDecayInVelo
  • bool UseLowQ2Range
  • double TMVAcut
• Return
  • Path to the simple background only fit to the upper mass sideband

TMVA plots

string GetTMVAplotsFolder()

• Parameters
  • int year
  • int Run
  • bool SplitYears
  • bool KshortDecaysInVelo
  • int nConfiguration
  • bool UseLowQ2Range
  • (string customTMbranch)
  • (bool gammaTM)
• Return
  • Path to the folder with pretty TMVA plots

Resolution plots

string getResolutionFile()

• Parameters
  • string year
  • int Run
  • bool TM
  • bool RemoveMultiple
  • double TMVAcut
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
• Return
  • Reslution plot adress.

Other paths

string returnFileAddress()

• Parameters
  • string year
  • int Run
  • string magnet
  • bool Preselected
  • bool BDTed
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
  • bool KshortDecayInVelo
• Return
  • Returns either GetFinalOutputFile() or GetBDTinputFile() or GetInputFile()

Truth matching control plots

std::string dataTypeString()

• Parameters
  • bool MC
  • bool Reference
  • bool PHSP
  • bool B0
  • bool K1
  • bool Inc
• Return
  • Tag for the given sample (eg. "data", "RefMC" or "BtoXJpsi")

string getTMplotsFolder()

• Parameters
  • string year
  • bool Reference
  • bool PHSP
  • bool B0
  • bool K1
  • bool Inc
• Return
  • Folder where the control truth-matching plots are stored.

string getTMplotsPath()

• Parameters
  • string name
  • string year
  • bool Reference
  • bool PHSP
  • bool B0
  • bool K1
  • bool Inc
• Return
  • Return the control truth-matching plot file (calls getTMplotsFolder()).

Restoring preselected data from backup

Useuful when the selection changes, one does not have to run the whole preSelection().

bool restore_from_backup()

Replace the current preselected file by the one from backup.

• Parameters
  • string year
  • string magnet
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
• Return
  • Always one

bool restore_allYears_from_backup()

Calls restore_from_backup() for all years and both polarities.

• Parameters
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
• Return
  • Always one

bool restore_allData_from_backup()

Calls restore_allYears_from_backup() for data.

• Return
  • Always one

int restore_allMCsig_from_backup()

Calls restore_allYears_from_backup() for signal MC.

• Return
  • Always one

int restore_allMCref_from_backup()

Calls restore_allYears_from_backup() for reference MC.

• Return
  • Always one

int restore_allPHSP_from_backup()

Calls restore_allYears_from_backup() for PHSP MC.

• Return
  • Always one

int restore_allMC_from_backup()

Restores all the MC samples from backup (see the three functions above)

• Return
  • Always one

Create backups

bool create_backup()

Takes the current preselected file and copies it into a backup file.

• Parameters
  • string year
  • string magnet
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
• Return
  • Always one

bool create_allYears_backup()

Calls create_backup() for all years and polarities.

• Parameters
  • bool MC
  • bool ReferenceChannel
  • bool PHSP
• Return
  • Always one

bool create_allData_backup()

Calls create_allYears_backup() for data.

• Return
  • Always one

int create_allMCsig_backup()

Calls create_allYears_backup() for signal MC.

• Return
  • Always one

int create_allMCref_backup()

Calls create_allYears_backup() for reference MC.

• Return
  • Always one

int create_allPHSP_backup()

Calls create_allYears_backup() for PHSP MC.

• Return
  • Always one

int create_allMC_backup()

Creates backup of all MC samples (see the three functions above).

• Return
  • Always one

bool create_backup_MCsig()

Probably obsolete. Copies a preselected file into a backup file.

• Parameters
  • string year
  • string magnet
• Return

int create_backup_All_MCsig()

Calls create_backup_MCsig() for all years and polarities.

• Return
  • Always one