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.
Next Steps¶
Read Preparing Input Files to prepare your own BED files from GFF3/GTF annotations.
See Pipeline Architecture & Benchmarks to understand how the synteny-based partitioning algorithm works and how it scales.