Function read_cov

mne/cov.py:480–509

Read a noise covariance from a FIF file. Parameters ---------- fname : path-like The path-like of file containing the covariance matrix. It should end with ``-cov.fif`` or ``-cov.fif.gz``. %(verbose)s Returns ------- cov : Covariance The noise co

(fname, verbose=None)

@verbose
def read_cov(fname, verbose=None):
    """Read a noise covariance from a FIF file.

    Parameters
    ----------
    fname : path-like
        The path-like of file containing the covariance matrix. It should end
        with ``-cov.fif`` or ``-cov.fif.gz``.
    %(verbose)s

    Returns
    -------
    cov : Covariance
        The noise covariance matrix.

    See Also
    --------
    write_cov, compute_covariance, compute_raw_covariance
    """
    from ._fiff.open import fiff_open

    check_fname(
        fname, "covariance", ("-cov.fif", "-cov.fif.gz", "_cov.fif", "_cov.fif.gz")
    )
    fname = _check_fname(fname=fname, must_exist=True, overwrite="read")
    f, tree, _ = fiff_open(fname)
    with f as fid:
        return Covariance(
            **_read_cov(fid, tree, FIFF.FIFFV_MNE_NOISE_COV, limited=True)
        )


###############################################################################