This section allows you to download input files that correspond to different physical situations.
We provide two kinds of inputs:
- PICMI python input files, with parameters described here.
- AMReX
inputsfiles, :ref:`with parameters described here <running-cpp-parameters>`,
For a complete list of all example input files, also have a look at our Examples/ directory. It contains folders and subfolders with self-describing names that you can try. All these input files are automatically tested, so they should always be up-to-date.
.. toctree:: :maxdepth: 1 examples/lwfa/README.rst examples/pwfa/README.rst
Coming soon:
- LWFA: External injection in the boosted frame
- LWFA: Ionization injection in the lab frame using a LASY data file
- PWFA: Self-injection in the lab frame
- MR case?
.. toctree:: :maxdepth: 1 examples/laser_ion/README.rst examples/plasma_mirror/README.rst
.. toctree:: :maxdepth: 1 examples/gaussian_beam/README.rst examples/beam-beam_collision/README.rst
.. toctree:: :maxdepth: 1 examples/ohm_solver_magnetic_reconnection/README.rst
ARTEMIS (Adaptive mesh Refinement Time-domain ElectrodynaMIcs Solver) is based on WarpX and couples the Maxwell's equations implementation in WarpX with classical equations that describe quantum material behavior (such as, LLG equation for micromagnetics and London equation for superconducting materials) for quantifying the performance of next-generation microelectronics.
Note
TODO
.. toctree:: :maxdepth: 1 examples/langmuir/README.rst examples/capacitive_discharge/README.rst
WarpX includes a reduced plasma model in which electrons are treated as a massless fluid while ions are kinetically evolved, and Ohm's law is used to calculate the electric field. This model is appropriate for problems in which ion kinetics dominate (ion cyclotron waves, for instance). See the :ref:`theory section <theory-kinetic-fluid-hybrid-model>` for more details. Several examples and benchmarks of this kinetic-fluid hybrid model are provided below. A few of the examples are replications of the verification tests described in :cite:t:`ex-MUNOZ2018`. The hybrid-PIC model was added to WarpX in PR #3665 - the figures in the examples below were generated at that time.
.. toctree:: :maxdepth: 1 examples/ohm_solver_EM_modes/README.rst examples/ohm_solver_ion_beam_instability/README.rst examples/ohm_solver_ion_Landau_damping/README.rst
The following examples are commonly used to study the performance of WarpX, e.g., for computing efficiency, scalability, and I/O patterns. While all prior examples are used for such studies as well, the examples here need less explanation on the physics, less-detail tuning on load balancing, and often simply scale (weak or strong) by changing the number of cells, AMReX block size and number of compute units.
.. toctree:: :maxdepth: 1 examples/uniform_plasma/README.rst
Note
TODO: The section needs to be sorted into either science cases (above) or later sections (:ref:`workflows and Python API details <usage-python-extend>`).
An example of using Python to access the simulation charge density, solve the Poisson equation (using superLU) and write the resulting electrostatic potential back to the simulation is given in the input file below. This example uses the fields.py module included in the pywarpx library.
An example of initializing the fields by accessing their data through Python, advancing the simulation for a chosen number of time steps, and plotting the fields again through Python. The simulation runs with 128 regular cells, 8 guard cells, and 10 PML cells, in each direction. Moreover, it uses div(E) and div(B) cleaning both in the regular grid and in the PML and initializes all available electromagnetic fields (E,B,F,G) identically.
WarpX runs over 200 integration tests on a variety of modeling cases, which validate and demonstrate its functionality. Please see the Examples/Tests/ directory for many more examples.
.. bibliography::
:keyprefix: ex-