Visual channels
Open Viz to connect a source to a channel, or Style to set appearance that does not come from graph data. A channel accepts only compatible result types and targets.
Node channels
Section titled “Node channels”| Channel | Accepts | Use |
|---|---|---|
| Size | Numeric | Compare magnitude or importance. |
| Colour | Numeric, category, set | Show a scale, group, or selected set. |
| Shape | Numeric, category, set | Separate categories or roles. |
| Image | Category | Select an image from a categorical field. |
| Node label | Numeric, category | Show an id, name, or attribute. |
| Border colour | Category, set | Colour the node outline by category, or highlight set membership. |
| Pie slices | Numeric, category | Show a small composition on a node. |
Image values and crop regions
Section titled “Image values and crop regions”An image value is an image URL (https:, a site-relative path or a data:
image). It may end in a W3C Media Fragments spatial fragment to show only part
of the picture:
| Fragment | Meaning |
|---|---|
#xywh=10,20,300,200 |
Region in pixels: x, y, width, height. |
#xywh=pixel:10,20,300,200 |
The same, written explicitly. |
#xywh=percent:0,0,50,100 |
Region as percentages of the image, each 0 to 100. |
Several nodes can reference one image with different regions: the file is downloaded once, and each node shows its own part. A region that is partly outside the image is clipped to it. An invalid or empty region (non-numeric, zero or negative size, wholly outside the image, a percentage over 100) is ignored and the whole image is shown. Node images are placed by the Image fit control in Style: whole keeps the region inside the node with a margin, fill crops it to a square that fills the node. Both apply within the region.
Shape values
Section titled “Shape values”A categorical Shape source gives each category the next shape in the cycle:
circle, square, triangle, diamond. A category whose value is itself one of
those names (in any letter case) gets that shape, so a column can state the
shape it wants: a field holding square on every row draws every node as a
square. Shapes claimed by name are left out of the cycle for the other
categories.
Missing numeric values
Section titled “Missing numeric values”A numeric field stays numeric when some rows have no value: a blank CSV cell,
null, or a node or link without the attribute. A numeric channel draws a
row without a finite number as missing rather than as the smallest value:
- Size uses the default node size.
- Colour and Edge color use the neutral grey of an unbound mark.
- Edge width uses the default link width.
- Shape uses the circle.
- Heatmap adds no heat for it.
The colour legend leaves these rows out of the ramp’s range and lists them as No value. A range filter on the field hides them, because they fall outside every range; this is how a node without the attribute has always behaved in a range filter.
Edge channels
Section titled “Edge channels”| Channel | Accepts | Use |
|---|---|---|
| Edge color | Numeric, category, set | Show a relationship value or type. |
| Edge width | Numeric | Show weight or another magnitude. |
| Link label | Numeric, category | Label relationships. |
| Edge style | Category | Distinguish relationship styles. |
Directed edges can also use tapered or line treatments and source-to-target colour gradients from Style.
Layers
Section titled “Layers”Layers add structure around the marks:
- Convex hull and Contour show group or set boundaries.
- Heatmap shows a numeric density or intensity field.
- The minimap can switch between the full drawing and a group-level view. Nodes bound to an image show it in the minimap once they are large enough to read; smaller ones take the image’s average colour.
Bound Convex hull and Heatmap wells include an Intensity slider.
Both start at 50%; 0% suppresses the layer and 100% makes it more prominent.
The slider changes appearance without changing the bound source or its
algorithm parameters. One gesture creates one undo step, and the value is
saved in shared views and .gph projects.
Heatmaps use a warm sequential palette adapted to the canvas theme. Hotspots show accumulated contributions from nearby nodes, rather than a direct colour lookup for each node’s value. Hidden nodes and invalid numeric values do not contribute.
Numeric bindings use scales; categorical bindings use bounded palettes. Saved edge sets can drive Edge color to highlight their exact membership.
See See the structure of a network, the workspace tour, and Sources and algorithms.