Installing oBB¶

Requirements¶

oBB requires the following software to be installed:

Additionally, the following python packages should be installed (these will be installed automatically if using pip, see Installation using pip):

Optionally, matplotlib 1.1.0 or higher may be manually installed for visualising the algorithm in 2D.

For easy installation, use pip as root:

$ [sudo] pip install --pre obb

or alternatively easy_install:

$ [sudo] easy_install obb

If you do not have root privileges or you want to install oBB for your private use, you can use:

$ pip install --pre --user obb

which will install oBB in your home directory.

Note that if an older install of oBB is present on your system you can use:

$ [sudo] pip install --pre --upgrade obb

to upgrade oBB to the latest version.

Alternatively, you can download the source code and unpack as follows:

$ wget http://pypi.python.org/packages/source/o/oBB/oBB-X.X.tar.gz
$ tar -xzvf oBB-X.X.tar.gz
$ cd oBB-X.X

and then build and install manually using:

$ python setup.py build
$ [sudo] python setup.py install

If you do not have root privileges or you want to install oBB for your private use, you can use:

$ python setup.py install --user

instead.

oBB includes a command line test script to check that the installation was successfull. To run the test simply type the following into your shell:

$ test_obb

This will run oBB using MPI on one processor core for a simple 2D sum of sines problem (see Example of Use).

Note that if using the MPICH implementation of MPI you first need to start an mpd daemon in the background:

$ mpd &

but this is not necessary for other MPI implementations, e.g. OpenMPI.

If oBB was installed using pip you can uninstall as follows:

$ [sudo] pip uninstall obb

If oBB was installed manually you have to remove the installed files by hand (located in your python site-packages directory).