Quick Installation¶
This is the recommended starting point for most users on CPU systems.
Use this first
If this Superbuild completes successfully, you do not need to manually build Kokkos, METIS, ParMETIS, SymEngine, or Text2Code. They are handled by the Superbuild.
Prerequisites¶
Install the basic system tools for your platform:
| Platform | Typical packages |
|---|---|
| macOS | brew install cmake llvm and optionally brew install open-mpi |
| Ubuntu/Debian CPU | sudo apt install build-essential cmake git libblas-dev liblapack-dev libopenmpi-dev |
| HPC CPU cluster | Load site compiler, CMake, MPI, BLAS/LAPACK modules. |
See macOS, Linux CPU, or HPC build chain for platform notes.
Recommended CPU Superbuild¶
From the parent directory containing the Exasim source tree:
export EXASIM_PREFIX=/path/to/prefix
cmake -S Exasim -B Exasim-build -DCMAKE_INSTALL_PREFIX=$EXASIM_PREFIX
cmake --build Exasim-build -j8
cmake --install Exasim-build
What this does:
- Configures the Exasim Superbuild.
- Builds required dependencies in order.
- Builds Exasim libraries, model libraries, Text2Code, and runtime data.
- Installs everything into
$EXASIM_PREFIX.
Confirm The Install¶
find $EXASIM_PREFIX -name ExasimConfig.cmake
find $EXASIM_PREFIX -name "libbuiltinmodel*"
ls $EXASIM_PREFIX/bin/text2code
Then build and run the first example from the Quick Start.
If This Fails¶
Do not immediately start manually installing every dependency. First read Troubleshooting Superbuild Failures. Manual installation is mainly for systems where:
- the site compiler/MPI stack must be used explicitly;
- network downloads are blocked;
- GPU toolchains need architecture-specific configuration;
- the Superbuild cannot find compatible BLAS/LAPACK, MPI, or compiler tools.