{"id":19570383,"url":"https://github.com/noaa-mdl/grib2io","last_synced_at":"2025-04-06T05:16:08.160Z","repository":{"id":39908711,"uuid":"188070893","full_name":"NOAA-MDL/grib2io","owner":"NOAA-MDL","description":"Python interface to the NCEP G2C Library for reading and writing GRIB2 messages. ","archived":false,"fork":false,"pushed_at":"2025-03-28T18:58:01.000Z","size":156751,"stargazers_count":32,"open_issues_count":3,"forks_count":13,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-30T04:08:41.510Z","etag":null,"topics":["atmospheric-science","data-science","grib2","grib2-decoder","grib2-encoder","grib2-tables","meteorology","ncep","ncep-grib2","ndfd-grib2","numpy","python","python3","weather","weather-data"],"latest_commit_sha":null,"homepage":"https://noaa-mdl.github.io/grib2io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NOAA-MDL.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-22T15:57:21.000Z","updated_at":"2025-03-03T15:29:29.000Z","dependencies_parsed_at":"2023-09-24T04:32:38.305Z","dependency_job_id":"76b68853-6ba1-47c0-afb5-6927a0eb3e06","html_url":"https://github.com/NOAA-MDL/grib2io","commit_stats":{"total_commits":1514,"total_committers":35,"mean_commits":43.25714285714286,"dds":0.5614266842800528,"last_synced_commit":"19c6e01baf844e845cd87f3add17ec719e0681c7"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-MDL%2Fgrib2io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-MDL%2Fgrib2io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-MDL%2Fgrib2io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NOAA-MDL%2Fgrib2io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NOAA-MDL","download_url":"https://codeload.github.com/NOAA-MDL/grib2io/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247436285,"owners_count":20938533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atmospheric-science","data-science","grib2","grib2-decoder","grib2-encoder","grib2-tables","meteorology","ncep","ncep-grib2","ndfd-grib2","numpy","python","python3","weather","weather-data"],"created_at":"2024-11-11T06:14:53.772Z","updated_at":"2025-04-06T05:16:07.965Z","avatar_url":"https://github.com/NOAA-MDL.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# grib2io\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[![Python 3.8](https://img.shields.io/badge/python-3.8-blue.svg)](https://www.python.org/downloads/release/python-380/)\n[![Python 3.9](https://img.shields.io/badge/python-3.9-blue.svg)](https://www.python.org/downloads/release/python-390/)\n[![Python 3.10](https://img.shields.io/badge/python-3.10-blue.svg)](https://www.python.org/downloads/release/python-3100/)\n[![Python 3.11](https://img.shields.io/badge/python-3.11-blue.svg)](https://www.python.org/downloads/release/python-3110/)\n[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://www.python.org/downloads/release/python-3120/)\n[![Python 3.13](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/downloads/release/python-3130/)\n\n![Build Linux](https://github.com/NOAA-MDL/grib2io/actions/workflows/build_linux.yml/badge.svg)\n![Build macOS](https://github.com/NOAA-MDL/grib2io/actions/workflows/build_macos.yml/badge.svg)\n\n![PyPI](https://img.shields.io/pypi/v/grib2io?label=pypi%20package)\n![PyPI - Downloads](https://img.shields.io/pypi/dm/grib2io)\n\n[![Anaconda-Server Badge](https://anaconda.org/conda-forge/grib2io/badges/version.svg)](https://anaconda.org/conda-forge/grib2io)\n[![Anaconda-Server Badge](https://anaconda.org/conda-forge/grib2io/badges/platforms.svg)](https://anaconda.org/conda-forge/grib2io)\n[![Anaconda-Server Badge](https://anaconda.org/conda-forge/grib2io/badges/downloads.svg)](https://anaconda.org/conda-forge/grib2io)\n\n[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/NOAA-MDL/grib2io/HEAD)\n\n## Introduction\n\ngrib2io provides a Python interface to the [NCEP GRIB2 C library](https://github.com/NOAA-EMC/NCEPLIBS-g2c) for reading and writing GRIB2 files.  The World Meteorological Organization ([WMO](https://www.wmo.int)) **GRI**dded **B**inary, Edition **2** ([GRIB2](https://www.wmo.int/pages/prog/www/WMOCodes/Guides/GRIB/GRIB2_062006.pdf)) is a table-driven, binary data format designed for transmitting large volumes of gridded meteorological and atmospheric data.\n\ngrib2io is the successor to [ncepgrib2](https://github.com/jswhit/ncepgrib2) which **_was_** a module within [pygrib](https://github.com/jswhit/pygrib).  As of pygrib v2.1, development of ncepgrib2 was dropped in favor of continued development of the pygrib module which provides an interface to the ECMWF [ecCodes](https://github.com/ecmwf/eccodes) library.  grib2io aims to provide a fast, efficient, and easy-to-use interface to the NCEP g2c library.  One way to accomplish this is to leverage the [NCEP GRIB2 Tables](https://www.nco.ncep.noaa.gov/pmb/docs/grib2/grib2_doc/) which are included in grib2io.  With these [tables](./grib2io/tables) included and functions interact with them, grib2io provides a translation of GRIB2's integer coded metadata to human-readable language.\n\nOptionally (but recommended), grib2io supports spatial interpolation via its internal Cython extension module, `iplib`, which provides an interface to the Fortran-based [NCEPLIBS-ip](https://github.com/NOAA-EMC/NCEPLIBS-ip).  Grid to grid and grid to station points are supported with OpenMP threading, provided that NCEPLIBS-ip was built with OpenMP support.\n\n\u003e [!IMPORTANT]\n\u003e **Beginning with grib2io v2.4.0, grib2io-interp component package is no longer supported.  Interpolation support is available in grib2io via Cython interface to [NCEPLIBS-ip](https://github.com/NOAA-EMC/NCEPLIBS-ip).**\n\n## Documentation\n* [API documentation](https://noaa-mdl.github.io/grib2io/grib2io.html)\n* [User Guide Jupyter Notebook](https://github.com/NOAA-MDL/grib2io/blob/master/demos/grib2io-v2.ipynb)\n\n## Required Software\n* [Python](https://python.org) 3.8, 3.9, 3.10, 3.11, 3.12, 3.13\n* [NCEPLIBS-g2c](https://github.com/NOAA-EMC/NCEPLIBS-g2c) 1.7.0+\n* setuptools 34.0+\n* NumPy 1.22+\n* pyproj 1.9.6+\n* C compiler: GNU, Intel, and Apple Clang have been tested.\n\n## Required External Libraries\n\n### NCEPLIBS-g2c\nThe [NCEPLIBS-g2c](https://github.com/NOAA-EMC/NCEPLIBS-g2c) library is required for grib2io.  You will have to build and install this yourself, but this is not difficult.  For macOS users, NCEPLIBS-g2c can be installed via [this Homebrew Tap](https://github.com/eengl/homebrew-nceplibs).  If you use the Anaconda ecosystem, then you can install via `conda install -c conda-forge nceplibs-g2c`.\n\n## Optional External Libraries\n\n### NCEPLIBS-ip (v5.0.0 or newer)\nThe [NCEPLIBS-ip](https://github.com/NOAA-EMC/NCEPLIBS-ip) Fortran library provides interpolation support.  You will have to build and install this yourself, but this is not difficult.  For macOS users, NCEPLIBS-ip can be installed via [this Homebrew Tap](https://github.com/eengl/homebrew-nceplibs).  If you use the Anaconda ecosystem, then you can install via `conda install -c conda-forge nceplibs-ip`.\n\n## Install\n\nOnce again, this assumes that NCEPLIBS-g2c has been installed.  If NCEPLIBS-g2c has been installed into a \"common\" installation path, then it will be found, otherwise define environment variable `G2C_DIR` with the installation path.\n\n* From [PyPI](https://pypi.python.org/pypi/grib2io) via pip:\n\n```\npip install grib2io\n```\n* From [conda-forge](https://anaconda.org/conda-forge/grib2io) via conda:\n\n```\nconda install -c conda-forge grib2io\n```\n\n* From source:\n```shell\npip install .\n```\n\n\u003e [!NOTE]\n\u003e ### Building with static libraries\n\u003e Beginning with grib2io v2.4.0, the process to build with static libs as changed.  The environment variable, `USE_STATIC_LIBS` has been removed and replaced with library-specific env vars, `G2C_STATIC` and `IP_STATIC` with acceptable values of `True` or `False`.  The default value is `False` (i.e. build with shared libs).\n\u003e \n\u003e```shell\n\u003eexport G2C_STATIC=True\n\u003eexport IP_STATIC=True\n\u003epip install .\n\u003e```\n\n## Development\n\ngrib2io is the de facto Python interface to the NCEPLIBS-g2c library. Therefore, its development and evolution will primarily focus on serving that purpose and supporting its core users—mainly meteorologists, physical scientists, and software developers working within NOAA’s National Weather Service (NWS), the National Centers for Environmental Prediction (NCEP), and other NOAA and U.S. Government organizations.\n\n## Disclaimer\n\nThis repository is a scientific product and is not official communication of the National Oceanic and Atmospheric Administration, or the United States Department of Commerce. All NOAA GitHub project code is provided on an 'as is' basis and the user assumes responsibility for its use. Any claims against the Department of Commerce or Department of Commerce bureaus stemming from the use of this GitHub project will be governed by all applicable Federal law. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by the Department of Commerce. The Department of Commerce seal and logo, or the seal and logo of a DOC bureau, shall not be used in any manner to imply endorsement of any commercial product or activity by DOC or the United States Government.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoaa-mdl%2Fgrib2io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoaa-mdl%2Fgrib2io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoaa-mdl%2Fgrib2io/lists"}