cogpy.wave.surrogates

Null-model surrogate generation for travelling-wave statistics.

Provides phase-randomisation and spatial-shuffle surrogates for testing whether observed wave properties exceed chance levels.

Ported from the surrogate logic in Muller et al. and the EvolutionaryNeuralCodingLab travelling-waves repository [1].

References

[1]

Bhattacharya et al., “Traveling waves in the prefrontal cortex during working memory”, PLOS Comp Biol, 2022. DOI: 10.1371/journal.pcbi.1009827

Functions

phase_randomize(data[, axis, rng])	Generate a phase-randomised surrogate preserving the power spectrum.
spatial_shuffle(data[, rng])	Permute spatial positions at each time step.
surrogate_test(data, estimator_fn[, ...])	Non-parametric significance test against surrogate distribution.