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, with core synteny analysis implemented in Rust for speed and efficiency.
Described in the preprint: orthoSynAssign: refine orthogroups using synteny information (bioRxiv, 2026).
conda install bioconda::orthosynassignpixi global install -c bioconda orthosynassignFor alternative installation options (source, developer setup), see the Installation Guide.
cd example
# Partition OrthoFinder orthogroups into SOGs using synteny from the BED annotation files
orthosynassign --og_file orthogroups.tsv --bed *.bed -o Refined_SOGs.tsv
# Visualize a syntenic orthogroup (SOG) for verification
orthosynassign-vis --og_file orthogroups.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000023.OG0000025 -f svgDetailed documentation, full CLI argument references, and technical deep-dives are available at orthosynassign.readthedocs.io:
- Installation — Bioconda, Pixi, source, and 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 — Main partitioning command: options, window/ratio thresholds, output format.
- orthosynassign-vis — Visualization command for verifying SOGs.
- Pipeline Architecture & Benchmarks — Algorithm overview and multithreading scalability benchmarks.
- Citation and References — Publication metadata and citations for underlying dependencies.
If you use orthoSynAssign in your research, please cite:
Tsai, C.-H., Pina Paez, C. G., & Stajich, J. E. (2026). orthoSynAssign: refine orthogroups using synteny information. bioRxiv. DOI: 10.64898/2026.08.10.744007
Contributions are welcome! Please feel free to submit a Pull Request.