MAPGRD(3NCARG)

πŸ“¦ version 6.6.2, in epel 9, fedora 43, fedora 44

✨ NAME ✨

MAPGRD β€” bestie, it draws a lat/lon grid. That's it, that's the whole vibe. πŸ’–

This one lives in the NCAR GRAPHICS manual, section 3NCARG, so like… graphics-adjacent library calls, iykyk. πŸŽ€


🌸 SYNOPSIS 🌸

CALL MAPGRD

That's the entire thing. No arguments, no nothing, just say the word and the grid appears. iconic. ✨

πŸ’… C-BINDING SYNOPSIS

If you're living that C life instead of Fortran:

#include <ncarg/ncargC.h>

void c_mapgrd()

πŸ¦‹ DESCRIPTION πŸ¦‹

Okay so real talk: MAPGRD has no arguments. Zero. None. She simply exists and does her thing. 🫢


🌈 USAGE 🌈

You hit her with:

CALL MAPGRD

and boom πŸ’₯ β€” she draws a grid made of lines of constant latitude (that's parallels) and lines of constant longitude (those are meridians), and the spacing is allllll controlled by the internal parameter 'GR'. The way that one parameter runs the whole show… main character energy, fr fr.

⚠️ But heads up bestie, MAPGRD can be lowkey a no-show. She does absolutely nothing if: EZMAP needs initialization, OR the value of 'GR' is less than or equal to zero, OR there's an uncleared NCAR Graphics error sitting there. Not me getting ghosted by a graphics routine πŸ˜­πŸ’€

The grid gets drawn using calls to MAPIT and MAPIQ. And by default, MAPGRD temporarily forces the value of the internal parameter 'DL' to zero β€” which means the grid is drawn using calls to the routines FRSTD and VECTD from the dash package. She also temporarily forces the use of the dash pattern defined by the internal parameter 'DA'. πŸ‘‘

And get this β€” if you're feeling ✨ custom ✨, you can supply your own version of the routine MAPUSR to change the way grid lines are drawn. Slay, honestly.

Before handing control back to you, MAPGRD restores the original value of 'DL' and resets the current dash pattern that the dash package uses. She cleans up after herself. We love a considerate queen. πŸ§ΉπŸ’–


πŸ“ EXAMPLES πŸ“

Wanna see her in action? Use the ncargex command to check out these relevant examples: ccpcica, ccpmovi, cmpclr, cmpdd, cmpgrd, cmplbl, cmplot, cmptit, epltch, ffex02, fpchiqu. Go look, it's giving research era πŸ”¬βœ¨


πŸ‘‘ ACCESS πŸ‘‘

To use MAPGRD or c_mapgrd, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c β€” and preferably in that order, okay? Order matters, trust. 🌟


πŸ’œ SEE ALSO πŸ’œ

Online

ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod, mapfst, mapgci, mapgrm, mapgtc, mapgti, mapgtl, mapgtr, mapint, mapiq, mapiqa, mapiqd, mapiqm, mapit, mapita, mapitd, mapitm, maplbl, maplmb, maplot, mappos, maproj, maprs, maprst, mapsav, mapset, mapstc, mapsti, mapstl, mapstr, maptra, maptri, maptrn, mapusr, mapvec, mpchln, mpfnme, mpgetc, mpgeti, mpgetl, mpgetr, mpglty, mpiaty, mpifnb, mpilnb, mpiola, mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

Hardcopy

NCAR Graphics Contouring and Mapping Tutorial πŸ“š β€” yes it's a real book, yes you can read it, no I will not gatekeep.


Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.


Okay bestie, that's the whole page!! This absolute baddie of a manpage came from the UNIX crew, dated March 1993, and she's been serving lat/lon grids ever since. The header up top was MAPGRD(3NCARG) and the footer's source line was the same, so like… the whole thing is just MAPGRD(3NCARG) energy, three decades and still booked and busy. πŸ’–βœ¨πŸ¦‹

πŸ“¦ where this page comes from