LinearWiggleDisplay
Auto-generated config schema for the current JBrowse release — see the config guide for concepts. Provided by the wiggle plugin. View source.
Example usage
Minimal QuantitativeTrack config. See the
quantitative track guide for all
adapter and display options:
{
type: 'QuantitativeTrack',
trackId: 'coverage',
name: 'Coverage',
assemblyNames: ['hg38'],
adapter: { type: 'BigWigAdapter', uri: 'https://example.com/coverage.bw' },
}
Several bigWigs stacked one per row, which is what a MultiQuantitativeTrack
does by default:
{
type: 'MultiQuantitativeTrack',
trackId: 'coverage_by_sample',
name: 'Coverage by sample',
assemblyNames: ['hg38'],
adapter: {
type: 'MultiWiggleAdapter',
bigWigs: [
'https://example.com/sample1.bw',
'https://example.com/sample2.bw',
],
},
displayDefaults: { facet: 'source' },
}
Taller track, log scale, custom color:
{
type: 'QuantitativeTrack',
trackId: 'coverage',
name: 'Coverage',
assemblyNames: ['hg38'],
adapter: { type: 'BigWigAdapter', uri: 'https://example.com/coverage.bw' },
displayDefaults: {
height: 200,
scales: { y: { type: 'log' } },
color: 'darkgreen',
},
}
See the Config slots section below for all available configuration fields.
configuration for the quantitative display: an XY plot, density, line or
scatter rendering of one source or of many, with facet: 'source' giving
each source a row of its own
Per-source metadata (a name, color and group for each) is preloaded on
the adapter rather than here — see MultiWiggleAdapter's subadapters
slot, where group drives the sidebar clustering tree and color sets each
source's line or fill.
These are display-level slots: set them inside a track's displays to
change its defaults (setting them at the track top level has no effect).
The object shorthand displayDefaults: { key: value } is equivalent to the
full displays: [{ type: 'LinearWiggleDisplay', displayId: '...', key: value }]
array form — see
configuring displays.
Related links
- Adapter: BedGraphAdapter
- Adapter: BedGraphTabixAdapter
- Adapter: BigWigAdapter
- Adapter: GCContentAdapter
- Extended by: SharedGCContentDisplay
- State model: runtime API
- Guide: Clustering rows
- Guide: CNV across a population (1000 Genomes)
- Guide: Cookbook
- Guide: Custom track and display types
- Guide: Display settings
- Config guide: Quantitative track
- User guide: Quantitative track
- Guide: Single-cell ATAC pseudobulk
- Guide: Structural variants (Cancer GIAB)
- Guide: Tracks
Config slots
These slots go on a display entry: "displays": [{ "type": "LinearWiggleDisplay", ... }], or in the track's displayDefaults when this is its default display. Slot types (fileLocation, frozen, ...) are explained in the config slot types reference. Slots a base configuration contributes are listed here too, so this table is the whole surface.
| Slot | Description |
|---|---|
defaultRenderingstringEnum (xyplot, density, line, linecenter, scatter) = 'xyplot' | Default rendering type: xyplot, density, line, linecenter, or scatter. |
| facet Facet | One row per value of a field, stacked down the track with a label, a separator and the clustering sidebar. source — one row per subtrack — is the only field this display reads; leave it unset and every source is drawn in one shared plot. domain is the row order: the subtracks it names lead, the rest keep the adapter's order, and a clustering run rotates its dendrogram towards it rather than discarding it. |
| color WiggleColor | One CSS colour, or a field through a scale — score through threshold for the bicolor plot, through linear or log for the density ramp, source through categorical for a palette entry per subtrack. Unset, the layout decides: several sources in one plot box take a palette entry each, and anything else is the pos/neg pair about the origin. |
| scales ValueScale | The y scale the plot is drawn through: type, domainMin, domainMax, autoscale, numStdDev, numQuantile, symlogConstant and rules, the reference lines drawn across it. The density rendering draws no rule and does not widen to one: it spends colour on the score and has no axis to rule. |
showLegendboolean = true | Draw the key: density's score color ramp, or the source colors where several share one plot. Defaults to on |
minimalTicksboolean = false | Draw only the min/max Y-axis ticks advanced |
heightnumber = 100 | default height for the track |
scoreFieldstring = 'score' | Feature field plotted on the score axis, read natively off each feature. The default score is the field every adapter serves — including the value a BED adapter's scoreColumn rewrote it to — so an explicit name here reaches a raw column the adapter left alone (a BED extra column, a GFF attribute) and takes precedence over that adapter-tier rewrite. The Manhattan plot skips a feature with no finite value in the field; the wiggle renderings plot it at 0 |
displayCrossHatchesboolean = false | Rule the score axis with horizontal cross hatches at the tick positions — the config form of the score menu's "Show cross hatches". Ignored by the density rendering types, which spend color rather than height on the score and so have no axis to rule |
resolutionnumber = 1 | how many points per pixel the fetch asks a tiered file for: 1 is one per pixel, larger is finer and smaller is coarser. Clamped to the range the Resolution menu offers, so a value outside it reads as the nearest end |
originnumber = 0 | The value bars grow from, and what a color scale reads where its own domain or domainMid is empty. The same slot, with the same meaning, as the mark display's origin |
scatterPointSizenumber = 2 | Point height in px for scatterplot rendering. Defaults to 2 advanced |
lineWidthnumber = 1 | Line thickness in px for line rendering. Defaults to 1 advanced |
maxGapMultiplenumber = 0 | Interpolated line only: break the line where consecutive points sit further apart than this multiple of the track's own mean point spacing, instead of drawing one long chord across the hole. Scaled to the data rather than a fixed bp distance so it holds at every zoom. 0 disables breaking (the pre-existing behavior, one connected line throughout) advanced |
summaryScoreModestringEnum (max, min, avg, whiskers) = 'whiskers' | choose whether to use max/min/average or whiskers which combines all three into the same rendering |
showTreeboolean = true | Show the subtrack clustering tree in the sidebar |
showBranchLengthboolean = true | position tree nodes by branch length (dendrogram) rather than evenly by topology (cladogram) |
showRowLabelsboolean = true | Name each subtrack row down the left edge |
treeAreaWidthnumber = 80 | width in px of the tree sidebar, which a drag on its edge also writes |
showRowSeparatorsboolean = false | draw a hairline between adjacent rows; off by default, because a painting whose neighbouring rows differ in color already separates itself and the line only earns its pixel where they do not — a run of same-colored rows reads as one block without it, with no way to recover the row count by eye. Drawn only once rows are at least 4px tall: below that the line is as thick as the row it borders, turning a dense painting into a grid of hairlines with a little color between them |