Free Access Week - Data Engineering + BI
Data Engineering and BI courses are free this week!
Free Access Week - Jun 2-8

simplevis (version 2.4.0)

ggplot_sf_col: Map of simple features in ggplot that is coloured.

Description

Map of simple features in ggplot that is coloured, but not facetted.

Usage

ggplot_sf_col(data, col_var, col_method = NULL, col_cuts = NULL,
  pal = NULL, pal_rev = FALSE, size = 0.5, alpha = 0.9,
  boundary = NULL, boundary_behind = TRUE, boundary_pal = "#7f7f7f",
  boundary_size = 0.2, legend_ncol = 3, legend_digits = 1,
  title = "[Title]", subtitle = NULL, col_title = "",
  caption = NULL, legend_labels = NULL, font_family = "Helvetica",
  font_size_title = NULL, font_size_body = NULL, title_wrap = 70,
  subtitle_wrap = 80, wrap_col_title = 25, caption_wrap = 80,
  isMobile = FALSE)

Arguments

data

A sf object with defined coordinate reference system. Required input.

col_var

Unquoted variable for points to be coloured by. Required input.

col_method

The method of colouring features, either "bin", "quantile" or "category." NULL results in "category", if categorical or "quantile" if numeric col_var. Note all numeric variables are cut to be inclusive of the min in the range, and exclusive of the max in the range (except for the final bucket which includes the highest value).

col_cuts

A vector of cuts to colour a numeric variable. If "bin" is selected, the first number in the vector should be either -Inf or 0, and the final number Inf. If "quantile" is selected, the first number in the vector should be 0 and the final number should be 1. Defaults to quartiles.

pal

Character vector of hex codes. Defaults to NULL, which selects the colorbrewer Set1 or viridis.

pal_rev

Reverses the palette. Defaults to FALSE.

size

Size of features (or shape outlines if polygon). Defaults to 0.5.

alpha

The opacity of polygons. Defaults to 0.9.

boundary

A sf object as administrative boundaries (or coastlines). Defaults to no boundaries added.

boundary_behind

TRUE or FALSE as to whether the boundary is to be behind the sf object defined in the data argument. Defaults to TRUE.

boundary_pal

Colour of the boundary. Defaults to "#7F7F7F".

boundary_size

Size of the boundary. Defaults to 0.2.

legend_ncol

The number of columns in the legend.

legend_digits

Select the appropriate number of decimal places for numeric variable auto legend labels. Defaults to 1.

title

Title string. Defaults to "[Title]".

subtitle

Subtitle string. Defaults to "[Subtitle]".

col_title

Colour title string for the legend. Defaults to NULL.

caption

Caption title string. Defaults to NULL.

legend_labels

A vector of manual legend label values. Defaults to NULL, which results in automatic labels.

font_family

Font family to use. Defaults to "Helvetica".

font_size_title

Font size for the title text. Defaults to 11.

font_size_body

Font size for all text other than the title. Defaults to 10.

title_wrap

Number of characters to wrap the title to. Defaults to 70. Not applicable where isMobile equals TRUE.

subtitle_wrap

Number of characters to wrap the subtitle to. Defaults to 80. Not applicable where isMobile equals TRUE.

wrap_col_title

Number of characters to wrap the colour title to. Defaults to 25. Not applicable where isMobile equals TRUE.

caption_wrap

Number of characters to wrap the caption to. Defaults to 80. Not applicable where isMobile equals TRUE.

isMobile

Whether the plot is to be displayed on a mobile device. Defaults to FALSE. If within an app with the mobileDetect function, then use isMobile = input$isMobile.

Value

A ggplot object.

Examples

Run this code
# NOT RUN {
ggplot_sf_col(data = example_sf_polygon, col_var = density, boundary = nz,
     col_method = "bin", col_cuts = c(0, 10, 50, 100, 150, 200, Inf), legend_digits = 0,
     title = "Density, 2017")

ggplot_sf_col(data = example_sf_polygon, col_var = density, boundary = nz,
     col_method = "quantile", col_cuts = c(0, 0.25, 0.5, 0.75, 0.95, 1),
     title = "Density, 2017")

 pal <- c("#4575B4", "#D3D3D3", "#D73027")

ggplot_sf_col(data = example_sf_point, col_var = trend_category, boundary = nz, 
   pal = pal, col_method = "category",
   title = "Monitored river nitrate-nitrogen trends, 2008-17")
# }

Run the code above in your browser using DataLab