NAME

       plmap - Plot continental outline or shapefile data in world coordinates

SYNOPSIS

       plmap(mapform, name, minx, maxx, miny, maxy)

DESCRIPTION

       Plots  continental  outlines  or  shapefile data in world coordinates. A demonstration of how to use this
       function to create different projections can be found in examples/c/x19c. PLplot is provided  with  basic
       coastal  outlines  and  USA state borders. These can be used irrespective of whether Shapefile support is
       built into PLplot. With Shapefile support this function can also be used with user Shapefiles,  in  which
       case  it will plot the entire contents of a Shapefile joining each point of each Shapefile element with a
       line. Shapefiles have become a popular standard for geographical data and data  in  this  format  can  be
       easily  found from a number of online sources. Shapefile data is actually provided as three or more files
       with the same filename, but different extensions. The .shp and  .shx  files  are  required  for  plotting
       Shapefile data with PLplot.

       Redacted form: plmap(mapform, name, minx, maxx, miny, maxy)

       This function is used in example 19.

ARGUMENTS

       mapform (PLMAPFORM_callback(3plplot), input)
              A  user  supplied  function  to  transform  the  original map data coordinates to a new coordinate
              system. The PLplot-supplied map data is provided as latitudes and longitudes; other Shapefile data
              may be provided in other coordinate systems as can be found in their .prj plain  text  files.  For
              example,  by  using  this transform we can change from a longitude, latitude coordinate to a polar
              stereographic projection. Initially, x[0]..[n-1] are the original x  coordinates  (longitudes  for
              the  PLplot-supplied data) and y[0]..y[n-1] are the corresponding y coordinates (latitudes for the
              PLplot supplied data).  After the call to mapform(),  x[]  and  y[]  should  be  replaced  by  the
              corresponding plot coordinates. If no transform is desired, mapform can be replaced by NULL.

       name (PLCHAR_VECTOR(3plplot), input)
              An  ascii  character  string  specifying the type of map plotted. This is either one of the PLplot
              built-in maps or the file name of a set of Shapefile files without the file  extensions.  For  the
              PLplot  built-in  maps  the  possible values are: "globe" -- continental outlines "usa" -- USA and
              state boundaries  "cglobe"  --  continental  outlines  and  countries  "usaglobe"  --  USA,  state
              boundaries and continental outlines

       minx (PLFLT(3plplot), input)
              The  minimum  x  value  of  map  elements  to be drawn. For the built in maps this is a measure of
              longitude. For Shapefiles the units must match the projection. The value of minx must be less than
              the value of maxx. Specifying a useful limit for these limits provides a useful  optimization  for
              complex or detailed maps.

       maxx (PLFLT(3plplot), input)
              The maximum x value of map elements to be drawn

       miny (PLFLT(3plplot), input)
              The  minimum  y  value  of  map  elements  to be drawn. For the built in maps this is a measure of
              latitude. For Shapefiles the units must match the projection. The value of miny must be less  than
              the value of maxy.

       maxy (PLFLT(3plplot), input)
              The maximum y value of map elements to be drawn.

AUTHORS

       Many  developers  (who  are  credited  at  http://plplot.sourceforge.net/credits.php) have contributed to
       PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                                 November, 2017                                   PLMAP(3plplot)