VGL Guide — Timeline
Estimated reading time: 1 minutes.
Timeline
Events across multiple tracks on a shared time axis, aligned by column.
Node types
TimePoint— a coordinate on the time axis, rendered as an anchor dot on a horizontal baseline with the year centred below it, and a dashed vertical guide descending through the diagram to anchor Events sharing itsalignGroup. TimePoints are not drawn as boxed nodes.Event— a thing that happened at a point in time (boxed, default: steel blue). UsealignGroupto pin it to a TimePoint's column.
Edge types
sequence— TimePoint → TimePoint. Used by Graphviz for rank ordering but not drawn: the overlay's horizontal baseline replaces the arrows visually.influence— Event → Event, a cross-track or within-track dependency (dashed,constraint=false). Drawn normally.
vgraph myTimeline: Timeline "19th Century Europe" {
// Time axis
node t1800: TimePoint "1800" [alignGroup: "1800"]
node t1850: TimePoint "1850" [alignGroup: "1850"]
node t1871: TimePoint "1871" [alignGroup: "1871"]
edge t1800 -> t1850: sequence
edge t1850 -> t1871: sequence
group germany "Germany" {
node g1: Event "Napoleon defeats Prussia" [alignGroup: "1800"]
node g2: Event "German Unification" [alignGroup: "1871"]
}
group england "England" {
node e1: Event "Industrial Revolution peaks" [alignGroup: "1850"]
node e2: Event "Franco-Prussian War impact" [alignGroup: "1871"]
}
edge g1 -> g2: influence "led to"
edge e1 -> g2: influence "industrialization enabled"
}
Timelines flow left to right, and groups become visual tracks. alignGroup is what puts nodes in the same column — TimePoints are optional, and alignGroup alone suffices for alignment.
Each TimePoint renders as a filled dot on a horizontal baseline with its label centred below, and a dashed vertical guide descends through the diagram so a reader can trace from a year down to every Event in that column. The sequence arrows are suppressed, because the baseline already conveys order. A
vnotation … extends Timeline inherits this rendering.
Home