README.md

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

ADDITIONS

FIXES

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.

In v3.3, al these methods are deprecated (but will still function). The data set has been moved to the 'mapdata' package, where it is called "worldLores".

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:



adeckmyn/maps documentation built on May 10, 2019, 5:52 a.m.