Page Comparison

{scrollbar}
----

h3
h2. Bubble Chart

{anchor:bubblechart}

A bubble chart draws bubbles for each point in a series. The chart expects three values per bubble: the domain (commonly the X-axis) value, the  range (commonly the y-axis) value, and a third value (the Z value) that determines the size of the bubble to draw around the point.

The size of the bubble is derived from an algorithm that takes the Z value, divides it by the maximum Z value in the dataset, then multiplies that number by the *max-bubble-size* property value. See the section on required properties below for more information on the *max-bubble-size* property.

 

h5h3. Dataset Guidelines

This chart expects its data as an [XYZ dataset|The XYZ Dataset].

h5h3. Required Properties

The following properties are required:

*chart-type*

{code:XML}
<chart-type>BubbleChart</chart-type>
{code}


*dataset-type*

{code:XML}
<dataset-type>XYZSeriesCollection</dataset-type>
{code} 

*max-bubble-size*

The max-bubble-size property is defaulted to zero, so in order to see your bubbles, you'll need to set this property\! The value should be between 1 and 100, as a percentage of smaller to larger. 

{code:XML}
<max-bubble-size>90</max-bubble-size>
{code} 

The optional chart properties that are supported for this chart are listed in the [Chart Properties Reference].

h5h3. Example

The following chart definition will produce the chart in the example below.

{code:XML}
<chart>
	<chart-type>BubbleChart</chart-type>
	<dataset-type>XYZSeriesCollection</dataset-type> 
	<title>Bubble Sample Chart</title>
	<border-visible>true</border-visible>
	<include-legend>true</include-legend>
	<orientation>vertical</orientation>
	<range-title-font>
		<font-family>Arial</font-family>
		<size>10</size>
		<is-bold>false</is-bold>
		<is-italic>false</is-italic>
	</range-title-font>
	<range-title>Share of Total Budget</range-title>
	<domain-title>Share of Total Actual</domain-title>
	<domain-title-font>
		<font-family>Arial</font-family>
		<size>10</size>
		<is-bold>false</is-bold>
		<is-italic>false</is-italic>
	</domain-title-font>
	<domain-minimum>5000000</domain-minimum>
	<domain-maximum>20000000</domain-maximum>
	<domain-tick-font>
		<font-family>Arial</font-family>
		<size>5</size>
		<is-bold>false</is-bold>
		<is-italic>false</is-italic>
	</domain-tick-font>
	<domain-tick-format>#000 test</domain-tick-format>
	<range-tick-format>#000</range-tick-format>
	<range-minimum>5000000</range-minimum>
	<range-tick-font>
		<font-family>Arial</font-family>
		<size>5</size>
		<is-bold>false</is-bold>
		<is-italic>false</is-italic>
	</range-tick-font>
	<max-bubble-size>50</max-bubble-size>
	<bubble-lable-content>
		<![CDATA[{0} Act.: {1}, Budg.: {2} = Var.{3}]]>
	</bubble-lable-content>
	<bubble-lable-z-format>#,###.00 EUR</bubble-lable-z-format>
	<color-palette>	
		<color>#EE7733</color>
		<color>#9EAA36</color>
		<color>#BF0000</color>
		<color>#FCCF12</color>
		<color>#772200</color>
		<color>#DDCC88</color>
		<color>#123D82</color>
		<color>#4A0866</color>
		<color>#445500</color>
		<color>#FFAA00</color>
		<color>#1E8AD3</color>
		<color>#AA6611</color>
		<color>#772200</color>
	</color-palette>
</chart>
{code}

!sample_bubble_chart.png!