.. index:: ubuntu

.. _Ubuntu :

.. highlight:: bash

Installing required libraries on Ubuntu
=======================================

TRIQS 3.2 has been tested on the Ubuntu LTS version 22.04. Earlier versions are not supported.

Install the following packages which are necessary to build TRIQS and use it::

  sudo apt-get install cmake g++-12 gfortran git hdf5-tools \
       libblas-dev libboost-dev libfftw3-dev libgfortran5 \
       libgmp-dev libhdf5-dev liblapack-dev libopenmpi-dev \
       python3-dev python3-mako python3-matplotlib \
       python3-mpi4py python3-numpy python3-scipy

We need to further specify the compiler to be used for the TRIQS compilation using::

    export CXX=g++-12

If you wish to use the jupyter notebook with triqs you can install it using::

    sudo apt-get install jupyter-notebook

.. _ubuntu_clang:

For full functionality of the C++2Py Tool, please install clang and the libclang library::

    sudo apt-get install clang libclang-dev python3-clang


.. _ubuntu_issues:
Issues
------

If you encounter compile-time error messages such as::

        fatal error: mpi.h: No such file or directory
        fatal error: H5public.h: No such file or directory
        
make sure that the include directories of your openmpi and hdf5 installation are in the CPLUS_INCLUDE_PATH :ref:`environment variable <environment_vars>`::

        export CPLUS_INCLUDE_PATH=/usr/include/$(gcc -dumpmachine)/openmpi/:/usr/include/hdf5/serial/:$CPLUS_INCLUDE_PATH