pcmdi_metrics.io.load_regions_specs

pcmdi_metrics.io.load_regions_specs()[source]

Load predefined geographic region specifications for climate data analysis.

This function returns a dictionary containing various geographic regions and their specifications, including domains defined by latitude and longitude ranges and, in some cases, specific values representing land or ocean regions. The dictionary includes regions for mean climate analysis, modes of variability, and monsoon domains.

Returns:: dict – A dictionary where each key is a region name (e.g., “global”, “NHEX”, “CONUS”), and each value is a dictionary specifying the region’s domain and, in some cases, a value indicating land (100) or ocean (0).

Examples

>>> regions = load_regions_specs()
>>> regions["CONUS"]
{'domain': {'latitude': (24.7, 49.4), 'longitude': (-124.78, -66.92)}}
>>> regions["land"]
{'value': 100}

See also

region_subset: The function used to subset regions.

Notes

The predefined regions are categorized into three main groups:

Mean Climate Regions: These regions represent large-scale geographic areas or climate zones.

Region	Latitude	Longitude	Value
global
NHEX	(30.0, 90)
SHEX	(-90.0, -30)
TROPICS	(-30.0, 30)
50N90N	(50.0, 90)
CONUS	(24.7, 49.4)	(-124.78, -66.92)
land			100
ocean			0

Modes of Variability: These regions are associated with climate oscillations or variability patterns.

Region	Latitude Range	Longitude Range
NAM	(20.0, 90)	(-180, 180)
NAO	(20.0, 80)	(-90, 40)
SAM	(-20.0, -90)	(0, 360)
PSA1	(-20.0, -90)	(0, 360)
PSA2	(-20.0, -90)	(0, 360)
PNA	(20.0, 85)	(120, 240)
NPO	(20.0, 85)	(120, 240)
PDO	(20.0, 70)	(110, 260)
NPGO	(20.0, 70)	(110, 260)
AMO	(0.0, 70)	(-80, 0)

Monsoon Domains: These regions correspond to areas influenced by monsoon systems.

Region	Latitude Range	Longitude Range
AllMW	(-40.0, 45.0)	(0.0, 360.0)
NAMM	(0.0, 45.0)	(210.0, 310.0)
SAMM	(-45.0, 0.0)	(240.0, 330.0)
NAFM	(0.0, 45.0)	(-50.0, 60.0)
SAFM	(-45.0, 0.0)	(0.0, 90.0)
ASM	(0.0, 45.0)	(60.0, 180.0)
AUSM	(-45.0, 0.0)	(90.0, 160.0)
AIR	(7.0, 25.0)	(65.0, 85.0)
AUS	(-20.0, -10.0)	(120.0, 150.0)
Sahel	(13.0, 18.0)	(-10.0, 10.0)
GoG	(0.0, 5.0)	(-10.0, 10.0)
NAmo	(20.0, 37.0)	(-112.0, -103.0)
SAmo	(-20.0, 2.5)	(-65.0, -40.0)

land and ocean can be combined with other region. e.g., global_land, TROPICS_ocean.