% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/plot-distributions.R
\name{plot_network_evolution}
\alias{plot_network_evolution}
\title{Plot Network Evolution (Small Multiples)}
\usage{
plot_network_evolution(
  x,
  time = NULL,
  slices = NULL,
  cumulative = FALSE,
  labels = NULL,
  layout = "spring",
  ncol = NULL,
  node_size = 5,
  seed = 42,
  combined = TRUE,
  ...
)
}
\arguments{
\item{x}{An edge list data frame with columns \code{from}, \code{to}, and
a time column, OR a list of network objects (matrices, igraph, etc.).}

\item{time}{Character. Name of the time/group column in \code{x}. Ignored
if \code{x} is a list.}

\item{slices}{Integer or NULL. Number of equal-width time bins. Default
NULL uses unique values of the time column.}

\item{cumulative}{Logical. If TRUE, each panel shows all edges up to that
time point (growing network). If FALSE (default), each panel shows only
edges from that period.}

\item{labels}{Character vector of panel labels. Default NULL (auto from
time values).}

\item{layout}{Layout specification. Default \code{"spring"}.}

\item{ncol}{Integer. Grid columns. Default auto.}

\item{node_size}{Numeric. Default 5.}

\item{seed}{Integer or NULL. Default 42.}

\item{combined}{Logical: when TRUE (default), arrange period panels in an
internal grid via \code{graphics::par(mfrow=...)}. Set to FALSE to draw
into a layout the caller has already configured (e.g. via
\code{\link{panel_layout}()}).}

\item{...}{Additional arguments passed to \code{\link{splot}}.}
}
\value{
Invisible list of per-panel networks or edge-list data frames.
}
\description{
Displays a network at different time points side by side. Accepts an edge
list data frame with a time column, or a pre-built list of networks.
All panels share the same node layout for visual comparison.
}
\examples{
set.seed(1)
edges <- data.frame(
  from = sample(LETTERS[1:5], 30, replace = TRUE),
  to   = sample(LETTERS[1:5], 30, replace = TRUE),
  week = sample(1:4, 30, replace = TRUE))
cograph::plot_network_evolution(edges, time = "week")
cograph::plot_network_evolution(edges, time = "week", cumulative = TRUE)
}
