From 0dd2fb9f5c4ee34d590b791469e730f170cc189f Mon Sep 17 00:00:00 2001 From: Nicolas Tessore Date: Fri, 15 Nov 2024 16:37:04 +0000 Subject: [PATCH] gh-390: release 2024.2 (#426) This is the release PR for v2024.2. Closes: #390 --- CHANGELOG.md | 20 ++++++++++++++++++-- CONTRIBUTING.md | 20 +++++++++----------- docs/manual/releases.rst | 40 ++++++++++++++++++++++++++++++++++++++-- 3 files changed, 65 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4db2d737..8ef08157 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,8 +2,23 @@ # Changelog -All notable changes to the project are documented in this file. The format is -based on [Keep a Changelog](https://keepachangelog.com). +All functional changes to the project are documented in this file. + +## [2024.2] (15 Nov 2024) + +- gh-188: add docstrings to all functions and tidy docs (#381) +- gh-336: support Python 3.13 (#337) +- gh-358: add static types support (#368) +- gh-131: rename `gaussian_gls` to `discretized_cls` (#345) +- gh-328: efficient resampling in `ellipticity_ryden04` (#341) +- gh-137: deprecate `redshifts_from_nz` in favor of `redshifts` (#333) +- gh-328: fix shape mismatch bug in ellipticity_ryden04 (#332) +- gh-315: add broadcasting rule in ellipticity_ryden04 + tests (#317) +- gh-198: enforce `python>3.8` & `numpy>1.21` (#326) +- gh-260: remove glass.core.constants (#261) +- gh-107: add all public functions/classes under glass namespace (#221) +- gh-168: move examples into repository (#169) +- gh-156: add FITS catalogue writer tool (#158) ## [2024.1] (16 Jul 2024) @@ -143,6 +158,7 @@ based on [Keep a Changelog](https://keepachangelog.com). - Initial wide release for GLASS paper +[2024.2]: https://github.com/glass-dev/glass/compare/v2024.1...v2024.2 [2024.1]: https://github.com/glass-dev/glass/compare/v2023.7...v2024.1 [2023.7]: https://github.com/glass-dev/glass/compare/v2023.6...v2023.7 [2023.6]: https://github.com/glass-dev/glass/compare/v2023.5...v2023.6 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8d24598d..efd3b302 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -101,12 +101,12 @@ any browser by opening the `index.html` file. ## Releases -To release a new version of _GLASS_, there should be a commit titled -`REL: glass yyyy.mm` that includes the following changes: +To release a new version of _GLASS_, there should be a commit that includes the +following changes: -- The changelog trailers since the last release are parsed into the - [changelog](CHANGELOG.md) under a section titled `[yyyy.mm] (DD Mon YYYY)`. A - new link to the changeset is added at the bottom of the file. +- The changes since the last release are added to the [changelog](CHANGELOG.md) + under a section titled `[yyyy.mm] (DD Mon YYYY)`. A new link to the changeset + is added at the bottom of the file. - The [release notes](docs/manual/releases.rst) are updated with the new version. The release notes should translate the changelog entries into prose that can be understood by non-developer users of the code. If there are @@ -129,14 +129,12 @@ PyPI. _GLASS_ follows [CalVer](https://calver.org). There is no difference between releases that increment the year and releases that increment the month; in particular, releases that increment the month may introduce breaking changes. -The version is generate dynamically through VCS using -[`hatch-vcs`](https://github.com/ofek/hatch-vcs). -The target is to have a new _GLASS_ release at the beginning of each month, as -long as there have been changes. +The current version number is automatically inferred from the last release +(i.e., git tag), subsequent unreleased commits, and local changes, if any. -The current version number is automatically inferred from the last release (i.e. -git tag), subsequent unreleased commits, and local changes, if any. +The target is to have a new _GLASS_ release once there are significant changes +to the code's functionality. ## Nox diff --git a/docs/manual/releases.rst b/docs/manual/releases.rst index 69c0e3d0..8356625f 100644 --- a/docs/manual/releases.rst +++ b/docs/manual/releases.rst @@ -5,8 +5,44 @@ Release notes These notes document the changes between individual *GLASS* releases. -2024.1 (16 Jul 2024) ---------------------- +2024.2 (15 Nov 2024) +-------------------- + +* All GLASS user functionality is now available directly from the main + ``glass`` namespace. No more imports! + +* Changes to the functions dealing with Gaussian spectra: + + * ``gaussian_gls()`` was renamed to :func:`glass.discretized_cls`, which + better reflects what the function does. + + * The implicit call to :func:`glass.discretized_cls` was removed from + :func:`glass.lognormal_gls`. Call :func:`glass.discretized_cls` explicitly + with the desired ``ncorr=``, ``lmax=``, and ``nside=`` parameters. + +* ``redshifts_from_nz()`` is deprecated in favour of :func:`glass.redshifts`, + as the former is almost never the right choice: the two-point statistics in a + linear bias model are coming from the shells, so the redshift distribution is + implicitly the same as the radial profile of the shells. + +* Several fixes to :func:`glass.ellipticity_ryden04`. + +* Added a FITS catalogue writer tool :func:`glass.write_catalog`. + +* Much improved documentation with docstring for all functions. + +* Examples now live in the main GLASS repository and documentation. + +* GLASS is now fully typed and passes mypy. + +* Python 3.13 is now supported. Python 3.8 and NumPy 1.21 are no longer + supported. + +* The ``glass.core.constants`` module was removed. + + +2024.1 (16 Jul 2024) +-------------------- * Further changes to the :func:`~glass.shells.partition()` function.