maps v3.2.0

0

Monthly downloads

0th

Percentile

by Alex Deckmyn

Draw Geographical Maps

Display of maps. Projection code and larger maps are in separate packages ('mapproj' and 'mapdata').

Readme

maps

###R package for geographical maps

This version 3 of the maps package. The main change with respect to v2 is a new world map. The old map legacy map is included and switching to "legacy" mode is explained below.

##CHANGES

  • The 'world' data base has been replaced by a much more recent data base, imported from the Natural Earth data project (the 1:50m world map, version 2.0, the latest version available in 2015) This may have several implications for code that calls map().

    • As of version 3.1, the 'world' database no longer contains lakes and lake islands. These are now in a separate database called 'lakes'.
    • Country names have changed. This is inevitable, since e.g. post-1990 Europe is dramatically different. As a consequence, any call to map() that involves the argument "region=...", may be affected. For instance, map('world','USSR') is now obsolete, while map('world','Russia') works fine.
    • The new data base contains less small islands, but the choice may be a bit different.
    • Some remote islands that are officially part of other countries may cause an unexpected change in the scale of a map. This is not a new phenomenon (map('world','france') had this in the old set), but some new cases may occur now. As explained below, this will now occur less often.
    • The naming of all polygons is as close as possible to the old world map. However, some inconsistencies have been remedied, e.g. on whether an island is called by its own name or as part of the country it belongs to. The choice is now mainly dependent on whether the entity has a seperate ISO code. The naming scheme unfortunately does not permit to represent all the intricacies. The data set iso3166 (see further) is added to provide more details.
    • Because of this segmentation by ISO code (and, often parallel, by admin-0 level), some countries now have much less islands. For instance, map(region="France") now only shows metropolitan France and one or two remote islands. To add all overseas territories and departments, you can use region=sov.expand("France"), which creates a list of all countries under French sovereignty.
    • The new 'world' database has a higher resolution than before and looks much smoother. In fact, for some applications it may now suffice rather than needing to import worldHires.
  • Most functions now use perl-style regular expressions internally, rather than the default style. This gives more flexibility.

##ADDITIONS

  • v3.1 includes support for 'SpatialPolygons' and 'SpatialLines' classes. Such objects can now either be passed to map() directly or first be converted to a map-type list with the new functions 'SpatialPolygons2map()' and 'SpatialLines2map'. These functions do not copy all the information present in the original data: only polygon names and co-ordinates are preserved (additional information like holes, plotting order etc. is ignored).

  • A new databse 'lakes' has been added. The standard 'world' map no longer contains any lakes.

  • A data frame iso3166 has been added which, for every country on the new world map, lists the official name, the ISO3166 2- and 3-letter codes, and also the sovereignty. Type '?iso3166' for details.

  • A set of simple functions use this iso3166 table for creating a list of countries to map. So you can use the 2- or 3-letter ISO code (e.g. as country labels on a map), but also create a list based on the sovereignty. Type '?iso.expand' for details.

  • v3.2 adds new options to map() for wrapping and exact boundary clipping.

##FIXES

  • As of v3.2, maps::map() also works if the maps package is not attached. You can even do maps::map("madata::worldHires").
  • As of v3.1, map(..., fill=TRUE) no longer applies thinning. This removes small artefacts, but plotting worldHires becomes rather slow, should you ever want to plot a full world map at such a high resolution.
  • map.text(..., exact=TRUE) now behaves as documented. Previously, the "exact=TRUE" was not passed to the map drawing if add=FALSE. To get the old (non-documented) behaviour (plot map with exact=FALSE, write text for exact=TRUE) you should now use 2 commands:
    • map(..., exact=FALSE)

    • map.text(..., exact=TRUE, add=TRUE)

  • match.map now works correctly for regions containing ":". This was potentially broken due to locale-dependent behaviour of order().
  • 'world2' now has clean boundaries when 'fill=TRUE'.

##FALL BACK TO LEGACY WORLD DATABASE There are a few mechanisms to use the old 'world' database rather than the updated one, should that be necessary:

  • Using 'database=legacy_world'
  • Setting R_MAP_DATA_LEGACY=TRUE in the environment prior to loading maps
  • Deprecated: Calling world.legacy(TRUE) for switching to the old database and world.legacy(FALSE) to switch back on the fly.

The last two options should only be used as a temporary last resource, to quickly run code that requires the old database without having to edit it.

Note that the worldHires database from the mapdata package has identical map naming than the legacy world map. The only difference is in the resolution of the polylines. That high resolution version of the legacy map will remain unchanged.

Please inform the maintainer of any problem that requires a fallback to the legacy database!

HIGH RESOLUTION AND OTHER MAPS

Natural Earth also supports a high-resolution (1:10m) world map. Rather than replacing 'worldHires' (in the mapdata package), this data set is available from the package mapdataNE (not yet on CRAN but already available from http://github.com/adeckmyn/mapdataNE).

Even maps in e.g. shapefile format can now easily be imported for use in 'map()'. For instance the package 'maptools' offers the function 'readShapePoly()', which reads a shapefile into a 'SpatialPolygonsDataFrame' that can be used as a map database (as of version 3.1).

##TO DO/DISCUSS:

  • Add 'proj4' support. This will have to be via a new argument e.g. \code{map(..., proj4="+proj=longlat"}.
  • Many islands remain nameless.
  • The naming convention is largely maintained, but some choices are different. The changes mean that e.g. /region="France"/ now covers only metropolitan France, whithout (most of) the overseas departments and territories
  • Some inconsistencies in the naming procedure remain. For instance, while most countries are named by their full name, "UK" and "USA" are shortened in the same way as in the old data base. For UK, this even required a hack in the mapping code to avoid adding Ukrain to the map.
  • The iso3166 table may have to be adapted for the Natural Earth 1:10 database, some extra rows have already been inserted.

Functions in maps

Name Description
county.fips FIPS county codes for US County Map
france France Map
map.cities Add Cities to Existing Map
map.scale Add Scale to Existing Unprojected Map
ozone Sample datasets
polygon Polygon functions
internal2 Internally Required Functions
iso.expand Identify countries by ISO 3166 codes (2 or 3 letters) or by Sovereignty.
map.text Draw a map with labeled regions
map.where Locate points on a map
match.map Index map regions
nz New Zealand Basic Map
canada.cities Database of Canadian cities
county United States County Map
lakes World lakes database
legacy_world Legacy low resolution World Map.
state.carto United States State Population Cartogram Map
identify.map Identify regions on a map
internal Internally Required Functions
iso3166 ISO 3166 country codes (2 or 3 letters) and sovereignty.
italy Italy Map
Spatial2map Read SpatialPolygons and SpatialLines objects
area.map Area of projected map regions
map Draw Geographical Maps
map.axes Draw Axes on Geographical Maps
state.vbm United States State Visibility Base Map
us.cities Database of US cities
world2 Pacific Centric Low resolution World Map
state.fips FIPS state codes for US 48 State Map
smooth.map Smooth out aggregated data
state United States State Boundaries Map
world.cities Database of world cities
world.legacy Legacy world map
usa United States Coast Map
world Low (mid) resolution World Map
No Results!

Last month downloads

Details

Date 2017-06-07
LazyData yes
License GPL-2
NeedsCompilation yes
Repository CRAN
Packaged 2017-06-07 21:50:04 UTC; alex
Date/Publication 2017-06-08 05:00:14 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/maps)](http://www.rdocumentation.org/packages/maps)