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:
Will start a python interpreter capable of running amuse scripts
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
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.
- 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:
- 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:
or, for csh:unset LD_LIBRARY_PATH
- 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
- 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
- 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
- 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
- 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:
- MESA, stellar evolution. Binary installation of this code uses more than 2Gb of disk space.