This version is out of date, covering development from v4.6.0 to v4.7.1. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Container plots

A pattern that applies only to containers (notes & agents), is plot(). It evaluates an expression using data from each child of the containers to produce a graph; i.e the scope is always a group, specifically 'child'.

The graph, in the forms of a sparkline-type plot is drawn across the viewport area of the container. The graph is drawn in color PlotColor. The container viewport is still accessible for drag/drop, etc. as if the plot weren't there - think of the plot as an overlay.

For example, to graph the word count of each child note in the container, see the container's map Pattern attribute to:

 plot($WordCount)

An alternate plot type is bargraph(), which draws a bar graph of each child item's value.

 bargraph($WordCount)

Both operators accept optional minimum & maximum values:

plot($attribute,min,max)

Thus:

 bargraph($WordCount,0)

graphs the word count of each note whilst ensuring the Y-axis is based at zero, with all attribute values including the maximum being plotted. note that while zero is the default value of an 'blank' number type attribute, the type allows minus values. The above example would treat all of them as if their value were zero.

 plot($WordCount,10,900)

graphs the data from a baseline of 10 to a maximum value of 900. Values outside these are plotted appropriately as the min or max values.

The plot/bargraph patterns are ignored if applied to non-container notes.

A container can also apply the bar & vbar progress bar patterns as used with note icons. However, as both types of visualisation use the Pattern attribute it is not possible to use a progress bar and plot at the same time