Notes for the binary releases

The binary releases contain most of the AMUSE community codes and are ready to run after unpacking the distributed files.

Every binary release comes with 3 scripts you can run:

amuse::

Will start a python interpreter capable of running amuse scripts

amuse-admin:

General script to do some administation tasks on the install, currently provides just the unit testing functionality. To run the tests do amuse-admin test

amuse-tutorial:

Will start a live amuse tutorial. This script uses  IPython notebook to run the tutorial, a html webserver with live connections to running python environments.

Known bugs/issues

  1. On Linux, when your hostname does not resolve to an ip-address or your ip-address is invalid, you may get the error: "Unable to connect to singleton process". You can fix this error by adding your hostname to the '/etc/hosts' file with a line like:
    hostname       127.0.0.1
    
  2. On Linux, the LD_LIBRARY_PATH variable may interfere with the binary shared object files. You will get errors about symbols not found. To fix this, please unset the LD_LIBRARY_PATH variable:
    export LD_LIBRARY_PATH=
    

or, for csh:

unset LD_LIBRARY_PATH
  1. On OS X, the matplotlib library may choose the wrong back-end by default. You can fix this error by creating a file named "matplotlibrc" in your working directory. In this file you should put the line "backend: tkagg". The following shell command will do both:
    echo "backend:tkagg" > matplotlibrc
    
  2. On Linux, the matplotlib library may not display any graphics by default. You can fix this error by creating a file named "matplotlibrc" in your working directory. In this file you should put the line "backend: webagg". The following shell command will do both:
    echo 'backend:webagg' > matplotlibrc
    
  3. The examples are hard to find in the binary distribution. You can find the examples here:
    cd lib/python2.7/site-packages/amuse/examples/simple
    ../../../../../../amuse cluster.py
    

Solved bugs

  1. The python community codes in the binary release are not yet functional, these depend on correct setting of the python interpreter and this is not fixed yet, see ticket #320 for current status. Codes that cannot run are: twobody, halogen and mmams
  1. Some tests check building of new codes, this is impossible for the binary release as the compilers are not available, see ticket #321 for current status. The unit tests for codes will fail!

Codes not in the AMUSE binary

The following codes are not provided with the amuse binary release:

  1. MESA, stellar evolution. Binary installation of this code uses more than 2Gb of disk space.