Dataset Module

Bounds

class dataset.Bounds(lat_min, lat_max, lon_min, lon_max, start, end)

Container for holding spatial and temporal bounds information.

Certain operations require valid bounding information to be present for correct functioning. Bounds guarantees that a function receives well formed information without the need to do the validation manually.

Spatial and temporal bounds must follow the following guidelines.

• Latitude values must be in the range [-90, 90]
• Longitude values must be in the range [-180, 180]
• Lat/Lon Min values must be less than the corresponding Lat/Lon Max values.
• Temporal bounds must a valid datetime object

Default Bounds constructor

Parameters:

• lat_min (float) – The minimum latitude bound.
• lat_max (float) – The maximum latitude bound.
• lon_min (float) – The minimum longitude bound.
• lon_max (float) – The maximum longitude bound.
• start (datetime) – The starting datetime bound.
• end (datetime) – The ending datetime bound.

Raises:

ValueError

Dataset

class dataset.Dataset(lats, lons, times, values, variable=None, name='')

Container for a dataset’s attributes and data.

Default Dataset constructor

Parameters:

• lats (numpy array) – One dimensional numpy array of unique latitude values.
• lons (numpy array) – One dimensional numpy array of unique longitude values.
• times (numpy array) – One dimensional numpy array of unique python datetime objects.
• values (numpy array) – Three dimensional numpy array of parameter values with shape [timesLength, latsLength, lonsLength].
• variable (string) – Name of the value variable.
• name – An optional string name for the Dataset.

Raises:

ValueError

spatial_boundaries()

Calculate the spatial boundaries.

Returns:The Dataset’s bounding latitude and longitude values as a tuple in the form (min_lat, max_lat, min_lon, max_lon) Return type:(float, float, float, float)

spatial_resolution()

Calculate the latitudinal and longitudinal spatial resolution.

Warning

This only works with properly gridded data.

Returns:The Dataset’s latitudinal and longitudinal spatial resolution as a tuple of the form (lat_resolution, lon_resolution). Return type:(float, float)

temporal_resolution()

Calculate the temporal resolution.

Raises ValueError:  If timedelta.days as calculated from the sorted list of times is an unrecognized value a ValueError is raised. Returns:The temporal resolution. Return type:string

time_range()

Calculate the temporal range

Returns:The start and end date of the Dataset’s temporal range as a tuple in the form (start_time, end_time). Return type:(datetime, datetime)