Skip to content

Commit

Permalink
DOC: update links to compwa.github.io (#387)
Browse files Browse the repository at this point in the history
  • Loading branch information
redeboer authored Jan 20, 2024
1 parent 20cd47d commit 6912694
Show file tree
Hide file tree
Showing 15 changed files with 30 additions and 32 deletions.
4 changes: 1 addition & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,4 @@
[![Open in Visual Studio Code](https://img.shields.io/badge/vscode-open-blue?logo=visualstudiocode)](https://open.vscode.dev/ComPWA/ampform)
[![GitPod](https://img.shields.io/badge/gitpod-open-blue?logo=gitpod)](https://gitpod.io/#https://github.com/ComPWA/ampform)

This package is part of the [ComPWA Organization](https://github.com/ComPWA). For more
information about how to contribute to the packages, go to
[compwa-org.rtfd.io/en/stable/develop.html](https://compwa-org.rtfd.io/en/stable/develop.html)!
This package is part of the [ComPWA Organization](https://github.com/ComPWA). For more information about how to contribute to the packages, go to [compwa.github.io/develop](https://compwa.github.io/develop)!
2 changes: 1 addition & 1 deletion docs/_extend_docstrings.py
Original file line number Diff line number Diff line change
Expand Up @@ -505,7 +505,7 @@ def extend_chew_mandelstam_s_wave() -> None:
with :math:`q^2(s)` defined as :eq:`BreakupMomentumSquared`.
.. seealso:: :doc:`compwa-org:report/003`
.. seealso:: :doc:`compwa:report/003`
""",
)

Expand Down
6 changes: 3 additions & 3 deletions docs/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -170,7 +170,7 @@
"icon_links": [
{
"name": "Common Partial Wave Analysis",
"url": "https://compwa-org.rtfd.io",
"url": "https://compwa.github.io",
"icon": "_static/favicon.ico",
"type": "local",
},
Expand Down Expand Up @@ -227,7 +227,7 @@
intersphinx_mapping = {
"IPython": (f"https://ipython.readthedocs.io/en/{pin('IPython')}", None),
"attrs": (f"https://www.attrs.org/en/{pin('attrs')}", None),
"compwa-org": ("https://compwa-org.readthedocs.io", None),
"compwa": ("https://compwa.github.io", None),
"graphviz": ("https://graphviz.readthedocs.io/en/stable", None),
"ipywidgets": (f"https://ipywidgets.readthedocs.io/en/{pin('ipywidgets')}", None),
"matplotlib": (f"https://matplotlib.org/{pin('matplotlib')}", None),
Expand Down Expand Up @@ -266,7 +266,7 @@
"run_interactive": f"""
```{{margin}}
Run this notebook [on Binder]({BINDER_LINK}) or
{{ref}}`locally on Jupyter Lab <compwa-org:develop:Jupyter Notebooks>` to interactively
{{ref}}`locally on Jupyter Lab <compwa:develop:Jupyter Notebooks>` to interactively
modify the parameters.
```
""",
Expand Down
4 changes: 2 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ maxdepth: 2
API <api/ampform>
Changelog <https://github.com/ComPWA/ampform/releases>
Upcoming features <https://github.com/ComPWA/ampform/milestones?direction=asc&sort=title&state=open>
Help developing <https://compwa-org.rtfd.io/en/stable/develop.html>
Help developing <https://compwa.github.io/develop>
```

```{toctree}
Expand All @@ -90,5 +90,5 @@ hidden:
QRules <https://qrules.readthedocs.io>
TensorWaves <https://tensorwaves.readthedocs.io>
PWA Pages <https://pwa.readthedocs.io>
ComPWA project <https://compwa-org.readthedocs.io>
ComPWA project <https://compwa.github.io>
```
18 changes: 9 additions & 9 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ can find on the [`stable`](https://github.com/ComPWA/ampform/tree/stable) branch

Optionally, you can install the dependencies required for
{doc}`visualizing topologies <qrules:usage/visualize>` with the following
{ref}`optional dependency syntax <compwa-org:develop:Optional dependencies>`:
{ref}`optional dependency syntax <compwa:develop:Optional dependencies>`:

```shell
pip install ampform[viz] # installs ampform with graphviz
Expand All @@ -49,13 +49,13 @@ python3 -m pip install git+https://github.com/ComPWA/ampform@main
## Editable installation

It is highly recommend to use the more dynamic
{ref}`'editable installation' <compwa-org:develop:Editable installation>`. This allows
{ref}`'editable installation' <compwa:develop:Editable installation>`. This allows
you to:

- exactly {ref}`pin all dependencies <compwa-org:develop:Pinning dependency versions>`
- exactly {ref}`pin all dependencies <compwa:develop:Pinning dependency versions>`
to a specific version, so that your work is **reproducible**.
- edit the source code of the framework and
{doc}`help improving it <compwa-org:develop>`.
{doc}`help improving it <compwa:develop>`.

For this, you first need to get the source code with [Git](https://git-scm.com):

Expand Down Expand Up @@ -85,11 +85,11 @@ This installs the project in a Conda environment following the definitions in

1. **[Recommended]** Create a virtual environment with
[`venv`](https://docs.python.org/3/library/venv.html) (see
{ref}`here <compwa-org:develop:Virtual environment>`).
{ref}`here <compwa:develop:Virtual environment>`).

2. Install the project as an
{ref}`'editable installation' <compwa-org:develop:Editable installation>` with
{ref}`additional packages <compwa-org:develop:Optional dependencies>` for the
{ref}`'editable installation' <compwa:develop:Editable installation>` with
{ref}`additional packages <compwa:develop:Optional dependencies>` for the
developer and all dependencies pinned through
[constraints files](https://pip.pypa.io/en/stable/user_guide/#constraints-files):

Expand All @@ -101,9 +101,9 @@ This installs the project in a Conda environment following the definitions in

::::

See {ref}`compwa-org:develop:Updating` for how to update the dependencies when new
See {ref}`compwa:develop:Updating` for how to update the dependencies when new
commits come in.

That's all! Have a look at {doc}`/usage` to try out the package. You can also have a
look at {doc}`compwa-org:develop` for tips on how to work with this 'editable' developer
look at {doc}`compwa:develop` for tips on how to work with this 'editable' developer
setup!
2 changes: 1 addition & 1 deletion docs/usage/dynamics/analytic-continuation.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@
"source": [
":::{note}\n",
"\n",
"Improvements to analytic continuation in AmpForm are currently being developed in {doc}`compwa-org:report/003` and {doc}`compwa-org:report/004`.\n",
"Improvements to analytic continuation in AmpForm are currently being developed in {doc}`compwa:report/003` and {doc}`compwa:report/004`.\n",
"\n",
":::"
]
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/dynamics/k-matrix.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@
"\n",
":::{note}\n",
"\n",
"The $\\boldsymbol{K}$-matrix approach was originally worked worked out in {doc}`compwa-org:report/005`, {doc}`compwa-org:report/009`, and {doc}`compwa-org:report/010`. Those reports contained a few mistakes, which have been addressed here.\n",
"The $\\boldsymbol{K}$-matrix approach was originally worked worked out in {doc}`compwa:report/005`, {doc}`compwa:report/009`, and {doc}`compwa:report/010`. Those reports contained a few mistakes, which have been addressed here.\n",
"\n",
":::\n",
"\n",
Expand Down Expand Up @@ -345,7 +345,7 @@
"\\end{eqnarray}\n",
"$$ (K-hat-and-T-hat)\n",
"\n",
"[^rho-dagger]: An unpublished primer on the $\\boldsymbol{K}$-matrix by Chung {cite}`chungPrimerKmatrixFormalism1995` uses a conjugate transpose of $\\boldsymbol{\\rho}$, e.g. $\\boldsymbol{T} = \\sqrt{\\boldsymbol{\\rho^\\dagger}} \\; \\boldsymbol{\\hat{T}} \\sqrt{\\boldsymbol{\\rho}}$. This should not matter above threshold, where the phase space factor is real, but could have effects below threshold. This is where things become tricky: on the one hand, we need to ensure that $\\boldsymbol{K}$ remains real (unitarity) and on the other, we need to take keep track of which imaginary square root we choose (**Riemann sheet**). The latter is often called the requirement of **analyticity**. This is currently being explored in {doc}`compwa-org:report/003` and {doc}`compwa-org:report/004`.\n",
"[^rho-dagger]: An unpublished primer on the $\\boldsymbol{K}$-matrix by Chung {cite}`chungPrimerKmatrixFormalism1995` uses a conjugate transpose of $\\boldsymbol{\\rho}$, e.g. $\\boldsymbol{T} = \\sqrt{\\boldsymbol{\\rho^\\dagger}} \\; \\boldsymbol{\\hat{T}} \\sqrt{\\boldsymbol{\\rho}}$. This should not matter above threshold, where the phase space factor is real, but could have effects below threshold. This is where things become tricky: on the one hand, we need to ensure that $\\boldsymbol{K}$ remains real (unitarity) and on the other, we need to take keep track of which imaginary square root we choose (**Riemann sheet**). The latter is often called the requirement of **analyticity**. This is currently being explored in {doc}`compwa:report/003` and {doc}`compwa:report/004`.\n",
"\n",
"With these definitions, we can deduce that:\n",
"\n",
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/helicity/spin-alignment.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"As described in {doc}`compwa-org:report/015`, the {doc}`'standard' helicity formalism </usage/helicity/formalism>` is not suited for state transitions that have different decay topologies. For this reason, the {class}`.HelicityAmplitudeBuilder` can insert a number of Wigner-$D$ functions into the amplitude model to 'align' the final state spins of underlying {class}`~qrules.topology.Topology` instances in the full decay.\n",
"As described in {doc}`compwa:report/015`, the {doc}`'standard' helicity formalism </usage/helicity/formalism>` is not suited for state transitions that have different decay topologies. For this reason, the {class}`.HelicityAmplitudeBuilder` can insert a number of Wigner-$D$ functions into the amplitude model to 'align' the final state spins of underlying {class}`~qrules.topology.Topology` instances in the full decay.\n",
"\n",
"Imagine we have the following the decay:"
]
Expand Down Expand Up @@ -406,7 +406,7 @@
"cell_type": "markdown",
"metadata": {},
"source": [
"For more information about these angles, see {ref}`compwa-org:report/015:Compute Wigner rotation angles` in {doc}`TR-015 <compwa-org:report/015>`."
"For more information about these angles, see {ref}`compwa:report/015:Compute Wigner rotation angles` in {doc}`TR-015 <compwa:report/015>`."
]
}
],
Expand Down
4 changes: 2 additions & 2 deletions docs/usage/kinematics.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -277,7 +277,7 @@
},
"source": [
":::{margin}\n",
"This notebook originates from {doc}`compwa-org:report/017`.\n",
"This notebook originates from {doc}`compwa:report/017`.\n",
":::\n",
"\n",
"Kinematics for a three-body decay $0 \\to 123$ can be fully described by two **Mandelstam variables** $\\sigma_1, \\sigma_2$, because the third variable $\\sigma_3$ can be expressed in terms $\\sigma_1, \\sigma_2$, the mass $m_0$ of the initial state, and the masses $m_1, m_2, m_3$ of the final state. As can be seen, the roles of $\\sigma_1, \\sigma_2, \\sigma_3$ are interchangeable.\n",
Expand Down Expand Up @@ -405,7 +405,7 @@
"tags": []
},
"source": [
"See {doc}`compwa-org:report/017` for an interactive visualization of the phase space region and an analytic expression for the phase space boundary."
"See {doc}`compwa:report/017` for an interactive visualization of the phase space region and an analytic expression for the phase space boundary."
]
}
],
Expand Down
4 changes: 2 additions & 2 deletions src/ampform/dynamics/kmatrix.py
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
.. seealso:: :doc:`/usage/dynamics/k-matrix`.
This module is an implementation of :doc:`compwa-org:report/005`,
:doc:`compwa-org:report/009`, and :doc:`compwa-org:report/010`. It works with classes to
This module is an implementation of :doc:`compwa:report/005`,
:doc:`compwa:report/009`, and :doc:`compwa:report/010`. It works with classes to
keep the code organized and to enable caching of the matrix multiplications, but this
might change once these dynamics are implemented into the amplitude builder.
"""
Expand Down
2 changes: 1 addition & 1 deletion src/ampform/helicity/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ class HelicityModel:
helicity combination. These amplitudes are indicated with as `sp.Indexed
<sympy.tensor.indexed.Indexed>` instances and this attribute provides the
definitions for each of these. See also
:ref:`TR-014 <compwa-org:tr-014-solution-2>`.
:ref:`TR-014 <compwa:tr-014-solution-2>`.
"""
parameter_defaults: ParameterValues = field(converter=_to_parameter_values)
"""A mapping of suggested parameter values.
Expand Down
2 changes: 1 addition & 1 deletion src/ampform/sympy/deprecated.py
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ class UnevaluatedExpression(sp.Expr):
1. condense the LaTeX representation of an expression tree by providing a custom
:meth:`_latex` method.
2. overwrite its printer methods (see `.NumPyPrintable` and e.g.
:doc:`compwa-org:report/001`).
:doc:`compwa:report/001`).
The `UnevaluatedExpression` base class makes implementations of its derived classes
more secure by enforcing the developer to provide implementations for these methods,
Expand Down
2 changes: 1 addition & 1 deletion src/ampform/sympy/math.py
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ class ComplexSqrt(NumPyPrintable):
A special version :func:`~sympy.functions.elementary.miscellaneous.sqrt` that
renders nicely as LaTeX and and can be used as a handle for lambdify printers. See
:doc:`compwa-org:report/000`, :doc:`compwa-org:report/001`, and
:doc:`compwa:report/000`, :doc:`compwa:report/001`, and
:doc:`sympy:modules/printing` for how to implement a custom
:func:`~sympy.utilities.lambdify.lambdify` printer.
"""
Expand Down
2 changes: 1 addition & 1 deletion src/symplot/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -394,7 +394,7 @@ def rename_symbols(
def substitute_indexed_symbols(expression: sp.Expr) -> sp.Expr:
"""Substitute `~sympy.tensor.indexed.IndexedBase` with symbols.
See :doc:`compwa-org:report/008` for more info.
See :doc:`compwa:report/008` for more info.
"""
return expression.xreplace({
s: _indexed_to_symbol(s)
Expand Down
2 changes: 1 addition & 1 deletion tests/kinematics/test_phasespace.py
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
],
)
def test_is_within_phasespace(s1, s2, expected):
# See widget https://compwa-org.rtfd.io/report/017.html
# See widget https://compwa.github.io/report/017
m0 = 2.1
m1 = 0.2
m2 = 0.4
Expand Down

0 comments on commit 6912694

Please sign in to comment.