ModernElectron
diff --git a/‎.azure-pipelines.yml‎
Lines changed: 1 addition & 3 deletions b/‎.azure-pipelines.yml‎
Lines changed: 1 addition & 3 deletions
diff --git a/‎.github/workflows/cuda.yml‎
Lines changed: 1 addition & 1 deletion b/‎.github/workflows/cuda.yml‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎.github/workflows/source/test_ci_matrix.sh‎
Lines changed: 0 additions & 2 deletions b/‎.github/workflows/source/test_ci_matrix.sh‎
Lines changed: 0 additions & 2 deletions
diff --git a/‎.pre-commit-config.yaml‎
Lines changed: 2 additions & 2 deletions b/‎.pre-commit-config.yaml‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎CMakeLists.txt‎
Lines changed: 21 additions & 5 deletions b/‎CMakeLists.txt‎
Lines changed: 21 additions & 5 deletions
diff --git a/‎Docs/source/acknowledge_us.rst‎
Lines changed: 10 additions & 2 deletions b/‎Docs/source/acknowledge_us.rst‎
Lines changed: 10 additions & 2 deletions
diff --git a/‎Docs/source/highlights.rst‎
Lines changed: 67 additions & 0 deletions b/‎Docs/source/highlights.rst‎
Lines changed: 67 additions & 0 deletions
diff --git a/‎Docs/source/index.rst‎
Lines changed: 1 addition & 0 deletions b/‎Docs/source/index.rst‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎Docs/source/install/cmake.rst‎
Lines changed: 2 additions & 0 deletions b/‎Docs/source/install/cmake.rst‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎Docs/source/usage/how_to_run.rst‎
Lines changed: 12 additions & 0 deletions b/‎Docs/source/usage/how_to_run.rst‎
Lines changed: 12 additions & 0 deletions
@@ -31,8 +31,6 @@ jobs:
         WARPX_CI_REGULAR_CARTESIAN_2D: 'TRUE'
       cartesian3d:
         WARPX_CI_REGULAR_CARTESIAN_3D: 'TRUE'
-      python:
-        WARPX_CI_PYTHON_MAIN: 'TRUE'
       single_precision:
         WARPX_CI_SINGLE_PRECISION: 'TRUE'
       rz_or_nompi:
@@ -100,7 +98,7 @@ jobs:
           -DopenPMD_USE_PYTHON=OFF -DBUILD_TESTING=OFF -DBUILD_EXAMPLES=OFF -DBUILD_CLI_TOOLS=OFF
         python3 -m pip install --upgrade openpmd-api
       fi
-      if [[ "${WARPX_CI_RZ_OR_NOMPI:-FALSE}" == "TRUE" || "${WARPX_CI_PYTHON_MAIN:-FALSE}" == "TRUE" ]]; then
+      if [[ "${WARPX_CI_RZ_OR_NOMPI:-FALSE}" == "TRUE" ]]; then
         cmake-easyinstall --prefix=/usr/local git+https://bitbucket.org/icl/blaspp.git \
           -DCMAKE_CXX_COMPILER_LAUNCHER=$(which ccache) \
           -DCMAKE_CXX_STANDARD=17                       \
 
@@ -106,7 +106,7 @@ jobs:
         which nvcc || echo "nvcc not in PATH!"
 
         git clone https://github.com/AMReX-Codes/amrex.git ../amrex
-        cd amrex && git checkout --detach 843a7dff266273a0f5b7b9f6cc9233a278f41fe1 && cd -
+        cd amrex && git checkout --detach b78921a2d80d95add9ff3ec9b498a96299ec4ed7 && cd -
         make COMP=gcc QED=FALSE USE_MPI=TRUE USE_GPU=TRUE USE_OMP=FALSE USE_PSATD=TRUE USE_CCACHE=TRUE -j 2
 
   build_nvhpc21-11-nvcc:
 
@@ -19,8 +19,6 @@ WARPX_CI_REGULAR_CARTESIAN_2D=TRUE python prepare_file_ci.py
 grep "\[" ci-tests.ini >>  ci_matrix_elements.txt
 WARPX_CI_REGULAR_CARTESIAN_3D=TRUE python prepare_file_ci.py
 grep "\[" ci-tests.ini >>  ci_matrix_elements.txt
-WARPX_CI_PYTHON_MAIN=TRUE       python prepare_file_ci.py
-grep "\[" ci-tests.ini >> ci_matrix_elements.txt
 WARPX_CI_SINGLE_PRECISION=TRUE  python prepare_file_ci.py
 grep "\[" ci-tests.ini >> ci_matrix_elements.txt
 WARPX_CI_RZ_OR_NOMPI=TRUE      python prepare_file_ci.py
 
@@ -48,7 +48,7 @@ repos:
 
 # Changes tabs to spaces
 - repo: https://github.com/Lucas-C/pre-commit-hooks
-  rev: v1.1.14
+  rev: v1.2.0
   hooks:
   - id: remove-tabs
     exclude: 'Make.WarpX|Make.package|Makefile|GNUmake'
@@ -67,7 +67,7 @@ repos:
 
 # Autoremoves unused Python imports
 - repo: https://github.com/hadialqattan/pycln
-  rev: v1.3.2
+  rev: v1.3.3
   hooks:
   - id: pycln
     name: pycln (python)
 
@@ -86,6 +86,13 @@ if(NOT WarpX_PRECISION IN_LIST WarpX_PRECISION_VALUES)
     message(FATAL_ERROR "WarpX_PRECISION (${WarpX_PRECISION}) must be one of ${WarpX_PRECISION_VALUES}")
 endif()
 
+set(WarpX_PARTICLE_PRECISION_VALUES SINGLE DOUBLE)
+set(WarpX_PARTICLE_PRECISION ${WarpX_PRECISION} CACHE STRING "Particle floating point precision (SINGLE/DOUBLE)")
+set_property(CACHE WarpX_PARTICLE_PRECISION PROPERTY STRINGS ${WarpX_PARTICLE_PRECISION_VALUES})
+if(NOT WarpX_PARTICLE_PRECISION IN_LIST WarpX_PARTICLE_PRECISION_VALUES)
+    message(FATAL_ERROR "WarpX_PARTICLE_PRECISION (${WarpX_PARTICLE_PRECISION}) must be one of ${WarpX_PARTICLE_PRECISION_VALUES}")
+endif()
+
 set(WarpX_COMPUTE_VALUES NOACC OMP CUDA SYCL HIP)
 set(WarpX_COMPUTE OMP CACHE STRING "On-node, accelerated computing backend (NOACC/OMP/CUDA/SYCL/HIP)")
 set_property(CACHE WarpX_COMPUTE PROPERTY STRINGS ${WarpX_COMPUTE_VALUES})
@@ -358,7 +365,7 @@ configure_file(
 # Installs ####################################################################
 #
 # headers, libraries and executables
-set(WarpX_INSTALL_TARGET_NAMES)
+set(WarpX_INSTALL_TARGET_NAMES ablastr)
 if(WarpX_APP)
     list(APPEND WarpX_INSTALL_TARGET_NAMES app)
 endif()
@@ -418,8 +425,17 @@ if(WarpX_LIB)
     set(PYINSTALLOPTIONS "" CACHE STRING
         "Additional parameters to pass to `pip install`")
 
+    # add a prefix to custom targets so we do not collide if used as a subproject
+    if(CMAKE_SOURCE_DIR STREQUAL PROJECT_SOURCE_DIR)
+        set(_WarpX_CUSTOM_TARGET_PREFIX_DEFAULT "")
+    else()
+        set(_WarpX_CUSTOM_TARGET_PREFIX_DEFAULT "warpx_")
+    endif()
+    set(WarpX_CUSTOM_TARGET_PREFIX "${_WarpX_CUSTOM_TARGET_PREFIX_DEFAULT}"
+            CACHE STRING "Prefix for custom targets")
+
     # build the wheel by re-using the shared library we build
-    add_custom_target(pip_wheel
+    add_custom_target(${WarpX_CUSTOM_TARGET_PREFIX}pip_wheel
         ${CMAKE_COMMAND} -E rm -f ${WarpX_BINARY_DIR}/pywarpx*whl
         COMMAND
             ${CMAKE_COMMAND} -E env PYWARPX_LIB_DIR=${CMAKE_LIBRARY_OUTPUT_DIRECTORY}
@@ -431,7 +447,7 @@ if(WarpX_LIB)
     )
 
     # this will also upgrade/downgrade dependencies, e.g., when the version of picmistandard changes
-    add_custom_target(pip_install_requirements
+    add_custom_target(${WarpX_CUSTOM_TARGET_PREFIX}pip_install_requirements
         python3 -m pip install ${PYINSTALLOPTIONS} -r ${WarpX_SOURCE_DIR}/requirements.txt
         WORKING_DIRECTORY
             ${WarpX_BINARY_DIR}
@@ -440,13 +456,13 @@ if(WarpX_LIB)
     # We force-install because in development, it is likely that the version of
     # the package does not change, but the code did change. We need --no-deps,
     # because otherwise pip would also force reinstall all dependencies.
-    add_custom_target(pip_install
+    add_custom_target(${WarpX_CUSTOM_TARGET_PREFIX}pip_install
         ${CMAKE_COMMAND} -E env WARPX_MPI=${WarpX_MPI}
             python3 -m pip install --force-reinstall --no-deps ${PYINSTALLOPTIONS} ${WarpX_BINARY_DIR}/pywarpx*whl
         WORKING_DIRECTORY
             ${WarpX_BINARY_DIR}
         DEPENDS
-            shared pip_wheel pip_install_requirements
+            shared ${WarpX_CUSTOM_TARGET_PREFIX}pip_wheel ${WarpX_CUSTOM_TARGET_PREFIX}pip_install_requirements
     )
 endif()
 
 
@@ -1,3 +1,5 @@
+.. _acknowledge_warpx:
+
 Acknowledge WarpX
 =================
 
@@ -32,6 +34,8 @@ Please add the following sentence to your publications, it helps contributors ke
   Primary WarpX contributors are with LBNL, LLNL, CEA-LIDYL, SLAC, DESY, CERN, and Modern Electron.
   We acknowledge all WarpX contributors.
 
+.. _acknowledge_warpx_ref:
+
 Latest WarpX reference
 **********************
 
@@ -41,14 +45,18 @@ If your project leads to a scientific publication, please consider citing the pa
   **Porting WarpX to GPU-accelerated platforms**. *Parallel Computing*. 2021 Sep, 108:102833.
   https://doi.org/10.1016/j.parco.2021.102833
 
+.. _acknowledge_warpx_all_refs:
+
 Prior WarpX references
 ----------------------
 
 If your project uses the specific algorithms, please consider citing the respective publications in addition.
 
 - Fedeli L, Zaim N, Sainte-Marie A, Thevenet M, Huebl A, Myers A, Vay J-L, Vincenti H.
-  **PICSAR-QED: a Monte Carlo module to simulate Strong-Field Quantum Electrodynamics in Particle-In-Cell codes for exascale architectures**. *New Journal of Physics*. in-press, 2022.
-  https://arxiv.org/abs/2110.00256
+  **PICSAR-QED: a Monte Carlo module to simulate Strong-Field Quantum Electrodynamics in Particle-In-Cell codes for exascale architectures**.
+  *New Journal of Physics* **24** 025009, 2022.
+  `arXiv:2110.00256 <https://arxiv.org/abs/2110.00256>`__,
+  `DOI:10.1088/1367-2630/ac4ef1 <https://doi.org/10.1088/1367-2630/ac4ef1>
 
 - Zoni E, Lehe R, Shapoval O, Belkin D, Zaim N, Fedeli L, Vincenti H, Vay J-L.
   **A Hybrid Nodal-Staggered Pseudo-Spectral Electromagnetic Particle-In-Cell Method with Finite-Order Centering**. under review, 2022.
 
@@ -0,0 +1,67 @@
+.. _highlights:
+
+Science Highlights
+==================
+
+WarpX can be used in many domains of laser-plasma science, plasma physics, accelerator physics and beyond.
+Below, we collect a series of scientific publications that used WarpX.
+Please :ref:`acknowledge WarpX in your works`, so we can find your works.
+
+Is your publication missing? :ref:`Contact us <contact>` or edit this page via a pull request.
+
+Plasma-Based Acceleration
+*************************
+
+Scientific works in laser-plasma and beam-plasma acceleration.
+
+#. Wang J, Zeng M, Li D, Wang X, Lu W, Gao J.
+   **Injection induced by coaxial laser interference in laser wakefield accelerators**.
+   *preprint*. under review, 2022.
+   `arXiv:2205.12083 <https://arxiv.org/abs/2205.12083>`__
+
+#. Levy D, Andriyash IA, Haessler S, Ouille M, Kaur J, Flacco A, Kroupp E, Malka V, Lopez-Martens R.
+   **Low-divergence MeV-class proton beams from kHz-driven laser-solid interactions**.
+   *preprint*. under review, 2021.
+   `arXiv:2112.12581 <https://arxiv.org/abs/2112.12581>`__
+
+#. Miao B, Shrock JE, Feder L, Hollinger RC, Morrison J, Nedbailo R, Picksley A, Song H, Wang S, Rocca JJ, Milchberg HM.
+   **Multi-GeV electron bunches from an all-optical laser wakefield accelerator**.
+   *preprint*. under review, 2021.
+   `arXiv:2112.03489 <https://arxiv.org/abs/2112.03489>`__
+
+#. Mirani F, Calzolari D, Formenti A, Passoni M.
+   **Superintense laser-driven photon activation analysis**.
+   Nature Communications Physics volume **4**.185, 2021
+   `DOI:10.1038/s42005-021-00685-2 <https://doi.org/10.1038/s42005-021-00685-2>`__
+
+
+Laser-Plasma Interaction
+************************
+
+Scientific works in laser-ion acceleration and laser-matter interaction.
+
+#. Hakimi S, Obst-Huebl L, Huebl A, Nakamura K, Bulanov SS, Steinke S, Leemans WP, Kober Z, Ostermayr TM, Schenkel T, Gonsalves AJ, Vay J-L, Tilborg Jv, Toth C, Schroeder CB, Esarey E, Geddes CGR.
+   **Laser-solid interaction studies enabled by the new capabilities of the iP2 BELLA PW beamline**.
+   under review, 2022
+
+
+Particle Accelerator & Beam Physics
+***********************************
+
+Scientific works in particle and beam modeling.
+
+
+Microelectronics
+****************
+
+.. note::
+
+  Link ARTEMIS publications.
+
+
+High-Performance Computing and Numerics
+***************************************
+
+Scientific works in High-Performance Computing, applied mathematics and numerics.
+
+Please see :ref:`this section <acknowledge_warpx_all_refs>`.
@@ -51,6 +51,7 @@ We also have a `discussion page <https://github.com/ECP-WarpX/WarpX/discussions>
 
    coc
    acknowledge_us
+   highlights
 
 Installation
 ------------
 
@@ -95,6 +95,7 @@ CMake Option                  Default & Values                             Descr
 ``WarpX_MPI_THREAD_MULTIPLE`` **ON**/OFF                                   MPI thread-multiple support, i.e. for ``async_io``
 ``WarpX_OPENPMD``             **ON**/OFF                                   openPMD I/O (HDF5, ADIOS)
 ``WarpX_PRECISION``           SINGLE/**DOUBLE**                            Floating point precision (single/double)
+``WarpX_PARTICLE_PRECISION``  SINGLE/**DOUBLE**                            Particle floating point precision (single/double), defaults to WarpX_PRECISION value if not set
 ``WarpX_PSATD``               ON/**OFF**                                   Spectral solver
 ``WarpX_QED``                 **ON**/OFF                                   QED support (requires PICSAR)
 ``WarpX_QED_TABLE_GEN``       ON/**OFF**                                   QED table generation support (requires PICSAR and Boost)
@@ -266,6 +267,7 @@ Environment Variable          Default & Values                             Descr
 ``WARPX_MPI``                 ON/**OFF**                                   Multi-node support (message-passing)
 ``WARPX_OPENPMD``             **ON**/OFF                                   openPMD I/O (HDF5, ADIOS)
 ``WARPX_PRECISION``           SINGLE/**DOUBLE**                            Floating point precision (single/double)
+``WARPX_PARTICLE_PRECISION``  SINGLE/**DOUBLE**                            Particle floating point precision (single/double), defaults to WarpX_PRECISION value if not set
 ``WARPX_PSATD``               ON/**OFF**                                   Spectral solver
 ``WARPX_QED``                 **ON**/OFF                                   PICSAR QED (requires PICSAR)
 ``WARPX_QED_TABLE_GEN``       ON/**OFF**                                   QED table generation (requires PICSAR and Boost)
 
@@ -92,3 +92,15 @@ On an :ref:`HPC system <install-hpc>`, you would instead submit the :ref:`job sc
    .. code-block:: bash
 
       mpirun -np 4 ./warpx <input_file> max_step=10 warpx.numprocs=1 2 2
+
+5. Outputs
+----------
+
+By default, WarpX will write a status update to the terminal (``stdout``).
+On :ref:`HPC systems <install-hpc>`, we usually store a copy of this in a file called ``outputs.txt``.
+
+We also store by default an exact copy of all explicitly and implicitly used inputs parameters in a file called ``warpx_used_inputs``.
+This is important for reproducibility, since as we wrote in the previous paragraph, the options in the input file can be extended and overwritten from the command line.
+
+:ref:`Further configured diagnostics <running-cpp-parameters-diagnostics>` are explained in the next sections.
+By default, they are written to a subdirectory in ``diags/`` and can use various :ref:`output formats <dataanalysis-formats>`.