nispace.nulls.nulls_burt2020

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

Variogram-matched surrogate maps (Burt et al. 2020, brainsmash).

Generates surrogates by permuting data_1d and smoothing to match its empirical variogram, via the brainsmash package’s Base class. dist_mat is the parcel-by-parcel distance matrix; **kwargs (e.g. resample, batch_size) are forwarded to Base. [10].

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