db_area: Du Bois area plot

In IcaroBernardes/dubois: Collection of functions that generate Du Bois based plots from user datasets

Du Bois area plot

Description

Creates an area plot with two categories (cat1 and cat2) over the values of an order variable. They are shown in terms of percentage and their sum is 100%. The values of the categories are associated with the horizontal axis. Their areas are stacked horizontally. The rightmost category (in red) has its values highlighted in the vertical axis on the right. The order variable is shown in the vertical axis and is labeled in the left. Both axes are inverted. A bounded random walk effect can be added to the left of the area (like the plot had been torn) as function of some parameters (seed, res_step and limits). Furthermore, there is three slots for text (title, subtitle and message)

Usage

db_area(
  data,
  order,
  cat1,
  cat2,
  dpi = 320,
  seed = 42,
  res_step = 0.001,
  limits = c(-1, 1),
  names = c(cat1, cat2),
  title,
  subtitle,
  message,
  path = getwd(),
  filename
)

Arguments

data	data-frame class object: the data to be shown in the area plot. Each row must contain the value of each of the two categories as well one instance of the order variable.
order	character: the name of the order variable.
cat1	character: the name of the leftmost category (in red). Its values are highlighted in the vertical axis.
cat2	character: the name of the rightmost category (in black).
dpi	integer: resolution of the rendered texts and image.
seed	integer: seed used for calculate the bounded random walk.
res_step	numeric: the product of res_step and the numeric range of the order variable defines the step size of the bounded random walk.
limits	numeric vector: the lower and superior limits that bound the random walk. Must be given in that order: (lower, superior).
names	character vector: the names of the categories. shown in the first areas in the superior part of the plot and in the vertical axis title in the left.
title	character: text on the top of the plot
subtitle	character: text under the title
message	character: text on the bottom of the plot. has a brown background.
path	character: path to save the image of the plot.
filename	character: name of the image and its extension.

Value

an 22x28 inches image of an area plot in Du Bois style

Examples

library(dubois)

data <- dubois::managers %>%
  dplyr::select(race, year, pct_bosses_total) %>%
  tidyr::pivot_wider(
    names_from = "race",
    values_from = "pct_bosses_total"
  )

title <- "PARTICIPATION IN MANAGERIAL POSITIONS BY RACE IN BRAZIL."
subtitle <- "INSPIRED BY: W.E.B. DU BOIS | DATA FROM: IBGE | GRAPHIC BY: ICARO BERNARDES"
message <- "IN THE SERIES, USUALLY WHITES OCCUPY SLIGHTLY LESS GENERAL WORK POSITIONS. HOWEVER WHITES OCCUPY WAY MORE MANAGERIAL POSITIONS THAN BLACKS"

dubois::db_area(
  data = data, order = "year", cat1 = "black", cat2 = "white",
  limits = c(-3, 4), filename = "managers.png",
  title = title,
  subtitle = subtitle,
  message = message
)

IcaroBernardes/dubois documentation built on May 30, 2022, 4:01 p.m.