MPISCI(3NCARG)

💅 MPISCI — NCAR GRAPHICS, bestie edition 🎀

okay so real quick, this is MPISCI(3NCARG) from the NCAR Graphics manual, and it's genuinely one of the cutest little functions in the whole EZMAPB lineup, i promise.

---

✨ NAME ✨

MPISCI — bestie, listen: 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 a suggested color index for that area. that's it. that's the whole job. iconic behavior honestly 💖

---

🌸 SYNOPSIS 🌸

ISCI=MPISCI(IAIN)

---

🦋 C-BINDING SYNOPSIS 🦋

#include <ncarg/ncargC.h>

int c_mpisci (int iain)

---

✨ DESCRIPTION ✨

• IAIN — an input expression of type INTEGER, specifying the area identifier of a particular area of interest. like, which area are we talking about, bestie? this is how you tell it. 🎯

---

💜 C-BINDING DESCRIPTION 💜

ngl the C-binding argument description is literally the same as the FORTRAN argument description. no notes, no changes, same vibe. 🫶

---

🔥 USAGE 🔥

okay so the statement "ISCI=MPISCI(IAIN)" retrieves in ISCI the suggested color index for the area with area identifier IAIN. 🎨

for example — and this is my favorite part — if IMAD is the area identifier of the little island in Lake Superior called "Lake Madeline", then MPISCI(IMAD) has the value 6. slay. 💅

and the way the suggested color indices work? they're defined in such a way as to ensure that areas that touch each other have different color indices. no matching outfits for neighbors, periodt. 🚫👯

so if you want a suggested color index for the area, at a specified level, that contains the area with a specified area identifier, you use MPISCI in combination with MPIOAR (which see 👀). for example:

• MPISCI(MPIOAR(IMAD,4)) has the value 6, which is the color index for "Wisconsin" or any portion thereof
• MPISCI(MPIOAR(IMAD,2)) = 5, which is the color index for "North America"

like, the way that one tiny island can zoom out into a whole continent's color index?? main character energy fr fr 🌎✨

---

🎀 EXAMPLES 🎀

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

---

🌈 ACCESS 🌈

to use MPISCI or c_mpisci, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order. yes, in that order, bestie, don't be chaotic about it. 😌

---

💖 SEE ALSO 💖

Online, and yes this is a long list, but every single one of them matters:

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, mpiosa, mpipai, mpipan, mpipar, 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.

---

and that's the whole page, bestie. go forth and color those areas correctly. 🧚💜

signing off from the UNIX corner of the manual — page dated April 1998, manual tag MPISCI(3NCARG), and yes she's still serving looks decades later. bye babes 💖✨🎀