exosim 2.2.0__tar.gz → 2.2.2__tar.gz

exosim-2.2.2/CHANGELOG.rst

@@ -0,0 +1,288 @@
+===========
+Changelog
+===========
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog (keepachangelog_), and this project adheres
+to Semantic Versioning (semver_).
+
+Unreleased changes live as fragments in ``changelog.d/`` and are merged here by
+``nox -s release``. See ``docs/source/contributing/releasing.rst``.
+
+.. scriv-insert-here
+
+.. _changelog-2.2.2:
+
+[2.2.2_] - Fix ACES solar-metallicity SED download
+==================================================
+
+Changed
+-------
+
+- the documentation home page now points readers who only need signal and
+  noise budgets to ExoRad 2, the radiometric model ExoSim 2 builds on
+
+Fixed
+-----
+
+- ``DownloadSed`` with ``model_name="phoenix-aces"`` built a 404 URL for a
+  solar-metallicity star: the Goettingen server names the directory and files
+  ``Z-0.0`` / ``lte...-0.0...``, but the URL builder formatted ``0.0`` as
+  ``+0.0``. Metallicity formatting is now routed through ``_feh_str``.
+
+.. _changelog-2.2.1:
+
+[2.2.1_] - Pipeline hardening
+=============================
+
+Changed
+-------
+
+- user guide and developer guide reworked for clarity: tighter prose, corrected
+  grammar, consistent sentence-case headings, and each mechanism now explains
+  the reason behind it, not just the behaviour
+- home page, user-guide and developer-guide landing pages now share the same
+  card-based navigation with consistent line icons, rendered from
+  reStructuredText instead of hand-written HTML and clip-art
+
+Removed
+-------
+
+- unused documentation dependencies from the ``docs`` extra
+  (``sphinx-rtd-theme``, ``sphinx-panels``, ``sphinxcontrib-napoleon``,
+  ``nbsphinx``, ``myst-parser`` and a few transitive-only pins)
+
+- dead duplicate ``PrepareInstantaneousReadOut.force_power_conservation`` method
+  (the live implementation is in ``InstantaneousReadOut``)
+
+Fixed
+-----
+
+- ``nox -s docs`` and ``nox -s docs-live`` now install the ``docs`` extra, so the
+  documentation builds on a clean checkout (Sphinx and the theme were missing)
+- two broken links on the user-guide landing page
+- several ``note`` and ``warning`` admonitions that were not rendering because
+  their content was not indented
+- broken cross-references to the installation instructions from the quick-start
+  and FAQ pages
+- malformed XML in the custom-task example (``unit`` attributes now quoted) and a
+  duplicate documentation label for pixel non-linearity
+- stale continuous-integration details in the contributing guide (workflow name
+  and supported Python versions)
+- title overline/underline mismatch on the sky-sources page that newer Sphinx
+  rejects
+- corrupted LaTeX in several task docstrings (``\frac``, ``\times`` and similar
+  were being read as escape characters), so the rendered formulae for read
+  noise, dark current noise and the dark-current map are now correct
+- the ExoSim logo no longer overflows and clips the page header
+
+- ``FocalPlanePlotter`` failed with ``KeyError: 'channels'`` on a normal
+  focal-plane output: it looked for ``channels/channels`` instead of
+  ``channels``
+
+- ``exosim.__branch__`` and ``exosim.__commit__`` were always ``None``: the git
+  metadata reader looked for ``.git`` one directory too shallow
+
+- ``InstantaneousReadOut`` in memory-saving mode (``slicing=True``) crashed with
+  ``AttributeError: 'InstantaneousReadOut' object has no attribute
+  'getOversampleFactors'`` whenever the pointing jitter needed sub-pixel
+  magnification; the call now uses the renamed ``get_oversample_factors``
+
+- the target-list mode of ``RadiometricModel`` (a ``targetlist_filepath`` under
+  ``sky/source``) crashed with ``KeyError: component not found``: it rebinned
+  the channel efficiencies from the file root instead of from the per-target
+  ``targets/<name>/channels`` group. The recipe now runs to completion and
+  writes a radiometric table for every target in the list.
+
+- ``RadiometricModel`` and ``CreateFocalPlane`` failed on a payload with a
+  single, unwrapped ``channel`` entry (``KeyError: component not found`` /
+  ``KeyError: 'Photometer'``): the efficiency-rebinning and the
+  foreground/source signal helpers iterated the channel dictionary as if it
+  were the multi-channel mapping. Single-channel configurations now run through
+  the whole radiometric pipeline.
+
+- ``Signal.get_slice`` / ``Signal.set_slice`` now accept a plain ``float``
+  start/end time as documented (assumed to be hours); before they raised
+  ``AttributeError``
+- ``AddGainDrift`` raises a clear ``KeyError`` when neither
+  ``gain_drift_amplitude`` nor the amplitude range is configured, instead of an
+  ``UnboundLocalError``
+- ``EstimatePlanetarySignal`` raises a clear ``ValueError`` when the planet
+  ``rp`` is neither a file path nor a number, instead of an
+  ``UnboundLocalError``
+- ``Channel.target_source`` raises an informative ``KeyError`` when several
+  sources are defined but none (or more than one) is flagged as the science
+  target, instead of an ``IndexError``
+- ``RadiometricModel`` now passes the per-channel configuration to the
+  sub-foreground signal task, so the ``<contribution>_total_signal`` columns are
+  computed for every channel type
+- ``CreateFocalPlane`` infers the wavelength grid from the channel passbands
+  (``channel``/``wl_min``/``wl_max``) when ``wl_grid`` is absent from the
+  configuration; the previous fallback looked up a non-existent ``channels`` key
+  and always used the 1-2 micron default
+- the spectrometer focal-plane builder no longer relies on a fragile
+  buffer-level ``array == zeros`` comparison to detect a flat wavelength axis
+  (in ``CreateFocalPlaneArray._wav_osr`` and the PSF window locator); it now
+  checks the values explicitly
+- ``locate_wavelength_windows`` raises a clear error for an unsupported PSF
+  dimensionality or channel type instead of returning ``None`` (which made the
+  caller fail with an opaque unpacking ``TypeError``)
+- ``EstimateZodi`` no longer loops forever when the bundled ``data`` directory
+  cannot be found by walking up from the module; the search is bounded and
+  raises ``OSError`` if it fails
+- ``AccumulateSubExposures`` corrupted the ramp of a single-exposure
+  acquisition: the first chunk read ``state_machine[-1]`` / ``dataset[-1]`` (the
+  wrapped-around last frame) as its carry-in offset. The first chunk now starts
+  from zero
+- ``AnalogToDigital`` clips the converted signal to the ADC full scale; a bright
+  pixel above full scale with a fixed ADC gain used to wrap around on the
+  integer cast (e.g. 200000 counts became 3392 on a 16-bit ADC)
+- ``AddCosmicRays`` no longer fails with an ``UnboundLocalError`` when the
+  configured ``interaction_shapes`` probabilities sum to less than one; the
+  event shape falls back to the last configured shape
+- ``MergeGroups`` raises a clear error when the number of sub-exposures is not
+  ``n_groups * n_ndrs`` instead of silently mis-averaging a truncated group or
+  raising ``IndexError``
+- ``ComputeSourcesPointingOffset`` computes the source-to-pointing offset with
+  ``SkyCoord.spherical_offsets_to``, so it handles the RA 0/360 wrap and the
+  ``cos(dec)`` foreshortening (a plain RA/Dec difference was wrong away from the
+  equator and near RA = 0); the offset is now rounded to the nearest sub-pixel
+  rather than truncated
+
+Security
+--------
+
+- refreshed the locked dependency versions to pull in security fixes for
+  ``pillow``, ``requests``, ``urllib3``, ``cryptography``, ``idna``,
+  ``jupyter-server``, ``jupyterlab``, ``notebook``, ``nbconvert``, ``mistune``,
+  ``tornado``, ``pygments`` and the ``safety`` toolchain (``authlib``,
+  ``nltk``); this clears the outstanding Dependabot alerts on ``uv.lock``. The
+  release still installs the highest compatible versions for end users, so this
+  only affects reproducible development and CI environments
+
+.. _changelog-2.2.0:
+
+[2.2.0_] - End-to-end simulations
+=================================
+
+Added
+-----
+
+- new recipe ``SimulateObservation`` to run the full simulation pipeline from an options file to the NDRs
+- radiometric model now supports target-list mode
+- new documentation section for the radiometric model with a detailed description of the pipeline and operating modes
+- observation efficiency can now be specified in the options file
+- ``slim_output`` option for recipes to reduce output file size by dropping intermediate data products
+- SED download task to fetch stellar spectra from online databases (currently Phoenix models only)
+
+Changed
+-------
+
+- ``fast_convolution`` now uses ``scipy.signal.fftconvolve`` for better performance and accuracy
+- saturation time now includes the well-depth fraction; integration time is the minimum saturation time across the detector; frame time is integration time divided by observation efficiency
+- photon noise is now computed on the observation-efficiency-corrected signal
+- packaging and dependency management moved from Poetry to uv
+- logging moved to ``structlog``
+- ``wl_interpolate`` reworked to use argsort + inverse mapping, avoiding O(n^2) lookups and extra copies
+- ExoSim can now run without any source (no input SED)
+- versioning is now derived from git tags via setuptools-scm; releases are cut with ``nox -s release``
+
+Fixed
+-----
+
+- normalization in ``Signal`` now handles custom units correctly
+- foreground is now decimated before being added to the focal plane instead of summed
+- inverted parameters in the wavelength-centering equation, to avoid a polynomial inversion
+- wrong wavelength order for ``loadPsfPaos``
+
+[2.1.1_] - CLI Fixed
+====================
+Fixed
+-----
+- missing summary for cli.
+
+[2.1.0_] - Hello Python 3.12
+============================
+Added
+-----
+- added unit normalization in Signal
+
+Changed
+-------
+- dropped support for Python 3.9 and 3.10. Now supports only Python >3.12
+- test framework changed into pytest
+- added default value for low frequency time grid
+
+
+
+[2.0.1_] - stable release
+=========================
+Added
+-----
+- improved exosim CLI with new click commands
+- option to load optical elements from .hdf5 files (LoadOpticalElementHDF5)
+- option to parse options file replacing a custom keyword with a value (LoadOptions)
+- added codemeta.json file for better metadata management
+- warning for misuse of oversampling factor and intra-pixel response function
+- added support for wavelength dependent limb darkening
+Changed
+-------
+- updated citation information
+- rp in astronomical signal is now binned with the same binning method as Signal
+Fixed
+-----
+- Custom SED units and documentation (added missing angle in loadCustom.py)
+- find keys is not case sensitive anymore
+- cosmic rays now work for low rates
+- fixed elliptical PSF from PAOS
+- ADC offset implemented as trigger offset (no negative values)
+- astronomical signal now is weighted by the stellar flux on the detector
+
+[2.0.0-rc2_] - ADC automode fix and minor improvements
+======================================================
+Added
+-----
+- boundaries for random amplitude in gain noise
+- option to force non-time-dependent PSF for LoadPsfPaos (`time_dependence` parameter to `False`)
+- option to slice jitter to save memory when the focal plane is sampled at high frequencies (`slicing` parameter to `True`)
+Changed
+-------
+- dependencies versions updated to support `Poetry` for Python 3.10
+Fixed
+-----
+- added offset and "auto" mode to ADC
+- removed Numba in populateFocalPlane (better numerical accuracy)
+- interp2d replaced with RectBivariateSpline in LoadPsfPaos to support Scipy 1.10+
+
+[2.0.0-rc1_] - Scipy compatibility fix
+======================================
+Added
+-----
+- .npy input support for pixel non-linearity coefficients (LoadPixelsNonLinearityMapNumpy)
+- multiplicative noise simulator (AddGainNoise)
+
+Fixed
+-----
+- replaced scipy.convolve with scipy.signal.convolve
+- ADC now works with unsigned integers
+
+[v2.0.0-rc0_] - Release Candidate
+================================
+Cleaned repository
+
+.. _v2.0.0-rc0: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.0.0-rc0
+.. _2.0.0-rc1: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.0.0-rc1
+.. _2.0.0-rc2: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.0.0-rc2
+.. _2.0.1: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.0.1
+.. _2.1.0: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.1.0
+.. _2.1.1: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.1.1
+
+.. _2.2.0: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.2.0
+
+.. _2.2.1: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.2.1
+
+.. _2.2.2: https://github.com/arielmission-space/ExoSim2.0/releases/tag/v2.2.2
+
+.. _keepachangelog: https://keepachangelog.com/en/1.0.0/
+.. _semver: https://semver.org/spec/v2.0.0.html

{exosim-2.2.0 → exosim-2.2.2}/CITATION.cff

@@ -18,5 +18,5 @@ authors:
 
 title: "ExoSim 2: the new exoplanet observation simulator applied to the Ariel space mission"
 doi: 10.1007/s10686-024-09976-2
-version: 2.2.0
-date-released: 2026-08-27
+version: 2.2.2
+date-released: 2026-11-12

{exosim-2.2.0 → exosim-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exosim
-Version: 2.2.0
+Version: 2.2.2
 Summary: ExoSim 2 is the next generation of the Exoplanet Observation Simulator (ExoSim) tailored for spectro-photometric observations of transiting exoplanets from space, ground, and sub-orbital platforms. This software is a complete rewrite implemented in Python 3, embracing object-oriented design principles.
 Author: E. Pascale, A. Bocchieri, A. Lorenzani, A. Papageorgiou
 Author-email: "L. V. Mugnai" <mugnail@cardiff.ac.uk>
@@ -58,18 +58,10 @@ Requires-Dist: safety>=3.2.11; extra == "dev"
 Requires-Dist: bandit>=1.8.0; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: sphinx>=8.1.3; extra == "docs"
-Requires-Dist: sphinx-rtd-theme>=3.0.2; extra == "docs"
-Requires-Dist: sphinxcontrib-napoleon; extra == "docs"
-Requires-Dist: sphinxcontrib-jsmath; extra == "docs"
-Requires-Dist: nbsphinx; extra == "docs"
-Requires-Dist: sphinx-panels; extra == "docs"
+Requires-Dist: pydata-sphinx-theme; extra == "docs"
 Requires-Dist: sphinx-autoapi; extra == "docs"
 Requires-Dist: sphinx-autobuild; extra == "docs"
 Requires-Dist: sphinx-design; extra == "docs"
-Requires-Dist: sphinxcontrib-serializinghtml; extra == "docs"
-Requires-Dist: docutils; extra == "docs"
-Requires-Dist: pydata-sphinx-theme; extra == "docs"
-Requires-Dist: myst-parser>=4.0.0; extra == "docs"
 Provides-Extra: jupyter
 Requires-Dist: pyzmq<27,>=26; extra == "jupyter"
 Requires-Dist: notebook; extra == "jupyter"
@@ -90,6 +82,8 @@ Dynamic: license-file
 [![DOI](https://img.shields.io/badge/doi-10.1007%2Fs10686--024--09976--2-blue?link=https%3A%2F%2Fdoi.org%2F10.1007%2Fs10686-024-09976-2)](https://doi.org/10.1007/s10686-024-09976-2)
 [![arXiv](https://img.shields.io/badge/arXiv-2501.12809-red?link=https%3A%2F%2Farxiv.org%2Fabs%2F2501.12809)](https://arxiv.org/abs/2501.12809)
 [![EMACS](https://img.shields.io/badge/EMAC-2504--003-blue)](https://emacs.gsfc.nasa.gov?cid=2504-003)
+[![Ask DeepWiki](https://img.shields.io/badge/DeepWiki-Ask-0a7bbb)](https://deepwiki.com/arielmission-space/ExoSim2-public)
+[![GitDiagram](https://img.shields.io/badge/GitDiagram-architecture-4c1)](https://gitdiagram.com/arielmission-space/ExoSim2-public)
 
 
 ## Introduction <a name="introduction"></a>
@@ -145,6 +139,14 @@ If you have installed ExoSim from source code, to test your ExoSim 2 installatio
 
 ExoSim2 comes with an extensive documentation, which can be built using Sphinx.
 The documentation includes a tutorial, a user guide and a reference guide.
+The published documentation is at <https://exosim2-public.readthedocs.io/>.
+
+An AI-generated overview of the codebase is also available on
+[DeepWiki](https://deepwiki.com/arielmission-space/ExoSim2-public), and an
+interactive architecture diagram on
+[GitDiagram](https://gitdiagram.com/arielmission-space/ExoSim2-public). Both are
+generated automatically from the code and may be out of date or inaccurate: the
+documentation is the reference.
 
 To build the documentation, install the needed packages first via `uv`:
 

{exosim-2.2.0 → exosim-2.2.2}/README.md

@@ -10,6 +10,8 @@
 [![DOI](https://img.shields.io/badge/doi-10.1007%2Fs10686--024--09976--2-blue?link=https%3A%2F%2Fdoi.org%2F10.1007%2Fs10686-024-09976-2)](https://doi.org/10.1007/s10686-024-09976-2)
 [![arXiv](https://img.shields.io/badge/arXiv-2501.12809-red?link=https%3A%2F%2Farxiv.org%2Fabs%2F2501.12809)](https://arxiv.org/abs/2501.12809)
 [![EMACS](https://img.shields.io/badge/EMAC-2504--003-blue)](https://emacs.gsfc.nasa.gov?cid=2504-003)
+[![Ask DeepWiki](https://img.shields.io/badge/DeepWiki-Ask-0a7bbb)](https://deepwiki.com/arielmission-space/ExoSim2-public)
+[![GitDiagram](https://img.shields.io/badge/GitDiagram-architecture-4c1)](https://gitdiagram.com/arielmission-space/ExoSim2-public)
 
 
 ## Introduction <a name="introduction"></a>
@@ -65,6 +67,14 @@ If you have installed ExoSim from source code, to test your ExoSim 2 installatio
 
 ExoSim2 comes with an extensive documentation, which can be built using Sphinx.
 The documentation includes a tutorial, a user guide and a reference guide.
+The published documentation is at <https://exosim2-public.readthedocs.io/>.
+
+An AI-generated overview of the codebase is also available on
+[DeepWiki](https://deepwiki.com/arielmission-space/ExoSim2-public), and an
+interactive architecture diagram on
+[GitDiagram](https://gitdiagram.com/arielmission-space/ExoSim2-public). Both are
+generated automatically from the code and may be out of date or inaccurate: the
+documentation is the reference.
 
 To build the documentation, install the needed packages first via `uv`:
 

{exosim-2.2.0 → exosim-2.2.2}/RELEASING.md

@@ -15,14 +15,14 @@ Full guide: `docs/source/contributing/releasing.rst`
   nox -s release
   ```
 
-  It asks major/minor/patch, folds the changelog fragments in, updates
-  `CITATION.cff` / `codemeta.json`, commits, fast-forwards `main`, and pushes the
-  `vX.Y.Z` tag.
+  It asks major/minor/patch **and a short release name**, folds the changelog
+  fragments in, updates `CITATION.cff` / `codemeta.json`, commits, fast-forwards
+  `main`, and pushes the `vX.Y.Z` tag.
 
 - The tag triggers `.github/workflows/release.yml`:
-  build → TestPyPI → verify install → PyPI → GitHub Release.
-  Then `sync-to-public.yml` mirrors `main` to `ExoSim2-public` and copies the
-  release there.
+  build → TestPyPI → verify install → PyPI → GitHub Release → clone of the
+  tag + release + wheels into `ExoSim2-public`.
+  `sync-to-public.yml` mirrors the `main` code on every push.
 
 ## One-time setup
 

{exosim-2.2.0 → exosim-2.2.2}/codemeta.json

@@ -40,12 +40,12 @@
     "license": "https://spdx.org/licenses/BSD-3-Clause",
     "name": "ExoSim2",
     "programmingLanguage": "Python 3",
-    "version": "2.2.0",
+    "version": "2.2.2",
     "codemeta:contIntegration": {
         "id": "https://app.codecov.io/gh/arielmission-space/ExoSim2-public"
     },
     "continuousIntegration": "https://app.codecov.io/gh/arielmission-space/ExoSim2-public",
     "issueTracker": "https://github.com/arielmission-space/ExoSim2-public/issues",
     "referencePublication": "https://link.springer.com/article/10.1007/s10686-024-09976-2",
-    "dateModified": "2026-08-27"
+    "dateModified": "2026-11-12"
 }

{exosim-2.2.0 → exosim-2.2.2}/pyproject.toml

@@ -84,18 +84,10 @@ dev = [
 
 docs = [
     "sphinx>=8.1.3",
-    "sphinx-rtd-theme>=3.0.2",
-    "sphinxcontrib-napoleon",
-    "sphinxcontrib-jsmath",
-    "nbsphinx",
-    "sphinx-panels",
+    "pydata-sphinx-theme",
     "sphinx-autoapi",
     "sphinx-autobuild",
     "sphinx-design",
-    "sphinxcontrib-serializinghtml",
-    "docutils",
-    "pydata-sphinx-theme",
-    "myst-parser>=4.0.0",
 ]
 
 jupyter = [
@@ -323,6 +315,10 @@ exclude_lines = [
     "if __name__ == \\.__main__\\.",
     "class .*\\bProtocol\\):",
     "@(abc\\.)?abstractmethod",
+    # numba-compiled kernels: coverage.py cannot trace into JIT-compiled code,
+    # so the decorated function bodies are excluded. They are still exercised
+    # behaviourally by the detector, sub-exposure and instrument test suites.
+    "^\\s*@(jit|njit)\\(",
 ]
 ignore_errors = true
 show_missing = true

exosim-2.2.2/scripts/changelog_extract.py

@@ -0,0 +1,74 @@
+#!/usr/bin/env python3
+"""Read the CHANGELOG.rst entry for a given version (used to build release notes).
+
+Usage:
+    python scripts/changelog_extract.py 2.2.0            # print the entry body
+    python scripts/changelog_extract.py 2.2.0 --title    # print just the title
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+CHANGELOG = Path(__file__).resolve().parent.parent / "CHANGELOG.rst"
+
+
+def _find_heading(lines: list[str], version: str) -> int | None:
+    for i, line in enumerate(lines):
+        if line.startswith((f"[{version}]", f"[{version}_]")):
+            return i
+    return None
+
+
+def extract_title(version: str) -> str:
+    """Return the human part of the heading, e.g. "CLI fixes" from
+    ``[2.1.1_] - CLI fixes``. Falls back to the bare version."""
+    lines = CHANGELOG.read_text().splitlines()
+    i = _find_heading(lines, version)
+    if i is None:
+        return version
+    heading = lines[i]
+    _, _, rest = heading.partition("] - ")
+    rest = rest.strip()
+    return rest or version
+
+
+def extract_body(version: str) -> str:
+    lines = CHANGELOG.read_text().splitlines()
+    start = _find_heading(lines, version)
+    if start is None:
+        return f"Release {version}.\n"
+
+    body: list[str] = []
+    for line in lines[start + 2 :]:  # skip heading + its underline
+        stripped = line.strip()
+        if stripped.startswith("[") and "]" in stripped:
+            break
+        if stripped.startswith((".. _", ".. scriv")):
+            break
+        body.append(line)
+
+    while body and not body[0].strip():
+        body.pop(0)
+    while body and not body[-1].strip():
+        body.pop()
+    return "\n".join(body) + "\n"
+
+
+def main() -> int:
+    args = sys.argv[1:]
+    want_title = "--title" in args
+    args = [a for a in args if a != "--title"]
+    if len(args) != 1:
+        sys.stderr.write("usage: changelog_extract.py <version> [--title]\n")
+        return 2
+    version = args[0]
+    sys.stdout.write(extract_title(version) if want_title else extract_body(version))
+    if want_title:
+        sys.stdout.write("\n")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

{exosim-2.2.0 → exosim-2.2.2}/scripts/release.py

@@ -140,6 +140,15 @@ def choose_part(cli_part: str | None) -> str:
         print("  please answer 'major', 'minor' or 'patch'")
 
 
+def choose_title() -> str:
+    """Ask for a short human name for the release (e.g. 'CLI fixes')."""
+    while True:
+        title = input("Release name (short, e.g. 'CLI fixes'): ").strip()
+        if title:
+            return title
+        print("  a release name is required")
+
+
 # --------------------------------------------------------------------------- #
 # Quality gate
 # --------------------------------------------------------------------------- #
@@ -154,20 +163,33 @@ def quality_gate() -> None:
 # --------------------------------------------------------------------------- #
 # Changelog + metadata
 # --------------------------------------------------------------------------- #
-def collect_changelog(version: str) -> None:
-    run("uv", "run", "scriv", "collect", "--version", version)
+def collect_changelog(version: str, title: str) -> None:
+    heading = f"[{version}_] - {title}"
 
     changelog = REPO_ROOT / "CHANGELOG.rst"
+    if f"[{version}_]" in changelog.read_text():
+        raise ReleaseError(f"CHANGELOG.rst already has an entry for {version}")
+
+    # scriv >= 1.8 refuses --version together with --title. We want a named
+    # heading (not the date-based default from ``entry_title_template``), so we
+    # pass only --title and add the ``.. _changelog-<version>:`` cross-reference
+    # anchor ourselves -- scriv only emits that on the --version code path.
+    run("uv", "run", "scriv", "collect", "--title", heading)
+
     text = changelog.read_text()
 
+    anchor = f".. _changelog-{version}:"
+    if anchor not in text:
+        text = text.replace(f"{heading}\n", f"{anchor}\n\n{heading}\n", 1)
+
     link = f".. _{version}: {TAG_URL.format(version=version)}\n"
     if link not in text:
         marker = "\n.. _keepachangelog:"
         if marker not in text:
             raise ReleaseError("could not find the link block in CHANGELOG.rst")
         text = text.replace(marker, f"\n{link}{marker}", 1)
-        changelog.write_text(text)
 
+    changelog.write_text(text)
     (REPO_ROOT / "docs" / "source" / "CHANGELOG.rst").write_text(text)
 
 
@@ -204,10 +226,10 @@ def update_codemeta(version: str, today: str) -> None:
 # --------------------------------------------------------------------------- #
 # Git release
 # --------------------------------------------------------------------------- #
-def commit_and_tag(version: str) -> None:
+def commit_and_tag(version: str, title: str) -> None:
     tag = f"v{version}"
     git("add", "-A", capture=False)
-    git("commit", "-m", f"docs: release {version}", capture=False)
+    git("commit", "-m", f"docs: release {version} — {title}", capture=False)
 
     print("\nChanges staged for the release commit:")
     print(git("show", "--stat", "HEAD"))
@@ -240,11 +262,17 @@ def commit_and_tag(version: str) -> None:
             f"git push {REMOTE} {tag}"
         )
 
-    git("tag", "-a", tag, "-m", f"Release {version}", capture=False)
+    git("tag", "-a", tag, "-m", f"{version} — {title}", capture=False)
     git("push", REMOTE, tag, capture=False)
 
-    print(f"\n✅ Tag {tag} pushed. Release pipeline: {ACTIONS_URL}")
-    print(f"   GitHub Release will appear at: {TAG_URL.format(version=version)}")
+    print(f"\n✅ Tag {tag} pushed. The release pipeline now runs:")
+    print(f"   {ACTIONS_URL}")
+    print("   build → TestPyPI → verify → PyPI → GitHub Release →")
+    print(
+        "   clone of the tag + release + wheels into arielmission-space/ExoSim2-public"
+    )
+    print(f"\n   GitHub Release: {TAG_URL.format(version=version)}")
+    print(f"   PyPI:           https://pypi.org/project/exosim/{version}/")
 
 
 # --------------------------------------------------------------------------- #
@@ -271,8 +299,9 @@ def main(argv: list[str] | None = None) -> int:
         current = latest_stable()
         part = choose_part(args.part)
         version = next_version(current, part)
+        title = choose_title()
         cur_str = ".".join(str(x) for x in current)
-        print(f"\nRelease: {cur_str} -> {version} ({part})")
+        print(f"\nRelease: {cur_str} -> {version} ({part}) — {title!r}")
         if not confirm("Proceed?"):
             raise ReleaseError("cancelled")
 
@@ -282,10 +311,10 @@ def main(argv: list[str] | None = None) -> int:
             quality_gate()
 
         today = dt.date.today().isoformat()
-        collect_changelog(version)
+        collect_changelog(version, title)
         update_citation(version, today)
         update_codemeta(version, today)
-        commit_and_tag(version)
+        commit_and_tag(version, title)
     except ReleaseError as exc:
         print(f"\n✗ {exc}", file=sys.stderr)
         return 1

{exosim-2.2.0 → exosim-2.2.2}/src/exosim/__about__.py

@@ -165,7 +165,10 @@ def _get_git_info() -> tuple[str | None, str | None]:
         tuple: (branch_name, commit_hash) or (None, None) if not in git repo
     """
     try:
-        base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        # __file__ is <root>/src/exosim/__about__.py -> walk up to <root>
+        base_dir = os.path.dirname(
+            os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+        )
     except NameError:
         return None, None
 

{exosim-2.2.0 → exosim-2.2.2}/src/exosim/models/channel.py

@@ -295,13 +295,19 @@ class Channel(log.Logger):
         target = [
             source
             for source, param in self.sources.items()
-            if "source_target" in param.metadata["parsed_parameters"]
-            and param.metadata["parsed_parameters"]["source_target"]
+            if param.metadata.get("parsed_parameters", {}).get("source_target")
         ]
+        if not target:
+            self.error(
+                "Multiple sources are defined but none is flagged as the science "
+                "target. Set 'source_target' on one source in the input file."
+            )
+            raise KeyError("no source is flagged as 'source_target'")
         if len(target) > 1:
             self.error(
                 "More than one target source found. Please check your input file."
             )
+            raise KeyError("more than one source is flagged as 'source_target'")
         self.debug(f"Target source is {target[0]}")
         return target[0]