The manual






Table and graph representations

There are two ways to represent data in the form of a table or a graph:

states and views,

the 'dataware' block inside a form.

What we are describing here corresponds to the 'dataware' block inside a form, the content of which is specified by a program of that form.

Configure the data representation of the dataware block

The type of representation chosen, as well as the general parameters of the representation, are specified using the dw_chart instruction:

dataware variable_du_bloc_dataware
  dw_chart "type_de_représentation" "liste_des_options"

For example :

dataware d
  dw_chart "pie" "size 50"

Note that the list of options indicated in the 'dw_chart' instruction, which we will explore in detail in this document, provides only part of the parameters used to configure the graphical representation of the dataware block.
Options such as 'color' in the 'dw_bin', 'dw_category', 'dw_value' or 'dw_add' statements allow you to specify the rest of the parameters, in particular the background color of rows, columns, or individual cells in a table, and the color of the different elements of a graph. The instructions available for specifying the data to be plotted are shown here:

Documentation of the Dataware data type

Representation in table form

The type is'table'.


Display the total at the end of each line.


Add a total line at the bottom.


Combines the two previous effects.

The background color of cells, columns and row, as well as the text color of each cell, are provided via the 'color' option of the 'dw_bin', 'dw_category', 'dw_value' and 'dw_add' instructions.
The 'button', 'link' and 'help' options of these same instructions make the different boxes clickable.

Representation in the form of juxtaposed bars

The type is'bar'.
The dataset can be in dimension 1 or 2.
If there is a second dimension, for each value of the first dimension, several bars will be represented side by side, with different colors, and a legend will be displayed on the right indicating the color corresponding to each value of the second dimension.

size x


size x y

Taille du carré ou du rectange dans lesquel les barres sont dessinées, en millimètres.
The default is 170.

unit x

Allows to force the horizontal size of each bar, in millimeters.
The default is calculated so that the width of the set matches the 'size' parameter.

mini x

Value at the bottom of the vertical axis.
The default is the smallest value of the sample represented.

maxi x

Value at the top of the vertical axis.
The default is the largest value of the sample represented.

step x

No vertical scale.
The default is (max-min) / 10


Draw in light gray the vertical lines corresponding to the advance step 'step'


Do not display the labels of the different categories on the right.
By default, they are displayed when there is more than one category.

In the context of a 2-dimensional graph, the color associated with each category is provided by the 'color' option of the 'dw_category' instruction.
The 'button', 'link' and 'help' options of the 'dw_value' and 'dw_add' instructions make the different bars clickable.

The representation in the form of stacked bars

The type is'stack'.
It is identical to the previous one, but if there is a second dimension, the different bars are displayed one above the other.

The representation in the form of lines

The type is'line'.
All the options of the bar representation can be used.
The additional options are:


Connect the points of the curves with curved lines.
The default behavior is to connect the points with line segments.


Define the line thickness of the curves, in millimeters.
The default is 0.75.

point x

Define the size of the point representation of the curves.
The default is 2 * thickness.

The color associated with each row is provided by the 'dw_category' instruction.
The color of a point can be specified at the level of the 'dw_value' or 'dw_add' instruction.
The 'button', 'link' and 'help' options of these same instructions make these points clickable.

Representation in the form of a pie chart

The type is'magpie'.
This representation only requires a data set in dimension 1. If the second dimension is used, then several pie charts will be drawn one under the other.


Size of the circle of the pie chart, in millimeters.
The default is 80.


No list of labels on the right of the pie chart representation.

The 'color' option of the 'dw_bin' instruction allows you to choose the color of each slice.