docs: add intro slide to AmpForm mini-demo (#23)

* ci: add gitignore to demo folder
* docs: simplify initialization cell

.cspell.json

@@ -144,8 +144,10 @@
         "pygments",
         "pyplot",
         "pythoncode",
+        "q",
         "redeboer",
         "rtfd",
+        "rules's",
         "savefig",
         "scimath",
         "seealso",

demo/.gitignore

@@ -0,0 +1,5 @@
+*
+!*.css
+!*.ipynb
+!.gitignore
+!README.md

demo/ampform.ipynb

@@ -20,7 +20,7 @@
     }
    },
    "source": [
-    "# AmpForm physics demo"
+    "# AmpForm physics mini-demo"
    ]
   },
   {
@@ -40,7 +40,7 @@
    "source": [
     "from IPython.display import Javascript\n",
     "\n",
-    "display(Javascript(\"IPython.notebook.execute_cells_below()\"))"
+    "Javascript(\"IPython.notebook.execute_cells_below()\")"
    ]
   },
   {
@@ -180,6 +180,42 @@
     "particle_selection += PDG.filter(lambda p: p.name.startswith(\"phi\"))"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "## Common Partial Wave Analysis"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "ComPWA provides an _ecosystem_ of three Python packages:\n",
+    "1. `QRules`: quantum number conservation rules ('resonance finder')\n",
+    "2. `AmpForm`: spin formalisms and dynamics\n",
+    "3. `TensorWaves`: toy MC and model optimization with multiple computational back-ends"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "fragment"
+    },
+    "tags": []
+   },
+   "source": [
+    "Main targets are:\n",
+    "- to make PWA intelligible with **modern and interactive documentation** ([example](https://ampform.rtfd.io/en/stable/usage/dynamics/k-matrix.html))\n",
+    "- long-term, open source development that can be picked up by successors (**academic continuity**)\n",
+    "- to perform PWA with the latest tools from the Python data science community"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {
@@ -201,7 +237,7 @@
    },
    "source": [
     "- **Quantum number conservation rules** are encoded in `QRules`\n",
-    "- This allows us to **generate particle reactions**"
+    "- This allows us to investigate potential resonances"
    ]
   },
   {
@@ -222,9 +258,23 @@
    "cell_type": "markdown",
    "metadata": {
     "slideshow": {
-     "slide_type": "subslide"
+     "slide_type": "fragment"
     }
    },
+   "source": [
+    "`QRules` can also:\n",
+    "- check **conversation rule violations** in an invalid reaction\n",
+    "- serve as a **quantum number database** (PDG listings are default input)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    },
+    "tags": []
+   },
    "source": [
     "## 2. [AmpForm](https://ampform.rtfd.io): express transitions as amplitude models"
    ]
@@ -239,7 +289,7 @@
    },
    "source": [
     "- `AmpForm` encodes **spin formalisms and dynamics**\n",
-    "- It can formulate these state transitions as an **amplitude model**"
+    "- It can formulate QRules's state transitions as an **amplitude model**"
    ]
   },
   {
@@ -279,14 +329,14 @@
    "cell_type": "markdown",
    "metadata": {
     "slideshow": {
-     "slide_type": "subslide"
+     "slide_type": "fragment"
     },
     "tags": []
    },
    "source": [
-    "`AmpForm` takes care of the spin formalism (helicity), but dynamics have to be chosen:\n",
-    "- 𝑎₀(1320) lies well within phase space: relativistic Breit-Wigner\n",
-    "- 𝑎₂(980) lies below threshold: add **analytic continuation**"
+    "In our example, **helicity formalism** with the following dynamics:\n",
+    "- 𝑎₀(1320) lies well within phase space: relativistic Breit-Wigner with form factor\n",
+    "- 𝑎₂(980) lies below threshold: **analytic continuation** for phase space factor"
    ]
   },
   {
@@ -296,14 +346,8 @@
    "outputs": [],
    "source": [
     "builder = ampform.get_builder(reaction)\n",
-    "builder.set_dynamics(\n",
-    "    \"a(2)(1320)+\",\n",
-    "    create_relativistic_breit_wigner_with_ff,\n",
-    ")\n",
-    "builder.set_dynamics(\n",
-    "    \"a(0)(980)0\",\n",
-    "    create_analytic_breit_wigner,\n",
-    ")\n",
+    "builder.set_dynamics(\"a(2)(1320)+\", create_relativistic_breit_wigner_with_ff)\n",
+    "builder.set_dynamics(\"a(0)(980)0\", create_analytic_breit_wigner)\n",
     "model = builder.formulate()"
    ]
   },
@@ -433,8 +477,9 @@
    "cell_type": "markdown",
    "metadata": {
     "slideshow": {
-     "slide_type": "subslide"
-    }
+     "slide_type": "slide"
+    },
+    "tags": []
    },
    "source": [
     "## 3. [TensorWaves](https://tensorwaves.rtfd.io): generate toy MC and optimize model"