LinearWiggleDisplay
Auto-generated from the config schema in the source — see the config guide for concepts. Provided by the wiggle plugin. View source.
Draws quantitative signal as bars, points, a line or a color strip (span),
for one source or many; rows: 'source' draws each source in a separate row.
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.
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, which a MultiQuantitativeTrack stacks one per row:
{
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',
],
},
}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,
encoding: {
y: { scale: { type: 'log' } },
color: { value: 'darkgreen' },
},
},
}Related links
- Adapter: BedGraphAdapter
- Adapter: BedGraphTabixAdapter
- Adapter: BigWigAdapter
- State model: runtime API
- Tutorial: CNV across a population (1000 Genomes)
- Tutorial: Display settings
- Tutorial: Single-cell ATAC pseudobulk
- User guide: Clustering rows
- User guide: Quantitative track
- Config guide: Quantitative track
- Config guide: Tracks
- Developer guide: Custom track and display types
- Docs: Cookbook
Config slots
Display 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 |
|---|---|
| mark WiggleMark | The shape each score is drawn as, using the mark display's names: bar draws a bar from the origin to the score, point a point at it, line a line through the scores, stepped or as interpolate says, and span a strip whose color is the score. The track menu's Plot type writes it. v4's defaultRendering loads as its mark: xyplot a bar, scatter a point, density a span, line a stepped line and linecenter a linear one. A WiggleMark object, or its type alone. |
| rows QuantitativeRows | One row per value of a field, stacked down the track with a label, a separator and the clustering sidebar, and the arrangement a reader gives them. source — one row per subtrack — is the only field this display reads; leave it unset and every source is drawn in one shared plot. sort 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. labels, tree, treeProvenance and kept are what the arrangement dialog, a clustering run and a focus write, each as a session edit to this object. |
| rowColor RowColor | The color a reader set on a named subtrack, as scale.domain and scale.range pairs, ahead of the adapter's color and the palette: its plot while encoding.color is unset, and otherwise, or under a score gradient, the tint beside its label. |
| encoding WiggleEncoding | The channels the marks paint through. encoding.color is one CSS color in value, or the score through a scale — threshold for solid bands, linear for a gradient; unset, it is the pos/neg pair about the origin, which a heatmap fades to from white there, and several sources in one plot box each paint their row color. encoding.y is the field plotted and the value axis it is drawn through: field, scale, axis and rules. The row axis beside rows is axis. |
| data WiggleData | What the fetch reads, a WiggleData object: resolution is the points per pixel asked of a tiered file. |
| legend Legend | The key: density's score color ramp, a threshold's bands, or the source colors where several share one plot. |
| axis RowAxisWithGrid | The row axis down the left of the subtrack rows: the clustering tree, each subtrack's name and the lines between rows. The value axis is encoding.y.axis. |
heightnumber = 100 | default height for the track |
originnumber = 0 | The value bars grow from, and the cut a threshold color scale with an empty domain uses. The same slot, with the same meaning, as the mark display's origin |
sizemaybeNumber | the mark's size in px, the display's constant for what the mark display spells encoding.size: a point's diameter, 2 while unset, or a line's width, 1 while unset |
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 keeps one connected line advanced |
extentstringEnum (min-max, none) = 'min-max' | the span drawn around each bin's plotted value: 'min-max' draws the bin's stored min and max with it, as a lighter band, while y names a stored summary |
Retired keys
An older config may still write these. Each loads without an error, and jbrowse validate reports it as stale.
| Key | On load |
|---|---|
scales | moved into a current slot |
y | moved into a current slot |
maxFeatureScreenDensity | ignored |
maxDisplayedBpPerPx | ignored |
fetchSizeLimit | ignored |
mouseover | ignored |
jexlFilters | moved into a current slot |
displayCrossHatches | moved into a current slot |
minimalTicks | ignored |
scaleType | moved into a current slot |
autoscale | moved into a current slot |
minScore | moved into a current slot |
maxScore | moved into a current slot |
numStdDev | ignored |
inverted | ignored |
color | moved into a current slot |
renderers | moved into a current slot |
summaryScoreMode | moved into a current slot |
resolution | moved into a current slot |
showTree | moved into a current slot |
showBranchLength | moved into a current slot |
showRowLabels | moved into a current slot |
treeAreaWidth | moved into a current slot |
showRowSeparators | moved into a current slot |
defaultRendering | moved into a current slot |
lineWidth | moved into a current slot |