earthkit.climate.atmos.temperature.biologically_effective_degree_days

earthkit.climate.atmos.temperature.biologically_effective_degree_days(tasmin: xarray.DataArray | str = 'tasmin', tasmax: xarray.DataArray | str = 'tasmax', lat: xarray.DataArray | str = 'lat', ds: xarray.Dataset | Any = None, *, thresh_tasmin: Any = '10 degC', method: Literal['gladstones', 'icclim', 'jones', 'smoothed', 'stepwise'] = 'gladstones', cap_value: float = 1.0, low_dtr: Any = '10 degC', high_dtr: Any = '13 degC', max_daily_degree_days: Any = '9 degC', start_date: str | str = '04-01', end_date: str | str = '11-01', freq: str = 'YS', **kwargs: Any) → Any

Biologically effective degree days.

Considers daily minimum and maximum temperature with a given base threshold between 1 April and 31 October, with a maximum daily value for cumulative degree days (typically 9°C), and integrates modification coefficients for latitudes between 40°N and 50°N as well as for swings in daily temperature range. Metric originally published in Gladstones (1992).

Units:

  • bedd: K days

This function wraps xclim.indicators.atmos.biologically_effective_degree_days.

Parameters:

  • tasmin (xarray.DataArray | str) – Minimum daily temperature.

  • tasmax (xarray.DataArray | str) – Maximum daily temperature.

  • lat (xarray.DataArray | str) – Latitude coordinate. If None and method is not “icclim”, a CF-conformant “latitude” field must be available within the passed DataArray.

  • thresh_tasmin (Any) – The minimum temperature threshold.

  • method (Literal[``’gladstones’, ``'icclim', 'jones', 'smoothed', 'stepwise']) – The formula to use for the daily temperature range and latitude coefficient. The “gladstones” method uses a temperature range adjustment and a latitude coefficient based on :cite:t:`gladstones_wine_2011`. End_date should be “11-01” for the Northern Hemisphere. The “huglin” method uses a temperature range adjustment and a stepwise latitude coefficient for values between 40° and 50° based on :cite:t:`huglin_nouveau_1978`. End_date should be “11-01” for the Northern Hemisphere. The “icclim” method does not implement daily temperature range and nor a latitude coefficient based on :cite:t:`project_team_eca&d_algorithm_2013`. End date should be “10-01” for the Northern Hemisphere. The “interpolated” method uses a temperature range adjustment and a smoothed curve latitude coefficient for values between 40° and 50° based on :cite:t:`huglin_nouveau_1978`. The “jones” method uses a temperature range adjustment and integrates axial tilt, latitude, and day-of-year based on :cite:t:`hall_spatial_2010`. End_date should be “11-01” for the Northern Hemisphere.

  • cap_value (float) – The value to use for the latitude coefficient for latitudes north of 50°N or south of 50°S. Only applicable for methods “huglin” and “interpolated”.

  • low_dtr (Any) – The lower bound for daily temperature range adjustment.

  • high_dtr (Any) – The higher bound for daily temperature range adjustment.

  • max_daily_degree_days (Any) – The maximum number of biologically effective degrees days that can be summed daily.

  • start_date (str | str) – The hemisphere-based start date to consider (north = April, south = October).

  • end_date (str | str) – The hemisphere-based start date to consider (north = October, south = April). This date is non-inclusive.

  • freq (str) – Resampling frequency (For Southern Hemisphere, should be “YS-JUL”).

  • ds (xarray.Dataset | Any) – Input dataset.

  • **kwargs (Any) – Additional keyword arguments.

Returns:

The computed index.

Return type:

Any