ncl_mpname (3) - Linux Manuals

ncl_mpname: Given the area identifier of one of the areas defined by whatever

NAME

MPNAME - 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 name of the area.

SYNOPSIS

CHARACTER*64 MPNAME,NAME

NAME=MPNAME(IAIN)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

char *c_mpname (int iain)

DESCRIPTION

IAIN

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

C-BINDING DESCRIPTION

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

USAGE

Given the declaration "CHARACTER*64 MPNAME,NAME", the executable statement "NAME=MPNAME(IAIN)" will retrieve in NAME the name of 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 MPNAME(IMAD) = 'Madeline Island (Lake Superior)'.

To get the name of the area, at a specified level, that contains an area with a specified area identifier, use MPNAME in combination with MPIOAR. For example, MPNAME(MPIOAR(IMAD,3)) = 'Conterminous US', and MPNAME(MPIOAR(IMAD,2)) = 'North America'.

EXAMPLES

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

ACCESS

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

COPYRIGHT

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