globalrep.weighted.grip()Alias of globalrep.weighted.grip()
weighted.grip(
edges = NULL,
n = NULL,
adj_list = NULL,
weight_list = NULL,
edge_weights = NULL,
dim = 3,
placement = c("barycenter", "circle"),
preset = NULL,
rounds = 160,
final_rounds = 384,
num_init = 24,
num_nbrs = 20,
r = 0.03,
s = 7.5,
repulsion_factor = 2.5,
coarse_repulsion_factor = 1.5,
coarse_repulsion_sample = 16,
coarse_repulsion_exact_below = 64,
final_anchor_factor = 0,
final_move_scale_after_first = 1,
final_mode = c("fr", "kk_repulse"),
insertion_anchor_count = 3,
insertion_anchor_scope = c("any_higher", "prev_misf"),
insertion_anchor_strategy = c("first", "distance_band", "balanced_band", "spread_prev"),
level0_insertion_mode = c("inherit", "barycenter", "least_squares"),
level0_anchor_count = insertion_anchor_count,
level0_local_kk_steps = 3,
lgkk_polish_rounds = 0L,
lgkk_multiscale_rounds = 0L,
lgkk_rounds_coarse = NULL,
lgkk_rounds_pre_final = NULL,
lgkk_rounds_final = NULL,
lgkk_local_nbrs = 20L,
lgkk_landmark_count = 8L,
lgkk_multiscale_scope = c("all", "coarse"),
lgkk_active_limit = 4096L,
metric_neighbor_cap = NULL,
length_normalization = c("median", "mean", "none"),
tinit_factor = 6,
seed = 6,
disconnected = c("components", "error")
)A numeric matrix with n rows and dim columns.
Two-column integer matrix of edges (1-based vertex ids).
Number of vertices.
Adjacency list (1-based) for undirected graphs.
Optional parallel list of edge weights (edge lengths). If NULL, all edges are treated as weight 1. All weights must be finite and strictly positive.
Optional vector of edge weights for edges. All
weights must be finite and strictly positive.
Layout dimension (2 or 3). Default is 3.
Initial placement strategy. "circle" is only used for 2D.
Optional weighted tuning preset. NULL uses the
quality-first defaults for the weighted core. "mesh" targets
rectangular and near-mesh weighted surfaces, "cylinder" targets
cylindrical grids, "torus" targets wrapped surface grids,
"sphere" targets closed near-spherical meshes,
"irregular" targets irregular manifold-like weighted families,
"tree" targets intrinsic weighted trees, and "carpet" keeps
a high-neighborhood profile for carpet-like recursive lattices. Explicit
tuning arguments override the preset field by field.
Initial rounds for refinement.
Final rounds for refinement.
Number of initial vertices in the coarsest level.
Maximum number of graph-distance neighbors retained for local refinement at each filtration level.
Main local temperature adaptation rate in [0, 1].
Non-negative boost factor applied when successive displacements have a consistent direction.
Non-negative multiplier applied to GRIP's finest-level repulsive force scale.
Non-negative multiplier applied to the extra
coarse-level active-set repulsion term. 0 disables that extra term;
when the remaining tuning arguments also match
legacy.grip(), the result matches the legacy
layout behavior.
Positive integer sample size used to approximate active-set-wide repulsion on larger coarse levels.
Positive integer threshold. When the active set size is at most this value, the coarse repulsion is computed exactly against all currently active vertices instead of being sampled.
Non-negative multiplier for an anchor term that pulls the final FR stage back toward the pre-final full-graph layout. `0` disables the anchor and preserves the current behavior.
Scalar in `[0, 1]` applied to the final FR displacement after the first finest-level round. Values below `1` damp later full-graph movement while keeping the first FR round unchanged.
Final full-graph refinement mode. "fr" keeps the
current Fruchterman-Reingold-style final stage. "kk_repulse" uses a
KK-style local distance-matching update with explicit active-set
repulsion instead of the final FR phase.
Positive integer number of anchor vertices used
during multiscale insertion on non-initial MISF refinement levels. This is
the closest current implementation to a global K_mish parameter.
Anchor-eligibility rule used during multiscale
insertion. "any_higher" matches the historical GRIP behavior and
allows anchors from any already placed higher MISF level.
"prev_misf" restricts anchors to the immediately previous MISF
level only.
Anchor-selection rule used during
multiscale insertion. "first" keeps the historical
first-anchors-found BFS behavior. "distance_band" keeps exploring
until the K_mish-th anchor distance band is exhausted, then places
the new vertex from that less order-sensitive anchor pool.
"balanced_band" uses the same band expansion, then explicitly
selects a subset whose centroid stays centered in the candidate cloud while
remaining geometrically spread out. "spread_prev" is a
symmetry-oriented band strategy intended to be paired with
insertion_anchor_scope = "prev_misf"; it selects anchors with broad
angular and geometric coverage before placement.
Level-0 insertion placement override used only
when the finest filtration level is first populated. "inherit"
keeps the current GRIP behavior. "barycenter" disables the 2D
circle heuristic at level 0 and uses barycentric anchor placement.
"least_squares" uses a multi-anchor least-squares distance fit at
level 0 before any local micro-polish.
Positive integer number of already placed anchors
to collect for level-0 insertion experiments. By default this inherits
insertion_anchor_count. The legacy behavior uses 3.
Non-negative integer number of tiny local KK micro-polish steps applied immediately after each level-0 insertion. The legacy behavior uses 3.
Non-negative integer number of experimental
landmark-geodesic KK polish iterations applied after the main GRIP solve.
0 disables the polish.
Non-negative integer number of compiled
landmark-geodesic KK refinement rounds applied inside the multiscale solver
after each eligible MISF level completes its standard GRIP rounds.
This legacy shared budget is used as a fallback when any of the more
specific per-stage budgets below are left NULL.
Optional non-negative integer number of compiled
LGKK rounds applied on coarse MISF levels with misf_level > 1.
When NULL, this falls back to lgkk_multiscale_rounds.
Optional non-negative integer number of compiled
LGKK rounds applied on the last coarse level just before the full graph is
opened (misf_level == 1). When NULL, this falls back to
lgkk_multiscale_rounds.
Optional non-negative integer number of compiled
LGKK rounds applied after the full graph level completes its standard GRIP
rounds (misf_level == 0). When NULL, this falls back to
lgkk_multiscale_rounds.
Number of nearest graph-metric neighbors retained per vertex in the LGKK sparse local set when either LGKK stage is enabled.
Number of farthest-point landmarks retained per vertex in the LGKK sparse long-range set when either LGKK stage is enabled.
Scope for the compiled multiscale LGKK stage.
"all" applies it after every eligible MISF level, including the
final full-graph level. "coarse" applies it only on coarse levels.
Positive integer upper bound on the active-set size for compiled multiscale LGKK cache construction. Levels larger than this skip the multiscale LGKK stage.
Optional cap on the number of settled Dijkstra
vertices used when building weighted neighborhood caches for inserted
vertices. NULL (default) keeps the exact weighted neighborhood
search, but now stops as soon as the required weighted neighbors and
anchors are filled. Supplying a positive integer enables an approximate
weighted neighborhood mode for larger graphs.
Global edge-length normalization:
"median" (default), "mean", or "none".
Initial temperature factor.
Optional RNG seed for reproducibility. If NULL, uses current time.
How to handle disconnected graphs:
"components" (default) lays out each connected component separately
and packs them into one coordinate matrix; "error" stops with an
error.