% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/historiograph.R
\name{historiograph}
\alias{historiograph}
\title{Build a historiograph (chronological citation network)}
\usage{
historiograph(data, n = 30, min_lcs = 1)
}
\arguments{
\item{data}{A data frame with \code{id}, \code{references} (list-column), and
\code{year}. Optionally \code{title}, \code{journal}, \code{doi}, \code{cited_by_count}.}

\item{n}{Integer. Number of top locally cited documents to include.
Default 30.}

\item{min_lcs}{Integer. Minimum local citation score for inclusion.
Default 1.}
}
\value{
A list with:
\describe{
\item{\verb{$nodes}}{Data frame of included documents with \code{id}, \code{lcs},
\code{gcs}, \code{year}, \code{title}, \code{journal}, \code{doi}.}
\item{\verb{$edges}}{Data frame of directed citation edges with \code{from}
(citing), \code{to} (cited), \code{year_from}, \code{year_to}.}
}
}
\description{
Constructs a Garfield-style historiograph: a directed citation network
among the most locally cited documents, laid out chronologically.
}
\examples{
data(biblio_data)
h <- historiograph(biblio_data, n = 5)
h$nodes
h$edges
}
