historiograph: Build a historiograph (chronological citation network)

In bibnets: Importing, Constructing, and Exporting Bibliometric Networks

Build a historiograph (chronological citation network)

Description

Constructs a Garfield-style historiograph: a directed citation network among the most locally cited documents, laid out chronologically.

Usage

historiograph(
  data,
  n = 30,
  min_lcs = 1,
  references = "references",
  sep = ";",
  strip_quotes = TRUE,
  id = NULL
)

Arguments

data	A data frame with id, a references column (list-column or delimited string), and year. Optionally title, journal, doi, cited_by_count.
n	Integer. Number of top locally cited documents to include. Default 30.
min_lcs	Integer. Minimum local citation score for inclusion. Default 1.
references	Character. Name of the column containing cited references. Default "references".
sep	Character. Separator used to split the references column when it is a plain character column. Default ";".
strip_quotes	Logical. If TRUE (default), surrounding quote characters are removed from each reference.
id	Optional. Name of the column to use as the work identifier. If NULL (default), an existing id column is used when present, otherwise row numbers are used.

Value

A list with:

⁠$nodes⁠

Data frame of included documents with id, lcs, gcs, year, title, journal, doi.

⁠$edges⁠

Data frame of directed citation edges with from (citing), to (cited), year_from, year_to.

Examples

data(biblio_data)
h <- historiograph(biblio_data, n = 5)
h$nodes
h$edges

bibnets documentation built on June 19, 2026, 1:06 a.m.