ProducingModuleAdaptor.h

Go to the documentation of this file.

#ifndef FWCore_Framework_stream_ProducingModuleAdaptor_h
#define FWCore_Framework_stream_ProducingModuleAdaptor_h
// -*- C++ -*-
//
// Package:     FWCore/Framework
// Class  :     ProducingModuleAdaptor
//
//
// Original Author:  Chris Jones
//         Created:  Fri, 02 Aug 2013 18:09:18 GMT
//

// system include files

// user include files
#include "FWCore/Framework/interface/ProcessBlock.h"
#include "FWCore/Framework/interface/Run.h"
#include "FWCore/Framework/interface/LuminosityBlock.h"
#include "FWCore/Framework/interface/RunPrincipal.h"
#include "FWCore/Framework/interface/LuminosityBlockPrincipal.h"
#include "FWCore/Framework/interface/EventSetup.h"
#include "FWCore/Framework/interface/stream/callAbilities.h"
#include "FWCore/Framework/interface/stream/dummy_helpers.h"
#include "FWCore/Framework/interface/stream/makeGlobal.h"
#include "FWCore/Framework/interface/TransitionInfoTypes.h"
#include "FWCore/ServiceRegistry/interface/ESParentContext.h"
// forward declarations

namespace edm {
  class ConfigurationDescriptions;
  namespace stream {

    template <typename T, typename M, typename B>
    class ProducingModuleAdaptor : public B {
    public:
      ProducingModuleAdaptor(edm::ParameterSet const& iPSet) : m_pset(&iPSet) {
        m_runs.resize(1);
        m_lumis.resize(1);
        m_runSummaries.resize(1);
        m_lumiSummaries.resize(1);
        typename T::GlobalCache const* dummy = nullptr;
        m_global = impl::makeGlobal<T>(iPSet, dummy);
        typename T::InputProcessBlockCache const* dummyInputProcessBlockCacheImpl = nullptr;
        m_inputProcessBlocks = impl::makeInputProcessBlockCacheImpl(dummyInputProcessBlockCacheImpl);
      }
      ProducingModuleAdaptor(const ProducingModuleAdaptor&) = delete;                   // stop default
      const ProducingModuleAdaptor& operator=(const ProducingModuleAdaptor&) = delete;  // stop default
      ~ProducingModuleAdaptor() override { this->deleteModulesEarly(); }

      static void fillDescriptions(ConfigurationDescriptions& descriptions) { T::fillDescriptions(descriptions); }
      static void prevalidate(ConfigurationDescriptions& descriptions) { T::prevalidate(descriptions); }

      bool wantsProcessBlocks() const noexcept final {
        return T::HasAbility::kWatchProcessBlock or T::HasAbility::kBeginProcessBlockProducer or
               T::HasAbility::kEndProcessBlockProducer;
      }
      bool wantsInputProcessBlocks() const noexcept final { return T::HasAbility::kInputProcessBlockCache; }
      bool wantsGlobalRuns() const noexcept final {
        return T::HasAbility::kRunCache or T::HasAbility::kRunSummaryCache or T::HasAbility::kBeginRunProducer or
               T::HasAbility::kEndRunProducer;
      }
      bool wantsStreamRuns() const noexcept final { return T::HasAbility::kWatchRuns; }

      bool wantsGlobalLuminosityBlocks() const noexcept final {
        return T::HasAbility::kLuminosityBlockCache or T::HasAbility::kLuminosityBlockSummaryCache or
               T::HasAbility::kBeginLuminosityBlockProducer or T::HasAbility::kEndLuminosityBlockProducer;
      }
      bool wantsStreamLuminosityBlocks() const noexcept final { return T::HasAbility::kWatchLuminosityBlocks; }

      bool hasAcquire() const noexcept final { return T::HasAbility::kExternalWork; }

      bool hasAccumulator() const noexcept final { return T::HasAbility::kAccumulator; }

    private:
      using MyGlobal = CallGlobal<T>;
      using MyInputProcessBlock = CallInputProcessBlock<T>;
      using MyWatchProcessBlock = CallWatchProcessBlock<T>;
      using MyBeginProcessBlockProduce = CallBeginProcessBlockProduce<T>;
      using MyEndProcessBlockProduce = CallEndProcessBlockProduce<T>;
      using MyGlobalRun = CallGlobalRun<T>;
      using MyGlobalRunSummary = CallGlobalRunSummary<T>;
      using MyBeginRunProduce = CallBeginRunProduce<T>;
      using MyEndRunProduce = CallEndRunProduce<T>;
      using MyGlobalLuminosityBlock = CallGlobalLuminosityBlock<T>;
      using MyGlobalLuminosityBlockSummary = CallGlobalLuminosityBlockSummary<T>;
      using MyBeginLuminosityBlockProduce = CallBeginLuminosityBlockProduce<T>;
      using MyEndLuminosityBlockProduce = CallEndLuminosityBlockProduce<T>;

      void setupStreamModules() final {
        this->createStreamModules([this](unsigned int iStreamModule) -> M* {
          auto tmp = impl::makeStreamModule<T>(*m_pset, m_global.get());
          MyGlobal::set(tmp, m_global.get());
          MyInputProcessBlock::set(tmp, &m_inputProcessBlocks, iStreamModule);
          return tmp;
        });
        m_pset = nullptr;
      }

      void preallocRuns(unsigned int iNRuns) final {
        m_runs.resize(iNRuns);
        m_runSummaries.resize(iNRuns);
      }
      void preallocLumis(unsigned int iNLumis) final {
        m_lumis.resize(iNLumis);
        m_lumiSummaries.resize(iNLumis);
      }
      void doBeginJob() final { MyGlobal::beginJob(m_global.get()); }
      void doEndJob() final { MyGlobal::endJob(m_global.get()); }
      void setupRun(M* iProd, RunIndex iIndex) final { MyGlobalRun::set(iProd, m_runs[iIndex].get()); }
      void streamEndRunSummary(M* iProd, edm::Run const& iRun, edm::EventSetup const& iES) final {
        auto s = m_runSummaries[iRun.index()].get();
        std::lock_guard<decltype(m_runSummaryLock)> guard(m_runSummaryLock);
        MyGlobalRunSummary::streamEndRunSummary(iProd, iRun, iES, s);
      }

      void setupLuminosityBlock(M* iProd, LuminosityBlockIndex iIndex) final {
        MyGlobalLuminosityBlock::set(iProd, m_lumis[iIndex].get());
      }
      void streamEndLuminosityBlockSummary(M* iProd,
                                           edm::LuminosityBlock const& iLumi,
                                           edm::EventSetup const& iES) final {
        auto s = m_lumiSummaries[iLumi.index()].get();
        std::lock_guard<decltype(m_lumiSummaryLock)> guard(m_lumiSummaryLock);
        MyGlobalLuminosityBlockSummary::streamEndLuminosityBlockSummary(iProd, iLumi, iES, s);
      }

      void doBeginProcessBlock(ProcessBlockPrincipal const& pbp, ModuleCallingContext const* mcc) final {
        if constexpr (T::HasAbility::kWatchProcessBlock or T::HasAbility::kBeginProcessBlockProducer) {
          ProcessBlock processBlock(pbp, this->moduleDescription(), mcc, false);
          ProcessBlock const& cnstProcessBlock = processBlock;
          processBlock.setConsumer(this->consumer());
          MyWatchProcessBlock::beginProcessBlock(cnstProcessBlock, m_global.get());
          if constexpr (T::HasAbility::kBeginProcessBlockProducer) {
            processBlock.setProducer(this->producer());
            MyBeginProcessBlockProduce::produce(processBlock, m_global.get());
            this->commit(processBlock);
          }
        }
      }

      void doAccessInputProcessBlock(ProcessBlockPrincipal const& pbp, ModuleCallingContext const* mcc) final {
        if constexpr (T::HasAbility::kInputProcessBlockCache) {
          ProcessBlock processBlock(pbp, this->moduleDescription(), mcc, false);
          ProcessBlock const& cnstProcessBlock = processBlock;
          processBlock.setConsumer(this->consumer());
          MyInputProcessBlock::accessInputProcessBlock(cnstProcessBlock, m_global.get(), m_inputProcessBlocks);
        }
      }

      void doEndProcessBlock(ProcessBlockPrincipal const& pbp, ModuleCallingContext const* mcc) final {
        if constexpr (T::HasAbility::kWatchProcessBlock or T::HasAbility::kEndProcessBlockProducer) {
          ProcessBlock processBlock(pbp, this->moduleDescription(), mcc, true);
          ProcessBlock const& cnstProcessBlock = processBlock;
          processBlock.setConsumer(this->consumer());
          MyWatchProcessBlock::endProcessBlock(cnstProcessBlock, m_global.get());
          if constexpr (T::HasAbility::kEndProcessBlockProducer) {
            processBlock.setProducer(this->producer());
            MyEndProcessBlockProduce::produce(processBlock, m_global.get());
            this->commit(processBlock);
          }
        }
      }

      void doBeginRun(RunTransitionInfo const& info, ModuleCallingContext const* mcc) final {
        if constexpr (T::HasAbility::kRunCache or T::HasAbility::kRunSummaryCache or T::HasAbility::kBeginRunProducer) {
          RunPrincipal const& rp = info.principal();
          Run r(rp, this->moduleDescription(), mcc, false);
          r.setConsumer(this->consumer());
          r.setProducer(this->producer());
          Run const& cnstR = r;
          RunIndex ri = rp.index();
          ESParentContext parentC(mcc);
          const EventSetup c{info,
                             static_cast<unsigned int>(Transition::BeginRun),
                             this->consumer()->esGetTokenIndices(Transition::BeginRun),
                             parentC};
          MyGlobalRun::beginRun(cnstR, c, m_global.get(), m_runs[ri]);
          typename T::RunContext rc(m_runs[ri].get(), m_global.get());
          MyGlobalRunSummary::beginRun(cnstR, c, &rc, m_runSummaries[ri]);
          if constexpr (T::HasAbility::kBeginRunProducer) {
            MyBeginRunProduce::produce(r, c, &rc);
            this->commit(r);
          }
        }
      }

      void doEndRun(RunTransitionInfo const& info, ModuleCallingContext const* mcc) final {
        if constexpr (T::HasAbility::kRunCache or T::HasAbility::kRunSummaryCache or T::HasAbility::kEndRunProducer) {
          RunPrincipal const& rp = info.principal();
          Run r(rp, this->moduleDescription(), mcc, true);
          r.setConsumer(this->consumer());
          r.setProducer(this->producer());

          RunIndex ri = rp.index();
          typename T::RunContext rc(m_runs[ri].get(), m_global.get());
          ESParentContext parentC(mcc);
          const EventSetup c{info,
                             static_cast<unsigned int>(Transition::EndRun),
                             this->consumer()->esGetTokenIndices(Transition::EndRun),
                             parentC};
          MyGlobalRunSummary::globalEndRun(r, c, &rc, m_runSummaries[ri].get());
          if constexpr (T::HasAbility::kEndRunProducer) {
            MyEndRunProduce::produce(r, c, &rc, m_runSummaries[ri].get());
            this->commit(r);
          }
          MyGlobalRun::endRun(r, c, &rc);
        }
      }

      void doBeginLuminosityBlock(LumiTransitionInfo const& info, ModuleCallingContext const* mcc) final {
        if constexpr (T::HasAbility::kLuminosityBlockCache or T::HasAbility::kLuminosityBlockSummaryCache or
                      T::HasAbility::kBeginLuminosityBlockProducer) {
          LuminosityBlockPrincipal const& lbp = info.principal();
          LuminosityBlock lb(lbp, this->moduleDescription(), mcc, false);
          lb.setConsumer(this->consumer());
          lb.setProducer(this->producer());
          LuminosityBlock const& cnstLb = lb;
          LuminosityBlockIndex li = lbp.index();
          RunIndex ri = lbp.runPrincipal().index();
          typename T::RunContext rc(m_runs[ri].get(), m_global.get());
          ESParentContext parentC(mcc);
          const EventSetup c{info,
                             static_cast<unsigned int>(Transition::BeginLuminosityBlock),
                             this->consumer()->esGetTokenIndices(Transition::BeginLuminosityBlock),
                             parentC};

          MyGlobalLuminosityBlock::beginLuminosityBlock(cnstLb, c, &rc, m_lumis[li]);
          typename T::LuminosityBlockContext lc(m_lumis[li].get(), m_runs[ri].get(), m_global.get());
          MyGlobalLuminosityBlockSummary::beginLuminosityBlock(cnstLb, c, &lc, m_lumiSummaries[li]);
          if constexpr (T::HasAbility::kBeginLuminosityBlockProducer) {
            MyBeginLuminosityBlockProduce::produce(lb, c, &lc);
            this->commit(lb);
          }
        }
      }
      void doEndLuminosityBlock(LumiTransitionInfo const& info, ModuleCallingContext const* mcc) final {
        if constexpr (T::HasAbility::kLuminosityBlockCache or T::HasAbility::kLuminosityBlockSummaryCache or
                      T::HasAbility::kEndLuminosityBlockProducer) {
          LuminosityBlockPrincipal const& lbp = info.principal();
          LuminosityBlock lb(lbp, this->moduleDescription(), mcc, true);
          lb.setConsumer(this->consumer());
          lb.setProducer(this->producer());

          LuminosityBlockIndex li = lbp.index();
          RunIndex ri = lbp.runPrincipal().index();
          typename T::LuminosityBlockContext lc(m_lumis[li].get(), m_runs[ri].get(), m_global.get());
          ESParentContext parentC(mcc);
          const EventSetup c{info,
                             static_cast<unsigned int>(Transition::EndLuminosityBlock),
                             this->consumer()->esGetTokenIndices(Transition::EndLuminosityBlock),
                             parentC};
          MyGlobalLuminosityBlockSummary::globalEndLuminosityBlock(lb, c, &lc, m_lumiSummaries[li].get());
          if constexpr (T::HasAbility::kEndLuminosityBlockProducer) {
            MyEndLuminosityBlockProduce::produce(lb, c, &lc, m_lumiSummaries[li].get());
            this->commit(lb);
          }
          MyGlobalLuminosityBlock::endLuminosityBlock(lb, c, &lc);
        }
      }

      void doRespondToCloseOutputFile() final { MyInputProcessBlock::clearCaches(m_inputProcessBlocks); }

      using B::consumer;

      void selectInputProcessBlocks(ProductRegistry const& productRegistry,
                                    ProcessBlockHelperBase const& processBlockHelperBase) final {
        MyInputProcessBlock::selectInputProcessBlocks(
            m_inputProcessBlocks, productRegistry, processBlockHelperBase, *consumer());
      }

      // ---------- member data --------------------------------
      typename impl::choose_unique_ptr<typename T::GlobalCache>::type m_global;
      typename impl::choose_unique_ptr<typename T::InputProcessBlockCache>::type m_inputProcessBlocks;
      typename impl::choose_shared_vec<typename T::RunCache const>::type m_runs;
      typename impl::choose_shared_vec<typename T::LuminosityBlockCache const>::type m_lumis;
      typename impl::choose_shared_vec<typename T::RunSummaryCache>::type m_runSummaries;
      typename impl::choose_mutex<typename T::RunSummaryCache>::type m_runSummaryLock;
      typename impl::choose_shared_vec<typename T::LuminosityBlockSummaryCache>::type m_lumiSummaries;
      typename impl::choose_mutex<typename T::LuminosityBlockSummaryCache>::type m_lumiSummaryLock;
      ParameterSet const* m_pset;
    };
  }  // namespace stream
}  // namespace edm

#endif