LogPlay Class Reference

#include <LogPlay.hh>

Inherits SingletonT< LogPlay >.

Public Member Functions

bool Chunk (const unsigned int _index, std::string &_data) const
 Get data for a particular chunk index. More...
 
unsigned int ChunkCount () const
 Get the number of chunks (steps) in the open log file. More...
 
std::string Encoding () const
 Get the type of encoding used for current chunck in the open log file. More...
 
std::string Filename () const
 Get the name of the log file. More...
 
uintmax_t FileSize () const
 Get the size of the log file. More...
 
bool Forward ()
 Jump to the end of the log file. More...
 
std::string FullPathFilename () const
 Get the full path of the log file. More...
 
std::string GazeboVersion () const
 Get the Gazebo version number of the open log file. More...
 
bool HasIterations () const
 Return if the log file contains the <iterations> tag. More...
 
std::string Header () const
 Get the header that was read from a log file. More...
 
uint64_t InitialIterations () const
 Get the initial simulation iterations from a log file. More...
 
bool IsOpen () const
 Return true if a file is open. More...
 
common::Time LogEndTime () const
 Get the log end time of the open log file. More...
 
common::Time LogStartTime () const
 Get the log start time of the open log file. More...
 
std::string LogVersion () const
 Get the log version number of the open log file. More...
 
void Open (const std::string &_logFile)
 Open a log file for reading. More...
 
uint32_t RandSeed () const
 Get the random number seed of the open log file. More...
 
bool Rewind ()
 Jump to the beginning of the log file. More...
 
bool Seek (const common::Time &_time)
 Jump to the closest sample that has its simulation time lower than the time specified as a parameter. More...
 
bool Step (std::string &_data)
 Step through the open log file. More...
 
bool Step (const int _step, std::string &_data)
 Step through the open log file. More...
 
bool StepBack (std::string &_data)
 Step through the open log file backwards. More...
 

Static Public Member Functions

static LogPlayInstance ()
 Get an instance of the singleton. More...
 

Member Function Documentation

bool Chunk ( const unsigned int  _index,
std::string &  _data 
) const

Get data for a particular chunk index.

Parameters
[in]_indexIndex of the chunk.
[out]_dataStorage for the chunk's data.
Returns
True if the _index was valid.
unsigned int ChunkCount ( ) const

Get the number of chunks (steps) in the open log file.

Returns
The number of recorded states in the log file.
std::string Encoding ( ) const

Get the type of encoding used for current chunck in the open log file.

Returns
The type of encoding. An empty string will be returned if LogPlay::Step has not been called at least once.
std::string Filename ( ) const

Get the name of the log file.

Returns
The filename.
uintmax_t FileSize ( ) const

Get the size of the log file.

Returns
The size of the file in bytes.
bool Forward ( )

Jump to the end of the log file.

Returns
True If the function succeed or false otherwise.
std::string FullPathFilename ( ) const

Get the full path of the log file.

Returns
The full path of the log file.
std::string GazeboVersion ( ) const

Get the Gazebo version number of the open log file.

Returns
The Gazebo version of the open log file. Empty string if a log file is not open.
bool HasIterations ( ) const

Return if the log file contains the <iterations> tag.

Old log files may not have the <iterations> tag.

Returns
True if <iterations> was found in the log file or false otherwise.
std::string Header ( ) const

Get the header that was read from a log file.

Should call LogPlay::Open first.

Returns
Header of the open log file.
uint64_t InitialIterations ( ) const

Get the initial simulation iterations from a log file.

Returns
Initial simulation iteration contained in the log file.
static LogPlay * Instance ( )
inlinestaticinherited

Get an instance of the singleton.

bool IsOpen ( ) const

Return true if a file is open.

Returns
True if a log file is open.
common::Time LogEndTime ( ) const

Get the log end time of the open log file.

Returns
End time of the log.
common::Time LogStartTime ( ) const

Get the log start time of the open log file.

Returns
Start time of the log.
std::string LogVersion ( ) const

Get the log version number of the open log file.

Returns
The log version of the open log file. Empty string if a log file is not open.
void Open ( const std::string &  _logFile)

Open a log file for reading.

Open a log file that was previously recorded.

Parameters
[in]_logFileThe file to load
Exceptions
ExceptionWhen the log file does not exist, is a directory instead of a regular file, or Gazebo was unable to parse it.
uint32_t RandSeed ( ) const

Get the random number seed of the open log file.

Returns
The random number seed the open log file. The current random number seed, as defined in ignition::math::Rand::Seed.
bool Rewind ( )

Jump to the beginning of the log file.

The next step() call will return the first data "chunk".

Returns
True If the function succeed or false otherwise.
bool Seek ( const common::Time _time)

Jump to the closest sample that has its simulation time lower than the time specified as a parameter.

Parameters
[in]_timeTarget simulation time.
Returns
True if operation succeed or false otherwise.
bool Step ( std::string &  _data)

Step through the open log file.

Parameters
[out]_dataData from next entry in the log file.
bool Step ( const int  _step,
std::string &  _data 
)

Step through the open log file.

Parameters
[in]_stepNumber of samples to step (forward or backwards).
[out]_dataData from next entry in the log file.
bool StepBack ( std::string &  _data)

Step through the open log file backwards.

Parameters
[out]_dataData from next entry in the log file.

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