# Bubble

To learn more about bubble charts and how to create one, please view this [video](https://youtu.be/a3Ca1T41ak8?si=c-B9E4ljnd9GfBcP).

A Bubble chart is a variation of the Scatter Plot. Aggregated data is grouped by dimension into circles displayed on an x/y axis. Additional measures change the size or color of the circles. A Bubble chart can represent up to four measures for your chosen dimensions (x, y, size, and color).

| Features                                                              | Quantity | Notes                                                                                      |
| --------------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------ |
| Required [Dimensions](/immerse/measures-and-dimensions.md#dimensions) | 1+       | Minimum 1, no limit, null dimensions optional.                                             |
| Required [Measures](/immerse/measures-and-dimensions.md#measures)     | 2-4      | Measure 1 = X-Axis, Measure 2 = Y-Axis, Measure 3 = Bubble Size, Measure 4 = Bubble Color. |

Use a Bubble chart to show a correlation between the x measure and the y measure. When you do not expect a correlation, you can use a Bubble chart to understand the distribution and influence of multiple factors.

### # Of Groups

Display up to 100 groups of records. You can enter a value or use the slider to visually set the number of groups.

### Null Dimensions

Choose whether to show or hide Null values for your chosen dimension.

### Color Palette

You can use a custom palette to visually group values in your chart. By default, data points are colored arbitrarily with a spectrum of solid colors. You can choose to arbitrarily color bubbles with 2, 3, or 4 colors. You can also apply colors to individual Dimension values.

If you set the **Color** measure, you can choose a gradient to visually express relative quantitative values.

### Custom Measure Formatting

You can use custom measure formats for the values in your chart. See [Customizing Measure and Date Formats](/immerse/measures-and-dimensions.md#customize-formats).

## Bubble Chart Examples

Create a new Bubble chart. Choose a **Data Source**. This example graphs employment statistics for all 50 United States for the years 1980-2015. The data is available at the [University of Kentucky website](http://www.ukcpr.org/data).

*State\_name* is a handy dimension for this data. Use the average *Unemployment\_rate* as the **X Axis**, and the average **Unemployment** total for the **Y Axis**. Increase the **# of Groups** to 50 to create an individual bubble for each state.

![](/files/iLhrqUUEUe88Qut4iK2I)

California has a significantly higher number of unemployed residents compared with the other states. Bubble charts are a good way to show outliers in a dataset. But that figure might be misleading. One reason for a higher average number of unemployed persons might be the fact that California is the most populous state in the country. Use *Population* as the **Size** measure to create proportionally sized bubbles, based on total population.

![](/files/V0wpzRbmwQx4I64vps7c)

You can add *Employment* as the **Color** measure, which casts California in a more favorable light.

![](/files/qzwygn3KKrk2beAgwP8R)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.heavy.ai/immerse/immerse-chart-types/bubble-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.