NATGRIDD(3NCARG)

✨ NATGRIDD ✨ (a.k.a. NATGRIDD(3NCARG) from the NCAR GRAPHICS fam)

okay bestie, so this is the primary double precision Fortran entry for natural neighbor gridding πŸ’… and honestly? she's iconic. this page lives in the NCAR Graphics manual and it's about to be your whole personality.


🌸 SYNOPSIS 🌸

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

that's the whole vibe. one call, ten arguments, no cap. 🫢


πŸ’– DESCRIPTION πŸ’–

so here's the tea on every single argument, and yes, we're doing all of them:

  • NPNTS β€” (Integer, Input) the number of input data points. and listen, NPNTS > 3. the original literally wrote that in parens. so four or more, bestie. don't try it with three. πŸ™ˆ
  • 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 functional values of your input data points. translation: Z(L) is the value of the input function at coordinate (X(L),Y(L)), for L=1,NPNTS. so for every L from 1 to NPNTS, X, Y and Z all line up like a lil trio. πŸŽ€
  • NUMXOUT β€” (Integer, Input) how many X values are chillin' in your output grid.
  • NUMYOUT β€” (Integer, Input) how many Y values are chillin' in your output grid.
  • XI β€” (Double precision, Input) an array of dimension NUMXOUT holding the X coordinates of the output data grid. the values in XI must be increasing, but they don't have to be equally spaced β€” she's flexible like that. ✨
  • YI β€” (Double precision, Input) an array of dimension NUMYOUT holding the Y coordinates of the output data grid. same rule: the values in YI must be increasing, but not necessarily equally spaced. πŸ’«
  • ZI β€” (Double precision, Output) a two-dimensional array of dimension NUMXOUT x NUMYOUT holding the interpolated functional values. specifically, ZI(I,J) is the interpolated value at grid point (XI(I),YI(J)). this is the moment. this is the main character. πŸ‘‘
  • IER β€” (Integer, Output) the error return value. if IER comes back as 0, then no errors were detected β€” slay, clean run, we love to see it. 🌈 if IER is non-zero, then go read the man page for natgrid_errors for the details, because that's where the receipts live. πŸ‘€

πŸ¦‹ USAGE πŸ¦‹

NATGRIDD is the double precision gridding function in the Natgrid package. periodt. πŸ’…

the behavior of NATGRIDD is controlled by values set for the various parameters described over in natgrid_params. and how do you set those values, you ask? with the subroutines NNSETI, NNSETRD, and NNSETC. that's the whole flow. iykyk. 🧚


🌟 ACCESS 🌟

to use NATGRIDD, load the NCAR Graphics library ngmath. that's it, that's the step. πŸ”₯


πŸ‘‘ SEE ALSO πŸ‘‘

go read these next, bestie, they're all part of the lore:

  • natgrid
  • natgrid_params
  • nnseti
  • nngeti
  • nnsetrd
  • nngetrd
  • nnsetc
  • nngetc

also!! complete documentation for Natgrid is available at this URL, copy it exactly:

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.

real talk bestie: this isn't a "do whatever" situation β€” the use of this Software is governed by a License Agreement, so check it before you go wild. πŸ’€

and that's the page!! πŸŒΈπŸ¦‹πŸ’– this was NATGRIDD(3NCARG) from NCAR GRAPHICS, dated March 1997-1998, living in the UNIX manual section. go forth and grid naturally, queen. πŸŽ€πŸ‘‘βœ¨