meegsim.coupling.ppc_von_mises

meegsim.coupling.ppc_von_mises(waveform, sfreq, phase_lag, kappa, fmin, fmax, m=1, n=1, random_state=None)

Generate a time series that is phase coupled to the input time series with a probabilistic phase lag based on the von Mises distribution.

This function can be used to set up both within-frequency (1:1, default) and cross-frequency (n:m) coupling.

Parameters:

waveformarray

The input signal to be processed. It can be a real or complex time series.

sfreqfloat

Sampling frequency (in Hz).

phase_lagfloat

Average phase lag to apply to the waveform in radians.

kappafloat

Concentration parameter of the von Mises distribution. With higher kappa, phase shifts between input and output waveforms are more concentrated around the mean value provided in phase_lag. With lower kappa, phase shifts will vary substantially for different time points.

fmin: float

Lower cutoff frequency of the base frequency harmonic (in Hz).

fmax: float

Upper cutoff frequency of the base frequency harmonic (in Hz).

mint, optional

Multiplier for the base frequency of the output oscillation, default is 1.

nint, optional

Multiplier for the base frequency of the input oscillation, default is 1.

random_stateNone (default) or int

Seed for the random number generator. If None (default), results will vary between function calls. Use a fixed value for reproducibility.

Returns:

outarray, shape (n_times,)

The phase-coupled waveform with the same amplitude envelope as the input one.