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

NAME

6       c_dsgrid3s - primary single precision C entry for 3D gridding
7

FUNCTION PROTOTYPE

9       float  *c_dsgrid3s(int, float [], float [], float [], float [],
10                 int, int, int, float [], float [], float [], int *);
11

SYNOPSIS

13       float  *c_dsgrid3s(int n, float x[], float y[], float z[],
14                 float u[], int nx, int ny, int nz, float xo[],
15                 float yo[], float zo[], int *ier);
16

DESCRIPTION

18       n           The number of input data points.
19
20       x           An  array  containing  the  X coordinates of the input data
21                   points.
22
23       y           An array containing the Y coordinates  of  the  input  data
24                   points.
25
26       z           An  array  containing  the  Z coordinates of the input data
27                   points.
28
29       u           An array of size n containing the functional values of  the
30                   input  data points. That is, z[m] is the value of the input
31                   function at coordinate (x[m],y[m],z[m]), for 0 <= m < n.
32
33       nx          The number of X values in the output grid.
34
35       ny          The number of Y values in the output grid.
36
37       nz          The number of Z values in the output grid.
38
39       xo          An array of size nx containing the  X  coordinates  of  the
40                   output  data grid. The values in xo must be increasing, but
41                   need not be equally spaced.
42
43       yo          An array of size ny containing the  Y  coordinates  of  the
44                   output  data grid. The values in yo must be increasing, but
45                   need not be equally spaced.
46
47       zo          An array of size nz containing the  Z  coordinates  of  the
48                   output  data grid. The values in zo must be increasing, but
49                   need not be equally spaced.
50
51       ier         An error return value. If *ier is returned as  0,  then  no
52                   errors  were  detected.  If *ier is non-zero, then refer to
53                   the man page for dsgrid_errors.
54

USAGE

56       c_dsgrid3s returns a pointer to a linear array  of  data  that  is  the
57       interpolated  grid  stored  in  row-major  order.  That  is,  if out is
58       declared as
59
60       float *out;
61
62       and we set:
63
64         out = *c_dsgrid3s(n, x, y, z, u, nx, ny, nz,
65                   xo, yo, zo, ier);
66
67       then out[nz*ny*i + nz*j + k] is  the  interpolated  function  value  at
68       coordinate  point (xo[i],yo[j],zo[k]) for 0 <= i < nx, 0 <= j < ny, and
69       0 <= k < nz. The space for out is allocated internal to c_dsgrid3s  and
70       is nx*ny*nz floats in size.
71

ACCESS

73       To use c_dsgrid3s, load the NCAR Graphics library ngmath.
74

SEE ALSO

76       dsgrid,   dsgrid_params,   c_dsseti,   c_dsgeti,   c_dssetr,  c_dsgetr,
77       c_dssetc, c_dsgetc.
78
79       Complete documentation for Dsgrid is available at URL
80       http://ngwww.ucar.edu/ngdoc/ng/ngmath/dsgrid/dshome.html
81

83       Copyright (C) 2000
84       University Corporation for Atmospheric Research
85
86       This documentation is free software; you  can  redistribute  it  and/or
87       modify  it  under  the  terms of the GNU General Public License as pub‐
88       lished by the  Free  Software  Foundation;  either  version  2  of  the
89       License, or (at your option) any later version.
90
91       This  software  is  distributed in the hope that it will be useful, but
92       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
93       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
94       Public License for more details.
95
96       You should have received a copy of the GNU General Public License along
97       with  this  software;  if  not,  write to the Free Software Foundation,
98       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
99
100
101
102
103UNIX                          September 1997-1998           c_dsgrid3s(3NCARG)
Impressum