Quick Start

This walkthrough uses the example dataset bundled in the example directory of the repository, which contains three fungal BED annotations and an orthogroup file:

FungiDB-68_AfumigatusA1163.bed
FungiDB-68_AfumigatusAf293.bed
FungiDB-68_AnovofumigatusIBT16806.bed
orthogroups.tsv

1. Run the Partitioning

From within the example directory, run:

orthosynassign --og_file orthogroups.tsv --bed *.bed -o Refined_SOGs.tsv

This partitions the OrthoFinder-style orthogroups.tsv into SOGs using synteny information from the three BED files and writes the result to Refined_SOGs.tsv. See orthosynassign for all available options (window size, ratio threshold, thread count, etc.).


2. Visualize a Syntenic Orthogroup

To verify a specific syntenic orthogroup (SOG), e.g. SOG000023.OG0000025, plot it against its original OrthoFinder orthogroup context:

orthosynassign-vis --og_file orthogroups.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000023.OG0000025 -f svg

The figure is written to visualize_Refined_SOGs/SOG000023.OG0000025.svg. See orthosynassign-vis for all available options, including -c/--combine to plot multiple SOGs in a single figure.

In the resulting figure:

  • Genes belonging to the observed SOG are labelled in yellow.

  • Genes assigned to the same orthogroup within the given window are labelled in other chromatic colors.

  • Genes with orthologs that are not syntenic within the given window are labelled in gray.

Syntenic orthogroup SOG000023

Next Steps