NAME

       DSGRID3D - double precision Fortran entry for 3D gridding

SYNOPSIS

       CALL DSGRID3D (NPNTS, X, Y, Z, U, NUMXOUT, NUMYOUT, NUMZOUT,
       XO, YO, ZO, UO, IER)

DESCRIPTION

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

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

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

       Z           (Double precision, Input) - An array containing the Z coordinates of the input
                   data points.

       U           (Double precision, 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          (Double precision, 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          (Double precision, 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          (Double precision, 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          (Double  precision,  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

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

ACCESS

       To use DSGRID3D, load the NCAR Graphics library ngmath.

SEE ALSO

       dsgrid, dsgrid_params, dsseti, dsgeti, dssetrd dsgetrd 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.