orthosynassign¶
orthosynassign is the main program for running the synteny-based orthogroup partitioning analysis. It takes an OrthoFinder-style Orthogroups.tsv file (or N0.tsv under the phylogenetic hierarchical orthogroups directory) and outputs syntenic orthogroups (SOGs) of positional orthologs, using the genome annotation BED files described in Preparing Input Files.
Command Syntax¶
orthosynassign --og_file OG_FILE --bed FILE [FILE ...] [OPTIONS]
Example:
orthosynassign --og_file orthogroups.tsv --bed *.bed -o Refined_SOGs.tsv
Arguments & Options Reference¶
Required Arguments¶
Flag |
Long Flag |
Description |
|---|---|---|
|
Path to OrthoFinder |
|
|
Path of BED formatted genome annotation files. Space-separated list. |
Options¶
Flag |
Long Flag |
Default |
Description |
|---|---|---|---|
|
|
|
Controls how many total genes are considered when determining synteny for a single gene. |
|
|
|
Controls how many genes within a window must provide synteny support to classify the genes being compared as syntenous. |
|
|
|
Output of results. |
|
|
|
Number of CPUs to use. |
|
|
|
Enable verbose logging. |
|
|
Show program’s version number and exit. |
|
|
|
Show help message and exit. |
Examples¶
Specify bed files separately:
orthosynassign --og_file orthogroup.tsv --bed file1.bed file2.bed file3.bed
Specify all bed files in a directory and processed in parallel with 6 CPUs:
orthosynassign --og_file orthogroup.tsv --bed *.bed -t 6
Specify output file name for results:
orthosynassign --og_file orthogroup.tsv --bed *.bed -o Refined_SOGs.tsv
Specify window size and ratio threshold:
orthosynassign --og_file orthogroup.tsv --bed *.bed -w 10 -r 0.8
With verbose output:
orthosynassign --og_file orthogroup.tsv --bed *.bed -v
Tuning Window and Ratio Threshold¶
--windowsets how many neighboring genes (total, across the comparison) are inspected when evaluating whether a gene pair is syntenic. A larger window tolerates more genomic rearrangement between the compared genomes at the cost of more permissive matching.--ratio_thresholdsets the minimum fraction of genes within that window that must show synteny support before a gene pair is classified as syntenic. Raising this threshold makes the partitioning stricter (fewer, more confident SOGs); lowering it is more permissive.
The defaults (window=8, ratio_threshold=0.5) are recommended starting points — see Pipeline Architecture & Benchmarks for details on how the synteny-based partitioning algorithm works.
Performance¶
The core synteny-comparison engine is implemented in Rust, exposed to the --threads option for multithreaded execution. Benchmarks across 193 Eurotiomycetes genomes show strong scalability with additional threads and a memory footprint that stays bounded regardless of thread count — see Pipeline Architecture & Benchmarks for details.