RetinaClusters decoding

MR to add Retina clusters decoding in Allen, following the work done in !381 (closed).
It also makes the Retina cluster decoding part of the default reconstruction sequence.

Official MC samples

Starting from Boole release v43r0, officially produced MC files contain VELO Retina clusters together with VELO SuperPixels.
Those MC files can be found in the Dirac bookkeeping, selecting Request IDs grater than 90182.

Private MC samples

To test this MR the following files are also available under /eos/lhcb/user/g/gbassi/AllenClusterDecoding.

From MiniBrunel_2018_MinBias_FTv4_DIGI

• MiniBrunel_2018_MinBias_FTv4_DIGI_digi, first digi file in MiniBrunel_2018_MinBias_FTv4_DIGI TestFileDB entry
• MiniBrunel_2018_MinBias_FTv4_DIGI_retinacluster_digi, digi file obtained adding VPRetinaCluster RawBanks to MiniBrunel_2018_MinBias_FTv4_DIGI_digi
• MiniBrunel_2018_MinBias_FTv4_DIGI_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on MiniBrunel_2018_MinBias_FTv4_DIGI_digi
• MiniBrunel_2018_MinBias_FTv4_DIGI_retinacluster_mdf, mdf files obtained running mdf_for_standalone_Allen.py on MiniBrunel_2018_MinBias_FTv4_DIGI_retinacluster_digi

From SMOG2_pppHe

• SMOGHepp8MB_digi, digi files in SMOG2_pppHe MC production
• SMOGHepp8MB_retinacluster_digi, digi file obtained adding VPRetinaCluster RawBanks to SMOGHepp8MB_digi
• SMOGHepp8MB_mdf, mdf file obtained running mdf_for_standalone_Allen.py on SMOGHepp8MB_digi
• SMOGHepp8MB_retinacluster_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on SMOGHepp8MB_retinacluster_digi

From SMOG2_pHe

• SMOG2_pHe_digi, digi files in SMOG2_pHe MC production
• SMOG2_pHe_retinacluster_digi, digi file obtained adding VPRetinaCluster RawBanks to SMOG2_pHe_digi
• SMOG2_pHe_mdf, mdf file obtained running mdf_for_standalone_Allen.py on SMOG2_pHe_digi
• SMOG2_pHe_retinacluster_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on SMOG2_pHe_retinacluster_digi

From Upgrade_BsPhiPhi_MD_FTv4_DIGI

• Upgrade_BsPhiPhi_MD_FTv4_DIGI_digi, first 10 digi files in Upgrade_BsPhiPhi_MD_FTv4_DIGI TestFileDB entry
• Upgrade_BsPhiPhi_MD_FTv4_DIGI_retinacluster_digi, digi file obtained adding VPRetinaCluster RawBanks to Upgrade_BsPhiPhi_MD_FTv4_DIGI_digi
• Upgrade_BsPhiPhi_MD_FTv4_DIGI_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on Upgrade_BsPhiPhi_MD_FTv4_DIGI_digi
• Upgrade_BsPhiPhi_MD_FTv4_DIGI_retinacluster_mdf, mdf files obtained running mdf_for_standalone_Allen.py on Upgrade_BsPhiPhi_MD_FTv4_DIGI_retinacluster_digi

From upgrade_DC19_01_Bs2PhiPhiMD

• upgrade_DC19_01_Bs2PhiPhiMD_xdigi, first 8 xdigi files in upgrade_DC19_01_Bs2PhiPhiMD TestFileDB entry
• upgrade_DC19_01_Bs2PhiPhiMD_retinacluster_xdigi, xdigi files obtained adding VPRetinaCluster RawBanks to upgrade_DC19_01_Bs2PhiPhiMD_xdigi
• upgrade_DC19_01_Bs2PhiPhiMD_mdf, mdf files obtained running mdf_for_standalone_Allen.py on upgrade_DC19_01_Bs2PhiPhiMD_xdigi
• upgrade_DC19_01_Bs2PhiPhiMD_retinacluster_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on upgrade_DC19_01_Bs2PhiPhiMD_retinacluster_xdigi

From upgrade_DC19_01_MinBiasMD

• upgrade_DC19_01_MinBiasMD_xdigi, first 8 xdigi files in upgrade_DC19_01_MinBiasMD TestFileDB entry
• upgrade_DC19_01_MinBiasMD_retinacluster_xdigi, xdigi file obtained adding VPRetinaCluster RawBanks to upgrade_DC19_01_MinBiasMD_xdigi
• upgrade_DC19_01_MinBiasMD_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on upgrade_DC19_01_MinBiasMD_xdigi
• upgrade_DC19_01_MinBiasMD_retinacluster_mdf, mdf files obtained running mdf_for_standalone_Allen.py on upgrade_DC19_01_MinBiasMD_retinacluster_xdigi

From upgrade_DC19_01_MinBiasMU

• upgrade_DC19_01_MinBiasMU_xdigi, first 8 xdigi files in upgrade_DC19_01_MinBiasMU TestFileDB entry
• upgrade_DC19_01_MinBiasMU_retinacluster_xdigi, xdigi files obtained adding VPRetinaCluster RawBanks to upgrade_DC19_01_MinBiasMU_xdigi
• upgrade_DC19_01_MinBiasMU_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on upgrade_DC19_01_MinBiasMU_xdigi
• upgrade_DC19_01_MinBiasMU_retinacluster_mdf, mdf files obtained running mdf_for_standalone_Allen.py on upgrade_DC19_01_MinBiasMU_xdigi

From Upgrade_KstEE_MU_FTv4_DIGI

• Upgrade_KstEE_MU_FTv4_DIGI_digi, first 10 digi files in Upgrade_KstEE_MU_FTv4_DIGI TestFileDB entry
• Upgrade_KstEE_MU_FTv4_DIGI_retinacluster_digi, digi files obtained adding VPRetinaCluster RawBanks to Upgrade_KstEE_MU_FTv4_DIGI_digi
• Upgrade_KstEE_MU_FTv4_DIGI_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on Upgrade_KstEE_MU_FTv4_DIGI_digi
• Upgrade_KstEE_MU_FTv4_DIGI_retinacluster_mdf, mdf files obtained running mdf_for_standalone_Allen.py on Upgrade_KstEE_MU_FTv4_DIGI_retinacluster_digi

From upgrade-magdown-sim10-up08-30000000

• upgrade-magdown-sim10-up08-30000000-xdigi, first 5 xdigi files in upgrade-magdown-sim10-up08-30000000 TestFileDB entry
• upgrade-magdown-sim10-up08-30000000_retinacluster-xdigi, xdigi files obtained adding VPRetinaCluster RawBanks to upgrade-magdown-sim10-up08-30000000-xdigi
• upgrade-magdown-sim10-up08-30000000-mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on upgrade-magdown-sim10-up08-30000000-xdigi
• upgrade-magdown-sim10-up08-30000000_retinacluster-mdf, mdf files obtained running mdf_for_standalone_Allen.py on upgrade-magdown-sim10-up08-30000000_retinacluster-xdigi

From upgrade-minbias-magdown-scifi-v5

• upgrade-minbias-magdown-scifi-v5_digi, first 6 digi files in upgrade-minbias-magdown-scifi-v5 TestFileDB entry
• upgrade-minbias-magdown-scifi-v5_retinacluster_digi, digi files obtained adding VPRetinaCluster RawBanks to upgrade-minbias-magdown-scifi-v5_digi
• upgrade-minbias-magdown-scifi-v5_mdf, mdf/geometry files obtained running mdf_for_standalone_Allen.py on upgrade-minbias-magdown-scifi-v5_digi
• upgrade-minbias-magdown-scifi-v5_retinacluster_mdf, mdf files obtained running mdf_for_standalone_Allen.py on upgrade-minbias-magdown-scifi-v5_retinacluster_digi

How to add RetinaClusters to existing .digi files

To add RetinaClusters to a .digi/.xdigi file one can run the following command within Moore
./Moore/run gaudirun.py runLLAApp.py LLASequence.py,
where runLLAApp.py and LLASequence.py option files are available under Hlt/RecoConf/options/ within the add_veloclusters_to_digi Moore branch.

Dependencies

This MR depends on Moore!1145 (merged), LHCb!3310 (merged), MooreAnalysis!72 (merged), lhcb-datapkg/PRConfig!211 (merged), lhcb-datapkg/RawEventFormat!1 (merged) and should be tested together with those.

Issue

See issue #286 (closed) for discussion on clusters with same LHCb ID.

FYI: @dovombru @dcampora @lpica