What’s new

0.5 (09 Jun 2025)

• drop support for python 3.9 (PR266) By Justus Magin.

• create a PintIndex to allow units on indexed coordinates (PR163, GH162) By Justus Magin and Benoit Bovy.

• fix Dataset.pint.interp() and DataArray.pint.interp() bug failing to pass through arguments (PR270, GH267) By Martijn van der Marel

0.4 (23 Jun 2024)

• adopt SPEC0 (PR228)

  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.

• add support for python 3.11 and 3.12 (PR228, PR263) By Justus Magin.

• ignore datetime units on attributes (PR241) By Justus Magin.

0.3 (27 Jul 2022)

• drop support for python 3.7 (PR153) By Justus Magin.

• add support for python 3.10 (PR155) By Justus Magin.

• preserve pandas.MultiIndex objects (GH164, PR168). By Justus Magin.

• fix “quantifying” dimension coordinates (GH105, PR174). By Justus Magin.

• allow using DataArray.pint.quantify() and Dataset.pint.quantify() as identity operators (GH47, PR175). By Justus Magin.

0.2.1 (26 Jul 2021)

• allow special “no unit” values in Dataset.pint.quantify() and DataArray.pint.quantify() (PR125) By Justus Magin.

• convert the note about dimension coordinates saving their units in the attributes a warning (GH124, PR126) By Justus Magin.

• improve the documentation on the format parameter of Dataset.pint.dequantify() and DataArray.pint.dequantify() (GH121, PR127, PR132) By Justus Magin.

• use cf-xarray’s unit registry in the plotting example (GH107, PR128). By Justus Magin.

0.2 (May 10 2021)

• rewrite Dataset.pint.quantify() and DataArray.pint.quantify(), to use pint’s UnitRegistry.parse_units instead of UnitRegistry.parse_expression (GH40) By Tom Nicholas.

• ensure the variables which causes the error is explicit if an error occurs in Dataset.pint.quantify() and other methods (PR43, GH91) By Tom Nicholas and Justus Magin.

• refactor the internal conversion functions (PR56) By Justus Magin.

• allow converting indexes (except pandas.MultiIndex) (PR56) By Justus Magin.

• document the reason for requiring the force_ndarray_like or force_ndarray options on unit registries (PR59) By Justus Magin.

• allow passing a format string to Dataset.pint.dequantify() and DataArray.pint.dequantify() (PR49) By Justus Magin.

• allow converting all data variables in a Dataset to the same units using Dataset.pint.to() (GH45, PR63). By Mika Pflüger.

• update format of examples in docstrings (PR64). By Mika Pflüger.

• implement Dataset.pint.sel() and DataArray.pint.sel() (PR60). By Justus Magin.

• implement Dataset.pint.loc and DataArray.pint.loc (PR79). By Justus Magin.

• implement Dataset.pint.drop_sel() and DataArray.pint.drop_sel() (PR73). By Justus Magin.

• implement Dataset.pint.chunk() and DataArray.pint.chunk() (PR83). By Justus Magin.

• implement Dataset.pint.reindex(), Dataset.pint.reindex_like(), DataArray.pint.reindex() and DataArray.pint.reindex_like() (PR69). By Justus Magin.

• implement Dataset.pint.interp(), Dataset.pint.interp_like(), DataArray.pint.interp() and DataArray.pint.interp_like() (PR72, PR76, PR97). By Justus Magin.

• implement Dataset.pint.ffill(), Dataset.pint.bfill(), DataArray.pint.ffill() and DataArray.pint.bfill() (PR78). By Justus Magin.

• implement Dataset.pint.interpolate_na() and DataArray.pint.interpolate_na() (PR82). By Justus Magin.

• expose pint_xarray.setup_registry() as public API (PR89) By Justus Magin.

v0.1 (October 26 2020)

• add initial draft of documentation (PR13, PR20)

• implement DataArray.pint.to() and Dataset.pint.to() (PR11)

• rewrite DataArray.pint.quantify(), Dataset.pint.quantify(), DataArray.pint.dequantify() and Dataset.pint.dequantify() (PR17)

• expose pint_xarray.testing.assert_units_equal() as public API (PR24)

• fix the DataArray.pint.units, DataArray.pint.magnitude and DataArray.pint.dimensionality properties and add docstrings for all three. (PR31)

• use pint’s application registry as a module-global registry (PR32)