MPIOSA(3NCARG)

💖 MPIOSA 💖 (that's MPIOSA(3NCARG) bestie, from the NCAR GRAPHICS manual)

okay so picture this: you've got areas. like, map areas. and you want to know which big area contains your little area. that's it. that's the whole girl. she's from NCAR GRAPHICS and she is so useful.

---

✨ NAME ✨

MPIOSA — okay so you give her 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 she hands you back the area identifier of the smallest area, at a specified level, that contains it. like a lil nesting doll situation. 🪆

---

🌸 SYNOPSIS 🌸

IOSA=MPIOSA(IAIN,ILVL)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

int c_mpiosa (int iaid, int ilvl)

---

💅 DESCRIPTION 💅

• IAIN — an input expression of type INTEGER, specifying the area identifier of a particular area of interest. this is your girl, your target, the one you're asking about 👀
• ILVL — an input expression of type INTEGER, specifying the level of the containing area to be found. like, how far up the family tree do you wanna go 🌳

---

🎀 C-BINDING DESCRIPTION 🎀

the C-binding argument description is the same as the FORTRAN argument description. literally identical. no notes. 💖

---

👑 USAGE 👑

so the statement "IOSA=MPIOSA(IAIN,ILVL)" retrieves in IOSA the area identifier of that area, at level ILVL, that contains the area with area identifier IAIN.

and here's the example they gave that honestly ATE: if IMAD is the area identifier of the little island in Lake Superior called "Lake Madeline", then MPIOSA(IMAD,3) is the area identifier of the area called "Conterminous US". like bestie went from a tiny island to the ENTIRE country in one function call. main character energy fr fr 🔥

---

🌈 EXAMPLES 🌈

use the ncargex command to see the following relevant examples: mpex11, mpex12. go look at them, they're cute 🫶

---

⭐ ACCESS ⭐

to use MPIOSA or c_mpiosa, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. don't be chaotic about the order, she's sensitive 💀

---

💜 SEE ALSO 💜

online, bestie, you've got a whole friend group:

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, mpiola, mpipai, mpipan, mpipar, mpisci, mplnam, mplndm, mplndr, mplnri, mpname, mprset, mpsetc, mpseti, mpsetl, mpsetr, supmap, supcon, ncarg_cbind

like I said. whole friend group. 💕

---

📜 COPYRIGHT 📜

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

---

and that's the tea ☕ always check the license agreement bestie, it's giving legally binding 💅

---

okay bye ily, this page came from the UNIX manual, MPIOSA(3NCARG), dated April 1998 — yeah she's an elder but she's still iconic, periodt 💖✨🎀