ncarg_csa3xs(3)

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

NAME

6       CSA3XS  -  cubic  spline approximation, expanded entry for three-dimen‐
7       sional input
8

SYNOPSIS

10       CALL CSA3XS (NI, XI, UI, WTS, KNOTS, SMTH, NDERIV,
11                    NXO, ,NYO, NZO, XO, YO, ZO, UO, NWRK,
12                    WORK, IER)
13

DESCRIPTION

15       NI          (integer,input) The number of input data points. It must be
16                   that  NI  .gt. 3 and, depending on the size of KNOTS below,
17                   NI may have to be larger.
18
19       XI          (real, input) An array containing the X - Y - Z coordinates
20                   of  the  input  data points.  XI is dimensioned for 3 x NI.
21                   XI(1,L) is the X coordinate, XI(2,L) is the  Y  coordinate,
22                   and  XI(2,L)  is  the Z coordinate for the input domain for
23                   L=1,NI.
24
25       UI          (real, input) An array dimensioned for NI containing  func‐
26                   tion  values  at the input XI values, that is, UI(L) is the
27                   value of the input function at XI(L) for  L=1,NI.   through
28                   the input function values.
29
30       WTS         (real,  input)  An  array  dimensioned  for  NI  containing
31                   weights for the UI values at the input XI values, that  is,
32                   WTS(L)  is  a weight for the value of UI(L) for L=1,NI.  If
33                   you do not desire to weight the input UI values,  then  set
34                   WTS(1)  to  -1.   The weights in the WTS array are relative
35                   and may be set to any non-negative value.  When  CSA3XS  is
36                   called,  the  weights are summed and the individual weights
37                   are normalized so that the weight sum is unity.
38
39       KNOTS       (integer, input) The number of knots to  be  used  in  con‐
40                   structing  the  approximation spline.  KNOTS is dimensioned
41                   for 3 and provides the number of knots to be used in the X,
42                   Y, and  Z directions.  Both KNOTS(I) must be at least 4 for
43                   I=1,3.  The larger the values for  KNOTS,  the  closer  the
44                   approximated  curve  will come to passing through the input
45                   function values.
46
47       SMTH        (real, input) A parameter that controls extrapolation  into
48                   data sparse regions.  If SMTH is zero, then nothing special
49                   is done in data sparse regions.  A good  first  choice  for
50                   SMTH is 1.
51
52       NDERIV      (integer, input) An array dimensioned for 3 that specifies,
53                   for each coordinate,  whether you  want  functional  values
54                   (=0),  first  derivative  values (=1), or second derivative
55                   values (=2).
56
57       NXO         (integer, input) The number of X coordinate values  in  the
58                   output grid.
59
60       NYO         (integer,  input)  The number of Y coordinate values in the
61                   output grid.
62
63       NZO         (integer, input) The number of Z coordinate values  in  the
64                   output grid.
65
66       XO          (real, input) An array dimensioned for NXO containing the X
67                   coordinates of the output spline.
68
69       YO          (real, input) An array dimensioned for NYO containing the Y
70                   coordinates of the output spline.
71
72       ZO          (real, input) An array dimensioned for NZO containing the Z
73                   coordinates of the output spline.
74
75       UO          (real, output) An array dimensioned for NXO  x  NYO  x  NZO
76                   containing  the  calculated  function values for the output
77                   function.  UO(I,J,K) is the calculated functional value  at
78                   (XO(I), YO(J), ZO(K)) for I=1,NXO and J=1,NYO and K=1,NZO.
79
80       NWRK        (integer,  input) The size of the WORK array.  NWRK must be
81                   at least NK * (NK+3) where  NK  =  KNOTS(1)  *  KNOTS(2)  *
82                   KNOTS(3).
83
84       WORK        (real, input) A work array dimensioned for NWRK.
85
86       IER         (integer,  output)  An  error  return  value.   If  IER  is
87                   returned as 0, then no errors were detected. If IER is non-
88                   zero,  then  refer  to  the man page for csagrid_errors for
89                   details.
90

USAGE

92       CSA3XS is called to find an approximating cubic spline for three-dimen‐
93       sional  input  data.   CSA3XS is called if you want to weight the input
94       data values, calculate derivatives, or handle data  sparse  areas  spe‐
95       cially.   If  you do not want to do any of these three things, then use
96       CSA3S.
97

ACCESS

99       To use CSA3XS, load the NCAR Graphics library ngmath.
100

COPYRIGHT

108       Copyright (C) 2000
109       University Corporation for Atmospheric Research
110
111       This documentation is free software; you  can  redistribute  it  and/or
112       modify  it  under  the  terms of the GNU General Public License as pub‐
113       lished by the  Free  Software  Foundation;  either  version  2  of  the
114       License, or (at your option) any later version.
115
116       This  software  is  distributed in the hope that it will be useful, but
117       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
118       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
119       Public License for more details.
120
121       You should have received a copy of the GNU General Public License along
122       with  this  software;  if  not,  write to the Free Software Foundation,
123       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
124
125
126
127
128UNIX                             January 1999                   CSA3XS(3NCARG)

NAME

SYNOPSIS

DESCRIPTION

USAGE

ACCESS

SEE ALSO

COPYRIGHT