Skip to content

Latest commit

 

History

History
164 lines (120 loc) · 14.1 KB

1_ScriptsAndConfigs.md

File metadata and controls

164 lines (120 loc) · 14.1 KB

Python Scripts And JSON Configs

@tableofcontents

Main Python Scripts

These scripts are the main python scripts that run the workflows in O2-DQ.

  • Script used to run on data the skimming tasks (tableMaker.cxx) runTableMaker.py.
  • Script used to run on MC the skimming tasks (tableMakerMC.cxx) runTableMakerMC.py.
  • Analyze DQ skimmed data tables. This workflow runs a few tasks: event selection, barrel track selection, muon track selection etc. runTableReader.py.
  • Which contains the tasks DQEventSelection for event selection, DQBarrelTrackSelection for barrel track selection and single track MC matching, and the DQQuarkoniumPairing for reconstructed track pairing, MC matching of the pairs and counting of generated MC signals.
    runDQEfficiency.py.
  • Produces a decision table for pp collisions. The decisions require that at least a selected pair (or just two tracks) exists for a given event. Currently up to 64 simultaneous decisions can be made, to facilitate studies for optimizing cuts. runFilterPP.py.
  • Task to compute Q vectors and other quanitites related from the generic framework. Generic framework O2 version is a port of the AliPhysics version. To be used in the DQ analyses aiming for flow measurements. runDQFlow.py.
  • V0 Selector makes Loops over a V0Data table and produces some standard analysis output. runV0selector.py.
  • Task to select electrons from dalitz decay runV0selector.py.
  • It provides Download needed O2-DQ Libraries (CutsLibrary, MCSignalLibrary, MixingLibrary from O2Physics) for validation and autocompletion in Manual way. You can download libs with version as nightly or you can pull libs from your local alice-software. DownloadLibs.py.

Also We have PWG-EM Dilepton Tasks, prepared from @rbailhac

  • Analysis task for calculating single electron and dielectron efficiency, skimmed version. runEMEfficiency.py.
  • Analysis task for calculating single electron and dielectron efficiency, not skimmed version. runEMEfficiencyNotSkimmed.py.

Config Files

  • Contains workflow configuration files Configs

  • JSON workflow configuration files List in Table (DQ)

Main File Related Task on O2Physics Description W.S
configTableMakerDataRun2.json TableMaker.cxx run over Run-2 converted data runTableMaker.py
configTableMakerDataRun3.json TableMaker.cxx run over Run-3 data runTableMaker.py
configTableMakerMCRun2.json TableMakerMC.cxx run over Run-2 converted MC runTableMakerMC.py
configTableMakerMCRun3.json TableMakerMC.cxx run over Run-3 MC runTableMakerMC.py
configAnalysisData.json TableReader.cxx run with tableReader.cxx runTableReader.py
configAnalysisMC.json dqEfficiency.cxx run with dqEfficiency.cxx runDQEfficiency.py
configFilterPPDataRun3.json filterPP.cxx run with filterPP.cxx on data run 3 runFilterPP.py
configFilterPPDataRun2.json filterPP.cxx run with filterPP.cxx on data run 2 runFilterPP.py
configFlowDataRun2.json dqFlow.cxx run with dqFlow.cxx on data run 2 runDQFlow.py
configFlowDataRun3.json dqFlow.cxx run with dqFlow.cxx on data run 3 runDQFlow.py
configV0SelectorDataRun2.json v0selector.cxx run with v0selector.cxx on data run 2 runV0selector.py
configV0SelectorDataRun3.json v0selector.cxx run with v0selector.cxx on data run 3 runV0selector.py
configV0SelectorDataRun2.json DalitzSelection.cxx run with DalitzSelection.cxx.cxx on data run 2 runDalitzSelection.py
configV0SelectorDataRun3.json DalitzSelection.cxx run with DalitzSelection.cxx.cxx on data run 3 runDalitzSelection.py
  • JSON workflow configuration files List in Table (PWG-EM Dilepton)
Main File Related Task on O2Physics Description W.S
configAnalysisMCEM.json emEfficiencyEE.cxx run with emEfficiencyEE.cxx on MC run 3 (skimmed) runEMEfficiency.py
configAnalysisMCEMNoSkimmed.json emEfficiencyEE.cxx run with emEfficiencyEE.cxx on MC run 3 (not skimmed) runEMEfficiencyNotSkimmed.py

W.S : Workflow Script

  • JSON Reader Configuations for the Common DQ skimmed tables:
Main File Data Model Description
readerConfiguration_reducedEvent.json DQ Skimmed Data Model For Data
readerConfiguration_reducedEventMC.json DQ Skimmed Data Model For MC
  • JSON Reader Configuations for the DQ skimmed tables with extra dilepton tables:
Main File Data Model Description
readerConfiguration_dileptons DQ Skimmed Data Model With Extra Dilepton Tables For Data
readerConfiguration_dileptonMC DQ Skimmed Data Model With Extra Dilepton Tables For MC
  • JSON Writer Configuations for produce extra dilepton tables in DQ skimmed tables:
Main File Data Model Description
writerConfiguration_dileptons.json DQ Skimmed Data Model For Data
writerConfiguration_dileptonMC.json DQ Skimmed Data Model For MC

DQ Interface Scripts

These scripts are interface scripts with arguments provided by parser_args to configure DQ tasks analysis side.

  • Contains DQ and EM Interface Scripts dqtasks

  • DQ Interface Script List:

Interface Script Workflow Script
tableMaker.py runTableMaker.py
tableMakerMC.py runTablemakerMC.py
tableReader.py runTableReader.py
dqEfficiency.py runDQEfficiency.py
filterPP.py filterPP.py
dqFlow.py runDQFlow.py
v0selector.py runV0selector.py
dalitzSelection.py runDalitzSelection.py
  • EM Interface Script List:
Interface Script Workflow Script
runEMEfficiency.py emEfficiency.py
runEMEfficiencyNotSkimmed.py emEfficiencyNoSkimmed.py
  • Important P.S!!! In order to avoid conflicts in the tableMaker Interface, the arguments in the filterPP, dqFlow and dalitzSelection interfaces have been reduced and moved to the tableMaker interface. That is, although filterPP, dqFlow and dalitzSelection interfaces have their own interfaces, the tableMaker interface has both its own interface and the reduced interfaces of these 2 scripts (tableMaker + reduced dqFlow + reduced filterPP + reduced dalitzSelection). It should be considered when configuring the interface for tableMaker, and the original interfaces of dqFlow and filterPP should never be connected to this interface, their reduced versions in tableMaker should be used.

Common Deps Interface Scripts

These scripts are interface scripts with arguments provided by parser_args to configure DQ tasks common side.

Interface Script Used in
centralityTable.py runTablemakerMC.py
runTableMaker.py
runV0selector.py
runDQFlow.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
dplAodReader.py runTablemakerMC.py
runTableMaker.py
runV0selector.py
runDQFlow.py
tableReader.py
dqEfficiency.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
eventSelection.py runTablemakerMC.py
runTableMaker.py
filterPP.py
runDQFlow.py
runV0selector.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
multiplicityTable.py runTablemakerMC.py
runTableMaker.py
filterPP.py
runDQFlow.py
runV0selector.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
pidTOFBase.py runTablemakerMC.py
runTableMaker.py
filterPP.py
runDQFlow.py
runV0selector.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
pidTOFBeta.py runTablemakerMC.py
runTableMaker.py
filterPP.py
runDQFlow.py
runV0selector.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
pidTPCTOFFull.py runTablemakerMC.py
runTableMaker.py
filterPP.py
runDQFlow.py
runV0selector.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
trackPropagation.py runTablemakerMC.py
runTableMaker.py
filterPP.py
runDQFlow.py
runV0selector.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py
trackselection.py runTablemakerMC.py
runTableMaker.py
filterPP.py
runDQFlow.py
runV0selector.py
emEfficiencyNoSkimmed.py
runDalitzSelection.py

Extra Modules

Extra modules include some external scripts not related to O2, which are prepared as an support for configuring the workflow and interface

Extra Script Desc
ChoicesHandler.py Contains some classes for printing sub helper messages to the screen and autocompletion class for which argument can multiple configurable
configSetter.py Contains methods that manage JSON configurations via interfaces and helper setter methods (developer package)
converters.py Contains Interface arguments for O2 converters (ex. o2-analysis-trackpropagation)
dqExceptions.py Contains some customized exceptions for transaction managements
dqLibGetter.py To automatically download python libraries in run scripts
dqTranscations.py To manage dependencies and misconfigurations in the DQ workflow
helperOptions.py Includes Interface arguments for debug and interface mode options
pycacheRemover.py For automatically removing pycache files when workflow is finished
stringOperations.py For managing string operations of multiple arguments in workflows

↑ Go to the Table of Content ↑ | Continue to Prerequisites →