# syntenet as a synteny detection tool

# Introduction

Although syntenet was designed for large-scale synteny analyses (i.e., with tens of genomes), users might also be interested in using syntenet as a simple synteny detection tool. For example, one can use syntenet to identify syntenic regions in a genome (intraspecies synteny), or to identify syntenic regions between the genomes of two species (interspecies synteny). To detect synteny, syntenet uses its own implementation of the MCScanX algorithm (Wang et al. 2012), ported to R thanks to the Rcpp package for R and C++ integration. In this vignette, we will guide you on how to perform intra and interspecies synteny with syntenet.

    library(syntenet)

# Detecting intragenome synteny

To detect intragenome (or intraspecies) synteny, you will use the function `intraspecies_synteny`. As input, you will need:

1. A `GRangesList` object containing the processed annotation for your species of interest, as returned by `process_input()`.

2. A list of data frames with the output of similarity search programs (e.g., DIAMOND, BLAST, etc). Only intragenome comparisons must be included. This can be obtained with `run_diamond(seq, compare = "intraspecies")`.

To demonstrate the usage of `intraspecies_synteny()`, let’s identify syntenic regions in the genome of Saccharomyces cerevisiae. The processed annotation and DIAMOND output are stored in the example data sets `scerevisiae_annot` and `scerevisiae_diamond`.

    # Load example data sets
    data(scerevisiae_annot)
    head(scerevisiae_annot)
    #> $Scerevisiae
    #> GRanges object with 6600 ranges and 1 metadata column:
    #>          seqnames        ranges strand |          gene
    #>             <Rle>     <IRanges>  <Rle> |   <character>
    #>      [1]    Sce_I       335-649      * |   Sce_YAL069W
    #>      [2]    Sce_I       538-792      * | Sce_YAL068W-A
    #>      [3]    Sce_I     1807-2169      * |   Sce_YAL068C
    #>      [4]    Sce_I     2480-2707      * | Sce_YAL067W-A
    #>      [5]    Sce_I     7235-9016      * |   Sce_YAL067C
    #>      ...      ...           ...    ... .           ...
    #>   [6596]  Sce_XVI 939922-941136      * |   Sce_YPR201W
    #>   [6597]  Sce_XVI 943032-943896      * |   Sce_YPR202W
    #>   [6598]  Sce_XVI 943880-944188      * |   Sce_YPR203W
    #>   [6599]  Sce_XVI 944603-947701      * |   Sce_YPR204W
    #>   [6600]  Sce_XVI 946856-947338      * | Sce_YPR204C-A
    #>   -------
    #>   seqinfo: 17 sequences from an unspecified genome; no seqlengths

    data(scerevisiae_diamond)
    names(scerevisiae_diamond)
    #> [1] "Scerevisiae_Scerevisiae"
    head(scerevisiae_diamond$Scerevisiae_Scerevisiae)
    #>         query          db perc_identity length mismatches gap_open qstart qend
    #> 1 Sce_YLR106C Sce_YLR106C         100.0   4910          0        0      1 4910
    #> 2 Sce_YKR054C Sce_YKR054C         100.0   4092          0        0      1 4092
    #> 3 Sce_YHR099W Sce_YHR099W         100.0   3744          0        0      1 3744
    #> 4 Sce_YDR457W Sce_YDR457W         100.0   3268          0        0      1 3268
    #> 5 Sce_YDR457W Sce_YER125W          44.1    354        195        3   2913 3266
    #> 6 Sce_YDR457W Sce_YJR036C          30.7    378        228       12   2913 3266
    #>   tstart tend   evalue bitscore
    #> 1      1 4910 0.00e+00     9095
    #> 2      1 4092 0.00e+00     7940
    #> 3      1 3744 0.00e+00     7334
    #> 4      1 3268 0.00e+00     6170
    #> 5    457  807 2.18e-91      315
    #> 6    523  890 7.99e-44      172

Once we have the data, we can detect synteny with `intraspecies_synteny()`. This function returns the path to the .collinearity files generated by MCScanX (Wang et al. 2012), which can be read and parsed with the `parse_collinearity()` function.

    # Detect intragenome synteny
    intra_syn <- intraspecies_synteny(
        scerevisiae_diamond, scerevisiae_annot
    )

    intra_syn # see where the .collinearity file is
    #> [1] "/tmp/RtmpX4RabB/intra/Scerevisiae.collinearity"

    # Get anchor pairs from .collinearity file
    anchors <- parse_collinearity(intra_syn)
    head(anchors)
    #>       Anchor1       Anchor2
    #> 1 Sce_YAR050W   Sce_YHR211W
    #> 2 Sce_YAR060C   Sce_YHR212C
    #> 3 Sce_YAR064W Sce_YHR213W-B
    #> 4 Sce_YAR066W   Sce_YHR214W
    #> 5 Sce_YAR068W Sce_YHR214W-A
    #> 6 Sce_YAR069C Sce_YHR214C-D

By default, the output of `parse_collinearity()` is a 2-column data frame with anchor pairs in syntenic regions. You can also extract data on each synteny block (or synteny region) by specifying `as = 'blocks'`.

    # Get synteny block information with `parse_collinearity()`
    blocks <- parse_collinearity(intra_syn, as = "blocks")
    head(blocks)
    #>   Block Block_score            Chr Orientation
    #> 1     0         446 Sce_I&Sce_VIII        plus
    #> 2     1         528   Sce_I&Sce_XV       minus
    #> 3     2         572  Sce_II&Sce_IV        plus
    #> 4     3         643   Sce_II&Sce_V       minus
    #> 5     4         446 Sce_II&Sce_XVI        plus
    #> 6     5         422 Sce_III&Sce_IV       minus

You can even extract both anchor pairs and synteny block data at once in a single data frame.

    # Get anchors and block data with `parse_collinearity()`
    intrasyn_all <- parse_collinearity(intra_syn, as = "all")
    head(intrasyn_all)
    #>   Block Block_score            Chr Orientation     Anchor1       Anchor2
    #> 1     0         446 Sce_I&Sce_VIII        plus Sce_YAR050W   Sce_YHR211W
    #> 2     0         446 Sce_I&Sce_VIII        plus Sce_YAR060C   Sce_YHR212C
    #> 3     0         446 Sce_I&Sce_VIII        plus Sce_YAR064W Sce_YHR213W-B
    #> 4     0         446 Sce_I&Sce_VIII        plus Sce_YAR066W   Sce_YHR214W
    #> 5     0         446 Sce_I&Sce_VIII        plus Sce_YAR068W Sce_YHR214W-A
    #> 6     0         446 Sce_I&Sce_VIII        plus Sce_YAR069C Sce_YHR214C-D

# Detecting intergenome synteny

To detect intergenome (or interspecies) synteny, you will use the function `interspecies_synteny`, which works very similarly to `intraspecies_synteny()`. As input, you will need:

1. A `GRangesList` object containing the processed annotation for your species of interest (2+ species), as returned by `process_input()`.

2. A list of data frames with the output of similarity search programs (e.g., DIAMOND, BLAST, etc). Only intergenome comparisons must be included. This can be obtained with `run_diamond(seq, compare = compare_df)`.

Importantly, to detect intergenome synteny, the MCScanX algorithm requires bidirectional BLAST hits. For instance, if you’re trying to detect synteny between `spA` and `spB`, you need to perform DIAMOND/BLAST searches in both directions: `spA_spB` and `spB_spA`. You can create a data frame specifying these comparisons as follows:

    # Create a data frame with comparisons to be made
    comp <- data.frame(
        query = "spA",
        db = "spB"
    )
    comp
    #>   query  db
    #> 1   spA spB

    # Make comparisons bidirectional
    comp_bi <- make_bidirectional(comp)
    comp_bi
    #>   query  db
    #> 1   spA spB
    #> 2   spB spA

Then, you can peform similarity searches for these comparisons with:

    # NOTE: Not executed because object `seq` doesn't exist; for demo only
    dmd_inter <- run_diamond(seq, compare = comp_bi)

The code above would generate a list of two data frames with DIAMOND tables: one named `spA_spB`, and another one named `spB_spA`.

To demonstrate what this looks like, we will load the example data set we will use to detect intergenome synteny. Here, we will detect syntenic regions between the genomes of the algae Ostreococcus lucimarinus and Ostreococcus sp RCC809. The list of DIAMOND tables is stored in object `blast_list`, and we will create the processed annotation from objects `proteomes` and `annotation`.

    # Load list of DIAMOND tables
    data(blast_list)
    names(blast_list)
    #> [1] "Olucimarinus_Olucimarinus" "Olucimarinus_OspRCC809"
    #> [3] "OspRCC809_Olucimarinus"    "OspRCC809_OspRCC809"

    algae_inter <- blast_list[c(2,3)] # keep only intergenome comparisons
    names(algae_inter)
    #> [1] "Olucimarinus_OspRCC809" "OspRCC809_Olucimarinus"

    # Get processed annotation
    data(proteomes)     # A list of `AAStringSet` objects
    data(annotation)    # A `GRangesList` object

    pdata <- process_input(proteomes, annotation)
    names(pdata$annotation)
    #> [1] "Olucimarinus" "OspRCC809"

Now that we have a list of DIAMOND tables with bidirectional comparisons between Olucimarinus and OspRCC809, as well as annotation for these two genomes, we can detect synteny with `interspecies_synteny()`. Like `intraspecies_synteny()`, this function will return the path to a .collinearity file generated by MCScanX, and we can parse this file with `parse_collinearity()`.

    # Detect interspecies synteny
    intersyn <- interspecies_synteny(algae_inter, pdata$annotation)

    intersyn # see where the .collinearity file is
    #> [1] "/tmp/RtmpX4RabB/inter/Olucimarinus_OspRCC809.collinearity"

    # Parse collinearity file
    ## 1) Get anchor pairs
    algae_anchors <- parse_collinearity(intersyn)
    head(algae_anchors)
    #>          Anchor1              Anchor2
    #> 1 Olu_OL01G00100 Osp_ORCC809_01G06480
    #> 2 Olu_OL01G00130 Osp_ORCC809_01G06440
    #> 3 Olu_OL01G00150 Osp_ORCC809_01G06420
    #> 4 Olu_OL01G00160 Osp_ORCC809_01G06410
    #> 5 Olu_OL01G00170 Osp_ORCC809_01G06400
    #> 6 Olu_OL01G00180 Osp_ORCC809_01G06390

    ## 2) Get synteny blocks
    algae_blocks <- parse_collinearity(intersyn, as = "blocks")
    head(algae_blocks)
    #>   Block Block_score                 Chr Orientation
    #> 1     0       27234 Olu_Chr_1&Osp_chr_1       minus
    #> 2     1         299 Olu_Chr_2&Osp_chr_2        plus
    #> 3     2         296 Olu_Chr_2&Osp_chr_2        plus
    #> 4     3         287 Olu_Chr_2&Osp_chr_2        plus
    #> 5     4        7548 Olu_Chr_2&Osp_chr_2       minus
    #> 6     5        4578 Olu_Chr_2&Osp_chr_2       minus

    ## 3) Get all data combined (blocks + anchor pairs)
    algae_all <- parse_collinearity(intersyn, as = "all")
    head(algae_all)
    #>   Block Block_score                 Chr Orientation        Anchor1
    #> 1     0       27234 Olu_Chr_1&Osp_chr_1       minus Olu_OL01G00100
    #> 2     0       27234 Olu_Chr_1&Osp_chr_1       minus Olu_OL01G00130
    #> 3     0       27234 Olu_Chr_1&Osp_chr_1       minus Olu_OL01G00150
    #> 4     0       27234 Olu_Chr_1&Osp_chr_1       minus Olu_OL01G00160
    #> 5     0       27234 Olu_Chr_1&Osp_chr_1       minus Olu_OL01G00170
    #> 6     0       27234 Olu_Chr_1&Osp_chr_1       minus Olu_OL01G00180
    #>                Anchor2
    #> 1 Osp_ORCC809_01G06480
    #> 2 Osp_ORCC809_01G06440
    #> 3 Osp_ORCC809_01G06420
    #> 4 Osp_ORCC809_01G06410
    #> 5 Osp_ORCC809_01G06400
    #> 6 Osp_ORCC809_01G06390

# Session information

This document was created under the following conditions:

    sessionInfo()
    #> R version 4.5.2 (2025-10-31)
    #> Platform: x86_64-pc-linux-gnu
    #> Running under: Ubuntu 24.04.4 LTS
    #>
    #> Matrix products: default
    #> BLAS:   /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
    #> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so;  LAPACK version 3.12.0
    #>
    #> locale:
    #>  [1] LC_CTYPE=en_US.UTF-8       LC_NUMERIC=C
    #>  [3] LC_TIME=en_US.UTF-8        LC_COLLATE=C
    #>  [5] LC_MONETARY=en_US.UTF-8    LC_MESSAGES=en_US.UTF-8
    #>  [7] LC_PAPER=en_US.UTF-8       LC_NAME=C
    #>  [9] LC_ADDRESS=C               LC_TELEPHONE=C
    #> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
    #>
    #> time zone: Etc/UTC
    #> tzcode source: system (glibc)
    #>
    #> attached base packages:
    #> [1] stats     graphics  grDevices utils     datasets  methods   base
    #>
    #> other attached packages:
    #> [1] ggtree_4.0.4     syntenet_1.12.0  BiocStyle_2.38.0
    #>
    #> loaded via a namespace (and not attached):
    #>   [1] bitops_1.0-9                rlang_1.1.7
    #>   [3] magrittr_2.0.4              matrixStats_1.5.0
    #>   [5] compiler_4.5.2              mgcv_1.9-4
    #>   [7] systemfonts_1.3.1           vctrs_0.7.1
    #>   [9] pkgconfig_2.0.3             crayon_1.5.3
    #>  [11] fastmap_1.2.0               XVector_0.50.0
    #>  [13] labeling_0.4.3              Rsamtools_2.26.0
    #>  [15] rmarkdown_2.30              network_1.20.0
    #>  [17] purrr_1.2.1                 xfun_0.56
    #>  [19] cachem_1.1.0                cigarillo_1.0.0
    #>  [21] aplot_0.2.9                 jsonlite_2.0.0
    #>  [23] DelayedArray_0.36.0         BiocParallel_1.44.0
    #>  [25] parallel_4.5.2              data.tree_1.2.0
    #>  [27] cluster_2.1.8.2             R6_2.6.1
    #>  [29] bslib_0.10.0                stringi_1.8.7
    #>  [31] RColorBrewer_1.1-3          rtracklayer_1.70.1
    #>  [33] GenomicRanges_1.62.1        jquerylib_0.1.4
    #>  [35] Rcpp_1.1.1                  Seqinfo_1.0.0
    #>  [37] SummarizedExperiment_1.40.0 knitr_1.51
    #>  [39] IRanges_2.44.0              Matrix_1.7-4
    #>  [41] splines_4.5.2               igraph_2.2.2
    #>  [43] tidyselect_1.2.1            abind_1.4-8
    #>  [45] yaml_2.3.12                 codetools_0.2-20
    #>  [47] curl_7.0.0                  lattice_0.22-9
    #>  [49] tibble_3.3.1                treeio_1.34.0
    #>  [51] Biobase_2.70.0              withr_3.0.2
    #>  [53] S7_0.2.1                    coda_0.19-4.1
    #>  [55] evaluate_1.0.5              Rtsne_0.17
    #>  [57] gridGraphics_0.5-1          Biostrings_2.78.0
    #>  [59] pillar_1.11.1               BiocManager_1.30.27
    #>  [61] MatrixGenerics_1.22.0       stats4_4.5.2
    #>  [63] ggfun_0.2.0                 generics_0.1.4
    #>  [65] RCurl_1.98-1.17             S4Vectors_0.48.0
    #>  [67] ggplot2_4.0.2               scales_1.4.0
    #>  [69] tidytree_0.4.7              ggnetwork_0.5.14
    #>  [71] glue_1.8.0                  gdtools_0.5.0
    #>  [73] pheatmap_1.0.13             lazyeval_0.2.2
    #>  [75] maketools_1.3.2             tools_4.5.2
    #>  [77] BiocIO_1.20.0               sys_3.4.3
    #>  [79] GenomicAlignments_1.46.0    ggiraph_0.9.6
    #>  [81] buildtools_1.0.0            fs_1.6.6
    #>  [83] XML_3.99-0.22               grid_4.5.2
    #>  [85] tidyr_1.3.2                 ape_5.8-1
    #>  [87] patchwork_1.3.2             nlme_3.1-168
    #>  [89] networkD3_0.4.1             restfulr_0.0.16
    #>  [91] cli_3.6.5                   rappdirs_0.3.4
    #>  [93] intergraph_2.0-4            labdsv_2.1-2
    #>  [95] fontBitstreamVera_0.1.1     S4Arrays_1.10.1
    #>  [97] dplyr_1.2.0                 gtable_0.3.6
    #>  [99] yulab.utils_0.2.4           fontquiver_0.2.1
    #> [101] sass_0.4.10                 digest_0.6.39
    #> [103] BiocGenerics_0.56.0         SparseArray_1.10.8
    #> [105] ggplotify_0.1.3             rjson_0.2.23
    #> [107] htmlwidgets_1.6.4           sna_2.8
    #> [109] farver_2.1.2                htmltools_0.5.9
    #> [111] lifecycle_1.0.5             httr_1.4.8
    #> [113] statnet.common_4.13.0       fontLiberation_0.1.0
    #> [115] MASS_7.3-65

# References

Wang, Yupeng, Haibao Tang, Jeremy D DeBarry, Xu Tan, Jingping Li, Xiyin Wang, Tae-ho Lee, et al. 2012. “MCScanX: A Toolkit for Detection and Evolutionary Analysis of Gene Synteny and Collinearity.” Nucleic Acids Research 40 (7): e49–49.