.. currentmodule:: xarray

What's new
==========
0.6.0 (31 Aug 2025)
-------------------
- Bump dependency versions (:pull:`313`):

  ============ ==============  ==============
   dependency    old minimum     new minimum
  ============ ==============  ==============
   python              3.10             3.11
   xarray         2022.06.0        2023.07.0
   numpy               1.23             1.26
   pint                0.21             0.24
  ============ ==============  ==============

  By `Justus Magin <https://github.com/keewis>`_.
- Switch to using pixi for all dependency management (:pull:`314`).
  By `Justus Magin <https://github.com/keewis>`_.
- Added the :py:func:`pint_xarray.expects` decorator to allow wrapping quantity-unaware functions (:issue:`141`, :pull:`316`).
  By `Justus Magin <https://github.com/keewis>`_ and `Tom Nicholas <https://github.com/TomNicholas>`_.
- Follow the change in signature of :py:meth:`xarray.Index.equals` (:issue:`322`, :pull:`324`)
  By `Justus Magin <https://github.com/keewis>`_.
- Add units to the inline ``repr`` and define a custom ``repr`` (:issue:`308`, :pull:`325`)
  By `Justus Magin <https://github.com/keewis>`_.
- Collect multiple errors into a specific exception group (:pull:`329`)
  By `Justus Magin <https://github.com/keewis>`_.

0.5.1 (10 Aug 2025)
-------------------
- Pass ``sel`` options to the wrapped array (:pull:`304`, :issue:`303`)
  By `Bhavin Patel <https://github.com/bpatel2107>`_.
- Support python 3.13 (:pull:`310`)
  By `Justus Magin <https://github.com/keewis>`_.

0.5 (09 Jun 2025)
------------------
- drop support for python 3.9 (:pull:`266`)
  By `Justus Magin <https://github.com/keewis>`_.
- create a `PintIndex` to allow units on indexed coordinates (:pull:`163`, :issue:`162`)
  By `Justus Magin <https://github.com/keewis>`_ and `Benoit Bovy <https://github.com/benbovy>`_.
- fix :py:meth:`Dataset.pint.interp` and :py:meth:`DataArray.pint.interp` bug
  failing to pass through arguments (:pull:`270`, :issue:`267`)
  By `Martijn van der Marel <https://github.com/martijnvandermarel>`_

0.4 (23 Jun 2024)
-----------------
- adopt `SPEC0 <https://scientific-python.org/specs/spec-0000>`_ (:pull:`228`)

  This means that the supported versions change:

  ============ ==============  ==============
   dependency    old minimum     new minimum
  ============ ==============  ==============
   python               3.8              3.9
   xarray            0.16.1        2022.06.0
   numpy               1.17             1.23
   pint                0.16             0.21
  ============ ==============  ==============

  By `Justus Magin <https://github.com/keewis>`_.
- add support for python 3.11 and 3.12 (:pull:`228`, :pull:`263`)
  By `Justus Magin <https://github.com/keewis>`_.
- ignore datetime units on attributes (:pull:`241`)
  By `Justus Magin <https://github.com/keewis>`_.

0.3 (27 Jul 2022)
-----------------
- drop support for python 3.7 (:pull:`153`)
  By `Justus Magin <https://github.com/keewis>`_.
- add support for python 3.10 (:pull:`155`)
  By `Justus Magin <https://github.com/keewis>`_.
- preserve :py:class:`pandas.MultiIndex` objects (:issue:`164`, :pull:`168`).
  By `Justus Magin <https://github.com/keewis>`_.
- fix "quantifying" dimension coordinates (:issue:`105`, :pull:`174`).
  By `Justus Magin <https://github.com/keewis>`_.
- allow using :py:meth:`DataArray.pint.quantify` and :py:meth:`Dataset.pint.quantify`
  as identity operators (:issue:`47`, :pull:`175`).
  By `Justus Magin <https://github.com/keewis>`_.

0.2.1 (26 Jul 2021)
-------------------
- allow special "no unit" values in :py:meth:`Dataset.pint.quantify` and
  :py:meth:`DataArray.pint.quantify` (:pull:`125`)
  By `Justus Magin <https://github.com/keewis>`_.
- convert the note about dimension coordinates saving their units in the attributes a
  warning (:issue:`124`, :pull:`126`)
  By `Justus Magin <https://github.com/keewis>`_.
- improve the documentation on the ``format`` parameter of :py:meth:`Dataset.pint.dequantify`
  and :py:meth:`DataArray.pint.dequantify` (:issue:`121`, :pull:`127`, :pull:`132`)
  By `Justus Magin <https://github.com/keewis>`_.
- use `cf-xarray <https://github.com/xarray-contrib/cf-xarray>`_'s unit registry in the
  plotting example (:issue:`107`, :pull:`128`).
  By `Justus Magin <https://github.com/keewis>`_.

0.2 (May 10 2021)
-----------------
- rewrite :py:meth:`Dataset.pint.quantify` and :py:meth:`DataArray.pint.quantify`, to
  use pint's ``UnitRegistry.parse_units`` instead of ``UnitRegistry.parse_expression``
  (:issue:`40`)
  By `Tom Nicholas <https://github.com/TomNicholas>`_.
- ensure the variables which causes the error is explicit if an error occurs in
  :py:meth:`Dataset.pint.quantify` and other methods (:pull:`43`, :issue:`91`)
  By `Tom Nicholas <https://github.com/TomNicholas>`_ and `Justus Magin <https://github.com/keewis>`_.
- refactor the internal conversion functions (:pull:`56`)
  By `Justus Magin <https://github.com/keewis>`_.
- allow converting indexes (except :py:class:`pandas.MultiIndex`) (:pull:`56`)
  By `Justus Magin <https://github.com/keewis>`_.
- document the reason for requiring the ``force_ndarray_like`` or ``force_ndarray``
  options on unit registries (:pull:`59`)
  By `Justus Magin <https://github.com/keewis>`_.
- allow passing a format string to :py:meth:`Dataset.pint.dequantify` and
  :py:meth:`DataArray.pint.dequantify` (:pull:`49`)
  By `Justus Magin <https://github.com/keewis>`_.
- allow converting all data variables in a Dataset to the same units using
  :py:meth:`Dataset.pint.to` (:issue:`45`, :pull:`63`).
  By `Mika Pflüger <https://github.com/mikapfl>`_.
- update format of examples in docstrings (:pull:`64`).
  By `Mika Pflüger <https://github.com/mikapfl>`_.
- implement :py:meth:`Dataset.pint.sel` and :py:meth:`DataArray.pint.sel` (:pull:`60`).
  By `Justus Magin <https://github.com/keewis>`_.
- implement :py:attr:`Dataset.pint.loc` and :py:attr:`DataArray.pint.loc` (:pull:`79`).
  By `Justus Magin <https://github.com/keewis>`_.
- implement :py:meth:`Dataset.pint.drop_sel` and :py:meth:`DataArray.pint.drop_sel` (:pull:`73`).
  By `Justus Magin <https://github.com/keewis>`_.
- implement :py:meth:`Dataset.pint.chunk` and :py:meth:`DataArray.pint.chunk` (:pull:`83`).
  By `Justus Magin <https://github.com/keewis>`_.
- implement :py:meth:`Dataset.pint.reindex`, :py:meth:`Dataset.pint.reindex_like`,
  :py:meth:`DataArray.pint.reindex` and :py:meth:`DataArray.pint.reindex_like` (:pull:`69`).
  By `Justus Magin <https://github.com/keewis>`_.
- implement :py:meth:`Dataset.pint.interp`, :py:meth:`Dataset.pint.interp_like`,
  :py:meth:`DataArray.pint.interp` and :py:meth:`DataArray.pint.interp_like`
  (:pull:`72`, :pull:`76`, :pull:`97`).
  By `Justus Magin <https://github.com/keewis>`_.
- implement :py:meth:`Dataset.pint.ffill`, :py:meth:`Dataset.pint.bfill`,
  :py:meth:`DataArray.pint.ffill` and :py:meth:`DataArray.pint.bfill` (:pull:`78`).
  By `Justus Magin <https://github.com/keewis>`_.
- implement :py:meth:`Dataset.pint.interpolate_na` and :py:meth:`DataArray.pint.interpolate_na` (:pull:`82`).
  By `Justus Magin <https://github.com/keewis>`_.
- expose :py:func:`pint_xarray.setup_registry` as public API (:pull:`89`)
  By `Justus Magin <https://github.com/keewis>`_.

v0.1 (October 26 2020)
----------------------
- add initial draft of documentation (:pull:`13`, :pull:`20`)
- implement :py:meth:`DataArray.pint.to` and :py:meth:`Dataset.pint.to`
  (:pull:`11`)
- rewrite :py:meth:`DataArray.pint.quantify`,
  :py:meth:`Dataset.pint.quantify`, :py:meth:`DataArray.pint.dequantify` and
  :py:meth:`Dataset.pint.dequantify` (:pull:`17`)
- expose :py:func:`pint_xarray.testing.assert_units_equal` as public API (:pull:`24`)
- fix the :py:attr:`DataArray.pint.units`, :py:attr:`DataArray.pint.magnitude`
  and :py:attr:`DataArray.pint.dimensionality` properties and add docstrings for
  all three. (:pull:`31`)
- use ``pint``'s application registry as a module-global registry (:pull:`32`)