nispace.nulls.nulls_burt2018

nispace.nulls.nulls_burt2018(data_1d, dist_mat, n_nulls=1000, seed=None, **kwargs)

Spatial autoregressive surrogate maps (Burt et al. 2018).

Generates surrogates via brainsmash.utils.batch_surrogates, which fits a spatial autoregressive model relating data_1d to dist_mat and samples from it (values are Box-Cox-shifted internally to satisfy positivity, then shifted back). [11].

Intended to be called through generate_null_maps(), which handles NaN masking, hemisphere splitting, and parallelization across maps — not meant to be called directly.