Installing Cyclus using a Tarball

Installing Cyclus is a two step process. First one needs to get and compile the Cyclus core, then the Cyclus Additional Modules (Cycamore), which provide the nuclear fuel cycle facilities such as the reactor, fuel fabrication facility, storage, etc.

Dependencies

In order to facilitate future compatibility with multiple platforms, Cyclus is built using CMake. A full list of the Cyclus package dependencies is shown below:

Package

Minimum Version

CMake

3.16.3

pkg-config

0.29.1

boost

1.71.0

libxml2

2.9.10

libxml++

2.40.1

python

3.8.10

sqlite3

3.31.1

HDF5

1.10.4

LAPACK

3.9.0

Instructions to install dependencies on the major platforms can be found here.

Install Cyclus

Get the Tarball

Download the most recent stable version of Cyclus source (either .zip or .gz):

(Previous versions of Cyclus )

Compiling Cyclus

Before going further with the installation procedure be sure you have installed all the required dependencies. We have provided detailed instructions `for installing those dependencies for the major supported systems`_.

Default Installation

Run the install script:

python3 install.py

If you successfully followed the instruction above, the cyclus binary has been generated and placed in the ~/.local/ in your home directory. You need to add ~/.local/bin to the front of your $PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

On MacOSX you also need to add ~/.local/lib/pythonX.Y/site-packages to your $PYTHONPATH:

echo "export PYTHONPATH=\"\$HOME/.local/lib/python`python3 -c 'import sys; \
print(".".join(map(str, sys.version_info[:2])))'`/site-packages:\$PYTHONPATH\"" >> ~/.bashrc
source ~/.bashrc

If you were successful then Cyclus has been installed and you can skip down to Installing Cycamore!

Alternative instructions are also available for doing a Custom Installation.

Install Cycamore

Get the Tarball

Download the most recent stable version of Cycamore source (either .zip or .gz):

(Previous versions of Cycamore )

Compiling Cycamore

Before going further with the installation procedure, be sure you have installed Cyclus.

Default Installation

Run the install script:

python3 install.py

If you successfully followed the instructions above, then the Cycamore library has been generated and placed in .local/ in your home directory.

Run the Unit Tests

To ensure the proper installation of Cyclus and Cycamore, you can run the Cyclus and Cycamore unit tests, they should report that all tests have passed (or been disabled):

$ cyclus_unit_tests
$ cycamore_unit_tests