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

NAME

6       CSA2S  -  cubic  spline approximation, simple entry for two-dimensional
7       input, gridded output
8

SYNOPSIS

10       CALL CSA2S (NI, XI, UI, KNOTS, NXO, ,NYO, XO, YO, UO, NWRK, WORK, IER)
11

DESCRIPTION

13       NI          (integer,input) The number of input data points. It must be
14                   that  NI  .gt. 3 and, depending on the size of KNOTS below,
15                   NI may have to be larger.
16
17       XI          (real, input) An array containing the X - Y coordinates  of
18                   the  input  data  points.  XI  is  dimensioned  for 2 x NI.
19                   XI(1,L) is the X coordinate and XI(2,L) is the Y coordinate
20                   for the input domain for L=1,NI.
21
22       UI          (real,  input) An array dimensioned for NI containing func‐
23                   tion values at the input XI values, that is  UI(L)  is  the
24                   value   of   the   input   function   at   the   coordinate
25                   (XI(1,L),XI(2,L)) for L=1,NI.
26
27       KNOTS       (integer, input) The number of knots to  be  used  in  con‐
28                   structing  the  approximation spline.  KNOTS is dimensioned
29                   for 2 and provides the number of knots to be used in the  X
30                   and  the  Y directions.  Both KNOTS(1) and KNOTS(2) must be
31                   at least 4.  The larger the values for  KNOTS,  the  closer
32                   the  approximated  curve  will  come to passing through the
33                   input function values.
34
35       NXO         (integer, input) The number of X coordinate values  in  the
36                   output grid.
37
38       NYO         (integer,  input)  The number of Y coordinate values in the
39                   output grid.
40
41       XO          (real, input) An array dimensioned for NXO containing the X
42                   coordinates of the output surface.
43
44       YO          (real, input) An array dimensioned for NYO containing the Y
45                   coordinates of the output surface.
46
47       UO          (real, output) An array dimensioned for NXO x NYO  contain‐
48                   ing  the calculated function values for the output surface.
49                   UO(I,J) is the calculated functional value at (XO(I),YO(J))
50                   for I=1,NXO and J=1,NYO.
51
52       NWRK        (integer,  input) The size of the WORK array.  NWRK must be
53                   at least KNOTS(1)*KNOTS(2)*(KNOTS(1)*KNOTS(2)+3).
54
55       WORK        (real, input) A work array dimensioned for NWRK.
56
57       IER         (integer,  output)  An  error  return  value.   If  IER  is
58                   returned as 0, then no errors were detected. If IER is non-
59                   zero, then refer to the man  page  for  csagrid_errors  for
60                   details.
61

USAGE

63       CSA2S  is called to find an approximating cubic spline surface for two-
64       dimensional input data.  If you want to weight the input  data  values,
65       calculate  derivatives, or handle data sparse areas specially, then you
66       will need to use CSA2XS.
67

ACCESS

69       To use CSA2S, load the NCAR Graphics library ngmath.
70

SEE ALSO

72       csagrid, csa2xs, csa2ls, csa2lxs
73
74       Complete documentation for Csagrid is available at URL
75       http://ngwww.ucar.edu/ngdoc/ng/ngmath/csagrid/csahome.html
76

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