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 (rect),
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 RNA and 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
Color channels
| Setting | Page | scale.type |
Preset fields |
|---|---|---|---|
encoding.color |
WiggleColor | linear, threshold | source |
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 rect a strip whose color is the score. extent is the band of each bin's min and max drawn around it. The track menu's Plot type writes it. v4's defaultRendering loads as its mark: xyplot a bar, scatter a point, density a rect, 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, colors, tree and kept are what the arrangement dialog, a clustering run and a focus write, each as a session edit to this object. colors pins a subtrack's color ahead of the adapter's and the palette: its plot, on both sides of the origin, while encoding.color colors by source, 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, the score through a scale — threshold for solid bands, linear for a gradient — or source, each subtrack in its row color. Unset, it colors by source on bars, points and lines, so a subtrack with no color draws the pos/neg pair about the origin, and a heatmap fades to that pair from white there. encoding.y is the field plotted and the value axis it is drawn through: field, scale, axis and rules. encoding.size is a point's diameter and encoding.strokeWidth a line's width, in px. The row axis is rows.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. |
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 |
Retired keys
An older config may still write these. Each loads without an error, and jbrowse validate reports it as stale.
| Key | On load |
|---|---|
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 |
renderers |
moved into a current slot |
defaultRendering |
moved into a current slot |