c_dspnt3s(3NCARG)

✨ c_dspnt3s — the NCAR GRAPHICS bestie you call when you need numbers right there ✨

okay so real talk, this page is from the NCAR GRAPHICS manual, and today's main character is c_dspnt3s. she does one thing and she does it gorgeously: interpolate single precision 3D data at whatever points you point at her. 💅

🌸 NAME 🌸

c_dspnt3s — interpolate single precision 3D data at specified points. that's it, that's the whole job, and she ate. 🎀

🦋 FUNCTION PROTOTYPE 🦋

void c_dspnt3s(int, float [], float [], float [], float[]
       int, float [], float [], float [], float *, int *);

no cap, that's the prototype exactly as it lives in the docs. we do not edit, we do not "fix", we copy it character for character because that's the vibe. 💖

✨ SYNOPSIS ✨

void c_dspnt3d(int n, float xi[], float yi[], float zi[], float ui[],
               int m, float xo[], float yo[], float zo[], float *uo,
               int *ier)

yes bestie, the synopsis is showing you c_dspnt3d — that is literally what's printed and we are reproducing it verbatim, no notes. 🙈

👑 DESCRIPTION 👑

here come the parameters, one by one, no skipping, no summarizing, we are thorough in this house:

• n — the number of input data points.
• xi — an array holding the X coordinates of the input data points.
• yi — an array holding the Y coordinates of the input data points.
• zi — an array holding the Z coordinates of the input data points.
• ui — an array holding the functional values of the input data points. like, ui[l] is the value of the input function at coordinate (xi[l],yi[l],zi[l]), for 0 <= l < n.
• m — the number of output data points (and yes, this may be "1" — one singular point is still a whole vibe, we respect the solo era 🫶).
• xo — an array of dimension m holding the X coordinates of the output data. the values in xo may be in any order.
• yo — an array of dimension m holding the Y coordinates of the output data. the values in xo may be in any order.
• zo — an array of dimension m holding the Z coordinates of the output data. the values in xo may be in any order.
• uo — a pointer to a float. space for m floats is allocated for uo by dspnt3d. zo[i] is the interpolated value at point (xo[i],yo[i],zo[i]) for 0 <= i < n.
• ier — an error return value. if *ier comes back as 0, then no errors were detected — slay, clean run, iconic. if *ier is non-zero, then go refer to the man page for dsgrid_errors. 💀

🌈 USAGE 🌈

you call this function when you want to interpolate single precision 3D data at a specified point or points. that's the whole assignment. one point, twelve points, doesn't matter — she's interpolating. ✨

🧚 ACCESS 🧚

to use c_dspnt3s, load the NCAR Graphics library ngmath. that's the ticket in. 🎟️

💜 SEE ALSO 💜

• dsgrid
• dsgrid_params

complete documentation for Dsgrid is available at URL http://ngwww.ucar.edu/ngdoc/ng/ngmath/dsgrid/dshome.html — go read it, iykyk. 📚

🍓 COPYRIGHT 🍓

Copyright (C) 2000 University Corporation for Atmospheric Research

the use of this Software is governed by a License Agreement. ⚖️

lowkey important: that ier non-zero situation is not a drill — when it's not 0, go straight to dsgrid_errors. don't guess, bestie. 😭

and that's the whole page, bestie. written on UNIX, dated September 1997-1998, from the NCAR GRAPHICS manual — love her, respect her, interpolate responsibly. 💖✨🎀🦋🌸💅🫶👑