Gridpoint Statistical Interpolation (GSI) Code

Gridpoint Statistical Interpolation (GSI) Code

*** PLEASE CHECK FREQUENTLY FOR UPDATES ***

Please take a moment to read the Disclaimer for this non-operational web page.

Page last modified: 11/1/2006 6:38 AM

Introduction

This site contains the most recent development version of the NCEP unified gridpoint statistical interpolation (GSI) analysis code. For a history of changes, please view the change log. Questions that you have may have been addressed in the GSI FAQ.

Documentation

Wu et al. (MWR, 2002) provide an overview of the theory and development of the original GSI system. Additional GSI related literature and presentations are found in the documents folder.

Training

· 1^st GSI User Orientation (4-5 January 2005)

Downloads

When downloading a copy of the GSI code, please send us an email stating so. We periodically send email to users on the GSI distribution list informing them of code upgrades and other pertinent GSI information. Please include the following information in your email:

· your name and title

· group you are affiliated with

· phone number at which we can reach you

· date you downloaded the code along with CVS tag

The GSI tarball contains a directory named CVS

Within directory CVS is a file named Tag.

View the contents of file Tag to get the CVS tag.

· short statement explaining why you downloaded the code and how you intend to use it.

Please send the above information to us in order to get on the GSI distribution list. Those who download the code without notifying us should expect no response to their inquiries.

As a professional courtesy we request that you do not distribute copies of the GSI code to third parties. Rather, please direct interested parties to this web site.

Support

This code is made available to the public on an "AS-IS" basis. The GSI remains a developmental, not-yet operational system. As such, the code can and has changed quickly (though the trend is for fewer and smaller changes). Pervious versions obtained through this site are not supported. In fact, no provision exists to support external users in the absence of collaborative working agreements with NCEP/EMC. Users should expect no support beyond that which is available from existing sources (NCEP web sites, reports, conference proceedings, papers, etc.).

GSI Source code

A web-viewable version of the most recent GSI release is available by clicking here. The f90tohtml utility is used to generate the GSI web code. The web-viewable code is constructed from the source code found in the most recent GSI tarball.

As the GSI code becomes more widely distributed and users suggest/submit code changes, the need for coding standards and management policy grows more critical. To view current GSI coding standards please click here. To view the current policy for evaluating / accepting / rejecting submitted changes to the GSI code, please click here.

GSI Tarballs

Below are links to the GSI code, supporting libraries, and fixed GSI input files. There is no guarantee that the GSI code or supporting GSI libraries will work on any system other than the NCEP CCS. The fixed files are either ASCII format files or IEEE binary files created for use on the NCEP CCS.

Tarball	Contents
GSI tarball	GSI source code, makefiles, and sample scripts to run code
bufrlib tarball	Source code for NCEP BUFR library
crtm tarball	Source code for JCSDA community radiative transfer model
splib tarball	Source code for NCEP spectral « grid transforms
bacio tarball	Source code for NCEP byte-addressable i/o module
sfcio tarball	Source code for NCEP GFS surface file i/o module
sigio tarball	Source code for NCEP GFS atmospheric file i/o module
w3lib tarball	Source code for NCEP W3 library (date/time manipulation, GRIB)
fix tarball	Fix input files required by GSI

util tarball	Source code for utilities used by GSI scripts, file conversions, etc
bkgecov tarball	Source code for global GSI background error statistics calculation

Additional Source code and Documentation

NCEP Central Operations (NCO) provides access to copies of NCEP operational codes, libraries, and other files through NCO’s Production Management Branch (PMB) home page. To view what codes are available, go to PMB’s home page and click on the Codes link. Limited documentation is available through the Documentation link found on PMB’s home page. Source code along with documentation for NCEP’s BUFR library is available on the Decoders page found on NCO’s Systems Integration Branch home page (click on the Decoders link).

Please note the following:

1) Questions related to or problems with links and / or the availability of codes, libraries, or fix files from the NCO web site should be directed to the Web Master for NCO’s site.

2) Source code for bufrlib, splib, and w3lib obtained from the NCO web site may not be as recent (up to date) as versions available through the GSI web site. Users are encouraged to start first with the GSI copies of these libraries (see table above).

Test Cases

Access restrictions placed on certain data sets preclude us from posting input/output from GSI runs using operational NCEP data sets. The global and regional GSI test cases below use NCEP data sets with the restricted data removed. The global and regional test cases use the GSI code in the GSI tarball above.

Mode	Date	Run script	Input	Output
Global	2004092100	rungsi_global.sh , global_chgres.sh	input.tar	output.tar
Regional NMM (binary)	2004090712	rungsi_regional_nmm_binary.sh	input.tar	output.tar
Regional NMM (netcdf)	2004090712	rungsi_regional_nmm_netcdf.sh	input.tar	output.tar
Regional Mass core (binary)	2004090706	rungsi_regional_mass_binary.sh	input.tar	output.tar
Regional Mass core (netcdf)	2004072712	rungsi_regional_mass_netcdf.sh	input.tar	output.tar

Test case files are also accessible via anonymous ftp. To get the files in this manner,

1) ftp ftp.emc.ncep.noaa.gov

2) log on as anonymous. Use your email address as the password.

3) cd /gmb/wd20rt/gsi/cases/globalor /gmb/wd20rt/gsi/cases/regional

Archive

The above GSI and fix tarballs contain the most recent GSI code. As updates are made to the code and/or fixed files, copies of previous versions are added to an archive folder on this site. Each tarball contains the GSI source code, makefiles, sample scripts, plus the corresponding fix files. Previous versions will be deleted, starting from the oldest, as space constraints dictate. The change log file to which the code corresponds is part of the tarball name. Please note: No support is provided for previous GSI versions.