Package: grib2io
grib2ioIntroductiongrib2io provides a Python interface to theNCEP GRIB2 C libraryfor reading and writing GRIB2 files.  The World Meteorological Organization (WMO)GRIddedBinary, Edition2(GRIB2) is a table-driven, binary data format designed for transmitting large volumes of gridded meteorological and atmospheric data.grib2io is the successor toncepgrib2whichwasa module withinpygrib.  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 ECMWFecCodeslibrary.  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 theNCEP GRIB2 Tableswhich are included in grib2io.  With thesetablesincluded and functions interact with them, grib2io provides a translation of GRIB2's integer coded metadata to human-readable language.DocumentationAPI documentationUser Guide Jupyter NotebookRequired SoftwarePython3.8+NCEPLIBS-g2c1.7.0+setuptools 34.0+NumPy 1.22+pyproj 1.9.6+C compiler: GNU, Intel, and Apple Clang have been tested.Optional Softwaregrib2io-interp1.0.0+ - Provides ability to perform spatial interpolation via theNCEPLIBS-ipNCEPLIBS Librariesg2cBeginning with grib2io v1.1.0, theNCEPLIBS-g2clibrary is no longer bundled with grib2io.  Instead, grib2io will link to an external installation of g2c, which as of v1.7.0, includes the ability to build shared-object library files.  Therefore, the previous "optional" compression software is no longer needed to build grib2io.  The caveat to this is you are at the mercy of how g2c was built.For macOS users, NCEPLIBS-g2c can be installed viathis Homebrew Tap.InstallOnce 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 variableG2C_DIRwith the installation path.FromPyPIvia pip:pip install grib2ioFrom conda-forge via conda:conda install -c conda-forge grib2ioFrom source:pipinstall.DevelopmentThe intention of grib2io is to become the offical Python interface for the NCEP g2c library.  Therefore, the development evolution of grib2io will mainly focus on how best to serve that purpose and its primary user's -- mainly meteorologist, physical scientists, and software developers supporting the missions within NOAA's National Weather Service (NWS) and National Centers for Environmental Prediction (NCEP).DisclaimerThis 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.