HepMC3 event record library
|
GenEvent I/O serialization for structured text files.
Definition at line 25 of file WriterAscii.h.
#include <WriterAscii.h>
Public Member Functions | |
WriterAscii (const std::string &filename, shared_ptr< GenRunInfo > run=shared_ptr< GenRunInfo >()) | |
Constructor. More... | |
WriterAscii (std::ostream &stream, shared_ptr< GenRunInfo > run=shared_ptr< GenRunInfo >()) | |
Constructor from ostream. More... | |
~WriterAscii () | |
Destructor. More... | |
void | write_event (const GenEvent &evt) |
Write event to file. More... | |
void | write_run_info () |
Write the GenRunInfo object to file. More... | |
bool | failed () |
Return status of the stream. More... | |
void | close () |
Close file stream. More... | |
void | set_precision (const int &prec) |
Set output precision. More... | |
int | precision () const |
Return output precision. More... | |
void | set_run_info (shared_ptr< GenRunInfo > run) |
Set the global GenRunInfo object. More... | |
shared_ptr< GenRunInfo > | run_info () const |
Get the global GenRunInfo object. More... | |
Private Member Functions | |
Buffer management | |
void | allocate_buffer () |
Attempts to allocate buffer of the chosen size. More... | |
void | set_buffer_size (const size_t &size) |
Set buffer size (in bytes) More... | |
std::string | escape (const std::string &s) const |
Escape '\' and ' ' characters in string. More... | |
void | flush () |
Inline function flushing buffer to output stream when close to buffer capacity. More... | |
void | forced_flush () |
Inline function forcing flush to the output stream. More... | |
Write helpers | |
void | write_string (const std::string &str) |
Inline function for writing strings. More... | |
void | write_vertex (ConstGenVertexPtr v) |
Write vertex. More... | |
void | write_particle (ConstGenParticlePtr p, int second_field) |
Write particle. More... | |
Private Attributes | |
std::ofstream | m_file |
Output file. More... | |
std::ostream * | m_stream |
Output stream. More... | |
int | m_precision |
Output precision. More... | |
char * | m_buffer |
Stream buffer. More... | |
char * | m_cursor |
Cursor inside stream buffer. More... | |
unsigned long | m_buffer_size |
Buffer size. More... | |
WriterAscii | ( | const std::string & | filename, |
shared_ptr< GenRunInfo > | run = shared_ptr<GenRunInfo>() |
||
) |
Constructor.
Definition at line 22 of file WriterAscii.cc.
References ERROR, WriterAscii::m_file, Writer::run_info(), Writer::set_run_info(), HepMC3::version(), and WriterAscii::write_run_info().
WriterAscii | ( | std::ostream & | stream, |
shared_ptr< GenRunInfo > | run = shared_ptr<GenRunInfo>() |
||
) |
Constructor from ostream.
Definition at line 41 of file WriterAscii.cc.
References Writer::run_info(), Writer::set_run_info(), HepMC3::version(), and WriterAscii::write_run_info().
~WriterAscii | ( | ) |
Destructor.
Definition at line 57 of file WriterAscii.cc.
References WriterAscii::close(), and WriterAscii::m_buffer.
|
private |
Attempts to allocate buffer of the chosen size.
This function can be called manually by the user or will be called before first read/write operation
Definition at line 170 of file WriterAscii.cc.
References ERROR, WriterAscii::m_buffer, WriterAscii::m_buffer_size, WriterAscii::m_cursor, and WARNING.
|
virtual |
Close file stream.
Implements Writer.
Definition at line 349 of file WriterAscii.cc.
References WriterAscii::forced_flush(), and WriterAscii::m_stream.
|
private |
Escape '\' and '
' characters in string.
Definition at line 190 of file WriterAscii.cc.
|
inlinevirtual |
Return status of the stream.
Implements Writer.
Definition at line 49 of file WriterAscii.h.
References WriterAscii::close(), and WriterAscii::m_file.
|
inlineprivate |
Inline function flushing buffer to output stream when close to buffer capacity.
Definition at line 242 of file WriterAscii.cc.
References WriterAscii::m_buffer, WriterAscii::m_buffer_size, WriterAscii::m_cursor, and WriterAscii::m_stream.
|
inlineprivate |
Inline function forcing flush to the output stream.
Definition at line 255 of file WriterAscii.cc.
References WriterAscii::m_buffer, WriterAscii::m_cursor, and WriterAscii::m_stream.
|
inline |
Return output precision.
Definition at line 62 of file WriterAscii.h.
References WriterAscii::allocate_buffer(), and WriterAscii::m_precision.
|
inlineinherited |
Get the global GenRunInfo object.
Definition at line 42 of file Writer.h.
References Writer::m_run_info.
|
inlineprivate |
Set buffer size (in bytes)
Default is 256kb. Minimum is 256b. Size can only be changed before first read/write operation.
Definition at line 83 of file WriterAscii.h.
References WriterAscii::escape(), WriterAscii::flush(), WriterAscii::forced_flush(), WriterAscii::m_buffer, WriterAscii::m_buffer_size, WriterAscii::write_particle(), WriterAscii::write_string(), and WriterAscii::write_vertex().
|
inline |
Set output precision.
So far available range is [2,24]. Default is 16.
Definition at line 57 of file WriterAscii.h.
References WriterAscii::m_precision.
|
inlineinherited |
Set the global GenRunInfo object.
Definition at line 37 of file Writer.h.
References Writer::m_run_info.
|
virtual |
Write event to file.
[in] | evt | Event to be serialized |
Implements Writer.
Definition at line 63 of file WriterAscii.cc.
References WriterAscii::allocate_buffer(), GenEvent::attributes(), WriterAscii::escape(), GenEvent::event_number(), GenEvent::event_pos(), WriterAscii::flush(), WriterAscii::forced_flush(), FourVector::is_zero(), GenEvent::length_unit(), WriterAscii::m_buffer, WriterAscii::m_cursor, WriterAscii::m_precision, GenEvent::momentum_unit(), Units::name(), GenEvent::particles(), Writer::run_info(), GenEvent::run_info(), Writer::set_run_info(), FourVector::t(), GenEvent::vertices(), WARNING, GenEvent::weights(), WriterAscii::write_particle(), WriterAscii::write_run_info(), WriterAscii::write_string(), WriterAscii::write_vertex(), FourVector::x(), FourVector::y(), and FourVector::z().
|
private |
Write particle.
Helper routine for writing single particle to file
Definition at line 306 of file WriterAscii.cc.
References WriterAscii::flush(), WriterAscii::m_cursor, and WriterAscii::m_precision.
void write_run_info | ( | ) |
Write the GenRunInfo object to file.
Definition at line 262 of file WriterAscii.cc.
References WriterAscii::allocate_buffer(), WriterAscii::escape(), WriterAscii::flush(), WriterAscii::m_cursor, Writer::run_info(), Writer::set_run_info(), WARNING, and WriterAscii::write_string().
|
inlineprivate |
Inline function for writing strings.
Since strings can be long (maybe even longer than buffer) they have to be dealt with separately.
Definition at line 330 of file WriterAscii.cc.
References WriterAscii::flush(), WriterAscii::forced_flush(), WriterAscii::m_buffer, WriterAscii::m_buffer_size, WriterAscii::m_cursor, and WriterAscii::m_stream.
|
private |
Write vertex.
Helper routine for writing single vertex to file
Definition at line 203 of file WriterAscii.cc.
References WriterAscii::flush(), FourVector::is_zero(), WriterAscii::m_cursor, WriterAscii::m_precision, FourVector::t(), FourVector::x(), FourVector::y(), and FourVector::z().
|
private |
Stream buffer.
Definition at line 128 of file WriterAscii.h.
|
private |
Buffer size.
Definition at line 130 of file WriterAscii.h.
|
private |
Cursor inside stream buffer.
Definition at line 129 of file WriterAscii.h.
|
private |
Output file.
Definition at line 124 of file WriterAscii.h.
|
private |
Output precision.
Definition at line 127 of file WriterAscii.h.
|
private |
Output stream.
Definition at line 125 of file WriterAscii.h.