DSGRID2S(3NCARG)

✨ NAME ✨

DSGRID2S β€” the primary single precision Fortran entry for 2D gridding, bestie πŸ’–

So this is the one in the NCAR Graphics manual (3NCARG), and it's the main character of the Dsgrid gridding situation. Periodt.


πŸŽ€ SYNOPSIS πŸŽ€

CALL DSGRID2S (NPNTS, X, Y, Z, NUMXOUT, NUMYOUT, XO, YO, ZO, IER)

That's the whole vibe. Ten arguments, no notes. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

Okay so let's go through every single one of these, because every single one matters:

  • NPNTS (Integer, Input) β€” the number of input data points. How many points you're bringing to the party. πŸŽ‰
  • 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 functional values of the input data points. Basically, Z(L) is the value of the input function at coordinate (X(L),Y(L)), for L=1,NPNTS. So like, the actual data data. πŸ“
  • NUMXOUT (Integer, Input) β€” the number of X values in the output grid.
  • NUMYOUT (Integer, Input) β€” the number of Y values in the output grid.
  • 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 need not be equally spaced. So ascending, okay? Not necessarily evenly spaced, but ascending. Don't play with it. πŸ™ˆ
  • YO (Real, Input) β€” an array of dimension NUMYOUT holding the Y coordinates of the output data grid. Same rules, same energy: the values in YO must be increasing, but need not be equally spaced.
  • ZO (Real, Output) β€” a two-dimensional array of dimension NUMXOUT x NUMYOUT holding the interpolated functional values. ZO(I,J) is the interpolated value at grid point (XO(I),YO(J)). This is where the results show up, and they ate. πŸ‘‘
  • 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. Not me sending you to another man page but like, go read it. 😭

🌈 USAGE 🌈

DSGRID2S is the single precision gridding function for 2D data in the Dsgrid package. Its behavior is controlled by the values you set for the various parameters described over in dsgrid_params. And how do you set those values? With the subroutines DSSETI, DSSETR, and DSSETC. That's the whole control panel, bestie. ✨

Important heads-up: in almost all cases the ngmath function NATGRIDS is superior to DSGRID2S for 2D interpolation. Like, genuinely. See the man page for NATGRIDS for details. πŸ‘€

πŸ’œ ACCESS πŸ’œ

To use DSGRID2S, load the NCAR Graphics library ngmath. That's it, that's the access. 🫢


πŸ‘‘ SEE ALSO πŸ‘‘

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

Complete documentation for Dsgrid is available at URL http://ngwww.ucar.edu/ngdoc/ng/ngmath/dsgrid/dshome.html 🌐


Copyright (C) 2000 University Corporation for Atmospheric Research

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


and that's the whole page, no cap πŸ’–βœ¨πŸŽ€

This was the DSGRID2S(3NCARG) page from the NCAR GRAPHICS manual, in the UNIX section β€” dated September 1997-1998. Love that for it. Stay interpolating, bestie πŸ¦‹πŸ’…πŸŒŸ