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

/page/www/DQ519I2E/0K4I5W2

Representation in table form

The type is'table'.

`no_bin_column`	Ne pas afficher la colonne de gauche avec le code correspondant à chaque ligne.
`horizontal_total`	Display the total at the end of each line.
`vertical_total`	Add a total line at the bottom.
`total`	Combines the two previous effects.

La couleur de fond des cellules, colonnes et ligne sont fournies via l'option 'color' des instructions 'dw_bin', 'dw_category', 'dw_value' et 'dw_add'. La couleur des textes par l'option 'foreground' de ces mêmes 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` ou `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
`yline`	Draw in light gray the vertical lines corresponding to the advance step 'step'
`no_legend`	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.
Les options 'button', 'link' et 'help' des instructions 'dw_value' et 'dw_add' permettent de rendre cliquables les différentes barres.

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:

`smooth`	Connect the points of the curves with curved lines. The default behavior is to connect the points with line segments.
`thickness`	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`	Size of the circle of the pie chart, in millimeters. The default is 80.
`no_legend`	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.

La représentation sous forme de nuage de points

Le type est 'point'.
Les options supplémentaires sont :

`size` `mm_x` `mm_y`	Taille du dessin, en millimètres.
`point` `mm`	Taille des points en millimètres.
`xmini` `x`	Valeur sur la gauche de l'axe horizonal. La valeur par défaut est zéro. Si l'on souhaite la plus petite valeur de l'échantillon représenté, il faut utiliser 'xmini ?'.
`xmaxi` `x`	Valeur sur le droite de l'axe horizontal. La valeur par défaut est la plus grande valeur de l'échantillon représenté.
`xstep` `x`	Pas de l'échelle horizontale. La valeur par défaut est (xmaxi-xmini)/10
`xline`	Trace les lignes verticales correspondant aux différents pas de l'échelle horizontale.
`ymini` `x`	Valeur au bas de l'axe verticale. La valeur par défaut est zéro. Si l'on souhaite la plus petite valeur de l'échantillon représenté, il faut utiliser 'ymini ?'.
`ymaxi` `x`	Value at the top of the vertical axis. The default is the largest value of the sample represented.
`ystep` `x`	No vertical scale. La valeur par défaut est (ymaxi-ymini)/10
`yline`	Trace les lignes horizontales correspondant aux pas de l'échelle verticale.
`mini` `?`	Equivalent de 'xmini ? ymini ?', c'est à dire que la valeur mini sur les deux axes sera déterminée les valeurs mini des points au lieu d'être zéro.
`regression`	Trace la droite de régression des moindres rectanges, en gris clair.
`thickness` `mm`	Epaisseur de la ligne pour le dessin de la droite de régression.

Le dataware doit contenir une catégorie 'x' et une catégorie 'y', mais il n'est pas nécessaire de définir les catégories si l'on utilise l'instruction 'dw_point' pour définir les points.
L'instruction 'dw_point' peut recevoir en option un libellé et une couleur :

dw_point x y label "libellé" color rgb r g b