Contents

Introduction

Biological systems are composed of multiple layers of dynamic interaction networks. These networks can be decomposed, for example, into: co-expression, physical, co-localization, genetic, pathway, and shared protein domains.

GeneMania provides us with an enormous collection of data sets for interaction network studies (Warde-Farley D, Donaldson S, Comes O, Zuberi K, Badrawi R, and others 2010). The data can be accessed and downloaded from different database, using a web portal. But currently, there is not a R-package to query and download these data.

An important regulatory mechanism of these network data involves microRNAs (miRNAs). miRNAs are involved in various cellular functions, such as differentiation, proliferation, and tumourigenesis. However, our understanding of the processes regulated by miRNAs is currently limited and the integration of miRNA data in these networks provides a comprehensive genome-scale analysis of miRNA regulatory networks.Actually, GeneMania doesn’t integrate the information of miRNAs and their interactions in the network.

SpidermiR allows the user to query, prepare, download network data (e.g. from GeneMania), and to integrate this information with miRNA data with the possibility to analyze these downloaded data directly in one single R package. This techincal report gives a short overview of the essential SpidermiR methods and their application.

Installation

To install use the code below.

if (!requireNamespace("BiocManager", quietly=TRUE))
    install.packages("BiocManager")
BiocManager::install("SpidermiR")

SpidermiRquery: Searching network

You can easily search GeneMania data using the SpidermiRquery function.

SpidermiRquery_species: Searching by species

The user can query the species supported by GeneMania, using the function SpidermiRquery_species:

org<-SpidermiRquery_species(species)

The list of species is shown below:


Table 1: List of species
tabOrgd[, 2]
1 Arabidopsis_thaliana
2 Caenorhabditis_elegans
3 Danio_rerio
4 Drosophila_melanogaster
5 Escherichia_coli
6 Homo_sapiens
7 Mus_musculus
8 Rattus_norvegicus
9 Saccharomyces_cerevisiae

SpidermiRquery_networks_type: Searching by network categories

The user can query the network types supported by GeneMania for a specific specie, using the function SpidermiRquery_networks_type. The user can select a specific specie using an index obtained by the function SpidermiRquery_species (e.g. organismID=org[6,] is the input for Homo_sapiens,organismID=org[9,] is the input for Saccharomyces cerevisiae )

net_type<-SpidermiRquery_networks_type(organismID=org[9,])

The list of network categories in Saccharomyces cerevisiae is shown below:

## [1] "Co-localization"        "Predicted"             
## [3] "Co-expression"          "Physical Interactions" 
## [5] "Genetic Interactions"   "Shared protein domains"
## [7] "Other"

SpidermiRquery_spec_networks: Searching by species, and network categories

You can filter the search by species using organism ID (above reported), and the network category. The network category can be filtered using the following parameters:

  • COexp Co-expression
  • PHint Physical_interactions
  • COloc Co-localization
  • GENint Genetic_interactions
  • PATH Pathway
  • SHpd Shared_protein_domains
  • pred predicted
net_shar_prot<-SpidermiRquery_spec_networks(organismID = org[9,],
                                    network = "SHpd")

The databases, which data are collected, are the output of this step. An example is shown below ( for Shared protein domains in Saccharomyces_cerevisiae data are collected in INTERPRO, and PFAM):

## [1] "http://genemania.org/data/current/Saccharomyces_cerevisiae/Shared_protein_domains.INTERPRO.txt"
## [2] "http://genemania.org/data/current/Saccharomyces_cerevisiae/Shared_protein_domains.PFAM.txt"

SpidermiRdownload: Downloading network data

The user in this step can download the data, as previously queried.

SpidermiRdownload_net: Download network

The user can download the data (previously queried) with SpidermiRdownload_net.

out_net<-SpidermiRdownload_net(net_shar_prot)
## [1] "Downloading: http://genemania.org/data/current/Saccharomyces_cerevisiae/Shared_protein_domains.INTERPRO.txt ... reference n. 1 of 2"
## [1] "Downloading: http://genemania.org/data/current/Saccharomyces_cerevisiae/Shared_protein_domains.PFAM.txt ... reference n. 2 of 2"

The list of SpidermiRdownload_net is shown below:

## List of 2
##  $ :'data.frame':    47523 obs. of  3 variables:
##   ..$ Gene_A: chr [1:47523] "Q0050" "Q0050" "Q0055" "Q0050" ...
##   ..$ Gene_B: chr [1:47523] "Q0055" "Q0060" "Q0060" "Q0065" ...
##   ..$ Weight: num [1:47523] 0.39 0.09 0.15 0.09 0.15 0.23 0.1 0.17 0.18 0.18 ...
##  $ :'data.frame':    30228 obs. of  3 variables:
##   ..$ Gene_A: chr [1:30228] "Q0050" "Q0055" "Q0055" "Q0060" ...
##   ..$ Gene_B: chr [1:30228] "Q0055" "Q0060" "Q0065" "Q0065" ...
##   ..$ Weight: num [1:30228] 0.39 0.12 0.12 0.22 0.14 0.14 0.14 0.15 0.15 0.34 ...

SpidermiRdownload_miRNAprediction: Downloading miRNA predicted data target

The user can download the predicted miRNA-gene from 4 databases:DIANA, Miranda, PicTar and TargetScan

mirna<-c('hsa-miR-567','hsa-miR-566')
SpidermiRdownload_miRNAprediction(mirna_list=mirna)

SpidermiRdownload_miRNAvalidate: Downloading miRNA validated data target

The user can download the validated miRNA-gene from: miRTAR and miRwalk (Jiang Q, Wang Y, Hao Y, Juan L, Teng M, Zhang X, Li M, Wang G, Liu Y. 2009) (Dweep H, Sticht C, Pandey P, Gretz N. 2011).

list<-SpidermiRdownload_miRNAvalidate(validated)

SpidermiRdownload_miRNAextra_cir:Download Extracellular Circulating microRNAs

The user can download extracellular circulating miRNAs from miRandola database

list_circ<-SpidermiRdownload_miRNAextra_cir(miRNAextra_cir)

SpidermiRdownload_pharmacomir: Download Pharmaco-miR Verified Sets from PharmacomiR database

The user can download Pharmaco-miR Verified Sets from PharmacomiR database (Rukov J, Wilentzik R, Jaffe I, Vinther J, Shomron N. 2013).

mir_pharmaco<-SpidermiRdownload_pharmacomir(pharmacomir=pharmacomir)

SpidermiRprepare: Preparing the data

SpidermiRprepare_NET: Prepare matrix of gene network with Ensembl Gene ID, and gene symbols

SpidermiRprepare_NET reads network data from SpidermiRdownload_net and enables user to prepare them for downstream analysis. In particular, it prepares matrix of gene network mapping Ensembl Gene ID to gene symbols. Gene symbols are needed to integrate miRNAdata.

geneSymb_net<-SpidermiRprepare_NET(organismID = org[9,],
                                    data = out_net)
## [1] "Preprocessing of the network n. 1 of 2"
## [1] "Preprocessing of the network n. 2 of 2"

The network with gene symbols ID is shown below:


Table 2: shared protein domain
Gene_A Gene_B Weight gene_symbolA gene_symbolB
Q0050 Q0055 0.39 AI1 AI2
Q0050 Q0060 0.09 AI1 AI3
Q0055 Q0060 0.15 AI2 AI3
Q0050 Q0065 0.09 AI1 AI4
Q0055 Q0065 0.15 AI2 AI4

SpidermiRanalyze: : Analyze data from network data

SpidermiRanalyze_mirnanet_pharm: Integration of pharmacomiR in the network

The user in this step can integrate the pharmacomiR database in order to link miRNA and drug effect in a specific network.

miRNA_NET <-data.frame(V1=c('hsa-let-7a','CASP3'),V2=c('CASP3','TAMOXIFEN'),stringsAsFactors=FALSE)
mir_pharmnet<-SpidermiRanalyze_mirnanet_pharm(mir_ph=mir_pharmaco,net=miRNA_NET)

SpidermiRanalyze_direct_net: Searching by biomarkers of interest with direct interaction

Starting from a set of biomarkers of interest (BI), genes, miRNA or both, given by the user, this function finds sub-networks including all direct interactions involving at least one of the BI.

biomark_of_interest<-c("hsa-let-7a","CDC34","hsa-miR-27a","PEX7","EPT1","FOX","hsa-miR-5a")
miRNA_NET <-data.frame(V1=c('hsa-let-7a','CASP3','BRCA','hsa-miR-7a','hsa-miR-5a','SMAD','SOX'),V2=c('CASP3','TAMOXIFEN','MYC','PTEN','FOX','HIF1','P53'),stringsAsFactors=FALSE)
GIdirect_net<-SpidermiRanalyze_direct_net(data=miRNA_NET,BI=biomark_of_interest)
## [1] "CDC34 is not in the network or please check the correct name"
## [1] "hsa-miR-27a is not in the network or please check the correct name"
## [1] "PEX7 is not in the network or please check the correct name"
## [1] "EPT1 is not in the network or please check the correct name"

The data frame of SpidermiRanalyze_direct_net, GIdirect_net, is shown below:

## 'data.frame':    2 obs. of  2 variables:
##  $ V1: chr  "hsa-let-7a" "hsa-miR-5a"
##  $ V2: chr  "CASP3" "FOX"

SpidermiRanalyze_direct_subnetwork: Network composed by only the nodes in a set of biomarkers of interest

Starting from BI, this function finds sub-networks including all direct interactions involving only BI.

subnet<-SpidermiRanalyze_direct_subnetwork(data=miRNA_NET,BI=biomark_of_interest)

SpidermiRanalyze_subnetwork_neigh: Network composed by the nodes in the list of BI and all the edges among this brunch of nodes.

Starting from BI, this function finds sub-networks including all direct and indirect interactions involving at least one of BI.

GIdirect_net_neigh<-SpidermiRanalyze_subnetwork_neigh(data=miRNA_NET,BI=biomark_of_interest)

SpidermiRanalyze_degree_centrality: Ranking degree centrality genes

This function finds the number of direct neighbours of a node in a network and allows the selection of those nodes with a number of direct neighbours higher than a selected cut-off.

top10_cent_gene<-SpidermiRanalyze_degree_centrality(miRNA_NET)

SpidermiRanalyze_Community_detection: Find community detection

This function find the communities in the network, and describes them in terms of number of community elements (both genes and miRNAs). The function uses one of the algorithms currently implemented in (Csardi G, Nepusz T. 2006), selected by the user according to the user need.

The user can choose the algorithm in order to calculate the community structure:

  • EB edge.betweenness.community
  • FC fastgreedy.community
  • WC walktrap.community
  • SC spinglass.community
  • LE leading.eigenvector.community
  • LP label.propagation.community
comm<-  SpidermiRanalyze_Community_detection(data=miRNA_NET,type="FC")

SpidermiRanalyze_Community_detection_net: Community detection

Starting from one community to which some BI belong (the output of the previously described function) this function describes the community as network of elements (both genes and miRNAs).

cd_net<-SpidermiRanalyze_Community_detection_net(data=miRNA_NET,comm_det=comm,size=1)

SpidermiRanalyze_Community_detection_bi: Community detection from a set of biomarkers of interest

Starting from the community to which BI belong (the output of the previously described function), this function indicates if a set of BI is included within such community.

gi=c("P53","PTEN","KIT","CCND2")
mol<-SpidermiRanalyze_Community_detection_bi(data=comm,BI=gi)

SpidermiRvisualize: To visualize the network

SpidermiRvisualize_mirnanet: To Visualize the network.

The user can visualize a 3D representation of the network in different colours for miRNA, genes, and pharmaco. The user can manage the network directly moving the nodes and the edges, in order to interpret the results in the graphic way.

library(networkD3)

SpidermiRvisualize_mirnanet(data=mir_pharmnet[sample(nrow(mir_pharmnet), 100), ] )

SpidermiRvisualize_BI: To Visualize the network from a set of BI.

Starting from a graphical representation of a network, the user can highlight with a different color specific BI.

biomark_of_interest<-c("hsa-let-7b","MUC1","PEX7","hsa-miR-222")
SpidermiRvisualize_BI(data=mir_pharmnet[sample(nrow(mir_pharmnet), 100), ],BI=biomark_of_interest)

SpidermiRvisualize_direction: To visualize the network

library(visNetwork)

SpidermiRvisualize_direction(data=mir_pharmnet[sample(nrow(mir_pharmnet), 100), ] )

SpidermiRvisualize_plot_target: Visualize the plot with miRNAs and the number of their targets in the network.

For each BI of a community, the user can visualize a plot showing the number of direct neighbours of such BI (the degree centrality of such BI).

SpidermiRvisualize_plot_target(data=miRNA_NET)

## NULL

SpidermiRvisualize_degree_dist: plots the degree distribution of the network

This function plots the cumulative frequency distribution of degree centrality of a community.

SpidermiRvisualize_degree_dist(data=miRNA_NET)

SpidermiRvisualize_adj_matrix: plots the adjacency matrix of the network

It plots the adjacency matrix of the community, representing the degree of connections among the nodes.

SpidermiRvisualize_adj_matrix(data=miRNA_NET)

SpidermiRvisualize_3Dbarplot: 3D barplot

It plots a summary representation of the networks with the number of edges, nodes and miRNAs.

SpidermiRvisualize_3Dbarplot(Edges_1net=1041003,Edges_2net=100016,Edges_3net=3008,Edges_4net=1493,Edges_5net=1598,NODES_1net=16502,NODES_2net=13338,NODES_3net=1429,NODES_4net=675,NODES_5net=712,nmiRNAs_1net=0,nmiRNAs_2net=74,nmiRNAs_3net=0,nmiRNAs_4net=0,nmiRNAs_5net=37)

Features databases SpidermiR:

Features of databases integrated in SpidermiR are:


Table 3: Features
CATEGORY EXTERNAL DATABASE VERSION LAST UPDATE LINK
Gene network GeneMania Current 2016 http://genemania.org/data/current/
Validated miRNA-target miRwalk miRwalk2 2015 http://zmf.umm.uni-heidelberg.de/apps/zmf/mirwalk2/downloads/vtm/hsa-vtm-gene.rdata.zip
miRTarBase miRTarBase 7 2017 mirtarbase.mbc.nctu.edu.tw/cache/download/7.0/miRTarBase_SE_WR.xls
Predicted miRNA-target DIANA DIANA- 5.0 2013 https://bioconductor.org/packages/release/bioc/html/miRNAtap.html
Miranda N/A 2010 https://bioconductor.org/packages/release/bioc/html/miRNAtap.html
PicTar N/A N/A https://bioconductor.org/packages/release/bioc/html/miRNAtap.html
TargetScan TargetScan7.1 2016 https://bioconductor.org/packages/release/bioc/html/miRNAtap.html
Extracellular Circulating microRNAs miRandola miRandola v 02/2017 2017 http://mirandola.iit.cnr.it/download/miRandola_version_02_2017.txt
Drug Associations Pharmaco-miR N/A N/A http://pharmaco-mir.org/home/download_VERSE_db/pharmacomir_VERSE_DB.csv

Session Information ******

sessionInfo()
## R version 3.6.0 (2019-04-26)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 18.04.2 LTS
## 
## Matrix products: default
## BLAS:   /home/biocbuild/bbs-3.9-bioc/R/lib/libRblas.so
## LAPACK: /home/biocbuild/bbs-3.9-bioc/R/lib/libRlapack.so
## 
## 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       
## 
## attached base packages:
## [1] parallel  stats4    stats     graphics  grDevices utils     datasets 
## [8] methods   base     
## 
## other attached packages:
##  [1] visNetwork_2.0.6     networkD3_0.4        SpidermiR_1.14.0    
##  [4] testthat_2.1.1       miRNAtap_1.18.0      AnnotationDbi_1.46.0
##  [7] IRanges_2.18.0       S4Vectors_0.22.0     Biobase_2.44.0      
## [10] BiocGenerics_0.30.0  BiocStyle_2.12.0    
## 
## loaded via a namespace (and not attached):
##   [1] proto_1.0.0                   R.utils_2.8.0                
##   [3] tidyselect_0.2.5              RSQLite_2.1.1                
##   [5] htmlwidgets_1.3               grid_3.6.0                   
##   [7] BiocParallel_1.18.0           devtools_2.0.2               
##   [9] DESeq_1.36.0                  munsell_0.5.0                
##  [11] codetools_0.2-16              preprocessCore_1.46.0        
##  [13] chron_2.3-53                  withr_2.1.2                  
##  [15] colorspace_1.4-1              highr_0.8                    
##  [17] knitr_1.22                    rstudioapi_0.10              
##  [19] labeling_0.3                  GenomeInfoDbData_1.2.1       
##  [21] KMsurv_0.1-5                  hwriter_1.3.2                
##  [23] bit64_0.9-7                   rprojroot_1.3-2              
##  [25] downloader_0.4                generics_0.0.2               
##  [27] xfun_0.6                      ggthemes_4.1.1               
##  [29] BiocFileCache_1.8.0           randomForest_4.6-14          
##  [31] EDASeq_2.18.0                 R6_2.4.0                     
##  [33] doParallel_1.0.14             GenomeInfoDb_1.20.0          
##  [35] clue_0.3-57                   locfit_1.5-9.1               
##  [37] bitops_1.0-6                  DelayedArray_0.10.0          
##  [39] assertthat_0.2.1              promises_1.0.1               
##  [41] scales_1.0.0                  gtable_0.3.0                 
##  [43] sva_3.32.0                    processx_3.3.0               
##  [45] wheatmap_0.1.0                sesameData_1.1.0             
##  [47] rlang_0.3.4                   genefilter_1.66.0            
##  [49] cmprsk_2.2-7                  GlobalOptions_0.1.0          
##  [51] splines_3.6.0                 rtracklayer_1.44.0           
##  [53] lazyeval_0.2.2                selectr_0.4-1                
##  [55] broom_0.5.2                   BiocManager_1.30.4           
##  [57] yaml_2.2.0                    GenomicFeatures_1.36.0       
##  [59] backports_1.1.4               httpuv_1.5.1                 
##  [61] tools_3.6.0                   usethis_1.5.0                
##  [63] bookdown_0.9                  ggplot2_3.1.1                
##  [65] gplots_3.0.1.1                RColorBrewer_1.1-2           
##  [67] DNAcopy_1.58.0                sessioninfo_1.1.1            
##  [69] gsubfn_0.7                    Rcpp_1.0.1                   
##  [71] plyr_1.8.4                    progress_1.2.0               
##  [73] zlibbioc_1.30.0               purrr_0.3.2                  
##  [75] RCurl_1.95-4.12               ps_1.3.0                     
##  [77] prettyunits_1.0.2             ggpubr_0.2                   
##  [79] sqldf_0.4-11                  GetoptLong_0.1.7             
##  [81] zoo_1.8-5                     SummarizedExperiment_1.14.0  
##  [83] ggrepel_0.8.0                 cluster_2.0.9                
##  [85] fs_1.3.0                      magrittr_1.5                 
##  [87] data.table_1.12.2             circlize_0.4.6               
##  [89] survminer_0.4.3               matrixStats_0.54.0           
##  [91] pkgload_1.0.2                 aroma.light_3.14.0           
##  [93] hms_0.4.2                     mime_0.6                     
##  [95] evaluate_0.13                 xtable_1.8-4                 
##  [97] XML_3.98-1.19                 gridExtra_2.3                
##  [99] shape_1.4.4                   compiler_3.6.0               
## [101] biomaRt_2.40.0                tibble_2.1.1                 
## [103] KernSmooth_2.23-15            crayon_1.3.4                 
## [105] R.oo_1.22.0                   htmltools_0.3.6              
## [107] mgcv_1.8-28                   later_0.8.0                  
## [109] tidyr_0.8.3                   geneplotter_1.62.0           
## [111] DBI_1.0.0                     ExperimentHub_1.10.0         
## [113] dbplyr_1.4.0                  matlab_1.0.2                 
## [115] ComplexHeatmap_2.0.0          rappdirs_0.3.1               
## [117] ShortRead_1.42.0              Matrix_1.2-17                
## [119] readr_1.3.1                   cli_1.1.0                    
## [121] R.methodsS3_1.7.1             gdata_2.18.0                 
## [123] igraph_1.2.4.1                km.ci_0.5-2                  
## [125] GenomicRanges_1.36.0          pkgconfig_2.0.2              
## [127] sesame_1.2.0                  GenomicAlignments_1.20.0     
## [129] xml2_1.2.0                    foreach_1.4.4                
## [131] annotate_1.62.0               XVector_0.24.0               
## [133] rvest_0.3.3                   stringr_1.4.0                
## [135] callr_3.2.0                   digest_0.6.18                
## [137] ConsensusClusterPlus_1.48.0   Biostrings_2.52.0            
## [139] rmarkdown_1.12                survMisc_0.5.5               
## [141] TCGAbiolinks_2.12.0           edgeR_3.26.0                 
## [143] miRNAtap.db_0.99.10           curl_3.3                     
## [145] shiny_1.3.2                   Rsamtools_2.0.0              
## [147] gtools_3.8.1                  rjson_0.2.20                 
## [149] nlme_3.1-139                  jsonlite_1.6                 
## [151] desc_1.2.0                    limma_3.40.0                 
## [153] pillar_1.3.1                  lattice_0.20-38              
## [155] httr_1.4.0                    pkgbuild_1.0.3               
## [157] survival_2.44-1.1             interactiveDisplayBase_1.22.0
## [159] glue_1.3.1                    remotes_2.0.4                
## [161] png_0.1-7                     iterators_1.0.10             
## [163] bit_1.1-14                    stringi_1.4.3                
## [165] blob_1.1.1                    org.Hs.eg.db_3.8.2           
## [167] AnnotationHub_2.16.0          latticeExtra_0.6-28          
## [169] caTools_1.17.1.2              memoise_1.1.0                
## [171] dplyr_0.8.0.1

References

Csardi G, Nepusz T. 2006. “The Igraph Software Package for Complex Network Research.”

Dweep H, Sticht C, Pandey P, Gretz N. 2011. “miRWalk - Database Prediction of Possible miRNA Binding Sites by ‘Walking’ the Genes of 3 Genomes.”

Jiang Q, Wang Y, Hao Y, Juan L, Teng M, Zhang X, Li M, Wang G, Liu Y. 2009. “miR2Disease a Manually Curated Database for microRNA Deregulation in Human Disease.”

Rukov J, Wilentzik R, Jaffe I, Vinther J, Shomron N. 2013. “Pharmaco miR Linking microRNAs and Drug Effects.”

Warde-Farley D, Donaldson S, Comes O, Zuberi K, Badrawi R, and others. 2010. “The Gene Mania Prediction Server Biological Network Integration for Gene Prioritization and Predicting Gene Function.”