diff options
Diffstat (limited to 'Docs/source/running_python')
| -rw-r--r-- | Docs/source/running_python/api_reference.rst | 2 | ||||
| -rw-r--r-- | Docs/source/running_python/examples.rst | 14 | ||||
| -rw-r--r-- | Docs/source/running_python/how_to_run.rst | 25 | ||||
| -rw-r--r-- | Docs/source/running_python/running_python.rst | 3 |
4 files changed, 41 insertions, 3 deletions
diff --git a/Docs/source/running_python/api_reference.rst b/Docs/source/running_python/api_reference.rst deleted file mode 100644 index b1276856f..000000000 --- a/Docs/source/running_python/api_reference.rst +++ /dev/null @@ -1,2 +0,0 @@ -pyWarpX API reference -===================== diff --git a/Docs/source/running_python/examples.rst b/Docs/source/running_python/examples.rst new file mode 100644 index 000000000..a546294fb --- /dev/null +++ b/Docs/source/running_python/examples.rst @@ -0,0 +1,14 @@ +Example input files +=================== + +.. warning:: + + This section is currently in development. + +This section allows you to **download Python scripts** that correspond to different +physical situations. + +Laser wakefield acceleration +---------------------------- + +* :download:`Without mesh refinement<../../../Example/laser_acceleration/laser_acceleration.py>` diff --git a/Docs/source/running_python/how_to_run.rst b/Docs/source/running_python/how_to_run.rst new file mode 100644 index 000000000..54568a64c --- /dev/null +++ b/Docs/source/running_python/how_to_run.rst @@ -0,0 +1,25 @@ +How to run a new simulation +=========================== + +After installing WarpX as a Python package (see the section +:doc:`../installation`), you can use its functionalities in a Python script +to run a simulation. + +In order to run a new simulation: + +* Create a **new directory**, where the simulation will be run. + +* Add a **Python script** in the directory. + +This file contains the numerical and physical parameters that define +the situation to be simulated. +Example input files can be found in the section :doc:`examples`. + +* **Run** the script with Python: + +:: + + mpirun -np <n_ranks> python <python_script> + +where ``<n_ranks>`` is the number of MPI ranks used, and ``<python_script>`` +is the name of the script. diff --git a/Docs/source/running_python/running_python.rst b/Docs/source/running_python/running_python.rst index f590887db..cf960d431 100644 --- a/Docs/source/running_python/running_python.rst +++ b/Docs/source/running_python/running_python.rst @@ -4,4 +4,5 @@ Running WarpX from Python .. toctree:: :maxdepth: 1 - api_reference
\ No newline at end of file + how_to_run + examples |