geo::GeometryConfigurationWriter Class Reference

Writes geometry configuration information into art runs. More...

Inheritance diagram for geo::GeometryConfigurationWriter:

Classes
struct	Config
	Service configuration. More...

Public Types
using	Parameters = art::ServiceTable< Config >

Public Member Functions
	GeometryConfigurationWriter (Parameters const &)
	Constructor: gets its configuration and does nothing with it. More...
void	setModuleDescription (ModuleDescription const &)
void	registerCallbacks (ProducingServiceSignals &)
void	doPostReadRun (RunPrincipal &)
void	doPostReadSubRun (SubRunPrincipal &)
void	doPostReadEvent (EventPrincipal &)

Static Public Attributes
static constexpr bool	service_handle_allowed {false}

Private Types
using	InfoPtr_t = std::unique_ptr< sumdata::GeometryConfigurationInfo >
	Alias for the pointer to the data product object to be put into the run. More...

Private Member Functions
virtual void	postReadRun (art::Run &run) override
	Writes the information from the service configuration into the run. More...
InfoPtr_t	loadInfo (art::Run &run) const
	Loads the geometry information from the run (either directly or legacy). More...
InfoPtr_t	readGeometryInformation (art::Run &run) const
	Reads geometry information from the run (returns null pointer if none). More...
InfoPtr_t	makeInfoFromRunData (art::Run &run) const
sumdata::RunData const *	readRunData (art::Run &run) const
	Returns a pointer to the sumdata::RunData in run (nullptr if none). More...

Static Private Member Functions
static InfoPtr_t	extractInfoFromGeometry ()
	Creates configuration information based on the current Geometry service. More...
static InfoPtr_t	convertRunDataToGeometryInformation (sumdata::RunData const &data)
	Converts the legacy data into geometry configuration information. More...
static InfoPtr_t	makeInfoPtr (sumdata::GeometryConfigurationInfo const &info)
	Alias to std::make_unique<sumdata::GeometryConfigurationInfo>. More...

Detailed Description

Writes geometry configuration information into art runs.

This service is part of the mandatory version check of geo::Geometry service. It does not require any special configuration, but it must be listed in the configuration in order for Geometry to work:

services: {

  GeometryConfigurationWriter: {}

  Geometry: @local::experiment_geometry

  # ...

}

The configuration check is described in the documentation of geo::Geometry service.

Produced data products

The service guarantees that configuration information of type sumdata::GeometryConfigurationInfo is present into the run, accessible with an input tag GeometryConfigurationWriter:

• if such information is already available in the run, no further information is added
• legacy: if there is no such information, but there is a sumdata::RunData data product, a reduced version of the configuration information is created from the information in that data product (the first one, if multiple are present)
• finally, if no information is present neither in the full sumdata::GeometryConfigurationInfo form nor in the legacy sumdata::RunData form, information is put together based on the current configuration of the Geometry service.

Service dependencies

• Geometry service (for obtaining the current configuration to put into the event)

Definition at line 80 of file GeometryConfigurationWriter_service.cc.

Member Typedef Documentation

using geo::GeometryConfigurationWriter::InfoPtr_t = std::unique_ptr<sumdata::GeometryConfigurationInfo>

private

Alias for the pointer to the data product object to be put into the run.

Definition at line 99 of file GeometryConfigurationWriter_service.cc.

using geo::GeometryConfigurationWriter::Parameters = art::ServiceTable<Config>

Definition at line 88 of file GeometryConfigurationWriter_service.cc.

Constructor & Destructor Documentation

geo::GeometryConfigurationWriter::GeometryConfigurationWriter

(

Parameters const &

)

Constructor: gets its configuration and does nothing with it.

Definition at line 131 of file GeometryConfigurationWriter_service.cc.

{
  produces<sumdata::GeometryConfigurationInfo, art::InRun>();
}

Member Function Documentation

auto geo::GeometryConfigurationWriter::convertRunDataToGeometryInformation ( sumdata::RunData const &  data )

staticprivate

Converts the legacy data into geometry configuration information.

Definition at line 213 of file GeometryConfigurationWriter_service.cc.

References sumdata::GeometryConfigurationInfo::dataVersion, DEFINE_ART_PRODUCING_SERVICE, sumdata::GeometryConfigurationInfo::detectorName, makeInfoPtr(), and MF_LOG_DEBUG.

Referenced by makeInfoFromRunData().

{

  sumdata::GeometryConfigurationInfo confInfo;

  // we use the simplest version 1 data format (legacy format)
  confInfo.dataVersion = sumdata::GeometryConfigurationInfo::DataVersion_t{1};
  confInfo.detectorName = data.DetName();

  MF_LOG_DEBUG("GeometryConfigurationInfo")
    << "Built geometry configuration information from run data:\n"
    << confInfo;

  return makeInfoPtr(std::move(confInfo));

} // geo::GeometryConfigurationWriter::convertRunDataToGeometryInformation()

void art::ProducingService::doPostReadEvent ( EventPrincipal &  ep )

inherited

Definition at line 54 of file ProducingService.cc.

References e, art::EventPrincipal::makeEvent(), art::ProducingService::mc_, and art::ProducingService::postReadEvent().

Referenced by art::ProducingService::registerCallbacks().

  {
    auto e = ep.makeEvent(mc_);
    postReadEvent(e);
    e.commitProducts(true, &expectedProducts<InEvent>());
  }

void art::ProducingService::doPostReadRun ( RunPrincipal &  rp )

inherited

Definition at line 38 of file ProducingService.cc.

References art::RangeSet::forRun(), art::RunPrincipal::makeRun(), art::ProducingService::mc_, art::ProducingService::postReadRun(), r, and art::RunPrincipal::runID().

Referenced by art::ProducingService::registerCallbacks().

  {
    auto r = rp.makeRun(mc_, RangeSet::forRun(rp.runID()));
    postReadRun(r);
    r.commitProducts();
  }

void art::ProducingService::doPostReadSubRun ( SubRunPrincipal &  srp )

inherited

Definition at line 46 of file ProducingService.cc.

References art::RangeSet::forSubRun(), art::SubRunPrincipal::makeSubRun(), art::ProducingService::mc_, art::ProducingService::postReadSubRun(), and art::SubRunPrincipal::subRunID().

Referenced by art::ProducingService::registerCallbacks().

  {
    auto sr = srp.makeSubRun(mc_, RangeSet::forSubRun(srp.subRunID()));
    postReadSubRun(sr);
    sr.commitProducts();
  }

auto geo::GeometryConfigurationWriter::extractInfoFromGeometry ( )

staticprivate

Creates configuration information based on the current Geometry service.

Definition at line 168 of file GeometryConfigurationWriter_service.cc.

References makeInfoPtr(), and MF_LOG_DEBUG.

Referenced by postReadRun().

{

  sumdata::GeometryConfigurationInfo confInfo =
    art::ServiceHandle<geo::Geometry>()->configurationInfo();

  MF_LOG_DEBUG("GeometryConfigurationWriter")
    << "Geometry configuration information from service:\n"
    << confInfo;

  return makeInfoPtr(std::move(confInfo));

} // geo::GeometryConfigurationWriter::extractInfoFromGeometry()

auto geo::GeometryConfigurationWriter::loadInfo ( art::Run &  run ) const

private

Loads the geometry information from the run (either directly or legacy).

Definition at line 149 of file GeometryConfigurationWriter_service.cc.

References makeInfoFromRunData(), and readGeometryInformation().

Referenced by postReadRun().

{

  /*
   * Read geometry configuration information from the run:
   *
   * 1. first attempt to directly read information from past runs of this
   *    service
   * 2. if none is found, attempt reading legacy information and upgrade it
   * 3. if no legacy information is found either, return a null pointer
   *
   */
  InfoPtr_t info = readGeometryInformation(run);

  return info ? std::move(info) : makeInfoFromRunData(run);

} // geo::GeometryConfigurationWriter::loadInfo()

auto geo::GeometryConfigurationWriter::makeInfoFromRunData ( art::Run &  run ) const

private

Upgrades legacy sumdata::RunData in run to geometry information (returns null pointer if no legacy information is present).

Definition at line 194 of file GeometryConfigurationWriter_service.cc.

References convertRunDataToGeometryInformation(), and readRunData().

Referenced by loadInfo().

{

  sumdata::RunData const* runData = readRunData(run);

  return runData ? convertRunDataToGeometryInformation(*runData) : InfoPtr_t{};

} // geo::GeometryConfigurationWriter::makeInfoFromRunData()

static InfoPtr_t geo::GeometryConfigurationWriter::makeInfoPtr ( sumdata::GeometryConfigurationInfo const &  info )

inlinestaticprivate

Alias to std::make_unique<sumdata::GeometryConfigurationInfo>.

Definition at line 121 of file GeometryConfigurationWriter_service.cc.

Referenced by convertRunDataToGeometryInformation(), extractInfoFromGeometry(), and readGeometryInformation().

  {
    return std::make_unique<sumdata::GeometryConfigurationInfo>(info);
  }

void geo::GeometryConfigurationWriter::postReadRun ( art::Run &  run )

overrideprivatevirtual

Writes the information from the service configuration into the run.

Reimplemented from art::ProducingService.

Definition at line 137 of file GeometryConfigurationWriter_service.cc.

References extractInfoFromGeometry(), art::fullRun(), loadInfo(), and art::Run::put().

{

  InfoPtr_t confInfo = geo::GeometryConfigurationWriter::loadInfo(run);

  if (!confInfo) confInfo = extractInfoFromGeometry();

  run.put(std::move(confInfo), art::fullRun());

} // geo::GeometryConfigurationWriter::postReadRun()

auto geo::GeometryConfigurationWriter::readGeometryInformation ( art::Run &  run ) const

private

Reads geometry information from the run (returns null pointer if none).

Definition at line 183 of file GeometryConfigurationWriter_service.cc.

References makeInfoPtr().

Referenced by loadInfo().

{

  art::Handle<sumdata::GeometryConfigurationInfo> infoHandle;
  return run.getByLabel(art::InputTag{"GeometryConfigurationWriter"}, infoHandle) ?
           makeInfoPtr(*infoHandle) :
           InfoPtr_t{};

} // geo::GeometryConfigurationWriter::hasGeometryInformation()

sumdata::RunData const * geo::GeometryConfigurationWriter::readRunData ( art::Run &  run ) const

private

Returns a pointer to the sumdata::RunData in run (nullptr if none).

Definition at line 204 of file GeometryConfigurationWriter_service.cc.

References art::ProductRetriever::getMany().

Referenced by makeInfoFromRunData().

{
  //std::vector<art::Handle<sumdata::RunData>> allRunData;
  //run.getManyByType(allRunData);
  auto allRunData = run.getMany<sumdata::RunData>();
  return allRunData.empty() ? nullptr : allRunData.front().product();
} // geo::GeometryConfigurationWriter::readRunData()

void art::ProducingService::registerCallbacks ( ProducingServiceSignals &  cbReg )

inherited

Definition at line 30 of file ProducingService.cc.

References art::ProducingService::doPostReadEvent(), art::ProducingService::doPostReadRun(), art::ProducingService::doPostReadSubRun(), art::ProducingServiceSignals::sPostReadEvent, art::ProducingServiceSignals::sPostReadRun, and art::ProducingServiceSignals::sPostReadSubRun.

  {
    cbReg.sPostReadRun.watch(this, &ProducingService::doPostReadRun);
    cbReg.sPostReadSubRun.watch(this, &ProducingService::doPostReadSubRun);
    cbReg.sPostReadEvent.watch(this, &ProducingService::doPostReadEvent);
  }

void art::ProducingService::setModuleDescription ( ModuleDescription const &  md )

inherited

Definition at line 21 of file ProducingService.cc.

References art::ProducingService::mc_.

  {
    // We choose the one-argument constructor since the path
    // information is irrelevant when the doPostRead* functions are
    // invoked.
    mc_ = ModuleContext{md};
  }

Member Data Documentation

constexpr bool art::ProducingService::service_handle_allowed {false}

staticinherited

Definition at line 19 of file ProducingService.h.

---

The documentation for this class was generated from the following file:

• larcore/v09_11_01/source/larcore/Geometry/GeometryConfigurationWriter_service.cc