SEQUANA

https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)

https://github.com/sequana/sequana/actions/workflows/main.yml/badge.svg?branch=main

https://coveralls.io/repos/github/sequana/sequana/badge.svg?branch=main

JOSS (journal of open source software) DOI

https://img.shields.io/badge/code%20style-black-000000.svg

How to cite:

Citations are important for us to carry on developments. For Sequana library (including the pipelines), please use

Cokelaer et al, (2017), ‘Sequana’: a Set of Snakemake NGS pipelines, Journal of Open Source Software, 2(16), 352, JOSS DOI doi:10.21105/joss.00352

For the genome coverage tool (sequana_coverage): Desvillechabrol et al, 2018: detection and characterization of genomic variations using running median and mixture models. GigaScience, 7(12), 2018. https://doi.org/10.1093/gigascience/giy110

For Sequanix: Desvillechabrol et al. Sequanix: A Dynamic Graphical Interface for Snakemake Workflows Bioinformatics, bty034, https://doi.org/10.1093/bioinformatics/bty034 Also available on bioRxiv (DOI: https://doi.org/10.1101/162701)

🔧 Overview and Installation

Sequana is a Python library dedicated to bioinformatics. It is also a project that includes a set of pipelines related to NGS (new generation sequencing) including quality control, variant calling, coverage, taxonomy, transcriptomics. We also ship Sequanix, a graphical user interface for Snakemake pipelines.

Pipelines and related projects

Here is a non-exhaustive list of tools and pipelines from the project, with users and developers audience.

name/github	description	apptainers
sequana_pipetools	Create and Manage Sequana pipeline	Not required
sequana-wrappers	Set of wrappers to build pipelines	Not required
demultiplex	Demultiplex your raw data	License restriction
denovo	denovo sequencing data
fastqc	Get Sequencing Quality control
LORA	Map sequences on target genome
mapper	Map sequences on target genome
nanomerge	Merge barcoded (or unbarcoded) nanopore fastq and reporting
pacbio_qc	Pacbio quality control
ribofinder	Find ribosomal content
rnaseq	RNA-seq analysis
variant_calling	Variant Calling
multicov	Coverage (mapping)
laa	Long read Amplicon Analysis
revcomp	reverse complement of sequence data
downsampling	downsample sequencing data	Not required
depletion	remove/select reads mapping a reference

Pipelines not yet released
name/github	description	Latest Pypi version	Test passing
trf	Find repeats
multitax	Taxonomy analysis

Please see the documentation for an up-to-date status and documentation.

Contributors

Maintaining Sequana would not have been possible without users and contributors. Each contribution has been an encouragement to pursue this project. Thanks to all:

https://contrib.rocks/image?repo=sequana/sequana

Changelog :memo:

Version	Description
0.25.0	NEW: mmcif.py Parse mmCIF protein structure files; download from RCSB. pairwise.py Needleman-Wunsch/Smith-Waterman alignment substitution_matrices.py BLOSUM45/62/80/90, PAM30/70/250 matrices melting.py DNA/RNA duplex Tm calculation (nearest-neighbor model) phylo_construction.py UPGMA, neighbor-joining, consensus trees fasta2faa.py Nucleotide→protein codec (bioconvert-compatible) canu_scanner.py Parse Canu assembly output checkm.py CheckM quality report parser hmmtools.py HMMER Pfam domtblout to GFF/annotation orthofinder.py OrthoFinder results analyzer (orthogroups, trees) variants.py VCF/BCF variant file reader & analysis NEW: FastAComparison class for comparing FASTA file contents via MD5 checksums, enabling sequence matching across different identifiers. NEW: fasta-compare and fasta2faa CLI commands PERF: Kraken consensus building optimized for large sequences; kmer string processing now 50% faster (caching split operations) PERF: PNG images now linked instead of embedded in HTML reports, reducing HTML file size by ~30% (15MB per report) PERF: Added timing instrumentation to consensus building and HTML generation for better visibility into performance bottlenecks NEW: Phylogenetic analysis modules (phylo.py, alignment.py) Parse and manipulate Newick trees; MSA parsing (PHYLIP, Stockholm, Nexus, FASTA); consensus sequences and alignment statistics NEW: UpSetPlot visualization library for set intersections NEW: Protein 3D structure analysis (pdb.py) Pipeline catalogue expanded with 7 new pipelines
0.24.1	Fix bowtie2 plots being empty when built from the multiqc plot data files (mqc_bowtie2_{se,pe}_plot_1.txt), whose columns are named after the plot legend. Missing columns now raise instead of drawing an empty figure. Restyle the sidebar of the HTML reports: card layout, hover and active section highlighting, responsive below 900px.
0.24.0	NEW: minor_groove_width module predicting the DNA minor groove width with the DNAshape pentamer model NEW: metrics gains compute_curvature (intrinsic curvature of the helix axis, roll-vector model) and compute_sidd (stress-induced duplex destabilization profile) UPDATE: DNA.plot_tracks replaces the hardcoded plot_all_skews panels. Any combination of tracks can be plotted now. UPDATE: somy module computes IGE/IAL metrics (genome expansion and aneuploidy level per isolate), also saved by sequana somy_score Fix multiqc featureCounts parsing (column names differ between multiqc versions and input files)
0.23.0	NEW: repeats sub package with non B-DNA modules. we also moved repeat- related modules in it (e.g. repeats.py) UPDATE: kozak module with cavener rule and ConsensusBuilder UPDATE: iem module updated to include bcl convert support.
0.22.0	Fix salmon argument handlind, Fix kraken analysis workflow, blast table in kraken report, unclassified file creation. add json export to sequana summary, kozakscore to kozak module. Fix html-report on empty VCF (no variant) raising StopIteration.
0.21.2	Update LAA to use the new variant class
0.21.1	Fix bowti2 plot( multiqc parsing)
0.21.0	Kozak: add plot_logo_bits method (information content / bits scaling) Telomere: refactored sliding window, new annotated plot, cleaner API; telomark CLI gains --plot-style option KEGG enrichment: replace selenium with REST API + PIL rendering FastQ: optimised select_reads_in_list (avoid decode overhead) modules_report: remove deprecated SummaryModule classes
0.20.0	Refactoring FASTA and GFF3 modules/classes (less memory). can now handle large eukaryotes as well. Update Kozak module
0.19.6	NEW add gff command rename and improve the add_CDS function in GFF class BUG fix typo in the is_telomeric function BUG Fix regression in kraken analysis
0.19.5	add embl2fasta, fix CDS parents in GFF file
0.19.4	improved TRF module. NEW: added fastq_split and html_report commands. The latter should be used in the future for sequana pipeline HTML reports. Right now, handles VCF file only.
0.19.3	Fixes plotly issue in RNAdiff plot (#872)
0.19.2	NEW new modules related to genomic metrics (zdna, imotif, cruciform,etc) NEW new visualisation tools NEW parser for hmmtools
0.19.1	update pyproject with matploblib, scipy, and all dependencie except snakemake (keep <8.X and its pulp dependency <2.8) because 8.X breaks the containers and therefore all pipelines. no workaround. we will need a snakemake ‘frozen library’. This is unfortunate. CHANGES: remove multiqc plugin quality_control (obsolet) and updated many plugin due to increased version ofmultiqc.
0.19.0	UPDATE pyproject layout to be poetry2.0 compatible. drop support py3.8 NEW: kozak module, somy score, telomere, biomol, rnafold, restriction enzyme UPDATES: sequence module has more metrics (e.g. karlin signature), fastq has a histogram for long reads,
0.18.0	NEW: somy scores (module and standalone) CHANGES: coverage now uses mosdepth for the bam2cov. can also handle creation of the 4-column coverage file from BAM on the fly. Drop python 3.8 support (more and more dependencies issues)
0.17.3	CHANGES: fix https://github.com/sequana/rnaseq/issues/45 to better handle multiqc files especially, feature counts plugin. Fix #855 to be able to name batch effect column arbitrary to any name. Fix batch effect column (and all others) to be strings rather than integer. If integer, factor are sorted based on the integer values, not the factor itself. NEWS: add size factor comments and table.
0.17.2	Pin down pulp<2.8 and snakemake to <8.0 (too many changes in snakemake)
0.17.1	NEW: tsne plot CHANGES: update iem module with additional specs
0.17.0	CHANGE. remove the substractor utility (use sequana_depletion pipeline instead) CHANGE. remove get_max_gc_correlation function from bedtools. not used. CHANGE. Got rid of freebayes_bcf_filter redundant with freebayes_vcf_filter; replace scipy fisher test with own implementation. Remove useless VCF code. FIXES. rnadiff HTML report IMPROV. speedup kegg enrichment using multiprocess IMPROV. sequana_taxonomy can now download toydb and viruses_masking DBs from zenodo NEW function to retrieve the GO terms and genes from panther website NEW keep_reads function in fastq class Major update of the IEM module (renamed IEM class into SampleSheet) NEW addW find-integrated-genes standalone
0.16.9	Major fix on PCA and add batch effect plots in RNAdiff analysis count matrix and DESeq2 output files’ headers fixed with missing index (no impact on analysis but only for those willing to use the CSV files in excel) Taxonomy revisited to save taxonomy.dat in gzipped CSV format.
0.16.8	update IEM for more testing better handling of error in RNADiff Add new methods for ribodesigner
0.16.7	Stable release (fix doc), deprecated.
0.16.6	Refactor IEM to make it more robust with more tests.
0.16.5	refactor to use pyproject instead of setuptools remove pkg_resources (future deprecation) remove unused requirements (cookiecutter, adjusttext, docutuils, mock, psutil, pykwalify) cleanup resources (e.g. moving canvas/bar.py into viz)
0.16.4	hot fixes on RNAdiff reports and enrichments
0.16.3	Remove all rules (see https://github.com/sequana/sequana-wrappers) instead add precommit for developers and applied to all modules and doc Fix wrong import for sequana standalone (regression)
0.16.2	save coverage PNG image (regression) Update taxonomy/coverage standalone (regression) and more tests
0.16.1	hotfix missing module
0.16.0	add mpileup module homogenization enrichment + fixup rnadiff Complete refactoring of sequana coverage module. Allow sequana_coverage to handle small eukaryotes in a more memory efficient way. use click for the sequana_taxonomy and sequana_coverage and sequana rnadiff command Small fixup on homer, idr and phantom modules (for chipseq pipeline)
0.15.4	add plot for rnaseq/rnadiff
0.15.3	add sequana.viz.plotly module. use tqdm in bamtools module KEGG API changed. We update sequana to use headless server and keep the feature of annotated and colored pathway. Various improvements on KEGG enrichment including saving pathways, addition –comparison option in sequana sub-command, plotly plots, etc
0.15.2	ribodesigner can now accept an input fasta with no GFF assuming the fasta already contains the rRNA sequences Fix IEM module when dealing with double indexing Fix anchors in HTML reports (rnadiff module) refactorise compare module to take several rnadiff results as input enrichment improvements (export KEGG and GO as csv files
0.15.1	Fix creation of images directory in modules report add missing test related to gff Fix #804
0.15.0	add logo in reports RNADiff reports can now use shrinkage or not (optional) remove useless rules now in sequana-wrappers update main README to add LORA in list of pipelines Log2FC values are now shrinked log2FC values in volcano plot and report table. “NotShrinked” columns for Log2FC and Log2FCSE prior shrinkage are displayed in report table.
0.14.6	add fasta_and_gff_annotation module to correct fasta and gff given a vcf file. add macs3 module to read output of macs3 peak detector. add idr module to read results of idr analysis add phantom module to compute phantom peaks add homer module to read annotation files from annotatePeaks
0.14.5	move start_pipeline standalone in https://github.com/sequana/sequana_pipetools update snpeff module to allows build command to have options
0.14.4	hotfix bug on kegg colorised pathways Fix the hover_name in rnadiff volcano plot to include the index/attribute. pin snakemake to be >=7.16
0.14.3	new fisher metric in variant calling; support several features in rnaseq/rnadiff pin several libaries due to regression during installs
0.14.2	Update ribodesigner
0.14.1	Kegg enrichment improvements; new uniprot module for GO term enrichment
0.14.0	pinned click>=8.1.0; ribodesigner new plots, clustering and notebook
0.13.X	Remove useless standalones or moved to main sequana command Move sequana_lane_merging into a subcommand (sequana lane_merging) General cleanup of documentation, test and links to pipelines add new ribodesigner subcommand
0.12.X	remove some rules now in https://github.com/sequana/sequana-wrappers refactorisation of VCF tools/modules to use vcfpy instead of pyVCF complete change log before 0.12.4 in the github /doc/Changelog.txt

Any :question: Feel free to [open an issue](https://github.com/sequana/sequana/issues)

Metadata

Release files for sequana 0.25.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sequana 0.25.0
File	Size	Uploaded
sequana-0.25.0.tar.gz	2.5 MB	Oct 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for sequana 0.25.0
File	Interpreter	ABI	Platform	Reset
sequana-0.25.0-py3-none-any.whl 2.7 MB Oct 5, 2026	Python 3	none	any	Details

Total release size: 5.2 MB

Release files / sequana-0.25.0.tar.gz

Download URL	sequana-0.25.0.tar.gz
Size	2.5 MB
Tags	Source
SHA-256 checksum How to use checksums	`14d2daca3d59ddab6791deb0bb451c4bd3f4ea492d7bacc4bcd8b1808fccdd1b`
BLAKE2b-256 checksum How to use checksums	`42908caa07fb65b6190785a3aed8acf8ad26b0ea8f7b4bc4924c911f476b02e6`
Upload date	Oct 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / sequana-0.25.0-py3-none-any.whl

Download URL	sequana-0.25.0-py3-none-any.whl
Size	2.7 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`a5a87b58e2f2c75dc66350de8fb7e92a98ee3208c308aeccb5a69f3503019035`
BLAKE2b-256 checksum How to use checksums	`1133429e67c3a92d314a3abf40c3c59757b10e481f99ff529520c672dbd39fc0`
Upload date	Oct 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`