Artisan Documentation

Visual scope for coffee roasters

Wheel Graphs (V 0.5.0)

Wheel graphs help visualize data that can be broken down into categories, which in turn can be broken into components (labels) or subcategories.

Categorization is the process by which distinct entities are treated equivalent. Organizing principles can be based on similarity, levels of abstractions, domains, divisions, etc. Categories can be mutually exclusive, overlapping, hierarchical, non hierarchical, etc. For example, flavor categorization of coffee can consist of divisions of flavor sensations into classes corresponding to their perceptual processes.

Wheel Graph Editor usage:


Wheels can be added or deleted by pressing the Add and Del buttons.


Modify the radius of each wheel using the Radius button


Using a separate text editor, write the labels of each wheel separating them by a comma. Labels in a wheel run counterclockwise from degree zero. The first label will be placed in the zero degree location. The next label will be placed counterclockwise from the previous label. The whole 360 degrees of a wheel will be initially divided equally between the number of labels found. Once finished with the text editor, copy and paste the labels to the Edit Labels box. Then press the Update button. The number of labels separated by a comma determines the number of segments per wheel.

Once the labels are made, chose the appropriate text orientation for each wheel using the button Text Projection.


The order of the change is important. Change widths starting from the most inner wheel of the graph to the most outer wheel of the graph. Change widths starting from the first label of each wheel (degree zero) to the last label of each wheel counterclockwise.

This editor allows either free or hierarchical graphs. The labels of a free graph don’t have a width relationship with the labels of previous wheel (parents). Meanwhile the elements of a hierarchical graph do.

To create a width hierarchy in a particular wheel, press the Wheel Properties button. Then select a parent from the inner wheel for each label. If more than one label share the same parent, then the width of the parent will be equally divided. Once finished, open the Wheel properties of the next outer wheel and do the same.

There is an optional global hierarchy made by using the button Set Hierarchy. If you want a graph with the labels of the most outer wheel to have all the same width, press this button. This button requires all the labels in the graph to have a parent (except the labels of the most inner wheel) as it adjusts the widths starting from the outer wheel towards the inner wheel..


Each label can be colored independently. A color pattern can also be applied to an entire wheel or to the whole graph.


A graph is rotated by by pressing the > or < buttons. In a free graph (no hierarchies), each wheel can be individually rotated using the Starting Angle property.