consenrich 0.1.12b0

Genome-wide extraction of reproducible continuous-valued signals hidden in noisy multisample functional genomics data

Consenrich

Consenrich is a sequential genome-wide state estimator for extraction of reproducible, spatially-resolved, epigenomic signals hidden in noisy multisample HTS data. The corresponding manuscript preprint is available on bioRxiv.

---

• Input:

  • $m \geq 1$ Sequence alignment files -t/--bam_files corresponding to each sample in a given HTS experiment
  • (Optional): $m_c = m$ control sample alignments, -c/--control_files, for each 'control' sample (e.g., ChIP-seq)
  • (Optional): wavelet-based template(s) to match for genome-wide pattern localization (--match_wavelet db<2,3,...>, sym<2,3,...>, haar, coif<1,2,...>, dmey)

• Output:

  • Genome-wide 'consensus' epigenomic state estimates and uncertainty metrics (BedGraph/BigWig)
  • (Optional) BED-like output of relative maxima in the cross-correlation with wavelet-based template(s)

Example: Consenrich outputs given 10 input ATAC-seq samples (lymphoblastoid) consenrich --bam_files ENCFF*.bam -g hg38 --match_wavelet db2 --step 25 --delta 0.50

---

Features

• Consenrich yields uncertainty-moderated signal tracks that effectively encompass multiple samples' epigenomic profiles $\implies$ Insightful data representation for profiling condition-specific regulatory landscapes (e.g., differential analyses).

• Consenrich resolves legitimate spatial features in epigenomic signals while attenuating noise $\implies$ Enables efficient $O(n \log n)$ genome-wide multi-sample pattern localization for deeper profiling of signal trends or to subdivide broadly enriched regions (peaks).

• Consenrich explicitly models dynamic signal trends and noise profiles for each sample with scale-invariance $\implies$ Multi-sample, multi-assay estimation of target molecular states from related functional genomics assays, e.g., ChIP-seq + CUT-N-RUN, ATAC-seq + DNase-seq.

Download/Install

Consenrich is available via PyPI/pip:

• python -m pip install consenrich

If lacking administrative privileges, running with flag --user may be necessary.

---

Consenrich can also be easily downloaded and installed from source:

1. git clone https://github.com/nolan-h-hamilton/Consenrich.git
2. cd Consenrich
3. python setup.py sdist bdist_wheel
4. python -m pip install .
5. Check installation: consenrich --help

Manuscript Preprint and Citation

Genome-Wide Uncertainty-Moderated Extraction of Signal Annotations from Multi-Sample Functional Genomics Data
Nolan H Hamilton, Benjamin D McMichael, Michael I Love, Terrence S Furey; doi: 10.1101/2025.02.05.636702

---

BibTeX

@article {Hamilton2025
	author = {Hamilton, Nolan H and McMichael, Benjamin D and Love, Michael I and Furey, Terrence S},
	title = {Genome-Wide Uncertainty-Moderated Extraction of Signal Annotations from Multi-Sample Functional Genomics Data},
	year = {2025},
	doi = {10.1101/2025.02.05.636702},
	url = {https://www.biorxiv.org/content/10.1101/2025.02.05.636702v1},
}