From e41cad093f5d0a001d1591aae20c5afc3aa2dd82 Mon Sep 17 00:00:00 2001
From: Felix Riehn <felix@matilda>
Date: Sat, 16 Apr 2022 08:40:24 +0100
Subject: [PATCH] comments

---
 .../modules/proposal/HadronicPhotonModel.hpp  |  3 ++-
 corsika/modules/proposal/InteractionModel.hpp | 23 ++++++++++++++++---
 2 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/corsika/modules/proposal/HadronicPhotonModel.hpp b/corsika/modules/proposal/HadronicPhotonModel.hpp
index befc2bd1b..b8e8a4156 100644
--- a/corsika/modules/proposal/HadronicPhotonModel.hpp
+++ b/corsika/modules/proposal/HadronicPhotonModel.hpp
@@ -18,7 +18,8 @@ namespace corsika::proposal {
   //! and virtual photons. At high energies an external model
   //! is needed that implements the doInteraction(TSecondaries& view, Code const
   //! projectile, Code const target,FourMomentum const& projectileP4, FourMomentum const&
-  //! targetP4) routine. Low energy interactions are currently not implemented.
+  //! targetP4) routine. Low energy interactions are currently not implemented. The
+  //! threshold between LE and HE interactions is defined in lab energy.
   //! @tparam THadronicModel
 
   template <class THadronicModel>
diff --git a/corsika/modules/proposal/InteractionModel.hpp b/corsika/modules/proposal/InteractionModel.hpp
index 135f685d1..6e41f9752 100644
--- a/corsika/modules/proposal/InteractionModel.hpp
+++ b/corsika/modules/proposal/InteractionModel.hpp
@@ -27,9 +27,9 @@ namespace corsika::proposal {
   //! reused by setting the \param PROPOSAL::InterpolationDef::path_to_tables variable.
   //! Hadroninc interactions of photons with nuclei are included. The cross section is
   //! calculated by PROPOSAL. For the production of hadronic secondaries an external model
-  //! is needed that implements the doInteraction(TSecondaries& view, Code const
-  //! projectile, Code const target,FourMomentum const& projectileP4, FourMomentum const&
-  //! targetP4) routine.
+  //! is needed that implements the
+  //! doInteraction(TSecondaries& view, Code const projectile, Code const
+  //! target,FourMomentum const& projectileP4, FourMomentum const& targetP4) routine.
   //! @tparam THadronicModel
   //!
 
@@ -61,7 +61,24 @@ namespace corsika::proposal {
     //! Calculate the rates for the different targets and interactions. Sample a
     //! pair of interaction-type, component and rate, followed by sampling a loss and
     //! produce the corresponding secondaries and store them on the particle stack.
+    //! interactions in PROPOSAL are:
     //!
+    //! InteractionType::Particle
+    //! InteractionType::Brems
+    //! InteractionType::Ioniz
+    //! InteractionType::Epair
+    //! InteractionType::Photonuclear
+    //! InteractionType::MuPair
+    //! InteractionType::Hadrons
+    //! InteractionType::ContinuousEnergyLoss
+    //! InteractionType::WeakInt
+    //! InteractionType::Compton
+    //! InteractionType::Decay
+    //! InteractionType::Annihilation
+    //! InteractionType::Photopair
+    //!
+    //! more information can be found at:
+    //! https://github.com/tudo-astroparticlephysics/PROPOSAL
     template <typename TSecondaryView>
     ProcessReturn doInteraction(TSecondaryView&, Code const projectileId,
                                 FourMomentum const& projectileP4);
-- 
GitLab