Batch-aware, SVD-based pathway-activity inference for single-cell transcriptomics, natively integrated with the Scanpy/AnnData ecosystem. scROMA is a Python implementation of ROMA (Representation and Quantification Of Module Activity) that scores each gene set from the coordinated variation among its member genes, with per-cell activity scores, per-gene contributions, and permutation-based significance. Its batch-aware extension corrects technical variation inside the gene-set subspace rather than across the whole transcriptome, and it ships with a generative simulation framework that produces data with fully specified ground-truth pathway activity.
Install
pip install scroma
# or with uv:
uv pip install scroma # into the active environment
uv add scroma # into a uv project
Requires Python ≥ 3.10 and anndata ≥ 0.12. Tutorial datasets download on first use (via pooch).
Quick start
import scroma
# --- core pathway-activity scoring ---
adata = scroma.datasets.pbmc3k() # downloaded + cached on first use
roma = scroma.ROMA()
roma.adata = adata
roma.gmt = scroma.use_hallmarks() # bundled MSigDB Hallmark gene sets
roma.compute()
roma.summary() # significantly active pathways
# --- batch-aware scoring (correction within the gene-set subspace) ---
broma = scroma.BatchAwareROMA()
broma.adata = adata
broma.gmt = scroma.use_hallmarks()
broma.compute(batch_key="batch", batch_method="harmonylike")
# --- simulation with ground-truth pathway activity ---
sim = scroma.simulate(n_batches=3, seed=42) # AnnData + ground truth in .obsm/.uns
reps = scroma.load_benchmark("multi") # 10 default benchmark replicates
Features
- Two complementary scores per gene set: an L1 overdispersion score and a median-expression shift score, plus per-cell activity scores and per-gene contribution weights.
- Permutation significance with Benjamini–Hochberg correction.
- Batch-aware correction within each gene set (
residualized,contrastive,weighted,centered,ComBat,MNN,harmonylike). - Ground-truth simulator (
scroma.simulate/scroma.load_benchmark) for quantitative benchmarking. - Bundled gene sets (
use_hallmarks,use_reactome,use_progeny) and one-call tutorial datasets (datasets.pbmc3k,datasets.pbmc_ifnb).
Documentation
Full docs and tutorials: https://scroma.readthedocs.io
- Getting started — scoring pathway activity on PBMCs
- Simulated data — visualising ground truth and computing AUROC
- Gene-set weights — which genes drive a pathway
- Pathway-activity clustermap
Citing scROMA
If you use scROMA, please cite the paper (see CITATION.cff).
License
scROMA is released under the GNU GPL v3.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file scroma-0.3.1.tar.gz.
File metadata
- Download URL: scroma-0.3.1.tar.gz
- Upload date:
- Size: 373.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c35eaf871aeaf14b3582a50f83ffbd09d5ac9ef23f7ceee871f74713f77b4896
|
|
| MD5 |
d464c82729a52a0b68087cc2435d87f1
|
|
| BLAKE2b-256 |
43873bbaa9389e2ba47c28d7ea9b2ca0bfeb499628380e61e893929bb17344c0
|
Provenance
The following attestation bundles were made for scroma-0.3.1.tar.gz:
Publisher:
release.yml on altyn-bulmers/scroma
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
scroma-0.3.1.tar.gz -
Subject digest:
c35eaf871aeaf14b3582a50f83ffbd09d5ac9ef23f7ceee871f74713f77b4896 - Sigstore transparency entry: 2226581323
- Sigstore integration time:
-
Permalink:
altyn-bulmers/scroma@0e65f89af409061a8c85b6dc3016b7a6b05a51b5 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/altyn-bulmers
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0e65f89af409061a8c85b6dc3016b7a6b05a51b5 -
Trigger Event:
push
-
Statement type:
File details
Details for the file scroma-0.3.1-py3-none-any.whl.
File metadata
- Download URL: scroma-0.3.1-py3-none-any.whl
- Upload date:
- Size: 376.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1e7116e9124b9103c40a66405d6de4598b503011f7ce5739b1fdacb1460bcc2a
|
|
| MD5 |
e8bb1981a34ae317ddea3df24dba3023
|
|
| BLAKE2b-256 |
e2a64952cdf7a1122b72a17976446ea5eb5603e7cdaafdfaf144868410a07d71
|
Provenance
The following attestation bundles were made for scroma-0.3.1-py3-none-any.whl:
Publisher:
release.yml on altyn-bulmers/scroma
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
scroma-0.3.1-py3-none-any.whl -
Subject digest:
1e7116e9124b9103c40a66405d6de4598b503011f7ce5739b1fdacb1460bcc2a - Sigstore transparency entry: 2226581772
- Sigstore integration time:
-
Permalink:
altyn-bulmers/scroma@0e65f89af409061a8c85b6dc3016b7a6b05a51b5 -
Branch / Tag:
refs/tags/v0.3.1 - Owner: https://github.com/altyn-bulmers
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0e65f89af409061a8c85b6dc3016b7a6b05a51b5 -
Trigger Event:
push
-
Statement type:
