Per-Cell Weighted Adjacency Score

For each cell of design_matrix, counts neighbours on rings of radius dists whose value equals the cell's own, weighted by weights. Implemented by stacking shifted copies of the matrix once per offset.

Usage

adjacency_score_vec(
  design_matrix,
  dists = c(1, 2),
  weights = c(1, 2),
  ring_type = c("manhattan", "chebyshev"),
  relationship = NULL
)

Arguments

design_matrix

Design matrix

dists

A vector of positive integers, ring radii to score over.

weights

Per-ring weights; must align with dists.

ring_type

Ring shape: "manhattan" (default; diamond ring) or "chebyshev" (square ring). See ring_offsets().

relationship

Optional pairwise-relationship lookup produced by prep_relationship(). When supplied, each neighbour pair contributes relationship[cell, neighbour] rather than 1 for matches and 0 otherwise. NA-padded cells off the design edge contribute 0. Defaults to NULL, which keeps the strict identity match. Pass the raw matrix through prep_relationship() first; the score functions consume only the prepped form.

Value

Matrix of the same dimensions as design_matrix, where each cell holds its weighted matching-neighbour count.