- df
A dataframe containing country level data
- geoid.name
The variable that identifies each country
- geoid.type
How the variable given by geoid.name specifies each
country. The allowed geoid.type are given by the columns name.proper,
name.lower, iso_a3, and iso_a2 in choroplethr::country.regions. If "auto",
the function will try to automatically determine geoid.type.
- value.name
The name of the variable you wish to plot.
- num_colors
The number of colors you want in your graph when plotting
continuous data. If num_colors > 1, the variable in question will be
divided into quantiles and converted into a factor with that many levels.
If num_colors = 1, a continuous color gradient will be used; if num_colors = 0,
a diverging color gradient will be used (useful for visualizing negative
and positive numbers). Use color.max and color.min to control the range of
colors displayed. num_colors is ignored when plotting categorical data.
- color.max
The color of the highest value in your data. Ignored if the
plotted variable is categorical.
- color.min
The color of the lowest value in your data. Ignored if the
plotted variable is categorical.
- na.color
The color you want to assign for regions with missing data
- custom.colors
A vector of valid R color terms of the to use for the
map when plotting factor variables. The length of this vector must match
the number of levels in your factor variable, or num_colors for a
continuous variable that will be discretized by the function, and the order
should match the order of the levels of in your factor variable.
- nbreaks
The number of breaks you wish to show in the legend when using
a continuous color scale. Ignored if num_colors > 1.
- zoom
An optional vector of countries to zoom in on, written in the
same manner as geoid.name.
- continent_zoom
Zoom in on a particular continent; to see which
countries belong to which continent, see choroplethr::country.regions
- projection
One of the following: "cartesian", "mercator", "robinson",
or "albers", for equirectangular, Mercator, Robinson, and Albers Equal Area
projections, respectively. When using the Mercator projection for world
maps, setting limits_lon is recommended to prevent exaggeration of the size
of Antarctica.
- limits_lat
A length two vector giving the minimum and maximum latitude
you wish to include in your map.
- limits_lon
A length two vector giving the minimum and maximum
longitude you wish to include in your map.
- reproject
If TRUE, the map will be cropped and centered prior to
applying the projection. This will generally result in a better figure when
using the Robinson and Albers, but may lead to countries near the edge of
the map being occluded.
- border_color
The color of the borders on your map
- border_thickness
The thickness of the borders on your map
- background_color
The background color of your map
- gridlines
Should gridlines appear on your map?
- latlon_ticks
Should lat/lon tick marks appear on the edge of your map?
- whitespace
Add some blank space to the sides of your map? For some
projections, this must be set to FALSE in order for lat/lon ticks and
display correctly.
- label
The name of variable you wish to use to label your map; must be
one of the variables that appears in the spatial dataframe just prior
plotting (use return = 'sf' to see this dataframe), and in general, can be
any of the allowed geoid.type. This function uses ggplot2::geom_label_repel
to create the labels and ensure that they do not overlap.
- label_text_size
The size of the text that will appear in each label
- label_text_color
The color of the text that will appear in each label
- label_box_color
The color of the box around each label
- ggrepel_options
A list containing additional arguments to be passed to
geom_label_repel (see ?ggplot2::geom_label_repel)
- legend
A title for your legend; if NULL, value.name will be used.
- legend_position
The position of your legend relative to the rest of
the map; can be "top", "bottom", "left", or "right".
- title
A title for your plot; if NULL, no title will be added.
- return
If "plot", the function will return the requested map as a
ggplot object. If "sf", the function will return the spatial dataframe used
to draw the map (useful if you wish to customize the map yourself).