removed Tools/tabulatedFunctions.* which are not used, userFunction.* is the one used ; updated the doc for GPU install with openmpi and the BC supported

Author: charlesprouveur

doc/Sphinx/Understand/GPU_offloading.rst

@@ -20,6 +20,8 @@ the announced exaflopic supercomputers will include GPUs.
   * Cartesian geometry in 1D, 2D and in 3D , for order 2
   * Diagnostics: Field, Probes, Scalar, ParticleBinning, TrackParticles
   * Moving Window
+  * Boundary conditions for Fields: Periodic, reflective and silver-muller are supported (no PML or BM)
+  * Boundary conditions for Particles: Periodic, Reflective, thermal, remove and stop are supported
 
 * A few key features remain to be implemented (AM geometry, ionization, PML, envelope,
   additional physics), but the fundamentals of the code are ported.

doc/Sphinx/Use/GPU_version.rst

@@ -16,8 +16,6 @@ This page contains the links of this documentation to compile and run SMILEI on
 
 ----
 
-Known issues
-^^^^^^^^^^^^
+Important note: 
 
-2D and 3D runs may crash with A2000 & A6000 GPUs (used in laptops and worstations respectively, 
-they are not 'production GPUs' which are designed for 64 bits floating point operations )
+The biggest challenge to execute SMILEI on an accelerator is the correct installation of the openmpi library. It needs to be compiled with nvc++ after configuring (ie. ./configure --options) with the appropriate options specific to your system 

doc/Sphinx/Use/install_linux_GPU.rst

@@ -6,6 +6,9 @@ First, make sure you have a recent version of CMAKE, and the other libraries
 to compile Smilei on CPU as usual. In particular, for this example, you
 need GCC <= 12.
 
+The installation protocol showed below uses the openmpi included in nvhpc. This approach often results in segfault at runtime (note that nvidia will remove openmpi from nvhpc in the future). 
+The "proper" way, which is much harder, consists in installing openmpi compiled with nvhpc (  
+
 Make a directory to store all the nvidia tools. We call it $NVDIR:
 
 .. code:: bash
@@ -72,3 +75,20 @@ To run:
 
   source nvidia_env.sh
   smilei namelist.py
+
+
+As an example of a "simple" openmpi installation
+Openmpi dependencies such as zlib, hwloc and libevent should first be compiled with nvc++ 
+
+.. code:: bash
+  export cuda=PATH_TO_YOUR_NVHPC_FOLDER/Linux_x86_64/24.5/cuda
+  wget https://download.open-mpi.org/release/open-mpi/v4.1/openmpi-4.1.5.tar.gz
+  tar -xzf openmpi-4.1.5.tar.gz
+  cd openmpi-4.1.5
+  mkdir build
+  cd build
+  CC=nvc++ CXX=nvc++ CFLAGS=-fPIC CXXFLAGS=-fPIC ../configure --with-hwloc --enable-mpirun-prefix-by-default   --prefix=PATH_TO_openmpi/openmpi-4.1.6/build --enable-mpi-cxx  --without-verb --with-cuda=$cuda --disable-mpi-fortran -with-libevent=PATH_TO_libevent/libevent-2.1.12-stable/build
+  make -j 4 all
+  make install
+
+Because of the complexity of the configure for openmpi, we recommend using your supercomputer support to use smilei on GPUs.

src/ParticleBC/BoundaryConditionType.cpp

@@ -9,7 +9,6 @@
 
 #include "BoundaryConditionType.h"
 #include "Params.h"
-#include "tabulatedFunctions.h"
 #include "userFunctions.h"
 
 

src/ParticleBC/BoundaryConditionType.h

@@ -13,7 +13,6 @@
 #include "Particles.h"
 #include "Species.h"
 #include "Params.h"
-#include "tabulatedFunctions.h"
 #include "userFunctions.h"
 #include "Random.h"
 

src/ParticleBC/PartBoundCond.h

@@ -4,7 +4,6 @@
 #include "Params.h"
 #include "Species.h"
 #include "Particles.h"
-#include "tabulatedFunctions.h"
 
 class Patch;
 

src/ParticleBC/PartWall.h

@@ -3,7 +3,6 @@
 
 #include "Params.h"
 #include "Random.h"
-#include "tabulatedFunctions.h"
 
 class Patch;
 class Species;