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 r
(*args, **kwargs)
| 176 | |
| 177 | |
| 178 | def load_dataset(*args, **kwargs) -> Dataset: |
| 179 | """ |
| 180 | Open, load into memory, and close a dataset from the online repository |
| 181 | (requires internet). |
| 182 | |
| 183 | If a local copy is found then always use that to avoid network traffic. |
| 184 | |
| 185 | Available datasets: |
| 186 | |
| 187 | * ``"air_temperature"``: NCEP reanalysis subset |
| 188 | * ``"air_temperature_gradient"``: NCEP reanalysis subset with approximate x,y gradients |
| 189 | * ``"basin_mask"``: Dataset with ocean basins marked using integers |
| 190 | * ``"rasm"``: Output of the Regional Arctic System Model (RASM) |
| 191 | * ``"ROMS_example"``: Regional Ocean Model System (ROMS) output |
| 192 | * ``"tiny"``: small synthetic dataset with a 1D data variable |
| 193 | * ``"era5-2mt-2019-03-uk.grib"``: ERA5 temperature data over the UK |
| 194 | * ``"eraint_uvz"``: data from ERA-Interim reanalysis, monthly averages of upper level data |
| 195 | * ``"ersstv5"``: NOAA's Extended Reconstructed Sea Surface Temperature monthly averages |
| 196 | |
| 197 | Parameters |
| 198 | ---------- |
| 199 | name : str |
| 200 | Name of the file containing the dataset. |
| 201 | e.g. 'air_temperature' |
| 202 | cache_dir : path-like, optional |
| 203 | The directory in which to search for and write cached data. |
| 204 | cache : bool, optional |
| 205 | If True, then cache data locally for use on subsequent calls |
| 206 | **kws : dict, optional |
| 207 | Passed to xarray.open_dataset |
| 208 | |
| 209 | See Also |
| 210 | -------- |
| 211 | tutorial.open_dataset |
| 212 | open_dataset |
| 213 | load_dataset |
| 214 | """ |
| 215 | with open_dataset(*args, **kwargs) as ds: |
| 216 | return ds.load() |
| 217 | |
| 218 | |
| 219 | def scatter_example_dataset(*, seed: int | None = None) -> Dataset: |
nothing calls this directly
no test coverage detected
searching dependent graphs…