Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/GMOD/JBrowseR
R interface to the JBrowse 2 Linear Genome View.
https://github.com/GMOD/JBrowseR
genomics r reactjs rmarkdown shiny visualization
Last synced: 3 months ago
JSON representation
R interface to the JBrowse 2 Linear Genome View.
- Host: GitHub
- URL: https://github.com/GMOD/JBrowseR
- Owner: GMOD
- License: apache-2.0
- Created: 2020-12-14T17:48:17.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-03-12T15:59:18.000Z (8 months ago)
- Last Synced: 2024-07-12T20:16:58.615Z (4 months ago)
- Topics: genomics, r, reactjs, rmarkdown, shiny, visualization
- Language: R
- Homepage: https://gmod.github.io/JBrowseR/
- Size: 15.1 MB
- Stars: 35
- Watchers: 11
- Forks: 3
- Open Issues: 13
-
Metadata Files:
- Readme: README.Rmd
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-shiny-extensions - JBrowseR - R interface to the JBrowse 2 linear genome view. (Visualization / Biological Data)
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# JBrowseR 
[](https://github.com/gmod/JBrowseR/actions)
[](https://CRAN.R-project.org/package=JBrowseR)
JBrowseR is an R package that provides a simple and clean interface to [JBrowse 2](https://jbrowse.org/jb2/) for R users.
Using JBrowseR, you can:
- Embed the JBrowse 2 genome browser in **R Markdown** documents and **Shiny applications**
- Deploy a genome browser directly from the R console to view your data
- Customize your genome browser to display your own data
## Installation
You can install the released version of JBrowseR from [CRAN](https://CRAN.R-project.org) with:
``` r
install.packages("JBrowseR")
```
And the development version from [GitHub](https://github.com/) with:
``` r
# install.packages("devtools")
devtools::install_github("gmod/JBrowseR")
```
## Example
This line of code can be used to launch a genome browser from your R console:
```{r example, eval=FALSE}
library(JBrowseR)
JBrowseR("ViewHg19", location = "10:29,838,737..29,838,819")
```
## Getting started
In order to get started with JBrowseR, please refer to the vignette that best suits your needs:
- [Introduction](https://gmod.github.io/JBrowseR/articles/JBrowseR.html)
- [Custom browser tutorial](https://gmod.github.io/JBrowseR/articles/custom-browser-tutorial.html)
- [JSON configuration tutorial](https://gmod.github.io/JBrowseR/articles/json-tutorial.html)
- [Creating URLS](https://gmod.github.io/JBrowseR/articles/creating-urls.html)
## Live demos
### Basic usage including text search index
Allows you to search by gene name
https://gmod.shinyapps.io/basic_usage_with_text_index
### Multi purpose demo app
Shows a "bookmark" type feature, loading data from data frame, and buttons to navigate to genes of interest
https://gmod.shinyapps.io/bookmarks_demo
### Load config.json file
Shows loading a config.json file
https://gmod.shinyapps.io/load_config_json
### Load data frame
Simple example showing a data frame as a track
https://gmod.shinyapps.io/load_data_frame
### Gene fusion example
Shows putative gene fusions in the SKBR3 breast cancer cell line
https://gmod.shinyapps.io/skbr3_gene_fusions
## Citation
If you use JBrowseR in your research, please cite the following publication:
[Hershberg et al., 2021. JBrowseR: An R Interface to the JBrowse 2 Genome Browser](https://doi.org/10.1093/bioinformatics/btab459)
```
@article{hershberg2021jbrowser,
title={JBrowseR: An R Interface to the JBrowse 2 Genome Browser},
author={Hershberg, Elliot A and Stevens, Garrett and Diesh, Colin and Xie, Peter and De Jesus Martinez, Teresa and Buels, Robert and Stein, Lincoln and Holmes, Ian},
journal={Bioinformatics}
}
```
## For developers
To modify the codebase, you can set up a dev environment as follows
```
git clone https://github.com/GMOD/JBrowseR
cd JBrowseR
yarn
yarn build # build current webpack dependencies
R
install.packages('devtools')
devtools::install()
library(JBrowseR)
JBrowseR("ViewHg19", location = "10:29,838,737..29,838,819") # this will now use your local build of JBrowseR
```