Bag-record » History » Version 4

Version 3 (J. Moringen, 08/24/2011 10:49 PM) → Version 4/15 (J. Moringen, 08/24/2011 10:50 PM)

h1. @bag-record@

h2. Obtaining @bag-record@

Binaries of the @bag-record@ program can be downloaded from the "continuous integration server":http://ci.cor-lab.org for versions RSB 0.4 and 0.5 of the project:rsb: versions:

* "0.4 i686":https://ci.cor-lab.de/job/cl-rsbag-tools-stable/label=ubuntu_lucid_32bit/
* "0.4 x86_64":https://ci.cor-lab.de/job/cl-rsbag-tools-stable/label=ubuntu_lucid_64bit/
* "0.5 i686":https://ci.cor-lab.de/job/cl-rsbag-tools/label=ubuntu_lucid_32bit/
* "0.5 x86_64":https://ci.cor-lab.de/job/cl-rsbag-tools/label=ubuntu_lucid_64bit/

After the download, the @bag-record@ has to be made executable in most cases. This can be done for example by executing
<pre>
chmod +x bag-record
</pre>
in the download directory.

h2. Checking Versions and Displaying Help

Version and help information is displayed when the @--version@ and @--help@ commandline options are specified:
<pre>
./bag-record --version
./bag-record --help
</pre>
The output of @--help@ includes a list of supported file formats.

h2. Recording Events

h3. Recording from a Nao robot using a local Spread daemon

This example assumes
* A Spread daemon running on the local machine and listening on port 4803
* Image, Sound and Proprioception message are encoded using the project:rst data types
** rst:source:trunk/rst/proto/rst/ImageMessage.proto
** rst:source:trunk/rst/proto/rst/SoundMessage.proto
** rst:source:trunk/rst/proto/rst/ProprioceptionData.proto

<pre>
./bag-record -o /tmp/nao.tide
'spread:/nao/vision/top?name=4803;wire-schema=.rst.ImageMessage'
'spread:/nao/audio/all?name=4803;wire-schema=.rst.SoundImage'
'spread:/nao/proprioception?name=4803;wire-schema=.rst.ProprioceptionData'
</pre>

*Note: the @wire-schema=NAME@ URL options are stored without further checks.*

*Note: the file extension ("tide" in this case) determines the used file format backend. Currently, only the "TIDELog":https://retf.info/svn/drafts/rd-0001.txt file format is supported.*

h3. Recording from a Nao robot using a remote Spread daemon

This example assumes
* A Spread daemon running on the machine "remote" and listening on port 4803
* Same data types as above

<pre>
./bag-record -o /tmp/nao.tide
'spread://remote:4803/nao/vision/top?wire-schema=.rst.ImageMessage'
'spread://remote:4803/nao/audio/all?wire-schema=.rst.SoundMessage'
'spread://remote:4803/nao/proprioception?wire-schema=.rst.ProprioceptionData'
</pre>