Using candi to compile dependencies
Using candi to compile dependencies#
In its default configuration
candi downloads and compiles a deal.II configuration that is able to run
ASPECT, but it also contains a number of packages
that are not required (and that can be safely disabled if problems occur
during the installation). We require at least the packages p4est, Trilinos, and
At the time of this writing (2022),
candi will install
p4est 2.3.2, Trilinos 12.18.1, and deal.II 9.3.3.
We strive to keep
the development version of ASPECT compatible
with the latest release of deal.II and the
current deal.II development version at any
time, and we usually support several older versions of p4est and Trilinos.
Obtaining candi: Download
git clone https://github.com/dealii/candi
in a directory of your choice.
Installing deal.II and its dependencies: Execute
cd candi ./candi.sh -p INSTALL_PATH
(here we assume you replace
INSTALL_PATHby the path were you want to install all dependencies and deal.II, typically a directory inside
$HOME/binor a similar place). This step might take a long time, but can be parallelized by adding
Nis the number of CPU cores available on your computer. Further configuration options and parameters are listed at https://github.com/dealii/candi. In case you encounter problems during this step, please read the error message, and consult our wiki (https://github.com/geodynamics/aspect/wiki) for common installation problems, before asking on the forum (https://community.geodynamics.org/c/aspect).
You may now want to configure your environment to make it aware of the newly installed packages. This can be achieved by adding the line
source INSTALL_PATH/configuration/enable.shto the file responsible for setting up your shell environment1 (again we assume you replace
INSTALL_PATHby the patch chosen in the previous step). Then close the terminal and open it again to activate the change.
Testing your installation: Test that your installation works by compiling the
step-32example that you can find in
$DEAL_II_DIR/examples/step-32. Prepare and compile by running
cmake . && makeand run with
mpirun -n 2 ./step-32.
Congratulations, you are now set up for compiling ASPECT itself.
For bash this would be the file