NuSDaS User's Guide

v1.0 Definition File - Metadata Statements

basepoint ix iy lon lat

This statement indicates that the location of grid numbered (ix, iy) is positioned (lon, lat). Both of ix, iy must be real number, lon must be real number with 'E' or 'W' appended, lat must be real number with 'N' or 'S' appended, Note that this statement is used with the geographical meaning shown above even if the 2D grid is taken vertically. In order to describe vertical grid point locations, SUBC record might be used.

distance dx dy

Indicates horizontal distance (in X and Y directions) between adjacent grid points. The units is degree when the grids is latitude-longitude grids, and is meter when map projection is applied. When the 2D grid is taken vertically, one of dx, dy shall be ignored. Note that the meridional grid distance dy is taken southward. It is positive in most JMA models: grid points with the smallest Y index are located at the northern end of 2D grid. On the contrary, if dy is negative, grid points with the smallest Y index are located at the southern end of 2D grid.

standard lon lat lon2 lat2

Specifies standard longitude/latitude. They are parameters of map projection, and only a part of them is used in some cases. It is dependent to horizontal grid style whether this statement is required or not. See following description of others.

others lon3 lat3 lon4 lat4

Specifies 3rd or 4th longitude/latitude. Meaning of parameters is dependent to projection. It is also dependent to horizontal grid style whether this statement is required or not.

LM

The Lambert conformal projection has 3 parameters; use "standard LoV Latin1 LoV Latin2", where LoV is Y-axis longitude, and Latin1 and Latin2 is the first/second latitude where the secant cone cuts the earth. In most cases of JMA, it looks like

standard 140.0E 30.0N 140.0E 60.0N
PS

The polar stereographic projection has 2 parameters; use "standard LoV LaD 0E 0N", where LoV is Y-axis longitude, and LaD is the latitude where grid point distance is defined. In most cases of JMA, it looks like

standard 140.0E 30.0N 0E 0N
MR

The Mercator projection has one parameter; use "standard 0E LaD 0E 0N", where LaD is the latitude where grid point distance is defined.

OL

The Lambert conformal projection has 3 parameters; use "standard LoV Latin1 LoV Latin2" and "others LoP LaP RotAngE 0N", where LoV is Y-axis longitude, (Latin1, Latin2) is the first/second latitude where the secant cone cuts the earth, (LoP, LaP) is longitude/latitnude of the projection southern pole, and RotAng is the angle of rotation after projection. Unfortunately, the practice in JMA has been failed to write this parameter properly and you may have data with zero-filled corresponding fields (as for 2003-03-07).

other horizontal grids

Since there is no projection parameters, standard or others statements should not be written.

value representation

Describes how gridded data represents field. Word representation should be one of them:

PVAL

values at grid point. This is the default.

MEAN

average over volume/area around grid point

REPR

representative value obtained with another method

packing pack_mode

Describes encoding scheme to be used in DATA record. See "Packing Type" in the reference manual for table of possible values. By default, 2PAC is assumed.

missing miss_mode

Describes how missing value is to be represented. Word miss_mode should be one of them:

NONE

There is no method for missing value in this case. This is the default.

UDFV

A certain value is missing value, and grids with the value should be regarded missing. see NUSDAS_PARAMETER_CHANGE for detail.

MASK

Grid points with valid data are indicated with bitmap for each DATA record. See NUSDAS_MAKE_MASK in the reference manual for detail.

information group filename

If the definition file has this statement, INFO record will be written at the time of data file creation. It can be stated as many as needed. Size and contents of the INFO record will be that of file specified with a relative path filename. Word group should be a four-character name that identifies the INFO record.

subcntl num group size group size ...

If the definition file has this statement, SUBC record is allocated at the time of data file creation. Each SUBC record is secified with a pair of group (four-character name that identifies the SUBC record) and size (size of the SUBC record). Word num specifies the number of group-size pairs.

forcedlen size

This statement is required if you use ES interface. If the definition file has this statement, each records in data file will have size bytes. Padding of (size - (payload size)) bytes is used after record payload. Error occurs if a record exceeds the specified size. By default, records are aligned contiguously (without padding between record payload and 4-byte record trailer).