% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/grip_geodesic_misf_kk.R
\name{score.misf.geodesic.kk}
\alias{score.misf.geodesic.kk}
\title{Score a MISF-based geodesic-KK fit}
\usage{
score.misf.geodesic.kk(
  fit = NULL,
  coords = NULL,
  prepared = NULL,
  stiffness = 1,
  distance_floor = 1e-08,
  edge_length_epsilon = 1e-08,
  score_pair_mode = c("full", "landmark", "auto"),
  score_full_limit = 2048L,
  score_local_nbrs = 20L,
  score_landmark_count = 8L,
  return_trace = FALSE
)
}
\arguments{
\item{fit}{Optional fit from [misf.geodesic.kk()].}

\item{coords}{Optional coordinate matrix used when `fit` is omitted.}

\item{prepared}{Optional MISF-GKK prepared object used when `fit` is omitted.}

\item{stiffness}{Global stiffness constant \(K\).}

\item{distance_floor}{Small positive floor used in
\code{k_ij = K / max(g_ij, distance_floor)^2}.}

\item{edge_length_epsilon}{Small positive stabilizer added inside each
embedded edge length.}

\item{score_pair_mode}{Requested scoring pair policy: `"full"`,
`"landmark"`, or `"auto"`.}

\item{score_full_limit}{Active-set size threshold used when
`score_pair_mode = "auto"`.}

\item{score_local_nbrs}{Sparse local-neighborhood size used for
landmark-based scoring.}

\item{score_landmark_count}{Sparse landmark count used for landmark-based
scoring.}

\item{return_trace}{If `TRUE`, attach any trace tables stored inside `fit`.}
}
\value{
A one-row data frame with final MISF-GKK summary fields and either
  full-GKK or landmark-GKK score columns, depending on the resolved scoring
  policy. If `return_trace = TRUE`, trace list-columns are attached when
  available.
}
\description{
`score.misf.geodesic.kk()` summarizes external coordinates against a
MISF-GKK prepared object using either the exact full geodesic-KK scorer or
the sparse landmark geodesic-KK scorer, depending on `score_pair_mode`. When
a full MISF-GKK fit is supplied, the function also carries over the
multiscale stage metadata and any trace tables retained by the optimizer.
}
