c_dsgrid3d(3NCARG)

💖 c_dsgrid3d — bestie, it's the 3D gridding girlie 💖

okay so this is a page from the NCAR GRAPHICS manual, and today we're talking about c_dsgrid3d(3NCARG) — the primary double precision C entry point for 3D gridding. yes she does the whole "scattered points in, pretty grid out" thing. no cap. ✨

---

🌸 NAME 🌸

c_dsgrid3d — the primary double precision C entry for 3D gridding. that's her. that's the whole job description. 🫶

---

🎀 FUNCTION PROTOTYPE 🎀

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

---

✨ SYNOPSIS ✨

double *c_dsgrid3d(int n, double x[], double y[], double z[],
          double u[], int nx, int ny, int nz, double xo[],
          double yo[], double zo[], int *ier);

---

💅 DESCRIPTION 💅

okay bestie, here's the tea on every single argument. nothing skipped, we're being thorough because we love being thorough 💜

• n — how many input data points you're feeding her. the count. the headcount. 🍓
• x — an array holding the X coordinates of your input data points.
• y — an array holding the Y coordinates of your input data points.
• z — an array holding the Z coordinates of your input data points.
• u — an array of size n with the functional values of the input data points. so like, z[m] is the value of the input function at coordinate (x[m],y[m],z[m]), for 0 <= m < n. (yes, that's exactly how the original says it, i'm not touching it, it's iconic 😭)
• nx — the number of X values in the output grid.
• ny — the number of Y values in the output grid.
• nz — the number of Z values in the output grid.
• xo — an array of size nx with the X coordinates of the output data grid. the values in xo must be increasing, but lowkey they don't have to be equally spaced. 📈
• yo — an array of size ny with the Y coordinates of the output data grid. values in yo must be increasing, equally spaced not required. 💫
• zo — an array of size nz with the Z coordinates of the output data grid. values in zo must be increasing, equally spaced not required either. 👑
• ier — the error return value. if *ier comes back as 0, then no errors were detected, we're slaying, nothing to see here ✨. if *ier is non-zero, then run don't walk to the man page for dsgrid_errors. 💀

---

🌈 USAGE 🌈

c_dsgrid3d returns a pointer to a linear array of data that is the interpolated grid, stored in row-major order. that's the vibe. 💫

so if out is declared as

double *out;

and we set:

out = *c_dsgrid3d(n, x, y, z, u, nx, ny, nz, xo, yo, zo, ier);

then out[nz*ny*i + nz*j + k] is the interpolated function value at coordinate point (xo[i],yo[j],zo[k]) for 0 <= i < nx, 0 <= j < ny, and 0 <= k < nz. 🧮

and the space for out? it's allocated internal to c_dsgrid3d and it's nx*ny*nz doubles in size. she provides. periodt. 💅

---

🦋 ACCESS 🦋

to use c_dsgrid3d, load the NCAR Graphics library ngmath. that's the whole access situation, bestie. 🎀

---

👑 SEE ALSO 👑

go read these too, they're all part of the family:

• dsgrid
• dsgrid_params
• c_dsseti
• c_dsgeti
• c_dssetrd
• c_dsgetrd
• c_dssetc
• c_dsgetc

and fr fr, complete documentation for Dsgrid is available at URL:

http://ngwww.ucar.edu/ngdoc/ng/ngmath/dsgrid/dshome.html

---

💜 COPYRIGHT 💜

Copyright (C) 2000 University Corporation for Atmospheric Research

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

---

⚠️ heads up bestie: that license agreement line is not decoration, it's real. use of this software is governed by it. respect the paperwork. 📜

---

and that's the whole page!! 💖 this one's from the UNIX manual, dated September 1997-1998, and it lives under the name c_dsgrid3d(3NCARG). go forth and grid in 3D, you absolute main character 🫶✨🎀