null_burt2018: Burt 2018 spatial autoregressive null model

In neuromapr: Spatial Null Models and Transforms for Brain Map Comparison

Burt 2018 spatial autoregressive null model

Description

Generates surrogate brain maps using a spatial autoregressive (SAR) model. Estimates spatial autocorrelation and distance decay parameters, then generates surrogates by solving the SAR equation and rank-matching to the original data.

Usage

null_burt2018(data, distmat, n_perm = 1000L, seed = NULL)

Arguments

data	Numeric vector of brain map values.
distmat	Distance matrix between parcels/vertices.
n_perm	Integer number of null permutations to generate.
seed	Optional integer seed for reproducibility.

Value

A null_distribution object.

References

Burt JB et al. (2018) Nature Neuroscience 21:1251-1259. doi:10.1038/s41593-018-0195-0

Examples

data <- rnorm(50)
distmat <- as.matrix(dist(matrix(rnorm(100), 50, 2)))
nd <- null_burt2018(data, distmat, n_perm = 10L, seed = 1L)

neuromapr documentation built on Feb. 27, 2026, 5:08 p.m.