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.
To use the app, download gene-visualizer-v1.0.0.html or other releases from the release and open it in a browser.
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.
To make your first synteny graph with the sample data downloaded from examples/ (or
example.zip from release),
- Select
base.bedas a baseline. - Select the remaining 4 BED files as query.
- Click
RUNwith default parameters. (May need 2 clicks in FireFox)
The result should be similar to the figure below.
yarn dev: start the dev server (craco)yarn build: production build tobuild/yarn build-one: a standalone HTML indist/(Python helper required)yarn test: run the Jest suite (append--coveragefor a coverage report)
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.txtAfter that, yarn build-one should work.
React 18, TypeScript, CRA via craco, @visx for SVG primitives, zustand for state, fflate for zipped exports, web workers for BED parsing.

