Docs: Cori PICMI Instructions

Too tricky to get right to just cross-link - add documentation how to
build & run PICMI interfaces on Cori.

Docs/source/install/hpc/cori.rst

@@ -142,6 +142,15 @@ If you want to run on either of the three partitions of Cori, open a new termina
    # GPU:
    #source $HOME/gpu_warpx.profile
 
+.. warning::
+
+   Consider that all three Cori partitions are *incompatible*.
+
+   Do not *source* multiple ``...warpx.profile`` files in the same terminal session.
+   Open a new terminal and log into Cori again, if you want to switch the targeted Cori partition.
+
+   If you re-submit an already compiled simulation that you ran on another day or in another session, *make sure to source* the corresponding ``...warpx.profile`` again after login!
+
 Then, ``cd`` into the directory ``$HOME/src/warpx`` and use the following commands to compile:
 
 .. code-block:: bash
@@ -153,16 +162,19 @@ Then, ``cd`` into the directory ``$HOME/src/warpx`` and use the following comman
    cmake -S . -B build -DWarpX_OPENPMD=ON -DWarpX_DIMS=3
    cmake --build build -j 16
 
-The general :ref:`cmake compile-time options and instructions for Python (PICMI) bindings <building-cmake>` apply as usual.
+The general :ref:`cmake compile-time options and instructions for Python (PICMI) bindings <building-cmake>` apply as usual:
 
-.. warning::
-
-   Consider that all three Cori partitions are *incompatible*.
+.. code-block:: bash
 
-   Do not *source* multiple ``...warpx.profile`` files in the same terminal session.
-   Open a new terminal and log into Cori again, if you want to switch the targeted Cori partition.
+   # PICMI build
+   cd $HOME/src/warpx
 
-   If you re-submit an already compiled simulation that you ran on another day or in another session, *make sure to source* the corresponding ``...warpx.profile`` again after login!
+   # update Python dependencies
+   python3 -m pip install --user -U pip
+   CFLAGS="$(CC --cray-print-opts=cflags)" LDFLAGS="$(CC --cray-print-opts=libs)" python3 -m pip install -U --user mpi4py
+   
+   # compile parallel PICMI interfaces with openPMD support and 3D, 2D and RZ
+   WarpX_MPI=ON WarpX_OPENPMD=ON BUILD_PARALLEL=16 python3 -m pip install --force-reinstall -v --user .
 
 .. _running-cpp-cori:
 
@@ -178,6 +190,8 @@ The batch script below can be used to run a WarpX simulation on 2 KNL nodes on
 the supercomputer Cori at NERSC. Replace descriptions between chevrons ``<>``
 by relevant values, for instance ``<job name>`` could be ``laserWakefield``.
 
+For PICMI Python runs, the ``<path/to/executable>`` has to read ``python3`` and the ``<input file>`` is the path to your PICMI input script.
+
 .. literalinclude:: ../../../../Tools/BatchScripts/batch_cori.sh
    :language: bash