scATrans

scATrans is a Python toolkit for single-cell differential analysis. It is primarily designed for datasets that contain spliced/unspliced (or mature/nascent) RNA layers. In this setting it computes a composite active transcription score that integrates differential expression with reference-based excess unspliced RNA to rank genes.

It also supports conventional differential expression workflows (no velocity data required) using scanpy, PyDESeq2 pseudobulk, linear mixed models, or optional Memento. Functional enrichment (ORA, GSEA, GO, KEGG) uses bundled gene sets with consistent universe handling, and a set of visualization functions is provided.

📚 Full documentation, tutorials, and the complete API reference are on Read the Docs.

Installation

# From PyPI
pip install scatrans

# Or from Bioconda
conda install -c conda-forge -c bioconda scatrans

# Optional extras (PyPI): advanced (scVelo) mode, gene features, pseudobulk DE (PyDESeq2), Memento, GSEA
pip install "scatrans[advanced,gene_features,pseudobulk,memento,gsea]"

See Installation for extras, source installs, and logging setup.

When developing from a git checkout, install the editable tree you are editing (pip install -e . from that checkout). A stale editable install pointing at another path can make import scatrans load an older copy.

Quickstart

import scatrans as scat

# One-liner pipeline: score → filter → GO enrichment
result = scat.run_default_pipeline(
    adata,
    groupby="condition",
    target_group="Disease",
    reference_group="Control",
    sample_col="sample",   # optional; auto-selects pseudobulk when >=3 replicates/group
    organism="mouse",
)
print(result["candidates"].head())
print(result["enrichment"].head())

See the Quickstart for a complete end-to-end walkthrough, the Tutorials for fully worked, real-data notebooks (with and without RNA-velocity layers), and the User Guide for DE backends, enrichment, plotting, and advanced options.

Before reporting results in a paper

active_score is a composite heuristic rank, not a p-value or FDR on its own. See Statistical Guidance for what each output column means, safe vs. unsafe uses, and a reporting checklist before you cite scATrans results in a manuscript or supplement. Domain conventions (upregulation-oriented scoring, residual vs DE, cutoff names, GSEA ranks, within-run λ scale) are spelled out in Domain Assumptions (also on Read the Docs after the next docs deploy).

License

Software (Python source) is licensed under Apache License 2.0. Bundled gene-set data (GO, KEGG) carries its own licensing terms — see License before commercial use.

Author

Zhao Li (李钊)
Email: leelieber@gmail.com

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scatrans-0.10.4.tar.gz (15.8 MB view details)

Uploaded Jul 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

scatrans-0.10.4-py3-none-any.whl (9.1 MB view details)

Uploaded Jul 16, 2026 Python 3

File details

Details for the file scatrans-0.10.4.tar.gz.

File metadata

Download URL: scatrans-0.10.4.tar.gz
Upload date: Jul 16, 2026
Size: 15.8 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for scatrans-0.10.4.tar.gz
Algorithm	Hash digest
SHA256	`eafc15c76a5225fde003203b47321d68dfa0647b7b2634f3a642e105a5f313df`
MD5	`733e9744e8526f8f97f75bc36782c233`
BLAKE2b-256	`c9ccb0984a97b7f3ba51a545e006f7dce2746682e5d710c5e6c7792723a828d5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for scatrans-0.10.4.tar.gz:

Publisher: publish.yml on leelieber2025/scATrans

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: scatrans-0.10.4.tar.gz
- Subject digest: eafc15c76a5225fde003203b47321d68dfa0647b7b2634f3a642e105a5f313df
- Sigstore transparency entry: 2187601636
- Sigstore integration time: Jul 16, 2026
Source repository:
- Permalink: leelieber2025/scATrans@594786984a33ddd3bd546e549fbce57aed80fa7c
- Branch / Tag: refs/heads/main
- Owner: https://github.com/leelieber2025
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@594786984a33ddd3bd546e549fbce57aed80fa7c
- Trigger Event: workflow_dispatch