From 7047cba8407d91f028ca3009c5cc9c87dfb09377 Mon Sep 17 00:00:00 2001
From: Tom Eichlersmith <31970302+tomeichlersmith@users.noreply.github.com>
Date: Tue, 10 Oct 2023 11:49:41 -0500
Subject: [PATCH] add rational for existence of energy function

explain in doxygen comment why this function exists basically copying the rational written for the produce function as well.
---
 DQM/src/DQM/DarkBremInteraction.cxx | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/DQM/src/DQM/DarkBremInteraction.cxx b/DQM/src/DQM/DarkBremInteraction.cxx
index d10368240..ef8ede592 100644
--- a/DQM/src/DQM/DarkBremInteraction.cxx
+++ b/DQM/src/DQM/DarkBremInteraction.cxx
@@ -5,6 +5,10 @@ namespace dqm {
 /**
  * calculate total energy from 3-momentum and mass
  *
+ * Since the dark brem model does not include a nucleus, it only is able to 
+ * conserve momentum, so we need to reconstruct the incident particle's 3-momentum
+ * and then use the known particle mass to calculate its total energy.
+ *
  * @param[in] p 3-momentum
  * @param[in] m mass
  * @return total energy