From 91fb063d181cd75834c1381eb0638a3a78c0d23b Mon Sep 17 00:00:00 2001 From: Maximilian Roos Date: Wed, 24 Feb 2021 13:00:07 -0800 Subject: [PATCH 1/9] Add 0.17.0 release notes --- doc/whats-new.rst | 139 +++++++++++++++++++++++++++++----------------- 1 file changed, 87 insertions(+), 52 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 5051a64af79..ed73a919a79 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -15,10 +15,24 @@ What's New np.random.seed(123456) -.. _whats-new.0.16.3: +.. _whats-new.0.17.0: -v0.17.0 (unreleased) --------------------- +v0.17.0 (24 Feb 2021) +--------------------- + +This release brings a few important performance improvements, a wide range of +usability upgrades, lots of bug fixes, and some new features. These include +better ``cftime`` support, better ``unstack`` performance, more efficient memory +use in rolling operations, and some python packaging improvements. We also have +a few documentation improvements (and more planned!). + +Many thanks to the 36 contributors to this release: Alessandro Amici, Anderson +Banihirwe, Aureliana Barghini, Ayrton Bourn, Benjamin Bean, Blair Bonnett, Chun +Ho Chow, DWesl, Daniel Mesejo-León, Deepak Cherian, Eric Keenan, Illviljan, Jens +Hedegaard Nielsen, Jody Klymak, Julien Seguinot, Julius Busecke, Kai Mühlbauer, +Leif Denby, Martin Durant, Mathias Hauser, Maximilian Roos, Michael Mann, Ray +Bell, RichardScottOZ, Spencer Clark, Tim Gates, Tom Nicholas, Yunus Sevinchan, +alexamici, aurghs, crusaderky, dcherian, ghislainp, keewis, rhkleijn Breaking changes ~~~~~~~~~~~~~~~~ @@ -49,72 +63,58 @@ Breaking changes (:issue:`4688`, :pull:`4720`, :pull:`4907`, :pull:`4942`) By `Justus Magin `_. -- use ``pyproject.toml`` instead of the ``setup_requires`` option for - ``setuptools`` (:pull:`4897`). - By `Justus Magin `_. - As a result of :pull:`4684` the default units encoding for datetime-like values (``np.datetime64[ns]`` or ``cftime.datetime``) will now always be set such that ``int64`` values can be used. In the past, no units finer than "seconds" were chosen, which would sometimes mean that ``float64`` values were required, which would lead to inaccurate I/O round-trips. - Variables referred to in attributes like ``bounds`` and ``grid_mapping`` - are can be set as coordinate variables. These attributes - are moved to :py:attr:`DataArray.encoding` from - :py:attr:`DataArray.attrs`. This behaviour is controlled by the - ``decode_coords`` kwarg to :py:func:`open_dataset` and + can be set as coordinate variables. These attributes are moved to + :py:attr:`DataArray.encoding` from :py:attr:`DataArray.attrs`. This behaviour + is controlled by the ``decode_coords`` kwarg to :py:func:`open_dataset` and :py:func:`open_mfdataset`. The full list of decoded attributes is in :ref:`weather-climate` (:pull:`2844`, :issue:`3689`) -- remove deprecated ``autoclose`` kwargs from :py:func:`open_dataset` (:pull:`4725`). - By `Aureliana Barghini `_. - As a result of :pull:`4911` the output from calling :py:meth:`DataArray.sum` or :py:meth:`DataArray.prod` on an integer array with ``skipna=True`` and a non-None value for ``min_count`` will now be a float array rather than an integer array. -Deprecations -~~~~~~~~~~~~ - -- ``dim`` argument to :py:meth:`DataArray.integrate` is being deprecated in - favour of a ``coord`` argument, for consistency with :py:meth:`Dataset.integrate`. - For now using ``dim`` issues a ``FutureWarning``. It will be removed in - version 0.19.0 (:pull:`3993`). - By `Tom Nicholas `_. - New Features ~~~~~~~~~~~~ -- Xarray now leverages updates as of cftime version 1.4.1, which enable exact I/O - roundtripping of ``cftime.datetime`` objects (:pull:`4758`). - By `Spencer Clark `_. -- Most rolling operations use significantly less memory. (:issue:`4325`). - By `Deepak Cherian `_. - :py:meth:`~xarray.cftime_range` and :py:meth:`DataArray.resample` now support millisecond (``"L"`` or ``"ms"``) and microsecond (``"U"`` or ``"us"``) frequencies for ``cftime.datetime`` coordinates (:issue:`4097`, :pull:`4758`). By `Spencer Clark `_. - Significantly higher ``unstack`` performance on numpy-backed arrays which - contain missing values; 8x faster in our benchmark, and 2x faster than pandas. + contain missing values; 8x faster than previous versions in our benchmark, and + now 2x faster than pandas. (:pull:`4746`); By `Maximilian Roos `_. - Add :py:meth:`Dataset.plot.quiver` for quiver plots with :py:class:`Dataset` variables. By `Deepak Cherian `_. -- add ``"drop_conflicts"`` to the strategies supported by the ``combine_attrs`` kwarg +- Add ``"drop_conflicts"`` to the strategies supported by the ``combine_attrs`` kwarg (:issue:`4749`, :pull:`4827`). By `Justus Magin `_. -- :py:meth:`DataArray.swap_dims` & :py:meth:`Dataset.swap_dims` now accept dims - in the form of kwargs as well as a dict, like most similar methods. - By `Maximilian Roos `_. - Allow installing from git archives (:pull:`4897`). By `Justus Magin `_. +- :py:class:`DataArrayCoarsen` and :py:class:`DatasetCoarsen` now implement a + ``reduce`` method, enabling coarsening operations with custom reduction + functions (:issue:`3741`, :pull:`4939`). By `Spencer Clark + `_. +- Most rolling operations use significantly less memory. (:issue:`4325`). + By `Deepak Cherian `_. +- Xarray now leverages updates as of cftime version 1.4.1, which enable exact I/O + roundtripping of ``cftime.datetime`` objects (:pull:`4758`). + By `Spencer Clark `_. - :py:func:`open_dataset` and :py:func:`open_mfdataset` now accept ``fsspec`` URLs (including globs for the latter) for ``engine="zarr"``, and so allow reading from many remote and other file systems (:pull:`4461`) By `Martin Durant `_ -- :py:class:`DataArrayCoarsen` and :py:class:`DatasetCoarsen` now implement a - ``reduce`` method, enabling coarsening operations with custom reduction - functions (:issue:`3741`, :pull:`4939`). By `Spencer Clark - `_. +- :py:meth:`DataArray.swap_dims` & :py:meth:`Dataset.swap_dims` now accept dims + in the form of kwargs as well as a dict, like most similar methods. + By `Maximilian Roos `_. Bug fixes ~~~~~~~~~ @@ -122,14 +122,18 @@ Bug fixes :py:func:`~xarray.core.variable.as_compatible_data` instead of blanket access to ``values`` attribute (:issue:`2097`) By `Yunus Sevinchan `_. -- :py:meth:`DataArray.resample` and :py:meth:`Dataset.resample` do not trigger computations anymore if :py:meth:`Dataset.weighted` or :py:meth:`DataArray.weighted` are applied (:issue:`4625`, :pull:`4668`). By `Julius Busecke `_. -- :py:func:`merge` with ``combine_attrs='override'`` makes a copy of the attrs (:issue:`4627`). -- By default, when possible, xarray will now always use values of type ``int64`` when encoding - and decoding ``numpy.datetime64[ns]`` datetimes. This ensures that maximum - precision and accuracy are maintained in the round-tripping process - (:issue:`4045`, :pull:`4684`). It also enables encoding and decoding standard calendar - dates with time units of nanoseconds (:pull:`4400`). By `Spencer Clark - `_ and `Mark Harfouche `_. +- :py:meth:`DataArray.resample` and :py:meth:`Dataset.resample` do not trigger + computations anymore if :py:meth:`Dataset.weighted` or + :py:meth:`DataArray.weighted` are applied (:issue:`4625`, :pull:`4668`). By + `Julius Busecke `_. - :py:func:`merge` with + ``combine_attrs='override'`` makes a copy of the attrs (:issue:`4627`). - By + default, when possible, xarray will now always use values of type ``int64`` + when encoding and decoding ``numpy.datetime64[ns]`` datetimes. This ensures + that maximum precision and accuracy are maintained in the round-tripping + process (:issue:`4045`, :pull:`4684`). It also enables encoding and decoding + standard calendar dates with time units of nanoseconds (:pull:`4400`). + By `Spencer Clark `_ and `Mark Harfouche + `_. - :py:meth:`DataArray.astype`, :py:meth:`Dataset.astype` and :py:meth:`Variable.astype` support the ``order`` and ``subok`` parameters again. This fixes a regression introduced in version 0.16.1 (:issue:`4644`, :pull:`4683`). @@ -155,8 +159,12 @@ Bug fixes - Raise DeprecationWarning when trying to typecast a tuple containing a :py:class:`DataArray`. User now prompted to first call `.data` on it (:issue:`4483`). By `Chun Ho Chow `_. -- Add :py:meth:`Dataset.drop_isel` and :py:meth:`DataArray.drop_isel` (:issue:`4658`, :pull:`4819`). By `Daniel Mesejo `_. -- Ensure that :py:meth:`Dataset.interp` raises ``ValueError`` when interpolating outside coordinate range and ``bounds_error=True`` (:issue:`4854`, :pull:`4855`). +- Add :py:meth:`Dataset.drop_isel` and :py:meth:`DataArray.drop_isel`; + (:issue:`4658`, :pull:`4819`). + By `Daniel Mesejo `_. +- Ensure that :py:meth:`Dataset.interp` raises ``ValueError`` when interpolating + outside coordinate range and ``bounds_error=True`` (:issue:`4854`, + :pull:`4855`). By `Leif Denby `_. - Fix time encoding bug associated with using cftime versions greater than 1.4.0 with xarray (:issue:`4870`, :pull:`4871`). By `Spencer Clark `_. @@ -174,14 +182,25 @@ Bug fixes Documentation ~~~~~~~~~~~~~ -- add information about requirements for accessor classes (:issue:`2788`, :pull:`4657`). +- Add information about requirements for accessor classes (:issue:`2788`, :pull:`4657`). By `Justus Magin `_. -- start a list of external I/O integrating with ``xarray`` (:issue:`683`, :pull:`4566`). +- Start a list of external I/O integrating with ``xarray`` (:issue:`683`, :pull:`4566`). By `Justus Magin `_. -- add concat examples and improve combining documentation (:issue:`4620`, :pull:`4645`). +- Add concat examples and improve combining documentation (:issue:`4620`, :pull:`4645`). By `Ray Bell `_ and `Justus Magin `_. +Deprecations +~~~~~~~~~~~~ + +- ``dim`` argument to :py:meth:`DataArray.integrate` is being deprecated in + favour of a ``coord`` argument, for consistency with :py:meth:`Dataset.integrate`. + For now using ``dim`` issues a ``FutureWarning``. It will be removed in + version 0.19.0 (:pull:`3993`). + By `Tom Nicholas `_. +- Deprecated ``autoclose`` kwargs from :py:func:`open_dataset` are removed; (:pull:`4725`). + By `Aureliana Barghini `_. + Internal Changes ~~~~~~~~~~~~~~~~ - Speed up of the continuous integration tests on azure. @@ -192,6 +211,9 @@ Internal Changes - Run the tests in parallel using pytest-xdist (:pull:`4694`). By `Justus Magin `_ and `Mathias Hauser `_. +- Use ``pyproject.toml`` instead of the ``setup_requires`` option for + ``setuptools`` (:pull:`4897`). + By `Justus Magin `_. - Replace all usages of ``assert x.identical(y)`` with ``assert_identical(x, y)`` for clearer error messages. @@ -212,10 +234,23 @@ Internal Changes v0.16.2 (30 Nov 2020) --------------------- -This release brings the ability to write to limited regions of ``zarr`` files, open zarr files with :py:func:`open_dataset` and :py:func:`open_mfdataset`, increased support for propagating ``attrs`` using the ``keep_attrs`` flag, as well as numerous bugfixes and documentation improvements. - -Many thanks to the 31 contributors who contributed to this release: -Aaron Spring, Akio Taniguchi, Aleksandar Jelenak, alexamici, Alexandre Poux, Anderson Banihirwe, Andrew Pauling, Ashwin Vishnu, aurghs, Brian Ward, Caleb, crusaderky, Dan Nowacki, darikg, David Brochart, David Huard, Deepak Cherian, Dion Häfner, Gerardo Rivera, Gerrit Holl, Illviljan, inakleinbottle, Jacob Tomlinson, James A. Bednar, jenssss, Joe Hamman, johnomotani, Joris Van den Bossche, Julia Kent, Julius Busecke, Kai Mühlbauer, keewis, Keisuke Fujii, Kyle Cranmer, Luke Volpatti, Mathias Hauser, Maximilian Roos, Michaël Defferrard, Michal Baumgartner, Nick R. Papior, Pascal Bourgault, Peter Hausamann, PGijsbers, Ray Bell, Romain Martinez, rpgoldman, Russell Manser, Sahid Velji, Samnan Rahee, Sander, Spencer Clark, Stephan Hoyer, Thomas Zilio, Tobias Kölling, Tom Augspurger, Wei Ji, Yash Saboo, Zeb Nicholls, +This release brings the ability to write to limited regions of ``zarr`` files, +open zarr files with :py:func:`open_dataset` and :py:func:`open_mfdataset`, +increased support for propagating ``attrs`` using the ``keep_attrs`` flag, as +well as numerous bugfixes and documentation improvements. + +Many thanks to the 31 contributors who contributed to this release: Aaron +Spring, Akio Taniguchi, Aleksandar Jelenak, alexamici, Alexandre Poux, Anderson +Banihirwe, Andrew Pauling, Ashwin Vishnu, aurghs, Brian Ward, Caleb, crusaderky, +Dan Nowacki, darikg, David Brochart, David Huard, Deepak Cherian, Dion Häfner, +Gerardo Rivera, Gerrit Holl, Illviljan, inakleinbottle, Jacob Tomlinson, James +A. Bednar, jenssss, Joe Hamman, johnomotani, Joris Van den Bossche, Julia Kent, +Julius Busecke, Kai Mühlbauer, keewis, Keisuke Fujii, Kyle Cranmer, Luke +Volpatti, Mathias Hauser, Maximilian Roos, Michaël Defferrard, Michal +Baumgartner, Nick R. Papior, Pascal Bourgault, Peter Hausamann, PGijsbers, Ray +Bell, Romain Martinez, rpgoldman, Russell Manser, Sahid Velji, Samnan Rahee, +Sander, Spencer Clark, Stephan Hoyer, Thomas Zilio, Tobias Kölling, Tom +Augspurger, Wei Ji, Yash Saboo, Zeb Nicholls, Deprecations ~~~~~~~~~~~~ From e0f90eb7ed504d221a629ea928a161af5177e248 Mon Sep 17 00:00:00 2001 From: Maximilian Roos Date: Wed, 24 Feb 2021 13:30:22 -0800 Subject: [PATCH 2/9] _ --- doc/whats-new.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index ed73a919a79..2d5a93d76f9 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -22,7 +22,7 @@ v0.17.0 (24 Feb 2021) This release brings a few important performance improvements, a wide range of usability upgrades, lots of bug fixes, and some new features. These include -better ``cftime`` support, better ``unstack`` performance, more efficient memory +better ``cftime`` support, a new quiver plot, better ``unstack`` performance, more efficient memory use in rolling operations, and some python packaging improvements. We also have a few documentation improvements (and more planned!). @@ -105,6 +105,9 @@ New Features - Most rolling operations use significantly less memory. (:issue:`4325`). By `Deepak Cherian `_. +- Add :py:meth:`Dataset.drop_isel` and :py:meth:`DataArray.drop_isel`; + (:issue:`4658`, :pull:`4819`). + By `Daniel Mesejo `_. - Xarray now leverages updates as of cftime version 1.4.1, which enable exact I/O roundtripping of ``cftime.datetime`` objects (:pull:`4758`). By `Spencer Clark `_. @@ -159,9 +162,6 @@ Bug fixes - Raise DeprecationWarning when trying to typecast a tuple containing a :py:class:`DataArray`. User now prompted to first call `.data` on it (:issue:`4483`). By `Chun Ho Chow `_. -- Add :py:meth:`Dataset.drop_isel` and :py:meth:`DataArray.drop_isel`; - (:issue:`4658`, :pull:`4819`). - By `Daniel Mesejo `_. - Ensure that :py:meth:`Dataset.interp` raises ``ValueError`` when interpolating outside coordinate range and ``bounds_error=True`` (:issue:`4854`, :pull:`4855`). @@ -189,6 +189,8 @@ Documentation - Add concat examples and improve combining documentation (:issue:`4620`, :pull:`4645`). By `Ray Bell `_ and `Justus Magin `_. +- Added docs on vectorized indexing; (:pull:`4711`). + By `Eric Keenan Date: Wed, 24 Feb 2021 23:15:59 +0100 Subject: [PATCH 3/9] Apply suggestions from code review --- doc/whats-new.rst | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 7a43c194df9..35afc5f7c46 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -116,7 +116,6 @@ New Features `_. - Most rolling operations use significantly less memory. (:issue:`4325`). By `Deepak Cherian `_. - - Add :py:meth:`Dataset.drop_isel` and :py:meth:`DataArray.drop_isel`; (:issue:`4658`, :pull:`4819`). By `Daniel Mesejo `_. @@ -201,8 +200,8 @@ Documentation - Add concat examples and improve combining documentation (:issue:`4620`, :pull:`4645`). By `Ray Bell `_ and `Justus Magin `_. -- Added docs on vectorized indexing; (:pull:`4711`). - By `Eric Keenan `_. Deprecations ~~~~~~~~~~~~ From 81e1b85c720c71a2eccd1990775adb65c1a2ff09 Mon Sep 17 00:00:00 2001 From: Keewis Date: Thu, 25 Feb 2021 00:41:54 +0100 Subject: [PATCH 4/9] reflow release message --- doc/whats-new.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 35afc5f7c46..525ffb9e786 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -22,9 +22,9 @@ v0.17.0 (24 Feb 2021) This release brings a few important performance improvements, a wide range of usability upgrades, lots of bug fixes, and some new features. These include -better ``cftime`` support, a new quiver plot, better ``unstack`` performance, more efficient memory -use in rolling operations, and some python packaging improvements. We also have -a few documentation improvements (and more planned!). +better ``cftime`` support, a new quiver plot, better ``unstack`` performance, +more efficient memory use in rolling operations, and some python packaging +improvements. We also have a few documentation improvements (and more planned!). Many thanks to the 36 contributors to this release: Alessandro Amici, Anderson Banihirwe, Aureliana Barghini, Ayrton Bourn, Benjamin Bean, Blair Bonnett, Chun From 5efe0a6f4754900ae9e079f60a008f807447a39d Mon Sep 17 00:00:00 2001 From: Keewis Date: Thu, 25 Feb 2021 00:45:11 +0100 Subject: [PATCH 5/9] fix some whats-new.rst entries --- doc/whats-new.rst | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 525ffb9e786..3f1b1c76f2a 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -91,7 +91,6 @@ Deprecations like :py:meth:`dict.update`. It will be removed in version 0.19.0 (:pull:`4932`). By `Justus Magin `_. - New Features ~~~~~~~~~~~~ - :py:meth:`~xarray.cftime_range` and :py:meth:`DataArray.resample` now support @@ -100,8 +99,7 @@ New Features By `Spencer Clark `_. - Significantly higher ``unstack`` performance on numpy-backed arrays which contain missing values; 8x faster than previous versions in our benchmark, and - now 2x faster than pandas. - (:pull:`4746`); + now 2x faster than pandas (:pull:`4746`). By `Maximilian Roos `_. - Add :py:meth:`Dataset.plot.quiver` for quiver plots with :py:class:`Dataset` variables. By `Deepak Cherian `_. @@ -116,7 +114,7 @@ New Features `_. - Most rolling operations use significantly less memory. (:issue:`4325`). By `Deepak Cherian `_. -- Add :py:meth:`Dataset.drop_isel` and :py:meth:`DataArray.drop_isel`; +- Add :py:meth:`Dataset.drop_isel` and :py:meth:`DataArray.drop_isel` (:issue:`4658`, :pull:`4819`). By `Daniel Mesejo `_. - Xarray now leverages updates as of cftime version 1.4.1, which enable exact I/O @@ -229,16 +227,17 @@ Internal Changes - Use ``pyproject.toml`` instead of the ``setup_requires`` option for ``setuptools`` (:pull:`4897`). By `Justus Magin `_. - - Replace all usages of ``assert x.identical(y)`` with ``assert_identical(x, y)`` - for clearer error messages. - (:pull:`4752`); + for clearer error messages (:pull:`4752`). By `Maximilian Roos `_. - Speed up attribute style access (e.g. ``ds.somevar`` instead of ``ds["somevar"]``) and tab completion - in ipython (:issue:`4741`, :pull:`4742`). By `Richard Kleijn `_. -- Added the ``set_close`` method to ``Dataset`` and ``DataArray`` for beckends to specify how to voluntary release - all resources. (:pull:`#4809`), By `Alessandro Amici `_. -- Update type hints to work with numpy v1.20 (:pull:`4878`). By `Mathias Hauser `_. + in IPython (:issue:`4741`, :pull:`4742`). + By `Richard Kleijn `_. +- Added the ``set_close`` method to ``Dataset`` and ``DataArray`` for backends + to specify how to voluntary release all resources. (:pull:`#4809`) + By `Alessandro Amici `_. +- Update type hints to work with numpy v1.20 (:pull:`4878`). + By `Mathias Hauser `_. - Ensure warnings cannot be turned into exceptions in :py:func:`testing.assert_equal` and the other ``assert_*`` functions (:pull:`4864`). By `Mathias Hauser `_. - Performance improvement when constructing DataArrays. Significantly speeds up repr for Datasets with large number of variables. From 978c52b1174dd1f867d1f107dd6a9eaee8f6c464 Mon Sep 17 00:00:00 2001 From: Keewis Date: Thu, 25 Feb 2021 00:45:52 +0100 Subject: [PATCH 6/9] fix the deprecations section --- doc/whats-new.rst | 17 ++++------------- 1 file changed, 4 insertions(+), 13 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 3f1b1c76f2a..a47c7323e00 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -87,6 +87,8 @@ Deprecations For now using ``dim`` issues a ``FutureWarning``. It will be removed in version 0.19.0 (:pull:`3993`). By `Tom Nicholas `_. +- Deprecated ``autoclose`` kwargs from :py:func:`open_dataset` are removed (:pull:`4725`). + By `Aureliana Barghini `_. - the return value of :py:meth:`Dataset.update` is being deprecated to make it work more like :py:meth:`dict.update`. It will be removed in version 0.19.0 (:pull:`4932`). By `Justus Magin `_. @@ -198,21 +200,10 @@ Documentation - Add concat examples and improve combining documentation (:issue:`4620`, :pull:`4645`). By `Ray Bell `_ and `Justus Magin `_. -- Added docs on vectorized indexing (:pull:`4711`). - By `Eric Keenan `_. - -Deprecations -~~~~~~~~~~~~ - -- ``dim`` argument to :py:meth:`DataArray.integrate` is being deprecated in - favour of a ``coord`` argument, for consistency with :py:meth:`Dataset.integrate`. - For now using ``dim`` issues a ``FutureWarning``. It will be removed in - version 0.19.0 (:pull:`3993`). - By `Tom Nicholas `_. -- Deprecated ``autoclose`` kwargs from :py:func:`open_dataset` are removed; (:pull:`4725`). - By `Aureliana Barghini `_. - explicitly mention that :py:meth:`Dataset.update` updates inplace (:issue:`2951`, :pull:`4932`). By `Justus Magin `_. +- Added docs on vectorized indexing (:pull:`4711`). + By `Eric Keenan `_. Internal Changes ~~~~~~~~~~~~~~~~ From 82eefd12fdd3de454773df9269599b8607db56ae Mon Sep 17 00:00:00 2001 From: Keewis Date: Thu, 25 Feb 2021 00:48:39 +0100 Subject: [PATCH 7/9] fix more entries --- doc/whats-new.rst | 34 ++++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 14 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index a47c7323e00..cc451af8cf6 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -139,13 +139,14 @@ Bug fixes - :py:meth:`DataArray.resample` and :py:meth:`Dataset.resample` do not trigger computations anymore if :py:meth:`Dataset.weighted` or :py:meth:`DataArray.weighted` are applied (:issue:`4625`, :pull:`4668`). By - `Julius Busecke `_. - :py:func:`merge` with - ``combine_attrs='override'`` makes a copy of the attrs (:issue:`4627`). - By - default, when possible, xarray will now always use values of type ``int64`` - when encoding and decoding ``numpy.datetime64[ns]`` datetimes. This ensures - that maximum precision and accuracy are maintained in the round-tripping - process (:issue:`4045`, :pull:`4684`). It also enables encoding and decoding - standard calendar dates with time units of nanoseconds (:pull:`4400`). + `Julius Busecke `_. +- :py:func:`merge` with ``combine_attrs='override'`` makes a copy of the attrs + (:issue:`4627`). +- By default, when possible, xarray will now always use values of + type ``int64`` when encoding and decoding ``numpy.datetime64[ns]`` datetimes. This + ensures that maximum precision and accuracy are maintained in the round-tripping + process (:issue:`4045`, :pull:`4684`). It also enables encoding and decoding standard + calendar dates with time units of nanoseconds (:pull:`4400`). By `Spencer Clark `_ and `Mark Harfouche `_. - :py:meth:`DataArray.astype`, :py:meth:`Dataset.astype` and :py:meth:`Variable.astype` support @@ -160,9 +161,12 @@ Bug fixes By `Alessandro Amici `_ - Coordinates with dtype ``str`` or ``bytes`` now retain their dtype on many operations, e.g. ``reindex``, ``align``, ``concat``, ``assign``, previously they were cast to an object dtype - (:issue:`2658` and :issue:`4543`) by `Mathias Hauser `_. -- Limit number of data rows when printing large datasets. (:issue:`4736`, :pull:`4750`). By `Jimmy Westling `_. -- Add ``missing_dims`` parameter to transpose (:issue:`4647`, :pull:`4767`). By `Daniel Mesejo `_. + (:issue:`2658` and :issue:`4543`). + By `Mathias Hauser `_. +- Limit number of data rows when printing large datasets. (:issue:`4736`, :pull:`4750`). + By `Jimmy Westling `_. +- Add ``missing_dims`` parameter to transpose (:issue:`4647`, :pull:`4767`). + By `Daniel Mesejo `_. - Resolve intervals before appending other metadata to labels when plotting (:issue:`4322`, :pull:`4794`). By `Justus Magin `_. - Fix regression when decoding a variable with a ``scale_factor`` and ``add_offset`` given @@ -221,8 +225,8 @@ Internal Changes - Replace all usages of ``assert x.identical(y)`` with ``assert_identical(x, y)`` for clearer error messages (:pull:`4752`). By `Maximilian Roos `_. -- Speed up attribute style access (e.g. ``ds.somevar`` instead of ``ds["somevar"]``) and tab completion - in IPython (:issue:`4741`, :pull:`4742`). +- Speed up attribute style access (e.g. ``ds.somevar`` instead of ``ds["somevar"]``) and + tab completion in IPython (:issue:`4741`, :pull:`4742`). By `Richard Kleijn `_. - Added the ``set_close`` method to ``Dataset`` and ``DataArray`` for backends to specify how to voluntary release all resources. (:pull:`#4809`) @@ -230,8 +234,10 @@ Internal Changes - Update type hints to work with numpy v1.20 (:pull:`4878`). By `Mathias Hauser `_. - Ensure warnings cannot be turned into exceptions in :py:func:`testing.assert_equal` and - the other ``assert_*`` functions (:pull:`4864`). By `Mathias Hauser `_. -- Performance improvement when constructing DataArrays. Significantly speeds up repr for Datasets with large number of variables. + the other ``assert_*`` functions (:pull:`4864`). + By `Mathias Hauser `_. +- Performance improvement when constructing DataArrays. Significantly speeds up + repr for Datasets with large number of variables. By `Deepak Cherian `_ .. _whats-new.0.16.2: From a84546c6d9c0d0a3ed28f34725a77cf32df4dd6c Mon Sep 17 00:00:00 2001 From: Keewis Date: Thu, 25 Feb 2021 00:49:01 +0100 Subject: [PATCH 8/9] minor fix --- doc/whats-new.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index cc451af8cf6..2c4e87c5a1d 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -62,7 +62,6 @@ Breaking changes ============ ====== ==== (:issue:`4688`, :pull:`4720`, :pull:`4907`, :pull:`4942`) - By `Justus Magin `_. - As a result of :pull:`4684` the default units encoding for datetime-like values (``np.datetime64[ns]`` or ``cftime.datetime``) will now always be set such that ``int64`` values can be used. In the past, no units From 3d79f56e2a0df4f5e96cc84dcdf8a726e098f85d Mon Sep 17 00:00:00 2001 From: Keewis Date: Thu, 25 Feb 2021 00:51:24 +0100 Subject: [PATCH 9/9] more fixes --- doc/whats-new.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 2c4e87c5a1d..ef7f5b43fdd 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -153,11 +153,12 @@ Bug fixes (:issue:`4644`, :pull:`4683`). By `Richard Kleijn `_ . - Remove dictionary unpacking when using ``.loc`` to avoid collision with ``.sel`` parameters (:pull:`4695`). - By `Anderson Banihirwe `_ + By `Anderson Banihirwe `_. - Fix the legend created by :py:meth:`Dataset.plot.scatter` (:issue:`4641`, :pull:`4723`). By `Justus Magin `_. -- Fix a crash in orthogonal indexing on geographic coordinates with ``engine='cfgrib'`` (:issue:`4733` :pull:`4737`). - By `Alessandro Amici `_ +- Fix a crash in orthogonal indexing on geographic coordinates with ``engine='cfgrib'`` + (:issue:`4733` :pull:`4737`). + By `Alessandro Amici `_. - Coordinates with dtype ``str`` or ``bytes`` now retain their dtype on many operations, e.g. ``reindex``, ``align``, ``concat``, ``assign``, previously they were cast to an object dtype (:issue:`2658` and :issue:`4543`). @@ -237,7 +238,7 @@ Internal Changes By `Mathias Hauser `_. - Performance improvement when constructing DataArrays. Significantly speeds up repr for Datasets with large number of variables. - By `Deepak Cherian `_ + By `Deepak Cherian `_. .. _whats-new.0.16.2: