MakeD2DFile User's Guide

August 23, 2005

Table of Contents

Overview

Running makeD2DFile From the GFE

Running makeD2Dfile From the Command Line


Overview

The makeD2DFile utility allows a local forecast office to create a netCDF file containing IFP forecast grids that can be read by an AWIPS (D2D) display system.  The program reads the gridded forecast data from the Official database, formats the data into a format compatible with the AWIPS display system, and writes the file to a directory known to the D2D system.

The makeD2DFile program is limited in several ways.  Currently the program will store only a subset of the GFE weather elements.  The set of weather elements that can be stored is limited to T (temperature), Td (dew point), RH (relative humidity), MinT (minimum temperature), MaxT (maximum temperature), QPF (quantitative precipitation forecast), and PoP (probability of precipitation).  Note that at this point the program will not store vector data such as wind or discrete data such as Wx.

While the time period over which the grids are stored can be controlled with the "s" and "e" switches, the programs is hard-coded to store grids every hour between the to indicated times.  There is currently no provision to store grids at different time intervals (for example, hourly grids to 24 hours, then 3 hourly out to 48).

All grids are converted to MKS units before they are stored in order to match the convention of other D2D gridded files.



Running makeD2DFile From the GFE

To run the makeD2DFile program from the GFE, perform the following steps...

  1.    From the GFE's Main Menu bar, Select Products->Scripts...
  2.    When the Scrips dialog appears, select MakeD2DFile and click Run and Dismiss.

The makeD2DFile program reads data from the ifpServer, formats the data so that it is compatible with D2D, and writes the file to a special D2D directory reserved for GFE.  When the program finishes you can view the data in D2D via the Volume Browser.  To view these grids you must first select the State(s) or WFO scale on the D2D scale selector.  Then in the D2D Volume Browser, select GFE for the model, select the weather elements you wish to view, and Surface as the level (if it's not selected for you already).  When you select "Load" the elements will be loaded in D2D just like any other model.  Other data may be overlaid on top of the GFE grids whose time matches that of the grid.


Running the makeD2DFile Program From the Command Line


The makeD2DFile can be run from the command line as well.  If you choose to run the program this way, keep in mind that the data will not display in D2D if you specify a different output directory than the default )see sample below for default directory.  It is for this reason that we do not recommend that you use this option.

A sample command line to make a displayable D2D file is:

makeD2DFile -h GFEHost -r 98000000 -o /data/fxa/Grid/SBN/netCDF/local/GFE/20050708_1200

Each option is listed below along with a description.

 
Option Syntax Optional or Mandatory Description
-h hostname Optional
Specifies the host, upon which the ifpServer is running. Defaults to "localhost"
-r port Optional
Specifies the port, upon which the ifpServer is running.  Defaults to the configured port number, usually 98000000
-o output directory and filename Optional Indicates the directory and filename of the D2D file. Note: if this is changed from the default (see sample above) th
-d database id
Optional
Indicates the name of the database from which the data will be retreived and formatted. Defaults to Fcst database
-p parmName
Optional
Indicates the name(s) of the paramters to be stored.  No -p option will store all elligible weather elements
-s startTime (yyyymmdd_hhmm)
Optional
Indicates the beginning time for the data to be stored.  No -s option will store starting with the current time.
-e endTime (yyyymmdd_hhmm)
Optional
Indicates the ending time for the data to be stored.  No -e option will store ending at 24 hours past the current time.
-m mask
Optional
Indicates the mask or edit area over which the data will be stored.  If no mask is specified, the entire grid will be stored, otherwise the data will be clipped to the mask area.  The mask is the name of a GFE edit area.
-g [no argument]
Optional
If present the program will also store the local GFE topography data set.