build_linux.md

@@ -3,23 +3,31 @@ Note that these build instructions are using the GNU compilers but Intel's compi
 
 **Required packages**  
 ```bash
-# Common
+# Add Intel repository to APT for Intel's oneAPI (https://www.intel.com/content/www/us/en/docs/oneapi/installation-guide-linux/2025-2/base-apt.html)
+wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg > /dev/null
+echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
+# Base
 sudo apt update
 sudo apt install git git-lfs
 sudo apt install build-essential cmake
 sudo apt install swig
-sudo apt install libtbb-dev
 sudo apt install libeigen3-dev
-sudo apt install gmsh
+sudo apt install intel-tbb-<VERSION>.<UPDATE>-<BUILD_NUMBER>
+TODO ADD TBB EXPORT
 # Python 3
 sudo apt install python3-dev
-sudo apt install python3-mpi4py python3-numpy python3-scipy python3-matplotlib
+python3 -m pip install numpy mpi4py matplotlib
+# Gmsh
+python3 -m pip install gmsh
 ```
+SWIG 4.2.0 (default on ubuntu 24.04) has a bug. Refer to [this page](https://gitlab.uliege.be/am-dept/dartflo/-/issues/3#note_574905) to compile and install SWIG 4.2.1.
+
 **Optional packages**
 ```bash
 # MKL
-sudo apt install libmkl-dev
+sudo apt install intel-mkl
 echo "export INCLUDE=${INCLUDE}:/usr/include/mkl" >> ~/.bashrc
+TODO CHECK INSTALL AND ADD EXPORT
 # MUMPS
 sudo apt install libmumps-seq-dev
 # VTK
@@ -32,23 +40,27 @@ sudo apt install graphviz
 ```bash
 # Get the code
 git lfs install # enable large file support
-git clone git@gitlab.uliege.be:am-dept/dartflo.git # ssh only
+git clone git@gitlab.uliege.be:am-dept/dartflo.git # ssh only for devs
 cd dartflo
 git submodule init
 git submodule update
-# Build
+# Build and test (for developers)
 mkdir build && cd build
 cmake ..
 make [-j4]
-[make install] # to install
 [make dox] # to build the documentation
-# Test
 ctest [-E exclude_pattern] [-R include_pattern] [-j4]
+# Install
+python3 -m pip install . [--user]
 ```
 For a complete list of options, refer to the [build](Build) page.  
 
-**Example**  
+**Run**  
 From the DART root directory,
 ```bash
-python run.py dart/tests/lift.py [-k4] [--nogui]
+python run.py dart/tests/lift.py [-k4] [-v] [--nogui]
+```
+From anywhere, if the Python package has been installed,
+```bash
+dart-run your_example.py [-k4] [-v] [--nogui]
 ```
\ No newline at end of file