Spreadsheet Graphics and Charts
Table of contents
Graphics can be created using the Graph button in the spreadsheet view or from the sheet listing, which takes the user to tiki-graph_sheet.php?sheetId=1 (1 or the numeric id of that sheet). Two simple forms are presented to select the parameters of the graphic.
Select the Graphic Type and Output Format
Fig. 1: First form
The radio buttons select the type of graphic to be generated. A first example will be made with the Pie Chart and a second one with Multibar. Multiline and Bar Stack use the same parameters as Bar Stack.
Multiple output formats are available. Depending on the installed extensions on the server, some elements might not be available. PDF and PostScript are printable format and require the paper size and orientation parameters. PNG and JPEG are images and require height and width parameters in pizels.
If the objective is to include the graphic in a wiki page, the selected format will only be used for the preview.
ParametersFigure 2 presents the parameters entered to obtain a pie chart from the speadsheet and Figure 3 is the result obtained. The page is divided in three sections:
- Parameter form
- Wiki Plug-in
The parameter form is used to select the elements that will be displayed in the graphic. All parameters under the series label are value ranges from the spreadsheet in A1:Z99 format or comma seperated list of elements (ex: Blue, ))LightBlue,LightGreen((). The color and style series require special values:
The spreadsheet is available as a reference to select the ranges.
The wiki plug-in is updated as the parameters are changed in the form. The code displayed can be pasted in a wiki page to display the graphic. The plug-in does not consider the selected output format. Instead, it will automatically select the best format available. If possible, it will display an image and link to a printable format. Prefered image format is PNG and prefered printable format is PDF.
Pie Chart ParametersThe following table presents the different field of the form, what they are used for and the behavior if left empty.
|Title||Used as the title of the graphic||No title|
|Label||Caption in the legends||No legend|
|Value||Values used in the chart||Required|
|Color||Colors used for the elements||Automatically selected|
|Style||Change border type||Normal-FillStroke|
The amount of elements in every range must be the same.
Fig. 2: Parameters for the pie chart.
Fig. 3: Resulting pie chart.
Multibar ParametersFigure 4 presents the parameters used to create the graphic in Figure 5. Note that different size parameters have been used to suite the large amount of data. Here is the table presenting the different parameters.
|Title||Title of the graphic||No title|
|Independant Scale||Determines if the graphic is vertical or horizontal|
|Horizontal Scale||Location of the horizontal scale|
|Vertical Scale||Location of the vertical scale|
|Label||Caption of the different elements in the legend||No legend|
|Color||Colors used in the legend||Automatically selected|
|Style||Border type used||Normal-FillStroke|
|X||Independant scale range||Required.|
|Y0||First dependant range||Required.|
|Y1-Y4||Additional dependant range|
The amount of elements in the Label, Color and Style ranges must be equal to the amount of Y ranges used. The amount of elements in the X range and all Y ranges must be the same.
Fig. 4: Parameters for the multibar graphic
Fig. 5: Resulting multibar graphic