simplevis (version 6.2.0)

gg_sf_facet: Simple feature ggplot map that is facetted.

Description

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

Usage

gg_sf_facet(
  data,
  facet_var,
  text_var = NULL,
  pal = pal_viridis_reorder(1),
  pal_borders = "#7F7F7F",
  borders = NULL,
  borders_on_top = NULL,
  alpha_fill = NULL,
  alpha_line = 1,
  alpha_point = 1,
  alpha_borders = 0.5,
  size_line = 0.5,
  size_point = 1.5,
  size_borders = 0.2,
  facet_labels = snakecase::to_sentence_case,
  facet_na_rm = FALSE,
  facet_ncol = NULL,
  facet_nrow = NULL,
  facet_rev = FALSE,
  title = NULL,
  title_wrap = 80,
  subtitle = NULL,
  subtitle_wrap = 80,
  caption = NULL,
  caption_wrap = 80,
  theme = gg_theme(void = TRUE)
)

Arguments

data

A sf object with defined coordinate reference system in a structure to be plotted untransformed. Required input.

facet_var

Unquoted categorical variable to facet the data by. Required input.

text_var

Unquoted variable to be used as a customised tooltip in combination with plotly::ggplotly(plot, tooltip = "text"). Defaults to NULL.

pal

Character vector of hex codes.

pal_borders

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

borders

A sf object as administrative boundaries (or coastlines). Defaults to no boundaries added. The rnaturalearth package is a useful source of country and state boundaries.

borders_on_top

TRUE or FALSE as to whether the borders are on top of the sf object supplied to the data argument. Defaults to TRUE for points and lines, but FALSE for polygons..

alpha_fill

The opacity of the fill.

alpha_line

The alpha of lines and outlines.

alpha_point

The alpha of points.

alpha_borders

Opacity of the borders. Defaults to 0.5.

size_line

Size of lines. Defaults to 0.5.

size_point

Size of points. Defaults to 1.5.

size_borders

Size of the borders. Defaults to 0.2.

facet_labels

A function or named vector to modify facet scale labels. Defaults to converting labels to sentence case. Use ggplot2::waiver() to keep facet labels untransformed.

facet_na_rm

TRUE or FALSE of whether to include facet_var NA values. Defaults to FALSE.

facet_ncol

The number of columns of facetted plots.

facet_nrow

The number of rows of facetted plots.

facet_rev

TRUE or FALSE of whether the facet variable variable is reversed. Defaults to FALSE.

title

Title string.

title_wrap

Number of characters to wrap the title to. Defaults to 100.

subtitle

Subtitle string.

subtitle_wrap

Number of characters to wrap the subtitle to. Defaults to 100.

caption

Caption title string.

caption_wrap

Number of characters to wrap the caption to. Defaults to 80.

theme

A ggplot2 theme.

Value

A ggplot object.

Examples

# NOT RUN {
gg_sf_facet(example_point, 
            facet_var = trend_category, 
            borders = example_borders)

# }