NCEPLIBS-ip  5.1.0
iplib_8.h File Reference

C interface to gdswzd() and gdswzd_grib1() functions for '8' library build. More...

Go to the source code of this file.

Functions

void gdswzd (long igdtnum, long *igdtmpl, long igdtlen, long iopt, long npts, double fill, double *xpts, double *ypts, double *rlon, double *rlat, long *nret, double *crot, double *srot, double *xlon, double *xlat, double *ylon, double *ylat, double *area)
 gdswzd() interface for C for _8 build of library. More...
 
void gdswzd_grib1 (long *kgds, long iopt, long npts, double fill, double *xpts, double *ypts, double *rlon, double *rlat, long *nret, double *crot, double *srot, double *xlon, double *xlat, double *ylon, double *ylat, double *area)
 gdswzd_grib1() interface for C for _8 build of the library. More...
 

Detailed Description

C interface to gdswzd() and gdswzd_grib1() functions for '8' library build.

Author
Jovic
Date
2016

Definition in file iplib_8.h.

Function Documentation

◆ gdswzd()

void gdswzd ( long  igdtnum,
long *  igdtmpl,
long  igdtlen,
long  iopt,
long  npts,
double  fill,
double *  xpts,
double *  ypts,
double *  rlon,
double *  rlat,
long *  nret,
double *  crot,
double *  srot,
double *  xlon,
double *  xlat,
double *  ylon,
double *  ylat,
double *  area 
)

gdswzd() interface for C for _8 build of library.

Parameters
igdtnumgrid definition template number. Corresponds to the gfldigdtnum component of the ncep g2 library gridmod data structure.
  • 00 equidistant cylindrical
  • 01 rotated equidistant cylindrical. "e" and non-"e" staggered
  • 10 mercator cyclindrical
  • 20 polar stereographic azimuthal
  • 30 lambert conformal conical
  • 40 gaussian equidistant cyclindrical
igdtmpl(igdtlen) grid definition template array. corresponds to the gfldigdtmpl component of the ncep g2 library gridmod data structure for section three. all projections:
  • 1 shape of earth, octet 15
  • 2 scale factor of spherical earth radius, octet 16
  • 3 scaled value of radius of spherical earth, octets 17-20
  • 4 scale factor of major axis of elliptical earth, octet 21
  • 5 scaled value of major axis of elliptical earth, octets 22-25
  • 6 scale factor of minor axis of elliptical earth, octet 26
  • 7 scaled value of minor axis of elliptical earth, octets 27-30 equidistant cyclindrical:
  • 8 number of points along a parallel, octs 31-34
  • 9 number of points along a meridian, octs 35-38
  • 10 basic angle of initial production domain, octets 39-42.
  • 11 subdivisions of basic angle, octets 43-46
  • 12 latitude of first grid point, octets 47-50
  • 13 longitude of first grid point, octets 51-54
  • 14 resolution and component flags, octet 55
  • 15 latitude of last grid point, octets 56-59
  • 16 longitude of last grid point, octets 60-63
  • 17 i-direction increment, octets 64-67
  • 18 j-direction increment, octets 68-71
  • 19 scanning mode, octet 72 mercator cyclindrical:
  • 8 number of points along a parallel, octs 31-34
  • 9 number of points along a meridian, octs 35-38
  • 10 latitude of first point, octets 39-42
  • 11 longitude of first point, octets 43-46
  • 12 resolution and component flags, octet 47
  • 13 tangent latitude, octets 48-51
  • 14 latitude of last point, octets 52-55
  • 15 longitude of last point, octets 56-59
  • 16 scanning mode flags, octet 60
  • 17 orientation of grid, octets 61-64
  • 18 longitudinal grid length, octets 65-68
  • 19 latitudinal grid length, octets 69-72 Lambert conformal conical:
  • 8 number of points along x-axis, octs 31-34
  • 9 number of points along y-axis, octs 35-38
  • 10 latitude of first point, octets 39-42
  • 11 longitude of first point, octets 43-46
  • 12 resolution of component flag, octet 47
  • 13 latitude where grid lengths specified, octets 48-51
  • 14 longitude of meridian that is parallel to y-axis, octets 52-55
  • 15 x-direction grid length, octets 56-59
  • 16 y-direction grid length, octets 60-63
  • 17 projection center flag, octet 64
  • 18 scanning mode, octet 65
  • 19 first tangent latitude from pole, octets 66-69
  • 20 second tangent latitude from pole, octets 70-73
  • 21 latitude of south pole of projection, octets 74-77
  • 22 longitude of south pole of projection, octets 78-81 gaussian cylindrical:
  • 8 number of points along a parallel, octs 31-34
  • 9 number of points along a meridian, octs 35-38
  • 10 basic angle of initial production domain, octets 39-42
  • 11 subdivisions of basic angle, octets 43-46
  • 12 latitude of first grid point, octets 47-50
  • 13 longitude of first grid point, octets 51-54
  • 14 resolution and component flags, octet 55
  • 15 latitude of last grid point, octets 56-59
  • 16 longitude of last grid point, octets 60-63
  • 17 i-direction increment, octets 64-67
  • 18 number of parallels between pole and equator, octets 68-71
  • 19 scanning mode, octet 72 polar stereographic azimuthal:
  • 8 number of points along x-axis, octets 31-34
  • 9 number of points along y-axis, octets 35-38
  • 10 latitude of first grid point, octets 39-42
  • 11 longitude of first grid point, octets 43-46
  • 12 resolution and component flags, octet 47
  • 13 true latitude, octets 48-51
  • 14 orientation longitude, octets 52-55
  • 15 x-direction grid length, octets 56-59
  • 16 y-direction grid length, octets 60-63
  • 17 projection center flag, octet 64
  • 18 scanning mode flags, octet 65 rotated equidistant cyclindrical:
  • 8 number of points along a parallel, octs 31-34
  • 9 number of points along a meridian, octs 35-38
  • 10 basic angle of initial production domain, octets 39-42
  • 11 subdivisions of basic angle, octets 43-46
  • 12 latitude of first grid point, octets 47-50
  • 13 longitude of first grid point, octets 51-54
  • 14 resolution and component flags, octet 55
  • 15 latitude of last grid point, octets 56-59
  • 16 longitude of last grid point, octets 60-63
  • 17 i-direction increment, octets 64-67
  • 18 j-direction increment, octets 68-71
  • 19 scanning mode, octet 72
  • 20 latitude of southern pole of projection, octets 73-76
  • 21 longitude of southern pole of projection, octets 77-80
  • 22 angle of rotation of projection, octs 81-84
igdtlennumber of elements of the grid definition template array. Corresponds to the gfldigdtlen component of the ncep g2 library gridmod data structure.
ioptoption flag
  • 0 to compute earth coords of all the grid points
  • 1 to compute earth coords of selected grid coords
  • -1 to compute grid coords of selected earth coords
nptsinteger maximum number of coordinates
fillreal fill value to set invalid output data (must be impossible value; suggested value: -9999.)
xptsreal (npts) grid x point coordinates if iopt>0
yptsreal (npts) grid y point coordinates if iopt>0
rlonreal (npts) earth longitudes in degrees e if iopt<0 (acceptable range: -360. to 360.)
rlatreal (npts) earth latitudes in degrees n if iopt<0 (acceptable range: -90. to 90.)
nretnumber of valid points computed (-1 if projection unrecognized)
crot(npts) clockwise vector rotation cosines
srot(npts) clockwise vector rotation sines (ugrid=crot*uearth-srot*vearth, vgrid=srot*uearth+crot*vearth)
xlon(npts) dx/dlon in 1/degrees
xlat(npts) dx/dlat in 1/degrees
ylon(npts) dy/dlon in 1/degrees
ylat(npts) dy/dlat in 1/degrees
area(npts) area weights in m**2 (Proportional to the square of the map factor in the case of conformal projections.)
Author
Jovic
Date
2016

◆ gdswzd_grib1()

void gdswzd_grib1 ( long *  kgds,
long  iopt,
long  npts,
double  fill,
double *  xpts,
double *  ypts,
double *  rlon,
double *  rlat,
long *  nret,
double *  crot,
double *  srot,
double *  xlon,
double *  xlat,
double *  ylon,
double *  ylat,
double *  area 
)

gdswzd_grib1() interface for C for _8 build of the library.

This is a C prototype to call the Fortran module subroutine gdswzd_c_grib1() for the _4 version of the library.

Parameters
kgds(200) gds parameters as decoded by w3fi63.
ioptoption flag
  • 0 to compute earth coords of all the grid points
  • 1 to compute earth coords of selected grid coords
  • -1 to compute grid coords of selected earth coords
nptsmaximum number of coordinates
fillfill value to set invalid output data (must be impossible value; suggested value: -9999.)
xpts(npts) grid x point coordinates if iopt>0
ypts(npts) grid y point coordinates if iopt>0
rlon(npts) earth longitudes in degrees e if iopt<0 (acceptable range: -360. to 360.)
rlat(npts) earth latitudes in degrees n if iopt<0 (acceptable range: -90. to 90.)
nretnumber of valid points computed (-1 if projection unrecognized)
crot(npts) clockwise vector rotation cosines
srot(npts) clockwise vector rotation sines (ugrid=crot*uearth-srot*vearth; vgrid=srot*uearth+crot*vearth)
xlon(npts) dx/dlon in 1/degrees
xlat(npts) dx/dlat in 1/degrees
ylon(npts) dy/dlon in 1/degrees
ylat(npts) dy/dlat in 1/degrees
area(npts) area weights in m**2 (proportional to the square of the map factor in the case of conformal projections.)
Author
Jovic
Date
2016