mapGriddedData

0th

Percentile

Produce maps of global gridded data at half degree resolution

Produce maps of global gridded data at half degree resolution

Keywords
hplot
Usage
mapGriddedData(dataset = "", nameColumnToPlot = "", numCats = 5, catMethod = "quantiles", colourPalette = "heat", xlim = c(-180, 180), ylim = c(-80, 90), mapRegion = "world", addLegend = TRUE, addBorders = "coarse", borderCol = "grey", oceanCol = NA, landCol = NA, plotData = TRUE, aspect = 1, lwd = 1)
Arguments
dataset
gridded data either as a :
  1. SpatialGridDataFrame (R object defined in package sp)
  2. file name of a GridAscii file - this is an Esri format
  3. 2D R matrix or array (rows by columns)
nameColumnToPlot
name of column containing the data to plot
numCats
number of categories to put the data in, may be overidden if catMethod ='pretty'
catMethod
method for categorisation of data "pretty", "fixedWidth","diverging", "logFixedWidth","quantiles","categorical", or a numeric vector defining breaks
colourPalette
a string describing the colour palette to use, choice of :
  1. "palette" for the current palette
  2. a vector of valid colours, e.g. =c('red','white','blue') or output from RColourBrewer
  3. one of "heat", "diverging", "white2Black", "black2White", "topo", "rainbow", "terrain", "negpos8", "negpos9"
xlim
map extents c(west,east), can be overidden by mapRegion
ylim
map extents c(south,north), can be overidden by mapRegion
mapRegion
a country name from getMap()[['NAME']] or 'world','africa','oceania','eurasia','uk' sets map extents, overrides xlim,ylim
addLegend
whether to add a legend or not
addBorders
options for country borders, 'low','coarse' = low or coarse resolution, 'coasts' = coasts only, 'none' or NA for none
borderCol
the colour for country borders
oceanCol
a colour for the ocean if the grid values are NA
landCol
a colour to fill countries if the grid values are NA over land
plotData
whether to plotData, if FALSE a legend can be added on its own
aspect
aspect for the map, defaults to 1, if set to 'variable' uses same method as plot.Spatial in sp
lwd
line width for country borders
Details

Plots a map of global half degree gridded data, allowing classification, colours and regions to be set.

Certain catMethod and colourPalette options go well together. e.g. "diverging" and "diverging", "categorical" and "rainbow"

Value

invisibly returns a list containing the data and main options used for the map, the list can be passed to addMapLegend along with additional options to allow greater flexibility in legend creation.

See Also

classInt, RColorBrewer

Aliases
  • mapGriddedData
Examples

## mapping continuous data
data(gridExData,envir=environment(),package="rworldmap")
gridExData <- get("gridExData")
mapGriddedData(gridExData)

## reclassing continuous data to categorical & mapping
data(gridExData,envir=environment(),package="rworldmap")
#find quartile breaks
cutVector <- quantile(gridExData@data[,1],na.rm=TRUE)
#classify the data to a factor
gridExData@data$categories <- cut( gridExData@data[,1]
                                      , cutVector, include.lowest=TRUE)
#rename the categories
levels(gridExData@data$categories) <- c('low', 'med', 'high', 'vhigh')
#mapping
mapGriddedData( gridExData, nameColumnToPlot= 'categories'
              , catMethod='categorical')



Documentation reproduced from package rworldmap, version 1.3-6, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.