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

NAME

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

SYNOPSIS

11       CALL IDBVIP (MD,NDP,XD,YD,ZD,NIP,XI,YI,ZI,IWK,WK)
12

C-BINDING SYNOPSIS

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

DESCRIPTION

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

C-BINDING DESCRIPTION

80       The C-binding argument descriptions are the same as the FORTRAN
81       argument descriptions.
82

EXAMPLES

84       To use Bivar routines, load the NCAR Graphics libraries ncarg,
85       ncarg_gks, and ncarg_c, preferably in that order.
86

ACCESS

88       To use IDBVIP or c_idbvip, load the NCAR Graphics libraries ncarg,
89       ncarg_gks, and ncarg_c, preferably in that order.
90

MESSAGES

92       See the bivar man page for a description of all Bivar error messages
93       and/or informational messages.
94

SEE ALSO

96       Online: bivar, bivar_params, idsfft, idpltr, idgeti, idgetr, idseti,
97       idsetr, ncarg_cbind
98

ACKNOWLEDGMENTS

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-2007
111       University Corporation for Atmospheric Research
112
113       This documentation is free software; you can redistribute it and/or
114       modify it under the terms of the GNU General Public License as
115       published by the Free Software Foundation; either version 2 of the
116       License, or (at your option) any later version.
117
118       This software is distributed in the hope that it will be useful, but
119       WITHOUT ANY WARRANTY; without even the implied warranty of
120       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
121       General Public License for more details.
122
123       You should have received a copy of the GNU General Public License along
124       with this software; if not, write to the Free Software Foundation,
125       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
126
127
128
129UNIX                             November 1995                  IDBVIP(3NCARG)
Impressum