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

GenEvent I/O parsing for structured text files. More...

#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 skip (const int) override
 skip events More...
 
bool read_event (GenEvent &evt) override
 Load event from file. More...
 
bool failed () override
 Return status of the stream. More...
 
void close () override
 Close file stream. More...
 
std::shared_ptr< GenRunInforun_info () const
 Get the global GenRunInfo object. More...
 
void set_options (const std::map< std::string, std::string > &options)
 Set options. More...
 
std::map< std::string,
std::string > 
get_options () const
 Set options. More...
 

Protected Member Functions

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

Protected Attributes

std::map< std::string,
std::string > 
m_options
 options 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,
std::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...
 

Detailed Description

GenEvent I/O parsing for structured text files.

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

Definition at line 29 of file ReaderAscii.h.

Constructor & Destructor Documentation

ReaderAscii ( const std::string &  filename)

Constructor.

Definition at line 22 of file ReaderAscii.cc.

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

ReaderAscii ( std::istream &  stream)

The ctor to read from stdin.

Definition at line 33 of file ReaderAscii.cc.

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

Destructor.

Definition at line 44 of file ReaderAscii.cc.

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

Member Function Documentation

void close ( )
overridevirtual

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 555 of file ReaderAscii.cc.

References ReaderAscii::m_file.

bool failed ( )
overridevirtual

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 553 of file ReaderAscii.cc.

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

std::map<std::string, std::string> get_options ( ) const
inlineinherited

Set options.

Definition at line 58 of file Reader.h.

References Reader::m_options.

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 451 of file ReaderAscii.cc.

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

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
std::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 206 of file ReaderAscii.cc.

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

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
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 363 of file ReaderAscii.cc.

References GenEvent::add_particle(), GenEvent::add_vertex(), HEPMC3_DEBUG, HEPMC3_ERROR, ReaderAscii::m_forward_daughters, GenEvent::particles(), and GenEvent::vertices().

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
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 476 of file ReaderAscii.cc.

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

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 516 of file ReaderAscii.cc.

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

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 270 of file ReaderAscii.cc.

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

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 291 of file ReaderAscii.cc.

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

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 499 of file ReaderAscii.cc.

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

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 253 of file ReaderAscii.cc.

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

bool read_event ( GenEvent evt)
overridevirtual
std::shared_ptr<GenRunInfo> run_info ( ) const
inlineinherited

Get the global GenRunInfo object.

Examples:
LHEF_example_cat.cc.

Definition at line 44 of file Reader.h.

References Reader::m_run_info.

void set_options ( const std::map< std::string, std::string > &  options)
inlineinherited

Set options.

Definition at line 53 of file Reader.h.

References Reader::m_options.

void set_run_info ( std::shared_ptr< GenRunInfo run)
inlineprotectedinherited

Set the global GenRunInfo object.

Definition at line 64 of file Reader.h.

References Reader::m_run_info.

bool skip ( const int  n)
overridevirtual

skip events

Reimplemented from Reader.

Definition at line 46 of file ReaderAscii.cc.

References ReaderAscii::failed(), ReaderAscii::m_file, ReaderAscii::m_isstream, and ReaderAscii::m_stream.

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

Unsecape '\' and '
' characters in string.

Definition at line 536 of file ReaderAscii.cc.

Field Documentation

std::ifstream m_file
private

Input file.

Definition at line 156 of file ReaderAscii.h.

std::map<GenParticlePtr, int > m_forward_daughters
private

Temp storage for prod vertex ids.

Definition at line 167 of file ReaderAscii.h.

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

Temp storage for outgoing particle ids.

Definition at line 165 of file ReaderAscii.h.

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

Store attributes global to the run being written/read.

Definition at line 162 of file ReaderAscii.h.

bool m_isstream
private

toggles usage of m_file or m_stream

Definition at line 158 of file ReaderAscii.h.

std::map<std::string, std::string> m_options
protectedinherited

options

Definition at line 68 of file Reader.h.

std::istream* m_stream
private

For ctor when reading from stdin.

Definition at line 157 of file ReaderAscii.h.


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