# Angular Bubble Charts

Bubble charts are useful for visualizing different scientific relationships such as economic or social relations because the X-axis of the Bubble Charts is numerical and does not require items.

Bubble Charts are also suitable for displaying dozens to hundreds of values, which is convenient for visualizing size values that differ by several orders of magnitude. Because the size value is represented by a circle area, it is recommended to plot positive values.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/series-types/bubble/overview/source.txt)

## Binding to Data

You can bind the Bubble chart series to an array through the [`data`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#data) property in two formats:

* Binding to arrays—Use arrays of `[X, Y, size]` where the first element is the X coordinate, the second element is the Y coordinate, and the third element is the bubble size.

  ```ts
  public data: [number, number, number][] = [[10, 20, 5], [15, 30, 10], [25, 15, 8]];
  ```

* Binding to objects—Use an array of objects with custom properties.

  ```ts
  public data: Array<{ x: number; y: number; size: number }> = [
      { x: 10, y: 20, size: 5 },
      { x: 15, y: 30, size: 10 },
      { x: 25, y: 15, size: 8 }
  ];
  ```

  When binding to objects, specify which properties contain the data through the following field mappings:

  | Property                                                                                                              | Data type | Required | Description                                                                                                           |
  | --------------------------------------------------------------------------------------------------------------------- | --------- | -------- | --------------------------------------------------------------------------------------------------------------------- |
  | [`xField`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#xfield)         | `string`  | Yes\*    | The property name that contains the X coordinate with `number` or `date` values (\*required when binding to objects). |
  | [`yField`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#yfield)         | `string`  | Yes\*    | The property name that contains the Y coordinate with `number` values (\*required when binding to objects).           |
  | [`sizeField`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#sizefield)   | `string`  | Yes\*    | The property name that contains the bubble size with `number` values (\*required when binding to objects).            |
  | [`xAxis`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#xaxis)           | `string`  | No       | The name of the X axis to use.                                                                                        |
  | [`yAxis`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#yaxis)           | `string`  | No       | The name of the Y axis to use.                                                                                        |
  | [`colorField`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#colorfield) | `string`  | No       | The property name that contains the color with `string` values.                                                       |

The following example demonstrates how to bind the Bubble chart series to data using object models.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/series-types/bubble/data-binding/source.txt)

## Customizing the Appearance

The Bubble chart provides configuration options for customizing the visual appearance of the bubbles:

* [`color`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#color) and [`border`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#border)—Control the bubble fill color and border styling (color, width, dashType).
* [`opacity`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#opacity)—Set the transparency of the bubbles. Accepts values between 0 (fully transparent) and 1 (fully opaque). Default is 1.
* [`maxSize`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#maxsize)—Define the maximum bubble size in pixels. Default is 100.
* [`minSize`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#minsize)—Define the minimum bubble size in pixels. Default is 5.
* [`negativeValues`](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api/seriesitemcomponent#negativevalues)—Configure how negative bubble values are displayed (visible and color properties).

The following example demonstrates how to customize the appearance of Bubble charts.

[Demo Source](https://demos.telerik.com/kendo-angular-ui/demos/charts/series-types/bubble/customization/source.txt)

## Support and Learning Resources

* [Scatter Homepage](https://www.telerik.com/kendo-angular-ui/charts#scatter-chart)
* [Getting Started with the Kendo UI for Angular Chart](https://www.telerik.com/kendo-angular-ui-develop/components/charts/installation/getting-started)
* [API Reference of the Charts](https://www.telerik.com/kendo-angular-ui-develop/components/charts/api)
* [Polar Charts](https://www.telerik.com/kendo-angular-ui-develop/components/charts/series-types/polar)
* [Scatter Charts](https://www.telerik.com/kendo-angular-ui-develop/components/charts/series-types/scatter)
* [Getting Started with Kendo UI for Angular (Online Guide)](https://www.telerik.com/kendo-angular-ui-develop/components/getting-started)
* [Getting Started with Kendo UI for Angular (Video Tutorial)](https://www.telerik.com/campaigns/kendo-ui/using-kendo-ui-with-angular-video-tutorial)
* [Video Courses](https://www.telerik.com/kendo-angular-ui-develop/components/getting-started/video-onboarding)
* [Chart Forum](https://www.telerik.com/forums/kendo-angular-ui?tagId=256)
* [Before You Start: All Things Angular (Telerik Blog Post)](https://www.telerik.com/blogs/all-things-angular)
* [Knowledge Base](https://www.telerik.com/kendo-angular-ui-develop/components/knowledge-base)

## Additional Resources

* [Angular Blogs](https://www.telerik.com/blogs/tag/kendo-ui-for-angular)
* [Angular Videos](https://www.telerik.com/videos/kendo-angular-ui)
* [Kendo UI for Angular Roadmap](https://www.telerik.com/support/whats-new/kendo-angular-ui/roadmap)
