compute.stability.metrics: Compute Stability Metrics Across a Sequence of IkNN Graphs

In dgraphs: Data-Derived Graph Construction Utilities

Compute Stability Metrics Across a Sequence of IkNN Graphs

Description

Computes stability diagnostics across the pruned IkNN graphs produced by create.iknn.graphs(). Metrics include edit distances between consecutive graphs, graph-summary Jensen-Shannon divergence, edge-count diagnostics, local minima, and smoothed trend fits for plotting.

Usage

compute.stability.metrics(
  graphs,
  graph.type = c("geom", "isize"),
  summary = c("degree_distribution", "edge_weight_distribution",
    "component_size_distribution", "neighborhood_label_distribution"),
  divergence = c("js"),
  labels = NULL,
  summary.args = list()
)

Arguments

graphs	An object of class "iknn_graphs" returned by create.iknn.graphs().
graph.type	Character string, either "geom" or "isize".
summary	Graph-summary family used for the divergence curve.
divergence	Divergence used for consecutive-graph comparison. Currently only "js".
labels	Optional vertex-label vector used when summary = "neighborhood_label_distribution".
summary.args	Optional named list forwarded to compute.graph.summary.stability().

Value

An object of class "iknn_stability_metrics".

dgraphs documentation built on Aug. 21, 2026, 1:08 a.m.