NATGRIDS(3NCARG)

✨ NAME ✨

NATGRIDS β€” the main single precision Fortran entry point for natural neighbor gridding πŸ’– (this one lives in the NCAR GRAPHICS manual, section 3NCARG, just so you know where to find it later πŸŽ€)


🌸 SYNOPSIS 🌸

CALL NATGRIDS (NPNTS, X, Y, Z, NUMXOUT, NUMYOUT, XI, YI, ZI, IER)

that's the whole vibe bestie, one call, ten arguments, slay πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's every single thing you're passing in, no skips, we're doing this properly 🫢

  • NPNTS (Integer, Input) β€” how many input data points you've got. and like, it has to be NPNTS > 3. three or fewer? nope, not happening πŸ™ˆ
  • X (Real, Input) β€” an array holding the X coordinates of your input data points.
  • Y (Real, Input) β€” an array holding the Y coordinates of your input data points.
  • Z (Real, Input) β€” an array holding the functional values of your input data points. so like, Z(L) is the value of the input function at coordinate (X(L),Y(L)), for L=1,NPNTS. literally a one-to-one situation ✨
  • NUMXOUT (Integer, Input) β€” the number of X values in your output grid.
  • NUMYOUT (Integer, Input) β€” the number of Y values in your output grid.
  • XI (Real, Input) β€” an array of dimension NUMXOUT with the X coordinates of the output data grid. the values in XI must be increasing, but ngl they don't have to be equally spaced πŸ’«
  • YI (Real, Input) β€” an array of dimension NUMYOUT with the Y coordinates of the output data grid. same deal: the values in YI must be increasing, and again, not equally spaced is totally fine πŸ’«
  • ZI (Real, Output) β€” a two-dimensional array of dimension NUMXOUT x NUMYOUT holding the interpolated functional values. ZI(I,J) is the interpolated value at grid point (XI(I),YI(J)). this is the one you actually wanted, the main character of the output 🌟
  • IER (Integer, Output) β€” the error return value. if IER comes back as 0, then no errors were detected, we love that for you πŸŽ‰ if IER is non-zero, then go read the man page for natgrid_errors for the details, okay? don't just sit there wondering 🫠

πŸ”₯ USAGE πŸ”₯

NATGRIDS is the single precision gridding function in the Natgrid package, periodt πŸ’…

the behavior of NATGRIDS is controlled by the values you set for the various parameters described over in natgrid_params. and the way you set values for those parameters is with the subroutines NNSETI, NNSETR, and NNSETC. that's the whole pipeline, iykyk ✨


πŸ‘‘ ACCESS πŸ‘‘

to use NATGRIDS, you load the NCAR Graphics library ngmath. that's the one, that's the library, don't forget it πŸŽ€


🌈 SEE ALSO 🌈

  • natgrid
  • natgrid_params
  • nnseti
  • nngeti
  • nnsetr
  • nngetr
  • nnsetc
  • nngetc

also, full and complete documentation for Natgrid is available at this URL, go treat yourself to some reading πŸ“š:

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

Copyright (C) 2000 University Corporation for Atmospheric Research

the use of this Software is governed by a License Agreement. (yes, a whole License Agreement, read it bestie, it's giving responsible 🫢)


okay that's the whole page!! mwah πŸ’‹ this one came from the UNIX manual, dated March 1997-1998, and it lives at NATGRIDS(3NCARG) if you ever need to find it again. bye bestie, go grid something gorgeous 🌸✨πŸ’