mdu 0.0.1__tar.gz

mdu-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthias Dold
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mdu-0.0.1/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: mdu
+Version: 0.0.1
+Summary: Default utilities I use for electrophys analysis
+Author-email: Matthias Dold <matthias.dold@gmx.de>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=2.2.6
+Requires-Dist: scipy>=1.15.3
+Requires-Dist: pandas>=2.3.3
+Requires-Dist: matplotlib>=3.10.8
+Requires-Dist: plotly>=6.6.0
+Requires-Dist: mne>=1.11.0
+Requires-Dist: statsmodels>=0.14.6
+Requires-Dist: tqdm>=4.67.3
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: polars>=1.38.0
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.2; extra == "dev"
+Requires-Dist: pytest-cov>=7.0.0; extra == "dev"
+Requires-Dist: ipython>=8.38.0; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: quartodoc; extra == "docs"
+Requires-Dist: nbformat; extra == "docs"
+Requires-Dist: nbclient; extra == "docs"
+Requires-Dist: jupyter-cache; extra == "docs"
+Requires-Dist: ipykernel; extra == "docs"
+Requires-Dist: griffe<2.0.0; extra == "docs"
+Provides-Extra: resampler
+Requires-Dist: plotly-resampler; extra == "resampler"
+Provides-Extra: ml
+Requires-Dist: scikit-learn>=1.0.0; extra == "ml"
+Provides-Extra: dash
+Requires-Dist: dash>=2.0.0; extra == "dash"
+Requires-Dist: PyYAML>=6.0.0; extra == "dash"
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+Provides-Extra: all
+Requires-Dist: build; extra == "all"
+Requires-Dist: twine; extra == "all"
+Requires-Dist: griffe<2.0.0; extra == "all"
+Requires-Dist: pytest>=9.0.2; extra == "all"
+Requires-Dist: pytest-cov>=7.0.0; extra == "all"
+Requires-Dist: ipython>=8.38.0; extra == "all"
+Requires-Dist: ruff; extra == "all"
+Requires-Dist: quartodoc; extra == "all"
+Requires-Dist: nbformat; extra == "all"
+Requires-Dist: nbclient; extra == "all"
+Requires-Dist: jupyter-cache; extra == "all"
+Requires-Dist: ipykernel; extra == "all"
+Requires-Dist: plotly-resampler; extra == "all"
+Requires-Dist: scikit-learn>=1.0.0; extra == "all"
+Requires-Dist: fire>=0.7.0; extra == "all"
+Requires-Dist: dash>=2.0.0; extra == "all"
+Requires-Dist: PyYAML>=6.0.0; extra == "all"
+Dynamic: license-file
+
+# MD Utils
+
+![CI](https://github.com/matthiasdold/mdu/workflows/CI%20Testing/badge.svg?branch=main)
+[![codecov](https://codecov.io/gh/matthiasdold/mdu/branch/main/graph/badge.svg)](https://codecov.io/gh/matthiasdold/mdu)
+![Tests](https://img.shields.io/badge/tests-176%20passed-brightgreen)
+![Python](https://img.shields.io/badge/python-3.10+-blue)
+
+This repo includes common functionality I often use during analysis of
+electrophysiology data.
+
+
+## Installation
+
+```bash
+# Basic installation
+pip install mdu
+
+# With development tools
+pip install mdu[dev]
+
+# With optional features
+pip install mdu[resampler]  # For large time-series plotting
+pip install mdu[ml]          # For ML plotting utilities
+pip install mdu[dash]        # For interactive dashboards
+pip install mdu[all]         # All optional features
+```
+
+## Testing
+
+Run tests with coverage:
+
+```bash
+pytest tests/ --cov=src/mdu --cov-report=html
+```
+
+Current test coverage: **27%** (176 tests passing)
+
+Coverage reports are automatically tracked on [Codecov](https://codecov.io/gh/matthiasdold/mdu) via CI.
+

mdu-0.0.1/README.md

@@ -0,0 +1,39 @@
+# MD Utils
+
+![CI](https://github.com/matthiasdold/mdu/workflows/CI%20Testing/badge.svg?branch=main)
+[![codecov](https://codecov.io/gh/matthiasdold/mdu/branch/main/graph/badge.svg)](https://codecov.io/gh/matthiasdold/mdu)
+![Tests](https://img.shields.io/badge/tests-176%20passed-brightgreen)
+![Python](https://img.shields.io/badge/python-3.10+-blue)
+
+This repo includes common functionality I often use during analysis of
+electrophysiology data.
+
+
+## Installation
+
+```bash
+# Basic installation
+pip install mdu
+
+# With development tools
+pip install mdu[dev]
+
+# With optional features
+pip install mdu[resampler]  # For large time-series plotting
+pip install mdu[ml]          # For ML plotting utilities
+pip install mdu[dash]        # For interactive dashboards
+pip install mdu[all]         # All optional features
+```
+
+## Testing
+
+Run tests with coverage:
+
+```bash
+pytest tests/ --cov=src/mdu --cov-report=html
+```
+
+Current test coverage: **27%** (176 tests passing)
+
+Coverage reports are automatically tracked on [Codecov](https://codecov.io/gh/matthiasdold/mdu) via CI.
+

mdu-0.0.1/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mdu"
+version = "0.0.1"
+authors = [{name="Matthias Dold", email="matthias.dold@gmx.de"}]
+description = "Default utilities I use for electrophys analysis"
+readme ="README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+dependencies = [
+    "numpy>=2.2.6",
+    "scipy>=1.15.3",
+    "pandas>=2.3.3",
+    "matplotlib>=3.10.8",
+    "plotly>=6.6.0",
+    "mne>=1.11.0",
+    "statsmodels>=0.14.6",
+    "tqdm>=4.67.3",
+    "loguru>=0.7.0",
+    "polars>=1.38.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=9.0.2", "pytest-cov>=7.0.0", "ipython>=8.38.0", "ruff"]
+docs = ["quartodoc", "nbformat", "nbclient", "jupyter-cache", "ipykernel", "griffe<2.0.0"] # griffe<2.0.0 required for quartodoc
+resampler = ["plotly-resampler"]
+ml = ["scikit-learn>=1.0.0"]
+dash = ["dash>=2.0.0", "PyYAML>=6.0.0"]
+build = ["build", "twine"]
+all = [
+    "build",
+    "twine", 
+    "griffe<2.0.0",
+    "pytest>=9.0.2",
+    "pytest-cov>=7.0.0",
+    "ipython>=8.38.0",
+    "ruff",
+    "quartodoc",
+    "nbformat",
+    "nbclient",
+    "jupyter-cache",
+    "ipykernel",
+    "plotly-resampler",
+    "scikit-learn>=1.0.0",
+    "fire>=0.7.0",
+    "dash>=2.0.0",
+    "PyYAML>=6.0.0"
+]
+
+[tool.pytest.ini_options]
+addopts = "-ra -q"
+testpaths = [
+    "tests",
+    "./"
+]
+filterwarnings = ["ignore:::.*fire.core"]
+
+# Adding e.g. custom css
+[tool.setuptools.package-data]
+mdu = ["*.txt"]
+"mdu.mne.ica.assets" = ["*.css"]

mdu-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mdu-0.0.1/src/mdu/cross_val/chrono.py

@@ -0,0 +1,73 @@
+import numpy as np
+from mdu.utils.logging import get_logger
+
+logger = get_logger("mdu")
+
+
+class ChronoGroupsSplit:
+    """Leave out blocks of chronologically sorted pairs"""
+
+    def __init__(self, **kwags):
+        for k in kwags:
+            logger.info(f"Received kwargs for {k=} which will not be used")
+
+    def split(self, X, y, groups):
+        """Return the indices of all splits of the data in X and y.
+
+        Parameters
+        ----------
+        X : np.ndarray, shape (nsamples, nfeatures)
+            The data array with the sample dimension first.
+        y : np.ndarray, shape (nsamples,)
+            The labels vector.
+        groups : np.ndarray, shape (nsamples,)
+            A grouping vector matching the labels. This will be considered
+            to keep groups constant within each fold.
+
+        Returns
+        -------
+        splits : list of tuple of np.ndarray
+            A list of splits as (ix_train, ix_test) tuples to loop over.
+        """
+
+        y = np.asarray(y)
+        groups = np.asarray(groups)
+        # get groups per label
+        gm = {k: list(set(groups[y == k])) for k in set(y)}
+
+        for v in gm.values():
+            v.sort()
+
+        # ensure that groups are distinct in labels
+        assert all(
+            [set(s).intersection(groups[y != k]) == set() for k, s in gm.items()]
+        ), " Groups are not unique in label"
+
+        # ensure lengths match
+        set_lens = [len(v) for v in gm.values()]
+        if not all([e == set_lens[0] for e in set_lens]):
+            logger.info(
+                "Not all the same number of groups per label - "
+                "will zip and thus drop all groups longer than the min"
+            )
+
+        Xidcs = np.arange(X.shape[0])
+
+        splits = [
+            (
+                np.hstack(
+                    [
+                        Xidcs[groups == list(gv)[j]]
+                        for gv in gm.values()
+                        for j in range(min(set_lens))
+                        if j != i
+                    ]
+                ),  # the non selected --> train set  # noqa
+                np.hstack(
+                    [Xidcs[groups == list(gv)[i]] for gv in gm.values()]
+                ),  # the selected per grp --> test  # noqa
+            )
+            for i in range(min(set_lens))
+        ]
+
+        return splits