DSGRID3S(3NCARG)

💖 DSGRID3S — single precision Fortran entry for 3D gridding 💖

okay bestie, sit down, hydrate, because we're about to talk about DSGRID3S, a lil Fortran subroutine from the NCAR GRAPHICS manual (that's section 3NCARG, iykyk). she's a single-precision queen and she does 3D gridding. no cap.

✨ NAME ✨

DSGRID3S — the single precision Fortran entry for 3D gridding. that's the whole vibe. that's her whole thing. 👑

✨ SYNOPSIS ✨

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

like yes she takes a LOT of arguments. she's high maintenance but she's worth it. 💅

✨ DESCRIPTION ✨

okay so here's the cast of characters, one by one, no skipping, we respect all of them:

• NPNTS (Integer, Input) — how many input data points we're working with. the headcount. the guest list. 🎀
• X (Real, Input) — an array holding the X coordinates of the input data points.
• Y (Real, Input) — an array holding the Y coordinates of the input data points.
• Z (Real, Input) — an array holding the Z coordinates of the input data points. yes bestie, three dimensions, we're living in a 3D world and she eats every time. 🦋
• U (Real, Input) — an array holding the functional values of the input data points. so like, U(L) is the value of the input function at coordinate (X(L),Y(L),Z(L)), for L=1,NPNTS. she's mapping points to values. that's the whole plot of the movie. 🌸
• 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. (three of them. because 3D. she's consistent and we love that for her.) 💜
• XO (Real, 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 need to be equally spaced. she's flexible like that, but she does have boundaries.
• YO (Real, Input) — an array of dimension NUMYOUT holding the Y coordinates of the output data grid. ⚠️ values in YO must be increasing, but again, not necessarily equally spaced. bestie said monotonic or nothing. 😭
• ZO (Real, Input) — an array of dimension NUMZOUT holding the Z coordinates of the output data grid. ⚠️ values in ZO must be increasing, and once more, no equal-spacing requirement. the grid is giving "curated but ordered". ✨
• UO (Real, 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. the main character moment. the output. 🔥
• IER (Integer, Output) — the error return value. if IER comes back as 0, then no errors were detected, slay. if IER is non-zero, then go read the man page for dsgrid_errors for the details. she's not gonna explain herself in public, okay? 🙈

✨ USAGE ✨

DSGRID3S is the single precision gridding function in the Dsgrid package. periodt.

the behavior of DSGRID3S is controlled by values set for the various parameters described over in dsgrid_params. and how do you set those values, you ask? with the subroutines DSSETI, DSSETR, and DSSETC. that's the trio. that's the friend group. 🫶

✨ ACCESS ✨

to use DSGRID3S, you gotta load the NCAR Graphics library ngmath. that's the door, that's the key, that's the whole entry requirement. 🔑

✨ SEE ALSO ✨

• dsgrid
• dsgrid_params
• dsseti
• dsgeti
• dssetr
• dsgetr
• dssetc
• dsgetc

and if you want the FULL lore, the complete documentation for Dsgrid is available at this URL:

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

go read it bestie, it's giving ✨comprehensive✨.

✨ COPYRIGHT ✨

Copyright (C) 2000
University Corporation for Atmospheric Research

the use of this Software is governed by a License Agreement. read it, respect it, we don't play about licenses. 💜

ok that's the whole page, you ate that. 💅

and that's a wrap on the NCAR GRAPHICS DSGRID3S(3NCARG) era — written down as UNIX, dated September 1997-1998, and forever iconic. bye bestie, go grid something in 3D 🎀✨💖