Skip navigation
NASA Logo, National Aeronautics and Space Administration
Currently Being Moderated

Running fvsetup

VERSION 6  Click to view document history
Created on: Jul 22, 2010 10:55 AM by Carlos Cruz - Last Modified:  Jul 22, 2010 12:25 PM by Carlos Cruz

Before setting up a DAS experiment you need to check out and build the DAS. Here we assume that you are setting up your experiment on DISCOVER.


cvs co -r GEOSadas-5_5_2 GEOSadas
cd GEOSadas/src
source g5_modules
make install
cd ../Linux/bin <<< this is $FVROOT (see below)



Some definitions before continuing:


  • TAGS:

Official tags: GEOSadas-X_Y_Z, e.g., GEOSadas-5_5_2
Note: UNSTABLE tags are not to be used
Tags vs Modules: many times the prefix of a tag refers to the CVS module name, e.g., the GCM Fortuna-1_5 can be checked out using the Module name Fortuna


  • Restarts: files required to run the DAS (initial conditions)
  • Job segment: the complete cycle of the submission of one DAS batch job. By default this is one full day of assimilation.
  • Work directory: directory manipulated by batch job, typically named, fvwork.$$, where $$ is a shell generated random number.
  • $FVHOME: location of DAS experiment settings
  • $FVROOT: location of DAS bin directory
  • Resource file: *.rc text files that contain parameter information passed to executables
  • Template files: *.tmpl files contain variables that are changed on the fly by the main DAS driver script, GEOSdas.csm
  • acq files: *.acq are acquire procedures to get data from mass storage
  • Filename templates: e.g. for grads: %s.ana.eta.%y4%m2%d2_%h2z.nc4
  • Assimilated fields: *.ana files
  • Background fields: *.bkg files


Experiment setup procedure


  • To prepare an environment to run GEOSdas experiments requires running fvsetup, residing in $FVROOT
  • fvsetup is a perl script (about ≈ 7700 lines)
  • fvsetup will not (generally) setup all your needs for a particular DAS experiment. Additional tweaks may be needed after the setup completes.


The following are snapshots from an fvsetup session. For the GEOSdas tag checked out above no post-setup edits are necessary, that is the setup will produce an experiment setup that will run as configured.


A typical fvsetup session


Once you are done you will need to go to $FVHOME and submit you DAS job script. Note that there will be several directories under $FVHOME:




Directories in red are stored in archiving system (of course they will be found under you username).


Running forecasts from DAS output.


There are two ways to do it:


  • As extensions to the background integration while the DAS is running

          Requires storing fewer restarts but slows down DAS
          In practice one needs to edit a handful files.

  • After the fact, from restarts stored during the DAS run

          Allows running forecasts started at different times concurrently, requires more restarts to be stored


Running standalone analysis.


  • Relevant directory: $FVHOME/anasa
  • Relevant script: g5anasa.j
  • Relevant resource file: $FVHOME/run/gsi.rc.tmpl

          cp $FVHOME/run/gsi.rc.tmpl $FVHOME/run/gsisa.rc.tmpl
          Submit g5anasa.j job script


General tips.


  • Choose low resolution case
  • Choose small observing system
  • Be mindful of HISTORY output. If you are not going to look at it don't output it!. It saves time and space.
  • The following hidden files specify where the various applications are running:

          The DAS: $FVHOME/.FVWORK
          Forecast: $FVHOME/.FVFCST
          Stand-alone analysis: $FVHOME/.ANASA
          Installation: $FVHOME/.FVROOT

Comments (0)
USAGov logo NASA Logo -