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 LogPlay *	Instance ()
	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]	_index	Index of the chunk.
[out]	_data	Storage 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]

_logFile

The file to load

Exceptions

Exception

When 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]

_time

Target simulation time.

Returns

True if operation succeed or false otherwise.

bool Step

(

std::string &

_data

)

Step through the open log file.

Parameters

[out]

_data

Data from next entry in the log file.

bool Step	(	const int	_step,
		std::string &	_data
	)

Step through the open log file.

Parameters

[in]	_step	Number of samples to step (forward or backwards).
[out]	_data	Data from next entry in the log file.

bool StepBack

(

std::string &

_data

)

Step through the open log file backwards.

Parameters

[out]

_data

Data from next entry in the log file.

---

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

• LogPlay.hh