build: upgrade to AmpForm v0.11.0 (#50)

* ci: remove redundant ignores sphinx-autobuild
* fix: remove typos about page
* fix: set lower limit on TensorWaves for jax
* build: require AmpForm v0.11.*
* fix: link to own develop page
* fix: update links to new AmpForm API
* docs: update notebooks to AmpForm v0.11.x
* docs: freeze TR-009
* docs: freeze TR-010

.cspell.json

@@ -133,6 +133,7 @@
         "imag",
         "infty",
         "iplt",
+        "ipykernel",
         "ipympl",
         "ipynb",
         "ipyplot",
@@ -153,6 +154,7 @@
         "mathbb",
         "mathop",
         "mathrm",
+        "mathtt",
         "maxdepth",
         "meshgrid",
         "multiline",

demo/analytic-continuation.ipynb

@@ -1551,7 +1551,7 @@
     "$\n",
     "\n",
     "with:\n",
-    "- $\\rho$ the normal [`phase_space_factor`](https://ampform.readthedocs.io/en/stable/api/ampform.dynamics.html#ampform.dynamics.phase_space_factor)\n",
+    "- $\\rho$ the normal [`PhaseSpaceFactor`](https://ampform.readthedocs.io/en/stable/api/ampform.dynamics.html#ampform.dynamics.PhaseSpaceFactor)\n",
     "- $n_a^2$ the same as [`BlattWeisskopfSquared`](https://ampform.readthedocs.io/en/stable/api/ampform.dynamics.html#ampform.dynamics.BlattWeisskopfSquared)"
    ]
   },
@@ -1790,7 +1790,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -1804,7 +1804,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.10"
+   "version": "3.8.11"
   },
   "livereveal": {
    "autolaunch": true

docs/about.md

@@ -70,12 +70,12 @@ ComPWA attempts to break this with the following ideals:
 - Follow industry standards and tools (e.g.
   {doc}`ticket system, CI, ADR, etc... </develop>`).
 
-The points is crucial. ComPWA rather sacrifices functionality for design and
-developer experience related developments. Many other frameworks have started
-with the same ideal of having a good software design etc., but soon begin to
-drop those ideals for the understandable reasons described above. We believe
-that only by sticking to those ideals, it is possible to maintain a long-term
-and collaboration-independent common tool.
+The first point is crucial. ComPWA rather sacrifices functionality for design
+and developer experience related developments. Many other frameworks have
+started with the same ideal of having a good software design etc., but soon
+begin to drop those ideals for the understandable reasons described above. We
+believe that only by sticking to those ideals, it is possible to maintain a
+long-term and collaboration-independent common tool.
 
 ## Developer Experience
 

docs/conf.py

@@ -172,6 +172,8 @@
     "report/003*",
     "report/006*",
     "report/008*",
+    "report/009*",
+    "report/010*",
 ]
 nb_output_stderr = "remove"
 nb_render_priority = {
@@ -208,8 +210,8 @@
     "run_interactive": f"""
 ```{{margin}}
 Run this notebook [on Binder]({BINDER_LINK}) or
-{{ref}}`locally on Jupyter Lab <pwa:develop:Jupyter Notebooks>` to
-interactively modify the parameters.
+{{ref}}`locally on Jupyter Lab <develop:Jupyter Notebooks>` to interactively
+modify the parameters.
 ```
 """
 }

docs/report/000.ipynb

@@ -282,7 +282,7 @@
    "source": [
     "**There is a problem with this approach though**: once input data is complex, _all_ square roots in a larger expression (some amplitude model) compute imaginary solutions for negative values, while this is not always the desired behavior.\n",
     "\n",
-    "Take for instance the two square roots appearing in {func}`~ampform.dynamics.phase_space_factor` --- does the $\\sqrt{s}$ also have to be evaluatable for negative $s$?"
+    "Take for instance the two square roots appearing in {class}`~ampform.dynamics.PhaseSpaceFactor` --- does the $\\sqrt{s}$ also have to be evaluatable for negative $s$?"
    ]
   },
   {
@@ -839,7 +839,7 @@
  "metadata": {
   "keep_output": true,
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -853,7 +853,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.10"
+   "version": "3.8.11"
   },
   "toc-autonumbering": true,
   "toc-showcode": false,

docs/report/003.ipynb

@@ -330,7 +330,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "For comparison, we plot the Chew-Mandelstam function for $S$-waves next to AmpForm's {func}`~ampform.dynamics.phase_space_factor_complex`. Have a look at the resulting plots and compare to Figure 49.3 on {pdg-review}`2020; Resonances; p.10`."
+    "For comparison, we plot the Chew-Mandelstam function for $S$-waves next to AmpForm's {class}`~ampform.dynamics.PhaseSpaceFactorComplex`. Have a look at the resulting plots and compare to Figure 49.3 on {pdg-review}`2020; Resonances; p.10`."
    ]
   },
   {
@@ -1226,7 +1226,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "For $\\rho_a$, we use AmpForm's {func}`~ampform.dynamics.phase_space_factor`:"
+    "For $\\rho_a$, we use AmpForm's {class}`~ampform.dynamics.PhaseSpaceFactor`:"
    ]
   },
   {
@@ -2337,7 +2337,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -2351,7 +2351,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.10"
+   "version": "3.8.11"
   }
  },
  "nbformat": 4,

docs/report/004.ipynb

@@ -48,7 +48,7 @@
     "import numpy as np\n",
     "import sympy as sp\n",
     "from ampform.dynamics import (\n",
-    "    phase_space_factor,\n",
+    "    PhaseSpaceFactor,\n",
     "    relativistic_breit_wigner_with_ff,\n",
     ")\n",
     "from IPython.display import Math\n",
@@ -99,7 +99,7 @@
    "source": [
     "s = sp.Symbol(\"s\")\n",
     "m1, m2 = sp.symbols(\"m1 m2\", real=True)\n",
-    "rho = 16 * sp.pi * phase_space_factor(s, m1, m2)\n",
+    "rho = 16 * sp.pi * PhaseSpaceFactor(s, m1, m2).doit()\n",
     "rho"
    ]
   },
@@ -297,7 +297,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Interactive reproduction of Figure 49.1 on {pdg-review}`2020; Resonances; p.2`. The formulas below come from a {func}`~ampform.dynamics.relativistic_breit_wigner_with_ff` with $L=0$. As phase space factor, we used the square root of {func}`~ampform.dynamics.breakup_momentum_squared` instead of the default {func}`~ampform.dynamics.phase_space_factor`, because this introduces only one branch point in the $s$-plane (namely the one over the nominator)."
+    "Interactive reproduction of Figure 49.1 on {pdg-review}`2020; Resonances; p.2`. The formulas below come from a {func}`~ampform.dynamics.relativistic_breit_wigner_with_ff` with $L=0$. As phase space factor, we used the square root of {class}`~ampform.dynamics.BreakupMomentumSquared` instead of the default {class}`~ampform.dynamics.PhaseSpaceFactor`, because this introduces only one branch point in the $s$-plane (namely the one over the nominator)."
    ]
   },
   {
@@ -313,11 +313,11 @@
    },
    "outputs": [],
    "source": [
-    "from ampform.dynamics import breakup_momentum_squared\n",
+    "from ampform.dynamics import BreakupMomentumSquared\n",
     "\n",
     "\n",
     "def breakup_momentum(s: sp.Symbol, m_a: sp.Symbol, m_b: sp.Symbol) -> sp.Expr:\n",
-    "    return sp.sqrt(breakup_momentum_squared(s, m_a, m_b))\n",
+    "    return sp.sqrt(BreakupMomentumSquared(s, m_a, m_b).doit())\n",
     "\n",
     "\n",
     "s = sp.Symbol(\"s\")\n",
@@ -497,7 +497,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },