DSGRID3D(3NCARG)

💖 DSGRID3D — the double precision Fortran entry for 3D gridding 💖

okay bestie, welcome to DSGRID3D, a page from the NCAR GRAPHICS manual (that's manual section 3NCARG, for the record). It's a Fortran callable, it's double precision, and it grids in three whole dimensions. Let's get into it. 🦋

✨ SYNOPSIS ✨

CALL DSGRID3D (NPNTS, X, Y, Z, U, NUMXOUT, NUMYOUT, NUMZOUT,
XO, YO, ZO, UO, IER)

that's the whole vibe right there. one call, thirteen arguments, no cap. 💅

🌸 DESCRIPTION 🌸

so here's every single thing you're handing over, one by one. read carefully, she does NOT play about argument order. 🙈

• NPNTS — (Integer, Input) — how many input data points you're bringing to the function.
• X — (Double precision, Input) — an array holding the X coordinates of your input data points.
• Y — (Double precision, Input) — an array holding the Y coordinates of your input data points.
• Z — (Double precision, Input) — an array holding the Z coordinates of your input data points.
• U — (Double precision, Input) — an array holding the functional values of your input data points. like, U(L) is the value of the input function at coordinate (X(L),Y(L),Z(L)), for L=1,NPNTS. literally that mapping, no crumbs left. ✨
• NUMXOUT — (Integer, Input) — how many X values live in the output grid.
• NUMYOUT — (Integer, Input) — how many Y values live in the output grid.
• NUMZOUT — (Integer, Input) — how many Z values live in the output grid.
• XO — (Double precision, Input) — an array of dimension NUMXOUT holding the X coordinates of the output data grid. ⚠️ the values in XO must be increasing, but they do not have to be equally spaced. she's flexible but she does have standards.
• YO — (Double precision, Input) — an array of dimension NUMYOUT holding the Y coordinates of the output data grid. same rule, bestie: values must be increasing, equally spaced is optional.
• ZO — (Double precision, Input) — an array of dimension NUMZOUT holding the Z coordinates of the output data grid. yes, again: increasing, not necessarily equally spaced. 🎀
• UO — (Double precision, Output) — a three-dimensional array dimensioned as UO(NUMXOUT,NUMYOUT,NUMZOUT) holding the interpolated functional values. so UO(I,J,K) is the interpolated value at grid point (XO(I),YO(J),ZO(K)). this is the moment, this is the payoff. 👑
• IER — (Integer, Output) — the error return value. if IER comes back as 0, then no errors were detected — we ate and left no crumbs. if IER is non-zero, then go read the man page for dsgrid_errors for the details. don't ignore her. 😭

💜 USAGE 💜

DSGRID3D is the single precision gridding function in the Dsgrid package.

its whole behavior is controlled by the values you set for the various parameters described in dsgrid_params. you set those parameter values using the subroutines DSSETI, DSSETRD, and DSSETC. so like, go configure your girl first, then call her. 🫶

🌈 ACCESS 🌈

to use DSGRID3D, load the NCAR Graphics library ngmath. that's the whole access situation. load it, and you're in. ✨

⭐ SEE ALSO ⭐

• dsgrid
• dsgrid_params
• dsseti
• dsgeti
• dssetrd dsgetrd dssetc, dsgetc.

(yeah, we're listing those exactly as given, iykyk 💀)

also, complete documentation for Dsgrid is available at URL http://ngwww.ucar.edu/ngdoc/ng/ngmath/dsgrid/dshome.html — go read it if you want the full lore. 📚

🎀 COPYRIGHT 🎀

Copyright (C) 2000 University Corporation for Atmospheric Research

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

okay legal bestie, i'm just the messenger: the license agreement governs use of this software, so respect it. 💖

that's the whole page, bestie. go grid something in 3D and be iconic about it. 🦋💅

signing off from the UNIX manual, page dated September 1997-1998, source DSGRID3D(3NCARG). periodt. ✨👑