Skip Navigation Links 
NOAA logo - Click to go to the NOAA home page National Weather Service   NWS logo - Click to go to the NWS home page
Climate Prediction Center

About Us
   Our Mission
   Who We Are

Contact Us
   CPC Information
   CPC Web Team

HOME > Monitoring_and_Data > Oceanic and Atmospheric Data > Reanalysis: Atmospheric Data > wgrib2 -scan

wgrib2: -scan


A grib message contains the grid point values. If you are a C programmer, the grid would naturally be in "C" order. A fortran programmer would have the grid in fortran order. Some people would start from the NW corner and others would start from the SW corner. In grib1, all these scan orders are possible. The grib1 scan orders are,

  1. WE:SN
  2. WE:NS
  3. EW:SN
  4. EW:NS
  5. SN:WE
  6. NS:WE
  7. SN:EW
  8. NS:EW
You read the above notation (WE:SN) by first go from W to E then go from S to N.
   do i = C to D
     do j = A to B
Grib2, includes the above 8 scan orders and adds 4 more useful scan orders.
  1. WE|EW:SN
  2. WE|EW:NS
  3. EW|WE:SN
  4. EW|WE:NS
   do i = C to D
     if (odd_row) {
       do j = A to B
     else {
       do j = B to A
     odd_row = not odd_row

This "plow the field" order reduces the file size when using regional grids and saving the increments.

Grib2 has 16 scan orders of which 3 are common: WE:SN, WE:NS and WE|EW:SN. Wgrib2 simplfies life by internally converting fields to WE:SN by default.




-$ wgrib2 ds_ens.grb -scan
1:0:scan=5 input=WE|EW:SN output=WE:SN
2:218709:scan=5 input=WE|EW:SN output=WE:SN
3:434276:scan=5 input=WE|EW:SN output=WE:SN
input=WE|EW:SN   the grib file is in WE|EW:SN scan order
output=WE:SN     the internal registers and output files except for grib
                 will be in WE:SN order, use the -order option to change
                 the output scan order
See also: -order,

NOAA/ National Weather Service
National Centers for Environmental Prediction
Climate Prediction Center
5830 University Research Court
College Park, Maryland 20740
Climate Prediction Center Web Team
Page last modified: May 15, 2005
Disclaimer Privacy Policy