AmbiDose
AmbiDose removes ambient RNA from droplet scRNA-seq. Empty droplets
estimate the soup profile χ. Each cell receives an operational dose
d_c = ρ_c · n_c. Type-aware subtraction writes non-negative integer
counts. The method does not correct batch effects or assign cell types.
Docs: Read the Docs.
Install
pip install ambidose
# or: conda install -c conda-forge -c bioconda ambidose
Python 3.10–3.13. A GPU is not required. Details: installation.
First run
import scanpy as sc
import ambidose as amdose
adata = sc.read_10x_mtx("filtered_feature_bc_matrix/")
adata = amdose.denoise(adata, raw="raw_feature_bc_matrix.h5", sample_key=None)
# adata.X is denoised integer UMI; original counts in layers["raw_counts"]
ambidose denoise --input /path/to/outs --output cleaned.h5ad
Treat rho as an operational dose. Check obs["ambidose_rho_trust"] and
the QC report before using it as a contamination rate.
Status
0.5.9 (Alpha). Import as import ambidose as amdose. The entry point is
denoise(). See the
API reference.
Next steps
Citation
Pin the package version used in the analysis, for example ambidose==0.5.9.
Software record: 10.5281/zenodo.22278199.
See CITATION.cff and the citation page.
@software{li2026ambidose,
title = {AmbiDose: per-cell ambient dose removal for droplet scRNA-seq},
author = {Li, Zhao},
year = {2026},
version = {0.5.9},
doi = {10.5281/zenodo.22278199},
url = {https://doi.org/10.5281/zenodo.22278199},
}
License
Software: Apache License 2.0.
Author
Zhao Li (李钊) Email: leelieber@gmail.com
1 maintainer
Metadata
1 maintainer
Release files for ambidose 0.5.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ambidose-0.5.9.tar.gz | 483.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ambidose-0.5.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 599.7 kB
Release files / ambidose-0.5.9.tar.gz
| Download URL | ambidose-0.5.9.tar.gz |
|---|---|
| Size | 483.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
57fbca88b9eaf96872be1e9aeed59c4f362458f59f3c7465538e2a4166ec1664
|
|
BLAKE2b-256 checksum How to use checksums |
b3e3c89bfe895b7fda79141f51622fef47964b7bede55031fa3e3d6b8a36506e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 20, 2026.
Transparency logRelease files / ambidose-0.5.9-py3-none-any.whl
| Download URL | ambidose-0.5.9-py3-none-any.whl |
|---|---|
| Size | 115.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e6da178e748cdc64f574f27d970373decbd669d916a18d325a237b4d6a840fe5
|
|
BLAKE2b-256 checksum How to use checksums |
8e9d419a88d565389a5e4222c26bec5bf63a48c778ad671c7987c23f8ae09525
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 20, 2026.
Transparency log
