ncl_dsgrid2s - Man Page

primary single precision Fortran entry for 2D gridding

Synopsis

CALL DSGRID2S (NPNTS, X, Y, Z, NUMXOUT, NUMYOUT, XO, YO, ZO, IER)

Description

NPNTS

(Integer, Input) - The number of input data points.

X

(Real, Input) - An array containing the X coordinates of the input data  points.

Y

(Real, Input) - An array containing the Y coordinates of the input data  points.

Z

(Real, Input) - An array containing the functional values of the  input data points. That is, Z(L) is the value of the input function at  coordinate (X(L),Y(L)), for L=1,NPNTS.

NUMXOUT

(Integer, Input) - The number of X values in the output grid.

NUMYOUT

(Integer, Input) - The number of Y values in the output grid.

XO

(Real, Input) - An array of dimension NUMXOUT containing the X  coordinates of the output data grid. The values in XO must be  increasing, but need not be equally spaced.

YO

(Real, Input) - An array of dimension NUMYOUT containing the Y  coordinates of the output data grid. The values in YO must be  increasing, but need not be equally spaced.

ZO

(Real, Output) -  A two-dimensional array of dimension NUMXOUT x NUMYOUT containing the interpolated functional values. ZO(I,J) is the interpolated value at grid point (XO(I),YO(J)).

IER

(Integer, Output) - An error return value. If IER is returned as 0, then no errors were detected. If IER is non-zero, then refer to the man page for dsgrid_errors for details.

Usage

DSGRID2S is the single precision gridding function for 2D data  in the Dsgrid package. The behavior of DSGRID2S is controlled by values set for the various parameters described in dsgrid_params.  Values for these parameters can be set using the subroutines DSSETI, DSSETR, and DSSETC.

In almost all cases the ngmath function NATGRIDS is superior to DSGRID2S for 2D interpolation.  See the man page for NATGRIDS for details.

Access

To use DSGRID2S, load the NCAR Graphics library ngmath.

See Also

dsgrid, dsgrid_params,  dsseti,  dsgeti,  dssetr,  dsgetr,  dssetc,  dsgetc.

Complete documentation for Dsgrid is available at URL
http://ngwww.ucar.edu/ngdoc/ng/ngmath/dsgrid/dshome.html

Info

September 1997-1998 UNIX NCAR GRAPHICS