1Bivar(3NCARG) NCAR GRAPHICS Bivar(3NCARG)
2
6 Bivar - Provides bivariate interpolation and smooth surface fitting for
7 values given at irregularly distributed points. The resulting
8 interpolating function and its first-order partial derivatives are
9 continuous. The method employed is local, i.e. a change in the data in
10 one area of the plane does not affect the interpolating function except
11 in that local area. Also, the method gives exact results when all
12 points lie in a plane.
13
15 IDBVIP Produces interpolated values at points (XI(I), YI(I)),
16 I=1,...,NIP. This is useful for filling in missing data
17 points on a grid.
18 IDSFFT Performs smooth surface fitting when the projections of the
20 data points in the X-Y plane are irregularly distributed in
21 the plane.
22 IDPLTR Plots the triangulation of the data points.
24 IDGETI Retrieves the integer value of a Bivar parameter.
26 IDGETR Retrieves the real value of a Bivar parameter.
28 IDSETI Provides a new integer value for a Bivar parameter.
30 IDSETR Provides a new real value for a Bivar parameter.
32
34 c_idbvip,
35 c_idsfft
36 c_idpltr
37 c_idgeti
38 c_idgetr
39 c_idseti
40 c_idsetr
41
43 See the example "cbex01".
44
46 To use the Bivar Fortran or C routines, load the NCAR Graphics
47 libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
48
51 When error conditions are detected, the support routine SETER is
52 called. By default, SETER writes a message to the standard error file
53 (as defined by I1MACH(4)) and then terminates execution. It is
54 possible to put SETER into recovery mode and regain control after a
55 recoverable error (which includes all of the possible errors).
56 The possible error messages are listed below. All errors are
58 recoverable in the sense that a user program which has called ENTSR to
59 set recovery mode will get control back after one of these errors
60 occurs.
61 IDBVIP (BIVAR) - UNCLEARED PRIOR ERROR
63 IDBVIP (BIVAR) - INPUT VARIABLE MD IS OUT OF RANGE
65 IDBVIP (BIVAR) - INPUT VARIABLE NDP IS OUT OF RANGE
67 IDBVIP (BIVAR) - INPUT VARIABLE NIP IS OUT OF RANGE
69 IDBVIP (BIVAR) - MD = 2 OR 3 BUT NDP WAS CHANGED SINCE LAST CALL
71 IDBVIP (BIVAR) - MD = 3 BUT ITY WAS CHANGED SINCE LAST CALL
73 IDBVIP (BIVAR) - MD = 3 BUT NIP WAS CHANGED SINCE LAST CALL
75 IDGETI (BIVAR) - UNCLEARED PRIOR ERROR
77 IDGETR (BIVAR) - UNCLEARED PRIOR ERROR
79 IDGETR (BIVAR) - INVALID KEYWORD: xxx
81 IDGRID (BIVAR) - INTERNAL ERROR - SEE CONSULTANT
83 IDPLTR (BIVAR) - UNCLEARED PRIOR ERROR
85 IDSETI (BIVAR) - UNCLEARED PRIOR ERROR
87 IDSETR (BIVAR) - UNCLEARED PRIOR ERROR
89 IDSETR (BIVAR) - INVALID KEYWORD: xxx
91 IDSFFT (BIVAR) - UNCLEARED PRIOR ERROR
93 IDSFFT (BIVAR) - INPUT VARIABLE MD IS OUT OF RANGE
95 IDSFFT (BIVAR) - INPUT VARIABLE NDP IS OUT OF RANGE
97 IDSFFT (BIVAR) - INPUT VARIABLE NXI OR NYI IS OUT OF RANGE
99 IDSFFT (BIVAR) - INPUT VARIABLE NZI IS LESS THAN NXI
101 IDSFFT (BIVAR) - MD = 2 OR 3 BUT NDP WAS CHANGED SINCE LAST CALL
103 IDSFFT (BIVAR) - MD = 3 BUT ITY WAS CHANGED SINCE LAST CALL
105 IDSFFT (BIVAR) - MD = 3 BUT NXI WAS CHANGED SINCE LAST CALL
107 IDSFFT (BIVAR) - MD = 3 BUT NYI WAS CHANGED SINCE LAST CALL
109 IDTANG (BIVAR) - INPUT PARAMETER NDP OUT OF RANGE
111 IDTANG (BIVAR) - TWO OF THE INPUT DATA POINTS ARE IDENTICAL
113 IDTANG (BIVAR) - ALL COLLINEAR DATA POINTS
115
117 Online: bivar_params, idbvip, idsfft, idpltr, idgeti, idgetr, idseti,
118 idsetr, ncarg_cbind
119 Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
121 Fundamentals, UNIX Version
122
124 Bivar was written by Hiroshi Akima in August 1975 and rewritten by him
125 in late 1976. In 1989, a new version of Bivar, incorporating changes
126 described in a Rocky Mountain Journal of Mathematics was obtained from
127 Dr. Akima, and included in NCAR Graphics with his permission. In 1995,
128 Dave Kennison incorporated the capability of doing linear interpolation
129 and a different kind of triangulation, put in a parameter access
130 interface, and wrote a routine to allow the triangulation to be
131 plotted.
132
134 Copyright (C) 1987-2007
135 University Corporation for Atmospheric Research
136 This documentation is free software; you can redistribute it and/or
138 modify it under the terms of the GNU General Public License as
139 published by the Free Software Foundation; either version 2 of the
140 License, or (at your option) any later version.
141 This software is distributed in the hope that it will be useful, but
143 WITHOUT ANY WARRANTY; without even the implied warranty of
144 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
145 General Public License for more details.
146 You should have received a copy of the GNU General Public License along
148 with this software; if not, write to the Free Software Foundation,
149 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
150UNIX November 1995 Bivar(3NCARG)