Skip to content

jpata/particleflow

Repository files navigation

Summary

ML-based particle flow (MLPF) focuses on developing full event reconstruction for particle detectors using computationally scalable and flexible machine learning models. The project aims to improve particle flow reconstruction across various detector environments, including CMS, as well as future detectors via Key4HEP. We build on existing, open-souce simulation software by the experimental collaborations.

High-level overview


Publications

Below is the development timeline of MLPF by our team, ranging from initial proofs of concept to full detector simulations and fine-tuning studies.

2021: First full-event GNN demonstration of MLPF

2021: First demonstration in CMS Run 3

2022: Improved performance in CMS Run 3

2024: Improved performance with CLIC full simulation

2025: Fine-tuning across detectors

2025/2026: CMS Run 3 full results


Datasets

Software & Dataset Compatibility

Please ensure you use the correct version of the jpata/particleflow software with the corresponding dataset version.

Code Version CMS Dataset CLIC Dataset CLD Dataset
1.9.0 2.4.0 2.2.0 NA
2.0.0 2.4.0 2.3.0 NA
2.1.0 2.5.0 2.5.0 NA
2.2.0 2.5.0 2.5.0 2.5.0
2.3.0 2.5.0 2.5.0 2.5.0
2.4.0 2.6.0 2.5.0 2.5.0

Instructions: Citations and Reuse

You are welcome to reuse the code in accordance with the LICENSE.

How to Cite

  1. Academic Work: Please cite the specific papers listed in the Publications section above relevant to the method you are using (e.g., initial GNN idea, fine-tuning, or specific detector studies).
  2. Code Usage: If you use the code significantly for research, please cite the specific tagged version from Zenodo.
  3. Dataset Usage: Cite the appropriate dataset via the Zenodo link and the corresponding paper.

Contact

For collaboration ideas that do not fit into the categories above, please get in touch via GitHub Discussions.

About

Machine-learned, GPU-accelerated particle flow reconstruction

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 11