orthosynassign-vis¶
orthosynassign-vis is a companion visualization script used to verify the SOGs produced by orthosynassign. It uses pyGenomeViz to plot orthogroups and their synteny relationships, taking the original orthogroup.tsv alongside the SOG output and plotting selected SOGs using their previous orthogroup IDs as gene labels.
Command Syntax¶
orthosynassign-vis --og_file OG_FILE --sog_file SOG_FILE --bed FILE [FILE ...] --sog SOG [SOG ...] [OPTIONS]
Example:
orthosynassign-vis --og_file orthogroups.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000023.OG0000025 -f svg
Arguments & Options Reference¶
Required Arguments¶
Flag |
Long Flag |
Description |
|---|---|---|
|
Path to the original |
|
|
Path to the SOG ( |
|
|
Path of BED formatted genome annotation files. Space-separated list. |
|
|
Plot the SOG(s) produced by the previous |
Options¶
Flag |
Long Flag |
Default |
Description |
|---|---|---|---|
|
|
|
The window size applied to the previous |
|
|
|
Output directory. |
|
|
|
Output image format ( |
|
|
|
Keep genes that are not assigned to any orthogroup. |
|
|
|
Combine all SOGs in a single figure file |
|
|
|
Enable verbose logging. |
|
|
Show program’s version number and exit. |
|
|
|
Show help message and exit. |
Note
--window should match the -w/--window value used in the original orthosynassign run being visualized, so that the plotted genomic context matches the window that was actually used for synteny support during partitioning.
--sog accepts one or more SOG IDs, each rendered as its own figure by default (<output>/<sog_id>.<fmt>). Pass -c/--combine to instead render all requested SOGs together into a single <output>/combined.<fmt> figure:
orthosynassign-vis --og_file orthogroups.tsv --sog_file Refined_SOGs.tsv --bed *.bed \
--sog SOG000023.OG0000025 SOG000024.OG0000025 SOG000025.OG0000025 -c -f svg
Examples¶
Plot multiple SOGs, each as its own figure:
orthosynassign-vis --og_file orthogroup.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000001.OG0000001 SOG000002.OG0000007
Combine multiple SOGs into a single figure:
orthosynassign-vis --og_file orthogroup.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000001.OG0000001 SOG000002.OG0000007 -c
Specify output directory for figures:
orthosynassign-vis --og_file orthogroup.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000001.OG0000001 -o fig
Specify window size applied in the previous orthosynassign analysis:
orthosynassign-vis --og_file orthogroup.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000001.OG0000001 -w 10
Save in svg format:
orthosynassign-vis --og_file orthogroup.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000001.OG0000001 -f svg
With verbose output:
orthosynassign-vis --og_file orthogroup.tsv --sog_file Refined_SOGs.tsv --bed *.bed --sog SOG000001.OG0000001 -v
Reading the Output 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.
Pass
-k/--keep_all_genesto additionally display genes that were not assigned to any orthogroup.
Single SOG Figures (default)¶
The image is written to <output>/<sog_id>.<fmt>, e.g. visualize_Refined_SOGs/SOG000023.OG0000025.svg:
Combined Figure (-c/--combine)¶
The image is written to <output>/combined.<fmt>: