Herbie

A python package that downloads recent and archived numerical weather prediction model output from different cloud archive sources.
https://github.com/blaylockbk/Herbie

Category: Atmosphere
Sub Category: Meteorological Observation and Forecast

Keywords

big-data-program cfgrib download ecmwf-data gfs grib grib2 hrrr noaa-data nomads numerical-weather-prediction open-data python rap xarray

Keywords from Contributors

weather charts simulations share observational polars synoptic-api mesowest mesonet streams

Last synced: about 13 hours ago
JSON representation

Repository metadata

Download numerical weather prediction datasets (HRRR, RAP, GFS, IFS, etc.) from NOMADS, NODD partners (Amazon, Google, Microsoft), ECMWF open data, and the University of Utah Pando Archive System.

• Host: GitHub
• URL: https://github.com/blaylockbk/Herbie
• Owner: blaylockbk
• License: mit
• Created: 2020-06-26T17:43:11.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2025-04-17T04:17:49.000Z (10 days ago)
• Last Synced: 2025-04-20T10:41:45.216Z (7 days ago)
• Topics: big-data-program, cfgrib, download, ecmwf-data, gfs, grib, grib2, hrrr, noaa-data, nomads, numerical-weather-prediction, open-data, python, rap, xarray
• Language: Python
• Homepage: https://herbie.readthedocs.io/
• Size: 172 MB
• Stars: 579
• Watchers: 16
• Forks: 87
• Open Issues: 78
• Releases: 24
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Citation: CITATION.cff

README.md

conda install -c conda-forge herbie-data

# Download environment file
wget https://github.com/blaylockbk/Herbie/raw/main/environment.yml

# Modify that file if you wish.

# Create the environment
conda env create -f environment.yml

# Activate the environment
conda activate herbie

# Latest published version
pip install herbie-data

# ~~ or ~~

# Most recent changes
pip install git+https://github.com/blaylockbk/Herbie.git

# Dependecies for extra features
pip install herbie-data[extra]

uv add herbie-data

  graph TD;
      d1[(HRRR)] -..-> H
      d2[(RAP)] -.-> H
      d3[(GFS)] -..-> H
      d33[(GEFS)] -.-> H
      d4[(IFS)] -..-> H
      d44[(AIFS)] -..-> H
      d5[(NBM)] -.-> H
      d6[(RRFS)] -..-> H
      d7[(RTMA)] -.-> H
      d8[(URMA)] -..-> H
      H((Herbie))
      H --- .inventory
      H --- .download
      H --- .xarray

      style H fill:#d8c89d,stroke:#0c3576,stroke-width:4px,color:#000000

from herbie import Herbie

# Herbie object for the HRRR model 6-hr surface forecast product
H = Herbie(
  '2021-01-01 12:00',
  model='hrrr',
  product='sfc',
  fxx=6
)

# Look at file contents
H.inventory()

# Download the full GRIB2 file
H.download()

# Download a subset, like all fields at 500 mb
H.download(":500 mb")

# Read subset with xarray, like 2-m temperature.
H.xarray("TMP:2 m")

Citation (CITATION.cff)

cff-version: 1.2.0
abstract: Herbie is a python package that downloads recent and archived numerical weather prediction (NWP) model output from different cloud archive sources. Its most popular capability is to download HRRR model data. NWP data in GRIB2 format can be read into an xarray dataframe using the cfgrib package. Much of this data is made available through the NOAA Open Data Dissemination (NODD) Program (formerly the Big Data Program) which has made weather data more accessible than ever before.
message: "If you use this software, please cite it as below."
authors:
  - family-names: Blaylock
    given-names: Brian K.
    email: [email protected]
    orcid: "https://orcid.org/0000-0003-2133-9313"
title: "Herbie: Retrieve Numerical Weather Prediction Model Data"
version: 2024.5.0
date-released: "2023-03-02"
url: "https://herbie.readthedocs.io/"
repository-code: "https://github.com/blaylockbk/Herbie"
type: software
keywords:
  - meteorology
  - weather
  - numerical weather prediction
  - forecast
  - atmosphere
license: "MIT"
identifiers:
  - type: doi
    value: 10.5281/zenodo.4567540

Owner metadata

• Name: Brian Blaylock
• Login: blaylockbk
• Email:
• Kind: user
• Description: Meteorologist
• Website: http://home.chpc.utah.edu/~u0553130/Brian_Blaylock/home.html
• Location: Monterey, CA
• Twitter: blaylockbk
• Company:
• Icon url: https://avatars.githubusercontent.com/u/6249613?u=83e593317387e0cfacc6d86df40f6d2ee2f13676&v=4
• Repositories: 45
• Last ynced at: 2024-03-15T18:11:46.924Z
• Profile URL: https://github.com/blaylockbk

GitHub Events

Total

• Create event: 16
• Release event: 4
• Issues event: 35
• Watch event: 94
• Delete event: 4
• Issue comment event: 81
• Push event: 92
• Pull request review comment event: 3
• Pull request review event: 5
• Pull request event: 24
• Fork event: 15

Last Year

• Create event: 16
• Release event: 4
• Issues event: 35
• Watch event: 94
• Delete event: 4
• Issue comment event: 81
• Push event: 92
• Pull request review comment event: 3
• Pull request review event: 5
• Pull request event: 24
• Fork event: 15

Committers metadata

Last synced: 4 days ago

Committer domains:

• inria.fr: 1
• aerology.ai: 1
• wayne.edu: 1
• gitter.im: 1
• illinois.edu: 1
• alexanderrey.ca: 1
• jether-energy.com: 1
• oceanum.science: 1
• psu.edu: 1
• nrlmry.navy.mil: 1
• panodata.org: 1
• actimar.fr: 1

Issue and Pull Request metadata

Last synced: 1 day ago

Package metadata

• Total packages: 3
• Total downloads:
  • pypi: 56,966 last-month
• Total dependent packages: 3 (may contain duplicates)
• Total dependent repositories: 3 (may contain duplicates)
• Total versions: 28
• Total maintainers: 1

Dependencies

Score: 20.656892593735165