The <diagram> container tag is used to draw pie, bar, or line charts as well as graphs. It is quite complex with six internal container tags.

Internal Tags

<data>

The data the diagram is to visualize, in tabular form.

<colors>

The colors for different pie slices, bars or lines.

<legend>

A separate legend with description of the different pie slices, bars or lines.

<xaxis>

Used for specifying the quantity and unit of the x-axis, as well as its scale, in a graph.

<yaxis>

Used for specifying the quantity and unit of the x-axis, as well as its scale, in a graph or line chart.

<xnames>

Separate tag that can be used to give names to put along the pie slices or under the bars. The names are usually part of the data.

Pie

<diagram type=pie width=200 height=200
name='Population'
tonedbox='lightblue,lightblue,white,white'>
<data separator=,>
5305048,5137269,4399993,8865051
</data>
<legend separator=,>
Denmark,Finland,Norway,Sweden</legend>
</diagram>

Bar

<diagram type=bar width=200 height=250
name='Population' horgrid
tonedbox='lightblue,lightblue,white,white'>
<data xnamesvert xnames separator=,>
Denmark,Finland,Norway,Sweden
5305048,5137269,4399993,8865051</data>
</diagram>

<diagram type=bar width=200 height=250
name='Age structure' horgrid
tonedbox='lightblue,lightblue,white,white'>
<data xnamesvert xnames form=column
  separator=,>
Denmark,951175,3556339,797534
Finland,966593,3424107,746569
Norway,857952,2846030,696011
Sweden,1654180,5660410,1550461</data>
<legend separator=,>
0-14,15-64,65-
</legend>
</diagram>

Sumbar

<diagram type=sumbar width=200 height=250
name='Land Use' horgrid
tonedbox='lightblue,lightblue,white,white'>
<data xnamesvert xnames form=column
  separator=,>
Denmark,27300,4200,10500
Finland,24400,231800,48800
Norway,9240,83160,215600
Sweden,32880,279480,102750</data>
<legend separator=,>
Arable,Forests,Other
</legend>
<yaxis quantity=area>
<yaxis unit=km^2>
</diagram>

Normalized Sumbar

<diagram type=normsumbar width=200 height=250
name='Land Use' horgrid
tonedbox='lightblue,lightblue,white,white'>
<data xnamesvert xnames form=column
  separator=,>
Denmark,27300,4200,10500
Finland,24400,231800,48800
Norway,9240,83160,215600
Sweden,32880,279480,102750
</data>
<legend separator=,>
Arable,Forests,Other
</legend>
<yaxis quantity=%>
</diagram>

Line Chart

<diagram type=line width=200 height=250
name='Exchange Rates' horgrid
tonedbox='lightblue,lightblue,white,white'>
<data form=row separator=,
 xnamesvert xnames>
1992,1993,1994,1995,1996
0.166,0.154,0.157,0.179,0.172
0.223,0.175,0.191,0.229,0.218
0.161,0.141,0.142,0.158,0.155
0.172,0.128,0.130,0.149,0.140
</data>
<yaxis start=0.09 stop=0.25>
<legend separator=,>
Danish kroner (DKr),
Markkaa (FMk),
Norwegian kronor (NKr),
Swedish kronor (SKr)
</legend>
<xaxis quantity=year>
<yaxis quantity=US$>
</diagram>

Graph

<diagram type=graph width=200 height=300
name='Simple Functions' horgrid
tonedbox='lightblue,lightblue,white,white'>
<colors separator=" ">#60b0ff darkred</colors>
<data separator=,><pike>
  float c;
  
  for (c=-2.0; c < 2.0; c+=0.1)
    output( "%f,%f,", c, c * c );
  output( "%f,%f", 2.0, 2.0 * 2.0 );
  return flush();
</pike>
<pike>
  float c;
  
  for (c=-2.0; c < 2.0; c+=0.1)
    output( "%f,%f,", c, c * c * c );
  output( "%f", 2.0, 2.0 * 2.0 * 2.0 );
  return flush();
</pike></data>
<axis start=-2.1 stop=2.1>
<axis start=-6.1 stop=6.1>
<legend separator=,>
x^2,x^3
</legend>
</diagram>

Attributes

3d=number

Draws a pie-chart on top of a cylinder, takes the height of the cylinder as argument.

background=path

Use the image as background.

bgcolor=color

Set the background color to use for anti-aliasing.

center=number

Centers a pie chart around that slice.

eng

Write numbers in engineering fashion, i.e like 1.2M.

font=font

Use this font. Can be overridden in the <legend>, <xaxis>, <yaxis> and <names> tags.

fontsize=number

Height of the text.

height=number

Height of the diagram. Will not have effect below 100.

horgrid

Draw a horizontal grid.

labelcolor=color

Set the color for the labels of the axis.

legendfontsize=number

Height of the legend text.

name=string

Write a name at the top of the diagram.

namecolor=color

Set the color of the name, by default textcolor.

namefont=font

Set the font for the name.

namesize=number

Sets the height of the name, by default fontsize.

neng

As eng, but 0.1-1.0 is written as 0.xxx.

notrans

Make bgcolor opaque.

rotate=degree

Rotate a pie chart this much.

textcolor

Set the color for all text.

tonedbox=color1,color2,color3,color4

Create a background shading between the colors assigned to each of the four corners.

turn

Turn the diagram 90 degrees.

type=sumbars normsum line bar pie graph

The type of the diagram.

vertgrid

Draw vertical grid lines.

voidsep=string

Change the string that means no such value, by default "VOID".

width=number

Set the width of the diagram.

xgridspace=number

Set the space between two vertical grid lines. The unit is the same as for the data.

ygridspace

Set the space between two horizontal grid lines. The unit is the same as for the data.

Regular <img> arguments will be passed on to the generated <img> tag.

<data>

form=column row

How to interpret the tabular data, by default row.

lineseparator=string

Set the separator between rows, by default newline. lineseparator.

noparse

Do not parse the contents by the RXML parser, before data extraction begins.

separator=string

Set the separator between elements, by default tab.

xnames

Treat the first row or column as names for the data to come. The name will be written along the pie slice or under the bar.

xnamesvert

Write the names vertically.

<colors>

separator=string

Set the separator between colors, by default tab.

<legend>

separator=string

Set the separator between legends, by default tab.

<xaxis>, <yaxis>

start=float

Limit the start of the diagram at this value. If set to min the axis starts at the lowest value in the data.

stop=float

Limit the end of the diagram at this value.

quantity=string

Set the name of the quantity of this axis.

unit=string

Set the name of the unit of this axis.

<xnames>

separator=string

Set the separator between names, by default tab.

orient=vert horiz

How to write names, vertically or horizontally.