feat: support for clas12root clas12reader

- new `Algorithm::CreateBank` to _just_ create a new Iguana bank, to be
  owned by the caller
- algorithm-specific `Run` functions, which operate on lvalue references
  to banks (compatible with `clas12reader`s raw pointers to
  `hipo::bank`-derived objects)

Author: c-dilks

src/iguana/algorithms/Algorithm.cc

@@ -251,6 +251,15 @@ namespace iguana {
 
   ///////////////////////////////////////////////////////////////////////////////
 
+  hipo::bank Algorithm::CreateBank(std::string const& bank_name) const noexcept(false) {
+    hipo::banklist new_banks;
+    hipo::banklist::size_type new_bank_idx;
+    CreateBank(new_banks, new_bank_idx, bank_name);
+    return new_banks.at(0);
+  }
+
+  ///////////////////////////////////////////////////////////////////////////////
+
   void Algorithm::ShowBanks(hipo::banklist& banks, std::string_view message, Logger::Level const level) const
   {
     if(m_log->GetLevel() <= level) {

src/iguana/algorithms/Algorithm.h

@@ -164,6 +164,11 @@ namespace iguana {
           hipo::banklist::size_type& bank_idx,
           std::string const& bank_name) const noexcept(false);
 
+      /// Create a new bank. The bank must be defined in `src/iguana/bankdefs/iguana.json`.
+      /// @param [in] bank_name the new bank name
+      /// @returns the new bank
+      hipo::bank CreateBank(std::string const& bank_name) const noexcept(false);
+
       /// Dump all banks in a `hipo::banklist`
       /// @param banks the banks to show
       /// @param message if specified, print a header message

src/iguana/algorithms/physics/InclusiveKinematics/Algorithm.cc

@@ -76,9 +76,17 @@ namespace iguana::physics {
 
   void InclusiveKinematics::Run(hipo::banklist& banks) const
   {
-    auto& particle_bank = GetBank(banks, b_particle, "REC::Particle");
-    auto& config_bank   = GetBank(banks, b_config, "RUN::config");
-    auto& result_bank   = GetBank(banks, b_result, GetClassName());
+    Run(
+        GetBank(banks, b_particle, "REC::Particle"),
+        GetBank(banks, b_config, "RUN::config"),
+        GetBank(banks, b_result, GetClassName()));
+  }
+
+  void InclusiveKinematics::Run(
+      hipo::bank& particle_bank,
+      hipo::bank& config_bank,
+      hipo::bank& result_bank) const
+  {
     ShowBank(particle_bank, Logger::Header("INPUT PARTICLES"));
 
     auto key = PrepareEvent(config_bank.getInt("run",0));

src/iguana/algorithms/physics/InclusiveKinematics/Algorithm.h

@@ -10,8 +10,7 @@ namespace iguana::physics {
   /// @brief_algo Calculate inclusive kinematics quantities
   ///
   /// @begin_doc_algo{physics::InclusiveKinematics | Creator}
-  /// @input_banks{REC::Particle, RUN::config}
-  /// @output_banks{%physics::InclusiveKinematics}
+  /// see this algorithm's Run function(s) for the input and output bank names
   /// @end_doc
   ///
   /// @begin_doc_config{physics/InclusiveKinematics}
@@ -34,6 +33,15 @@ namespace iguana::physics {
       void Run(hipo::banklist& banks) const override;
       void Stop() override;
 
+      /// run function
+      /// @param [in] particle_bank `REC::Particle`
+      /// @param [in] config_bank `RUN::config`
+      /// @param [out] result_bank `%physics::InclusiveKinematics`
+      void Run(
+          hipo::bank& particle_bank,
+          hipo::bank& config_bank,
+          hipo::bank& result_bank) const;
+
       /// @action_function{reload} prepare the event
       /// @when_to_call{for each event}
       /// @param runnum the run number