wgrib2: wgrib for GRIB-2
Utility to read and write grib2 files
wgrib2 v3.1.3 has been released
Wgrib3 v3.1.3 includes the AEC and the OpenJPEG libraries by default. Of course,
the unfortunate people without a recent CMake can build wgrib2 without these libraries.
Wgrib2 is a processor for grib2 files. It is a utility
and library for manipulating grib files, The utility was designed to be
used to reduce the need for custom Fortran programs to
read, write and manipulate grib files.
Wgrib2 has the following abilities.
- inventory and read grib2 files
- create subsets
- create regional subsets by cookie cutter or projections
- export to ieee, text, binary, CSV, netcdf and mysql
- import to ieee, text, binary, and netcdf
- write of new grib2 fields
- parallel processing by using threads (OpenMP)
- parallel processing by flow-based programming
Wgrib2 is versatile because it's command line is a simple
language. This makes wgrib2 useful in embedding.
Some programs that embed wgrib2.
a control maker for GraADS
- atl_g2ctl, alt_gmp
alternative versions of g2ctl/gribmap for for
- grib-filter/g2subset cgi-bin programs for Nomads (NOAA OperationalModel Archive & Distribution System)
- g2grb.gs enables GrADS to write grib2 files
- grb1to2.pl grib1 to grib2 converter
- Xplane11 flight simulator
- rNOMADS R interface for NOAA weather data
OpenMP is used to speed up wgrib2 by running loops over
multiple cores. OpenMP is enabled by default for most builds
and you can slow up your machine if you the wrong OpenMP
The first configuration is to set up the number of
threads that wgrib2 will use. The default configuration
is set the number of threads equal to the number of
physical cores. The default is reasonable except for
when your computer becommes becomes
unresonsive. For a 4 core CPU, I set the number of threads
to be 3, so I another core to handle other work.
The next OpenMP configuration is how to handle unused threads (cores).
By setting OMP_WAIT_POLICY to PASSIVE,
unused cores are made availible to to work on other tasks.
Setting OMP_WAIT_POLICY to ACTIVE, will not share the cores.
In kindergarten, you learned the value of sharing.
4/14/2022: wgrib2 v3.1.1 is released
Changes for wgrib2 v3.1.1
- fixes check_pdt_len for some ECMWF and ICON files with vertial coordinates
- fixes -unix_time because of glibc
- more support for unix time: -set_date, -import_netcdf
- tested: gcc/gfortran on Ubuntu 20.04, Redhat 7
- tested: icc/ifort on Redhat 7
- tested: AOCC v3.2 (clang, flang) on Ubuntu 20.04
- minor tested: Windows 10 using cygwin64
- minor tested: gcc/gfortran on Ubuntu 18.04
- each option corresponds to a subroutine call
- type wgrib2 to see primary options
- inventory format is specified on command line by options
- if no "inv" option is specified, -s is used
Joining the development effort
- Source code: knowledge of C and some grib-2
- Changes to existing source code has to use the same licence as the original code
- New code (files) must either be GNU or public domain.
- Github? No.
- Bug reports are important
- Some inovations by first time contributors
- first implementation of lat-lon of common grids
- write netcdf files
- callable wgrib2 (making wgrib2 a subroutine)
- write to mysql files
- AEC compression
- python interface
- Contact firstname.lastname@example.org
- Wesley Ebisuzaki: many modules
- Reinoud Bokhorst: tosubmsg, checksum
- DWD (Gregor Schee, Daniel Lee and others): AEC compression
- Jaakko Hyvätti: gribtab
- John Howard: callable wgrib2
- Dusan Jovic: staggered grids, proj4 code
- Kristian Nilssen: netcdf module
- Karl Pfeiffer: georeferencing
- Pablo Romero: unix_time
- Manfred Schwarb: many modules
- Arlindo da Silva: openGrADS, bbox
- Niklas Sondell: mysql module
- Sam Trahan: satellite tables
- George Trojan: python interface, improvements to wgrib2api
- Sergey Varlamov: netcdf module improvements, georeferencing updates
- thanks to the people who report the bugs and more who provide the fixes!
Select/Ignore by name/level/time/etc
- -match process records that match a posix extended regular expression
- -not process records not matching a regular expression
- -match_inv the inventory used by -match and -not
- -i reads inventory from stdin for record selection
Select by number (better to use previous method)
- -d dump specific record
- -for select a range of records to process (nth message)
- -for_n select a range of records to process (nth message/submessage)
Selective Processing: if options
After selecting the fields to process, you can refine the processing by
the "if" options. With wgrib2 v3.0.0, the IF
structure was improved. Scripts that used the older IF structure still work;
however, the new IF structure is easier to read.
If possible, it is better to use the match options than the if options.
The -match/-not options prevent unwanted records from being processed which
saves time over the if options which process the fields.
Individual Grid Point Data
- -ij print value at grid point (i, j)
- -ijlat print lat, lon, value at grid point (i, j)
- -ilat print lat, lon, value of Nth grid point
- -lon prints the lat-lon, and value of the grid point nearest the specified lat-lon
- -max prints the maximum value
- -min prints the minimum value
- -stats prints some statistics about the fields
- -V verbose inventory (shows stats)
Regridding, Interpolating to new grids
Wgrib2 has the ability to convert grib files from one grid
to another. The conversion uses a user-selected interpolation
scheme: bilinear (default), bicubic, nearest neighbor, budget, and spectral.
The supported grids include lat-lon, gaussian, Lambert conformal, polar stereographic,
and WMO-defined rotated lat-lon grid. This capability uses the NCEP IPOLATES2 library
and is an optional package.
Note: the interpolation uses scalar and vector interpolation
schemes. For the vector quantities the V field must immediately
follow the corresponding U field.
Exporting data to other programs
For a short list of options, type "wgrib -h"
- -netcdf: write data in netcdf format
- -mysql: export data to a mysql database
- -mysql_speed: export data to a mysql database
- -spread: write data for spreadsheets
- -csv: write in column separated values, another one for spreadsheets
- -text: data in text format
- -bin: data native binary floating point
- -ieee: data in big endian IEEE format
- -ijbox: write a rectangular grid of data
- -AAIG: arcinfo ascii grid, GIS
For a complete list, type "wgrib -help all"
To search for an option, type "wgrib -help keyword"
Wgrib2 has adopted the template approach for writing grib. You
have a sample grib2 message (template), and you modify the grid point values
and metadata to create a new grib message that you can write.
This is similar to how ECMWF's ECCodes writes grib. The other approach
is to supply many parameters to create a grib message which is used
by NCEP's g2 library.
- from wgrib2 command line
- from GrADS using g2grb.gs
- fron python using write
- from fortran using grb2_write
Machines able to run wgrib2
64-bit with IPOLATES
The makefile works on Redhat and Ubuntu (with needed installed options).
For other systems, you may have to modify the makefile. The makefile
requires gnu make which is a common version of make.
- Redhat 7 Enterprise: gcc/gfortran (primary development system)
- Redhat 7 Enterprise: gcc/gfortran, icc/ifortran
- SUSE Enterprise: gcc/gfortran, icc/ifortran
- Ubuntu 20.04: gcc/gfortran (primary development system)
- Ubuntu 20.04: AOCC's clang and flang (development system) with OpenJPEG
- Ubuntu 20.04: nvidia with OpenJPEG
- ARM: needed to be compiled with USE_NETCDF4=1, USE_JASPER=0 (old report)
- Redhat linux: 32-bit with IPOLATES, not tested recently, use netcdf4 (old report)
- Mandriva linux (old report)
- AIX: use makefile, some fiddling with libraries is necessary, not tested recently
- Solaris, needs gnu make and gcc (old report)
- Solaris-10 (old report)
- HPUX, needs changes to makefiles (old report)
- Windows: using Cygwin system produces 32-bit binaries (old report)
- Windows: using Cygwin system produces 64-bit binaries
- Windows: compiled MingW (not recent), Watcom C, icc/ifort (old report)
- Windows/linux subsystem (ubuntu): compiled with gcc/gfortran (old report)
- Intel-based Mac using gcc and gfortran
System dependencies: 32 vs 64 bit, big vs little endian, Windows vs Linux/UNIX
The wgrib2 source code is written to be portable; there are no
issues with big vs little endian or the size of the integer as
long as it is 32 bits or more. The source code is written in
ANSI/ISO C (C89), with optional features that require
POSIX or POSIX-2. There has been a debate about
moving the base rquirements to C99.
- big vs little endian: either works
- 32-bit machine: files limited to 2GB files, netcdf3 may not work
- Windows: 2GB+ files with 64-bit cygwin, 2GB with other windows C compilers
- Windows: only 64-bit cygwin is supported
- POSIX: all POSIX code is optional. Regex support is POSIX and useful.
- JPEG2000: OpenJPEG library or Jasper library
Source Code and Compling Hints
The wgrib2 source code is written to the POSIX-2 standard. Features requiring
POSIX2, such as regular expressions, can usually be turned off
in the makefile. The wgrib2 code can be compiled with 32 or 64 bit pointers and integers.
However, the code has to be compiled in a like manner for all the libraries.
Some packages are optional (netcdf, mysql) and enabling these options can really
increase the executable size.
While compiling wgrib2, you may see warnings about unknown pragmas. Pragmas
are "comments" that are used when compiling an OpenMP version of the code. The
default is to compile with OpenMP turned on.
2/2019: The HDF5 library has problems being compiled with newer gcc compilers.
The only consisten method of adding NetCDF4 to wgrib2 is by using old compilers
(RedHat 6) or using the Intel compilers. The work around to enable NetCDF3 support
and use an external utility to convert the files to Netcdf4.
NetCDF3 has problem being compiled on 32-bit machines.
Precompiled code from External Sites
There are many sites with precompiled versions of wgrib2. This list
is neither exhaustive nor an endorsement of the sites. I have
not tested the wgrib2 executables from these sites and YMMV.
The wgrib2 is used operationally in the NCEP production suite.
Please report bugs to email@example.com. When you report bugs,
try to make them reproducible on a linux machine and include sample data.
The long time practice was not to port bug fixes to older versions of
wgrib2. As of June 23, 2023, the official policy is not to backport bug fixes
to older versions of wgrib2, especially versions that are over 4 year old,
and 5 public releases ago. As of June 23, 2023, a recent CMake is necessary
to compile some default library/libraries used by wgrib2. Wgrib2 can be
compiled without the libraries and avoiding the use of CMake.
The source code modules for wgrib2 are either in the public domain or under the GNU
licence depending on the authors of the various modules. Wgrib2 uses libraries that
are in the public domain, under various GNU licences, the Image Power JPEG-2000 Public Licence*,
libpng licence*, the zlib licence*, the netcdf licence*, HDF5 licence*, MySQL licence* and perhaps others. How
about one licence to rule them all?
* optional package