NAME

       DSGRID2S - 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

COPYRIGHT

       Copyright (C) 2000
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.