gSeaGen code by KM3NeT: An efficient tool to propagate muons simulated with CORSIKA

S. Aiello, A. Albert, A. R. Alhebsi, M. Alshamsi, S. Alves Garre, A. Ambrosone, F. Ameli, M. Andre, L. Aphecetche, M. Ardid, S. Ardid, H. Atmani, J. Aublin, F. Badaracco, L. Bailly-Salins, Z. Bardačová, B. Baret, A. Bariego-Quintana, Y. Becherini, M. BendahmanF. Benfenati, M. Benhassi, M. Bennani, D. M. Benoit, E. Berbee, V. Bertin, S. Biagi, M. Boettcher, D. Bonanno, A. B. Bouasla, J. Boumaaza, M. Bouta, M. Bouwhuis, C. Bozza, R. M. Bozza, H. Brânzaş, F. Bretaudeau, M. Breuhaus, R. Bruijn, J. Brunner, R. Bruno, E. Buis, R. Buompane, J. Busto, B. Caiffi, D. Calvo, A. Capone, F. Carenini, V. Carretero, T. Cartraud, P. Castaldi, V. Cecchini, S. Celli, L. Cerisy, M. Chabab, A. Chen, S. Cherubini, T. Chiarusi, M. Circella, R. Cocimano, J. A.B. Coelho, A. Coleiro, A. Condorelli, R. Coniglione, P. Coyle, A. Creusot, G. Cuttone, R. Dallier, A. De Benedittis, B. De Martino, G. De Wasseige, V. Decoene, I. Del Rosso, L. S. Di Mauro, I. Di Palma, A. F. Díaz, D. Diego-Tortosa, C. Distefano, A. Domi, C. Donzaud, D. Dornic, E. Drakopoulou, D. Drouhin, J. G. Ducoin, R. Dvornický, T. Eberl, E. Eckerová, A. Eddymaoui, T. van Eeden, M. Eff, D. van Eijk, I. El Bojaddaini, S. El Hedri, V. Ellajosyula, A. Enzenhöfer, G. Ferrara, M. D. Filipović, F. Filippini, D. Franciotti, L. A. Fusco, S. Gagliardini, T. Gal, J. García Méndez, A. Garcia Soto, C. Gatius Oliver, N. Geißelbrecht, E. Genton, H. Ghaddari, L. Gialanella, B. K. Gibson, E. Giorgio, I. Goos, P. Goswami, S. R. Gozzini, R. Gracia, C. Guidi, B. Guillon, M. Gutiérrez, C. Haack, H. van Haren, A. Heijboer, L. Hennig, J. J. Hernández-Rey, W. Idrissi Ibnsalih, G. Illuminati, D. Joly, M. de Jong, P. de Jong, B. J. Jung, P. Kalaczyński, G. Kistauri, C. Kopper, A. Kouchner, Y. Y. Kovalev, V. Kueviakoe, V. Kulikovskiy, R. Kvatadze, M. Labalme, R. Lahmann, M. Lamoureux, G. Larosa, C. Lastoria, A. Lazo, S. Le Stum, G. Lehaut, V. Lemaître, E. Leonora, N. Lessing, G. Levi, M. Lindsey Clark, F. Longhitano, F. Magnani, J. Majumdar, L. Malerba, F. Mamedov, J. Mańczak, A. Manfreda, M. Marconi, A. Margiotta, A. Marinelli, C. Markou, L. Martin, M. Mastrodicasa, S. Mastroianni, J. Mauro, G. Miele, P. Migliozzi, E. Migneco, M. L. Mitsou, C. M. Mollo, L. Morales-Gallegos, A. Moussa, I. Mozun Mateo, R. Muller, M. R. Musone, M. Musumeci, S. Navas, A. Nayerhoda, C. A. Nicolau, B. Nkosi, B. Ó Fearraigh, V. Oliviero, A. Orlando, E. Oukacha, D. Paesani, J. Palacios González, G. Papalashvili, V. Parisi, E. J. Pastor Gomez, C. Pastore, A. M. Păun, G. E. Păvălaş, S. Peña Martínez, M. Perrin-Terrin, V. Pestel, R. Pestes, P. Piattelli, A. Plavin, C. Poirè, V. Popa, T. Pradier, J. Prado, S. Pulvirenti, C. A. Quiroz-Rangel, N. Randazzo, S. Razzaque, I. C. Rea, D. Real, G. Riccobene, J. Robinson, A. Romanov, E. Ros, A. Šaina, F. Salesa Greus, D. F.E. Samtleben, A. Sánchez Losa, S. Sanfilippo, M. Sanguineti, D. Santonocito, P. Sapienza, J. Schnabel, J. Schumann, H. M. Schutte, J. Seneca, I. Sgura, R. Shanidze, A. Sharma, Y. Shitov, F. Šimkovic, A. Simonelli, A. Sinopoulou, B. Spisso, M. Spurio, D. Stavropoulos, I. Štekl, S. M. Stellacci, M. Taiuti, Y. Tayalati, H. Thiersen, S. Thoudam, I. Tosta e Melo, B. Trocmé, V. Tsourapis, A. Tudorache, E. Tzamariudaki, A. Ukleja, A. Vacheret, V. Valsecchi, V. Van Elewyck, G. Vannoye, G. Vasileiadis, F. Vazquez de Sola, A. Veutro, S. Viola, D. Vivolo, A. van Vliet, E. de Wolf, I. Lhenry-Yvon, S. Zavatarelli, A. Zegarelli, D. Zito, J. D. Zornoza, J. Zúñiga, N. Zywucka

Research output: Contribution to journalArticlepeer-review

Abstract

The KM3NeT Collaboration has tackled a common challenge faced by the astroparticle physics community, namely adapting the experiment-specific simulation software to work with the CORSIKA air shower simulation output. The proposed solution is an extension of the open source code gSeaGen, which allows the transport of muons generated by CORSIKA to a detector of any size at an arbitrary depth. The gSeaGen code was not only extended in terms of functionality but also underwent a thorough redesign of the muon propagation routine, resulting in a more accurate and efficient simulation. This paper presents the capabilities of the new gSeaGen code as well as prospects for further developments. Program summary: Program title: gSeaGen CPC Library link to program files: https://doi.org/10.17632/ymgxvy2br4.2 Developer's respository link: git.km3net.de/opensource/gseagen Licensing provisions: BSD 3-Clause Programming language: C++ Nature of problem: Integration of the state-of-the-art extensive air shower Monte Carlo event generator CORSIKA [1] into the atmospheric muon simulation for water Cherenkov neutrino telescopes. The primary use case considered is the KM3NeT experiment [2], however, the code should be able to cover other similar experiments as well. The challenges in this work included interfacing the CORSIKA binary output, efficient handling of already generated events to reduce the overall computational cost, and preserving all the additional available information, which can be invaluable in physics analyses. Solution method: The readout of CORSIKA simulation was adapted from the base script provided together with CORSIKA and implemented as a standalone flux driver in gSeaGen. The propagation routine has been redesigned to support the geometry of extensive air shower simulations and to improve its efficiency in propagating particles to the detector. To ensure a reliable modelling of muon energy loss and scattering, PROPOSAL [3] was set as the default internal code for muon transport. PROPOSAL is an open-source software developed and maintained by the IceCube collaboration [4] and is a well-established solution used by the neutrino physics community. Additional comments including restrictions and unusual features: The code was tested with GENIE [5] version 3.4.0 and PROPOSAL 6.1.5. Currently, linking of gSeaGen to GENIE is mandatory, even in the case of a muon-only simulation using CORSIKA. References: [1] D. Heck et al., FZKA-6019 (1998). [2] S. Adrián-Martínez et al., J. Phys. G, Nucl. Part. Phys. 43 (2016) 084001. [3] J.H. Koehne et al., Comput. Phys. Commun. 184 (2013) 2070. [4] M.G. Aartsen et al., J. Instrum. 12 (2017) P03012. [5] C. Andreopoulos et al., Nucl. Instrum. Methods A 614 (2010) 87.

Original languageEnglish
Article number109660
JournalComputer Physics Communications
Volume314
DOIs
Publication statusPublished - Sept 2025

Keywords

  • Astroparticle physics
  • Atmospheric muons
  • CORSIKA
  • Extensive air showers
  • KM3NeT
  • Neutrino telescope

ASJC Scopus subject areas

  • Hardware and Architecture
  • General Physics and Astronomy

Fingerprint

Dive into the research topics of 'gSeaGen code by KM3NeT: An efficient tool to propagate muons simulated with CORSIKA'. Together they form a unique fingerprint.

Cite this