IDBVIP(3NCARG)

πŸ“¦ version 6.6.2, in epel 9, fedora 43, fedora 44

✨ IDBVIP β€” it's giving "fill in the blanks but make it math" ✨

okay bestie so this is a page from the NCAR GRAPHICS manual set, and the star of the show is IDBVIP πŸ’– she's a FORTRAN-callable bivariate interpolation icon and honestly? she eats.


🌸 NAME 🌸

IDBVIP</purgle> β€” produces interpolated values at points (XI(I), YI(I)), I=1,...,NIP. This is useful for filling in missing data points on a grid. no cap, that's literally her whole job and she does it flawlessly πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

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

πŸ¦‹ C-BINDING SYNOPSIS πŸ¦‹

#include <ncarg/ncargC.h>

void c_idbvip (int md, int ndp, float *xd, float *yd,
float *zd, int nip, float *xi, float *yi, float *zi,
int *iwk, float *wk)

✨ DESCRIPTION ✨

okay so here's the tea on every single argument, and yes we're going through all of them because she deserves it 🫢

  • MD β€” the mode of computation. must be 1, 2, or 3, otherwise an error return occurs. periodt. Here's the vibe check on each one:
    • 1 β€” use this if it's the first call to this subroutine, or if the value of NDP has been changed from the previous call, or if the contents of the XD or YD arrays have been changed from the previous call.
    • 2 β€” use this if the values of NDP and the XD and YD arrays are unchanged from the previous call, but new values for XI, YI are being used. > careful bestie: if MD = 2 and NDP has been changed since the previous call to IDBVIP, an error return occurs. πŸ’€
    • 3 β€” use this if the values of NDP, NIP, XD, YD, XI, YI are unchanged from the previous call, i.e. if the only change on input to IDBVIP is in the ZD array. > and again: if MD=3 and NDP or NIP has been changed since the previous call to IDBVIP, an error return occurs. πŸ™ˆ
    • Between the call with MD=2 or MD=3 and the preceding call, the IWK and WK work arrays should not be disturbed. hands off, bestie 🚫
  • NDP β€” number of data points. must be 4 or greater, else an error return occurs.
  • XD β€” array of dimension NDP containing the X coordinates of the data points.
  • YD β€” array of dimension NDP containing the Y coordinates of the data points.
  • ZD β€” array of dimension NDP containing the Z coordinates of the data points.
  • NIP β€” the number of output points at which interpolation is to be performed. must be 1 or greater, else an error return occurs.
  • XI β€” array of dimension NIP containing the X coordinates of the output points.
  • YI β€” array of dimension NIP containing the Y coordinates of the output points.
  • IWK β€” integer work array of dimension at least 31*NDP + NIP.
  • WK β€” real work array of dimension at least 8*NDP.
  • ZI β€” array of dimension NIP where interpolated Z values are to be stored. this is the moment she's been waiting for, the whole main character reveal πŸ‘‘
⚠️ Inadequate work space IWK and WK may cause incorrect results. do not skimp on the work arrays, I am begging 😭
⚠️ The data points must be distinct and their projections in the X-Y plane must not be collinear, otherwise an error return occurs. that's the vibe check and if you fail it she's sending you home 🧚

🌈 C-BINDING DESCRIPTION 🌈

The C-binding argument descriptions are the same as the FORTRAN argument descriptions. literally identical, we said what we said πŸ’œ


πŸ“ EXAMPLES πŸ“

To use Bivar routines, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. order matters, don't fight it πŸ’…


πŸ‘‘ ACCESS πŸ‘‘

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


πŸ’– MESSAGES πŸ’–

See the bivar man page for a description of all Bivar error messages and/or informational messages. she has a whole extended universe, go read it πŸ“š


🌸 SEE ALSO 🌸

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

the whole friend group fr fr 🫢


⭐ ACKNOWLEDGMENTS ⭐

Bivar was written by Hiroshi Akima in August 1975 and rewritten by him in late 1976. In 1989, a new version of Bivar, incorporating changes described in a Rocky Mountain Journal of Mathematics, was obtained from Dr. Akima, and included in NCAR Graphics with his permission. In 1995, Dave Kennison incorporated the capability of doing linear interpolation and a different kind of triangulation, put in a parameter access interface, and wrote a routine to allow the triangulation to be plotted. legends only, we love a glow-up arc ✨


Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.

okay and that's the whole page bestie πŸ’… this was the UNIX version from November 1995, filed under IDBVIP(3NCARG) β€” go interpolate something iconic, ily, byeee πŸ¦‹βœ¨

πŸ“¦ where this page comes from