Add new datasets to tutorial.load_dataset docstring (#6719)

* Add new datasets to tutorial.load_dataset docstring

* Add basin_mask; file types.

* [skip-ci] Add docstring for tutorial.load_dataset

Author: dcherian

xarray/tutorial.py

@@ -38,6 +38,9 @@ def _construct_cache_dir(path):
 }
 file_formats = {
     "air_temperature": 3,
+    "air_temperature_gradient": 4,
+    "basin_mask": 4,
+    "ersstv5": 4,
     "rasm": 3,
     "ROMS_example": 4,
     "tiny": 3,
@@ -88,11 +91,14 @@ def open_dataset(
     Available datasets:
 
     * ``"air_temperature"``: NCEP reanalysis subset
+    * ``"air_temperature_gradient"``: NCEP reanalysis subset with approximate x,y gradients
+    * ``"basin_mask"``: Dataset with ocean basins marked using integers
     * ``"rasm"``: Output of the Regional Arctic System Model (RASM)
     * ``"ROMS_example"``: Regional Ocean Model System (ROMS) output
     * ``"tiny"``: small synthetic dataset with a 1D data variable
     * ``"era5-2mt-2019-03-uk.grib"``: ERA5 temperature data over the UK
     * ``"eraint_uvz"``: data from ERA-Interim reanalysis, monthly averages of upper level data
+    * ``"ersstv5"``: NOAA's Extended Reconstructed Sea Surface Temperature monthly averages
 
     Parameters
     ----------
@@ -108,7 +114,9 @@ def open_dataset(
 
     See Also
     --------
-    xarray.open_dataset
+    tutorial.load_dataset
+    open_dataset
+    load_dataset
     """
     try:
         import pooch
@@ -218,9 +226,37 @@ def load_dataset(*args, **kwargs):
     Open, load into memory, and close a dataset from the online repository
     (requires internet).
 
+    If a local copy is found then always use that to avoid network traffic.
+
+    Available datasets:
+
+    * ``"air_temperature"``: NCEP reanalysis subset
+    * ``"air_temperature_gradient"``: NCEP reanalysis subset with approximate x,y gradients
+    * ``"basin_mask"``: Dataset with ocean basins marked using integers
+    * ``"rasm"``: Output of the Regional Arctic System Model (RASM)
+    * ``"ROMS_example"``: Regional Ocean Model System (ROMS) output
+    * ``"tiny"``: small synthetic dataset with a 1D data variable
+    * ``"era5-2mt-2019-03-uk.grib"``: ERA5 temperature data over the UK
+    * ``"eraint_uvz"``: data from ERA-Interim reanalysis, monthly averages of upper level data
+    * ``"ersstv5"``: NOAA's Extended Reconstructed Sea Surface Temperature monthly averages
+
+    Parameters
+    ----------
+    name : str
+        Name of the file containing the dataset.
+        e.g. 'air_temperature'
+    cache_dir : path-like, optional
+        The directory in which to search for and write cached data.
+    cache : bool, optional
+        If True, then cache data locally for use on subsequent calls
+    **kws : dict, optional
+        Passed to xarray.open_dataset
+
     See Also
     --------
+    tutorial.open_dataset
     open_dataset
+    load_dataset
     """
     with open_dataset(*args, **kwargs) as ds:
         return ds.load()