1IDBVIP(3NCARG) NCAR GRAPHICS IDBVIP(3NCARG)
2
3
4
6 IDBVIP - produces interpolated values at points (XI(I), YI(I)),
7 I=1,...,NIP. This is useful for filling in missing data points on a
8 grid.
9
11 CALL IDBVIP (MD,NDP,XD,YD,ZD,NIP,XI,YI,ZI,IWK,WK)
12
14 #include <ncarg/ncargC.h>
15
16 void c_idbvip (int md, int ndp, float *xd, float *yd,
17 float *zd, int nip, float *xi, float *yi, float *zi,
18 int *iwk, float *wk)
19
21 MD Mode of computation (must be 1, 2, or 3, else an error
22 return occurs.)
23
24 1 If this is the first call to this subroutine, or if
25 the value of NDP has been changed from the previous
26 call, or if the contents of the XD or YD arrays have
27 been changed from the previous call.
28
29 2 If the values of NDP and the XD and YD arrays are
30 unchanged from the previous call, but new values for
31 XI, YI are being used. If MD = 2 and NDP has been
32 changed since the previous call to IDBVIP, an error
33 return occurs.
34
35 3 If the values of NDP, NIP, XD, YD, XI, YI are
36 unchanged from the previous call, i.e. if the only
37 change on input to IDBVIP is in the ZD array. If
38 MD=3 and NDP or NIP has been changed since the
39 previous call to IDBVIP, an error return occurs.
40
41 Between the call with MD=2 or MD=3 and the preceding call,
42 the IWK and WK work arrays should not be disturbed.
43
44 NDP Number of data points (must be 4 or greater, else an error
45 return occurs).
46
47 XD Array of dimension NDP containing the X coordinates of the
48 data points.
49
50 YD Array of dimension NDP containing the Y coordinates of the
51 data points.
52
53 ZD Array of dimension NDP containing the Z coordinates of the
54 data points.
55
56 NIP The number of output points at which interpolation is to be
57 performed (must be 1 or greater, else an error return
58 occurs).
59
60 XI Array of dimension NIP containing the X coordinates of the
61 output points.
62
63 YI Array of dimension NIP containing the Y coordinates of the
64 output points.
65
66 IWK Integer work array of dimension at least 31*NDP + NIP.
67
68 WK Real work array of dimension at least 8*NDP.
69
70 ZI Array of dimension NIP where interpolated Z values are to
71 be stored.
72
73
74 Inadequate work space IWK and WK may may cause incorrect results.
75
76 The data points must be distinct and their projections in the X-Y plane
77 must not be collinear, otherwise an error return occurs.
78
80 The C-binding argument descriptions are the same as the FORTRAN
81 argument descriptions.
82
84 To use Bivar routines, load the NCAR Graphics libraries ncarg,
85 ncarg_gks, and ncarg_c, preferably in that order.
86
88 To use IDBVIP or c_idbvip, load the NCAR Graphics libraries ncarg,
89 ncarg_gks, and ncarg_c, preferably in that order.
90
92 See the bivar man page for a description of all Bivar error messages
93 and/or informational messages.
94
96 Online: bivar, bivar_params, idsfft, idpltr, idgeti, idgetr, idseti,
97 idsetr, ncarg_cbind
98
100 Bivar was written by Hiroshi Akima in August 1975 and rewritten by him
101 in late 1976. In 1989, a new version of Bivar, incorporating changes
102 described in a Rocky Mountain Journal of Mathematics was obtained from
103 Dr. Akima, and included in NCAR Graphics with his permission. In 1995,
104 Dave Kennison incorporated the capability of doing linear interpolation
105 and a different kind of triangulation, put in a parameter access
106 interface, and wrote a routine to allow the triangulation to be
107 plotted.
108
110 Copyright (C) 1987-2009
111 University Corporation for Atmospheric Research
112 The use of this Software is governed by a License Agreement.
113
114
115
116UNIX November 1995 IDBVIP(3NCARG)