orthoSynAssign¶
orthoSynAssign (Ortholog Synteny Assignment Tool) is a Python tool to partition orthogroups into syntenic orthogroups (SOGs) of positional orthologs using synteny information inferred from genome annotation files (BED converted from GFF3/GTF). It is a Python re-implementation of OrthoRefine, addressing sample-matching and memory-usage issues in the original C++ tool, and is designed to be more efficient, easier to use, and more flexible for custom analyses.
Described in the preprint: orthoSynAssign: refine orthogroups using synteny information (bioRxiv, 2026).
Key Features¶
Synteny-based Partitioning: Splits complex, many-to-many OrthoFinder orthogroups into high-granularity, single-copy syntenic orthogroups (SOGs) by comparing gene-neighborhood context across genomes.
Hybrid Python/Rust Architecture: An intuitive Python command-line interface wraps a core synteny-comparison engine written in Rust, giving straightforward installation, seamless data parsing, and exceptional computational efficiency.
Isoform-aware Parsing: Use semicolon-delimited multi-isoform protein IDs in BED annotation files to resolve isoform-related mapping issues automatically.
Multithreaded & Scalable: Benchmarked across 193 Eurotiomycetes genomes with strong multithreading scalability, drastically reduced runtime, and a strictly bounded, thread-independent memory footprint.
Configurable Synteny Window: Tunable window size and synteny-support ratio threshold let users control the stringency of synteny-based orthogroup splitting.
Companion Visualization Tool:
orthosynassign-visuses pyGenomeViz to plot SOGs and their syntenic context for manual verification of results.
Pipeline Flowchart¶
Pipeline Overview¶
Convert genome annotation files (GFF3/GTF) to BED format with
misc/gff2bed.py, collapsing isoforms into semicolon-delimited protein ID lists.Run
orthosynassignon an OrthoFinderOrthogroups.tsv(orN0.tsv) file plus the BED annotation files to partition them into syntenic orthogroups (SOGs).Optionally verify individual SOGs with
orthosynassign-vis, which renders a synteny plot for a chosen SOG using pyGenomeViz.
Contents¶
Installation — Bioconda, Pixi, source, release tarball, and the developer setup.
Preparing Input Files — OrthoFinder orthogroup files, converting GFF3/GTF to BED with
gff2bed.py, and the isoform delimiter convention.Quick Start — Walkthrough using the bundled
exampledataset.Command reference: orthosynassign · orthosynassign-vis
Pipeline Architecture & Benchmarks — Algorithm overview and multithreading scalability benchmarks from the preprint.
Citation and References — Publication metadata and citations for underlying dependencies.