neuromaps.nulls.cornblath

neuromaps.nulls.cornblath(data, atlas='fsaverage', density='10k', parcellation=None, n_perm=1000, seed=None, spins=None, surfaces=None)

Generates null maps for parcellated data using method from [SN5]

Method projects data to spherical surface and uses arbitrary rotations to generate null distributions. Reassigned parcels are based on the average value of the vertices in each parcel within the rotated data

Parameters

• data ((N,) array_like) – Input data from which to generate null maps

• atlas ({'fsLR', 'fsaverage', 'civet'}, optional) – Name of surface atlas on which data are defined. Default: ‘fsaverage’

• density (str, optional) – Density of surface mesh on which data are defined. Must be compatible with specified atlas. Default: ‘10k’

• parcellation (tuple-of-str or os.PathLike, optional) – Filepaths to parcellation images ([left, right] hemisphere) mapping data to surface mesh specified by atlas and density. Should only be supplied if data represents a parcellated null map. Default: None

• n_perm (int, optional) – Number of null maps or permutations to generate. Default: 1000

• seed ({int, np.random.RandomState instance, None}, optional) – Seed for random number generation. Default: None

• spins (array_like or str or os.PathLike) – Filepath to or pre-loaded resampling array. If not specified spins are generated. Default: None

• surfaces (tuple-of-str or os.PathLike, optional) – Instead of specifying atlas and density this specifies the surface files on which data are defined. Providing this will override arguments supplied to atlas and density. Default: None

Returns

nulls – Generated null distribution, where each column represents a unique null map

Return type

np.ndarray

References

SN5

Cornblath, E. J., Ashourvan, A., Kim, J. Z., Betzel, R. F., Ciric, R., Adebimpe, A., … & Bassett, D. S. (2020). Temporal sequences of brain activity at rest are constrained by white matter structure and modulated by cognitive demands. Communications biology, 3(1), 1-12.