• On all platforms and versions of OOF2 earlier than 2.1.12, if you do not have swig version 1.1 build 883 installed, you will need to provide the --skip-swig argument to the build command, and will also need to build and install in one step, like this:

  python setup.py build --skip-swig [other build args] install [install args] 

• If you get a lot of messages like this:

  .../oof2-2.1.0/SRC/SWIG2D/image/oofimagecmodule.C:3281: undefined reference to `PyArg_ParseTuple'
  .../oof2-2.1.0/SRC/SWIG2D/image/oofimagecmodule.C:3284: undefined reference to `_Py_NoneStruct'
  .../oof2-2.1.0/SRC/SWIG2D/image/oofimagecmodule.C:3336: undefined reference to `PyEval_RestoreThread' 

  ending with this:

  build/temp.linux-i686-2.6-2d/shlib/liboof2common.so: undefined reference to `PyString_AsString'
  build/temp.linux-i686-2.6-2d/shlib/liboof2common.so: undefined reference to `PyGILState_Ensure'
  build/temp.linux-i686-2.6-2d/shlib/liboof2common.so: undefined reference to `PyErr_GivenExceptionMatches'
  collect2: ld returned 1 exit status
  error: command 'g++' failed with exit status 1 

  then you probably have GraphicsMagick installed instead of ImageMagick. Assuming that you used apt-get to install GraphicsMagick, you can fix it like this:

  apt-get remove graphicsmagick-libmagick-dev-compat
  apt-get install libmagick++-dev 

• If you get an error message ending with

  KeyError: 'shlib' 

  when building OOF2 version 2.0.4 or 2.0.5 with Ubuntu 9.04, try using the --prefix argument to the install command, and running both build and install on the same line, like this:

  python setup.py build [options] install --prefix=/xxxx/yyyy 

  where /xxxx/yyyy is the topmost installation directory and [options] are optional build options. Do this even if you are installing OOF2 in the default system location.

The easiest way to install OOF2 on a Mac is to first install MacPorts, and then type sudo port install oof2.

If you don't want to use MacPorts, the difficult parts of installing OOF2 on OS X are all in the installation of third party libraries. This is now discussed on the OOF2 Prerequisites page.