From 6ab9adbaeda966004ee6789b7eed675d66df697b Mon Sep 17 00:00:00 2001
From: Roelof Groenewald <40245517+roelof-groenewald@users.noreply.github.com>
Date: Tue, 16 Nov 2021 13:46:31 -0800
Subject: [PATCH] added superLU solver example to docs (#2567)

---
 Docs/source/usage/examples.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/Docs/source/usage/examples.rst b/Docs/source/usage/examples.rst
index 91cf103f16d..6c1a13a7421 100644
--- a/Docs/source/usage/examples.rst
+++ b/Docs/source/usage/examples.rst
@@ -90,3 +90,10 @@ PICMI test cases included that can be used as a reference:
 * :download:`Langmuir plasma wave test in 3d <../../../Examples//Tests/Langmuir/PICMI_inputs_langmuir_rt.py>`
 * :download:`Langmuir plasma wave test in RZ <../../../Examples//Tests/Langmuir/PICMI_inputs_langmuir_rz_multimode_analyze.py>`
 * :download:`Langmuir plasma wave test in 2D <../../../Examples//Tests/Langmuir/PICMI_inputs_langmuir2d.py>`
+
+Manipulating fields via Python
+------------------------------
+
+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.
+
+* :download:`Direct Poisson solver example <../../../Examples/Physics_applications/capacitive_discharge/PICMI_inputs_2d.py>`