#' Term Frequency from INLPO Publications
#'
#' @description A term-frequency table giving the number of times each term appears in
#'   each publication, for publications by the U.S. Geological Survey (USGS), Idaho
#'   Water Science Center, Idaho National Laboratory Project Office (INLPO). The table
#'   has one row per term-publication pairing.
#'
#' @format An object of class 'term' that inherits from the 'data.frame' class and
#'   includes the following columns:
#'   \describe{
#'     \item{`term`}{Term (a single word, or a multi-word n-gram), stored as a factor.
#'       Terms are lowercase ASCII.}
#'     \item{`pub_id`}{Identifier of the publication in which the term appears, stored
#'       as a factor; a foreign key referencing the `pub_id` primary key of the
#'       [`pubs`] table.}
#'     \item{`freq`}{Number of times the term occurs in that publication.}
#'   }
#'
#' @source The publication text was sourced from the original PDF documents using the
#'   [`get_pdf_text`] function, and term frequencies were extracted from the text
#'   using the [`mine_text`] function.
#'
#' @seealso [`mine_text`] to build a term-frequency table, [`search_terms`] to search
#'   within it, and [`make_wordcloud`] to visualize it.
#'
#' @keywords datasets
#'
#' @examples
#' str(terms, max.level = 3, width = 75, strict.width = "cut")
#'
#' # Most frequent terms across all publications:
#' freq_by_term <- tapply(terms$freq, terms$term, FUN = sum)
#' sort(freq_by_term, decreasing = TRUE) |> head(n = 10)

"terms"
