Ligo.skymap

==================

- No changes yet.

==================

- Added options to center ``mollweide`` and ``aitoff`` projections. Thanks go
to Sam Wyatt for this contribution.

- Added support for ``os.PathLike`` filenames when reading ligolw files. Thanks
go to Thomas Sainrat for this contribution.

- Check for more invalid input corner cases in ``ligo.skymap.moc.rasterize``.

- Remove the ``--min-inclination`` and ``max-inclination`` options from
``bayestar-localize-coincs`` and ``bayestar-localize-lvalert``. These options
are rarely used, and will be made obsolete by a future release that adds
inclination posteriors to sky map output.

- Remove ``frameon=False`` in ``ligo-skymap-plot-volume`` so that it respects
the (lack of the) ``--transparent`` option. This improves text and label
readability against dark backgrounds when transparent mode is not on. Thanks
go to Geoffrey Mo for this contribution.

- Add documentation on the LIGO Scientific Collaboration (LSC) review process
to the Testing section of the manual.

- Require Numpy >= 1.23.0. Rebuild for binary compatibility with Numpy 2.0.0.

- Add unit tests for Python 3.12.

==================

- Update for compatibility with Matplotlib 3.8.0.

- Binary wheels for macOS x86_64 are now built against Big Sur (10.15), because
Catalina (11) is past end of life.

- Fix deprecation warnings from importlib.resources.

==================

- Fix a typo in the ``setup.cfg`` file that prevented correct interpretation of
the minimum Python version. Contributed by
`ahnitz <https://github.com/ahnitz>`_.

==================

- Add ``max_depth`` keyword argument to the call to
``MOC.from_valued_healpix_cells`` in ``ligo-skymap-contour-moc``.
Contributed by `parkma99 <https://github.com/parkma99>`_.

- Improve handling of the ``--output`` command line argument for
``ligo-skymap-contour-moc``:

- Add ``-o`` as a short form.

- Don't write to stdout by default; it does not make sense to write a binary
FITS file to stdout.

- Make the argument required.

- Drop dependency on distutils to prepare for its removal in Python 3.12.
See `PEP 632 <https://peps.python.org/pep-0632/>`_.

- Drop support for Python 3.8.

- Vectorize ``find_ellipse`` over the ``cl`` argument.

- Tune compiler settings used to build wheels for PyPI:

- Add the option ``-fvisibility=hidden`` to hide all symbols except for the
Python entry point. This improves the efficiency of link-time optimization.
On average, it speeds up BAYESTAR by about 5%.

- Add the options ``-Ofast -fno-finite-math-only -flto`` on Linux aarch64
and macOS, the targets on which we use gcc. These options approximate the
configuration that we use for icc on Linux x86_64. On average, this change
speeds up BAYESTAR on macOS by about 30%.

- Factor out the Python implementation of the BAYESTAR adaptive mesh refinement
algorithm so that other libraries can use it. It is exposed as
``ligo.skymap.moc.bayestar_adaptive_grid``.

- Fix incorrectly rendered default values for some command line arguments in
the documentation.

- Move coherence plots from GWCelery to ligo.skymap.

==================

- Track an API change in Matplotlib 3.7.0. Update test baseline images.

- Update Linux wheels from manylinux2014 to manylinux_2_28.

- Require scipy ≠ 1.10.0 due to an unplanned API change in that version, which
was fixed in 1.10.1.

- Add unit tests under Python 3.11 to the continuous integration pipeline.