OutputModuleBase.h

Go to the documentation of this file.

#ifndef FWCore_Framework_one_OutputModuleBase_h
#define FWCore_Framework_one_OutputModuleBase_h
// -*- C++ -*-
//
// Package:     FWCore/Framework
// Class  :     OutputModuleBase
//
//
// Original Author:  Chris Jones
//         Created:  Wed, 31 Jul 2013 15:37:16 GMT
//
 
// system include files
#include <array>
#include <memory>
#include <string>
#include <vector>
#include <map>
#include <atomic>
#include <set>
 
// user include files
#include "DataFormats/Provenance/interface/BranchID.h"
#include "DataFormats/Provenance/interface/BranchIDList.h"
#include "DataFormats/Provenance/interface/ModuleDescription.h"
#include "DataFormats/Provenance/interface/SelectedProducts.h"
 
#include "FWCore/Common/interface/FWCoreCommonFwd.h"
#include "FWCore/Common/interface/OutputProcessBlockHelper.h"
#include "FWCore/Framework/interface/TriggerResultsBasedEventSelector.h"
#include "FWCore/Framework/interface/Frameworkfwd.h"
#include "FWCore/Framework/interface/ProductSelectorRules.h"
#include "FWCore/Framework/interface/ProductSelector.h"
#include "FWCore/Framework/interface/EDConsumerBase.h"
#include "FWCore/Framework/interface/getAllTriggerNames.h"
#include "FWCore/Framework/interface/SharedResourcesAcquirer.h"
#include "FWCore/ParameterSet/interface/ParameterSetfwd.h"
#include "FWCore/Concurrency/interface/WaitingTaskHolder.h"
#include "FWCore/Utilities/interface/propagate_const.h"
 
// forward declarations
namespace edm {
 
  class MergeableRunProductMetadata;
  class ModuleCallingContext;
  class PreallocationConfiguration;
  class ActivityRegistry;
  class ThinnedAssociationsHelper;
  class SubProcessParentageHelper;
 
  template <typename T>
  class OutputModuleCommunicatorT;
 
  namespace maker {
    template <typename T>
    class ModuleHolderT;
  }
 
  namespace one {
 
    class OutputModuleBase : public EDConsumerBase {
    public:
      template <typename U>
      friend class edm::maker::ModuleHolderT;
      template <typename T>
      friend class ::edm::WorkerT;
      template <typename T>
      friend class ::edm::OutputModuleCommunicatorT;
      typedef OutputModuleBase ModuleType;
 
      explicit OutputModuleBase(ParameterSet const& pset);
      ~OutputModuleBase() override;
 
      OutputModuleBase(OutputModuleBase const&) = delete;             // Disallow copying and moving
      OutputModuleBase& operator=(OutputModuleBase const&) = delete;  // Disallow copying and moving
 
      int maxEvents() const { return maxEvents_; }
 
      int remainingEvents() const { return remainingEvents_; }
 
      bool selected(BranchDescription const& desc) const;
 
      void selectProducts(ProductRegistry const& preg, ThinnedAssociationsHelper const&, ProcessBlockHelperBase const&);
      std::string const& processName() const { return process_name_; }
      SelectedProductsForBranchType const& keptProducts() const { return keptProducts_; }
      std::array<bool, NumBranchTypes> const& hasNewlyDroppedBranch() const { return hasNewlyDroppedBranch_; }
 
      static void fillDescription(
          ParameterSetDescription& desc,
          std::vector<std::string> const& iDefaultOutputCommands = ProductSelectorRules::defaultSelectionStrings());
      static void fillDescriptions(ConfigurationDescriptions& descriptions);
      static const std::string& baseType();
      static void prevalidate(ConfigurationDescriptions&);
 
      //Output modules always need writeRun and writeLumi to be called
      virtual bool wantsProcessBlocks() const = 0;
      virtual bool wantsInputProcessBlocks() const = 0;
      virtual bool wantsGlobalRuns() const = 0;
      virtual bool wantsGlobalLuminosityBlocks() const = 0;
      bool wantsStreamRuns() const { return false; }
      bool wantsStreamLuminosityBlocks() const { return false; };
 
      virtual SerialTaskQueue* globalRunsQueue() { return nullptr; }
      virtual SerialTaskQueue* globalLuminosityBlocksQueue() { return nullptr; }
      SharedResourcesAcquirer& sharedResourcesAcquirer() { return resourcesAcquirer_; }
 
      bool wantAllEvents() const { return wantAllEvents_; }
 
      BranchIDLists const* branchIDLists();
 
      OutputProcessBlockHelper const& outputProcessBlockHelper() const { return outputProcessBlockHelper_; }
 
      ThinnedAssociationsHelper const* thinnedAssociationsHelper() const;
 
      SubProcessParentageHelper const* subProcessParentageHelper() const { return subProcessParentageHelper_; }
 
      const ModuleDescription& moduleDescription() const { return moduleDescription_; }
 
    protected:
      ModuleDescription const& description() const;
 
      ParameterSetID selectorConfig() const { return selector_config_id_; }
 
      void doPreallocate(PreallocationConfiguration const&);
      virtual void preallocLumis(unsigned int);
 
      void doBeginJob();
      void doEndJob();
      bool doEvent(EventTransitionInfo const&, ActivityRegistry*, ModuleCallingContext const*);
      void doBeginProcessBlock(ProcessBlockPrincipal const&, ModuleCallingContext const*) {}
      void doAccessInputProcessBlock(ProcessBlockPrincipal const&, ModuleCallingContext const*) {}
      void doEndProcessBlock(ProcessBlockPrincipal const&, ModuleCallingContext const*) {}
      bool doBeginRun(RunTransitionInfo const&, ModuleCallingContext const*);
      bool doEndRun(RunTransitionInfo const&, ModuleCallingContext const*);
      bool doBeginLuminosityBlock(LumiTransitionInfo const&, ModuleCallingContext const*);
      bool doEndLuminosityBlock(LumiTransitionInfo const&, ModuleCallingContext const*);
 
      void setEventSelectionInfo(
          std::map<std::string, std::vector<std::pair<std::string, int>>> const& outputModulePathPositions,
          bool anyProductProduced);
 
      void configure(OutputModuleDescription const& desc);
 
      std::map<BranchID::value_type, BranchID::value_type> const& droppedBranchIDToKeptBranchID() {
        return droppedBranchIDToKeptBranchID_;
      }
 
    private:
      int maxEvents_;
      std::atomic<int> remainingEvents_;
 
      // TODO: Give OutputModule
      // an interface (protected?) that supplies client code with the
      // needed functionality *without* giving away implementation
      // details ... don't just return a reference to keptProducts_, because
      // we are looking to have the flexibility to change the
      // implementation of keptProducts_ without modifying clients. When this
      // change is made, we'll have a one-time-only task of modifying
      // clients (classes derived from OutputModule) to use the
      // newly-introduced interface.
      // TODO: Consider using shared pointers here?
 
      // keptProducts_ are pointers to the BranchDescription objects describing
      // the branches we are to write.
      //
      // We do not own the BranchDescriptions to which we point.
      SelectedProductsForBranchType keptProducts_;
      std::array<bool, NumBranchTypes> hasNewlyDroppedBranch_;
 
      std::string process_name_;
      ProductSelectorRules productSelectorRules_;
      ProductSelector productSelector_;
      ModuleDescription moduleDescription_;
 
      bool wantAllEvents_;
      std::vector<detail::TriggerResultsBasedEventSelector> selectors_;
      ParameterSet selectEvents_;
      // ID of the ParameterSet that configured the event selector
      // subsystem.
      ParameterSetID selector_config_id_;
 
      // needed because of possible EDAliases.
      // filled in only if key and value are different.
      std::map<BranchID::value_type, BranchID::value_type> droppedBranchIDToKeptBranchID_;
      edm::propagate_const<std::unique_ptr<BranchIDLists>> branchIDLists_;
      BranchIDLists const* origBranchIDLists_;
 
      SubProcessParentageHelper const* subProcessParentageHelper_;
 
      edm::propagate_const<std::unique_ptr<ThinnedAssociationsHelper>> thinnedAssociationsHelper_;
      std::map<BranchID, bool> keepAssociation_;
 
      OutputProcessBlockHelper outputProcessBlockHelper_;
 
      SharedResourcesAcquirer resourcesAcquirer_;
      SerialTaskQueue runQueue_;
      SerialTaskQueue luminosityBlockQueue_;
 
      //------------------------------------------------------------------
      // private member functions
      //------------------------------------------------------------------
 
      virtual SharedResourcesAcquirer createAcquirer();
 
      void doWriteProcessBlock(ProcessBlockPrincipal const&, ModuleCallingContext const*);
      void doWriteRun(RunPrincipal const& rp, ModuleCallingContext const*, MergeableRunProductMetadata const*);
      void doWriteLuminosityBlock(LuminosityBlockPrincipal const& lbp, ModuleCallingContext const*);
      void doOpenFile(FileBlock const& fb);
      void doRespondToOpenInputFile(FileBlock const& fb);
      void doRespondToCloseInputFile(FileBlock const& fb);
      void doRespondToCloseOutputFile() {}
      void doRegisterThinnedAssociations(ProductRegistry const&, ThinnedAssociationsHelper&) {}
 
      std::string workerType() const { return "WorkerT<edm::one::OutputModuleBase>"; }
 
      void doCloseFile();
 
      void registerProductsAndCallbacks(OutputModuleBase const*, ProductRegistry const*) {}
 
      bool needToRunSelection() const;
      std::vector<ProductResolverIndexAndSkipBit> productsUsedBySelection() const;
      bool prePrefetchSelection(StreamID id, EventPrincipal const&, ModuleCallingContext const*);
 
      // Do the end-of-file tasks; this is only called internally, after
      // the appropriate tests have been done.
      virtual void reallyCloseFile();
 
      virtual bool shouldWeCloseFile() const { return false; }
 
      virtual void write(EventForOutput const&) = 0;
      virtual void preActionBeforeRunEventAsync(WaitingTaskHolder iTask,
                                                ModuleCallingContext const& iModuleCallingContext,
                                                Principal const& iPrincipal) const {}
 
      virtual void beginJob() {}
      virtual void endJob() {}
      virtual void writeLuminosityBlock(LuminosityBlockForOutput const&) = 0;
      virtual void writeRun(RunForOutput const&) = 0;
      virtual void writeProcessBlock(ProcessBlockForOutput const&) {}
      virtual void openFile(FileBlock const&) {}
      virtual bool isFileOpen() const { return true; }
 
      virtual void doBeginRun_(RunForOutput const&) {}
      virtual void doEndRun_(RunForOutput const&) {}
      virtual void doBeginLuminosityBlock_(LuminosityBlockForOutput const&) {}
      virtual void doEndLuminosityBlock_(LuminosityBlockForOutput const&) {}
      virtual void doRespondToOpenInputFile_(FileBlock const&) {}
      virtual void doRespondToCloseInputFile_(FileBlock const&) {}
 
      virtual void setProcessesWithSelectedMergeableRunProducts(std::set<std::string> const&) {}
 
      bool hasAcquire() const { return false; }
      bool hasAccumulator() const { return false; }
 
      void keepThisBranch(BranchDescription const& desc,
                          std::map<BranchID, BranchDescription const*>& trueBranchIDToKeptBranchDesc,
                          std::set<BranchID>& keptProductsInEvent);
 
      void setModuleDescription(ModuleDescription const& md) { moduleDescription_ = md; }
 
      bool limitReached() const { return remainingEvents_ == 0; }
    };
  }  // namespace one
}  // namespace edm
#endif