Skip to contents

Computes a pairwise interaction matrix between phenotypes based on observed versus expected neighbour frequencies within a given radius. Expected counts multiply the two phenotype frequencies within each sample by that sample's total observed directed neighbour count, then sum across samples. This analytic frequency model is distinct from the fixed-label permutation null available through InteractionMatrix().

Usage

interaction_matrix(dt, radius)

Arguments

dt

A data.frame or data.table with finite real numeric vectors x and y, complete nonblank phenotype labels, and optional sample_id. An absent sample column means one sample; a present column must contain complete, nonblank identifiers. Matrix and array columns are not accepted. Missing phenotype labels must be resolved explicitly before analysis; they are not silently dropped from counts.

radius

Finite nonnegative numeric scalar. Radius for defining spatial neighbourhoods.

Value

A data.table in long format with columns from, to, observed, expected, and interaction_score (log2 observed/expected). Positive values indicate spatial attraction; negative values indicate avoidance. Zero observed counts with positive expectation yield -Inf (complete avoidance). When expectation is zero, the historical score convention is zero.

Examples

set.seed(42)
dt <- data.table::data.table(
  sample_id = "s1", cell_id = 1:100,
  x = runif(100, 0, 500), y = runif(100, 0, 500),
  phenotype = sample(c("CD3+", "CD8+", "Tumour"), 100, replace = TRUE)
)
interactions <- interaction_matrix(dt, radius = 50)
interactions
#>      from     to observed expected interaction_score
#>    <char> <char>    <num>    <num>             <num>
#> 1:   CD3+   CD3+       62  45.9192         0.4331707
#> 2:   CD3+   CD8+       35  38.6688        -0.1438151
#> 3:   CD3+ Tumour       40  36.2520         0.1419394
#> 4:   CD8+   CD3+       35  38.6688        -0.1438151
#> 5:   CD8+   CD8+       36  32.5632         0.1447544
#> 6:   CD8+ Tumour       23  30.5280        -0.4084992
#> 7: Tumour   CD3+       40  36.2520         0.1419394
#> 8: Tumour   CD8+       23  30.5280        -0.4084992
#> 9: Tumour Tumour       24  28.6200        -0.2539893