Merge remote-tracking branch 'upstream/master' into fix/user-coordinates

* upstream/master: (35 commits)
  fix plotting with transposed nondim coords. (pydata#3441)
  make coarsen reductions consistent with reductions on other classes (pydata#3500)
  Resolve the version issues on RTD (pydata#3589)
  Add bottleneck & rasterio git tip to upstream-dev CI (pydata#3585)
  update whats-new.rst (pydata#3581)
  Examples for quantile (pydata#3576)
  add cftime intersphinx entries (pydata#3577)
  Add pyXpcm to Related Projects doc page (pydata#3578)
  Reimplement quantile with apply_ufunc (pydata#3559)
  add environment file for binderized examples (pydata#3568)
  Add drop to api.rst under pending deprecations (pydata#3561)
  replace duplicate method _from_vars_and_coord_names (pydata#3565)
  propagate indexes in to_dataset, from_dataset (pydata#3519)
  Switch examples to notebooks + scipy19 docs improvements (pydata#3557)
  fix whats-new.rst (pydata#3554)
  Tweaks to release instructions (pydata#3555)
  Clarify conda environments for new contributors (pydata#3551)
  Revert to dev version
  0.14.1 whatsnew (pydata#3547)
  sparse option to reindex and unstack (pydata#3542)
  ...

Author: dcherian

.binder/environment.yml

@@ -0,0 +1,39 @@
+name: xarray-examples
+channels:
+  - conda-forge
+dependencies:
+  - python=3.7
+  - boto3
+  - bottleneck
+  - cartopy
+  - cdms2
+  - cfgrib
+  - cftime
+  - coveralls
+  - dask
+  - distributed
+  - dask_labextension
+  - h5netcdf
+  - h5py
+  - hdf5
+  - iris
+  - lxml    # Optional dep of pydap
+  - matplotlib
+  - nc-time-axis
+  - netcdf4
+  - numba
+  - numpy
+  - pandas
+  - pint
+  - pip
+  - pydap
+  - pynio
+  - rasterio
+  - scipy
+  - seaborn
+  - sparse
+  - toolz
+  - xarray
+  - zarr
+  - pip:
+    - numbagg

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: numfocus
+custom: http://numfocus.org/donate-to-xarray

HOW_TO_RELEASE renamed to HOW_TO_RELEASE.md

@@ -1,9 +1,11 @@
-How to issue an xarray release in 15 easy steps
+How to issue an xarray release in 14 easy steps
 
 Time required: about an hour.
 
  1. Ensure your master branch is synced to upstream:
-       git pull upstream master
+      ```
+      git pull upstream master
+      ```
  2. Look over whats-new.rst and the docs. Make sure "What's New" is complete
     (check the date!) and consider adding a brief summary note describing the
     release at the top.
@@ -12,37 +14,53 @@ Time required: about an hour.
     - Function/method references should include links to the API docs.
     - Sometimes notes get added in the wrong section of whats-new, typically
       due to a bad merge. Check for these before a release by using git diff,
-      e.g., ``git diff v0.X.Y whats-new.rst`` where 0.X.Y is the previous
+      e.g., `git diff v0.X.Y whats-new.rst` where 0.X.Y is the previous
       release.
  3. If you have any doubts, run the full test suite one final time!
-      py.test
+      ```
+      pytest
+      ```
  4. On the master branch, commit the release in git:
+      ```
       git commit -a -m 'Release v0.X.Y'
+      ```
  5. Tag the release:
+      ```
       git tag -a v0.X.Y -m 'v0.X.Y'
+      ```
  6. Build source and binary wheels for pypi:
+      ```
       git clean -xdf  # this deletes all uncommited changes!
       python setup.py bdist_wheel sdist
+      ```
  7. Use twine to register and upload the release on pypi. Be careful, you can't
     take this back!
+      ```
       twine upload dist/xarray-0.X.Y*
+      ```
     You will need to be listed as a package owner at
     https://pypi.python.org/pypi/xarray for this to work.
  8. Push your changes to master:
+      ```
       git push upstream master
       git push upstream --tags
+      ```
  9. Update the stable branch (used by ReadTheDocs) and switch back to master:
+     ```
       git checkout stable
       git rebase master
       git push upstream stable
       git checkout master
-    It's OK to force push to 'stable' if necessary.
-    We also update the stable branch with `git cherrypick` for documentation
-    only fixes that apply the current released version.
+     ```
+    It's OK to force push to 'stable' if necessary. (We also update the stable 
+    branch with `git cherrypick` for documentation only fixes that apply the 
+    current released version.)
 10. Add a section for the next release (v.X.(Y+1)) to doc/whats-new.rst.
 11. Commit your changes and push to master again:
-      git commit -a -m 'Revert to dev version'
+      ```
+      git commit -a -m 'New whatsnew section'
       git push upstream master
+      ```
     You're done pushing to master!
 12. Issue the release on GitHub. Click on "Draft a new release" at
     https://github.com/pydata/xarray/releases. Type in the version number, but
@@ -53,11 +71,22 @@ Time required: about an hour.
 14. Issue the release announcement! For bug fix releases, I usually only email
     [email protected]. For major/feature releases, I will email a broader
     list (no more than once every 3-6 months):
-      [email protected], [email protected],
-      [email protected], [email protected],
-      [email protected]
+      - [email protected]
+      - [email protected]
+      - [email protected]
+      - [email protected]
+      - [email protected]
+
     Google search will turn up examples of prior release announcements (look for
     "ANN xarray").
+    You can get a list of contributors with:
+    ```
+    git log "$(git tag --sort="v:refname" | sed -n 'x;$p').." --format="%aN" | sort -u
+    ```
+    or by replacing `v0.X.Y` with the _previous_ release in:
+    ```
+    git log v0.X.Y.. --format="%aN" | sort -u
+    ```
 
 Note on version numbering:
 

ci/azure/install.yml

@@ -16,16 +16,18 @@ steps:
         --pre \
         --upgrade \
         matplotlib \
+        numpy \
         pandas \
         scipy
-        # numpy \  # FIXME https://github.com/pydata/xarray/issues/3409
     pip install \
         --no-deps \
         --upgrade \
         git+https://github.com/dask/dask \
         git+https://github.com/dask/distributed \
         git+https://github.com/zarr-developers/zarr \
-        git+https://github.com/Unidata/cftime
+        git+https://github.com/Unidata/cftime \
+        git+https://github.com/mapbox/rasterio \
+        git+https://github.com/pydata/bottleneck
   condition: eq(variables['UPSTREAM_DEV'], 'true')
   displayName: Install upstream dev dependencies
 

ci/requirements/doc.yml

@@ -6,16 +6,20 @@ dependencies:
   - python=3.7
   - bottleneck
   - cartopy
+  - cfgrib
   - h5netcdf
+  - ipykernel
   - ipython
   - iris
+  - jupyter_client
+  - nbsphinx
   - netcdf4
   - numpy
   - numpydoc
   - pandas<0.25  # Hack around https://github.com/pydata/xarray/issues/3369
   - rasterio
   - seaborn
   - sphinx
-  - sphinx-gallery
   - sphinx_rtd_theme
+  - xarray
   - zarr

ci/requirements/py36.yml

@@ -25,7 +25,7 @@ dependencies:
   - nc-time-axis
   - netcdf4
   - numba
-  - numpy<1.18  # FIXME https://github.com/pydata/xarray/issues/3409
+  - numpy
   - pandas
   - pint
   - pip

ci/requirements/py37.yml

@@ -25,7 +25,7 @@ dependencies:
   - nc-time-axis
   - netcdf4
   - numba
-  - numpy<1.18  # FIXME https://github.com/pydata/xarray/issues/3409
+  - numpy
   - pandas
   - pint
   - pip

doc/README.rst

@@ -1,3 +1,5 @@
+:orphan:
+
 xarray
 ------
 

doc/api-hidden.rst

@@ -2,6 +2,8 @@
 .. This extra page is a work around for sphinx not having any support for
 .. hiding an autosummary table.
 
+:orphan:
+
 .. currentmodule:: xarray
 
 .. autosummary::
@@ -30,9 +32,11 @@
    core.groupby.DatasetGroupBy.first
    core.groupby.DatasetGroupBy.last
    core.groupby.DatasetGroupBy.fillna
+   core.groupby.DatasetGroupBy.quantile
    core.groupby.DatasetGroupBy.where
 
    Dataset.argsort
+   Dataset.astype
    Dataset.clip
    Dataset.conj
    Dataset.conjugate
@@ -71,6 +75,7 @@
    core.groupby.DataArrayGroupBy.first
    core.groupby.DataArrayGroupBy.last
    core.groupby.DataArrayGroupBy.fillna
+   core.groupby.DataArrayGroupBy.quantile
    core.groupby.DataArrayGroupBy.where
 
    DataArray.argsort

doc/api.rst

@@ -675,3 +675,12 @@ arguments for the ``from_store`` and ``dump_to_store`` Dataset methods:
    backends.FileManager
    backends.CachingFileManager
    backends.DummyFileManager
+
+Deprecated / Pending Deprecation
+================================
+
+   Dataset.drop
+   DataArray.drop
+   Dataset.apply
+   core.groupby.DataArrayGroupBy.apply
+   core.groupby.DatasetGroupBy.apply