BioCircos
Htmlwidgets binding R commands to the BioCircos.js library
Science Score: 20.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
○codemeta.json file
-
○.zenodo.json file
-
○DOI references
-
✓Academic publication links
Links to: ncbi.nlm.nih.gov, zenodo.org -
✓Committers with academic emails
1 of 2 committers (50.0%) from academic institutions -
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.3%) to scientific vocabulary
Keywords
Repository
Htmlwidgets binding R commands to the BioCircos.js library
Basic Info
Statistics
- Stars: 39
- Watchers: 3
- Forks: 9
- Open Issues: 19
- Releases: 0
Topics
Metadata Files
README.md
BioCircos.R
Simple htmlwidgets binding R commands to the BioCircos.js library
Introduction
This package allows to implement in 'R' Circos-like visualizations of genomic data, as proposed by the BioCircos.js JavaScript library, based on the JQuery and D3 technologies.
For a complete list of all the parameters available, please refer to the package documentation.
Motivation
The amount of data produced nowadays in a lot of different fields assesses the relevance of reactive analyses and interactive display of the results. This is especially true in biology, where the cost of sequencing data has dropped must faster than the Moore's law prediction. New ways of integrating different levels of information and accelerating the interpretation are therefore needed.
The integration challenge appears to be of major importance, as it allows a deeper understanding of the biological phenomena happening, that cannot be observed in the single analyses independently.
This package aims at offering an easy way of producing Circos-like visualizations to face distinct challenges :
- On the one hand, data integration and visualization: Circos is a popular tool to combine different biological information on a single plot.
- On the other hand, reactivity and interactivity: thanks to the htmlwidgets framework, the figures produced by this package are responsive to mouse events and display useful tooltips, and they can be integrated in shiny apps. Once the analyses have been performed and the shiny app coded, it is possible for the end-user to explore a massive amount of biological data without any programming or bioinformatics knowledge.
The terminology used here arises from genomics but this tool may be of interest for different situations where different positional or temporal informations must be combined.
Installation
To install this package, you can use CRAN (the central R package repository) to get the last stable release or build the last development version directly from the GitHub repository.
From CRAN
install.packages('BioCircos')
From Github
# You need devtools for that
if (!require('devtools')){install.packages('devtools')}
devtools::install_github('lvulliard/BioCircos.R', build_vignettes = TRUE))
Compatibility and troubleshooting
Since the visualizations are powered by JavaScript, they are affected by the environment in which they are displayed.
- If nothing shows up in the Rstudio viewer pane, try displaying the plot you generated in your browser instead. You can export the figure using the Save as Web Page... option in the Export tab of the viewer pane.
- If nothing shows up in a shiny application or an Rmarkdown document, try to update your web browser. See the vignettes for examples of BioCircos plots that should be correctly displayed.
- Rotation of labels using the genomeLabelOrientation parameter leads to a slight offset of the text when displayed in Firefox because some recent CSS options are not yet implemented.
Obseved behavior
- Firefox 55, Chrome 54 and later versions work as expected.
- Firefox 46, Chrome 53 and past versions do not display the plots at all.
- Firefox 47 to 54 do not include all features, such as zooming.
Tutorial
See the vignettes to learn how to use BioCircos visualizations.
vignette('BioCircos')
Original work
BioCircos.js : an Interactive Circos JavaScript Library for Biological Data Visualization on Web Applications.
https://github.com/YaCui/Biocircos.js
http://bioinfo.ibp.ac.cn/biocircos/
http://www.ncbi.nlm.nih.gov/pubmed/26819473
Documentation: http://bioinfo.ibp.ac.cn/biocircos/document/index.html
Modifications
The following features have been added to the original BioCircos.js library, based on version 1.1.2:
- Parameter snpvaluemaxmin_instance set by SNPsettings.range when provided, to allow the use of a pre-defined range of values for the SNP track.
- Similar parameters added for the range of Histogram/Bar tracks, Line tracks, CNV tracks and Heatmap tracks (for the range to be used for color mapping).
- Parameter opacity added to each elements of SNP and Arc tracks.
- Changes were made in order to allow rotation of genome labels with the new parameter genomeLabelOrientation and the radial offset dy is now directly integrated in the label translation.
Contact
To report bugs, request features or for any question or remark regarding this package, please use the GitHub page or contact Loan Vulliard.
Credits
The creation and implementation of the BioCircos.js JavaScript library is an independent work attributed to Ya Cui and Xiaowei Chen.
This work is described in the following scientific article: BioCircos.js: an Interactive Circos JavaScript Library for Biological Data Visualization on Web Applications. Cui, Y., et al. Bioinformatics. (2016).
This package relies on several open source projects other R packages, and is made possible thanks to shiny and htmlwidgets.
The package heatmaply was used as a model for this vignette, as well as for the htmlwidgets configuration.
Owner
- Name: lvulliard
- Login: lvulliard
- Kind: organization
- Repositories: 6
- Profile: https://github.com/lvulliard
GitHub Events
Total
- Issues event: 1
- Watch event: 3
Last Year
- Issues event: 1
- Watch event: 3
Committers
Last synced: about 2 years ago
Top Committers
| Name | Commits | |
|---|---|---|
| Loan Vulliard | l****d@c****t | 62 |
| Vulliard Loan | k****e | 3 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: 6 months ago
All Time
- Total issues: 29
- Total pull requests: 0
- Average time to close issues: 22 days
- Average time to close pull requests: N/A
- Total issue authors: 22
- Total pull request authors: 0
- Average comments per issue: 0.59
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 1
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 1
- Pull request authors: 0
- Average comments per issue: 0.0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
- koalive (8)
- nickjhathaway (1)
- shengyongniu (1)
- anlo328 (1)
- akhilpampana (1)
- seanaller (1)
- travis-m-blimkie (1)
- pdimens (1)
- dgolden96 (1)
- rkmeade (1)
- menzel (1)
- anoronh4 (1)
- khash79 (1)
- KatrionaGoldmann (1)
- userzxyz (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- cran 270 last-month
- Total docker downloads: 23
- Total dependent packages: 0
- Total dependent repositories: 2
- Total versions: 3
- Total maintainers: 1
cran.r-project.org: BioCircos
Interactive Circular Visualization of Genomic Data using 'htmlwidgets' and 'BioCircos.js'
- Homepage: https://github.com/lvulliard/BioCircos.R
- Documentation: http://cran.r-project.org/web/packages/BioCircos/BioCircos.pdf
- License: GPL-2 | file LICENSE
-
Latest release: 0.3.4
published almost 7 years ago
Rankings
Maintainers (1)
Dependencies
- R >= 3.1.0 depends
- RColorBrewer * imports
- grDevices * imports
- htmlwidgets * imports
- jsonlite * imports
- plyr * imports
- knitr * suggests
- rmarkdown * suggests