1c_natgridd(3NCARG)               NCAR GRAPHICS              c_natgridd(3NCARG)
2
3
4

NAME

6       c_natgrids  -  primary  double  precision  C entry for natural neighbor
7       gridding
8

FUNCTION PROTOTYPE

10       double  *c_natgridd(int, double [], double [], double [],
11                           int, int, double [], double [], int *);
12

SYNOPSIS

14       double *c_natgridd (npnts, x, y, z, numxout, numyout, xi, yi, ier);
15

DESCRIPTION

17       npnts       The number of input data points. (npnts > 3).
18
19       x           An array containing the x coordinates  of  the  input  data
20                   points.
21
22       y           An  array  containing  the  y coordinates of the input data
23                   points.
24
25       z           An array containing the functional values of the input data
26                   points. That is, z[m] is the value of the input function at
27                   coordinate (x[m],y[m]), for 0 <= m < npnts.
28
29       numxout     The number of x values in the output grid.
30
31       numyout     The number of y values in the output grid.
32
33       xi          An array of dimension numxout containing the x  coordinates
34                   of  the output data grid. The values in xi must be increas‐
35                   ing, but need not be equally spaced.
36
37       yi          An array of dimension numyout containing the y  coordinates
38                   of  the output data grid. The values in yi must be increas‐
39                   ing, but need not be equally spaced.
40
41       ier         An error value. If *ier is 0, then no errors were detected.
42                   If  *ier  is  non-zero, then refer to the man page for nat‐
43                   grid_errors for details.
44

USAGE

46       c_natgridd returns a pointer to a linear array of data that is  is  the
47       interpolated  grid  stored  in  row-major  order.  That  is,  if out is
48       declared as
49
50       double *out;
51
52       and we set:
53
54         out = c_natgridd(numin, x, y, z, numxout, numyout, xo, yo, &ier);
55
56       then out[i*numyout+j] is the interpolated function value at  coordinate
57       point  (xo[i],yo[j])  for  0  <=  i < numxout and 0 <= j < numyout. The
58       space for out is allocated internal to c_natgrids and is  numxout*numy‐
59       out double values in size.
60

ACCESS

62       To use c_natgridd, load the NCAR Graphics library ngmath.
63

SEE ALSO

65       natgrid,  natgrid_params,  c_nnseti,  c_nngeti,  c_nnsetrd,  c_nngetrd,
66       c_nnsetc, c_nngetc.
67
68       Complete documentation for Natgrid is available at URL
69       http://ngwww.ucar.edu/ngdoc/ng/ngmath/natgrid/nnhome.html
70
72       Copyright (C) 2000
73       University Corporation for Atmospheric Research
74
75       This documentation is free software; you  can  redistribute  it  and/or
76       modify  it  under  the  terms of the GNU General Public License as pub‐
77       lished by the  Free  Software  Foundation;  either  version  2  of  the
78       License, or (at your option) any later version.
79
80       This  software  is  distributed in the hope that it will be useful, but
81       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
82       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
83       Public License for more details.
84
85       You should have received a copy of the GNU General Public License along
86       with  this  software;  if  not,  write to the Free Software Foundation,
87       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
88
89
90
91
92UNIX                            March 1997-1998             c_natgridd(3NCARG)
Impressum