Skip to content

Development requirements

C++ version

The compilation of Antares Xpansion requires C++20 and GCC >= 11.

mpicxx is used to build some executables with MPI support. mpicxx relies on /usr/bin/c++ on Linux to compile the code. Please ensure that /usr/bin/c++ points to a C++20-capable compiler (GCC >= 11) or adjust your PATH/symlink accordingly. If not, you may get an error linking to TBB: fatal error: tbb/blocked_range.h.

Note: CMake enforces GCC >= 11. If a GNU compiler with version less than 11 is detected, configuration will fail with the following message (X is the detected version):

Xpansion requires GCC >= 11, your version is X. GCC >= 11 is required for compatibility with Intel TBB oneAPI

Compilation is tested on Visual Studio 17 2022.

=== "CentOS" ⚠ CentOS is considered EoL (end of life) and is not supported anymore. We recommend using a more recent distribution like Oracle Linux 8

By default, GCC version of Centos7 is 4.8.5. Some external repositories must be enabled:

=== "Centos 7 (EPEL)"
    ``` 
    sudo yum install epel-release
    sudo yum install centos-release-scl
    ```

You can then use a more recent version of GCC by enabling `devtoolset-11` (or a newer devtoolset) if available:
```
sudo yum install devtoolset-11
# Launch a shell using the newer toolset:
scl enable devtoolset-11 bash
```
If `devtoolset-11` is not available in your repositories, install a GCC >= 11 from your distribution vendor or build it from source.

sudo apt update
sudo apt install build-essential gcc-11 g++-11
# Make gcc-11/g++-11 the default system compiler (optional but recommended):
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 100
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-11 100

CMake version

CMake 3.x must be used.

You can download latest Windows version directly from CMake website.

sudo yum install epel-release
sudo yum install cmake3

Or

python -m pip install cmake

sudo apt install cmake

Or

python -m pip install cmake

Python version

Python 3.x must be used.

You can download latest Windows version directly from Python website.

sudo yum install python3 python3-pip

sudo apt-get install python3 python3-pip

Required python modules can be installed with:

pip install -r requirements-tests.txt

Git version

Git version must be above 2.15 for external dependencies build because --ignore-whitespace is not used by default and we have an issue with OR-Tools compilation of ZLib and application of patch on Windows ( see https://github.com/google/or-tools/issues/1193).

You can download latest Windows version directly from Git website.

sudo yum install rh-git227-git
sudo yum install git

Sometimes we need a 2.x version of git. To enable to git 2.27: 

source /opt/rh/rh-git227/enable


sudo apt-get install git

Now you can clone the repository:

git clone https://github.com/AntaresSimulatorTeam/antares-xpansion.git

Most of the rest of the guide will assume that you are in the root directory of the repository.