Extreme Weather Bench
Builds on the successful work of WeatherBench and introduces a set of high-impact weather events, spanning across multiple spatial and temporal scales and different parts of the weather spectrum.
https://github.com/brightbandtech/extremeweatherbench
Category: Atmosphere
Sub Category: Meteorological Observation and Forecast
Keywords
benchmarking meteorology
Last synced: about 11 hours ago
JSON representation
Repository metadata
Benchmarking of machine learning and numerical weather prediction (MLWP & NWP) models, with a focus on extreme events.
- Host: GitHub
- URL: https://github.com/brightbandtech/extremeweatherbench
- Owner: brightbandtech
- License: mit
- Created: 2024-08-15T15:33:50.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-05T18:06:52.000Z (about 1 month ago)
- Last Synced: 2026-06-05T08:03:11.879Z (6 days ago)
- Topics: benchmarking, meteorology
- Language: Python
- Homepage: https://extremeweatherbench.readthedocs.io/
- Size: 3.84 MB
- Stars: 121
- Watchers: 5
- Forks: 11
- Open Issues: 24
- Releases: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
README.md
Extreme Weather Bench (EWB)
Read our blog post here | Documentation
As AI weather models are growing in popularity, we need a standardized set of community driven tests that evaluate the models across a wide variety of high-impact hazards. Extreme Weather Bench (EWB) builds on the successful work of WeatherBench and introduces a set of high-impact weather events, spanning across multiple spatial and temporal scales and different parts of the weather spectrum. We provide data to use for testing, standard metrics for evaluation by forecasters worldwide for each of the phenomena, as well as impact-based metrics. EWB is a community system and will be adding additional phenomena, test cases and metrics in collaboration with the worldwide weather and forecast verification community.
Events
EWB has cases broken down by multiple event types within src/extremeweatherbench/data/events.yaml between 2020 and 2024. EWB case studies are documented here.
Available:
| Event Type | Number of Cases |
|---|---|
| 🌇 Heat Waves | 46 |
| 🧊 Freezes | 14 |
| 🌀 Tropical Cyclones | 98 |
| ☔️ Atmospheric Rivers | 56 |
| 🌪️ Severe Convection | 115 |
| Total Cases | 329 |
EWB paper and talks
How do I suggest new data, metrics, or otherwise get involved?
We welcome your involvement! The success of a benchmark suite rests on community involvement and feedback. There are several ways to get involved:
- Get involved in community discussion using the discussion board
- Submit new code requests using the issues
- Send us email at hello@brightband.com
Installing EWB
Currently, the easiest way to install EWB is using pip or uv:
$ pip install extremeweatherbench
# Or, add to an existing uv virtual environment
$ uv add extremeweatherbench
If you'd like to install the most recent updates to EWB:
$ pip install git+https://github.com/brightbandtech/ExtremeWeatherBench.git
For extra installation options:
# For running the data prep modules:
$ pip install "extremeweatherbench[data-prep]"
$ uv add "extremeweatherbench[data-prep]"
How to Run EWB
Running EWB on sample data (included) is straightforward.
Using Jupyter Notebook or a Script:
import extremeweatherbench as ewb
# Load in a forecast; here, we load in GFS initialized FCNv2 from the CIRA MLWP archive with a default variable built-in for convenience
fcnv2_heatwave_forecast = ewb.defaults.cira_fcnv2_heatwave_forecast
# Load in ERA5 with another default convenience variable
era5_heatwave_target = ewb.defaults.era5_heatwave_target
# EvaluationObjects are used to evaluate a single forecast source against a single target source with a defined event type. Event types are declared with each case. One or more metrics can be evaluated with each EvaluationObject.
heatwave_evaluation_list = [
ewb.inputs.EvaluationObject(
event_type="heat_wave",
metric_list=[
ewb.metrics.MaximumMeanAbsoluteError(),
ewb.metrics.RootMeanSquaredError(),
ewb.metrics.MaximumLowestMeanAbsoluteError(),
],
target=era5_heatwave_target,
forecast=fcnv2_heatwave_forecast,
),
]
# Load in the EWB default list of event cases
case_metadata = ewb.cases.load_ewb_events_yaml_into_case_list()
# Create the evaluation class, with cases and evaluation objects declared
ewb_instance = ewb.evaluation(
case_metadata=case_metadata,
evaluation_objects=heatwave_evaluation_list,
)
# Execute a parallel run and return the evaluation results as a pandas DataFrame
heatwave_outputs = ewb_instance.run_evaluation(
parallel_config={'n_jobs':16} # Uses 16 jobs with the loky backend as default
)
# Save the results
heatwave_outputs.to_csv('heatwave_evaluation_results.csv')
Using command line initialization:
$ ewb --default
Note: this will run every event type, case, target source, and metric for the individual event type as they become available for GFS initialized FourCastNetv2. It is expected a full evaluation will take some time, even on a large VM.
Owner metadata
- Name: Brightband
- Login: brightbandtech
- Email:
- Kind: organization
- Description: Brightband is making weather and climate predictable for all, to help humanity adapt to increasingly extreme weather.
- Website: brightband.com
- Location: United States of America
- Twitter: brightbandtech
- Company:
- Icon url: https://avatars.githubusercontent.com/u/159490539?v=4
- Repositories: 1
- Last ynced at: 2024-09-18T00:32:39.957Z
- Profile URL: https://github.com/brightbandtech
GitHub Events
Total
- Release event: 3
- Delete event: 162
- Pull request event: 201
- Fork event: 4
- Issues event: 87
- Watch event: 70
- Issue comment event: 109
- Public event: 1
- Push event: 1351
- Pull request review event: 146
- Pull request review comment event: 218
- Create event: 167
Last Year
- Release event: 2
- Delete event: 126
- Pull request event: 125
- Fork event: 1
- Issues event: 36
- Watch event: 24
- Issue comment event: 40
- Push event: 968
- Pull request review event: 78
- Pull request review comment event: 109
- Create event: 123
Committers metadata
Last synced: 4 days ago
Total Commits: 596
Total Committers: 4
Avg Commits per committer: 149.0
Development Distribution Score (DDS): 0.03
Commits in past year: 120
Committers in past year: 3
Avg Commits per committer in past year: 40.0
Development Distribution Score (DDS) in past year: 0.042
| Name | Commits | |
|---|---|---|
| aaTman | m****r@g****m | 578 |
| Amy McGovern | a****n@o****u | 12 |
| Daniel Rothenberg | d****l@d****m | 4 |
| Ummara Ali Syeda | 8****2 | 2 |
Committer domains:
- danielrothenberg.com: 1
- ou.edu: 1
Issue and Pull Request metadata
Last synced: 6 days ago
Total issues: 69
Total pull requests: 207
Average time to close issues: about 2 months
Average time to close pull requests: 4 days
Total issue authors: 5
Total pull request authors: 7
Average comments per issue: 1.09
Average comments per pull request: 0.5
Merged pull request: 144
Bot issues: 0
Bot pull requests: 0
Past year issues: 30
Past year pull requests: 124
Past year average time to close issues: 3 months
Past year average time to close pull requests: 3 days
Past year issue authors: 3
Past year pull request authors: 6
Past year average comments per issue: 1.17
Past year average comments per pull request: 0.29
Past year merged pull request: 77
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- aaTman (51)
- amymcgovern (9)
- darothen (5)
- hansmohrmann (2)
- alxmrs (2)
Top Pull Request Authors
- aaTman (188)
- amymcgovern (8)
- darothen (5)
- ummaraali2 (3)
- ehargitt (1)
- gideonite (1)
- rodrigoalmeida94 (1)
Top Issue Labels
- Improvement (7)
- bug (3)
- documentation (3)
- enhancement (3)
- Feature (2)
- good first issue (2)
- v1 (1)
Top Pull Request Labels
Package metadata
- Total packages: 3
-
Total downloads:
- pypi: 211 last-month
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 16
- Total maintainers: 1
proxy.golang.org: github.com/brightbandtech/extremeweatherbench
- Homepage:
- Documentation: https://pkg.go.dev/github.com/brightbandtech/extremeweatherbench#section-documentation
- Licenses: mit
- Latest release: v1.0.2 (published about 1 month ago)
- Last Synced: 2026-06-07T12:11:35.033Z (3 days ago)
- Versions: 6
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.401%
- Average: 5.583%
- Dependent repos count: 5.764%
proxy.golang.org: github.com/brightbandtech/ExtremeWeatherBench
- Homepage:
- Documentation: https://pkg.go.dev/github.com/brightbandtech/ExtremeWeatherBench#section-documentation
- Licenses: mit
- Latest release: v1.0.2 (published about 1 month ago)
- Last Synced: 2026-06-07T12:11:35.741Z (3 days ago)
- Versions: 6
- Dependent Packages: 0
- Dependent Repositories: 0
-
Rankings:
- Dependent packages count: 5.401%
- Average: 5.583%
- Dependent repos count: 5.764%
pypi.org: extremeweatherbench
Benchmarking weather and weather AI models using extreme events
- Homepage:
- Documentation: https://extremeweatherbench.readthedocs.io/
- Licenses: MIT License
- Latest release: 1.0.2 (published about 1 month ago)
- Last Synced: 2026-06-07T12:11:33.750Z (3 days ago)
- Versions: 4
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 211 Last month
-
Rankings:
- Dependent packages count: 7.872%
- Average: 26.189%
- Dependent repos count: 44.505%
- Maintainers (1)
Dependencies
- actions/checkout v4 composite
- actions/checkout v3 composite
- actions/setup-python v5 composite
- actions/setup-python v3 composite
- astral-sh/setup-uv v4 composite
- pre-commit/action v3.0.1 composite
- cartopy >=0.24.1
- cftime >=1.6.4.post1
- dacite >=1.8.1
- dask [complete]>=2024.12.1
- fastparquet >=2024.11.0
- gcsfs >=2024.12.0
- geopandas >=1.0.1
- h5py >=3.12.1
- ipywidgets >=8.1.5
- kerchunk >=0.2.7
- numpy >=2.2.0
- pandas >=2.2.3
- pyyaml >=6.0.2
- regionmask >=0.13.0
- rioxarray >=0.18.1
- s3fs >=2024.12.0
- scikit-learn >=1.6.0
- scores >=2.0.0
- seaborn >=0.13.2
- shapely >=2.0.6
- tqdm >=4.67.1
- ujson >=5.10.0
- virtualizarr >=1.2.0
- xarray >=2024.11.0
- zarr >=2.18.4
- 157 dependencies
Score: 11.719614378212476