Skip to content

A genome browser designed for complex structural variants and long reads.

License

Notifications You must be signed in to change notification settings

MariaNattestad/Ribbon

Repository files navigation

Ribbon/SplitThreader

Ribbon and SplitThreader are both visualization tools for exploring complex rearrangements and long-range structural variants. Especially if you have long reads, Ribbon and SplitThreader should be quite helpful for figuring out what's going on around large variants.

Ribbon is available online at genomeribbon.com

Major changes in 2024

v2.0 release notes

SplitThreader to Ribbon jumping demo

Both built by Maria Nattestad originally, we decided in 2024 to put Ribbon and SplitThreader together and give them both major updates. This was prompted by a collaboration with the Genome in a Bottle (GIAB) team at NIST to support the release of their somatic (tumor) benchmark dataset for HG008. 2024 development done by Maria Nattestad and Robert Aboukhalil.

Documentation

  • How to read the visualizations? Check out interpretation for examples.
  • What changed in 2024? Including how to make a session with multiple files: v2.0 release notes

Citation and publications

Please cite our paper in Bioinformatics.

The BioRxiv has both the Ribbon preprint and the SplitThreader preprint.

Ribbon

Ribbon overview

SplitThreader

SplitThreader overview

There are several algorithms available within SplitThreader that can help make sense of long-range rearrangements, from categorizing variants: to searching for gene fusions: gene fusion algorithms described in supplement to SplitThreader preprint.

Local deployment

If you need to run Ribbon/SplitThreader without internet access, go to releases and find the ribbon_splitthreader.zip bundle from the latest release.

unzip ribbon_splitthreader.zip
cd ribbon_splitthreader
python3 -m http.server
# or run any other server pointed at that directory.

Note that permalinks won't work without internet access.

Development and building from source

To develop new features in Ribbon, first install npm.

Then clone this repository and build it:

# Clone repo and install dependencies
git clone https://github.com/marianattestad/ribbon
cd ribbon
npm install
# to run locally for development
npm run dev

# to build from source:
npm run build
npm run serve # to test the build
# To run a server with this build:
cd dist
python3 -m http.server