Synteny on genomes.jbrowse.org
The tutorials target the JBrowse v5 beta, and the v4.3.0 release
on the download page lacks some of what they show. To install the
beta of JBrowse Web, run npm install -g @jbrowse/cli@next, then
jbrowse create jbrowse2 --branch v5.0.0-beta.22. Desktop beta builds for Linux and
macOS are on the releases page;
the Windows build waits on code signing.
Comparing two genomes starts from an alignment between them. UCSC has already aligned each genome it hosts to many others as liftOver chains, and genomes.jbrowse.org serves those chains as tracks beside each genome. We compare human with the T2T human reference at TNNT3, with chimp at an FTO intron, with mouse strains at Nnt, and one person's two haplotypes at the 17q21.31 inversion. We:
- turn on a liftOver track and launch a linear synteny view from one of its chain blocks
- set the synteny view's ribbons to curves, and color them by strand
- launch hg38 against chimp and add the chimp panel's tracks
- turn on a multi-way liftOver track and choose which genomes become its lanes
- reorder the lanes to put one person's two haplotypes side by side
Opening a liftOver track
We'll start on hg38, where the track selector lists one liftOver track per genome UCSC aligned hg38 to:
- open hg38 on genomes.jbrowse.org
- in the track selector, under Pairwise alignments → liftOver, turn on hg38 to Human (hs1) liftOver
- type
TNNT3into the location box, which searches the hosted name index
The liftOver track draws one feature per chain block. The hg38 config declares one assembly, and the site loads the other genome's config when a track names it.
Launching a synteny view
Right-click any chain block and choose Launch → Linear synteny view with <assembly>. The dialog frames the second panel:
- Use CIGAR to map the current visible region to the target finds, from the alignment, the interval in the other genome that matches what is in view. The chain through TNNT3 spans the chromosome, so with the box unticked both panels frame all of chromosome 11.
- Horizontally flip inverted targets (ticked by default) appears for a reverse-strand block.
- Open in new view appends the result below the linear view, and Replace current view puts it in that view's place.
- Copy this view's tracks into its panel sets whether the panel you launched from keeps the tracks that view had on.
For a locus no single chain block covers, drag-select it on the scale bar and pick Launch → Linear synteny view..., whose dialog offers every assembly the session's synteny datasets align to it. See the linear synteny view guide.
Ribbon display settings
The synteny view's settings menu, the sliders button in its header, holds the ribbon settings. Curved lines draws each ribbon as a curve, easier to follow across a gap. Insertions and deletions inside each block are see-through gaps; CIGAR indels → Colored indels paints them instead.
The TNNT3 rearrangement by strand
TNNT3 is the locus of Fig 5C in Aganezov et al. (2022). Against GRCh38 the
region reads as an inversion plus a deletion. The palette button in the view
header sets the view's encoding.color, a color scale that maps a field to
colors. Pick Strand there, and the segment that moved is the one ribbon in
the second color.
Launching hg38 against chimp at an FTO intron
Launching a synteny view from a chain block works from any track under Pairwise alignments → liftOver. We'll repeat it against chimp and add tracks to the chimp panel:
- turn on hg38 to Chimp (panTro6) liftOver
- type
chr16:54,036,000-54,054,000, an intron of FTO, into the location box - right-click a chain block and launch a synteny view
- in the chimp panel's track selector, turn on NCBI RefSeq - RefSeq All and RepeatMasker, which come with the panTro6 hub
- set curves as above
The one gap in the ribbon is a hole that lines up with the L1HS element in
hg38's RepeatMasker track, and the chimp panel's has no L1HS. The rest of the
panTro6 hub loads from File → Open connection... as a JBrowse 2 hub at
https://jbrowse.org/ucsc/panTro6/config.json.
A chain or PAF of your own launches the same way once it is added as a synteny track: HG002 haplotypes loads a chain, and Synteny (pairwise minimap2) aligns two genomes and loads the PAF.
To start from a gene, the site's ortholog search lists a symbol's NCBI orthologs among the hosted genomes, with a synteny view per row where an alignment exists.
Stacking many genomes under hg38 in one multi-way track
A liftOver track pairs hg38 with one other genome. To compare many genomes at
once, hg38's staging config also has hg38 vs 242 genomes (liftOver,
multi-way), one track over all of hg38's liftOver chains, which draws hg38 on
top and a lane per genome below. It is on
staging.genomes.jbrowse.org until JBrowse
5 ships. Open hg38 there, type TNNT3 into the location box and turn the track
on.
The TNNT3 conserved gene order page opens the same window across its genomes with Open TNNT3 in JBrowse across 12 genomes.
The track has a lane for each genome UCSC publishes a liftOver chain to, too many to read at once. In its track menu:
- pick Lanes → Choose lanes... and tick chimp, orangutan, rhesus, gray mouse lemur, Chinese tree shrew, naked mole-rat, elephant and platypus, a span from the apes to the monotremes
- leave the ribbons on their default color, Color by → Strand under Ribbons: red where the two lanes a ribbon joins run the same way, blue where one is inverted against the other
The multi-way synteny display guide
covers the lane labels, [rev], the ribbons and the lane menus.
Synteny (liftOver lanes, vertebrates)
builds the same kind of track from chains you choose.
Choosing which mouse strains become lanes at Nnt
Choosing lanes also compares strains within one species. mm39 is C57BL/6J, the strain that lost Nnt exons 7 to 11 (Freeman et al. 2006), and its multi-way liftOver track holds the Mouse Genomes Project strains. We'll open the strain lanes at that gene:
- open mm39 on staging.genomes.jbrowse.org and turn on mm39 vs 76 genomes (liftOver, multi-way) under Pairwise alignments
- type
Nntinto the location box - in the track menu, pick Lanes → Choose lanes..., type
house mouseinto the filter and tick the strains, the C57BL/6J T2T assembly among them
Comparing one person's two haplotypes at the 17q21.31 inversion
Dragging a lane's label moves it up or down the stack. hg38's multi-way track
holds both haplotypes of the H9 T2T assembly, so a stack can put one person's
two chromosomes under the reference. At 17q21.31 the H2 haplotype is a 900 kb
inversion (Stefansson et al. 2005), and H9 has one of each. On hg38 at
staging.genomes.jbrowse.org, turn on
hg38 vs 242 genomes (liftOver, multi-way), type
chr17:45,300,000-46,800,000 into the location box, then in the track menu:
- pick Lanes → Choose lanes... and tick the two H9 haplotypes, the HG002 maternal assembly, the NA24631 maternal assembly and T2T-CHM13 (hs1)
- drag the H9 hap2 lane's label to the top of the stack, beside hg38
- turn off Show → Show gene labels, since the RefSeq track above names the genes
See also
- Tutorial: Basic usage of genomes.jbrowse.org
- Tutorial: Synteny visualization (pairwise minimap2)
- Tutorial: Synteny from an ortholog table (grape, peach, cacao)
- Tutorial: Synteny visualization (all-vs-all minimap2)
- Tutorial: Pangenome (mouse)
- Tutorial: Driving JBrowse with an AI agent (two Drosophila genomes)
- Tutorial: Proteins on genomes.jbrowse.org
- User guide: Linear synteny view
- User guide: Dotplot view
Citations
- Aganezov et al. (2022). A complete reference genome improves analysis of human genetic variation
- Freeman et al. (2006). Deletion of nicotinamide nucleotide transhydrogenase: a new quantitive trait locus accounting for glucose intolerance in C57BL/6J mice
- Stefansson et al. (2005). A common inversion under selection in Europeans
Feedback on this tutorial is welcome: contact us.