Page Comparison

{scrollbar}
----

h3. 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.   

h5. Dataset Guidelines

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

h5. Required Properties

The following properties are required:

*chart-type*

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

*dataset-type*

{code:XML}
<dataset-type>XYSeriesCollection<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].

h5. Example

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

{code:XML}
<chart>
	
	<chart-type>LineChart<type>BubbleChart</chart-type>
	<dataset-type>XYSeriesCollection<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 	<title>XY Series Sample Chart</title>
	<line-style>solid</line-style>
	<line-width>1</line-width>
	<markers-visible>true</markers-visible>
	<chart-background type="color">#FFFFFF</chart-background>
	<plot-background type="color">#FFFFFF</plot-background>
	<height>550</height>
	<width>650</width>
	<color-palette>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>
	
    <include-legend>true</include-legend>
</chart>
{code}

!sample_xychartbubble_by_columnchart.png!