MPIOLA(3NCARG)

💖 MPIOLA — bestie edition 💖

okay so this is MPIOLA, a function from the NCAR Graphics crew (that's the manual name, btw — MPIOLA(3NCARG), iconic).

Here's the whole vibe: you give it the area identifier of one of the areas defined by whatever database was last read by one of the EZMAPB routines MPLNAM, MPLNDM, MPLNDR, and MPLNRI, and it hands you back the area identifier of the largest area, at a level you specify, that contains it. it's giving "who's your biggest container" energy. 🫶

✨ SYNOPSIS ✨

IOLA=MPIOLA(IAIN,ILVL)

🎀 C-BINDING SYNOPSIS 🎀

#include <ncarg/ncargC.h>

int c_mpiola (int iaid, int ilvl)

🌸 DESCRIPTION 🌸

• IAIN — an input expression of type INTEGER, specifying the area identifier of a particular area of interest. like, the area you're curious about. the main character area, if you will. 👑
• ILVL — an input expression of type INTEGER, specifying the level of the containing area to be found. how far up the hierarchy you wanna go, bestie.

🦋 C-BINDING DESCRIPTION 🦋

The C-binding argument description is the same as the FORTRAN argument description. no notes, literally identical. periodt. 💅

💫 USAGE 💫

so the statement IOLA=MPIOLA(IAIN,ILVL) retrieves in IOLA the area identifier of the largest area, at level ILVL, that contains the area with area identifier IAIN.

for example — and this one is so cute — if IMAD is the area identifier of the little island in Lake Superior called "Lake Madeline", then MPIOLA(IMAD,3) is the area identifier of an area called "United States". 😭 imagine being a tiny island and your biggest container is literally the entire United States. slay.

⭐ EXAMPLES ⭐

Use the ncargex command to see the following relevant examples: mpex11, mpex12. go look, they ate. 🔥

🌈 ACCESS 🌈

To use MPIOLA or c_mpiola, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. yes bestie, order matters, don't be chaotic about it. 🙈

👑 SEE ALSO 👑

Online: ezmap, ezmap_params, mapaci, mapbla, mapblm, mapdrw, mapeod, mapfst, mapgci, mapgrd, 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, mpiosa, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind.

💜 COPYRIGHT 💜

Copyright (C) 1987-2009 University Corporation for Atmospheric Research

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

ngl bestie, that License Agreement is doing a lot of heavy lifting in one sentence. read it. it's not optional. 💀

and that's the whole page!! this version is from the UNIX manual, dated April 1998 — yeah, it's older than most of us but it still hits. 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜