{"about":{"site":"https://codewithpapers.app","non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page"},"url":"/paper/explaining-machine-learned-particle-flow","title":"Explaining machine-learned particle-flow reconstruction","arxiv_id":"2111.12840","date":"2021-11-24","proceeding":null,"authors":["Farouk Mokhtar","Raghav Kansal","Daniel Diaz","Javier Duarte","Joosep Pata","Maurizio Pierini","Jean-Roch Vlimant"],"abstract":"The particle-flow (PF) algorithm is used in general-purpose particle detectors to reconstruct a comprehensive particle-level view of the collision by combining information from different subdetectors. A graph neural network (GNN) model, known as the machine-learned particle-flow (MLPF) algorithm, has been developed to substitute the rule-based PF algorithm. However, understanding the model's decision making is not straightforward, especially given the complexity of the set-to-set prediction task, dynamic graph building, and message-passing steps. In this paper, we adapt the layerwise-relevance propagation technique for GNNs and apply it to the MLPF algorithm to gauge the relevant nodes and features for its predictions. Through this process, we gain insight into the model's decision-making.","url_abs":"https://arxiv.org/abs/2111.12840v1","url_pdf":"https://arxiv.org/pdf/2111.12840v1.pdf","source":{"archive":"pwc-archive (Hugging Face), CC BY-SA 4.0","snapshot":"2025-07-28","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","row_kind":"abstracts"},"code_links":[{"paper_slug":"explaining-machine-learned-particle-flow","repo_url":"https://github.com/faroukmokhtar/particleflow","is_official":1,"mentioned_in_paper":1,"mentioned_in_github":0,"framework":"tf","reach":{"status":"ok","spdx":"Apache-2.0"}},{"paper_slug":"explaining-machine-learned-particle-flow","repo_url":"https://github.com/farakiko/xai4hep","is_official":0,"mentioned_in_paper":0,"mentioned_in_github":1,"framework":"pytorch","reach":{"status":"ok","spdx":"MIT"}}],"tasks":[{"task_slug":"decision-making","task_name":"Decision Making"},{"task_slug":"graph-neural-network","task_name":"Graph Neural Network"}],"methods":[{"method_slug":"graph-neural-network","method_name":"Graph Neural Network"}],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2111.12840","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2111.12840"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-24T18:15:14+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/faroukmokhtar/particleflow","reach":{"status":"ok","spdx":"Apache-2.0"}},{"provenance":"external:paperswithcode_snapshot_2025-07-28","url":"https://github.com/farakiko/xai4hep","reach":{"status":"ok","spdx":"MIT"}}],"summary":{"unverified":18},"by_repo_kind":{"official":{"samples":18,"ran":0,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":0,"samples":[{"code_sha256_prefix":"e64cf35ab8bff4bb","entry":"classification_loss","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/losses.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/losses.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"e64cf35ab8bff4bb"}},{"code_sha256_prefix":"2b270dba64c8bbb1","entry":"customize_pipeline_test","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/customizations.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/customizations.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"2b270dba64c8bbb1"}},{"code_sha256_prefix":"c01f983334e0f6b8","entry":"dataset_input_type_id","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/conf.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/conf.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"c01f983334e0f6b8"}},{"code_sha256_prefix":"d8a81f0febeff149","entry":"dataset_source_id","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/conf.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/conf.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"d8a81f0febeff149"}},{"code_sha256_prefix":"72d34ad7b15b8a79","entry":"deltaphi","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/jet_utils.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/jet_utils.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"72d34ad7b15b8a79"}},{"code_sha256_prefix":"48d587451f46aabd","entry":"deltar","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/jet_utils.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/jet_utils.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"48d587451f46aabd"}},{"code_sha256_prefix":"9c993588b9c2e6fc","entry":"get_regions","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/heptv2.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/heptv2.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"9c993588b9c2e6fc"}},{"code_sha256_prefix":"ded74e6af3ddb339","entry":"invert_permutation","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/heptv2.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/heptv2.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"ded74e6af3ddb339"}},{"code_sha256_prefix":"a99434c75350faa3","entry":"lsh_mapping","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/hept.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/hept.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"a99434c75350faa3"}},{"code_sha256_prefix":"45ca4d36fd5a0792","entry":"match_jets","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/jet_utils.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/jet_utils.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"45ca4d36fd5a0792"}},{"code_sha256_prefix":"c22d7ce353754a1e","entry":"pairwise_l2_dist","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/gnnlsh.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/gnnlsh.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"c22d7ce353754a1e"}},{"code_sha256_prefix":"a3aa89db788edd6f","entry":"point_wise_feed_forward_network","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/gnnlsh.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/gnnlsh.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"a3aa89db788edd6f"}},{"code_sha256_prefix":"574204301da463f9","entry":"quantile_partition","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/heptv2.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/heptv2.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"574204301da463f9"}},{"code_sha256_prefix":"5c5bebafe8dccc63","entry":"regression_loss","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/losses.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/losses.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"5c5bebafe8dccc63"}},{"code_sha256_prefix":"cfb51c77ac54ffd0","entry":"sliced_wasserstein_loss","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/losses.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/losses.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"cfb51c77ac54ffd0"}},{"code_sha256_prefix":"b146c0426554f03c","entry":"split_indices_to_bins_batch","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/gnnlsh.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/gnnlsh.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"b146c0426554f03c"}},{"code_sha256_prefix":"e932b7d3ef0f378b","entry":"trunc_normal_","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/hept.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/hept.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"e932b7d3ef0f378b"}},{"code_sha256_prefix":"1d809fe0159efa28","entry":"uniform","repo":"faroukmokhtar/particleflow","repo_kind":"official","path":"mlpf/model/hept.py","file_url":"https://github.com/faroukmokhtar/particleflow/blob/HEAD/mlpf/model/hept.py","link_basis":"harvester_set","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"Apache-2.0","inline_ok":true,"mcp_get_code":{"code_sha256":"1d809fe0159efa28"}}]},"arxiv_metadata":null,"syntology_extracted_results":null}