Warning, /analysis/INTT_MBD_evt_combiner/readme.md is written in an unsupported language. File is not indexed.
0001 # The offline event combiner for INTT and MBD for the sPHENIX run 23 data
0002 Updated: 2024-Mar-06
0003
0004 * The code reads the root trees of INTT and MBD generated by the F4A, does the synchronization check, merges the branches of the two trees, and outputs a root file with a merged tree and two histograms showing the synchronization status.
0005 * It is aimed to be an inclusive code, which means that you don't have to define the names and types of the branches explicitly.
0006 * Only the clock information related braches are needed.
0007 1. One in INTT tree, the branch "INTT_BCO", which keeps the bco_full information (40-bit GTM clock).
0008 2. One in MBD tree, the branch "mbdclk", which keeps the FEM clock information.
0009 * These two branches are used for the event synchronization. If you happened to use the event combiner with trees with different structures, you may want to make sure the names of the clock-info. branches consistent with the names mentioned above.
0010
0011 The python code requires at least 5 arguments
0012 1. <outfile_full_directory>
0013 2. <intt_file_full_directory>
0014 3. <intt_tree_name>
0015 4. <mbd_file_in_full_directory>
0016 5. <mbd_tree_name>
0017 6. <N_event>: this is optional, if it's not given, then all events of the file will be included
0018
0019 ## To run the code:
0020 ```bash
0021 python3 intt_mbd_evt_combiner_v1.py outfile_full_directory intt_file_full_directory intt_tree_name mbd_file_in_full_directory mbd_tree_name N_event
0022 ```
0023
0024
0025 * Histogram (intt_mbd_bco and intt_mbd_bco_1D) kept in the output root file can be checked once the process is done.
0026 * The plot "intt_mbd_bco" shows the clock difference as a function of event ID. If the synchronization is performed correctly, it is expected to be a horizental line across events. Like the example given in the folder.
