Counting threshold exceedance events

Cal-Adapt Analytics Engine: threshold tools

This notebook calculates exceedance events (time periods above or below a certain threshold) at different time scales using the thresholds() tool, using different criteria describing the extreme event severity and duration (for example, how many 3-day periods per year contain at least five hours of temperatures above 100 degrees F?). For any given location using hourly data, we can calculate and display how frequencies of extreme events will change under different global emissions scenarios and across model simulations.

Intended Application: As a user, I want to understand the duration of extreme events and their impacts by:

1. Examining how the frequency of cold snaps or heat waves of a user-defined temperature (e.g. above 95 degF), duration (e.g. 3 hours or more), and period of time (e.g. for 6 days in a row) will change annually or seasonally
2. Exploring changes in the frequency of extreme precipitation events (for example, periods of low to no precipitation or high precipitation within a season or year) under different global emissions scenarios

Coming soon! Export functionality of your selected timeseries transformations

Step 0: setup

Import the climakitae library and other dependencies.

import climakitae as ck

Step 1: Explore threshold exceedance events and plot

Below, use the thresholds() GUI to explore extreme events. First, select the variable you are interested in characterizing extreme events of, and the units of that variable. You can also select an area of interest for exploring extreme events.

The exceedance calculator can then be used to measure the frequency of exceedance events based on four different parameters: threshold to capture events above or below (e.g. temperatures above 80 degF, temperatures below 30 degF), length of time of the event (e.g. temperatures above a threshold for three hours), whether to count frequency of events seasonally or annually, and duration of extreme event occurrences (for example, to measure multi-day heat events, set this to the number of days you want to consider a heat event).

Once you select the parameters of the event of interest, the plot on the right will show how frequencies of the defined extreme event change through the year 2100 across different GCM simulations, and changes can be explored for each global emissions scenario using the dropdown menu below the plot. Smoothing can optionally be applied to the time series as well.

Note the GUI below can be reloaded to reflect new selections using the ‘Reload data’ button. Static plots can be saved to export to your local computer by using the save button in the lower right of the plot window.

from climakitae.explore import thresholds
thresholds = thresholds()

thresholds.show()