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

NAME

6       CSA2LS  -  cubic spline approximation, simple entry for two-dimensional
7       input, list output
8

SYNOPSIS

10       CALL CSA2LS (NI, XI, UI, KNOTS, NO, XO, YO, UO, NWRK,
11                    WORK, IER)
12

DESCRIPTION

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

USAGE

61       CSA2LS is called to find an approximating cubic spline surface for two-
62       dimensional input data with output values calculated at a list of user-
63       specified points.  If you want to weight the input data values,  calcu‐
64       late  derivatives, or handle data sparse areas specially, then you will
65       need to use CSA2LXS.
66

ACCESS

68       To use CSA2LS, load the NCAR Graphics library ngmath.
69

SEE ALSO

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