moabb.datasets.download.nemar_sourcedata_dl#

moabb.datasets.download.nemar_sourcedata_dl(nemar_id, dataset_code, path=None, force_update=False, subject=None, include=None, verbose=None)[source]#

Download a NEMAR dataset’s sourcedata/ and return its local root.

sourcedata/ holds the original, pre-BIDS distribution as published by the dataset authors, stored under the upstream filenames. It is therefore a drop-in mirror of whatever BaseDataset.data_path() would otherwise fetch from the upstream host — useful when that host is slow, rate-limited, behind a bot gate, or gone.

Parameters:

nemar_id (str) – NEMAR dataset identifier.
dataset_code (str) – MOABB dataset code used to choose the local dataset directory.
path (None | str) – Base path where MOABB stores datasets.
force_update (bool) – Re-fetch even when a local copy is already present.
subject (int | str | list | None) – Restrict the download to one subject, resolved through the deposit’s sourcedata_provenance.json rather than by guessing at the layout. A list is treated as aliases for the same subject (e.g. the raw MOABB id and its nemar_subject_template form) and matches any of them. Falls back to fetching the whole tree, with a warning, when the deposit was enriched before that manifest recorded subjects.
include (str | list of str | None) – Explicit path glob(s) relative to the dataset root, for callers that know the layout. Overrides subject. Without either, the whole sourcedata/ tree is downloaded.
verbose (bool, str, int, or None) – If not None, override default verbose level.

Returns:

Local path to the downloaded sourcedata directory.

Return type:

str

Raises:

NemarDownloadError – If the download fails or the deposit publishes no sourcedata/ at all.