GEMPAK Manual |
Programs
GDCFIL creates a GEMPAK grid file.
INPUT PARAMETERS
GDOUTF Output grid file
PROJ Map projection/angles/margins|drop flag
GRDAREA Area covered by grid
KXKY Number of grid points in x;y
MAXGRD Maximum number of grids
CPYFIL Grid file whose navigation is to be used in new grid file | subare
ANLYSS Grid analysis block
PROGRAM DESCRIPTION
This program creates a GEMPAK grid file. Information about
the file to be created is received from the input values,
from the grid navigation table, or from an existing grid file.
Each grid file must contain navigation information. It
may also contain analysis block information which is used
when an objective analysis program writes to the grid file.
If the value in CPYFIL begins with a #, the rest of the
string specifies a grid number or name contained in the
grid navigation table. Any other non-blank entry in CPYFIL
is taken as the name of an existing grid file, whose navigation
and analysis blocks will be copied to the new grid file.
If CPYFIL is blank, the navigation and analysis information
will be obtained from PROJ, GRDAREA, KXKY, and ANLYSS. KXKY
contains the number of points in the x and y directions.
The two integers must be separated with a semicolon. If
the grid projection type specified in PROJ is CED, the
grid spacing consisting of deltax and deltay may be entered
in KXKY by prefixing the numbers with a #. DELTAX and DELTAY
are in degrees longitude and degrees latitude, respectively.
The analysis information specifies DELTAN, which is the
station spacing, and the extend area separated by a slash.
The extend area is four integers separated by semicolons. If
ANLYSS is blank, default values will be assigned. If there
is no analysis block in the file to be copied, ANLYSS is
used to create one.
MAXGRD is the maximum number of grids which will be allowed
in the grid file.
EXAMPLES
1. Create a grid file called lfm.grd from the information in
the grid navigation table, allowing up to 1000 grids in the
file. PROJ, GRDAREA and KXKY are ignored since this
information will be obtained from the grid navigation
table.
GDOUTF = lfm.grd
PROJ =
GRDAREA =
KXKY =
MAXGRD = 1000
CPYFIL = #lfm
ANLYSS =
2. Create a grid file called sound.grd with a maximum of 15
grids. The grid dimensions are 20 by 30; the area
is US in a Mercator projection. The station
spacing is 5 degrees of latitude and the grid extension
for objective analysis is 3 grid points in each direction.
GDOUTF = sound.grd
PROJ = mer
GRDAREA = us
KXKY = 20;30
MAXGRD = 15
CPYFIL =
ANLYSS = 5/3;3;3;3
3. Create a file for evenly spaced lat/lon grids over area IL-
using a grid spacing of .75 degrees in each direction.
Compute reasonable values for the analysis block.
GDOUTF = il.grd
PROJ = ced
GRDAREA = il-
KXKY = #.75;.75
MAXGRD = 100
CPYFIL =
ANLYSS =
4. Create a grid file called new.grd from the information
within grid file old.grd.
GDOUTF = new.grd
PROJ =
GRDAREA =
KXKY =
MAXGRD = 100
CPYFIL = old.grd
ANLYSS =
ERROR MESSAGES
[GDCFIL +1] WARNING: This grid is too large for GEMPAK programs.
[GDCFIL -1] Fatal error initializing TAE.
[GDCFIL -2] Fatal error reading TAE parameters.
[GDCFIL -3] Fatal error initializing GEMPLT.
[GDCFIL -4] Navigation information is invalid.
[GDCFIL -5] Grid area ... is invalid.
[GDCFIL -6] Grid size is invalid.
[GDCFIL -7] The grid file name may not be blank.
[GDCFIL -8] Navigation table cannot be read.
[GDCFIL -9] Grid name ... cannot be found in grid table.
[GDCFIL -10] Extend region is invalid. Try 2;2;2;2.