OptionaltitleOverrides the layer's announced title. Maps to MaidrLayer.title.
Names the chart; use DeclarationBase.name to say which layer of it this is.
OptionalnameNames this layer among sibling layers. Maps to MaidrLayer.name.
Announced on a layer switch in place of the trace type, so a hue-split figure says "Male" and "Female" rather than "error_bar plot" twice.
TraceType.MANHATTAN — the string 'manhattan'.
OptionallabelField holding what each point is — a SNP id, a probe, a marker. Maps to
VolcanoPoint.label.
Identity is the payload on these charts, not the coordinates: a reader told "x is 2.3, y is 14.1" has been given the two numbers whose shape they can already hear and withheld the one thing they came for. Left out of the payload when nothing resolves.
OptionalgroupField holding the region a point belongs to — its chromosome. Maps to
VolcanoPoint.group.
OptionalsignificanceThe significance cutoff on the y axis, on the axis the chart is drawn
against — 7.3 for genome-wide significance on a -log10(p) axis. Maps to
MaidrLayer.thresholdOptions.significance.
There is deliberately no default: the conventions differ by field and by software, and a guessed line would sort every point on the figure onto the wrong side, silently. Undeclared, the trace simply reports no findings.
OptionalsignificanceWhich side of significance is the significant one. Maps to
MaidrLayer.thresholdOptions.significanceDirection.
'above' suits the transformed axes these charts usually carry; a raw p
axis runs the other way and needs 'below', where a reading fixed to
'above' would select precisely the points that failed to reach
significance and announce them as the result.
The grammar's 'above' default is the grammar's to apply: pass your value
through or pass nothing.
OptionaleffectThe effect-size cutoff on the x axis, applied to its magnitude. Maps
to MaidrLayer.thresholdOptions.effect.
Meaningful on a volcano, whose x is an effect size. A Manhattan's x is a genomic position and its x-axis plot lines are chromosome dividers rather than cutoffs, so this is never inferred for one — declare it or leave it out.
OptionalmergeAbsorb following sibling series of the same drawn kind that carry no declaration of their own into this layer.
This is how a 22-dataset Manhattan becomes one navigable trace rather than 22 layers a reader must switch between.
Genomic position against significance — the standard figure of a GWAS.
Read as a scatter it offers point-by-point navigation over tens of thousands of points, which is not a viable path to the few dozen that matter. What a reader wants is which points cross the line and what they are called.
Example