diff --git a/doc/api.rst b/doc/api.rst index 699687441d7..9b3d6dfaf95 100644 --- a/doc/api.rst +++ b/doc/api.rst @@ -610,6 +610,7 @@ Plotting Dataset.plot DataArray.plot + Dataset.plot.scatter plot.plot plot.contourf plot.contour diff --git a/doc/whats-new.rst b/doc/whats-new.rst index 57da2910d6e..c40f7fc64ed 100644 --- a/doc/whats-new.rst +++ b/doc/whats-new.rst @@ -15,15 +15,20 @@ What's New .. _whats-new.0.13.0: -v0.13.0 (unreleased) --------------------- +v0.13.0 (10 July 2019) +---------------------- -This release increases the minimum required Python version from 3.5.0 to 3.5.3 -(:issue:`3089`). By `Guido Imperiale `_. +This release includes many exciting changes: wrapping of +`NEP18 `_ compliant +numpy-like arrays; new :py:meth:`~Dataset.plot.scatter` method that can scatter +two ``DataArrays`` in a ``Dataset`` against each other; support for converting pandas +DataFrames to xarray objects that wrap ``pydata/sparse``; and more! Breaking changes ~~~~~~~~~~~~~~~~ +- This release increases the minimum required Python version from 3.5.0 to 3.5.3 + (:issue:`3089`). By `Guido Imperiale `_. - The ``isel_points`` and ``sel_points`` methods are removed, having been deprecated since v0.10.0. These are redundant with the ``isel`` / ``sel`` methods. See :ref:`vectorized_indexing` for the details @@ -54,16 +59,16 @@ Breaking changes error in a later release. (:issue:`3250`) by `Guido Imperiale `_. -- The default dimension for :py:meth:`~xarray.Dataset.groupby`, :py:meth:`~xarray.Dataset.resample`, - :py:meth:`~xarray.DataArray.groupby` and :py:meth:`~xarray.DataArray.resample` reductions is now the +- The default dimension for :py:meth:`Dataset.groupby`, :py:meth:`Dataset.resample`, + :py:meth:`DataArray.groupby` and :py:meth:`DataArray.resample` reductions is now the grouping or resampling dimension. -- :py:meth:`~Dataset.to_dataset` requires ``name`` to be passed as a kwarg (previously ambiguous +- :py:meth:`DataArray.to_dataset` requires ``name`` to be passed as a kwarg (previously ambiguous positional arguments were deprecated) - Reindexing with variables of a different dimension now raise an error (previously deprecated) - :py:func:`~xarray.broadcast_array` is removed (previously deprecated in favor of :py:func:`~xarray.broadcast`) -- :py:meth:`~Variable.expand_dims` is removed (previously deprecated in favor of - :py:meth:`~Variable.set_dims`) +- :py:meth:`Variable.expand_dims` is removed (previously deprecated in favor of + :py:meth:`Variable.set_dims`) New functions/methods ~~~~~~~~~~~~~~~~~~~~~ @@ -102,13 +107,15 @@ New functions/methods Currently only :py:meth:`Dataset.plot.scatter` is implemented. By `Yohai Bar Sinai `_ and `Deepak Cherian `_ -- Added `head`, `tail` and `thin` methods to `Dataset` and `DataArray`. (:issue:`319`) - By `Gerardo Rivera `_. +- Added :py:meth:`DataArray.head`, :py:meth:`DataArray.tail` and :py:meth:`DataArray.thin`; + as well as :py:meth:`Dataset.head`, :py:meth:`Dataset.tail` and :py:meth:`Dataset.thin` methods. + (:issue:`319`) By `Gerardo Rivera `_. Enhancements ~~~~~~~~~~~~ - Multiple enhancements to :py:func:`~xarray.concat` and :py:func:`~xarray.open_mfdataset`. + By `Deepak Cherian `_ - Added ``compat='override'``. When merging, this option picks the variable from the first dataset and skips all comparisons. @@ -131,8 +138,6 @@ Enhancements data = xr.open_mfdataset(files, concat_dim='time', data_vars='minimal', coords='minimal', compat='override', join='override') - By `Deepak Cherian `_: - - In :py:meth:`~xarray.Dataset.to_zarr`, passing ``mode`` is not mandatory if ``append_dim`` is set, as it will automatically be set to ``'a'`` internally. By `David Brochart `_. @@ -156,7 +161,8 @@ Enhancements when the user passes invalid arguments (:issue:`3176`). By `Gregory Gundersen `_. -- :py:func:`filter_by_attrs` now filters the coordinates as well as the variables. By `Spencer Jones `_. +- :py:func:`filter_by_attrs` now filters the coordinates as well as the variables. + By `Spencer Jones `_. Bug fixes ~~~~~~~~~ @@ -195,9 +201,7 @@ Bug fixes - Plots in 2 dimensions (pcolormesh, contour) now allow to specify levels as numpy array (:issue:`3284`). By `Mathias Hauser `_. - Fixed bug in :meth:`DataArray.quantile` failing to keep attributes when - `keep_attrs` was True (:issue:`3304`). By David Huard `_. - -.. _whats-new.0.12.3: + `keep_attrs` was True (:issue:`3304`). By David Huard ``_. Documentation ~~~~~~~~~~~~~ @@ -210,6 +214,8 @@ Documentation (:issue:`3227`). By `Gregory Gundersen `_. +.. _whats-new.0.12.3: + v0.12.3 (10 July 2019) ---------------------- @@ -224,14 +230,14 @@ New functions/methods as described in :ref:`reshape.stacking_different`. By `Noah Brenowitz `_. +Enhancements +~~~~~~~~~~~~ + - Support for renaming ``Dataset`` variables and dimensions independently with :py:meth:`~Dataset.rename_vars` and :py:meth:`~Dataset.rename_dims` (:issue:`3026`). By `Julia Kent `_. -Enhancements -~~~~~~~~~~~~ - - Add ``scales``, ``offsets``, ``units`` and ``descriptions`` attributes to :py:class:`~xarray.DataArray` returned by :py:func:`~xarray.open_rasterio`. (:issue:`3013`)