fit_mc

class mne_plsc.fit_mc(data, design=None, between=None, within=None, participant=None, source_domain=None, source_freqs=None, effects='all', boot_stat='condwise-scores-centred', svd_method='lapack', random_state=None)

Fit mean-centred PLS model.

Parameters:

• data (MNE object or iterable of MNE objects) – The M/EEG data to analyze. For single-participant analysis, this should be an instance of one of MNE’s data containers for epoched data (e.g., mne.Epochs) and each observation will be a single trial. For group-level analysis, this should be an iterable of MNE data containers for averages over epochs (e.g., mne.Evoked), and each observation will be a participant’s average in a within-participants condition. For source-space analysis, data will always be a list of source time courses.

• design (pd.DataFrame, optional) – Design matrix containing indicators of experimental condition and/or covariates. The default is None.

• between (iterable | str, optional) – An iterable containing indicators (integer or string labels) of between-participants conditions, or a string specifying which column in design contains such an indicator. The default is None.

• within (iterable | str, optional) – An iterable containing indicators (integer or string labels) of within-participants conditions, or a string specifying which column in design contains such an indicator. The default is None.

• participant (iterable | str, optional) – An iterable containing indicators (integer or string labels) of participant identity, or a string specifying which column in design contains such an indicator. The default is None. This is required only if there is a within-participants condition.

• source_domain (str, optional) –

  If model is fit to source-space data, this argument specifies the domain of the source space. Must be one of:

  • 'time' For output of mne.minimum_norm.apply_inverse(), mne.beamformer.apply_lcmv(), etc. This is assumed by default.

  • 'freq' For output of mne.minimum_norm.apply_inverse_cov(), mne.beamformer.apply_dics(), etc.

  • 'time-freq' For output of mne.minimum_norm.apply_dics_tfr_epochs, :func:`mne.beamformer.apply_dics_tfr_epochs(), etc.

• source_freqs (numpy.ndarray, optional) – If model is fit to source-space data and source domain is time or time-frequency, this argument specifies the frequencies in the source data.

• boot_stat (str, optional) – Specifies which statistic should be computed on each bootstrap iteration. The default is 'score-covariate-corr'. See pyplsc.BDA for details.

• svd_method (str, optional) – The method of SVD decomposition. The default is 'lapack'. See pyplsc.BDA for details.

• random_state (int, optional) – Random state for seeding the model. The default is None.

Returns:

MCPLSC object fit to the data.

Return type:

MCPLSC