geo::AuxDetGeometry Class Reference

The geometry of one entire detector, as served by art. More...

#include "AuxDetGeometry.h"

Public Member Functions
	AuxDetGeometry (fhicl::ParameterSet const &pset, art::ActivityRegistry &reg)
void	preBeginRun (art::Run const &run)
	Updates the geometry if needed at the beginning of each new run. More...
AuxDetGeometryCore const &	GetProvider () const
	Returns a constant reference to the service provider. More...
AuxDetGeometryCore const *	GetProviderPtr () const
	Returns a constant pointer to the service provider. More...

Private Member Functions
void	LoadNewGeometry (std::string gdmlfile, std::string rootfile)
	Expands the provided paths and loads the geometry description(s) More...
void	InitializeChannelMap ()
AuxDetGeometryCore &	GetProvider ()
	Returns a reference to the service provider. More...
AuxDetGeometryCore *	GetProviderPtr ()
	Returns a pointer to the service provider. More...

Private Attributes
AuxDetGeometryCore	fProvider
	the actual service provider More...
std::string	fRelPath
bool	fForceUseFCLOnly
fhicl::ParameterSet	fSortingParameters
	Parameter set to define the channel map sorting. More...

Detailed Description

The geometry of one entire detector, as served by art.

This class extends the interface of the geometry service provider, GeometryCore, to the one of an art service. It handles the correct initialization of the provider using information

It relies on geo::ExptGeoHelperInterface service to obtain the channel mapping algorithm proper for the selected geometry.

The geometry initialization happens immediately on construction. Optionally, the geometry is automatically reinitialized on each run based on the information contained in the art::Run object.

Configuration

In addition to the parameters documented in geo::GeometryCore, the following parameters are supported:

• RelativePath (string, default: no path): this path is prepended to the geometry file names before searching from them; the path string does not affect the file name
• GDML (string, mandatory): path of the GDML file to be served to Geant4 for detector simulation. The full file is composed out of the optional relative path specified by RelativePath path and the base name specified in GDML parameter; this path is searched for in the directories configured in the FW_SEARCH_PATH environment variable;
• ROOT (string, mandatory): currently overridden by GDML parameter, whose value is used instead; this path is assembled in the same way as the one for GDML parameter, except that no alternative (wireless) geometry is used even if DisableWiresInG4 is specified (see below); this file is used to load the geometry used in the internal simulation and reconstruction, basically everywhere except for the Geant4 simulation
• DisableWiresInG4 (boolean, default: false): if true, Geant4 is loaded with an alternative geometry from a file with the standard name as configured with the /GDML/ parameter, but with an additional "_nowires" appended before the ".gdml" suffix
• ForceUseFCLOnly (boolean, default: false): information on the current geometry is stored in each run by the event generator producers; if this information does not describe the current geometry, a new geometry is loaded according to the information in the run. If ForceUseFCLOnly is set to true, this mechanism is disabled and the geometry is just loaded at the beginning of the job from the information in the job configuration, once and for all.
• SortingParameters (a parameter set; default: empty): this configuration is directly passed to the channel mapping algorithm (see geo::ChannelMapAlg); its content is dependent on the chosen implementation of ChannelMapAlg

Note

Currently, the file defined by GDML parameter is also served to ROOT for the internal geometry representation.

Definition at line 97 of file AuxDetGeometry.h.

Constructor & Destructor Documentation

geo::AuxDetGeometry::AuxDetGeometry	(	fhicl::ParameterSet const &	pset,
		art::ActivityRegistry &	reg
	)

Definition at line 31 of file AuxDetGeometry_service.cc.

References fRelPath, fhicl::ParameterSet::get(), LoadNewGeometry(), preBeginRun(), and art::ActivityRegistry::sPreBeginRun.

    : fProvider         (pset)
    , fRelPath          (pset.get< std::string       >("RelativePath",      ""   ))
    , fForceUseFCLOnly  (pset.get< bool              >("ForceUseFCLOnly" ,  false))
    , fSortingParameters(pset.get<fhicl::ParameterSet>("SortingParameters", fhicl::ParameterSet() ))
  {
    // add a final directory separator ("/") to fRelPath if not already there
    if (!fRelPath.empty() && (fRelPath.back() != '/')) fRelPath += '/';
    
    // register a callback to be executed when a new run starts
    reg.sPreBeginRun.watch(this, &AuxDetGeometry::preBeginRun);
    
    //......................................................................
    // 5.15.12 BJR: use the gdml file for both the fGDMLFile and fROOTFile
    // variables as ROOT v5.30.06 is once again able to read in gdml files
    // during batch operation, in this case think of fROOTFile meaning the
    // file used to make the ROOT TGeoManager.  I don't want to remove
    // the separate variables in case ROOT breaks again
    std::string GDMLFileName = pset.get<std::string>("GDML");
    std::string ROOTFileName = pset.get<std::string>("GDML");
    
    // load the geometry
    LoadNewGeometry(GDMLFileName, ROOTFileName);
    
  } // Geometry::Geometry()

Member Function Documentation

AuxDetGeometryCore const& geo::AuxDetGeometry::GetProvider ( ) const

inline

Returns a constant reference to the service provider.

Definition at line 107 of file AuxDetGeometry.h.

References fProvider.

Referenced by GetProviderPtr(), InitializeChannelMap(), LoadNewGeometry(), and preBeginRun().

{ return fProvider; }

AuxDetGeometryCore& geo::AuxDetGeometry::GetProvider ( )

inlineprivate

Returns a reference to the service provider.

Definition at line 120 of file AuxDetGeometry.h.

References fProvider.

{ return fProvider; }

AuxDetGeometryCore const* geo::AuxDetGeometry::GetProviderPtr ( ) const

inline

Returns a constant pointer to the service provider.

Definition at line 110 of file AuxDetGeometry.h.

References GetProvider(), InitializeChannelMap(), and LoadNewGeometry().

Referenced by InitializeChannelMap().

{ return &GetProvider(); }

AuxDetGeometryCore* geo::AuxDetGeometry::GetProviderPtr ( )

inlineprivate

Returns a pointer to the service provider.

Definition at line 123 of file AuxDetGeometry.h.

References GetProvider().

{ return &GetProvider(); }

void geo::AuxDetGeometry::InitializeChannelMap ( )

private

Definition at line 94 of file AuxDetGeometry_service.cc.

References fSortingParameters, GetProvider(), GetProviderPtr(), and geo::AuxDetGeometryCore::hasAuxDetChannelMap().

Referenced by GetProviderPtr(), and LoadNewGeometry().

  {
    // the channel map is responsible of calling the channel map configuration
    // of the geometry
    art::ServiceHandle<geo::AuxDetExptGeoHelperInterface>()->ConfigureAuxDetChannelMapAlg(fSortingParameters, GetProviderPtr());
    
    if ( ! GetProvider().hasAuxDetChannelMap() ) {
      throw cet::exception("ChannelMapLoadFail") << " failed to load new channel map";
    }
    
  } // Geometry::InitializeChannelMap()

void geo::AuxDetGeometry::LoadNewGeometry ( std::string  gdmlfile, std::string  rootfile  )

private

Expands the provided paths and loads the geometry description(s)

Definition at line 107 of file AuxDetGeometry_service.cc.

References DEFINE_ART_SERVICE, fRelPath, GetProvider(), InitializeChannelMap(), and geo::AuxDetGeometryCore::LoadGeometryFile().

Referenced by AuxDetGeometry(), GetProviderPtr(), and preBeginRun().

  {
    // start with the relative path
    std::string GDMLFileName(fRelPath), ROOTFileName(fRelPath);
    
    // add the base file names
    ROOTFileName.append(gdmlfile); // not rootfile (why?)
    GDMLFileName.append(gdmlfile);
    
    // Search all reasonable locations for the GDML file that contains
    // the detector geometry.
    // cet::search_path constructor decides if initialized value is a path
    // or an environment variable
    cet::search_path sp("FW_SEARCH_PATH");
    
    std::string GDMLfile;
    if( !sp.find_file(GDMLFileName, GDMLfile) ) {
      throw cet::exception("AuxDetGeometry") << "cannot find the gdml geometry file:" 
                                             << "\n" << GDMLFileName
                                             << "\nbail ungracefully.\n";
    }
    
    std::string ROOTfile;
    if( !sp.find_file(ROOTFileName, ROOTfile) ) {
      throw cet::exception("AuxDetGeometry") << "cannot find the root geometry file:\n"
                                             << "\n" << ROOTFileName
                                             << "\nbail ungracefully.\n";
    }
    
    // initialize the geometry with the files we have found
    GetProvider().LoadGeometryFile(GDMLfile, ROOTfile);
    
    // now update the channel map
    InitializeChannelMap();
    
  } // Geometry::LoadNewGeometry()

void geo::AuxDetGeometry::preBeginRun

(

art::Run const &

run

)

Updates the geometry if needed at the beginning of each new run.

Definition at line 58 of file AuxDetGeometry_service.cc.

References fForceUseFCLOnly, art::DataViewImpl::getManyByType(), GetProvider(), and LoadNewGeometry().

Referenced by AuxDetGeometry().

  {
    // FIXME this seems utterly wrong: constructor loads geometry based on an
    // explicit parameter, whereas here we load it by detector name
    
    // if we are requested to stick to the configured geometry, do nothing
    if (fForceUseFCLOnly) return;
    
    // check here to see if we need to load a new geometry.
    // get the detector id from the run object
    std::vector< art::Handle<sumdata::RunData> > rdcol;
    run.getManyByType(rdcol);
    if (rdcol.empty()) {
      mf::LogWarning("LoadNewGeometry") << "cannot find sumdata::RunData object to grab detector name\n" 
                                        << "this is expected if generating MC files\n"
                                        << "using default geometry from configuration file\n";
      return;
    }
    
    // if the detector name is still the same, everything is fine
    std::string newDetectorName = rdcol.front()->DetName();
    if (GetProvider().DetectorName() == newDetectorName) return;
    
    // else {
    //   // the detector name is specified in the RunData object
    //   SetDetectorName(newDetectorName);
    // }
    
    LoadNewGeometry(
      GetProvider().DetectorName() + ".gdml",
      GetProvider().DetectorName() + ".gdml"
      );
  } // Geometry::preBeginRun()

Member Data Documentation

bool geo::AuxDetGeometry::fForceUseFCLOnly

private

Force Geometry to only use the geometry files specified in the fcl file

Definition at line 130 of file AuxDetGeometry.h.

Referenced by preBeginRun().

AuxDetGeometryCore geo::AuxDetGeometry::fProvider

private

the actual service provider

Definition at line 126 of file AuxDetGeometry.h.

Referenced by GetProvider().

std::string geo::AuxDetGeometry::fRelPath

private

Relative path added to FW_SEARCH_PATH to search for geometry file

Definition at line 128 of file AuxDetGeometry.h.

Referenced by AuxDetGeometry(), and LoadNewGeometry().

fhicl::ParameterSet geo::AuxDetGeometry::fSortingParameters

private

Parameter set to define the channel map sorting.

Definition at line 132 of file AuxDetGeometry.h.

Referenced by InitializeChannelMap().

---

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

• larcore/v06_21_02/source/larcore/Geometry/AuxDetGeometry.h
• larcore/v06_21_02/source/larcore/Geometry/AuxDetGeometry_service.cc