NAME

       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.

SYNOPSIS

       IOLA=MPIOLA(IAIN,ILVL)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       int c_mpiola (int iaid, int ilvl)

DESCRIPTION

       IAIN        is  an  input expression of type INTEGER, specifying the area identifier of a particular area
                   of interest.

       ILVL        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.

USAGE

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

EXAMPLES

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

ACCESS

       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

COPYRIGHT

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

UNIX                                               April 1998                                     MPIOLA(3NCARG)