Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Synteny Graph Builder

codecov

Synteny Graph Builder is an app to visualize genomic structural variation from BED files. It loads a base BED and one or more query BEDs, joins rows by id, classifies each row as synteny/inversion/translocation, groups contiguous rows into chunks, and draws ribbons between chromosome bars.

Quick start

To use the app, download gene-visualizer-v1.0.0.html or other releases from the release and open it in a browser.

Input BED files

Each file is tab-separated with no header, one gene per line. Lines starting with # are skipped.

# Column Example Description
1 chromosome 1A 2-character chromosome name; <file>_chr or <file>_ prefix is stripped
2 start 399327 Start position, 1-based inclusive
3 end 401443 End position, inclusive; must be greater than start
4 strand + + (forward) - (reverse/inverse)
5 id 1 Gene id shared across files; rows are joined on it

The same gene must carry the same id in the base and every query file. If id is missing, the row's line number is used (assuming sorted). Rows on chromosome Un are dropped. See example below.

Example

To make your first synteny graph with the sample data downloaded from examples/ (or example.zip from release),

  1. Select base.bed as a baseline.
  2. Select the remaining 4 BED files as query.
  3. Click RUN with default parameters. (May need 2 clicks in FireFox)

Steps

The result should be similar to the figure below.

Visualization tab with the example bed files loaded

Scripts

  • yarn dev: start the dev server (craco)
  • yarn build: production build to build/
  • yarn build-one: a standalone HTML in dist/ (Python helper required)
  • yarn test: run the Jest suite (append --coverage for a coverage report)

yarn build-one prerequisites

build-one runs ./touch-up.py between the CRA build and the webpack inlining step. The script's shebang is #!./env/bin/python, so a virtualenv must exist at ./env. One-time setup:

python3 -m venv env
env/bin/pip install -r requirements.txt

After that, yarn build-one should work.

Tech

React 18, TypeScript, CRA via craco, @visx for SVG primitives, zustand for state, fflate for zipped exports, web workers for BED parsing.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages