NAME

       DSGRID3S - single precision Fortran entry for 3D gridding

SYNOPSIS

       CALL DSGRID3S (NPNTS, X, Y, Z, U, NUMXOUT, NUMYOUT, NUMZOUT, XO, YO, ZO, UO, 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  Z coordinates of the input data
                   points.

       U           (Real, Input) - An array containing the functional values of  the  input  data
                   points.   That  is,  U(L)  is  the  value  of the input function at coordinate
                   (X(L),Y(L),Z(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.

       NUMZOUT     (Integer, Input) - The number of Z 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, Input) - An array of dimension NUMZOUT containing the Z coordinates  of
                   the  output  data  grid.  The values in ZO must be increasing, but need not be
                   equally spaced.

       UO          (Real,    Output)    -    A    three-dimensional    array    dimensioned    as
                   UO(NUMXOUT,NUMYOUT,NUMZOUT)  containing  the  interpolated  functional values.
                   UO(I,J,K) is the interpolated value at grid point (XO(I),YO(J),ZO(K)).

       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

       DSGRID3S is the single precision gridding function in the Dsgrid package.  The behavior of
       DSGRID3S   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.

ACCESS

       To use DSGRID3S, 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.