soma
soma runs computational pathology experiments from images and labels to predictions, metrics, and reports. It combines preprocessing, frozen foundation-model features, and downstream training through a modular Python API or a YAML pipeline.
Install
Requires Python 3.11 or later:
pip install soma-pathology
The distribution is soma-pathology; the Python package and CLI are soma.
Run an experiment
For slide classification, prepare dataset.csv (sample ID, image path, label) and splits.csv (sample ID, split, fold). The getting started guide shows both files and a complete walkthrough.
from soma import (
AggregatorConfig,
EncoderConfig,
EvalConfig,
Pipeline,
PipelineConfig,
TaskConfig,
TrainingConfig,
)
config = PipelineConfig(
dataset_csv="dataset.csv",
splits_csv="splits.csv",
output_root="output",
dataset_type="slide",
encoder=EncoderConfig(name="phikon"),
aggregator=AggregatorConfig(name="abmil"),
task=TaskConfig(name="binary_classification"),
training=TrainingConfig(epochs=5, learning_rate=1e-4, seed=0),
evaluation=EvalConfig(metrics=["auroc", "balanced_accuracy"]),
)
result = Pipeline(config).run()
print(result.summary)
print(result.run_dir)
phikon weights are public and download on first use. To extract features once and reuse them across experiments, see the API guide.
Use the CLI
Run the same pipeline from a YAML config:
soma config.yaml
# Equivalent:
python -m soma config.yaml
soma merges the file with its bundled defaults. Start with the task examples or the CLI reference. soma list encoders (and aggregators, decoders, tasks, benchmarks) prints the registered components.
Explore
- How soma works: pipeline components and experiment design.
- Modeling paths: tile, slide, patient, and dense prediction workflows.
- Tutorials: task-specific walkthroughs.
- Benchmarking: fixed protocols and encoder comparisons, including task-free CRoMa evaluation.
- Caching and run outputs: feature reuse and experiment provenance.
License
1 maintainer
Metadata
1 maintainer
Release files for soma-pathology 1.18.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| soma_pathology-1.18.0.tar.gz | 502.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| soma_pathology-1.18.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / soma_pathology-1.18.0.tar.gz
| Download URL | soma_pathology-1.18.0.tar.gz |
|---|---|
| Size | 502.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4df5f9a83d10af514c69ad7104335e6e7caf2f25d4cc8b1d74023037198563b7
|
|
BLAKE2b-256 checksum How to use checksums |
32ba0ac3e421c3ba3b1a0350bd015628430a3989ad94678c0b004306841e2e7f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / soma_pathology-1.18.0-py3-none-any.whl
| Download URL | soma_pathology-1.18.0-py3-none-any.whl |
|---|---|
| Size | 606.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3c943691088c457d721c9fdc8828bd40cce74b169e069689d5a5698315df96d8
|
|
BLAKE2b-256 checksum How to use checksums |
3fb7e543016cbf9c90c9272b55495f388d15b219cabf47a48f0de34a53bbb43e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
