vertices

A vertex table from @data, one vertex per row: vertices(names: #cities.city; sizes: #cities.population; groups: #cities.region). names: is the key an edge list's cells and an inline vertex's label are matched against; the other columns carry what the network's own measurements cannot — the data's own numbers and categories. Column attributes are plural. A listed vertex with no edges is drawn on its own. The table also carries the vertices' encodings — colour-by: and size-by: — which live on the tables, never on the environment. A table with no names: lists no rows: its rules cover every vertex no named table lists, inline vertices included — vertices(size-by: degree).

verticesNode
Five countries as vertices sized by population and coloured by the language most of their people speak, joined by their shared borders.Five countries as vertices sized by population and coloured by the language most of their people speak, joined by their shared borders.

#Attributes

namesImplicit
The column naming each row's vertex. A name matching an inline vertex's label or id — case and spacing aside — lends that vertex the row; any other name makes a vertex.
Can be written as shorthand: vertices:value
labels
What each vertex is labelled, where it differs from its name: names: #cities.code with labels: #cities.city.
groups
Each vertex's group — what colour-by: group, the circle's ordering and a bipartite split read. Under colour-by: group each group is dealt a hue and named in the footer's key. An inline vertex's own group: wins.
colour-by
How the table's rows are coloured: group deals each of its groups: a hue, named in the key; component colours by which connected piece of the network a vertex is in; community by the densely knit clusters modularity finds within a piece (the Louvain method). A vertex's own colour: overrides it.
nonegroupcomponentcommunity
Also written: color-by
Defaultnone
hues
Pins the groups whose hue carries meaning: hues: Labour = red, Green = green — each group as the data spells it (case and spacing aside), =, then its colour. The rest are dealt from the palette, skipping every pinned hue, so a dealt group never wears a colour a pinned one was given to mean.
network-hues
hue-labels
Renames groups in the footer's key, and only there: hue-labels: neutral = Neutral — each group as the data spells it, =, then the name the key gives it.
network-hue-labels
sizes
A numeric column: each vertex's area in proportion to its reading, measured against the largest in the column. It replaces size-by: for the vertices the table lists.
size-by
Vertex area in proportion to a measurement of the network: degree, in-degree, out-degree, betweenness, or weight — the summed weight of a vertex's edges. in-degree and out-degree need a directed network. A vertex's own size: multiplies it.
nonedegreein-degreeout-degreebetweennessweight
Defaultnone
hiddenAnimatable
Declared but not drawn, with the vertices only this table names and their edges. They still count in every measurement. Animatable.
Defaultfalse

#Allowed in

#Examples

vertices(names: #cities.city; sizes: #cities.population; groups: #cities.region)
vertices(names: #species.code; labels: #species.name; groups: #species.diet; colour-by: group)
vertices(size-by: betweenness; colour-by: community)

Last updated