HepMC3 event record library
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes
ReaderAscii Class Reference

Detailed Description

GenEvent I/O parsing for structured text files.

Examples:
class_example_write.cc, convert_example.cc, HepMC3_fileIO_example.cc, LHEF_example_cat.cc, and rootIO_example_write.cc.

Definition at line 29 of file ReaderAscii.h.

#include <ReaderAscii.h>

+ Inheritance diagram for ReaderAscii:
+ Collaboration diagram for ReaderAscii:

Public Member Functions

 ReaderAscii (const std::string &filename)
 Constructor. More...
 
 ReaderAscii (std::istream &)
 The ctor to read from stdin. More...
 
 ~ReaderAscii ()
 Destructor. More...
 
bool read_event (GenEvent &evt)
 Load event from file. More...
 
bool failed ()
 Return status of the stream. More...
 
void close ()
 Close file stream. More...
 
shared_ptr< GenRunInforun_info () const
 Get the global GenRunInfo object. More...
 

Protected Member Functions

void set_run_info (shared_ptr< GenRunInfo > run)
 Set the global GenRunInfo object. More...
 

Private Member Functions

std::string unescape (const std::string &s)
 Unsecape '\' and '
' characters in string. More...
 
Read helpers
std::pair< int, int > parse_event_information (GenEvent &evt, const char *buf)
 Parse event. More...
 
bool parse_weight_values (GenEvent &evt, const char *buf)
 Parse weight value lines. More...
 
bool parse_units (GenEvent &evt, const char *buf)
 Parse units. More...
 
bool parse_pdf_info (GenEvent &evt, const char *buf)
 Parse struct GenPdfInfo information. More...
 
bool parse_heavy_ion (GenEvent &evt, const char *buf)
 Parse struct GenHeavyIon information. More...
 
bool parse_cross_section (GenEvent &evt, const char *buf)
 Parse struct GenCrossSection information. More...
 
bool parse_vertex_information (GenEvent &evt, const char *buf)
 Parse vertex. More...
 
bool parse_particle_information (GenEvent &evt, const char *buf)
 Parse particle. More...
 
bool parse_attribute (GenEvent &evt, const char *buf)
 Parse attribute. More...
 
bool parse_run_attribute (const char *buf)
 Parse run-level attribute. More...
 
bool parse_weight_names (const char *buf)
 Parse run-level weight names. More...
 
bool parse_tool (const char *buf)
 Parse run-level tool information. More...
 

Private Attributes

std::ifstream m_file
 Input file. More...
 
std::istream * m_stream
 For ctor when reading from stdin. More...
 
bool m_isstream
 toggles usage of m_file or m_stream More...
 
std::map< std::string, shared_ptr< Attribute > > m_global_attributes
 Store attributes global to the run being written/read. More...
 
std::map< GenVertexPtr, std::set< int > > m_forward_mothers
 Temp storage for outgoing particle ids. More...
 
std::map< GenParticlePtr, int > m_forward_daughters
 Temp storage for prod vertex ids. More...
 

Constructor & Destructor Documentation

◆ ReaderAscii() [1/2]

ReaderAscii ( const std::string &  filename)

Constructor.

Definition at line 22 of file ReaderAscii.cc.

References ERROR, ReaderAscii::m_file, and Reader::set_run_info().

◆ ReaderAscii() [2/2]

ReaderAscii ( std::istream &  stream)

The ctor to read from stdin.

Definition at line 33 of file ReaderAscii.cc.

References ERROR, ReaderAscii::m_stream, and Reader::set_run_info().

◆ ~ReaderAscii()

Destructor.

Definition at line 44 of file ReaderAscii.cc.

References ReaderAscii::close(), and ReaderAscii::m_isstream.

Member Function Documentation

◆ close()

void close ( )
virtual

Close file stream.

Todo:
Implicit cast to bool = !failed()?

Implements Reader.

Examples:
class_example_write.cc, HepMC3_fileIO_example.cc, and rootIO_example_write.cc.

Definition at line 539 of file ReaderAscii.cc.

References ReaderAscii::m_file.

◆ failed()

bool failed ( )
virtual

Return status of the stream.

Todo:
No-arg version returning GenEvent?

Implements Reader.

Examples:
class_example_write.cc, HepMC3_fileIO_example.cc, and rootIO_example_write.cc.

Definition at line 537 of file ReaderAscii.cc.

References ReaderAscii::m_file, ReaderAscii::m_isstream, and ReaderAscii::m_stream.

◆ parse_attribute()

bool parse_attribute ( GenEvent evt,
const char *  buf 
)
private

Parse attribute.

Helper routine for parsing single attribute information

Parameters
[out]evtEvent that will contain parsed attribute
[in]bufLine of text that needs to be parsed

Definition at line 435 of file ReaderAscii.cc.

References GenEvent::add_attribute(), and ReaderAscii::unescape().

◆ parse_cross_section()

bool parse_cross_section ( GenEvent evt,
const char *  buf 
)
private

Parse struct GenCrossSection information.

Helper routine for parsing cross-section information

Parameters
[out]evtEvent that will be filled with unit information
[in]bufLine of text that needs to be parsed

◆ parse_event_information()

pair< int, int > parse_event_information ( GenEvent evt,
const char *  buf 
)
private

Parse event.

Helper routine for parsing event information

Parameters
[out]evtEvent that will be filled with new data
[in]bufLine of text that needs to be parsed
Returns
vertices count and particles count for verification

Definition at line 190 of file ReaderAscii.cc.

References DEBUG, GenEvent::set_event_number(), FourVector::setT(), FourVector::setX(), FourVector::setY(), FourVector::setZ(), and GenEvent::shift_position_to().

◆ parse_heavy_ion()

bool parse_heavy_ion ( GenEvent evt,
const char *  buf 
)
private

Parse struct GenHeavyIon information.

Helper routine for parsing heavy ion information

Parameters
[out]evtEvent that will be filled with unit information
[in]bufLine of text that needs to be parsed

◆ parse_particle_information()

bool parse_particle_information ( GenEvent evt,
const char *  buf 
)
private

Parse particle.

Helper routine for parsing single particle information

Parameters
[out]evtEvent that will contain parsed particle
[in]bufLine of text that needs to be parsed
Todo:
Should be an exception

Definition at line 347 of file ReaderAscii.cc.

References GenEvent::add_particle(), GenEvent::add_vertex(), DEBUG, ERROR, ReaderAscii::m_forward_daughters, GenEvent::particles(), and GenEvent::vertices().

◆ parse_pdf_info()

bool parse_pdf_info ( GenEvent evt,
const char *  buf 
)
private

Parse struct GenPdfInfo information.

Helper routine for parsing PDF information

Parameters
[out]evtEvent that will be filled with unit information
[in]bufLine of text that needs to be parsed

◆ parse_run_attribute()

bool parse_run_attribute ( const char *  buf)
private

Parse run-level attribute.

Helper routine for parsing single attribute information

Parameters
[in]bufLine of text that needs to be parsed

Definition at line 460 of file ReaderAscii.cc.

References Reader::run_info(), and ReaderAscii::unescape().

◆ parse_tool()

bool parse_tool ( const char *  buf)
private

Parse run-level tool information.

Helper routine for parsing a line with information about tools being used.

Parameters
[in]bufLine of text that needs to be parsed

Definition at line 500 of file ReaderAscii.cc.

References GenRunInfo::ToolInfo::description, GenRunInfo::ToolInfo::name, Reader::run_info(), ReaderAscii::unescape(), and GenRunInfo::ToolInfo::version.

◆ parse_units()

bool parse_units ( GenEvent evt,
const char *  buf 
)
private

Parse units.

Helper routine for parsing units information

Parameters
[out]evtEvent that will be filled with unit information
[in]bufLine of text that needs to be parsed

Definition at line 254 of file ReaderAscii.cc.

References DEBUG, Units::length_unit(), GenEvent::length_unit(), Units::momentum_unit(), GenEvent::momentum_unit(), Units::name(), and GenEvent::set_units().

◆ parse_vertex_information()

bool parse_vertex_information ( GenEvent evt,
const char *  buf 
)
private

Parse vertex.

Helper routine for parsing single event information

Parameters
[out]evtEvent that will contain parsed vertex
[in]bufLine of text that needs to be parsed

Definition at line 275 of file ReaderAscii.cc.

References GenEvent::add_vertex(), DEBUG, ReaderAscii::m_forward_mothers, and GenEvent::particles().

◆ parse_weight_names()

bool parse_weight_names ( const char *  buf)
private

Parse run-level weight names.

Helper routine for parsing a line with information about weight names.

Parameters
[in]bufLine of text that needs to be parsed

Definition at line 483 of file ReaderAscii.cc.

References Reader::run_info(), and ReaderAscii::unescape().

◆ parse_weight_values()

bool parse_weight_values ( GenEvent evt,
const char *  buf 
)
private

Parse weight value lines.

Helper routine for parsing weight value information

Parameters
[out]evtEvent whose GenWeights will be filled with weight values
[in]bufLine of text that needs to be parsed

Definition at line 237 of file ReaderAscii.cc.

References Reader::run_info(), and GenEvent::weights().

◆ read_event()

bool read_event ( GenEvent evt)
virtual

◆ run_info()

shared_ptr<GenRunInfo> run_info ( ) const
inlineinherited

Get the global GenRunInfo object.

Examples:
convert_example.cc, and LHEF_example_cat.cc.

Definition at line 39 of file Reader.h.

References Reader::m_run_info.

◆ set_run_info()

void set_run_info ( shared_ptr< GenRunInfo run)
inlineprotectedinherited

Set the global GenRunInfo object.

Definition at line 46 of file Reader.h.

References Reader::m_run_info.

◆ unescape()

string unescape ( const std::string &  s)
private

Unsecape '\' and '
' characters in string.

Definition at line 520 of file ReaderAscii.cc.

Field Documentation

◆ m_file

std::ifstream m_file
private

Input file.

Definition at line 155 of file ReaderAscii.h.

◆ m_forward_daughters

std::map<GenParticlePtr, int > m_forward_daughters
private

Temp storage for prod vertex ids.

Definition at line 166 of file ReaderAscii.h.

◆ m_forward_mothers

std::map<GenVertexPtr, std::set<int> > m_forward_mothers
private

Temp storage for outgoing particle ids.

Definition at line 164 of file ReaderAscii.h.

◆ m_global_attributes

std::map< std::string, shared_ptr<Attribute> > m_global_attributes
private

Store attributes global to the run being written/read.

Definition at line 161 of file ReaderAscii.h.

◆ m_isstream

bool m_isstream
private

toggles usage of m_file or m_stream

Definition at line 157 of file ReaderAscii.h.

◆ m_stream

std::istream* m_stream
private

For ctor when reading from stdin.

Definition at line 156 of file ReaderAscii.h.


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