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

NAME

6       c_csa3ls  -  cubic  spline approximation, simple entry for three-dimen‐
7       sional input, list output
8

FUNCTION PROTOTYPE

10       float *c_csa3ls(int, float [], float [], float [], float [],
11                       int [], int, float [], float [], float[], int *);
12
13

SYNOPSIS

15       float *c_csa3ls(int n, float xi[], float yi[], float zi[], float ui[],
16                       int knots[3], int no, float xo[], float yo[], float zo[],
17                       int *);
18
19

DESCRIPTION

21       n           (integer,input) The number of input data points. It must be
22                   that  n  is  greater  than  3 and, depending on the size of
23                   knots below, n may have to be larger.
24
25       xi          (real, input) An array dimensioned for n containing  the  X
26                   coordinate values for the input function.
27
28       yi          (real,  input)  An array dimensioned for n containing the Y
29                   coordinate values for the input function.
30
31       zi          (real, input) An array dimensioned for n containing  the  Z
32                   coordinate values for the input function.
33
34       ui          (real,  input) An array containing the functional values of
35                   the input function -- ui[k]  is  the  functional  value  at
36                   (xi[k], yi[k], zi[k]) for k=0,n-1.
37
38       knots       (integer,  input)  The  number  of knots to be used in con‐
39                   structing the approximation  spline.   knots[0],  knots[1],
40                   and  knots[2]  must be at least 4. The larger the value for
41                   knots, the closer the approximated curve will come to pass‐
42                   ing through the input function values.
43
44       no          (integer,  input)  The number of X - Y coordinate values to
45                   be calculated for the output array.
46
47       xo          (real, input) An array dimensioned for no containing the  X
48                   coordinates of the output list.
49
50       yo          (real, output) An array dimensioned for no containing the Y
51                   coordinates of the output list.
52
53       zo          (real, output) An array dimensioned for no containing the Z
54                   coordinates of the output list.
55
56       ier         (pointer to integer, output) An error return value. If *ier
57                   is returned as 0, then no errors were detected. If *ier  is
58                   non-zero,  then  refer to the error list in the error table
59                   for details.
60

USAGE

62       c_csa3ls is called to find values of an approximating cubic  spline  at
63       specified  three-dimensional  coordinates.   If  you want to weight the
64       input data values, calculate derivatives, or handle data  sparse  areas
65       specially, then you will need to use c_csa3lxs.
66
67       c_csa3ls  returns a pointer to a linear array of data that contains the
68       approximated values calculated at the input list of coordinate  values.
69       That is, if out is declared as
70
71         float *out;
72
73       and we set:
74
75         out = c_csa3ls(n, x, y, z, u, knots, no, xo, yo, zo, &ier);
76
77       then  out[i]  is  the  approximated  function value at coordinate point
78       (xo[i], yo[i], zo[i]) for 0 <= i < no. The space for out  is  allocated
79       internal to c_csa3ls and is no floats in size.
80

ACCESS

82       To use c_csa3ls, load the NCAR Graphics library ngmath.
83

SEE ALSO

85       csagrid, c_csa3s, c_csa3xs, c_csa3lxs
86
87       Complete documentation for Csagrid is available at URL
88       http://ngwww.ucar.edu/ngdoc/ng/ngmath/csagrid/csahome.html
89

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