Skip to content
Open Garphield

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.

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.

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.

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.

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.

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 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.