NuSDaS Interface Reference Manual

NUSDAS_GRID

SYNOPSIS

/* C */
    int
nusdas_grid(type1, type2, type3, btime, memb, vtime1,
  proj, gridsize, geometry, tattr, io)
    int
nusdas_grid2(type1, type2, type3, btime, memb, vtime1, vtime2,
  proj, gridsize, geometry, tattr, io)

SUBROUTINE NUSDAS_GRID(type1, type2, type3, btime, memb, vtime1, &
  proj, gridsize, geometry, tattr, io, iostat)
    int
SUBROUTINE NUSDAS_GRID2(type1, type2, type3, btime, memb, vtime1, &
  vtime2, proj, gridsize, geometry, tattr, io, iostat)
symbolFortranC
projCHARACTER(4)char [4]
gridsizeINTEGER, DIMENSION(2)N_SI4 [2]
geometryREAL, DIMENSION(2, 7)float [7][2]
tattrCHARACTER(4)char [4]
io(should be symbol/macro defined in header file)
iostatINTEGER, INTENT(OUT)(not used)

ARGUMENTS

proj

four-character symbol of projection type. The name is different from that in type1 string, the corresponding values are following table.

proj parameter values
Projectiontype1 stringproj parameterremarks
CylindricalEquid"LL""LL ".
LambertConformal"LM""LMN "Northern hemisphere (*)
"LMS "Southern hemisphere
PolarStereo"PS""PSN "Northern hemisphere
"PSS "Southern hemisphere
Mercator"MR""MER ".
Gaussian grid"GS""GS ".
ObliqueLambert"OL""OL "Specified for RADAR data of Japan area.
Some parameters are due to the agreement between the users.
Section of latitude"XP""XP ".
Section of longitude"YP""YP ".
"Free Grid""FG""FG ".
RADAR site"RD""RD "Peculiar to each site
Station data"ST""ST ".

(*) In case of LambertConformal or PolarStereo, the "N" or "S" character is added to the proj parameter. The character is decided with the location of the basepoint, indicated in the definition file. The equator is equated to northern hemisphere.

gridsize

grid size.

geometry

byte offset 80--135 in CNTL record.

tattr

four-character symbol which denotes how grid point value represents physical field with regard to spatial dimensions. Note that it is different from symbols in type2 string. See "value" statement in Definition File Format for possible values.

io

one of following symbols

N_IO_PUT

writes SUBC record.

N_IO_GET

reads SUBC record.

RETURN VALUE

0Succeeded.
-1Error: requested file not exist.
-2Error: requested file malformed.
-5Error: invalid argument.
-10 to -99(see error code table)

see also Error Code of NuSDaS library for return code from -10 to -99.