Produce a run list from the Temporary RCT (Google spreadsheets)

• The configuration file
  • sheet_name: the name of the google spreadsheets, e.g., QC_summary_data_2023_pbpb for 2023 Pb-Pb.
  • tab_name: the name of the tab that you want to take.
  • periods: add which period(s) you want to include in the runlist; if empty, takes all periods in the tab.
  • runlists name: the dumped file name. detectors: add the requested detectors and the flags.
  • pass_shift: select which apass to be checked. For example, "1" refers to the first apass for a detector.
  • pass_name: set the apass name which will be in the dumped file.
  • runlists -> name: indicating which run list it is, e.g., CBT, CBT_hadronPID
  • separate_22o_test: set whether to separate LHC22o_test. Default is "False"
• Make sure you have the certificate runlist-5dfcf12a816d.json under the same folder where you run the script. Contact Jian Liu (jian.liu@cern.ch) for the certificate.
• python3 runlist.py config_pp.json
• Take config_pp_2022.json as the reference configuration file for 2022 periods, config_pp.json or config_pbpb.json for 2023 periods

Export runs from RCT (in Bookkeeping)

• The configuration file:
  • "token": add your token to access Bookkeeping
  • "dataPassNames": asynchronous pass name(s), e.g., ["LHC24af_cpass0", "LHC24ag_cpass0"]
• Example file: config_rct.json
• python3 rct.py config_rct.json
• Separate .csv files are saved for each period if you have more than one period in the configuration file

Produce run lists from RCT

• Produce the .csv files mentioned in Export runs from RCT (in Bookkeeping)
• Example configuration file: rct_runlist.json. Modify it according to your needs
• python3 rct_runlist.py rct_runlist.json -d csv_file_path. The -d can be omitted if the .csv files are already in the current directory

Calculate and upload mu/INEL rate to RCT

The scritps needed and the example configuration files can be found under INEL_Mu.

• python3 inel_mu_calculation.py mu_inel.json
• python3 uploading.py upload.json

Flagging multi-runs in RCT

Currently, only run-based (covering the whole run duration) flags can be added with this script. Put your Bookkeeping token to the json configuration file. The flagTypeId can be found at QC flag types in Bookkeeping. --max_run, --min_run, --excluded_runs and --comment are optional. If omitted, all runs from the pass will be flagged. Add your BK token to the configuration json file.

• Example command for unique flag type and comment:

python3 rct_post_flag.py rct_post_flag.json --data_pass "LHC24a_cpass0" --detector "ITS" --flagTypeId 11 --max_run 106 --min_run 53 --excluded_runs 54

• Example command for multiple flags and comments in a .csv file:

python3 test_rct_post_flag.py test_rct_post_flag.json --data_pass "LHC24al_cpass0" --detector "ITS" -b ITS_flag.csv

The format of the file refers to the Example.csv.

Verifying multi-runs in RCT

Both the latest run-based and time-dependent flags for each run can be verified with this script. Put your Bookkeeping token to the json configuration file. The --comment, --max_run, --min_run and --excluded_runs are optional. If --max_run and --min_run are omitted, all runs from the pass will be verified. Add your BK token to the configuration json file. This script is not well tested. Suggest verifying the time-dependent flags by hand.

• Example command:

python3 rct_verify_flag.py rct_verify_flag.json --data_pass "LHC22a_apass1" --detector "FT0"  --max_run 106 --min_run 53 --excluded_runs 54 --comment "test"

How to generate a token in BK/RCT

• Login to the BK
• Open the Developer Tools and type sessionService.session.token to produce the token.