Bag-info » History » Version 5
« Previous -
Version 5/12
(diff) -
Next » -
Current version
J. Moringen, 08/29/2011 12:50 AM
added introduction section
bag-info
¶
Introduction¶
The bag-info
can be used to inspect the structure and, to some extent, contents of log files. Given a log file, it displays the channels stored in the file, some information regarding timing as well as some event counts and sizes.
See bag-record for recording and bag-play for replaying events from log files.
Obtaining bag-info
¶
Binaries of the bag-info
program can be downloaded from the continuous integration server for versions 0.4 and 0.5 of the Robotics Service Bus:
After the download, the bag-info
file has to be made executable in most cases. This can be done for example by executing
chmod +x bag-info
in the download directory.
Checking Versions and Displaying Help¶
Version and help information is displayed when the --version
and --help
commandline options are specified:
./bag-info --version ./bag-info --help
The output of --help
includes a list of supported file formats.
Inspecting a File¶
When invoked with just a file name, bag-info
will display some basic information about the stored data. For example
./bag-info /tmp/nao.tide
should produce output similar to the following:
File "/tmp/nao.tide" Events: 160 Start : 2011-08-21T18:15:54.088877+02:00 End : 2011-08-21T18:16:05.445361+02:00 Channel "/nao/proprioception/" Events: 51 Start : 2011-08-21T18:15:54.932970+02:00 End : 2011-08-21T18:16:05.319996+02:00 Length: 10.387026d0 Rate : 4.909971343096666d0 Channel "/nao/audio/all/" Events: 63 Start : 2011-08-21T18:15:54.868080+02:00 End : 2011-08-21T18:16:05.445361+02:00 Length: 10.577281d0 Rate : 5.956162079838855d0 Channel "/nao/vision/top/" Events: 46 Start : 2011-08-21T18:15:54.088877+02:00 End : 2011-08-21T18:16:04.616276+02:00 Length: 10.527398999999999d0 Rate : 4.369550351421087d0
Note: the file extension ("tide" in this case) determines the used file format backend. Currently, only the TIDELog file format is supported.