scATrans

scATrans answers a simple follow-up after differential expression (DE): among the genes that changed, which look transcription-driven and which look stabilization-driven? It uses the nascent (unspliced) residual on top of a normal DE step—something total-count fold change alone cannot sort out.

Step	What it does
DE	Chooses which genes make the list
Mechanism	Labels those genes (transcription vs. stabilization)
Detection (optional)	Extra nascent-activity scores; does not rewrite mechanism labels

Pathway- or program-level summaries (gene_sets=) are usually more useful than single-gene labels. Without spliced/unspliced layers, the package still runs ordinary DE, enrichment, and plots.

Docs: Read the Docs.

What you need

Python 3.9+ (tested 3.9–3.12)
An AnnData object with a condition column in .obs
For mechanism analysis: spliced/unspliced (or mature/nascent) layers

Install

pip install scatrans
# or: conda install -c conda-forge -c bioconda scatrans

Optional extras (PyDESeq2, GSEA, scVelo, …): installation guide.

First run

import scatrans as scat

result = scat.partition_de_by_mechanism(
    adata,  # needs spliced/unspliced or mature/nascent layers
    groupby="condition",
    target_group="Disease",
    reference_group="Control",
    organism="mouse",  # or "human"
    de="builtin",
    # sample_col="sample",   # set this when you have biological replicates
    # gene_sets=my_pathways, # optional pathway / program table
    # induction_matched=True,
)
print(result.regime)           # data-quality check on unspliced capture
print(result.selected.head())  # DE genes + soft mechanism labels
print(result.summary())
# Absolute program placement (optional):
# scat.program_mechanism_permutation_calibrated(adata, gene_sets, de=frozen_de, ...)

That is the recommended entry point. Next:

Quickstart
Tutorials
FAQ if something looks off

Status

0.10.x (Beta). Import as import scatrans as scat and stick to names in scatrans.__all__, scat.pl, and scat.qc. Details: API stability.

Citation

Cite the Zenodo DOI above (and the manuscript when available). For analyses tied to package version 0.10.9, use scatrans==0.10.9. See CITATION.cff.

License

Software: Apache License 2.0. Bundled GO/KEGG data may carry separate terms—see the license page before commercial redistribution.

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.9.tar.gz (14.4 MB view details)

Uploaded Jul 25, 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.9-py3-none-any.whl (9.1 MB view details)

Uploaded Jul 25, 2026 Python 3

File details

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

File metadata

Download URL: scatrans-0.10.9.tar.gz
Upload date: Jul 25, 2026
Size: 14.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for scatrans-0.10.9.tar.gz
Algorithm	Hash digest
SHA256	`4bd2f55e719b8165a806658857ff3844abe5a5704d02532de4c7d059651491b6`
MD5	`c5b38350131befb3aa187dcd9414d55b`
BLAKE2b-256	`22c6b6847ef3b9a3cbb62632a4c34f5a2eb01fef700bb5aad147376af39b7318`

See more details on using hashes here.

Provenance

The following attestation bundles were made for scatrans-0.10.9.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.9.tar.gz
- Subject digest: 4bd2f55e719b8165a806658857ff3844abe5a5704d02532de4c7d059651491b6
- Sigstore transparency entry: 2247942407
- Sigstore integration time: Jul 25, 2026
Source repository:
- Permalink: leelieber2025/scATrans@edb5694e9f2a59abfa23dacc95364ace4a150514
- 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@edb5694e9f2a59abfa23dacc95364ace4a150514
- Trigger Event: workflow_dispatch