Function _ensure_src

mne/source_space/_source_space.py:2655–2675

Ensure we have a source space.

(src, kind=None, extra="", verbose=None)

@verbose
def _ensure_src(src, kind=None, extra="", verbose=None):
    """Ensure we have a source space."""
    _check_option("kind", kind, (None, "surface", "volume", "mixed", "discrete"))
    msg = f"src must be a string or instance of SourceSpaces{extra}"
    if _path_like(src):
        src = str(src)
        if not op.isfile(src):
            raise OSError(f'Source space file "{src}" not found')
        logger.info(f"Reading {src}...")
        src = read_source_spaces(src, verbose=False)
    if not isinstance(src, SourceSpaces):
        raise ValueError(f"{msg}, got {src} (type {type(src)})")
    if kind is not None:
        if src.kind != kind and src.kind == "mixed":
            if kind == "surface":
                src = src[:2]
            elif kind == "volume":
                src = src[2:]
        if src.kind != kind:
            raise ValueError(f"Source space must contain {kind} type, got {src.kind}")
    return src


def _ensure_src_subject(src, subject):