ncl_mpiola man page

MPIOLA — Given 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, this function returns the area identifier of the largest area, at a specified level, that contains it.



C-Binding Synopsis

#include <ncarg/ncargC.h>

int c_mpiola (int iaid, int ilvl)


is an input expression of type INTEGER, specifying the area identifier of a particular area of interest.
is an input expression of type INTEGER, specifying the level of the containing area to be found.

C-Binding Description

The C-binding argument description is the same as the FORTRAN argument description.


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, 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".


Use the ncargex command to see the following relevant examples: mpex11, mpex12.


To use MPIOLA or c_mpiola, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

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