LinearManhattanDisplay
Auto-generated config schema for the current JBrowse release — see the
config guide for concepts. Provided by the gwas plugin.
View source.
Example usage
Minimal GWASTrack config. See the
GWAS track guide for all options:
{
type: 'GWASTrack',
trackId: 'gwas',
name: 'GWAS results',
assemblyNames: ['hg38'],
adapter: {
type: 'GWASAdapter',
uri: 'https://example.com/gwas.bed.gz',
},
}
Taller track, LocusZoom-style coloring: colorBy: 'ld' colors each point by its
r² to the index SNP read from the adapter's ldAdapter sub-adapter. The LD data
is a second source on GWASAdapter (mirroring MAF's annotationAdapter), so it
nests under adapter, while display-only options like height/colorBy go in
displayDefaults — see
configuring displays:
{
type: 'GWASTrack',
trackId: 'gwas',
name: 'GWAS results',
assemblyNames: ['hg38'],
adapter: {
type: 'GWASAdapter',
uri: 'https://example.com/gwas.bed.gz',
ldAdapter: {
type: 'PlinkLDTabixAdapter',
uri: 'https://example.com/plink.ld.gz',
},
},
displayDefaults: {
height: 400,
colorBy: 'ld',
},
}
See the Config slots section below for all available configuration fields.
configuration for the Manhattan plot display used by GWAS tracks
Related links
- Adapter: GWASAdapter
- State model: runtime API
- Base config: BaseLinearDisplay
- Guide: A selected haplotype (Dog10K)
- Guide: Custom track and display types
- Guide: Defaults for all tracks
- Guide: GWAS track
- Guide: Tracks
Config slots
These slots go on a display entry:
"displays": [{ "type": "LinearManhattanDisplay", ... }], 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 |
|---|---|
colorcolor = '#0068d1' | CSS color or jexl callback for Manhattan points callback args: feature |
colorBystringEnum (normal, ld) = 'normal' | LocusZoom-style coloring. 'normal' uses color; 'ld' colors each point by its r² to the index SNP, read from the GWASAdapter's ldAdapter sub-adapter. |
significanceLinemaybeNumber | Draw a horizontal line across the plot at this score, for the threshold a scan is read against: genome-wide significance on a GWAS, or an empirical outlier cutoff on a differentiation scan. Unset (the default) draws none, since there is no threshold that is right for every scan. On the plot's own scale, so it is a -log10(p) where the points are and an Fst where scoreColumn names an Fst column. The autoscaled y-axis widens to reach it, so a window where nothing clears the threshold still shows the threshold; an explicit minScore/maxScore that excludes it still wins, and there the line is not drawn. |
minimalTicksboolean = false | Draw only the min/max Y-axis ticks advanced |
scatterPointSizemaybeNumber = 4 promotable | Manhattan point diameter in px (adjustable from the track menu). Larger default than wiggle's since Manhattan points are the primary glyph. |
showLdLegendmaybeBoolean = true promotable | Draw the LD color key, which labels the r² ramp the points are painted against. Only appears while LD coloring is active — the ramp means nothing under the plain single-color scheme. |
minScorenumber = Number.MIN_VALUE | Fixed minimum score bound. The default (Number.MIN_VALUE) is a sentinel meaning "unset, use autoscale" advanced |
maxScorenumber = Number.MAX_VALUE | Fixed maximum score bound. The default (Number.MAX_VALUE) is a sentinel meaning "unset, use autoscale" advanced |
scaleTypestringEnum (linear, log) = 'linear' | Scale type (linear or log) |
autoscalestringEnum (local, localsd, localpercentile) = 'localpercentile' | Autoscale type: "local" uses the min/max in the visible region, "localsd" uses mean ± numStdDev standard deviations, "localpercentile" uses the numQuantile-th percentile score as the max (robust to skewed/peaky data) |
numStdDevnumber = 3 | Number of standard deviations to use for the localsd autoscale type advanced |
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 |
| Inherited from BaseLinearDisplay | 6 slots |
maxFeatureScreenDensitynumber = 1 | maximum features per pixel before showing a "too many features" message advanced |
heightnumber = 100 | default height for the track |
mouseoverstring = | text to display when the cursor hovers over a feature callback args: feature |
jexlFiltersstringArray = [] | config jexlFilters are deferred evaluated so they are prepended with jexl at runtime rather than being stored with jexl in the config |
fetchSizeLimitnumber = 1_000_000 | maximum data to attempt to download for a given track, used if adapter doesn't specify one advanced |
forceLoadboolean = false | Declarative equivalent of the "Force load" button on the "too much data" banner: when true the display always renders, however large the region or dense the features. Off by default (the gate guards against huge downloads). Set it on a view no one can interact with — an embedded / notebook view, or a screenshot — where the region is known and you want it drawn without a click. advanced |