Simple feature ggplot map that is coloured and facetted.
Source:R/ggplot_sf.R
ggplot_sf_col_facet.RdMap of simple features in ggplot that is coloured and facetted.
ggplot_sf_col_facet( data, col_var, facet_var, text_var = NULL, pal = NULL, pal_rev = FALSE, size_point = 1, size_line = 0.5, alpha = 1, borders = NULL, borders_behind = TRUE, borders_pal = "#7f7f7f", borders_size = 0.2, title = NULL, title_wrap = 70, subtitle = NULL, subtitle_wrap = 80, col_cuts = NULL, col_labels_dp = 1, col_method = NULL, col_na = TRUE, col_legend_ncol = NULL, col_legend_nrow = NULL, col_title = NULL, col_title_wrap = 25, facet_ncol = NULL, facet_nrow = NULL, caption = NULL, caption_wrap = 80, font_family = "Helvetica", font_size_title = NULL, font_size_body = NULL )
Arguments
| data | A sf object with defined coordinate reference system. Required input. |
|---|---|
| col_var | Unquoted variable for points to be coloured by. 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. Defaults to NULL, which selects the colorbrewer Set1 or viridis. |
| pal_rev | Reverses the palette. Defaults to FALSE. |
| size_point | Size of points. Defaults to 0.5. |
| size_line | Size of lines. Defaults to 0.5. |
| alpha | The opacity of polygons. Defaults to 0.9. |
| 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_behind | TRUE or FALSE as to whether the borders is to be behind the sf object defined in the data argument. Defaults to TRUE. |
| borders_pal | Colour of the borders. Defaults to "#7F7F7F". |
| borders_size | Size of the borders. Defaults to 0.2. |
| title | Title string. Defaults to NULL. |
| title_wrap | Number of characters to wrap the title to. Defaults to 70. |
| subtitle | Subtitle string. Defaults to "[Subtitle]". |
| subtitle_wrap | Number of characters to wrap the subtitle to. Defaults to 80. |
| 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. |
| col_labels_dp | Select the appropriate number of decimal places for numeric variable auto legend labels. Defaults to 1. |
| 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_na | TRUE or FALSE of whether to show NA values of the colour variable. Defaults to TRUE. |
| col_legend_ncol | The number of columns in the legend. |
| col_legend_nrow | The number of rows in the legend. |
| col_title | Colour title string for the legend. Defaults to NULL, which converts to sentence case with spaces. Use "" if you would like no title. |
| col_title_wrap | Number of characters to wrap the colour title to. Defaults to 25. |
| facet_ncol | The number of columns of facetted plots. |
| facet_nrow | The number of rows of facetted plots. |
| caption | Caption title string. Defaults to NULL. |
| caption_wrap | Number of characters to wrap the caption to. Defaults to 80. |
| 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. |
Value
A ggplot object.
Examples
pal <- c("#4575B4", "#D3D3D3", "#D73027") ggplot_sf_col_facet(data = example_sf_point, col_var = trend_category, facet_var = trend_category, borders = nz, pal = pal, title = "Trends, 1990-2017")
