eegdash 0.3.2.dev52__py3-none-any.whl → 0.3.3__py3-none-any.whl

eegdash/__init__.py

@@ -4,5 +4,7 @@ from .utils import __init__mongo_client
 
 __init__mongo_client()
 
+
 __all__ = ["EEGDash", "EEGDashDataset", "EEGChallengeDataset"]
-__version__ = "0.3.2.dev52"
+
+__version__ = "0.3.3"

eegdash/api.py

@@ -534,6 +534,7 @@ class EEGDashDataset(BaseConcatDataset):
         ],
         cache_dir: str = "~/eegdash_cache",
         s3_bucket: str | None = None,
+        eeg_dash_instance=None,
         **kwargs,
     ):
         """Create a new EEGDashDataset from a given query or local BIDS dataset directory
@@ -568,29 +569,51 @@ class EEGDashDataset(BaseConcatDataset):
         """
         self.cache_dir = cache_dir
         self.s3_bucket = s3_bucket
-        if query:
-            datasets = self.find_datasets(query, description_fields, **kwargs)
-        elif data_dir:
-            if isinstance(data_dir, str):
-                datasets = self.load_bids_dataset(
-                    dataset, data_dir, description_fields, s3_bucket
-                )
+        self.eeg_dash = eeg_dash_instance or EEGDash()
+        _owns_client = eeg_dash_instance is None
+
+        try:
+            if query:
+                datasets = self.find_datasets(query, description_fields, **kwargs)
+            elif data_dir:
+                if isinstance(data_dir, str):
+                    datasets = self.load_bids_dataset(
+                        dataset, data_dir, description_fields, s3_bucket, **kwargs
+                    )
+                else:
+                    assert len(data_dir) == len(dataset), (
+                        "Number of datasets and their directories must match"
+                    )
+                    datasets = []
+                    for i, _ in enumerate(data_dir):
+                        datasets.extend(
+                            self.load_bids_dataset(
+                                dataset[i],
+                                data_dir[i],
+                                description_fields,
+                                s3_bucket,
+                                **kwargs,
+                            )
+                        )
             else:
-                assert len(data_dir) == len(dataset), (
-                    "Number of datasets and their directories must match"
+                raise ValueError(
+                    "Exactly one of 'query' or 'data_dir' must be provided."
                 )
-                datasets = []
-                for i, _ in enumerate(data_dir):
-                    datasets.extend(
-                        self.load_bids_dataset(
-                            dataset[i], data_dir[i], description_fields, s3_bucket
-                        )
-                    )
+        finally:
+            # If we created the client, close it now that construction is done.
+            if _owns_client:
+                try:
+                    self.eeg_dash.close()
+                except Exception:
+                    # Don't let close errors break construction
+                    pass
 
         self.filesystem = S3FileSystem(
             anon=True, client_kwargs={"region_name": "us-east-2"}
         )
 
+        self.eeg_dash.close()
+
         super().__init__(datasets)
 
     def find_key_in_nested_dict(self, data: Any, target_key: str) -> Any:
@@ -628,27 +651,23 @@ class EEGDashDataset(BaseConcatDataset):
             A list of EEGDashBaseDataset objects that match the query.
 
         """
-        eeg_dash_instance = EEGDash()
-        try:
-            datasets = []
-            for record in eeg_dash_instance.find(query):
-                description = {}
-                for field in description_fields:
-                    value = self.find_key_in_nested_dict(record, field)
-                    if value is not None:
-                        description[field] = value
-                datasets.append(
-                    EEGDashBaseDataset(
-                        record,
-                        self.cache_dir,
-                        self.s3_bucket,
-                        description=description,
-                        **kwargs,
-                    )
+        datasets: list[EEGDashBaseDataset] = []
+        for record in self.eeg_dash.find(query):
+            description = {}
+            for field in description_fields:
+                value = self.find_key_in_nested_dict(record, field)
+                if value is not None:
+                    description[field] = value
+            datasets.append(
+                EEGDashBaseDataset(
+                    record,
+                    self.cache_dir,
+                    self.s3_bucket,
+                    description=description,
+                    **kwargs,
                 )
-            return datasets
-        finally:
-            eeg_dash_instance.close()
+            )
+        return datasets
 
     def load_bids_dataset(
         self,
@@ -676,36 +695,28 @@ class EEGDashDataset(BaseConcatDataset):
             data_dir=data_dir,
             dataset=dataset,
         )
-        eeg_dash_instance = EEGDash()
-        try:
-            datasets = Parallel(n_jobs=-1, prefer="threads", verbose=1)(
-                delayed(self.get_base_dataset_from_bids_file)(
-                    bids_dataset=bids_dataset,
-                    bids_file=bids_file,
-                    eeg_dash_instance=eeg_dash_instance,
-                    s3_bucket=s3_bucket,
-                    description_fields=description_fields,
-                )
-                for bids_file in bids_dataset.get_files()
+        datasets = Parallel(n_jobs=-1, prefer="threads", verbose=1)(
+            delayed(self.get_base_dataset_from_bids_file)(
+                bids_dataset=bids_dataset,
+                bids_file=bids_file,
+                s3_bucket=s3_bucket,
+                description_fields=description_fields,
+                **kwargs,
             )
-            return datasets
-        finally:
-            eeg_dash_instance.close()
+            for bids_file in bids_dataset.get_files()
+        )
+        return datasets
 
     def get_base_dataset_from_bids_file(
         self,
-        bids_dataset: EEGBIDSDataset,
+        bids_dataset: "EEGBIDSDataset",
         bids_file: str,
-        eeg_dash_instance: EEGDash,
         s3_bucket: str | None,
         description_fields: list[str],
-    ) -> EEGDashBaseDataset:
-        """Instantiate a single EEGDashBaseDataset given a local BIDS file. Note
-        this does not actually load the data from disk, but will access the metadata.
-        """
-        record = eeg_dash_instance.load_eeg_attrs_from_bids_file(
-            bids_dataset, bids_file
-        )
+        **kwargs,
+    ) -> "EEGDashBaseDataset":
+        """Instantiate a single EEGDashBaseDataset given a local BIDS file (metadata only)."""
+        record = self.eeg_dash.load_eeg_attrs_from_bids_file(bids_dataset, bids_file)
         description = {}
         for field in description_fields:
             value = self.find_key_in_nested_dict(record, field)
@@ -716,4 +727,5 @@ class EEGDashDataset(BaseConcatDataset):
             self.cache_dir,
             s3_bucket,
             description=description,
+            **kwargs,
         )

eegdash/data_utils.py

@@ -10,6 +10,7 @@ import numpy as np
 import pandas as pd
 import s3fs
 from bids import BIDSLayout
+from fsspec.callbacks import TqdmCallback
 from joblib import Parallel, delayed
 from mne._fiff.utils import _read_segments_file
 from mne.io import BaseRaw
@@ -98,8 +99,27 @@ class EEGDashBaseDataset(BaseDataset):
             self.s3file = re.sub(r"(^|/)ds\d{6}/", r"\1", self.s3file, count=1)
 
         self.filecache.parent.mkdir(parents=True, exist_ok=True)
+        info = filesystem.info(self.s3file)
+        size = info.get("size") or info.get("Size")
+
+        callback = TqdmCallback(
+            size=size,
+            tqdm_kwargs=dict(
+                desc=f"Downloading {Path(self.s3file).name}",
+                unit="B",
+                unit_scale=True,
+                unit_divisor=1024,
+                dynamic_ncols=True,
+                leave=True,
+                mininterval=0.2,
+                smoothing=0.1,
+                miniters=1,
+                bar_format="{desc}: {percentage:3.0f}%|{bar}| {n_fmt}/{total_fmt} "
+                "[{elapsed}<{remaining}, {rate_fmt}]",
+            ),
+        )
+        filesystem.get(self.s3file, self.filecache, callback=callback)
 
-        filesystem.download(self.s3file, self.filecache)
         self.filenames = [self.filecache]
 
     def _download_dependencies(self) -> None:
@@ -119,7 +139,26 @@ class EEGDashBaseDataset(BaseDataset):
             # in the case of the competition.
             if not filepath.exists():
                 filepath.parent.mkdir(parents=True, exist_ok=True)
-                filesystem.download(s3path, filepath)
+                info = filesystem.info(s3path)
+                size = info.get("size") or info.get("Size")
+
+                callback = TqdmCallback(
+                    size=size,
+                    tqdm_kwargs=dict(
+                        desc=f"Downloading {Path(s3path).name}",
+                        unit="B",
+                        unit_scale=True,
+                        unit_divisor=1024,
+                        dynamic_ncols=True,
+                        leave=True,
+                        mininterval=0.2,
+                        smoothing=0.1,
+                        miniters=1,
+                        bar_format="{desc}: {percentage:3.0f}%|{bar}| {n_fmt}/{total_fmt} "
+                        "[{elapsed}<{remaining}, {rate_fmt}]",
+                    ),
+                )
+                filesystem.get(s3path, filepath, callback=callback)
 
     def get_raw_bids_args(self) -> dict[str, Any]:
         """Helper to restrict the metadata record to the fields needed to locate a BIDS

eegdash/dataset.py

@@ -1,4 +1,7 @@
+from pathlib import Path
+
 from .api import EEGDashDataset
+from .registry import register_openneuro_datasets
 
 RELEASE_TO_OPENNEURO_DATASET_MAP = {
     "R11": "ds005516",
@@ -67,3 +70,13 @@ class EEGChallengeDataset(EEGDashDataset):
             s3_bucket=f"{s3_bucket}/{release}_L100",
             **kwargs,
         )
+
+
+registered_classes = register_openneuro_datasets(
+    summary_file=Path(__file__).with_name("dataset_summary.csv"),
+    base_class=EEGDashDataset,
+    namespace=globals(),
+)
+
+
+__all__ = ["EEGChallengeDataset"] + list(registered_classes.keys())

eegdash/registry.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+
+import csv
+from pathlib import Path
+from typing import Any, Dict
+
+
+def register_openneuro_datasets(
+    summary_file: str | Path,
+    *,
+    base_class=None,
+    namespace: Dict[str, Any] | None = None,
+) -> Dict[str, type]:
+    """Dynamically create dataset classes from a summary file.
+
+    Parameters
+    ----------
+    summary_file : str | Path
+        Path to a CSV file where each line starts with the dataset identifier.
+    base_class : type | None
+        Base class for the generated datasets. If ``None``, defaults to
+        :class:`eegdash.api.EEGDashDataset`.
+    namespace : dict | None
+        Mapping where the new classes will be registered. Defaults to the
+        module's global namespace.
+
+    Returns
+    -------
+    dict
+        Mapping from class names to the generated classes.
+
+    """
+    if base_class is None:
+        from .api import EEGDashDataset as base_class  # lazy import
+
+    summary_path = Path(summary_file)
+    namespace = namespace if namespace is not None else globals()
+    registered: Dict[str, type] = {}
+
+    with summary_path.open() as f:
+        reader = csv.reader(f)
+        for row in reader:
+            if not row:
+                continue
+            dataset_id = row[0].strip()
+            if not dataset_id or dataset_id.startswith("#"):
+                continue
+            class_name = dataset_id.upper()
+
+            def __init__(
+                self,
+                cache_dir: str,
+                query: dict | None = None,
+                s3_bucket: str | None = None,
+                **kwargs,
+            ):
+                q = {"dataset": self._dataset}
+                if query:
+                    q.update(query)
+                super().__init__(
+                    query=q, cache_dir=cache_dir, s3_bucket=s3_bucket, **kwargs
+                )
+
+            cls = type(
+                class_name,
+                (base_class,),
+                {"_dataset": dataset_id, "__init__": __init__},
+            )
+            namespace[class_name] = cls
+            registered[class_name] = cls
+
+    return registered

{eegdash-0.3.2.dev52.dist-info → eegdash-0.3.3.dist-info}/METADATA

@@ -1,35 +1,11 @@
 Metadata-Version: 2.4
 Name: eegdash
-Version: 0.3.2.dev52
+Version: 0.3.3
 Summary: EEG data for machine learning
 Author-email: Young Truong <dt.young112@gmail.com>, Arnaud Delorme <adelorme@gmail.com>, Aviv Dotan <avivd220@gmail.com>, Oren Shriki <oren70@gmail.com>, Bruno Aristimunha <b.aristimunha@gmail.com>
-License: GNU General Public License
-        
-        Copyright (C) 2024-2025
-        
-        Young Truong, UCSD, dt.young112@gmail.com
-        Arnaud Delorme, UCSD, adelorme@ucsd.edu
-        Aviv Dotan, BGU, avivdot@bgu.post.ac.il
-        Oren Shriki, BGU, shrikio@bgu.ac.il
-        Bruno Aristimunha, b.aristimunha@gmail.com
-        
-        This program is free software; you can redistribute it and/or modify
-        it under the terms of the GNU General Public License as published by
-        the Free Software Foundation; either version 2 of the License, or
-        (at your option) any later version.
-        
-        This program is distributed in the hope that it will be useful,
-        but WITHOUT ANY WARRANTY; without even the implied warranty of
-        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-        GNU General Public License for more details.
-        
-        You should have received a copy of the GNU General Public License
-        along with this program; if not, write to the Free Software
-        Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1.07  USA
-        
+License-Expression: GPL-3.0-only
 Project-URL: Homepage, https://github.com/sccn/EEG-Dash-Data
 Project-URL: Issues, https://github.com/sccn/EEG-Dash-Data/issues
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
@@ -60,6 +36,8 @@ Requires-Dist: s3fs
 Requires-Dist: scipy
 Requires-Dist: tqdm
 Requires-Dist: xarray
+Requires-Dist: h5io>=0.2.4
+Requires-Dist: pymatreader
 Provides-Extra: tests
 Requires-Dist: pytest; extra == "tests"
 Requires-Dist: pytest-cov; extra == "tests"
@@ -98,6 +76,14 @@ Dynamic: license-file
 
 # EEG-Dash
 
+[![PyPI version](https://img.shields.io/pypi/v/eegdash)](https://pypi.org/project/eegdash/)
+[![Docs](https://img.shields.io/badge/docs-stable-brightgreen.svg)](https://sccn.github.io/eegdash)
+
+[![License: GPL-2.0-or-later](https://img.shields.io/badge/License-GPL--2.0--or--later-blue.svg)](LICENSE)
+[![Python versions](https://img.shields.io/pypi/pyversions/eegdash.svg)](https://pypi.org/project/eegdash/)
+[![Downloads](https://pepy.tech/badge/eegdash)](https://pepy.tech/project/eegdash)
+<!-- [![Coverage](https://img.shields.io/codecov/c/github/sccn/eegdash)](https://codecov.io/gh/sccn/eegdash) -->
+
 To leverage recent and ongoing advancements in large-scale computational methods and to ensure the preservation of scientific data generated from publicly funded research, the EEG-DaSh data archive will create a data-sharing resource for MEEG (EEG, MEG) data contributed by collaborators for machine learning (ML) and deep learning (DL) applications. 
 
 ## Data source
@@ -143,7 +129,9 @@ To use the data from a single subject, enter:
 from eegdash import EEGDashDataset
 
 ds_NDARDB033FW5 = EEGDashDataset(
-    {"dataset": "ds005514", "task": "RestingState", "subject": "NDARDB033FW5"}
+    {"dataset": "ds005514", "task":
+     "RestingState", "subject": "NDARDB033FW5"}, 
+     cache_dir="."
 )
 ```
 
@@ -155,7 +143,7 @@ To use the data from multiple subjects, enter:
 from eegdash import EEGDashDataset
 
 ds_ds005505rest = EEGDashDataset(
-    {"dataset": "ds005505", "task": "RestingState"}, target_name="sex"
+    {"dataset": "ds005505", "task": "RestingState"}, target_name="sex", cache_dir=".
 )
 ```
 

{eegdash-0.3.2.dev52.dist-info → eegdash-0.3.3.dist-info}/RECORD

@@ -1,10 +1,11 @@
-eegdash/__init__.py,sha256=Nfsbk31HxH9sVIE7p14a0SwBKJWCAbWc6pHCUzDy_VA,238
-eegdash/api.py,sha256=lYCILa69Y_RRd4_13x1Ge77FDGswnEG2DEfdPzMygAY,26865
+eegdash/__init__.py,sha256=PX7q8ysT3hF3Gb5ADBOV413JrJNl-byFEHyU69Z7yNQ,234
+eegdash/api.py,sha256=OqOZ27GYURSAZwTQHSs0QcW_6Mq1i_5XHP6KMcihb8A,27295
 eegdash/data_config.py,sha256=OS6ERO-jHrnEOfMJUehY7ieABdsRw_qWzOKJ4pzSfqw,1323
-eegdash/data_utils.py,sha256=h1FLCTjRj2JDn6IFnVgWrogDYnHFR4mcuDF23KNtLZI,24530
-eegdash/dataset.py,sha256=GVELU-eXq9AQDzOeg6Lkykd-Pctyn42e5UEcAV0Go4s,2348
+eegdash/data_utils.py,sha256=8Jb_94uVbdknNPpx3GBl4dCDYUIJNzl3zkLwbfH90N4,26052
+eegdash/dataset.py,sha256=ooLoxMFy2I8BY9gJl6ncTp_Gz-Rq0Z-o4NJyyomxLcU,2670
 eegdash/mongodb.py,sha256=GD3WgA253oFgpzOHrYaj4P1mRjNtDMT5Oj4kVvHswjI,2006
 eegdash/preprocessing.py,sha256=7S_TTRKPKEk47tTnh2D6WExBt4cctAMxUxGDjJqq5lU,2221
+eegdash/registry.py,sha256=u2TqnMZPhnhItFupPbV50QGemeImnuc18wnEkKzLtL8,2118
 eegdash/utils.py,sha256=wU9CBQZLW_LIQIBwhgQm5bU4X-rSsVNPdeF2iE4QGJ4,410
 eegdash/features/__init__.py,sha256=BXNhjvL4_SSFAY1lcP9nyGpkbJNtoOMH4AHlF6OyABo,4078
 eegdash/features/datasets.py,sha256=kU1DO70ArSIy-LF1hHD2NN4iT-kJrI0mVpSkyV_OSeI,18301
@@ -21,8 +22,8 @@ eegdash/features/feature_bank/dimensionality.py,sha256=j_Ds71Y1AbV2uLFQj8EuXQ4kz
 eegdash/features/feature_bank/signal.py,sha256=3Tb8z9gX7iZipxQJ9DSyy30JfdmW58kgvimSyZX74p8,3404
 eegdash/features/feature_bank/spectral.py,sha256=bNB7skusePs1gX7NOU6yRlw_Gr4UOCkO_ylkCgybzug,3319
 eegdash/features/feature_bank/utils.py,sha256=DGh-Q7-XFIittP7iBBxvsJaZrlVvuY5mw-G7q6C-PCI,1237
-eegdash-0.3.2.dev52.dist-info/licenses/LICENSE,sha256=asisR-xupy_NrQBFXnx6yqXeZcYWLvbAaiETl25iXT0,931
-eegdash-0.3.2.dev52.dist-info/METADATA,sha256=vlhnJbk-mBMlfsTen_2zpBRpm6VNZ_2gI3I2gprYAC0,10784
-eegdash-0.3.2.dev52.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-eegdash-0.3.2.dev52.dist-info/top_level.txt,sha256=zavO69HQ6MyZM0aQMR2zUS6TAFc7bnN5GEpDpOpFZzU,8
-eegdash-0.3.2.dev52.dist-info/RECORD,,
+eegdash-0.3.3.dist-info/licenses/LICENSE,sha256=asisR-xupy_NrQBFXnx6yqXeZcYWLvbAaiETl25iXT0,931
+eegdash-0.3.3.dist-info/METADATA,sha256=0vPvCWfTcK3bjOZMcGW3xf2bVenY7lvHsDKBetAIoVc,10334
+eegdash-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+eegdash-0.3.3.dist-info/top_level.txt,sha256=zavO69HQ6MyZM0aQMR2zUS6TAFc7bnN5GEpDpOpFZzU,8
+eegdash-0.3.3.dist-info/RECORD,,