# Bubble Chart

A **Bubble Chart** visualizes datasets across **three or four dimensions** simultaneously. The first two dimensions are plotted along the **X-axis** and **Y-axis**, while the remaining dimensions are represented by the **bubble size** and optionally the **bubble color**.

Bubble charts are particularly effective for showing **relationships and distribution across multiple variables**, making them popular in financial and economic analysis, as well as customer and market segmentation studies.

### Best Situations to Use

Use a bubble chart when:

* You have **three or more data series** to represent simultaneously.
* The **size of the data points (bubbles)** conveys meaningful information (e.g., market share, profit, customer count).
* You need to visualize **correlations** or **outliers** across multiple variables.
* Comparing data distributions where **magnitude differences** matter.

**Examples:**

* Plotting **financial performance** where X = revenue, Y = profit, bubble size = market share.
* Customer segmentation where bubble size = total spend and bubble color = loyalty tier.
* Comparing product portfolios across categories and contribution levels.

### Variations

Bubble charts can be styled and customized into different visual formats:

* **Plain Base Bubble Chart** – Standard representation with circular bubbles.
* **Gradient Base Bubble Chart** – Bubbles filled with gradient effects for improved aesthetics.
* **Ring Base Bubble Chart** – Hollow circular bubbles for a cleaner look and differentiation.

### Properties

#### General

* **Component Name** – Unique identifier for the chart (auto-generated).
* **Position (Left, Top)** – Placement on the canvas.
* **Height / Width** – Set chart dimensions.
* **Initial Visibility** – Show or hide chart on load.
* **Max Button** – Enable maximize mode.
* **Color From Drill** – Apply colors dynamically from drill-down operations.
* **Shadow** – Add depth with configurable shadow effects.
* **Base Type** – Define chart type (plain, gradient, ring).
* **Luminance** – Adjust bubble luminance for contrast.

#### Background

* **Gradient Rotation, Opacity, Gradient Colors** – Control background styling.
* **Border** – Customize border color, radius, and width.
* **Shadow** – Adjust shadow color and transparency.

#### Range Indicators

* Add multiple **ranges** with custom colors to highlight thresholds.
* Enable **Dynamic Range Colors** for auto-adjusting bubble colors.
* Option to display **Range Color Legends** in preview mode.

#### Tooltip

* Show/hide tooltips for additional insights.
* Customize background color, border, opacity, font size, precision, and box width.
* Enable **highlighter mode** to emphasize specific data points.

#### Title & Subtitle

* Show or hide **title box** and **subtitle**.
* Customize font, size, color, alignment, and decorations.
* Optionally use dataset descriptions as titles.

#### Axes

* **X-Axis / Y-Axis** settings: toggle lines, customize fonts, labels, and colors.
* Enable **category tick marks** and markers.
* Add axis descriptions and adjust label rotations for readability.

#### Legend

* Show or hide chart legend.
* Customize font, style, and decoration.
* Option to hide on initial load.

#### Formatter

* Set units (e.g., %, $, count).
* Configure precision, currency format, and number style.
* Adjust placement of values before/after numbers.

#### Axis Setup

* **Auto Axis Setup** – Dynamic scaling based on dataset.
* **Base Zero** – Ensure axis starts at zero.
* Set **Min/Max values**.
* Add **vertical/horizontal marker lines** or a **zero baseline marker**.

#### Alerts

* Configure **color bands** for thresholds.
* Customize band name, range, color, and opacity.
* Enable or disable dynamic banding.

#### Export Options

* Enable right-click **context menu** for export.
* Supported formats: **Excel, CSV, JPEG, PNG, PPT, PDF, Print**.
* Customize export heading, subheading, and file name.

#### Dataset Series Properties

* Change bubble colors per series.
* Enable **Data Labels** to display actual values on bubbles.

### Example Use Cases

* **Finance:** Compare revenue vs. profit, with bubble size = market capitalization.
* **Marketing:** Customer segmentation where bubble size = total purchase value and bubble color = campaign response rate.
* **Operations:** Visualize supplier performance with cost vs. delivery time, bubble size = volume purchased.
* **Education Analytics:** Plot student scores (X = math, Y = science) with bubble size = attendance and bubble color = grade.

**Sample Data Setup:**

* **Category Field:** Year (or other categorical variable).
* **Series Fields:** At least three numeric fields (X, Y, Size, optional Color).

{% file src="/files/dnj9MB7RKJBpCi1YVNLd" %}

⚠️ **Note:** Category fields can be string, numeric, or date types, but **series fields must be numeric**.


---

# 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.bdb.ai/bdb-user-documentation/platform-modules/10.0/bdb-visualization/dashboard-designer/chart-gallery/charts/bubble-chart.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.