bvenv¶
This is a meta-package that manages the installation of all the software necessary for the bootstrapping simulations contained in the paper that can be found at the page http://purl.org/censi/2010/boot. (“bvenv” stands for “Bootstrapping Vehicles Environment”)
It utilizes the following packages. Each has its own repository.
- bvexp201007 contains the code that manages the simulations.
- pybv is a python simulator of the various sensors and random environments.
- raytracer is a C++ raytracer used by pybv to simulate a range-finder.
- snp_geometry contains some utils to manipulate poses.
- reprep is a library used for creating reports in html (for inspection) and their latex versions (for publishing).
- compmake is a parallel “make” for batch python processes – the weeks I used to write this were well repaid by the time it made me save for the bootstrapping simulations.
- json-c is a port to ansi-c, with some addons, of a popular C JSON library.
- jsonstream contains Python functions to read a stream of JSON objects.
- patience is the script that automates downloading and installing of the other packages.
I found out that having very small libraries/repositories and aggregating meta-packages works very well for me for code reuse.
Download and install¶
For history, branches, etc., see the github page http://github.com/AndreaCensi/bvenv
You can download this project in either zip or tar formats. You can also clone the project with Git by running:
$ git clone git://github.com/AndreaCensi/bvexp201007
Usage¶
Read the documentation concerning the required dependencies. It has been tested in OS X and Ubuntu/Fedora.
Run the script bvenv_boot.sh:
$ ./bvenv_boot.sh
This creates a Python virtual environment in the subdirectory deploy/. It downloads and installs in deploy/ all the packages mentioned above.
Moreover, it creates a file called environment.sh which contains all the environment variables that you need to run the software in deploy/.
Use the environment variables:
$ source environment.sh
At this point everything is installed. See the instructions in the package bvexp2010 to actually run the simulations.