quanteda (version 1.1.1)

textplot_keyness: Plot word keyness

Description

Plot the results of a "keyword" of features comparing their differential associations with a target and a reference group, after calculating keyness using textstat_keyness.

Usage

textplot_keyness(x, show_reference = TRUE, show_legend = TRUE, n = 20L,
  min_count = 2L, margin = 0.05, color = c("darkblue", "gray"),
  labelcolor = "gray30", labelsize = 4, font = NULL)

Arguments

x

a return object from textstat_keyness

show_reference

logical; if TRUE, show key reference features in addition to key target features

show_legend

logical; if TRUE, show legend

n

integer; number of features to plot

min_count

numeric; minimum total count of feature across the target and reference categories, for a feature to be included in the plot

margin

numeric; size of margin where feature labels are shown

color

character or integer; colors of bars for target and reference documents. color must have two elements when show_reference = TRUE. See color.

labelcolor

character; color of feature labels.

labelsize

numeric; size of feature labels and bars. See size.

font

character; font-family of texts. Use default font if NULL.

Value

a ggplot2 object

See Also

textstat_keyness

Examples

# NOT RUN {
# compare Trump speeches to other Presidents by chi^2
dem_dfm <- data_corpus_inaugural %>%
     corpus_subset(Year > 1980) %>%
     dfm(groups = "President", remove = stopwords("english"), remove_punct = TRUE)
dem_key <- textstat_keyness(dem_dfm, target = "Trump")
textplot_keyness(dem_key, margin = 0.2, n = 10)

# compare contemporary Democrats v. Republicans
pres_corp <- data_corpus_inaugural %>%
    corpus_subset(Year > 1960)
docvars(pres_corp, "party") <-
    ifelse(docvars(pres_corp, "President") %in% c("Nixon", "Reagan", "Bush", "Trump"),
           "Republican", "Democrat")
pres_dfm <- dfm(pres_corp, groups = "party", remove = stopwords("english"),
                remove_punct = TRUE)
pres_key <- textstat_keyness(pres_dfm, target = "Democrat", measure = "lr")
textplot_keyness(pres_key, color = c("blue", "red"), n = 10)

# }