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

NAME

6       c_cssgridd - tension spline interpolation on a sphere
7

FUNCTION PROTOTYPE

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

SYNOPSIS

14       double *c_cssgridd (n, rlat, rlon, f, ni, nj, plat, plon, ier)
15
16

DESCRIPTION

18       n           The number of input data points, n > 2.
19
20       rlat        An  array  containing  the  latitudes  of  the  input data,
21                   expressed in degrees.  The first three points must  not  be
22                   collinear (lie on a common great circle).
23
24       rlon        An  array  containing  the  longitudes  of  the input data,
25                   expressed in degrees.
26
27       f           Array containing data values. f[i] is the functional  value
28                   at (rlat[i],rlon[i]) for i = 0 to n-1.
29
30       ni          The number of latitudes in the interpolated grid.
31
32       nj          The  number of longitudes in the interpolated grid.  ni and
33                   nj can both be 1, allowing for interpolation  at  a  single
34                   point.
35
36       plat        An  array  containing  the  latitudes  of  the points where
37                   interpolated values are to be computed.  The values in plat
38                   should be in degrees.
39
40       plon        An  array of length nj containing the longitudes the output
41                   grid lines.  The values in plon should be in degrees.
42
43       ier         An error return value. If *ier is returned as  0,  then  no
44                   errors  were  detected.  If *ier is non-zero, then refer to
45                   the error list in cssgrid_errors for details.
46

USAGE

48       c_cssgridd is called to find an interpolating tension spline  for  ran‐
49       domly  positioned  data on a unit sphere. c_cssgridd is a double preci‐
50       sion version of c_cssgrid.
51

RETURN VALUE

53       c_cssgridd returns a pointer to a linear array of  data  that  contains
54       interpolated values at user-specified lat/lon pairs. The returned array
55       stores its values as if they were a 2-dimensional C array with latitude
56       being  the first dimension and longitude the second dimension. That is,
57       if out is declared as
58
59         double *out;
60
61       and we set:
62
63         out = c_cssgridd(n, rlat, rlon, f, nlat, nlon, plat, plon, &ier);
64
65       then out[i*nlon+j] is the interpolated  function  value  at  coordinate
66       point (plat[i], plon[j]) for 0 <= i < nlat and 0 <= j < nlon. The space
67       for out is allocated internal to c_cssgridd and is nlat * nlon  doubles
68       in size.
69

ACCESS

71       To use c_cssgridd, load the NCAR Graphics library ngmath.
72

SEE ALSO

74       c_cssgrid, css_overview, cssgrid_errors
75
76       Complete documentation for Cssgrid is available at URL
77       http://ngwww.ucar.edu/ngdoc/ng/ngmath/cssgrid/csshome.html
78

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