Merge branch 'main' into create-pull-request/patch-1715051879

.cspell.json

@@ -73,10 +73,14 @@
     "eval",
     "flatté",
     "functools",
+    "Hankel",
     "helicities",
     "helicity",
+    "Hippel",
     "itertools",
     "JHEP",
+    "JPAC",
+    "Ketzer",
     "kwargs",
     "Källén",
     "lambdification",
@@ -106,6 +110,7 @@
     "pytest",
     "PYTHONHASHSEED",
     "qrules",
+    "Quigg",
     "Reana",
     "roadmap",
     "Schwarz",
@@ -121,6 +126,8 @@
     "traceback",
     "unbinned",
     "unitarity",
+    "unitless",
+    "unnormalized",
     "unphysical",
     "vectorize",
     "weisskopf",
@@ -297,6 +304,7 @@
     "phsp",
     "pkpi",
     "pmatrix",
+    "ppnp",
     "preorder",
     "prereleased",
     "println",

.readthedocs.yml

@@ -15,13 +15,9 @@ build:
   tools:
     python: "3.10"
   jobs:
+    pre_install:
+      - ./docs/install-julia-on-rtd.sh
     post_install:
       - curl -LsSf https://astral.sh/uv/install.sh | sh
       - |-
         /home/docs/.cargo/bin/uv pip install --system -c .constraints/py3.10.txt -e .[doc]
-      - |
-        wget https://julialang-s3.julialang.org/bin/linux/x64/1.9/julia-1.9.2-linux-x86_64.tar.gz
-      - tar xzf julia-1.9.2-linux-x86_64.tar.gz
-      - mkdir bin
-      - ln -s $PWD/julia-1.9.2/bin/julia bin/julia
-      - ./bin/julia docs/InstallIJulia.jl

docs/InstallIJulia.jl

@@ -2,4 +2,4 @@ import Pkg
 Pkg.add("IJulia")
 
 import IJulia
-IJulia.installkernel("julia")
+IJulia.installkernel("julia-compwa.github.io")

docs/bibliography.bib

@@ -1,5 +1,4 @@
-
-@article{aitchisonMatrixFormalismOverlapping1972,
+@article{Aitchison:1972ay,
   title = {The 𝐾-Matrix Formalism for Overlapping Resonances},
   author = {Aitchison, I.J.R.},
   year = {1972},
@@ -19,11 +18,8 @@ @article{aitchisonUnitarityAnalyticityCrossing2015
   year = {2015},
   month = jul,
   journal = {arXiv:1507.02697 [hep-ph]},
-  eprint = {1507.02697},
-  eprinttype = {arxiv},
-  primaryclass = {hep-ph},
   url = {http://arxiv.org/abs/1507.02697},
-  archiveprefix = {arXiv}
+  archiveprefix = {arxiv}
 }
 
 @book{beckTestDrivenDevelopmentExample2003,
@@ -32,23 +28,34 @@ @book{beckTestDrivenDevelopmentExample2003
   author = {Beck, Kent},
   year = {2003},
   series = {The {{Addison-Wesley}} Signature Series},
-  publisher = {{Addison-Wesley}},
-  address = {{Boston}},
+  publisher = {Addison-Wesley},
+  address = {Boston},
   isbn = {978-0-321-14653-3},
   lccn = {QA76.76.T48 B43 2003}
 }
 
-@book{bycklingParticleKinematics1973,
+@book{Blatt:1952ije,
+  title = {Theoretical {{Nuclear Physics}}},
+  author = {Blatt, John M and Weisskopf, Victor F},
+  year = {1979},
+  publisher = {Springer New York},
+  address = {New York, NY},
+  url = {https://doi.org/10.1007/978-1-4612-9959-2},
+  isbn = {978-1-4612-9959-2 978-1-4612-9961-5},
+  annotation = {OCLC: 840280777}
+}
+
+@book{Byckling:1971vca,
   title = {Particle {{Kinematics}}},
   author = {Byckling, Eero and Kajantie, Keijo},
   year = {1973},
-  publisher = {{Wiley}},
-  address = {{London, New York}},
+  publisher = {Wiley},
+  address = {London, New York},
   isbn = {978-0-471-12885-4},
   lccn = {QC794.6.K5 B95}
 }
 
-@article{chungPartialWaveAnalysis1995,
+@article{Chung:1995dx,
   title = {{Partial wave analysis in 𝐾-matrix formalism}},
   author = {Chung, Suh-Urk and Brose, J. and Hackmann, R. and Klempt, E. and Spanier, S. and Strassburger, C.},
   year = {1995},
@@ -68,7 +75,7 @@ @techreport{chungSpinFormalismsUpdated2014
   year = {2014},
   month = jul,
   pages = {BNL--76975-2006-IR, 890945},
-  institution = {{Brookhaven National Laboratory}},
+  institution = {Brookhaven National Laboratory},
   url = {https://suchung.web.cern.ch/spinfm1.pdf}
 }
 
@@ -78,13 +85,13 @@ @book{gammaDesignPatternsElements1995
   editor = {Gamma, Erich},
   year = {1995},
   series = {Addison-{{Wesley}} Professional Computing Series},
-  publisher = {{Addison-Wesley}},
-  address = {{Reading, Mass}},
+  publisher = {Addison-Wesley},
+  address = {Reading, Mass},
   isbn = {978-0-201-63361-0},
   lccn = {QA76.64 .D47 1995}
 }
 
-@article{jacobGeneralTheoryCollisions1959,
+@article{Jacob:1959at,
   title = {On the General Theory of Collisions for Particles with Spin},
   author = {Jacob, M. and Wick, G.C.},
   year = {1959},
@@ -98,6 +105,35 @@ @article{jacobGeneralTheoryCollisions1959
   url = {https://linkinghub.elsevier.com/retrieve/pii/000349165990051X}
 }
 
+@article{JPAC:2019ufm,
+  title = {Dalitz-Plot Decomposition for Three-Body Decays},
+  author = {Mikhasenko, M. and Albaladejo, M. and Bibrzycki, Ł. and {Fernandez-Ramirez}, C. and Mathieu, V. and Mitchell, S. and Pappagallo, M. and Pilloni, A. and Winney, D. and Skwarnicki, T. and Szczepaniak, A. P.},
+  year = {2020},
+  month = feb,
+  journal = {Physical Review D: Particles and Fields},
+  volume = {101},
+  number = {3},
+  pages = {034033},
+  issn = {2470-0010, 2470-0029},
+  doi = {10.1103/PhysRevD.101.034033},
+  url = {https://journals.aps.org/prd/abstract/10.1103/PhysRevD.101.034033},
+  archiveprefix = {arxiv}
+}
+
+@article{Ketzer:2019wmd,
+  title = {Light-Meson Spectroscopy with {{COMPASS}}},
+  author = {Ketzer, B. and Grube, B. and Ryabchikov, D.},
+  year = {2020},
+  month = jul,
+  journal = {Progress in Particle and Nuclear Physics},
+  volume = {113},
+  pages = {103755},
+  issn = {01466410},
+  doi = {10.1016/j.ppnp.2020.103755},
+  url = {https://linkinghub.elsevier.com/retrieve/pii/S0146641020300028},
+  archiveprefix = {arxiv}
+}
+
 @misc{kutschkeAngularDistributionCookbook1996,
   title = {An {{Angular Distribution Cookbook}}},
   author = {Kutschke, Rob},
@@ -106,7 +142,7 @@ @misc{kutschkeAngularDistributionCookbook1996
   url = {https://home.fnal.gov/~kutschke/Angdist/angdist.ps}
 }
 
-@article{marangottoHelicityAmplitudesGeneric2020,
+@article{Marangotto:2019ucc,
   title = {Helicity {{Amplitudes}} for {{Generic Multibody Particle Decays Featuring Multiple Decay Chains}}},
   author = {Marangotto, Daniele},
   editor = {Vagnozzi, Sunny},
@@ -117,16 +153,17 @@ @article{marangottoHelicityAmplitudesGeneric2020
   pages = {1--15},
   issn = {1687-7365, 1687-7357},
   doi = {10.1155/2020/6674595},
-  url = {https://www.hindawi.com/journals/ahep/2020/6674595/}
+  url = {https://www.hindawi.com/journals/ahep/2020/6674595/},
+  archiveprefix = {arxiv}
 }
 
 @book{martinCleanCodeHandbook2009,
   title = {Clean {{Code}}: {{A Handbook}} of {{Agile Software Craftsmanship}}},
   shorttitle = {Clean Code},
   editor = {Martin, Robert C.},
   year = {2009},
-  publisher = {{Prentice Hall}},
-  address = {{Upper Saddle River, NJ}},
+  publisher = {Prentice Hall},
+  address = {Upper Saddle River, NJ},
   isbn = {978-0-13-235088-4},
   lccn = {QA76.76.D47 C583 2009}
 }
@@ -136,35 +173,18 @@ @misc{meyerMatrixTutorial2008
   author = {Meyer, Curtis A.},
   year = {2008},
   month = oct,
-  address = {{Munich, Germany}},
+  address = {Munich, Germany},
   url = {http://www.curtismeyer.com/talks/PWA_Munich_KMatrix.pdf}
 }
 
-@article{mikhasenkoDalitzplotDecompositionThreebody2020,
-  title = {Dalitz-Plot Decomposition for Three-Body Decays},
-  author = {Mikhasenko, M. and Albaladejo, M. and Bibrzycki, Ł. and {Fernandez-Ramirez}, C. and Mathieu, V. and Mitchell, S. and Pappagallo, M. and Pilloni, A. and Winney, D. and Skwarnicki, T. and Szczepaniak, A. P.},
-  year = {2020},
-  month = feb,
-  journal = {Physical Review D},
-  volume = {101},
-  number = {3},
-  eprint = {1910.04566},
-  eprinttype = {arxiv},
-  pages = {034033},
-  issn = {2470-0010, 2470-0029},
-  doi = {10.1103/PhysRevD.101.034033},
-  url = {https://journals.aps.org/prd/abstract/10.1103/PhysRevD.101.034033},
-  archiveprefix = {arXiv}
-}
-
 @book{percivalTestDrivenDevelopmentPython2017,
   title = {Test-{{Driven Development}} with {{Python}}: {{Obey}} the {{Testing Goat}}: {{Using Django}}, {{Selenium}}, and {{JavaScript}}},
   shorttitle = {Test-Driven Development with {{Python}}},
   author = {Percival, Harry},
   year = {2017},
   edition = {Second edition},
-  publisher = {{O'Reilly Media}},
-  address = {{Sebastopol, CA}},
+  publisher = {O'Reilly Media},
+  address = {Sebastopol, CA},
   isbn = {978-1-4919-5870-4},
   lccn = {QA76.73.P98 P46 2017},
   annotation = {OCLC: ocn953432202}
@@ -175,11 +195,11 @@ @misc{petersPartialWaveAnalysis2004
   author = {Peters, Klaus},
   year = {2004},
   month = jun,
-  address = {{Varenna}},
+  address = {Varenna},
   url = {https://slideplayer.com/slide/1676572}
 }
 
-@misc{richmanExperimenterGuideHelicity1984,
+@misc{Richman:1984gh,
   title = {An {{Experimenter}}'s {{Guide}} to the {{Helicity Formalism}}},
   author = {Richman, Jeffrey D.},
   year = {1984},
@@ -191,9 +211,9 @@ @book{sedgewickAlgorithms2011
   title = {Algorithms},
   author = {Sedgewick, Robert and Wayne, Kevin Daniel},
   year = {2011},
-  edition = {Fourth},
-  publisher = {{Addison-Wesley}},
-  address = {{Upper Saddle River, NJ}},
+  edition = {4th},
+  publisher = {Addison-Wesley},
+  address = {Upper Saddle River, NJ},
   isbn = {978-0-321-57351-3},
   lccn = {QA76.9.A43 S429 2011}
 }
@@ -204,21 +224,36 @@ @book{slatkinEffectivePython902019
   author = {Slatkin, Brett},
   year = {2019},
   month = nov,
-  publisher = {{Addison-Wesley}},
+  publisher = {Addison-Wesley},
   isbn = {978-0-13-485398-7},
   annotation = {OCLC: 1127093006}
 }
 
-@article{wangNovelMethodTest2020,
-  title = {A Novel Method to Test Particle Ordering and Final State Alignment in Helicity Formalism},
-  author = {Wang, Mengzhen and Jiang, Yi and Liu, Yinrui and Qian, Wenbin and Lyu, Xiaorui and Zhang, Liming},
-  year = {2020},
-  month = dec,
-  journal = {arXiv},
-  eprint = {2012.03699},
-  eprinttype = {arxiv},
-  url = {http://arxiv.org/abs/2012.03699},
-  archiveprefix = {arXiv}
+@article{VonHippel:1972fg,
+  title = {Centrifugal-{{Barrier Effects}} in {{Resonance Partial Decay Widths}}, {{Shapes}}, and {{Production Amplitudes}}},
+  author = {{von Hippel}, Frank and Quigg, C.},
+  year = {1972},
+  month = feb,
+  journal = {Physical Review D},
+  volume = {5},
+  number = {3},
+  pages = {624--638},
+  issn = {0556-2821},
+  doi = {10.1103/PhysRevD.5.624},
+  url = {https://link.aps.org/doi/10.1103/PhysRevD.5.624}
 }
 
-
+@article{Wang:2020giv,
+  title = {A Novel Method to Test Particle Ordering and Final State Alignment in Helicity Formalism},
+  author = {Wang, Mengzhen and Jiang, Yi and Liu, Yinrui and Qian, Wenbin and Lyu, Xiao-Rui and Zhang, Liming},
+  year = {2021},
+  month = jun,
+  journal = {Chinese Physics C},
+  volume = {45},
+  number = {6},
+  pages = {063103},
+  issn = {1674-1137, 2058-6132},
+  doi = {10.1088/1674-1137/abf139},
+  url = {https://iopscience.iop.org/article/10.1088/1674-1137/abf139},
+  archiveprefix = {arxiv}
+}

docs/conf.py

@@ -8,6 +8,7 @@
 
 import os
 import shutil
+import subprocess  # noqa: S404
 import sys
 
 from sphinx_api_relink.helpers import (
@@ -23,7 +24,7 @@
 
 
 def get_nb_exclusion_patterns() -> list[str]:
-    exclusions = [
+    exclusions = {
         "adr/001/*",
         "adr/002/*",
         "report/000*",
@@ -40,20 +41,27 @@ def get_nb_exclusion_patterns() -> list[str]:
         "report/015*",
         "report/017*",
         "report/018*",
-        "report/019*",
         "report/020*",
         "report/021*",
         "report/022*",
-    ]
-    julia_notebooks = [
+    }
+    julia_notebooks = {
         "report/019*",
-    ]
-    if "READTHEDOCS" not in os.environ and shutil.which("julia") is None:
-        exclusions.extend(julia_notebooks)
-    return exclusions
+    }
+    if shutil.which("julia") is None or "READTHEDOCS" in os.environ:
+        exclusions.update(julia_notebooks)
+    return sorted(exclusions)
+
+
+def install_ijulia() -> None:
+    if shutil.which("julia") is None:
+        return
+    if "EXECUTE_NB" in os.environ or "FORCE_EXECUTE_NB" in os.environ:
+        subprocess.check_call(["julia", "InstallIJulia.jl"])  # noqa: S603, S607
 
 
 _list_technical_reports.main()
+install_ijulia()
 set_intersphinx_version_remapping({
     "ipython": {
         "8.12.2": "8.12.1",