pybispectra.cfc.AAC#
- class pybispectra.cfc.AAC(data: ndarray, freqs: ndarray, sampling_freq: int | float, verbose: bool = True)[source]#
Class for computing amplitude-amplitude coupling (AAC).
- Parameters:
- data
ndarray
, shape of [epochs, channels, frequencies, times] Amplitude (power) of the time-frequency representation of data.
- freqs
ndarray
, shape of [frequencies] Frequencies (in Hz) in
data
. Frequencies are expected to be evenly spaced.- sampling_freq
int
|float
Sampling frequency (in Hz) of the data from which
data
was derived.- verbose
bool
(defaultTrue
) Whether or not to report the progress of the processing.
- data
- Attributes:
results
tuple
ofResultsCFC
Return the results.
- data
ndarray
, shape of [epochs, channels, frequencies, times] Amplitude (power) of the time-frequency representation of data.
- freqs
ndarray
, shape of [frequencies] Frequencies (in Hz) in
data
.- sampling_freq
int
|float
Sampling frequency (in Hz) of
data
.- verbose
bool
Whether or not to report the progress of the processing.
Methods
compute
([indices, f1s, f2s, n_jobs])Compute AAC, averaged over epochs.
copy
()Return a copy of the object.
- compute(indices: tuple[tuple[int]] | None = None, f1s: tuple[int | float] | None = None, f2s: tuple[int | float] | None = None, n_jobs: int = 1) None [source]#
Compute AAC, averaged over epochs.
- Parameters:
- indices
tuple
oftuple
ofint
, length of 2 |None
(defaultNone
) Indices of the seed and target channels, respectively, to compute AAC between. If
None
, coupling between all channels is computed.- f1s
tuple
ofint
orfloat
, length of 2 |None
(defaultNone
) Start and end lower frequencies to compute AAC on, respectively. If
None
, all frequencies are used.- f2s
tuple
ofint
orfloat
, length of 2 |None
(defaultNone
) Start and end higher frequencies to compute AAC on, respectively. If
None
, all frequencies are used.- n_jobs
int
(default1
) Number of jobs to run in parallel. If
-1
, all available CPUs are used.
- indices
Notes
AAC is computed as the Pearson correlation coefficient across times for each frequency in each epoch, with coupling being averaged across epochs [1].
AAC is computed between all values of
f1s
andf2s
. If any value off1s
is higher thanf2s
, anumpy.nan
value is returned.References
- property results: ResultsCFC#
Return the results.
- Returns:
- results
ResultsCFC
The results of the AAC computation.
- results