ENH: render particle name in Markdown as code (#105)

* DOC: hide `RuntimeWarning`s
* DOC: widen DPD intensity expression cell
* DX: remove redundant notebook metadata
* FIX: conserve parity in production node
* FIX: remove `sphinx.ext.viewcode` extensions

.cspell.json

@@ -103,6 +103,7 @@
     "seealso",
     "setuptools",
     "sharey",
+    "simplefilter",
     "startswith",
     "suptitle",
     "textwrap",

.pre-commit-config.yaml

@@ -21,8 +21,10 @@ repos:
           - |
             cell.attachments
             cell.metadata.code_folding
+            cell.metadata.editable
             cell.metadata.id
             cell.metadata.pycharm
+            cell.metadata.slideshow
             cell.metadata.user_expressions
             metadata.celltoolbar
             metadata.colab.name
@@ -38,7 +40,7 @@ repos:
             metadata.vscode
 
   - repo: https://github.com/ComPWA/policy
-    rev: 0.3.4
+    rev: 0.3.6
     hooks:
       - id: check-dev-files
         args:

docs/comparison/d2kkk.ipynb

@@ -34,6 +34,7 @@
     "import itertools\n",
     "import logging\n",
     "import os\n",
+    "import warnings\n",
     "from textwrap import dedent\n",
     "from typing import TYPE_CHECKING, Iterable\n",
     "\n",
@@ -82,6 +83,7 @@
     "simplify_latex_rendering()\n",
     "logging.getLogger(\"jax\").setLevel(logging.ERROR)  # mute JAX\n",
     "os.environ[\"TF_CPP_MIN_LOG_LEVEL\"] = \"3\"  # mute TF\n",
+    "warnings.simplefilter(\"ignore\")\n",
     "NO_TQDM = \"EXECUTE_NB\" in os.environ\n",
     "if NO_TQDM:\n",
     "    logging.getLogger(\"ampform.sympy\").setLevel(logging.ERROR)\n",
@@ -311,6 +313,7 @@
      "source_hidden": true
     },
     "tags": [
+     "full-width",
      "hide-input"
     ]
    },

docs/comparison/jpsi2phipipi.ipynb

@@ -34,6 +34,7 @@
     "import itertools\n",
     "import logging\n",
     "import os\n",
+    "import warnings\n",
     "from textwrap import dedent\n",
     "from typing import TYPE_CHECKING, Iterable\n",
     "\n",
@@ -82,6 +83,7 @@
     "simplify_latex_rendering()\n",
     "logging.getLogger(\"jax\").setLevel(logging.ERROR)  # mute JAX\n",
     "os.environ[\"TF_CPP_MIN_LOG_LEVEL\"] = \"3\"  # mute TF\n",
+    "warnings.simplefilter(\"ignore\")\n",
     "NO_TQDM = \"EXECUTE_NB\" in os.environ\n",
     "if NO_TQDM:\n",
     "    logging.getLogger(\"ampform.sympy\").setLevel(logging.ERROR)\n",
@@ -301,6 +303,7 @@
      "source_hidden": true
     },
     "tags": [
+     "full-width",
      "hide-input"
     ]
    },

docs/comparison/jpsi2pipipi.ipynb

@@ -34,6 +34,7 @@
     "import itertools\n",
     "import logging\n",
     "import os\n",
+    "import warnings\n",
     "from textwrap import dedent\n",
     "from typing import TYPE_CHECKING, Iterable\n",
     "\n",
@@ -82,6 +83,7 @@
     "simplify_latex_rendering()\n",
     "logging.getLogger(\"jax\").setLevel(logging.ERROR)  # mute JAX\n",
     "os.environ[\"TF_CPP_MIN_LOG_LEVEL\"] = \"3\"  # mute TF\n",
+    "warnings.simplefilter(\"ignore\")\n",
     "NO_TQDM = \"EXECUTE_NB\" in os.environ\n",
     "if NO_TQDM:\n",
     "    logging.getLogger(\"ampform.sympy\").setLevel(logging.ERROR)\n",
@@ -301,6 +303,7 @@
      "source_hidden": true
     },
     "tags": [
+     "full-width",
      "hide-input"
     ]
    },

docs/conf.py

@@ -88,7 +88,6 @@
     "sphinx.ext.githubpages",
     "sphinx.ext.intersphinx",
     "sphinx.ext.napoleon",
-    "sphinx.ext.viewcode",
     "sphinx_api_relink",
     "sphinx_book_theme",
     "sphinx_codeautolink",

docs/jpsi2ksp.ipynb

@@ -180,7 +180,7 @@
     "        child1, child2, spectator = Σ, pbar, K\n",
     "    else:\n",
     "        raise NotImplementedError\n",
-    "    prod_ls_couplings = _generate_ls(Jpsi, resonance, spectator, conserve_parity=False)\n",
+    "    prod_ls_couplings = _generate_ls(Jpsi, resonance, spectator, conserve_parity=True)\n",
     "    dec_ls_couplings = _generate_ls(resonance, child1, child2, conserve_parity=True)\n",
     "    if min_ls:\n",
     "        decay = IsobarNode(\n",

src/ampform_dpd/io.py

@@ -173,7 +173,7 @@ def _as_resonance_markdown_table(items: Sequence[Particle]) -> str:
     src = _create_markdown_table_header(column_names)
     for particle in items:
         row_items = [
-            particle.name,
+            f"`{particle.name}`",
             f"${particle.latex}$",
             Rf"${aslatex(particle, only_jp=True)}$",
             f"{int(1e3 * particle.mass):,.0f}",