Score a MISF-based geodesic-KK fit

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.

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

fit

Optional fit from misf.geodesic.kk().

coords

Optional coordinate matrix used when fit is omitted.

prepared

Optional MISF-GKK prepared object used when fit is omitted.

stiffness

Global stiffness constant \(K\).

distance.floor

Small positive floor used in k_ij = K / max(g_ij, distance.floor)^2.

edge.length.epsilon

Small positive stabilizer added inside each embedded edge length.

score.pair.mode

Requested scoring pair policy: "full", "landmark", or "auto".

score.full.limit

Active-set size threshold used when score.pair.mode = "auto".

score.local.nbrs

Sparse local-neighborhood size used for landmark-based scoring.

score.landmark.count

Sparse landmark count used for landmark-based scoring.

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.

Examples

mesh_edges <- edges.mesh(4, 4)
prepared <- prepare.misf.geodesic.kk(
  mesh_edges, n = 16, num.init = 4,
  top.level.mode = "skip", seed = 1
)
coords <- matrix(seq_len(32), nrow = 16, ncol = 2)
score <- score.misf.geodesic.kk(coords = coords, prepared = prepared)