Skip to content

Axis Swapping

When your benchmark data has multiple dimensions (2D or 3D), the UI lets you swap which dimension maps to which axis. This changes the perspective without regenerating the file.

Vizb extracts up to four dimensions from benchmark names:

  • Name — groups benchmarks into separate charts
  • XAxis — categories on the X-axis
  • YAxis — test case variants
  • ZAxis — depth layer of a 3D chart

In the UI, use the axis dropdown to rearrange these. For example, swap Name and YAxis to see all variants grouped differently.

The dropdown offers arrangements of the present axes — how many you get depends on how many dimensions your data has:

Dimensions present Available arrangements
1 x, y
2 nx, ny, xn, xy, yn, yx
3 every n/x/y ordering, plus xyz orderings (3D)
4 every n/x/y/z ordering

An arrangement that uses z (e.g. xyz) renders a 3D chart; one that rotates z out to name (e.g. nxy) renders 2D. z is only offered when both x and y are present. For single-dimension data, the lone value can only be placed on the x or y axis — grouping it by name would make one chart per point.

  • Compare different perspectives of the same 3D data
  • Group by variant instead of by benchmark family
  • Switch which dimension appears on the X-axis for better comparison

The initial axis assignment comes from your --group-pattern or --group-regex flags:

Terminal window
# Default: Name=XAxis=YAxis assignment from pattern
vizb bench.txt -p n/x/y -o output.html