eegdash 0.3.3.dev58__py3-none-any.whl → 0.3.3.dev65__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.3.dev58"
+
+__version__ = "0.3.3.dev65"

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/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.3.dev58.dist-info → eegdash-0.3.3.dev65.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eegdash
-Version: 0.3.3.dev58
+Version: 0.3.3.dev65
 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

{eegdash-0.3.3.dev58.dist-info → eegdash-0.3.3.dev65.dist-info}/RECORD

@@ -1,10 +1,11 @@
-eegdash/__init__.py,sha256=Kj9Utn1GX3_PBPX9iOkMXepsLn4-u9yx8dFGTIkTb2c,238
-eegdash/api.py,sha256=lYCILa69Y_RRd4_13x1Ge77FDGswnEG2DEfdPzMygAY,26865
+eegdash/__init__.py,sha256=uALy4D9ILgjI9j18swEQkPxkajlvZnBy3Vp5NgbWYgA,240
+eegdash/api.py,sha256=OqOZ27GYURSAZwTQHSs0QcW_6Mq1i_5XHP6KMcihb8A,27295
 eegdash/data_config.py,sha256=OS6ERO-jHrnEOfMJUehY7ieABdsRw_qWzOKJ4pzSfqw,1323
 eegdash/data_utils.py,sha256=8Jb_94uVbdknNPpx3GBl4dCDYUIJNzl3zkLwbfH90N4,26052
-eegdash/dataset.py,sha256=GVELU-eXq9AQDzOeg6Lkykd-Pctyn42e5UEcAV0Go4s,2348
+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.3.dev58.dist-info/licenses/LICENSE,sha256=asisR-xupy_NrQBFXnx6yqXeZcYWLvbAaiETl25iXT0,931
-eegdash-0.3.3.dev58.dist-info/METADATA,sha256=RRZw0l9aGFsfVZgS6qfQVTft6uBdVdRqTgsQ6HYjl9A,11483
-eegdash-0.3.3.dev58.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-eegdash-0.3.3.dev58.dist-info/top_level.txt,sha256=zavO69HQ6MyZM0aQMR2zUS6TAFc7bnN5GEpDpOpFZzU,8
-eegdash-0.3.3.dev58.dist-info/RECORD,,
+eegdash-0.3.3.dev65.dist-info/licenses/LICENSE,sha256=asisR-xupy_NrQBFXnx6yqXeZcYWLvbAaiETl25iXT0,931
+eegdash-0.3.3.dev65.dist-info/METADATA,sha256=jzQQ705x_KvVRiSlHPT9P048biAgEN2NONf7oLTy6O4,11483
+eegdash-0.3.3.dev65.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+eegdash-0.3.3.dev65.dist-info/top_level.txt,sha256=zavO69HQ6MyZM0aQMR2zUS6TAFc7bnN5GEpDpOpFZzU,8
+eegdash-0.3.3.dev65.dist-info/RECORD,,