- This release brings new `hypothesis <https://hypothesis.works/>`_ strategies for testing, significantly faster rolling aggregations as well as:
``ffill`` and ``bfill`` with ``numbagg``, a new :py:meth:`Dataset.eval` method, and improvements to
- reading and writing Zarr arrays (including a new ``"a-"`` mode).:
- Thanks to our 16 contributors:
- Anderson Banihirwe, Ben Mares, Carl Andersson, Deepak Cherian, Doug Latornell, Gregorio L. Trevisan, Illviljan, Jens Hedegaard Nielsen, Justus Magin, Mathias Hauser, Max Jones, Maximilian Roos, Michael Niklas, Patrick Hoefler, Ryan Abernathey, Tom Nicholas:
- New Features:
- Added hypothesis strategies for generating :py:class:`xarray.Variable` objects containing arbitrary data, useful for parametrizing downstream tests.
Accessible under :py:mod:`testing.strategies`, and documented in a new page on testing in the User Guide.
(:issue:`6911`, :pull:`8404`)
By `Tom Nicholas <https://github.com/TomNicholas>`_.
- :py:meth:`rolling` uses `numbagg <https://github.com/numbagg/numbagg>`_ for
most of its computations by default. Numbagg is up to 5x faster than bottleneck
where parallelization is possible. Where parallelization isn't possible — for
example a 1D array — it's about the same speed as bottleneck, and 2-5x faster
than pandas' default functions. (:pull:`8493`). numbagg is an optional
dependency, so requires installing separately.
By `Maximilian Roos <https://github.com/max-sixty>`_.
- Use a concise format when plotting datetime arrays. (:pull:`8449`).
By `Jimmy Westling <https://github.com/illviljan>`_.
- Avoid overwriting unchanged existing coordinate variables when appending with :py:meth:`Dataset.to_zarr` by setting ``mode='a-'``.
By `Ryan Abernathey <https://github.com/rabernat>`_ and `Deepak Cherian <https://github.com/dcherian>`_.
- :py:meth:`~xarray.DataArray.rank` now operates on dask-backed arrays, assuming
the core dim has exactly one chunk. (:pull:`8475`).
By `Maximilian Roos <https://github.com/max-sixty>`_.
- Add a :py:meth:`Dataset.eval` method, similar to the pandas' method of the
same name. (:pull:`7163`). This is currently marked as experimental and
doesn't yet support the ``numexpr`` engine.
- :py:meth:`Dataset.drop_vars` & :py:meth:`DataArray.drop_vars` allow passing a
callable, similar to :py:meth:`Dataset.where` & :py:meth:`Dataset.sortby` & others.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=84
- Update to 2023.8.0
* This release brings changes to minimum dependencies, allows
reading of datasets where a dimension name is associated with a
multidimensional variable (e.g. finite volume ocean model
output), and introduces a new xarray.Coordinates object.
## Announcements
* The xarray.Variable class is being refactored out to a new
project title 'namedarray'. See the design doc for more
details. Reach out to us on this discussion topic if you have
any thoughts.
## What's Changed
* Use variable name in all exceptions raised in as_variable by
@ZedThree in #7995
* Allow opening datasets with nD dimenson coordinate variables.
by @dcherian in #7989
* join together duplicate entries in the text repr by @keewis in
#7225
* Expose "Coordinates" as part of Xarray's public API by @benbovy
in #7368
* Update interpolate_na in dataset.py by @ilgast in #7974
* Add HDF5 Section to read/write docs page by @rwegener2 in #8012
* Add examples to docstrings by @harshitha1201 in #7937
* (chore) min versions bump by @jhamman in #8022
* Automatically chunk other in GroupBy binary ops. by @dcherian
in #7684
* change cumproduct to cumprod by @quantsnus in #8031
* Reduce pre-commit update frequency to monthly from weekly. by
@dcherian in #8033
* sort when encoding coordinates for deterministic outputs by
@itcarroll in #8034
* Zarr : Allow setting write_empty_chunks by @RKuttruff in #8016
* Count documentation by @Articoking in #8057
* unpin numpy by @keewis in #8061
- Release 2023.7.0
* This release brings improvements to the documentation on
wrapping numpy-like arrays, improved docstrings, and bug fixes.
## What's Changed
* Allow cubed arrays to be passed to flox groupby by @TomNicholas
in #7941
* Duck array documentation improvements by @TomNicholas in #7911
* Docstring examples by @harshitha1201 in #7881
* Chunked array docs by @TomNicholas in #7951
* ensure no forward slashes in names for HDF5-based backends by
@kmuehlbauer in #7953
* Move absolute path finder from open_mfdataset to own function
by @Illviljan in #7968
* Skip broken tests on Python 3.11 and Windows by @Illviljan in
#7972
* Examples added to docstrings by @harshitha1201 in #7936
* Fix typo in zarr.py by @johmathe in #7983
* Improve explanation in example "Working with Multidimensional
Coordinates" by @yvonnefroehlich in #7984
* Remove hue_style from plot1d docstring by @Illviljan in #7925
- Release 2023.06.0
* This release adds features to curvefit, improves the
performance of concatenation, and fixes various bugs.
## What's Changed
* Array API fixes for astype by @TomNicholas in #7847
* Add type hints to test_dtypes by @Illviljan in #7858
* adapt the pint + dask test to the newest version of pint by
@keewis in #7855
* Avoid explicit loop when updating OrderedSet by @Illviljan in
#7857
* Improve to_dask_dataframe performance by @Illviljan in #7844
* Changed duck typing exception to: (ImportError, AttributeError)
by @vhaasteren in #7874
* defer to numpy for the expected result by @keewis in #7875
* deprecate the cdms2 conversion methods by @keewis in #7876
* Implement multidimensional initial guess and bounds for
curvefit by @mgunyho in #7821
* Improve concat performance by @Illviljan in #7824
* Fix .groupby(multi index level) by @dcherian in #7830
* don't use CacheFileManager.__del__ on interpreter shutdown by
@keewis in #7880
* fix polyfit changing the original object by @malmans2 in #7900
* Fix flaky doctest for curvefit by @mgunyho in #7893
* Ensure dtype of reindex result matches dtype of the original
DataArray by @andersy005 in #7917
* Add errors option to curvefit by @mgunyho in #7891
* CF encoding should preserve vlen dtype for empty arrays by
@tomwhite in #7862
* use trusted publishers instead of a API token by @keewis in
#7899
* Add cfgrib,ipywidgets to doc env by @dcherian in #7888
* Fix regression with grouper object on an IndexVariable by
@mwtoews in #7920
* Fix check for chunk_store in zarr backend by @juntyr in #7923
* fixing rolling_window issue with cupy by @negin513 in #7938
- Add xarray-pr8139-pandas-fill_value.patch gh#pydata/xarray#8125,
gh#pydata/xarray#8139
OBS-URL: https://build.opensuse.org/request/show/1110376
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=82
* This release adds some new methods and operators, updates our
deprecation policy for python versions, fixes some bugs with
groupby, and introduces experimental support for alternative
chunked parallel array computation backends via a new plugin
system!
* Docstrings examples for string methods
* Fix groupby_bins when labels are specified
* Fix binning by unsorted array
* This release includes support for pandas v2, allows
refreshing of backend engines in a session, and removes
deprecated backends for ``rasterio`` and ``cfgrib``.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=80
- This release brings a major upgrade to :py:func:`xarray.concat`, many bug fixes,:
- and a bump in supported dependency versions. Thanks to our 11 contributors:
- Aron Gergely, Deepak Cherian, Illviljan, James Bourbeau, Joe Hamman,:
- Justus Magin, Hauke Schulz, Kai Mühlbauer, Ken Mankoff, Spencer Clark, Tom Nicholas.:
- Breaking changes:
- Support for ``python 3.8`` has been dropped and the minimum versions of some
dependencies were changed (:pull:`7461`):
===================== ========= ========
Package Old New
===================== ========= ========
python 3.8 3.9
numpy 1.20 1.21
pandas 1.3 1.4
dask 2021.11 2022.1
distributed 2021.11 2022.1
h5netcdf 0.11 0.13
lxml 4.6 4.7
numba 5.4 5.5
===================== ========= ========
- Deprecations:
- Following pandas, the `closed` parameters of :py:func:`cftime_range` and
:py:func:`date_range` are deprecated in favor of the `inclusive` parameters,
and will be removed in a future version of xarray (:issue:`6985`:,
:pull:`7373`).
- Bug fixes:
- :py:func:`xarray.concat` can now concatenate variables present in some datasets but
not others (:issue:`508`, :pull:`7400`).
- Handle ``keep_attrs`` option in binary operators of :py:meth:`Dataset` (:issue:`7390`, :pull:`7391`).
- Improve error message when using dask in :py:func:`apply_ufunc` with ``output_sizes`` not supplied. (:pull:`7509`)
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=78
- Update to 2022.12.0
* This release includes a number of bug fixes and experimental
support for Zarr V3.
## New Features
* Enable using offset and origin arguments in
DataArray.resample() and Dataset.resample() (GH7266, PR7284).
By Spencer Clark.
* Add experimental support for Zarr’s in-progress V3
specification. (PR6475). By Gregory Lee and Joe Hamman.
## Breaking changes
* The minimum versions of some dependencies were changed
(PR7300):
## Deprecations
* The PyNIO backend has been deprecated (GH4491, PR7301). By Joe
Hamman.
## Bug fixes
* Fix handling of coordinate attributes in where(). (GH7220,
PR7229) By Sam Levang.
* Import nc_time_axis when needed (GH7275, PR7276). By Michael
Niklas.
* Fix static typing of xr.polyval() (GH7312, PR7315). By Michael
Niklas.
* Fix multiple reads on fsspec S3 files by resetting file pointer
to 0 when reading file streams (GH6813, PR7304). By David Hoese
and Wei Ji Leong.
* Fix Dataset.assign_coords() resetting all dimension coordinates
to default (pandas) index (GH7346, PR7347). By Benoît Bovy.
OBS-URL: https://build.opensuse.org/request/show/1056773
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=76
- Update to 2022.11.0
* This release brings a number of bugfixes and documentation
improvements. Both text and HTML reprs now have a new "Indexes"
section, which we expect will help with development of new
Index objects. This release also features more support for the
Python Array API.
## New Features
* Add static typing to plot accessors (GH6949, PR7052). By
Michael Niklas.
* Display the indexes in a new section of the text and HTML reprs
(PR6795, PR7183, PR7185) By Justus Magin and Benoît Bovy.
* Added methods DataArrayGroupBy.cumprod() and
DatasetGroupBy.cumprod(). (PR5816) By Patrick Naylor
## Breaking changes
* repr(ds) may not show the same result because it doesn’t load
small, lazy data anymore. Use ds.head().load() when wanting to
see just a sample of the data. (GH6722, PR7203). By Jimmy
Westling.
* Many arguments of plotmethods have been made keyword-only.
* xarray.plot.plot module renamed to xarray.plot.dataarray_plot
to prevent shadowing of the plot method. (GH6949, PR7052). By
Michael Niklas.
## Deprecations
* Positional arguments for all plot methods have been deprecated
(GH6949, PR7052). By Michael Niklas.
* xarray.plot.FacetGrid.axes has been renamed to
xarray.plot.FacetGrid.axs because it’s not clear if axes refers
to single or multiple Axes instances. This aligns with
matplotlib.pyplot.subplots. (PR7194) By Jimmy Westling.
## Bug fixes
OBS-URL: https://build.opensuse.org/request/show/1037318
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=74
- This release brings numerous bugfixes, a change in minimum
supported versions, and a new scatter plot method for
DataArrays.
- Update to 2022.9.0:
- This release brings a large number of bugfixes and
documentation improvements, as well as an external interface
for setting custom indexes!
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=70
- This release brings a number of small improvements, as well as a move to `calendar versioning <https://calver.org/>`_ (:issue:`6176`).:
- Many thanks to the 16 contributors to the v2022.02.0 release!:
- Aaron Spring, Alan D. Snow, Anderson Banihirwe, crusaderky, Illviljan, Joe Hamman, Jonas GliÃ,:
- Lukas Pilz, Martin Bergemann, Mathias Hauser, Maximilian Roos, Romain Caneill, Stan West, Stijn Van Hoey,:
- Tobias Kölling, and Tom Nicholas.:
- New Features:
- Enabled multiplying tick offsets by floats. Allows ``float`` ``n`` in
:py:meth:`CFTimeIndex.shift` if ``shift_freq`` is between ``Day``
and ``Microsecond``. (:issue:`6134`, :pull:`6135`).
By `Aaron Spring <https://github.com/aaronspring>`_.
- Enbable to provide more keyword arguments to `pydap` backend when reading
OpenDAP datasets (:issue:`6274`).
By `Jonas Glià <https://github.com/jgliss>`.
- Allow :py:meth:`DataArray.drop_duplicates` to drop duplicates along multiple dimensions at once,
and add :py:meth:`Dataset.drop_duplicates`. (:pull:`6307`)
By `Tom Nicholas <https://github.com/TomNicholas>`_.
- Breaking changes:
- Renamed the ``interpolation`` keyword of all ``quantile`` methods (e.g. :py:meth:`DataArray.quantile`)
to ``method`` for consistency with numpy v1.22.0 (:pull:`6108`).
By `Mathias Hauser <https://github.com/mathause>`_.
- Deprecations:
- Bug fixes:
- Variables which are chunked using dask in larger (but aligned) chunks than the target zarr chunk size
can now be stored using `to_zarr()` (:pull:`6258`) By `Tobias Kölling <https://github.com/d70-t>`_.
- Multi-file datasets containing encoded :py:class:`cftime.datetime` objects can be read in parallel again (:issue:`6226`, :pull:`6249`, :pull:`6305`). By `Martin Bergemann <https://github.com/antarcticrainforest>`_ and `Stan West <https://github.com/stanwest>`_.
- Documentation:
- Delete files of datasets saved to disk while building the documentation and enable
building on Windows via `sphinx-build` (:pull:`6237`).
By `Stan West <https://github.com/stanwest>`_.
- Internal Changes:
- update to version 0.21.1:
- This is a bugfix release to resolve (:issue:`6216`, :pull:`6207`).:
- Bug fixes:
- Add `packaging` as a dependency to Xarray (:issue:`6216`, :pull:`6207`).
By `Sebastian Weigand <https://github.com/s-weigand>`_ and `Joe Hamman <https://github.com/jhamman>`_.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=65
- Many thanks to the 20 contributors to the v0.21.0 release!:
- Abel Aoun, Anderson Banihirwe, Ant Gib, Chris Roat, Cindy Chiao,:
- Deepak Cherian, Dominik Stańczak, Fabian Hofmann, Illviljan, Jody Klymak, Joseph:
- K Aicher, Mark Harfouche, Mathias Hauser, Matthew Roeschke, Maximilian Roos,:
- Michael Delgado, Pascal Bourgault, Pierre, Ray Bell, Romain Caneill, Tim Heap,:
- Tom Nicholas, Zeb Nicholls, joseph nowak, keewis.:
- New Features:
- New top-level function :py:func:`cross`. (:issue:`3279`, :pull:`5365`).
By `Jimmy Westling <https://github.com/illviljan>`_.
- ``keep_attrs`` support for :py:func:`where` (:issue:`4141`, :issue:`4682`, :pull:`4687`).
By `Justus Magin <https://github.com/keewis>`_.
- Enable the limit option for dask array in the following methods :py:meth:`DataArray.ffill`, :py:meth:`DataArray.bfill`, :py:meth:`Dataset.ffill` and :py:meth:`Dataset.bfill` (:issue:`6112`)
By `Joseph Nowak <https://github.com/josephnowak>`_.
- Breaking changes:
- Rely on matplotlib's default datetime converters instead of pandas' (:issue:`6102`, :pull:`6109`).
By `Jimmy Westling <https://github.com/illviljan>`_.
- Improve repr readability when there are a large number of dimensions in datasets or dataarrays by
wrapping the text once the maximum display width has been exceeded. (:issue:`5546`, :pull:`5662`)
By `Jimmy Westling <https://github.com/illviljan>`_.
- Deprecations:
- Removed the lock kwarg from the zarr and pydap backends, completing the deprecation cycle started in :issue:`5256`.
By `Tom Nicholas <https://github.com/TomNicholas>`_.
- Support for ``python 3.7`` has been dropped. (:pull:`5892`)
By `Jimmy Westling <https://github.com/illviljan>`_.
- Bug fixes:
- Preserve chunks when creating a :py:class:`DataArray` from another :py:class:`DataArray`
(:pull:`5984`). By `Fabian Hofmann <https://github.com/FabianHofmann>`_.
- Properly support :py:meth:`DataArray.ffill`, :py:meth:`DataArray.bfill`, :py:meth:`Dataset.ffill` and :py:meth:`Dataset.bfill` along chunked dimensions (:issue:`6112`).
By `Joseph Nowak <https://github.com/josephnowak>`_.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=63
- This is a bugfix release to resolve (:issue:`3391`, :issue:`5715`). It also:
- includes performance improvements in unstacking to a ``sparse`` array and a:
- number of documentation improvements.:
- Many thanks to the 20 contributors:
- Aaron Spring, Alexandre Poux, Deepak Cherian, Enrico Minack, Fabien Maussion,:
- Giacomo Caria, Gijom, Guillaume Maze, Illviljan, Joe Hamman, Joseph Hardin, Kai:
- Mühlbauer, Matt Henderson, Maximilian Roos, Michael Delgado, Robert Gieseke,:
- Sebastian Weigand and Stephan Hoyer.:
- Breaking changes:
- Use complex nan when interpolating complex values out of bounds by default (instead of real nan) (:pull:`6019`).
By `Alexandre Poux <https://github.com/pums974>`_.
- Performance:
- Significantly faster unstacking to a ``sparse`` array. :pull:`5577`
By `Deepak Cherian <https://github.com/dcherian>`_.
- Bug fixes:
- :py:func:`xr.map_blocks` and :py:func:`xr.corr` now work when dask is not installed (:issue:`3391`, :issue:`5715`, :pull:`5731`).
By `Gijom <https://github.com/Gijom>`_.
- Fix plot.line crash for data of shape ``(1, N)`` in _title_for_slice on format_item (:pull:`5948`).
By `Sebastian Weigand <https://github.com/s-weigand>`_.
- Fix a regression in the removal of duplicate backend entrypoints (:issue:`5944`, :pull:`5959`)
By `Kai Mühlbauer <https://github.com/kmuehlbauer>`_.
- Documentation:
- Better examples in docstrings for groupby and resampling reductions (:pull:`5871`).
By `Deepak Cherian <https://github.com/dcherian>`_,
`Maximilian Roos <https://github.com/max-sixty>`_,
`Jimmy Westling <https://github.com/illviljan>`_ .
- Internal Changes:
- Use ``importlib`` to replace functionality of ``pkg_resources`` in
backend plugins tests. (:pull:`5959`).
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=61
- This release brings improved support for pint arrays, methods for weighted standard deviation, variance,:
- and sum of squares, the option to disable the use of the bottleneck library, significantly improved performance of:
- unstack, as well as many bugfixes and internal changes.:
- Many thanks to the 38 contributors to this release!:
- Aaron Spring, Akio Taniguchi, Alan D. Snow, arfy slowy, Benoit Bovy, Christian Jauvin, crusaderky, Deepak Cherian,:
- Giacomo Caria, Illviljan, James Bourbeau, Joe Hamman, Joseph K Aicher, Julien Herzen, Kai Mühlbauer,:
- keewis, lusewell, Martin K. Scherer, Mathias Hauser, Max Grover, Maxime Liquet, Maximilian Roos, Mike Taves, pmav99,:
- Pushkar Kopparla, Ray Bell, Rio McMahon, Scott Staniewicz, Spencer Clark, Stefan Bender, Taher Chegini, Thomas Nicholas,:
- Tomas Chor, Tom Augspurger, Victor Negîrneac, Zachary Moon, and Zeb Nicholls.:
- New Features:
- Add ``std``, ``var``, ``sum_of_squares`` to :py:class:`~core.weighted.DatasetWeighted` and :py:class:`~core.weighted.DataArrayWeighted`.
By `Christian Jauvin <https://github.com/cjauvin>`_.
- Added a :py:func:`get_options` method to xarray's root namespace (:issue:`5698`, :pull:`5716`)
By `Pushkar Kopparla <https://github.com/pkopparla>`_.
- Xarray now does a better job rendering variable names that are long LaTeX sequences when plotting (:issue:`5681`, :pull:`5682`).
By `Tomas Chor <https://github.com/tomchor>`_.
- Add an option (``"use_bottleneck"``) to disable the use of ``bottleneck`` using :py:func:`set_options` (:pull:`5560`)
By `Justus Magin <https://github.com/keewis>`_.
- Added ``**kwargs`` argument to :py:meth:`open_rasterio` to access overviews (:issue:`3269`).
By `Pushkar Kopparla <https://github.com/pkopparla>`_.
- Added ``storage_options`` argument to :py:meth:`to_zarr` (:issue:`5601`).
By `Ray Bell <https://github.com/raybellwaves>`_, `Zachary Blackwood <https://github.com/blackary>`_ and
`Nathan Lis <https://github.com/wxman22>`_.
- Histogram plots are set with a title displaying the scalar coords if any, similarly to the other plots (:issue:`5791`, :pull:`5792`).
By `Maxime Liquet <https://github.com/maximlt>`_.
- Slice plots display the coords units in the same way as x/y/colorbar labels (:pull:`5847`).
By `Victor Negîrneac <https://github.com/caenrigen>`_.
- Added a new :py:attr:`Dataset.chunksizes`, :py:attr:`DataArray.chunksizes`, and :py:attr:`Variable.chunksizes`
property, which will always return a mapping from dimension names to chunking pattern along that dimension,
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=59
- remove test_resample_loffset.patch, merged upstream.
- update to version 0.19.0:
- This release brings improvements to plotting of categorical data, the ability to specify how attributes:
- are combined in xarray operations, a new high-level :py:func:`unify_chunks` function, as well as various:
- deprecations, bug fixes, and minor improvements.:
- Many thanks to the 29 contributors to this release!:
- Andrew Williams, Augustus, Aureliana Barghini, Benoit Bovy, crusaderky, Deepak Cherian, ellesmith88,:
- Elliott Sales de Andrade, Giacomo Caria, github-actions[bot], Illviljan, Joeperdefloep, joooeey, Julia Kent,:
- Julius Busecke, keewis, Mathias Hauser, Matthias Göbel, Mattia Almansi, Maximilian Roos, Peter Andreas Entschev,:
- Ray Bell, Sander, Santiago Soler, Sebastian, Spencer Clark, Stephan Hoyer, Thomas Hirtz, Thomas Nicholas.:
- New Features:
- Allow passing argument ``missing_dims`` to :py:meth:`Variable.transpose` and :py:meth:`Dataset.transpose`
(:issue:`5550`, :pull:`5586`)
By `Giacomo Caria <https://github.com/gcaria>`_.
- Allow passing a dictionary as coords to a :py:class:`DataArray` (:issue:`5527`,
reverts :pull:`1539`, which had deprecated this due to python's inconsistent ordering in earlier versions).
By `Sander van Rijn <https://github.com/sjvrijn>`_.
- Added :py:meth:`Dataset.coarsen.construct`, :py:meth:`DataArray.coarsen.construct` (:issue:`5454`, :pull:`5475`).
By `Deepak Cherian <https://github.com/dcherian>`_.
- Xarray now uses consolidated metadata by default when writing and reading Zarr
stores (:issue:`5251`).
By `Stephan Hoyer <https://github.com/shoyer>`_.
- New top-level function :py:func:`unify_chunks`.
By `Mattia Almansi <https://github.com/malmans2>`_.
- Allow assigning values to a subset of a dataset using positional or label-based
indexing (:issue:`3015`, :pull:`5362`).
By `Matthias Göbel <https://github.com/matzegoebel>`_.
- Attempting to reduce a weighted object over missing dimensions now raises an error (:pull:`5362`).
By `Mattia Almansi <https://github.com/malmans2>`_.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=56
- This release is intended as a small patch release to be compatible with the new:
2021.5.0 ``dask.distributed`` release. It also includes a new
``drop_duplicates`` method, some documentation improvements, the beginnings of
- our internal Index refactoring, and some bug fixes.:
- Thank you to all 16 contributors!:
- Anderson Banihirwe, Andrew, Benoit Bovy, Brewster Malevich, Giacomo Caria,:
- Illviljan, James Bourbeau, Keewis, Maximilian Roos, Ravin Kumar, Stephan Hoyer,:
- Thomas Nicholas, Tom Nicholas, Zachary Moon.:
- New Features:
- Implement :py:meth:`DataArray.drop_duplicates`
to remove duplicate dimension values (:pull:`5239`).
By `Andrew Huang <https://github.com/ahuang11>`_.
- Allow passing ``combine_attrs`` strategy names to the ``keep_attrs`` parameter of
:py:func:`apply_ufunc` (:pull:`5041`)
By `Justus Magin <https://github.com/keewis>`_.
- :py:meth:`Dataset.interp` now allows interpolation with non-numerical datatypes,
such as booleans, instead of dropping them. (:issue:`4761` :pull:`5008`).
By `Jimmy Westling <https://github.com/illviljan>`_.
- Raise more informative error when decoding time variables with invalid reference dates.
(:issue:`5199`, :pull:`5288`). By `Giacomo Caria <https://github.com/gcaria>`_.
- Bug fixes:
- Opening netCDF files from a path that doesn't end in ``.nc`` without supplying
an explicit ``engine`` works again (:issue:`5295`), fixing a bug introduced in
0.18.0.
By `Stephan Hoyer <https://github.com/shoyer>`_
- Documentation:
- Clean up and enhance docstrings for the :py:class:`DataArray.plot` and ``Dataset.plot.*``
families of methods (:pull:`5285`).
By `Zach Moon <https://github.com/zmoon>`_.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=50
- This release brings a few important performance improvements, a wide range of:
- usability upgrades, lots of bug fixes, and some new features. These include:
- a plugin API to add backend engines, a new theme for the documentation,:
- curve fitting methods, and several new plotting functions.:
- Many thanks to the 38 contributors to this release: Aaron Spring, Alessandro Amici,:
- Alex Marandon, Alistair Miles, Ana Paula Krelling, Anderson Banihirwe, Aureliana Barghini,:
- Baudouin Raoult, Benoit Bovy, Blair Bonnett, David Trémouilles, Deepak Cherian,:
- Gabriel Medeiros Abrahão, Giacomo Caria, Hauke Schulz, Illviljan, Mathias Hauser, Matthias Bussonnier,:
- Mattia Almansi, Maximilian Roos, Ray Bell, Richard Kleijn, Ryan Abernathey, Sam Levang, Spencer Clark,:
- Spencer Jones, Tammas Loughran, Tobias Kölling, Todd, Tom Nicholas, Tom White, Victor Negîrneac,:
- Xianxiang Li, Zeb Nicholls, crusaderky, dschwoerer, johnomotani, keewis:
- New Features:
- apply ``combine_attrs`` on data variables and coordinate variables when concatenating
and merging datasets and dataarrays (:pull:`4902`).
By `Justus Magin <https://github.com/keewis>`_.
- Add :py:meth:`Dataset.to_pandas` (:pull:`5247`)
By `Giacomo Caria <https://github.com/gcaria>`_.
- Add :py:meth:`DataArray.plot.surface` which wraps matplotlib's `plot_surface` to make
surface plots (:issue:`2235` :issue:`5084` :pull:`5101`).
By `John Omotani <https://github.com/johnomotani>`_.
- Allow passing multiple arrays to :py:meth:`Dataset.__setitem__` (:pull:`5216`).
By `Giacomo Caria <https://github.com/gcaria>`_.
- Add 'cumulative' option to :py:meth:`Dataset.integrate` and
:py:meth:`DataArray.integrate` so that result is a cumulative integral, like
:py:func:`scipy.integrate.cumulative_trapezoidal` (:pull:`5153`).
By `John Omotani <https://github.com/johnomotani>`_.
- Add ``safe_chunks`` option to :py:meth:`Dataset.to_zarr` which allows overriding
checks made to ensure Dask and Zarr chunk compatibility (:issue:`5056`).
By `Ryan Abernathey <https://github.com/rabernat>`_
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=48
- 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!).:
- 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:
- xarray no longer supports python 3.6
The minimum version policy was changed to also apply to projects with irregular
releases. As a result, the minimum versions of some dependencies have changed:
============ ====== ====
Package Old New
============ ====== ====
Python 3.6 3.7
setuptools 38.4 40.4
numpy 1.15 1.17
pandas 0.25 1.0
dask 2.9 2.11
distributed 2.9 2.11
bottleneck 1.2 1.3
h5netcdf 0.7 0.8
iris 2.2 2.4
netcdf4 1.4 1.5
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=45
- 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.:
- Deprecations:
- :py:attr:`~core.accessor_dt.DatetimeAccessor.weekofyear` and :py:attr:`~core.accessor_dt.DatetimeAccessor.week`
have been deprecated. Use ``DataArray.dt.isocalendar().week``
instead (:pull:`4534`). By `Mathias Hauser <https://github.com/mathause>`_,
`Maximilian Roos <https://github.com/max-sixty>`_, and `Spencer Clark <https://github.com/spencerkclark>`_.
- :py:attr:`DataArray.rolling` and :py:attr:`Dataset.rolling` no longer support passing ``keep_attrs``
via its constructor. Pass ``keep_attrs`` via the applied function, i.e. use
``ds.rolling(...).mean(keep_attrs=False)`` instead of ``ds.rolling(..., keep_attrs=False).mean()``
Rolling operations now keep their attributes per default (:pull:`4510`).
By `Mathias Hauser <https://github.com/mathause>`_.
- New Features:
- :py:func:`open_dataset` and :py:func:`open_mfdataset`
now works with ``engine="zarr"`` (:issue:`3668`, :pull:`4003`, :pull:`4187`).
By `Miguel Jimenez <https://github.com/Mikejmnez>`_ and `Wei Ji Leong <https://github.com/weiji14>`_.
- Unary & binary operations follow the ``keep_attrs`` flag (:issue:`3490`, :issue:`4065`, :issue:`3433`, :issue:`3595`, :pull:`4195`).
By `Deepak Cherian <https://github.com/dcherian>`_.
- Added :py:meth:`~core.accessor_dt.DatetimeAccessor.isocalendar()` that returns a Dataset
with year, week, and weekday calculated according to the ISO 8601 calendar. Requires
pandas version 1.1.0 or greater (:pull:`4534`). By `Mathias Hauser <https://github.com/mathause>`_,
`Maximilian Roos <https://github.com/max-sixty>`_, and `Spencer Clark <https://github.com/spencerkclark>`_.
- :py:meth:`Dataset.to_zarr` now supports a ``region`` keyword for writing to
limited regions of existing Zarr stores (:pull:`4035`).
See :ref:`io.zarr.appending` for full details.
By `Stephan Hoyer <https://github.com/shoyer>`_.
- Added typehints in :py:func:`align` to reflect that the same type received in ``objects`` arg will be returned (:pull:`4522`).
By `Michal Baumgartner <https://github.com/m1so>`_.
- :py:meth:`Dataset.weighted` and :py:meth:`DataArray.weighted` are now executing value checks lazily if weights are provided as dask arrays (:issue:`4541`, :pull:`4559`).
By `Julius Busecke <https://github.com/jbusecke>`_.
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=41
- This patch release fixes an incompatability with a recent pandas change, which:
- was causing an issue indexing with a ``datetime64``. It also includes:
- improvements to ``rolling``, ``to_dataframe``, ``cov`` & ``corr`` methods and:
- bug fixes. Our documentation has a number of improvements, including fixing all :
- doctests and confirming their accuracy on every commit.:
- Many thanks to the 36 contributors who contributed to this release:
- Aaron Spring, Akio Taniguchi, Aleksandar Jelenak, Alexandre Poux,:
- Caleb, Dan Nowacki, Deepak Cherian, Gerardo Rivera, Jacob Tomlinson, James A.:
- Bednar, Joe Hamman, Julia Kent, Kai Mühlbauer, Keisuke Fujii, Mathias Hauser,:
- Maximilian Roos, Nick R. Papior, Pascal Bourgault, Peter Hausamann, Romain:
- Martinez, Russell Manser, Samnan Rahee, Sander, Spencer Clark, Stephan Hoyer,:
- Thomas Zilio, Tobias Kölling, Tom Augspurger, alexamici, crusaderky, darikg,:
- inakleinbottle, jenssss, johnomotani, keewis, and rpgoldman.:
- Breaking changes:
- :py:meth:`DataArray.astype` and :py:meth:`Dataset.astype` now preserve attributes. Keep the
old behavior by passing `keep_attrs=False` (:issue:`2049`, :pull:`4314`).
By `Dan Nowacki <https://github.com/dnowacki-usgs>`_ and `Gabriel Joel Mitchell <https://github.com/gajomi>`_.
- New Features:
- :py:meth:`~xarray.DataArray.rolling` and :py:meth:`~xarray.Dataset.rolling`
now accept more than 1 dimension. (:pull:`4219`)
By `Keisuke Fujii <https://github.com/fujiisoup>`_.
- :py:meth:`~xarray.DataArray.to_dataframe` and :py:meth:`~xarray.Dataset.to_dataframe`
now accept a ``dim_order`` parameter allowing to specify the resulting dataframe's
dimensions order (:issue:`4331`, :pull:`4333`).
By `Thomas Zilio <https://github.com/thomas-z>`_.
- Support multiple outputs in :py:func:`xarray.apply_ufunc` when using
``dask='parallelized'``. (:issue:`1815`, :pull:`4060`).
By `Kai Mühlbauer <https://github.com/kmuehlbauer>`_.
- ``min_count`` can be supplied to reductions such as ``.sum`` when specifying
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=39
- This release brings many improvements to xarray's documentation: our examples are now binderized notebooks (`click here <https://mybinder.org/v2/gh/pydata/xarray/master?urlpath=lab/tree/doc/examples/weather-data.ipynb>`_):
- and we have new example notebooks from our SciPy 2019 sprint (many thanks to our contributors!).:
- This release also features many API improvements such as a new:
:py:class:`~core.accessor_dt.TimedeltaAccessor` and support for :py:class:`CFTimeIndex` in
:py:meth:`~DataArray.interpolate_na`); as well as many bug fixes.
- Breaking changes:
- Bumped minimum tested versions for dependencies:
- numpy 1.15
- pandas 0.25
- dask 2.2
- distributed 2.2
- scipy 1.3
- Remove ``compat`` and ``encoding`` kwargs from ``DataArray``, which
have been deprecated since 0.12. (:pull:`3650`).
Instead, specify the ``encoding`` kwarg when writing to disk or set
the :py:attr:`DataArray.encoding` attribute directly.
By `Maximilian Roos <https://github.com/max-sixty>`_.
- :py:func:`xarray.dot`, :py:meth:`DataArray.dot`, and the ``@`` operator now
use ``align="inner"`` (except when ``xarray.set_options(arithmetic_join="exact")``;
:issue:`3694`) by `Mathias Hauser <https://github.com/mathause>`_.
- New Features:
- :py:meth:`DataArray.sel` and :py:meth:`Dataset.sel` now support :py:class:`pandas.CategoricalIndex`. (:issue:`3669`)
By `Keisuke Fujii <https://github.com/fujiisoup>`_.
- Support using an existing, opened h5netcdf ``File`` with
:py:class:`~xarray.backends.H5NetCDFStore`. This permits creating an
:py:class:`~xarray.Dataset` from a h5netcdf ``File`` that has been opened
using other means (:issue:`3618`).
By `Kai Mühlbauer <https://github.com/kmuehlbauer>`_.
- Implement ``median`` and ``nanmedian`` for dask arrays. This works by rechunking
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=31
- New functions/methods:
- New methods :py:meth:`Dataset.to_stacked_array` and
:py:meth:`DataArray.to_unstacked_dataset` for reshaping Datasets of variables
with different dimensions
(:issue:`1317`).
This is useful for feeding data from xarray into machine learning models,
as described in :ref:`reshape.stacking_different`.
- Enhancements:
- Support for renaming ``Dataset`` variables and dimensions independently
with :py:meth:`~Dataset.rename_vars` and :py:meth:`~Dataset.rename_dims`
(:issue:`3026`).
- Add ``scales``, ``offsets``, ``units`` and ``descriptions``
attributes to :py:class:`~xarray.DataArray` returned by
:py:func:`~xarray.open_rasterio`. (:issue:`3013`)
- Bug fixes:
- Resolved deprecation warnings from newer versions of matplotlib and dask.
- Compatibility fixes for the upcoming pandas 0.25 and NumPy 1.17 releases.
- Fix summaries for multiindex coordinates (:issue:`3079`).
- Fix HDF5 error that could arise when reading multiple groups from a file at
once (:issue:`2954`).
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=21
- New functions/methods:
- Two new functions, :py:func:`~xarray.combine_nested` and
:py:func:`~xarray.combine_by_coords`, allow for combining datasets along any
number of dimensions, instead of the one-dimensional list of datasets
supported by :py:func:`~xarray.concat`.
The new ``combine_nested`` will accept the datasets as a nested
list-of-lists, and combine by applying a series of concat and merge
operations. The new ``combine_by_coords`` instead uses the dimension
coordinates of datasets to order them.
:py:func:`~xarray.open_mfdataset` can use either ``combine_nested`` or
``combine_by_coords`` to combine datasets along multiple dimensions, by
specifying the argument ``combine='nested'`` or ``combine='by_coords'``.
The older function :py:func:`~xarray.auto_combine` has been deprecated,
because its functionality has been subsumed by the new functions.
To avoid FutureWarnings switch to using ``combine_nested`` or
``combine_by_coords``, (or set the ``combine`` argument in
``open_mfdataset``). (:issue:`2159`)
By `Tom Nicholas <http://github.com/TomNicholas>`_.
- :py:meth:`~xarray.DataArray.rolling_exp` and
:py:meth:`~xarray.Dataset.rolling_exp` added, similar to pandas'
``pd.DataFrame.ewm`` method. Calling ``.mean`` on the resulting object
will return an exponentially weighted moving average.
By `Maximilian Roos <https://github.com/max-sixty>`_.
- New :py:func:`DataArray.str <core.accessor_str.StringAccessor>` for string
related manipulations, based on ``pandas.Series.str``.
By `0x0L <https://github.com/0x0L>`_.
- Added ``strftime`` method to ``.dt`` accessor, making it simpler to hand a
datetime ``DataArray`` to other code expecting formatted dates and times.
(:issue:`2090`). :py:meth:`~xarray.CFTimeIndex.strftime` is also now
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=18
- Bug fixes
- Saving files with times encoded with reference dates with timezones
(e.g. '2000-01-01T00:00:00-05:00') no longer raises an error
(:issue:`2649`).
- Fixed performance regression with ``open_mfdataset`` (:issue:`2662`).
- Fixed supplying an explicit dimension in the ``concat_dim`` argument to
to ``open_mfdataset`` (:issue:`2647`).
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python:numeric/python-xarray?expand=0&rev=13