Observational datasets
Observational datasets¶
The datasets module provides ready access to several datasets that are cached locally.
- datasets.aircraft_sections(source='obs-multi-sensor', vertical_coord='z', clobber=False)¶
Return a dataset with aircraft sections.
- Parameters
source (str, optional) – The data to use, options include “obs”, “obs-multi-sensor”, or the name of a model.
vertical_coord (string, optional) – The coordinate; possibilities include “z”, “theta”, and “pressure”.
clobber (boolean, optional) – If true, remove cache and recompute.
- Returns
ds – The section dataset.
- Return type
xarray.Dataset
- datasets.aircraft_profiles(source='obs', tracer='CO2', vertical_coord='theta', clobber=False)¶
Return an xarray.Dataset with profiles from aircraft data binned on a “z” or “theta” coordinate.
- Parameters
source (str, optional) – The data to use, options include “obs”, “obs-multi-sensor”, or the name of a model.
tracer (str, optional) – The constituent for which to make the profiles.
vertical_coord (string, optional) – The coordinate; possibilities include “z”, “theta”, and “pressure”.
clobber (boolean, optional) – If true, remove cache and recompute.
- Returns
ds – Dataset with the profiles.
- Return type
xarray.Dataset
- datasets.aircraft_profiles_seasonal(source='obs', tracer='CO2', vertical_coord='theta', seasonal_groups=['DJF', 'MAM', 'JJA', 'SON'], clobber=False)¶
Return dataset with profiles aggegated by seasonal groups
- Parameters
source (str, optional) – The data to use, options include “obs”, “obs-multi-sensor”, or the name of a model.
tracer (str, optional) – The constituent for which to make the profiles.
vertical_coord (string, optional) – The coordinate; possibilities include “z”, “theta”, and “pressure”.
seasonal_group (list) – Can be [‘DJF’, ‘MAM’, …] or [‘DJF’, ‘MAMJJASON’]
clobber (boolean, optional) – If true, remove cache and recompute.
- Returns
ds – Dataset with the profiles.
- Return type
xarray.Dataset
- datasets.obs_surface_stn_v_lat(season, constituent='CO2', minus_spo=True)¶
Return a dataset with seasonal-mean surface-station observations.
- Parameters
season (string) – The season over which to compute mean.
constituent (string) – Either CO2 or SF6
minus_spo (boolean) – Specify whether to subtract the SPO record.
- Returns
ds – Dataset with seasonal-mean station data.
- Return type
xarray.Dataset
- datasets.obs_surface_climatology(constituent='CO2', minus_spo=True)¶
Return a dataset with the climatological surface-station observations.
- Parameters
constituent (string) – Either CO2 or SF6
minus_spo (boolean) – Specify whether to subtract the SPO record.
- Returns
ds – Dataset with seasonal-mean station data.
- Return type
xarray.Dataset