nispace.nulls.nulls_random

nispace.nulls.nulls_random(data_1d, dist_mat=None, n_nulls=1000, seed=None)

Fully random (spatially unconstrained) null maps.

Generates each null as an independent full permutation of the non-NaN values of data_1d (no resampling with replacement). dist_mat is accepted but never used — it exists only so this function shares a call signature with the other nulls_* functions for uniform dispatch inside generate_null_maps().

Intended to be called through generate_null_maps() (method="random"), which handles parallelization across maps — not meant to be called directly.