Pangenome (rice)
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.21. Desktop beta builds for Linux and
macOS are on the releases page;
the Windows build waits on code signing.
The rice pangenome aligns 47 NCBI assemblies of Asian rice onto AGIS-1.0, the
telomere-to-telomere assembly of the japonica variety Nipponbare, with
minigraph. Most come from a 2025 set of HiFi and Nanopore assemblies of
cultivated, weedy and wild rice (Oryza rufipogon); the rest add the aus
variety Kasalath, the indica IR64 and complete indica and japonica genomes.
Nipponbare is a temperate japonica, so where it carries a derived allele, the
other assemblies appear as the change. No graph had been published for these
assemblies, so we built one. We:
- at sd1, find the Green Revolution's semi-dwarf deletion in IR64
- at qSW5, read three grain-width alleles, one of them the reference's
- at Pup1, read a 90 kb insertion that the reference lacks
- load the graph and its bubbles as tracks on AGIS-1.0 in your own JBrowse
- build a minigraph graph from the assemblies
The first three start from the rice graph page on genomes.jbrowse.org, which launches the JBrowse 5 development build until JBrowse 5 ships.
The graph view is a beta plugin. We welcome your feedback.
Prerequisites
- the GraphGenomeView plugin, for the
GraphTrackbelow. In your own JBrowse, install it from the plugin store; the portal page already loads it minigraph, to build a graph like this one
# conda
conda install -c bioconda -c conda-forge minigraphThe data
The reference is AGIS-1.0 (GCF_034140825.1) from UCSC GenArk, and the 47 assemblies are NCBI GenBank records, listed with their accessions in the README beside the files.
Nothing to download: the track configs below read the index files by URL. Building the graph builds the files for assemblies of your own.
The files
| What it is | File |
|---|---|
| AGIS-1.0, as 2bit | GCF_034140825.1.2bit |
| The graph, as rGFA | rice-agis1-minigraph.rgfa.gz |
| Segments and links, the graph's nodes and edges at their reference coordinates | rice-agis1-minigraph.graph.bed.gz |
| Bubbles, where the assemblies' paths split and rejoin | rice-agis1-minigraph.bubbles.bed.gz |
| The whole-chromosome overview, with variants under 10 kb folded into the reference | rice-agis1-minigraph.fold10000.graph.bed.gz |
The graph holds no path per assembly, so the portal page reads which assemblies
carry each bubble's allele from a separate file, made by mapping each assembly
back onto the graph with minigraph --call.
sd1: the Green Revolution's semi-dwarf deletion
The semi-dwarf rice varieties of the Green Revolution carry defective alleles of SD1, which encodes an oxidase of gibberellin biosynthesis. Monna et al. (2002) found that the allele from the Taiwanese variety Dee-geo-woo-gen is a 383 bp deletion from the middle of exon 1 to upstream of exon 2, which shifts the frame. IR64 carries it. Nipponbare is tall and has the intact gene.
- Open the portal page, which
starts on sd1, or type
chr1:39,008,000-39,020,000into its box and press Show. - Read the map's sd1-d row: IR64 and eight more assemblies share the 383 bp deletion inside the gene.
The commoner 240 bp deletion, in a third of the assemblies, lies upstream of the gene.
qSW5: three grain-width alleles
A deletion upstream of the grain-width gene qSW5 (GW5) lowers its expression and widens the grain. Lee et al. (2015) distinguished three alleles: Kasalath's, with no deletion; an indica allele with a 950 bp deletion; and Nipponbare's, with a 1,212 bp deletion. AGIS-1.0 carries the 1,212 bp deletion, so the map draws the other two as longer sequence than the reference's at that site.
- Type
chr5:5,374,000-5,390,000into the portal page's box and press Show, or pick qSW5 / GW5 from its examples. - Read the forms: the qSW5, no deletion rows, about half the assemblies with Kasalath, IR64 and 9311 among them, have the 1.2 kb Nipponbare lacks. The qSW5, 950 bp deletion row, a quarter with the three weedy rices among them, has 260 bp of it. Balilla, Udai21, Changxianggeng1813, Wuyunjing8 and eight more share the reference's deletion, the row AGIS-1.0's structure.
Pup1: a 90 kb insertion the reference lacks
Kasalath's Pup1 locus, for tolerance of phosphorus-poor soil, holds the protein kinase gene PSTOL1. Gamuyao et al. (2012) found that the gene is absent from the reference genome and from other phosphorus-starvation-intolerant modern varieties, and Vigueira et al. (2016) place it in an insertion of about 90 kb.
- Type
chr12:15,866,140-15,866,870into the portal page's box and press Show, or pick Pup1 / PSTOL1 from its examples. - Read the forms: Kasalath and SL190 insert 89 kb at one point, named Pup1. Fifteen more assemblies insert 46 to 77 kb at the same point, and IR64 and most of the rest have the reference's structure.
The window is 730 bp wide, between the bubbles on either side, so that every form is one insertion. Wider windows take in the 20 kb deletions around the locus, which split the panel into more forms than the map can show.
Loading the graph in your own JBrowse
The portal's launches load these tracks for you. In your own JBrowse, we'll load
the reference, then the graph and its bubbles. The graph track names the file
prefix gfa-to-tabix build writes, and the uris below are our hosted copy, so
swap the prefix for your own build. The alias file maps the graph's chr1 to
chr12 onto GenArk's RefSeq names.
Goes in the assemblies array of config.json. See Assemblies.
{
"name": "GCF_034140825.1",
"uri": "https://hgdownload.soe.ucsc.edu/hubs/GCF/034/140/825/GCF_034140825.1/GCF_034140825.1.2bit",
"refNameAliases": {
"uri": "https://hgdownload.soe.ucsc.edu/hubs/GCF/034/140/825/GCF_034140825.1/GCF_034140825.1.chromAlias.txt"
}
}Edits config.json in the current folder, creating it if there is none. See JBrowse CLI with Desktop.
jbrowse add-assembly https://hgdownload.soe.ucsc.edu/hubs/GCF/034/140/825/GCF_034140825.1/GCF_034140825.1.2bit \
--name GCF_034140825.1 \
--refNameAliases https://hgdownload.soe.ucsc.edu/hubs/GCF/034/140/825/GCF_034140825.1/GCF_034140825.1.chromAlias.txtIn JBrowse Desktop, Open your own genome on the start screen (or File → Open genome... in a session), then Open from a URL and paste:
https://hgdownload.soe.ucsc.edu/hubs/GCF/034/140/825/GCF_034140825.1/GCF_034140825.1.2bitJBrowse reads the format off the file name. Then fill in:
- Genome name:
GCF_034140825.1 - refName aliases (under More options):
https://hgdownload.soe.ucsc.edu/hubs/GCF/034/140/825/GCF_034140825.1/GCF_034140825.1.chromAlias.txt
Goes in the tracks array of config.json. See Tracks.
{
"type": "GraphTrack",
"trackId": "rice_minigraph_segments",
"name": "Rice pangenome (rGFA segments)",
"assemblyNames": ["GCF_034140825.1"],
"adapter": {
"type": "RgfaTabixAdapter",
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph",
"format": 2,
"coarse": {
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph.fold10000",
"format": 2,
"aboveBpPerPx": 1000
}
},
"displays": [
{ "type": "LinearGraphDisplay" },
{ "type": "LinearBasicDisplay" }
]
}Edits config.json in the current folder. See JBrowse CLI with Desktop.
jbrowse add-track-json '{
"type": "GraphTrack",
"trackId": "rice_minigraph_segments",
"name": "Rice pangenome (rGFA segments)",
"assemblyNames": ["GCF_034140825.1"],
"adapter": {
"type": "RgfaTabixAdapter",
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph",
"format": 2,
"coarse": {
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph.fold10000",
"format": 2,
"aboveBpPerPx": 1000
}
},
"displays": [
{ "type": "LinearGraphDisplay" },
{ "type": "LinearBasicDisplay" }
]
}'In JBrowse Desktop, or in any running JBrowse Web session, open a view on this track’s assembly, then File → Open track..., choose Add track from pasted JSON, and paste:
{
"type": "GraphTrack",
"trackId": "rice_minigraph_segments",
"name": "Rice pangenome (rGFA segments)",
"assemblyNames": ["GCF_034140825.1"],
"adapter": {
"type": "RgfaTabixAdapter",
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph",
"format": 2,
"coarse": {
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph.fold10000",
"format": 2,
"aboveBpPerPx": 1000
}
},
"displays": [
{ "type": "LinearGraphDisplay" },
{ "type": "LinearBasicDisplay" }
]
}The bubbles track reads the same build's bubble index:
Goes in the tracks array of config.json. See Tracks.
{
"type": "FeatureTrack",
"trackId": "rice_minigraph_bubbles",
"name": "Rice pangenome bubbles",
"assemblyNames": ["GCF_034140825.1"],
"adapter": {
"type": "MinigraphBubbleAdapter",
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph.bubbles.bed.gz",
"csi": true
}
}Edits config.json in the current folder. See JBrowse CLI with Desktop.
jbrowse add-track-json '{
"type": "FeatureTrack",
"trackId": "rice_minigraph_bubbles",
"name": "Rice pangenome bubbles",
"assemblyNames": ["GCF_034140825.1"],
"adapter": {
"type": "MinigraphBubbleAdapter",
"uri": "https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph.bubbles.bed.gz",
"csi": true
}
}'In JBrowse Desktop, or in any running JBrowse Web session, open a view on this track’s assembly, then File → Open track..., choose Add pangenome graph track, and fill in:
- File type:
Minigraph bubbles (tabix BED) - Path:
https://jbrowse.org/demos/rice_pangenome/rice-agis1-minigraph.bubbles.bed.gz - Track name:
Rice pangenome bubbles - Assembly:
GCF_034140825.1
Building the rice graph
The rice genome is small enough for one minigraph run over every chromosome at
once, reference first so that its segments take rank 0, the earliest build
order:
# -xggs: incremental graph construction, adding each genome in turn
# -c: base-level alignment, which minigraph recommends for graph generation
minigraph -cxggs -t 8 Nipponbare.fa SL001.fa SL010.fa ... Wuyunjing8.fa > rice.gfaPangenome (hosting your own graph) then turns the graph into the files
above with one command, gfa-to-tabix build.
build_rice_pangenome.sh
runs the whole build on Linux, since it needs GNU tools. It downloads the 48
assemblies from NCBI with the datasets CLI and took 5.5 hours of minigraph
time on 8 threads. It:
- downloads each assembly with its sequence report
- keeps each assembly's twelve chromosomes, renamed to PanSN
(
sample#haplotype#contig) from the report, and drops organelles and unplaced scaffolds - runs
minigraphover all of them - writes the index files
The script stops if:
- a segment has an
SNtag that names no kept chromosome - a segment id repeats
- the rank-0 segments are not AGIS-1.0's twelve chromosomes at their full length
A graph that fails any of these has wrong coordinates that every later check accepts, so copy these audits into your own build.
See also
- Tutorial: Pangenome (fly)
- Tutorial: Pangenome (hosting your own graph)
Citations
- Li et al. (2020). The design and construction of reference pangenome graphs with minigraph
- Monna et al. (2002). Positional cloning of rice semidwarfing gene, sd-1: rice "green revolution gene" encodes a mutant enzyme involved in gibberellin synthesis
- Bhuvaneswari et al. (2020). Discovery of a novel induced polymorphism in SD1 gene governing semi-dwarfism in rice and development of a functional marker for marker-assisted selection
- Lee et al. (2015). Influence of multi-gene allele combinations on grain size of rice and development of a regression equation model to predict grain parameters
- Gamuyao et al. (2012). The protein kinase Pstol1 from traditional rice confers tolerance of phosphorus deficiency
- Vigueira et al. (2016). Long-term balancing selection at the Phosphorus Starvation Tolerance 1 (PSTOL1) locus in wild, domesticated and weedy rice (Oryza)
Feedback on this tutorial is welcome: contact us.