% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/grip_quality.R
\name{prepare.landmark.geodesic.kk}
\alias{prepare.landmark.geodesic.kk}
\title{Prepare sparse landmark-geodesic KK data for repeated layout evaluation}
\usage{
prepare.landmark.geodesic.kk(
  edges = NULL,
  n = NULL,
  adj_list = NULL,
  weight_list = NULL,
  edge_weights = NULL,
  local_nbrs = 20L,
  landmark_count = 8L
)
}
\arguments{
\item{edges}{Two-column integer matrix of edges (1-based vertex ids).}

\item{n}{Number of vertices. If omitted with \code{adj_list}, defaults to
\code{length(adj_list)}. If omitted with \code{edges}, defaults to
\code{max(edges)}.}

\item{adj_list}{Adjacency list (1-based) for an undirected graph.}

\item{weight_list}{Optional parallel list of positive edge weights.}

\item{edge_weights}{Optional positive edge-weight vector parallel to
\code{edges}.}

\item{local_nbrs}{Number of nearest graph-metric neighbors retained per
vertex.}

\item{landmark_count}{Number of farthest-point landmarks retained per vertex.}
}
\value{
A list with the sparse pair set, graph distances, chosen paths, and
  other cached data. The object has class \code{"grip_lgkk_prepared"}.
}
\description{
\code{prepare.landmark.geodesic.kk()} builds the deterministic shortest
path trees, graph-distance cache, sparse local-plus-landmark pair set, and
chosen path realizations needed to evaluate the landmark geodesic KK energy
repeatedly on the same graph. This is intended as a reusable preparation step
for experiments where many layouts of the same graph are compared.
}
\details{
The sparse set follows the implementation choice recorded in
\code{landmark\_geodesic\_kk\_spec\_2026-03-30.tex}: each vertex contributes
its \code{local_nbrs} nearest active vertices in graph distance and its
\code{landmark_count} farthest-point landmarks, both selected
deterministically.
}
