ALPAKA_ACCELERATOR_NAMESPACE::ESProducer Class Reference

#include <ESProducer.h>

Inheritance diagram for ALPAKA_ACCELERATOR_NAMESPACE::ESProducer:

Protected Member Functions
template<typename T >
auto	setWhatProduced (T *iThis, edm::es::Label const &label={})
template<typename T , typename TReturn , typename TRecord >
auto	setWhatProduced (T *iThis, TReturn(T ::*iMethod)(TRecord const &), edm::es::Label const &label={})
template<typename T , typename TReturn , typename TRecord >
auto	setWhatProduced (T *iThis, TReturn(T ::*iMethod)(device::Record< TRecord > const &), edm::es::Label const &label={})
Protected Member Functions inherited from edm::ESProducer
template<typename T >
auto	setWhatProduced (T *iThis, const es::Label &iLabel={})
template<typename T >
auto	setWhatProduced (T *iThis, const char *iLabel)
template<typename T >
auto	setWhatProduced (T *iThis, const std::string &iLabel)
template<typename T , typename TDecorator >
auto	setWhatProduced (T *iThis, const TDecorator &iDec, const es::Label &iLabel={})
template<typename T , typename TReturn , typename TRecord >
auto	setWhatProduced (T *iThis, TReturn(T ::*iMethod)(const TRecord &), const es::Label &iLabel={})
template<typename T , typename TReturn , typename TRecord , typename TArg >
auto	setWhatProduced (T *iThis, TReturn(T ::*iMethod)(const TRecord &), const TArg &iDec, const es::Label &iLabel={})
template<typename TFunc >
auto	setWhatProduced (TFunc &&func, const es::Label &iLabel={})
template<typename TReturn , typename TRecord , typename TFunc , typename TDecorator >
ESConsumesCollectorT< TRecord >	setWhatProduced (TFunc &&func, TDecorator &&iDec, const es::Label &iLabel={})
void	usesResources (std::vector< std::string > const &)
Protected Member Functions inherited from edm::ESProxyFactoryProducer
template<class TFactory >
void	registerFactory (std::unique_ptr< TFactory > iFactory, const std::string &iLabel=std::string())
virtual void	registerFactoryWithKey (const EventSetupRecordKey &iRecord, std::unique_ptr< eventsetup::ProxyFactoryBase > iFactory, const std::string &iLabel=std::string())
KeyedProxiesVector	registerProxies (const EventSetupRecordKey &, unsigned int iovIndex) override
Protected Member Functions inherited from edm::eventsetup::DataProxyProvider
template<class T >
void	usingRecord ()
void	usingRecordWithKey (const EventSetupRecordKey &key)

Private Types
using	Base = edm::ESProducer

Static Private Member Functions
static void	throwSomeNullException ()

Additional Inherited Members
Public Member Functions inherited from edm::ESProducer
	ESProducer ()
	ESProducer (const ESProducer &)=delete
ESProxyIndex const *	getTokenIndices (unsigned int iIndex) const
ESRecordIndex const *	getTokenRecordIndices (unsigned int iIndex) const
bool	hasMayConsumes () const noexcept
size_t	numberOfTokenIndices (unsigned int iIndex) const
ESProducer const &	operator= (const ESProducer &)=delete
SerialTaskQueueChain &	queue ()
template<typename Record >
std::optional< std::vector< ESProxyIndex > >	updateFromMayConsumes (unsigned int iIndex, const Record &iRecord) const
void	updateLookup (eventsetup::ESRecordsToProxyIndices const &) final
	~ESProducer () noexcept(false) override
Public Member Functions inherited from edm::ESProxyFactoryProducer
	ESProxyFactoryProducer ()
	ESProxyFactoryProducer (const ESProxyFactoryProducer &)=delete
const ESProxyFactoryProducer &	operator= (const ESProxyFactoryProducer &)=delete
	~ESProxyFactoryProducer () noexcept(false) override
Public Member Functions inherited from edm::eventsetup::DataProxyProvider
void	createKeyedProxies (EventSetupRecordKey const &key, unsigned int nConcurrentIOVs)
	DataProxyProvider ()
	DataProxyProvider (const DataProxyProvider &)=delete
const ComponentDescription &	description () const
void	fillRecordsNotAllowingConcurrentIOVs (std::set< EventSetupRecordKey > &recordsNotAllowingConcurrentIOVs) const
virtual void	initConcurrentIOVs (EventSetupRecordKey const &key, unsigned int nConcurrentIOVs)
bool	isUsingRecord (const EventSetupRecordKey &key) const
KeyedProxies &	keyedProxies (const EventSetupRecordKey &iRecordKey, unsigned int iovIndex=0)
const DataProxyProvider &	operator= (const DataProxyProvider &)=delete
void	setAppendToDataLabel (const edm::ParameterSet &)
void	setDescription (const ComponentDescription &iDescription)
std::set< EventSetupRecordKey >	usingRecords () const
virtual	~DataProxyProvider () noexcept(false)
Static Public Member Functions inherited from edm::eventsetup::DataProxyProvider
static void	prevalidate (ConfigurationDescriptions &)
Protected Types inherited from edm::ESProxyFactoryProducer
using	EventSetupRecordKey = eventsetup::EventSetupRecordKey
Protected Types inherited from edm::eventsetup::DataProxyProvider
using	KeyedProxiesVector = std::vector< std::pair< DataKey, std::shared_ptr< DataProxy > >>

Detailed Description

The ESProducer is a base class for modules producing data into the host memory space and/or the device memory space defined by the backend (i.e. ALPAKA_ACCELERATOR_NAMESPACE). The interface looks similar to the normal edm::ESProducer.

When producing a host product, the produce function should have the the usual Record argument. For producing a device product, the produce funtion should have device::Record<Record> argument.

Definition at line 23 of file ESProducer.h.

Member Typedef Documentation

Base

using ALPAKA_ACCELERATOR_NAMESPACE::ESProducer::Base = edm::ESProducer

private

Definition at line 24 of file ESProducer.h.

Member Function Documentation

setWhatProduced() [1/3]

template<typename T >

auto ALPAKA_ACCELERATOR_NAMESPACE::ESProducer::setWhatProduced ( T *  iThis, edm::es::Label const &  label = {}  )

inlineprotected

Definition at line 28 of file ESProducer.h.

Referenced by ALPAKA_ACCELERATOR_NAMESPACE::TestAlpakaESProducerA::TestAlpakaESProducerA(), ALPAKA_ACCELERATOR_NAMESPACE::TestAlpakaESProducerB::TestAlpakaESProducerB(), ALPAKA_ACCELERATOR_NAMESPACE::TestAlpakaESProducerC::TestAlpakaESProducerC(), and ALPAKA_ACCELERATOR_NAMESPACE::TestAlpakaESProducerD::TestAlpakaESProducerD().

                                                             {}) {
      return setWhatProduced(iThis, &T::produce, label);
    }

setWhatProduced() [2/3]

template<typename T , typename TReturn , typename TRecord >

auto ALPAKA_ACCELERATOR_NAMESPACE::ESProducer::setWhatProduced ( T *  iThis, TReturn(T ::*)(TRecord const &)  iMethod, edm::es::Label const &  label = {}  )

inlineprotected

Definition at line 33 of file ESProducer.h.

                                                                                                   {}) {
      return Base::setWhatProduced(iThis, iMethod, label);
    }

setWhatProduced() [3/3]

template<typename T , typename TReturn , typename TRecord >

auto ALPAKA_ACCELERATOR_NAMESPACE::ESProducer::setWhatProduced ( T *  iThis, TReturn(T ::*)(device::Record< TRecord > const &)  iMethod, edm::es::Label const &  label = {}  )

inlineprotected

Definition at line 38 of file ESProducer.h.

                                                   {}) {
      using TProduct = typename edm::eventsetup::produce::smart_pointer_traits<TReturn>::type;
      using ProductType = ESDeviceProduct<TProduct>;
      using ReturnType = detail::ESDeviceProductWithStorage<TProduct, TReturn>;
      return Base::setWhatProduced(
          [iThis, iMethod](TRecord const& record) -> std::unique_ptr<ProductType> {
            // TODO: move the multiple device support into EventSetup system itself
            auto const& devices = cms::alpakatools::devices<Platform>();
            std::vector<std::shared_ptr<Queue>> queues;
            queues.reserve(devices.size());
            auto ret = std::make_unique<ReturnType>(devices.size());
            bool allnull = true;
            bool anynull = false;
            for (auto const& dev : devices) {
              device::Record<TRecord> const deviceRecord(record, dev);
              auto prod = std::invoke(iMethod, iThis, deviceRecord);
              if (prod) {
                allnull = false;
                ret->insert(dev, std::move(prod));
              } else {
                anynull = true;
              }
              queues.push_back(deviceRecord.queuePtr());
            }
            // TODO: to be changed asynchronous later
            for (auto& queuePtr : queues) {
              alpaka::wait(*queuePtr);
            }
            if (allnull) {
              return nullptr;
            } else if (anynull) {
              // TODO: throwing an exception if the iMethod() returns
              // null for some of th devices of one backend is
              // suboptimal. On the other hand, in the near term
              // multiple devices per backend is useful only for
              // private tests (not production), and the plan is to
              // make the EventSetup system itself aware of multiple
              // devies (or memory spaces). I hope this exception
              // would be good-enough until we get there.
              ESProducer::throwSomeNullException();
            }
            return ret;
          },
          label);
    }

throwSomeNullException()

void ALPAKA_ACCELERATOR_NAMESPACE::ESProducer::throwSomeNullException ( )

staticprivate

Definition at line 5 of file ESProducer.cc.

References Exception, and edm::errors::UnimplementedFeature.

                                          {
    throw edm::Exception(edm::errors::UnimplementedFeature)
        << "The Alpaka backend has multiple devices. The device-specific produce() function returned a null product "
           "for some of the devices of the backend, but not all. This is not currently supported.";
  }