Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

MiTHo: access and interpret Cumulative Hazard Indices

ESA

Explore re-projected dataset in the Med cube

This dataset provides monthly information on Cumulative Hazard Indexs (CHIs) at the sea surface (3D, lat, lon, time) at global scale. The dataset is split into 3 zarr stores:

  1. Global CHI1 and CHI3 indicies

  2. Global CHI2 indicies

  3. Global CHI4 indicies

This tutorial accesses the published Zarr stores over HTTPS and illustrates the multistressor construction of CHI1, global July 2022 conditions, and annual changes across the Mediterranean and four subbasins: Western Mediterranean, Adriatic, Ionian, and Levantine–Aegean. The monthly map shows July 2022; time series cover the full record.

The Mediterranean is used here as a regional example to illustrate basin-scale and subbasin-scale analyses. A global map provides context; basin analyses are examples, not a geographic restriction of the data.

Source: original NetCDF dataset on Zenodo · catalogue entry · MiTHo

IndexInputs / stressorsAvailable periodLevels
CHI1Sea surface temperature (SST): warm and cold extremes; hydrogen ion concentration (H+): acidificationJan 1993–Dec 2022Surface
CHI2Temperature: warm and cold extremes; dissolved oxygen: deoxygenation; salinity: low and high extremesJan 2004–Nov 20222.5 dbar (level=0), 200 dbar (level=1)
CHI3SST, H+, sea surface salinity (SSS), sea surface density (SSD), wind speed: nine stressors in totalJan 1993–Dec 2022Surface
CHI4SST: warm and cold extremes; fishing effort (FE): high valuesJan 2012–Dec 2020Surface

The dataset is gridded on a 1° x 1° regular lat-lon grid.
Geographic coverage and valid-data masks differ between indices. CHI3 combines both low and high extremes of SSS, SSD and wind in a single index. For any given variable and threshold pair, low and high extremes are mutually exclusive at the same place and time. Extremes of different variables can occur together.

1. Environment and required input files

The CHI stores use Zarr format 3.

Keep these files together:

mitho_access.ipynb
inputs/
    mediterranean_subbasin_masks_1deg.nc

The basin-mask NetCDF is a ready-to-use input file distributed with this notebook. The notebook reads it without modifying it; it does not create, resample or export a basin-mask file. No original high-resolution masks are needed. The input path can be changed in the settings below.

Figures, tables and run information are saved in notebook_artifacts/. Access to the public CHI data requires internet. Cartopy may also download Natural Earth coastline and land files on the first run.

Create the output directory and display the package versions used for this run.

Loading...

2. Locate and open the published data

The first store contains CHI1 and CHI3, using CH1_ and CH3_ prefixes. The other stores contain CHI2 and CHI4. Fetching each store’s root metadata below checks that all three URLs expose Zarr 3 groups, without loading their data arrays.

Loading...

Fetch the small root metadata from each store to check access. This does not download the full datasets.

Loading...

Open the CHI1/CHI3 store lazily: xarray reads metadata now and numerical chunks only when requested.

Loading...

3. What does CHI1 represent?

The original processing code constructs the unnormalized CHI1 as:

CHI1 = S_MHW + S_CS + S_PH

S_MHW is the marine-heatwave contribution, S_CS the cold-spell contribution, and S_PH the acidification contribution. They are non-negative, dimensionless stressor intensities derived from standardized anomalies at detected extremes. They are not raw SST or pH measurements. For SST, the processing uses monthly 90th/10th percentile thresholds for warm/cold extremes, respectively.

The example uses the unnormalized, fixed-climatology variables. _mav identifies the alternative based on a moving climatology, rather than simply a smoothed CHI time series. _norm, _mean, _std, _Cat and _PI identify other derived products; they are not interchangeable with the variables plotted here.

Higher CHI values indicate a larger sum of stressor contributions under this method; they are not calibrated probabilities of ecological damage. The baseline depends on the input product and must be considered when comparing different indices.

For CHI1, _norm divides the raw index by the global spatial maximum of each month. The global context below uses raw CHI1, not this normalized variant.

A small helper keeps geographic slicing valid for either coordinate ordering.

Select only the variables and geographic rectangle needed for the regional example.

Native chunks: {'CH1_CHI1': (180, 180, 360), 'CH1_S_MHW': (180, 180, 360), 'CH1_S_CS': (180, 180, 360), 'CH1_S_PH': (180, 180, 360)}
Subset dimensions: {'time': 360, 'latitude': 16, 'longitude': 42}

Load the selected regional data once, then extract the July 2022 map.

4. Read the supplied Mediterranean basin-mask file

inputs/mediterranean_subbasin_masks_1deg.nc already contains masks on the same 1° grid as the CHI data, with these variables:

Variable in the fileRegion
MediterraneanWhole Mediterranean
Western_MediterraneanWestern Mediterranean
Adriatic_SeaAdriatic
Ionian_SeaIonian
Levantine_Aegean_SeaLevantine–Aegean

Values are 1 inside each supplied mask and 0 outside it. The code selects the matching grid coordinates directly: it performs no interpolation or regridding.

For the analysis, cells without CHI1 data are excluded. This is a data-availability filter, not a change to the supplied basin boundaries. Fixed temporal coverage is applied later when computing the means. The following map visualizes the regions read from the file on the CHI marine-data footprint.

Exclude cells without CHI1 observations, while keeping the supplied region assignments.

Visualize the regions read from the input file. Colours are display labels only.

/Users/dean/code/ocean_hackathon/.pixi/envs/default/lib/python3.13/site-packages/cartopy/io/__init__.py:242: DownloadWarning: Downloading: https://naturalearth.s3.amazonaws.com/110m_physical/ne_110m_land.zip
  warnings.warn(f'Downloading: {url}', DownloadWarning)
/Users/dean/code/ocean_hackathon/.pixi/envs/default/lib/python3.13/site-packages/cartopy/io/__init__.py:242: DownloadWarning: Downloading: https://naturalearth.s3.amazonaws.com/110m_physical/ne_110m_coastline.zip
  warnings.warn(f'Downloading: {url}', DownloadWarning)
<Figure size 1200x500 with 1 Axes>

5. Global context: raw CHI1 in July 2022

Use a monthly map of the unnormalized CHI1, rather than a full-period count. This retains the spatial contrast between places with no detected stressors and places with larger cumulative intensities in the selected month. The colour scale covers the actual minimum of zero to the maximum in this map; values are not clipped to a percentile. White marine cells have no data.

The blue rectangle locates the Mediterranean example. The map is a snapshot, not a temporal trend or a calibrated ecological-risk map.

Raw global CHI1 in 2022-07: 0 to 7.304

Draw the global map using its own colour scale, in raw dimensionless CHI1 units.

<Figure size 1300x530 with 2 Axes>

6. CHI1 and its three contributions in July 2022

All panels use the same linear colour scale so the magnitude of the contributions can be compared directly. Land is grey; missing marine values are left blank. Only Mediterranean grid-cell centres selected by the geographic mask below are plotted. The basin time series below use these four subbasins and their union.

Draw the cumulative index and its components with the same colour limits.

<Figure size 1300x600 with 5 Axes>

7. Monthly time series for the Mediterranean and four subbasins

Use the same spatial sample in every month: only cells with finite CHI1, normalized CHI1 and all three contributions throughout 1993–2022 are retained. Weights are proportional to cos(latitude). Missing areas are not filled or extrapolated. The coverage table reports how much of each CHI marine footprint is retained. Subbasin means use the supplied boundaries, not rectangular selections.

Each panel shows basin-mean CHI1 and its three contributions, on a common y scale. The dashed line marks July 2022. All 360 monthly samples are shown without smoothing.

Compute one area-weighted monthly series per basin for each variable.

Inspect the retained coverage before interpreting the basin means.

Loading...

Plot each basin separately so that the individual contributions remain readable.

<Figure size 1300x1200 with 5 Axes>

8. Basin-wide annual evolution: are recent extremes stronger or more frequent?

Keep the same spatial sample in every month: retain basin grid cells with finite CHI1, normalized CHI1 and all three contributions for all 360 months. Use weights proportional to cos(latitude) for the equal-angle grid. The coverage table reports the retained fraction of each geographic mask; results describe those observed cells, not an extrapolation to missing parts of the basin.

Three metrics separate different aspects:

  1. Mean CHI1: mean over retained basin cells and all months of each year, including zeros.

  2. Affected area: annual mean of the monthly area fraction satisfying CHI1_norm > 1e-4.

  3. Intensity when active: annual weighted mean raw CHI1 across the active cell-months only.

The last metric helps separate magnitude from occurrence. An increase in mean CHI1 alone does not establish that individual extremes became stronger. These are descriptive comparisons under a fixed-climatology index, not a trend-significance or attribution test.

Display and save the annual and first/last-decade summaries.

Loading...
Loading...

Compare three complementary metrics; a higher mean index can reflect frequency as well as intensity.

<Figure size 1200x900 with 3 Axes>

9. Spatial comparison of the first and last decades

Compare raw mean CHI1 in 1993–2002 and 2013–2022 using the same complete-data Mediterranean cells. Positive differences indicate larger mean cumulative intensity, which can reflect changes in both occurrence and magnitude. No significance test is applied.

Compare the two decade means on a shared scale and map their difference separately.

<Figure size 1500x420 with 6 Axes>

10. Mediterranean Persistency and Category maps

Use the stored products, and first verify them against the monthly normalized data. All maps cover the full 1993–2022 period:

  • Persistency: number of months with CHI1_norm > 1e-4.

  • Low Category: number of months with 0 < CHI1_norm <= 0.33.

  • Medium Category: number of months with 0.33 < CHI1_norm <= 0.66.

  • High Category: number of months with 0.66 < CHI1_norm <= 1.001.

The 1.001 upper bound is the numerical margin used in the source code; the nominal normalized upper limit is 1. Category is relative to each month’s global spatial maximum, not an absolute hazard threshold. Categories partition positive normalized values; their total can differ from PI because PI excludes values at or below 1e-4.

These full-period counts locate repeated occurrence but do not themselves show whether events increased towards the end of the record. Use the annual metrics above for that question. Maps below retain the same complete-data Mediterranean mask. Each panel has its own colour scale in months, to make the rarer high category visible; compare the colourbar values, not colours alone, between panels.

Check that the supplied counts agree with the monthly normalized index.

Stored PI and all three Category counts match monthly data on the retained Mediterranean mask.

Draw PI and the three categories, each with its own explicitly labelled count scale.

<Figure size 1300x700 with 8 Axes>

Save the run settings and close the remote dataset.