HepMcReaderTool Class Reference

#include <HepMcReaderTool.h>

Inheritance diagram for HepMcReaderTool:

Collaboration diagram for HepMcReaderTool:

Public Member Functions
	HepMcReaderTool (const std::string &type, const std::string &name, const IInterface *parent)
	Constructor with parameters:
virtual	~HepMcReaderTool ()
	Destructor:
StatusCode	initialize ()
	Athena Algorithm's Hooks.
StatusCode	execute ()
StatusCode	finalize ()
StatusCode	read (HepMC::GenEvent *evt)
	Process the HepMC::GenEvent through the I/O frontend.

Protected Member Functions
	HepMcReaderTool ()
	Default constructor:
void	setupFrontend (Gaudi::Details::PropertyBase &ioFrontendURL)
	Method to configure the front-end to read out the HepMC::GenEvent.

Protected Attributes
StringProperty	m_ioFrontendURL
	URL of the I/O front-end (only "ASCII" for now...) glued with the name of the input file name.
StringProperty	m_mcEventsOutputName
	Location of the McEventCollection to be read out.
HepMC::IO_BaseClass *	m_ioFrontend
	Abstract base class for the back-end.

Detailed Description

Definition at line 30 of file HepMcReaderTool.h.

Constructor & Destructor Documentation

HepMcReaderTool() [1/2]

HepMcReaderTool::HepMcReaderTool	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent )

Constructor with parameters:

Public methods:

Constructors

Definition at line 33 of file HepMcReaderTool.cxx.

                                             : 
  base_class( type, name, parent ),
  m_ioFrontend( nullptr )
{
  //
  // Property declaration
  // 
 
  declareProperty( "Input", 
           m_ioFrontendURL = "ascii:hepmc.genevent.txt", 
           "Name of the front-end we'll use to read in the HepMC::GenEvent."
           "\nEx: ascii:hepmc.genevent.txt" );
  m_ioFrontendURL.declareUpdateHandler( &HepMcReaderTool::setupFrontend,
                    this );
 
  declareProperty( "McEventsOutput",
           m_mcEventsOutputName = "GEN_EVENT",
           "Output location of the McEventCollection to read out" );
}

~HepMcReaderTool()

HepMcReaderTool::~HepMcReaderTool ( )

virtual

Destructor:

Destructor.

Definition at line 57 of file HepMcReaderTool.cxx.

{ 
  ATH_MSG_DEBUG("Calling destructor");
 
  delete m_ioFrontend;
  m_ioFrontend = nullptr;
}

HepMcReaderTool() [2/2]

HepMcReaderTool::HepMcReaderTool ( )

protected

Default constructor:

Member Function Documentation

execute()

StatusCode HepMcReaderTool::execute

(

)

Definition at line 90 of file HepMcReaderTool.cxx.

{
  // create a new McEventCollection and put it into StoreGate
  McEventCollection * mcEvts = new McEventCollection;
  if ( evtStore()->record( mcEvts, m_mcEventsOutputName ).isFailure() ) {
    ATH_MSG_ERROR("Could not record a McEventCollection at ["<< m_mcEventsOutputName << "] !!");
    return StatusCode::FAILURE;
  }
  
  if ( evtStore()->setConst( mcEvts ).isFailure() ) {
    ATH_MSG_WARNING("Could not setConst McEventCollection at ["<< m_mcEventsOutputName << "] !!");
  }
 
  HepMC::GenEvent * evt = new HepMC::GenEvent;
  mcEvts->push_back(evt);
 
  return read(evt);
}

finalize()

StatusCode HepMcReaderTool::finalize

(

)

Definition at line 84 of file HepMcReaderTool.cxx.

{
  ATH_MSG_INFO("Finalizing " << name() << "...");
  return StatusCode::SUCCESS;
}

initialize()

StatusCode HepMcReaderTool::initialize

(

)

Athena Algorithm's Hooks.

Definition at line 67 of file HepMcReaderTool.cxx.

{
  ATH_MSG_INFO("Initializing " << name() << "...");
  // Get pointer to StoreGateSvc and cache it :
  if ( !evtStore().retrieve().isSuccess() ) {
    ATH_MSG_ERROR("Unable to retrieve pointer to StoreGateSvc");
    return StatusCode::FAILURE;
  }
 
  // setup frontend
  if ( nullptr == m_ioFrontend ) {
    setupFrontend(m_ioFrontendURL);
  }
 
  return StatusCode::SUCCESS;
}

read()

StatusCode HepMcReaderTool::read

(

HepMC::GenEvent *

evt

)

Process the HepMC::GenEvent through the I/O frontend.

Non-const methods:

Definition at line 113 of file HepMcReaderTool.cxx.

{
#ifdef HEPMC3
  m_ioFrontend->read_event(*evt);
#else
  m_ioFrontend->fill_next_event(evt);
#endif
 
  return StatusCode::SUCCESS;
}

setupFrontend()

void HepMcReaderTool::setupFrontend ( Gaudi::Details::PropertyBase & ioFrontendURL )

protected

Method to configure the front-end to read out the HepMC::GenEvent.

Definition at line 124 of file HepMcReaderTool.cxx.

{
  // defaults
  std::string protocol = "ascii";
  std::string fileName = "hepmc.genevent.txt";
 
  // reset internal state
  if ( m_ioFrontend ) {
    delete m_ioFrontend;
    m_ioFrontend = nullptr;
  }
 
  // caching URL
  const std::string& url = m_ioFrontendURL.value();
  
  std::string::size_type protocolPos = url.find(s_protocolSep);
 
  if ( std::string::npos != protocolPos ) {
    protocol = url.substr( 0, protocolPos );
    fileName = url.substr( protocolPos+1, std::string::npos );
  } else {
    //protocol = "ascii";
    fileName = url;
  }
 
  // get the protocol name in lower cases
  std::transform( protocol.begin(), protocol.end(), protocol.begin(), [](unsigned char c){ return std::tolower(c); } );
 
#ifdef HEPMC3
  if ( "ascii" == protocol ) {
    m_ioFrontend = new HepMC3::ReaderAsciiHepMC2( fileName.c_str());
 
  } else {
    msg(MSG::WARNING) << "UNKNOWN protocol [" << protocol << "] !!" << endmsg<< "Will use [ascii] instead..."<< endmsg;
    protocol = "ascii";
    m_ioFrontend = new HepMC3::ReaderAsciiHepMC2( fileName.c_str());
  }    
#else 
  if ( "ascii" == protocol ) {
    m_ioFrontend = new HepMC::IO_GenEvent( fileName.c_str(), std::ios::in );
 
  } else {
    msg(MSG::WARNING) << "UNKNOWN protocol [" << protocol << "] !!" << endmsg << "Will use [ascii] instead..."<< endmsg;
    protocol = "ascii";
    m_ioFrontend = new HepMC::IO_GenEvent( fileName.c_str(), std::ios::in );
  }    
#endif
 
  ATH_MSG_DEBUG("Using protocol [" << protocol << "] and write to ["<< fileName << "]");
}

Member Data Documentation

m_ioFrontend

HepMC::IO_BaseClass* HepMcReaderTool::m_ioFrontend

protected

Abstract base class for the back-end.

Definition at line 94 of file HepMcReaderTool.h.

m_ioFrontendURL

StringProperty HepMcReaderTool::m_ioFrontendURL

protected

URL of the I/O front-end (only "ASCII" for now...) glued with the name of the input file name.

Ex: "ascii:/home/foo/hepmc.txt" If no protocol separator ':' is found, fallback is "ASCII"

Definition at line 83 of file HepMcReaderTool.h.

m_mcEventsOutputName

StringProperty HepMcReaderTool::m_mcEventsOutputName

protected

Location of the McEventCollection to be read out.

Definition at line 87 of file HepMcReaderTool.h.

---

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

• HepMcReaderTool.h
• HepMcReaderTool.cxx