This repository contains the AMUSE software. With AMUSE you can write scripts to simulate astrophysical problems in different domains.

The project website is:

• www.amusecode.org

and the documentation can be found at:

• https://amuse.readthedocs.io

In short, most probably

pip install amuse

should get you going if you have a linux or Mac were you compile codes on (HDF5 and an MPI libraries must be installed).

Below are some hints for a quick install, if these fail please look for options at the detailed descriptions of the installation procedure in the documents in the 'doc/install' directory.

To build AMUSE from source you need to have a working build environment. The AMUSE build system needs C/C++ and fortan 90 compilers, we recommend a recent version of GCC.

In Ubuntu you can setup the environment with (as root):

apt-get install build-essential curl g++ gfortran gettext zlib1g-dev

Other distributions have similar package or package groups available.

In OS X you can use the homebrew or macports package manager (both require the Apple Developer Tools and Xcode to be installed).

AMUSE needs Python 3 version >=3.5 installed preferably with pip and virtualenv. It may be necessary to update pip to a recent version. If you cannot use Python 3, legacy support for Python 2 is available in the AMUSE 12 release and the python2 branch.

The following libraries need to be installed:

• HDF (version 1.6.5 - 1.8.x)
• MPI (OpenMPI or MPICH)

The following are needed for some codes:

• FFTW (version >= 3.0)
• GSL
• CMake (version >= 2.4)
• GMP (version >= 4.2.1)
• MPFR (version >= 2.3.1)

AMUSE can be installed through pip:

pip install [--user] amuse

This will build and install AMUSE with an extensive set of codes. If necessary this will also install some required Python packages:

• Numpy (version >= 1.3.0)
• h5py (version >= 1.2.0)
• mpi4py (version >= 1.0)
• nose (version >= 0.11)
• docutils (version >= 0.6)

If you are not using pip these must be installed by hand.

It is possible to install the minimal framework by:

pip install [--user] amuse-framework

This does not include any codes. These can be added

pip install [--user] amuse-<code name>

If you are using Python 2, an AMUSE development install can also be handled through pip by executing (in the root of a clone of the repository)

pip install -e .

after this the codes need to be build:

python setup.py develop_build

AMUSE comes with a large set of tests, most can be run automatically. To run these tests start the nosetests command from the main amuse directory (directory this README file lives in).

To run these tests do:

1. install the tests

pip install [--user] amuse-tests

2. Run the automatic tests

nosetests -v amuse.tests.suite