GRDINFO

Lists, modifies, or statistically analyzes grid point values.


Formats

GRDINFO sdataset EDIT ddataset [keywords]
GRDINFO sdataset HIST [keywords]
GRDINFO sdataset LIST [keywords]
GRDINFO sdataset STAT [keywords]


Parameters

sdataset

source ADDE dataset name and absolute position; specify one of the following formats:

 

 

group/descriptor.position

alias.position

 

use only positive integers or ALL (all positions) for position (no default for group/descriptor or alias; default=ALL for position)

EDIT

modifies grid point values and copies the new grid to ddataset

HIST

displays histogram for grid point values

LIST

lists grid point values

STAT

displays statistical analysis for grid point values; statistics include the minimum and maximum values, mean, and standard deviation (default)

ddataset

destination ADDE dataset name and absolute position; specify one of the following formats:

 

 

group/descriptor.position

alias.position

 

use only positive integers for position


Search Keywords

DAY=

d1 . . dn

selects grids with the specified days

DRAnge=

bday eday inc

selects grids in the range of days bday through eday, incremented by inc days (no default for bday; eday default=bday; inc default=1)

ENSemble=

e1 . . en

selects grids with the specified ensemble numbers; each ensemble number must include a + or - sign, e.g., -1 -0 +0 +1

FDAy=

selects grids with the specified forecast day; a grid's forecast day is determined by adding the forecast hour to the day and time; for example, a 12 UTC grid from day 2000100 with a forecast hour of 72 has a forecast day of 2000103; you cannot use FDAY with the FHOUR, FRANGE or MATH keyword

FHOur=

h1 . . hn

selects grids with the specified forecast hours; you cannot use FHOUR with the FRANGE, FDAY or FTIME keyword

FRANGe=

bhr ehr inc

selects grids in the range of forecast hours bhr through ehr, incremented by inc hours; you cannot use FRANGE with the FHOUR, FDAY or FTIME keyword (no default for bhr; ehr default=bhr; inc default=1)

FTIme=

selects grids with the specified forecast time; a grid's forecast time is determined by adding the forecast hour to the time; for example, a 12 UTC grid with a forecast hour of 18 has a forecast time of 6 on the following day; you cannot use FTIME with the FHOUR, FRANGE or MATH keyword

GPRo=

g1 . . gn

selects grids with the specified projection, for example, MERC, PS, LAMB, EQUI

GRIB=

geo par model level

selects grids with the specified GRIB codes; the four values are the geographic, parameter, model and level codes that can be listed with GRDLIST FORM=ALL; values specified as an X (a placeholder) or not specified at all will match any GRIB code

GRId=

bgrid egrid

selects grids bgrid through egrid in the grid file specified in the dataset parameter; enter a grid number or LAST (last grid) for bgrid and egrid; see the Remarks (no default for bgrid; egrid default=bgrid)

LEV=

l1[u1] . . ln[un]

selects grids with the specified levels and units, e.g., SFC, 850[MB], 5000[M]; units are optional but must be in square brackets if specified

PARam=

p1 . . pn

selects grids with the specified parameters, for example, T, Z, RH; do not use with the DERIVE keyword; see the Remarks

SRC=

s1 . . sn

selects grids with the specified sources, for example, MDX, GFS, ETA

TIMe=

t1 . . tn

selects grids with the specified times

TRAnge=

btim etim inc

selects grids in the range of times btim through etim, incremented by inc (no default for btim; etim default=btim; inc default=1, meaning one hour)


Derived Grid Keywords

DERive=

selects the component grids needed to derive a grid with the specified parameter, for example, DST or VOR; the grid listed with the HIST, LIST, or STAT parameters does not exist, but the components needed to derive such a grid do; do not use with the PARAM keyword; see the Remarks

MERidional=

YES

adds a correction term to account for the convergence of longitude lines at the poles

 

NO

does not add a correction term; only valid with DERIVE=ABV, DSH, DST, DVG, or VOR; see the Remarks (default)

PLAnet=

planet for which derive calculations are done; valid options are MERCURY, VENUS, EARTH, MARS, JUPITER, SATURN, NEPTUNE, URANUS (default=EARTH)


Mathematical Operations Keywords

Gn=

'clause1; clause2; . .; clausen'

grids to be used with the MATH keyword; separate select clauses with semicolons; single quotes are mandatory; specify clause using the following format:

searchkeyword value

valid options for searchkeyword are DAY, FHOUR, GPRO, GRID, LEV, PARAM, SRC, TIME; you can specify numbers between 1 and 99 in the keyword name (G1, G2, . . , G99); see the Remarks

INFo=

'text'

string placed in the header of the copied grid when the MATH keyword is used; maximum of 48 characters

MATh=

'expression'

mathematical operation to perform on the grids specified with the Gn keywords; single quotes are mandatory; see the Remarks

NEWpar=

param punit level lunit src
header information for the grid copied with the MATH keyword; parameter and level values, and associated units

 

 

param

grid parameter; four characters maximum (default=MATH)

 

 

punit

units of grid parameter; four characters maximum (default=NONE)

 

 

level

grid level (default=from grid)

 

 

lunit

units of grid level; two characters maximum (default=from grid)

 

 

src

grid source; four characters maximum (default=from grid)


Grid Point Selection Keywords

COL=

bcol ecol

range of columns to list or edit; specify MAX for the last column in the grid (default=1 MAX for the STAT and HIST options; default=1 bcol for the LIST and EDIT options)

LAT=

lat1 lat2

range of latitudes to list or edit; range must be south to north (default=grid latitude extents)

LON=

lon1 lon2

range of longitudes to list or edit; range must be east to west (default=grid longitude extents)

RANge=

bval eval

range of grid point values to list or edit; bval can be MISS for missing values (default=all values)

 

MISS

list or edit grid points with missing values

ROW=

brow erow

range of rows to list or edit; specify MAX for the last row in the grid (default=1 MAX for the STAT and HIST options; default=1 brow for the LIST and EDIT options)


EDIT Option Keywords

DEL=

YES

delete the destination grid file before copying the edited grid; see the Remarks

 

NO

do not delete the destination grid file (default)

DGRid=

beginning grid number in the destination grid file to place the edited grids; this keyword may overwrite existing grids; see the Remarks (default=append after the last grid in the grid file)

MAXgrd=

maximum number of grids the newly created destination grid file can store; see the Remarks (default=1000)

TITLE=

'text'

title of the newly created destination grid file; 32 characters maximum; see the Remarks

VALue=

num

value to assign to grid points specified with the grid point selection keywords

 

MISS

assigns a missing data value to the specified grid points


Output Keywords

BINsize=

increment, or bin width, for the histogram; valid only with the HIST option (default=from sdataset)

BYTecount=

YES

lists the number of bytes received from the server

 

NO

does not list the number of bytes (default)

FORmat=

output format for grid point values; if multiple parameters are requested, FORMAT cannot be specified; see the Remarks

NUM=

number of grids matching the criteria defined with the search keywords to list or edit; for example, if you specify NUM=50, the first 50 grids matching the search keywords are used (default=1)

 

ALL

use all grids matching the search keywords

SUBsect=

slat nlat elon wlon incrow inccol

geographic region to subsect from the source grid, and row and column reduction intervals to use within the subsect region, where:

 

slat, nlat

southern and northern latitudes of the subsect region

 

elon, wlon

eastern and western longitudes of the subsect region (slat, nlat, elon, wlon defaults=source grid bounds)

 

incrow, inccol

row and column reduction intervals; 1 means use every row/column of grid points in the subsect region, 2 means use every other row/column, etc.; when subsecting a conformal projection grid, the incrow and inccol values must be the same (default=1 for both)

 

Note: If the source grid is a McIDAS grid, you can subsect it by row and column instead of latitude and longitude. To do so, specify row and column numbers instead of latitudes and longitudes in the first four parameters, and specify ROWCOL as the seventh parameter. For example, SUBSECT=10 40 80 160 1 2 ROWCOL uses rows 10, 11, 12, ..., 40 and columns 80, 82, 84, ..., 160 for the subsect region. (If you don't include the ROWCOL at the end, it will treat 10 and 40 as latitudes, and 80 and 160 as longitudes.)

UNIt=

units to list for grid point values; not valid if multiple parameters are requested with the PARAM keyword (default=from grid header)


Remarks

Individual grids are stored in grid files. Each dataset position points to a single grid file. GRDINFO lists or edits individual grid point values in one or more grid files in a dataset. Use the search keywords to limit grid selection.

Use the RANGE, LAT and LON, and ROW and COL keywords to limit the selection of grid points. Using a combination of these grid point selection keywords limits grid points to those that meet all the specified criteria.

More than one grid can be altered using the EDIT option; however, only one value can be assigned to modify all the grids.

If you specify DEL=YES or a position number of a nonexistent grid file in the ddataset parameter, the edited grids are copied into a newly created grid file with the attributes specified in keywords MAXGRD and TITLE.

Using the DGRID keyword may result in grids being overwritten in the destination grid file. For example, if the destination grid file has 50 grids (in grids 1 to 50) and you specify NUM=10 DGRID=25, the edited grids will overwrite grids 25 to 34 in the destination grid file.

The GRID keyword copies grids from the grid file specified with the sdataset position number; the default position value, ALL, is not valid. When using the GRID keyword, do not specify additional search keywords, PARAM, LEV, DAY, etc., or NUM.

When using the DERIVE keyword with the LIST, HIST, and STAT options, GRDINFO lists information for a virtual grid: a grid that could be derived. The command searches for grids with components needed to derive a grid with the specified parameter. Only one derived parameter can be specified at a time, but you can request multiple grids, by specifying multiple levels or times, for example. Use GRDCOPY with the DERIVE keyword to create derived grids.

Use the FORMAT keyword options below to format output based on FORTRAN designators for data output:

Designator Description
I integer
F floating point
E exponential

To specify a parameter's output format, use a designator followed by a number. For example, I4 specifies an integer of up to four digits; F10.1 specifies a floating point decimal of up to 10 digits (including the decimal point) with one digit to the right of the decimal; E10.3 specifies an exponential number of up to 10 characters (including the decimal point and the four-character exponential flag) with three digits to the right of the decimal. Specify an X to use the parameter's default format. If the specified integer or floating point format is too small for the parameter's values, a series of asterisks (***) is displayed.


See Also

See the Remarks and Examples in the GRDCOPY or GRDDISP command for additional information on DERIVE, MERIDIONAL, and MATH keywords.


Examples

GRDINFO GFS/12

This entry lists the statistics for the first grid in the first grid file in dataset GFS/12. The statistics include the minimum and maximum values, mean, and standard deviation.

GRDINFO RT/GRID.10 HIST PARAM=T LEV=850 FHOUR=12

This entry displays the histogram of the 12-hour forecast, 850 mb temperature grid in position 10 of dataset RT/GRID.

GRDINFO GRIDS/ETA.1 DERIVE=SPD LEV=500 FHOUR=48

This entry lists the statistics for a wind speed grid that could be derived from 500 mb, 48-hour forecast time component grids in position 1 of dataset GRIDS/ETA.

GRDINFO CASEA.21 LIST PARAM=T LEV=700 FHOUR=24 ROW=15 COL=30 40 UNIT=C FORMAT=F5.1

This entry lists the temperature values stored in columns 30 through 40 of row 15 of a 24-hour forecast, 700 mb temperature grid in position 21 of the dataset with the alias name CASEA. The temperatures are listed in degrees Celsius. The temperature output is formatted as real numbers containing up to five digits (including the decimal point) with one digit to the right of the decimal point.

GRDINFO BLIZZARD/GFS.8000 EDIT BLIZZARD/EDIT.4003 VALUE=MISS LAT=40 45 LON=90 95 DERIVE=VOR LEV=500 FHOUR=48 DGRID=15

This entry creates a derived grid of relative vorticity using the 48-hour forecast, 500 mb u- and v- wind component grids in position 8000 of the dataset BLIZZARD/GFS. The new grid is placed in grid number 15 in position 4003 of the dataset BLIZZARD/EDIT, overwriting all pre-existing data. The values of grid points between 40° and 45° latitude and between 90° and 95° longitude are changed to missing data values (MISS).