c_natgridd(3NCARG)

💖 c_natgridd — bestie edition 💖

okay so this is the NCAR GRAPHICS page for c_natgridd(3NCARG), and honestly? she's that girl. it's the double precision C entry point for natural neighbor gridding. let's get into it 🦋

---

✨ NAME ✨

c_natgrids — primary double precision C entry for natural neighbor gridding

(yes bestie, the NAME section really does say c_natgrids. that's just what it says. i don't make the rules 💅)

---

🧚 FUNCTION PROTOTYPE 🧚

double  *c_natgridd(int, double [], double [], double [],
                    int, int, double [], double [], int *);

---

🌸 SYNOPSIS 🌸

double *c_natgridd (npnts, x, y, z, numxout, numyout, xi, yi, ier);

---

👑 DESCRIPTION 👑

here's the whole cast, no skips, no cuts ✨

• npnts — the number of input data points. and it has to be npnts > 3. like, more than three. that's the vibe check and it is not optional 😤
• x — an array holding the x coordinates of the input data points.
• y — an array holding the y coordinates of the input data points.
• z — an array holding the functional values of the input data points. so basically z[m] is the value of the input function at coordinate (x[m],y[m]), for 0 <= m < npnts. cute right?
• numxout — the number of x values in the output grid.
• numyout — the number of y values in the output grid.
• xi — an array of dimension numxout containing the x coordinates of the output data grid. the values in xi must be increasing, but they do not need to be equally spaced. flexible queen 💅
• yi — an array of dimension numyout containing the y coordinates of the output data grid. the values in yi must be increasing, but they do not need to be equally spaced either. same energy, different axis ✨
• ier — an error value. if *ier is 0, then no errors were detected, we're thriving 🎀. if *ier is non-zero, then go read the man page for natgrid_errors for the details. that's where the lore lives.

---

🔥 USAGE 🔥

okay so c_natgridd returns a pointer to a linear array of data that is the interpolated grid, stored in row-major order. let me set the scene:

if out is declared as

double *out;

and we set:

out = c_natgridd(numin, x, y, z, numxout, numyout, xo, yo, &ier);

then out[i*numyout+j] is the interpolated function value at coordinate point (xo[i],yo[j]) for 0 <= i < numxout and 0 <= j < numyout. 🫶

and here's the part where she's lowkey generous: the space for out is allocated internal to c_natgrids, and it is numxout*numyout double values in size. no cap. you don't gotta malloc that yourself. iconic behavior honestly 💜

---

🌈 ACCESS 🌈

to use c_natgridd, load the NCAR Graphics library ngmath. that's it. that's the whole step. periodt ✨

---

🎀 SEE ALSO 🎀

go read these too, they're all in the same friend group:

• natgrid
• natgrid_params
• c_nnseti
• c_nngeti
• c_nnsetrd
• c_nngetrd
• c_nnsetc
• c_nngetc

also! complete documentation for Natgrid is available at URL

http://ngwww.ucar.edu/ngdoc/ng/ngmath/natgrid/nnhome.html

---

💀 COPYRIGHT 💀

Copyright (C) 2000
University Corporation for Atmospheric Research

The use of this Software is governed by a License Agreement.

bestie. please. the use of this software is governed by a License Agreement. read it. i'm begging 🙈

---

and that's the whole page, start to finish, nothing skipped, every flag and every word intact 🦋💖

this has been c_natgridd(3NCARG) from the UNIX manual pages, March 1997-1998 vintage — an absolute era, no notes, ate and left no crumbs 👑✨ bye bestie 🎀