combatlearn 1.1.0__py3-none-any.whl → 1.1.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: combatlearn
3
- Version: 1.1.0
3
+ Version: 1.1.1
4
4
  Summary: Batch-effect harmonization for machine learning frameworks.
5
5
  Author-email: Ettore Rocchi <ettoreroc@gmail.com>
6
6
  License: MIT
@@ -21,14 +21,14 @@ Requires-Dist: nbformat>=4.2
21
21
  Requires-Dist: umap-learn>=0.5
22
22
  Provides-Extra: dev
23
23
  Requires-Dist: pytest>=7; extra == "dev"
24
- Requires-Dist: pytest-cov>=4.0; extra == "dev"
25
- Requires-Dist: ruff>=0.1; extra == "dev"
26
- Requires-Dist: mypy>=1.0; extra == "dev"
24
+ Requires-Dist: ruff>=0.8; extra == "dev"
25
+ Requires-Dist: pre-commit>=3.0; extra == "dev"
27
26
  Provides-Extra: docs
28
- Requires-Dist: mkdocs>=1.5.0; extra == "docs"
29
- Requires-Dist: mkdocs-material>=9.0.0; extra == "docs"
30
- Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
31
- Requires-Dist: pymdown-extensions>=10.0; extra == "docs"
27
+ Requires-Dist: sphinx>=7.0.0; extra == "docs"
28
+ Requires-Dist: pydata-sphinx-theme>=0.15.0; extra == "docs"
29
+ Requires-Dist: myst-parser>=3.0.0; extra == "docs"
30
+ Requires-Dist: sphinx-copybutton>=0.5.0; extra == "docs"
31
+ Requires-Dist: linkify-it-py>=2.0.0; extra == "docs"
32
32
  Dynamic: license-file
33
33
 
34
34
  # **combatlearn**
@@ -41,7 +41,7 @@ Dynamic: license-file
41
41
  [![License](https://img.shields.io/github/license/EttoreRocchi/combatlearn)](https://github.com/EttoreRocchi/combatlearn/blob/main/LICENSE)
42
42
 
43
43
  <div align="center">
44
- <p><img src="https://raw.githubusercontent.com/EttoreRocchi/combatlearn/main/docs/logo.png" alt="combatlearn logo" width="350" /></p>
44
+ <p><img src="https://raw.githubusercontent.com/EttoreRocchi/combatlearn/main/docs/source/_static/logo.png" alt="combatlearn logo" width="350" /></p>
45
45
  </div>
46
46
 
47
47
  **combatlearn** makes the popular _ComBat_ (and _CovBat_) batch-effect correction algorithm available for use into machine learning frameworks. It lets you harmonise high-dimensional data inside a scikit-learn `Pipeline`, so that cross-validation and grid-search automatically take batch structure into account, **without data leakage**.
@@ -62,16 +62,11 @@ pip install combatlearn
62
62
  **Full documentation is available at [combatlearn.readthedocs.io](https://combatlearn.readthedocs.io)**
63
63
 
64
64
  The documentation includes:
65
- - [Installation Guide](https://combatlearn.readthedocs.io/en/latest/installation/)
66
- - [Quick Start Tutorial](https://combatlearn.readthedocs.io/en/latest/quickstart/)
67
- - [User Guide](https://combatlearn.readthedocs.io/en/latest/user-guide/overview/)
65
+ - [Methods Guide](https://combatlearn.readthedocs.io/en/latest/methods/)
68
66
  - [API Reference](https://combatlearn.readthedocs.io/en/latest/api/)
69
- - [Examples](https://combatlearn.readthedocs.io/en/latest/examples/basic-usage/)
70
67
 
71
68
  ## Quick start
72
69
 
73
- For more details, see the [Quick Start Tutorial](https://combatlearn.readthedocs.io/en/latest/quickstart/).
74
-
75
70
  ```python
76
71
  import pandas as pd
77
72
  from sklearn.pipeline import Pipeline
@@ -116,7 +111,7 @@ print("Best parameters:", grid.best_params_)
116
111
  print(f"Best CV AUROC: {grid.best_score_:.3f}")
117
112
  ```
118
113
 
119
- For a full example of how to use **combatlearn** see the [notebook demo](https://github.com/EttoreRocchi/combatlearn/blob/main/docs/demo/combatlearn_demo.ipynb)
114
+ For a full example of how to use **combatlearn** see the [notebook demo](https://github.com/EttoreRocchi/combatlearn/blob/main/docs/source/demo/combatlearn_demo.ipynb)
120
115
 
121
116
  ## `ComBat` parameters
122
117
 
@@ -146,13 +141,13 @@ The following section provides a detailed explanation of all parameters availabl
146
141
 
147
142
  The `plot_transformation` method allows to visualize the **ComBat** transformation effect using dimensionality reduction, showing the before/after comparison of data transformed by `ComBat` using PCA, t-SNE, or UMAP to reduce dimensions for visualization.
148
143
 
149
- For further details see the [Visualization Guide](https://combatlearn.readthedocs.io/en/latest/user-guide/visualization/) and the [notebook demo](https://github.com/EttoreRocchi/combatlearn/blob/main/docs/demo/combatlearn_demo.ipynb).
144
+ For further details see the [API Reference](https://combatlearn.readthedocs.io/en/latest/api/) and the [notebook demo](https://github.com/EttoreRocchi/combatlearn/blob/main/docs/source/demo/combatlearn_demo.ipynb).
150
145
 
151
146
  ### Batch Effect Metrics
152
147
 
153
148
  The `compute_batch_metrics` method provides quantitative assessment of batch correction quality. It computes metrics including Silhouette coefficient, Davies-Bouldin index, kBET, LISI, and variance ratio for batch effect quantification, as well as k-NN preservation and distance correlation for structure preservation.
154
149
 
155
- For further details see the [Metrics Guide](https://combatlearn.readthedocs.io/en/latest/user-guide/metrics/) and the [notebook demo](https://github.com/EttoreRocchi/combatlearn/blob/main/docs/demo/combatlearn_demo.ipynb).
150
+ For further details see the [API Reference](https://combatlearn.readthedocs.io/en/latest/api/) and the [notebook demo](https://github.com/EttoreRocchi/combatlearn/blob/main/docs/source/demo/combatlearn_demo.ipynb).
156
151
 
157
152
  ## Contributing
158
153
 
@@ -0,0 +1,7 @@
1
+ combatlearn/__init__.py,sha256=ETYsrj1yK76UxKS8bfnTkzx5XPnk18XsNEgr-6tu6YY,100
2
+ combatlearn/combat.py,sha256=oiDtJv87PWRJHsWZVZfZ9_uLZbmzS0zl7j128kxIKdY,58992
3
+ combatlearn-1.1.1.dist-info/licenses/LICENSE,sha256=O34CBRTmdL59PxDYOa6nq1N0-2A9xyXGkBXKbsL1NeY,1070
4
+ combatlearn-1.1.1.dist-info/METADATA,sha256=ujWyvXi1loi_9Y6Qp-uP9HXUmrM_PPrKaM6Bnc1UfOU,9082
5
+ combatlearn-1.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
6
+ combatlearn-1.1.1.dist-info/top_level.txt,sha256=3cFQv4oj2sh_NKra45cPy8Go0v8W9x9-zkkUibqZCMk,12
7
+ combatlearn-1.1.1.dist-info/RECORD,,
@@ -1,7 +0,0 @@
1
- combatlearn/__init__.py,sha256=L4sPJuJzLJIODAuSXdNQECVoFJXcmVss7SzoqX6MlYg,99
2
- combatlearn/combat.py,sha256=yLoppVuLBvqO-0a01xWQve-8ZEMkEICabcGPf5u1goI,59309
3
- combatlearn-1.1.0.dist-info/licenses/LICENSE,sha256=O34CBRTmdL59PxDYOa6nq1N0-2A9xyXGkBXKbsL1NeY,1070
4
- combatlearn-1.1.0.dist-info/METADATA,sha256=s4Y3G0ou1TnNZJpu1eRC7VN2lDVan_BqEm_qpVQf2lk,9446
5
- combatlearn-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
6
- combatlearn-1.1.0.dist-info/top_level.txt,sha256=3cFQv4oj2sh_NKra45cPy8Go0v8W9x9-zkkUibqZCMk,12
7
- combatlearn-1.1.0.dist-info/RECORD,,