User Python Based Interface

Table of Contents

• Contact
• Important
• Big Update!!!
• Table Of Contents
• TODO LIST

This project includes python based user interface development for PWG-DQ Workflows based on nightly-20220915. You can follow the instructions and you can find tutorials in table of contents (For prerequisites, Installation guide for argcomplete and Some Informations good to know).

Contact

Ionut Cristian Arsene (Owner of O2DQWorkflows)

Cevat Batuhan Tolon (Author Of Interface)

Important

Since the interface is constantly updated for stability, it is recommended to update it with git pull --rebase command

Big Update!!!

Now converter tasks are added automatically according to the content of the data. Arguments like –add_track_prop are no longer needed. Accordingly, the tutorials have been updated and the details will be added over time.

Table Of Contents

• Python Scripts And JSON Configs
  • Main Python Scripts
  • Config Files
  • DQ Interface Scripts
  • Common Deps Interface Scripts
  • Extra Modules
• Prerequisites!!!
  • Cloning repository
  • argcomplete - Bash tab completion for argparse
  • Instalation Guide For argcomplete
    • Prerequisites Before Installation argcomplete Package For Linux Based Systems and LXPLUS
    • Local Instalation (Not Need For O2)
    • O2 Installation
    • Prerequisites Before Installation argcomplete Package For MacOS Based Systems
    • Local Instalation (Not Need For O2)
    • O2 Installation
• Instructions for TAB Autocomplete
• Technical Informations
  • Helper Command Functionality
    • One Minimal Bug on Error Message
  • Debug and Logging Options for O2DQWorkflows and DownloadLibs.py
  • Features for runTableMaker
    • Automated Things In runTableMaker
    • Logger Things In runTableMaker
  • Features for runTableReader
    • Automated Things In runTableReader
  • Features for runDQEfficiency
    • Automated Things In runDQEfficiency
  • Some Things You Should Be Careful For Using and Development
  • Some Notes Before The Instructions
  • Interface Modes: JSON Overrider and JSON Additional
• Instructions for Python Scripts
  • Download CutsLibrary, MCSignalLibrary, MixingLibrary From Github
  • Get CutsLibrary, MCSignalLibrary, MixingLibrary From Local Machine
  • Available configs in DownloadLibs.py Interface
• Instructions for runTableMaker/runTableMakerMC.py
  • Available configs in runTableMaker Interface
• Instructions for runTableReader.py
  • Available configs in runTableReader Interface
• Instructions for runDQEfficiency.py
  • Available configs in runDQEfficiency Interface
• Instructions for runFilterPP.py
  • Available configs in runFilterPP Interface
• Instructions for runDQFlow.py
  • Available configs in runDQFlow Interface
• Tutorial Part
  • Download Datas For Tutorials
    • Workflows In Tutorials
    • Skimmed Datas In Tutorials
    • Pre-Made JSON configuration Files In Tutorials
  • MC Part
    • Run tableMakerMC on LHC21i3d2 (jpsi to MuMu pp Run3Simulation)
    • Run dqEfficiency on MC (LHC21i3d2 pp Run3Simulation)
    • Run tablemakerMC on LHC21i3b (Prompt jpsi to dielectron pp Run3Simulation)
    • Run dqEfficiency on MC (LHC21i3b pp Run3Simulation)
    • Run tablemakerMC on LHC21i3f2 (Non-Prompt jpsi to dielectron pp Run3Simulation)
    • Run dqEfficiency on LHC21i3f2 (LHC21i3f2 pp Run3Simulation)
  • Data Part
    • Run tableMaker on LHC15o (LHC15o PbPb Run2Data)
    • Run tableReader on LHC15o (LHC15o PbPb Run2Data)
    • Run tableMaker on LHC15o With Generic Flow Analysis (LHC15o PbPb Run2Data)
    • Run tableReader on LHC15o with Generic Flow Analysis (LHC15o PbPb Run2Data)
    • Run dqFlow on LHC15o (LHC15o PbPb Run2Data)
    • Run v0Selector on LHC15o (LHC15o PbPb Run2Data)
    • Run tableMaker on LHC22c (LHC22c pp Run3Data)
    • Run tableReader on Data (LHC22c pp Run3Data)
    • Run filterPP on fwdprompt(fwdprompt pp Run3Data)
  • Special Part : Dilepton Analysis For Non-Standart Existing Workflows in DQ
    • MC : Dilepton Track Analysis (On Bc Simulation)
    • Data : Dilepton Hadron Analysis (On PbPb Data LHC15o)
• Design Notes
  • TODO List For Python Workflows
  • Feedbacks, Suggestions and User Acceptance Test List
  • Updates
  • Naming Conventions
• 8_TroubleshootingTreeNotFound
  • Converters
  • add_track_prop

TODO LIST

• Add Contributing guide chapter
• Maintaince need for available configs part
• Python Scripts And JSON Configs need update
• Need more details for arguments for user guide
• Needed to explain O2-DQ Data Model and Workflow
• Doxygen doc should be updated
• More tutorials needed for users
• On tutorial side, we need explain all arguments one by one
• TableReader and dqEfficiency should be refactored
• interface logic part needs refactor
• github downloader util should be integrated
• Clean the code