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

NAME

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

SYNOPSIS

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
19       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
23       IDPLTR      Plots the triangulation of the data points.
24
25       IDGETI      Retrieves the integer value of a Bivar parameter.
26
27       IDGETR      Retrieves the real value of a Bivar parameter.
28
29       IDSETI      Provides a new integer value for a Bivar parameter.
30
31       IDSETR      Provides a new real value for a Bivar parameter.
32

C-BINDING SYNOPSIS

34       c_idbvip,
35       c_idsfft
36       c_idpltr
37       c_idgeti
38       c_idgetr
39       c_idseti
40       c_idsetr
41

EXAMPLES

43       See the example "cbex01".
44

ACCESS

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
49

MESSAGES

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
57       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
62       IDBVIP (BIVAR) - UNCLEARED PRIOR ERROR
63
64       IDBVIP (BIVAR) - INPUT VARIABLE MD IS OUT OF RANGE
65
66       IDBVIP (BIVAR) - INPUT VARIABLE NDP IS OUT OF RANGE
67
68       IDBVIP (BIVAR) - INPUT VARIABLE NIP IS OUT OF RANGE
69
70       IDBVIP (BIVAR) - MD = 2 OR 3 BUT NDP WAS CHANGED SINCE LAST CALL
71
72       IDBVIP (BIVAR) - MD = 3 BUT ITY WAS CHANGED SINCE LAST CALL
73
74       IDBVIP (BIVAR) - MD = 3 BUT NIP WAS CHANGED SINCE LAST CALL
75
76       IDGETI (BIVAR) - UNCLEARED PRIOR ERROR
77
78       IDGETR (BIVAR) - UNCLEARED PRIOR ERROR
79
80       IDGETR (BIVAR) - INVALID KEYWORD: xxx
81
82       IDGRID (BIVAR) - INTERNAL ERROR - SEE CONSULTANT
83
84       IDPLTR (BIVAR) - UNCLEARED PRIOR ERROR
85
86       IDSETI (BIVAR) - UNCLEARED PRIOR ERROR
87
88       IDSETR (BIVAR) - UNCLEARED PRIOR ERROR
89
90       IDSETR (BIVAR) - INVALID KEYWORD: xxx
91
92       IDSFFT (BIVAR) - UNCLEARED PRIOR ERROR
93
94       IDSFFT (BIVAR) - INPUT VARIABLE MD IS OUT OF RANGE
95
96       IDSFFT (BIVAR) - INPUT VARIABLE NDP IS OUT OF RANGE
97
98       IDSFFT (BIVAR) - INPUT VARIABLE NXI OR NYI IS OUT OF RANGE
99
100       IDSFFT (BIVAR) - INPUT VARIABLE NZI IS LESS THAN NXI
101
102       IDSFFT (BIVAR) - MD = 2 OR 3 BUT NDP WAS CHANGED SINCE LAST CALL
103
104       IDSFFT (BIVAR) - MD = 3 BUT ITY WAS CHANGED SINCE LAST CALL
105
106       IDSFFT (BIVAR) - MD = 3 BUT NXI WAS CHANGED SINCE LAST CALL
107
108       IDSFFT (BIVAR) - MD = 3 BUT NYI WAS CHANGED SINCE LAST CALL
109
110       IDTANG (BIVAR) - INPUT PARAMETER NDP OUT OF RANGE
111
112       IDTANG (BIVAR) - TWO OF THE INPUT DATA POINTS ARE IDENTICAL
113
114       IDTANG (BIVAR) - ALL COLLINEAR DATA POINTS
115

SEE ALSO

117       Online: bivar_params, idbvip, idsfft, idpltr, idgeti, idgetr, idseti,
118       idsetr, ncarg_cbind
119
120       Hardcopy: NCAR Graphics Contouring and Mapping Tutorial; NCAR Graphics
121       Fundamentals, UNIX Version
122

ACKNOWLEDGMENTS

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-2009
135       University Corporation for Atmospheric Research
136       The use of this Software is governed by a License Agreement.
137
138
139
140UNIX                             November 1995                   Bivar(3NCARG)
Impressum