This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Pattern: bargraph() (for container plot only)

Pattern: bargraph() (for container plot only)

Note that this pattern can't be set via the Pattern menu, but only via action code or Info view. Rather it is set via manual editing of the $Pattern attribute or via actions, rules, etc., acting upon it. This pattern is only available for use in container plots and has no visual effect if applied to other objects.

The graph is drawn in the form of a bar graph plot across the viewport area of the container. The graph is drawn in colour $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 in bar graph form, set the container's map Pattern attribute to:

 bargraph($WordCount)

The Y-axis of the graph will run from the minimum value of the specified attribute - for the notes being plotted, to the largest value.

The pattern accepts optional minimum & maximum values:

bargraph($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. If a negative min value is supplied, negative item values above that threshold are plotted. For:

 bargraph($WordCount,10,900)

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

An alternate container plot type is plot(), which draws a sparkline-type plot of each child item's value or, xyplot() which draws a similar sparkline-type plot but where data can be specified for both axes.

From v5.10.2, the background of the plot is set via $PlotBackgroundColor with opacity of $PlotBackgroundOpacity.


Possible relevant notes (via "Similar Notes" feature):


A Tinderbox Reference File : Visual Styling : Shapes, borders, patterns and fills : Pattern: bargraph() (for container plot only)