KupoChart 0.1.5 Documentation: 2D Pie Charts

• Required Parameters
  • cht: Chart type
  • chd: Chart data


• Optional Parameters
  • chs: Chart size (width and height)
  • chco: Chart colours / colors
  • outputtype: Output type (PNG or SVG)


• Examples

Required Parameters

To graph a 2D pie chart, you must pass the following required parameters:

• cht:
  Chart type. Must be set to 'p'.
  [Back to top of page]



• chd:
  Chart data. This is a string of comma-delimited values, preceded by 't:' indicating 'text' data type. Support for other data types will be added later.
  
  Example: t:12,37,15,9,20,7
  
  Note that unlike Google Chart, values do not need to add up to 100 in this mode. If values of 100 and 900 are provided, the 100 slice will be 10% of the pie and the 900 slice will be 90%. Google Chart would crop each value to 100 and display a pie with two 50% slices.
  [Back to top of page]

Optional Parameters

When graphing a pie chart, one may pass the following optional parameters:

• chs:
  Chart size, in pixels. In the form WIDTHxHEIGHT. Maximum size is 2400x1200 by default. Default size is 120x120 by default.
  Example: chs=200x200
  
  [Back to top of page]
  
  
  
• chco:
  Chart colours. This is a string of comma-delimited colours. These may be HTML-style hex colours (e.g. 'FFFF00'), named colour entities (e.g. 'yellow'), or a mix of both. When using hex colours, do not include the hash or pound sign (i.e. use '00FFAA' instead of '#00FFAA').
  Example: chco=220099,7733DD,violet,purple,indigo
  
  If no colours are provided, the following default colours will be assigned, in this order (read from left to right, top down):
  
  
  [Back to top of page]
• outputtype:
  Output type. Acceptable values are:
  
  • png: Output a PNG image. This is the default.
  • svg: Output a SVG (Scalable Vector Graphics) file. Note that SVG support presently lags somewhat behind PNG support.

  Example output: PNG vs. SVG
  PNG, 125x125 pixels	SVG, nominally 125x125 (scalable)

Examples

The following are several real examples of pie chart output using KupoChart.

• Small pie chart, five slices, user-specified colours, PNG output:
  kupochart.php?cht=p&chd=t:1,2,3,4,5&chco=220099,7733DD,violet,purple,indigo&chs=125x125
  
  



• Medium-sized pie chart, eight slices, default colours, SVG output:
  kupochart.php?cht=p&chd=t:1.3,2.8,9.2,7.3,5,4.1,5.7,6.9&outputmode=svg&chs=400x400