=== +-======-+ 
===  Copyright (c) 2003-2007 United States Government as represented by 
===  the Admistrator of the National Aeronautics and Space Administration.  
===  All Rights Reserved.
===  
===  THIS OPEN  SOURCE  AGREEMENT  ("AGREEMENT") DEFINES  THE  RIGHTS  OF USE,
===  REPRODUCTION,  DISTRIBUTION,  MODIFICATION AND REDISTRIBUTION OF CERTAIN 
===  COMPUTER SOFTWARE ORIGINALLY RELEASED BY THE UNITED STATES GOVERNMENT AS 
===  REPRESENTED BY THE GOVERNMENT AGENCY LISTED BELOW ("GOVERNMENT AGENCY").  
===  THE UNITED STATES GOVERNMENT, AS REPRESENTED BY GOVERNMENT AGENCY, IS AN 
===  INTENDED  THIRD-PARTY  BENEFICIARY  OF  ALL  SUBSEQUENT DISTRIBUTIONS OR 
===  REDISTRIBUTIONS  OF THE  SUBJECT  SOFTWARE.  ANYONE WHO USES, REPRODUCES, 
===  DISTRIBUTES, MODIFIES  OR REDISTRIBUTES THE SUBJECT SOFTWARE, AS DEFINED 
===  HEREIN, OR ANY PART THEREOF,  IS,  BY THAT ACTION, ACCEPTING IN FULL THE 
===  RESPONSIBILITIES AND OBLIGATIONS CONTAINED IN THIS AGREEMENT.
===  
===  Government Agency: National Aeronautics and Space Administration
===  Government Agency Original Software Designation: GSC-15354-1
===  Government Agency Original Software Title:  GEOS-5 GCM Modeling Software
===  User Registration Requested.  Please Visit http://opensource.gsfc.nasa.gov
===  Government Agency Point of Contact for Original Software:  
===  			Dale Hithon, SRA Assistant, (301) 286-2691
===  
=== +-======-+ 
                   Converting GEOS-2 prog.sig files to FVGCM

                             Arlindo da Silva

                             November 9, 1999


The utility geos2fv.x can be used to convert GEOS-2 prognostic fields
in sigma coordinates (prog.sig files) to FVGCM state variables
(restart, grads or GFIO formats). This version requires prog.sig
files in HDF written with GFIO. If you have an older prog.sig in PHOENIX
format you must convert this file to HDF with LATS4D; see below.


1) Configure and make

   ./configure
   make

2) Next, run geos2fv on a sample file:

   geos2fv.x -i b290_03_w98.pre-anal.sig.t19971221 -o test  19971221 0

   By default this will create a GFIO file named "test.nc"; 
   type "geos2fv.x" for additional options.



PHOENIX FILES:

If you have an older PHOENIX file, say 

     helios1:/u/almeida/scott/uth01/prog/dec1997/uth01.prog.sig.t19971221

then you must first create a ctl for it; just enter

     phx2ctl uth01.prog.sig.t19971221

Next, use lats4d to subset and convert this file to HDF:

   lats4d -v -i uth01.prog.sig.t19971221.ctl -o uth01.fg.t19971221 \
          -vars phis ps slp lwi uwnd vwnd tmpu sphu rh

This will create an HDF file named "uth01.fg.t19971221.nc"


NOTE: phx2ctl and lats4d is on /ford1/local.



Send algorithm related questions to SJ Lin (lin@dao); GFIO, lats4d and
other format related questions to Arlindo da Silva (dasilva@dao).

                       --- // ---