Adding the Bubble Layer

You can add a bubble layer to a geo map.

Prerequisites

To add data from a model to a bubble layer, the model must contain at least one location dimension. For more information see Creating a Model with Coordinate or Area Data for Geospatial Analysis. For both private and public generic as well as organization dimensions, you can enrich a dimension using coordinate data within the modeller, see Creating a Geo-Enriched Dimension Property Structure for a Model With Coordinate Data.

Procedure

To pick the model that the layer will be based on, under Data Source, select (edit).
Select Bubble Layer from the Layer Type list.
From the Location Dimension list, select the dimension that you want to visualize.
1. To change the marker icon, select the arrow to the right of Style and choose a new icon.
  
  Note
  You can also use a custom marker; choose Add Custom, select Enter SVG Path to directly enter the icon's SVG Path, or select Upload SVG File to load the file containing the icon. If you are using a custom SVG, only the <path> attribute is read. All other attributes such as <transform> will be ignored - if your icon relies on these attributes it may not display as expected.
2. You have the option to apply more changes to the location dimension marker:
  - Select a new color from the Palette list.
  - If necessary, you can adjust the Opacity or the Size of the marker icon.
  Note
  The settings for Palette, Opacity, and Size only correspond to the localization dimension. Once the marker size or color is associated with a measure, the location dimension settings are ignored.
Use the Add Measure/Dimension list under Bubble Color to associate a bubble color with a measure or a dimension.

Note
If you are using a New Model with Measures as your data source, select + Add Dimension/Account to specify an Account and Measure pairing for the Bubble Color. To define more Bubble Color settings, expand the associated Account heading.

You can choose the number of Ranges for the palette. This sets the number of KPI values and allows you to specify values to set the KPI ranges for each color in the palette. If necessary, adjust the Opacity of the bubbles to ensure that the basemap or other layers are visible.
Note
Use the switch beside the Ranges list to show KPI values as percentages or as absolute values. To reverse the palette order, use the (Switch) icon.
If you choose to associate Bubble Color with a dimension, the dimension's top five members are displayed within pie charts in the resulting bubbles. If no measure is specified for Bubble Size, the pie sections will be evenly proportional. If a measure is specified, the proportion will be aggregated according to the measure values. To highlight a bubble, select it once. To highlight a section of the pie within the bubble, select the bubble and then select the section. If you associate Bubble Color with a hierarchical dimension, you can drill up or down the hierarchy after selecting a bubble or section.
Note
You can only sync colors by dimension using a geo map and a chart.

Note
You can associate Bubble Color with only one dimension or measure. When working with New Models with Measures, you can associate Bubble Color with only one account and measure pairing.
Use the Add Measure list under Bubble Size to associate the bubble size with a measure.

Note
If you are using a New Model with Measures as your data source, select + Add Account and + Add Measureto specify an account and measure pairing for the Bubble Size. To define more Bubble Size settings, expand the associated Account heading.

Use the Size slider to adjust the size of bubbles. Toggle the Adjust Range Scale switch between a scale range based on percentages and a range based on numeric values. You can customize the range by modifying the min and max values or using the provided range slider.

Data points representing values outside the bounds of the specified range will display as bubbles with dotted boundaries and no fill color.
To control the display of data point labels in geo maps, select the geo map and go to More Actions Show/Hide Labels) to display or remove labels for a particular layer.

By default, labels will display in a Bubble layer, and labels will not overlap. However, to remove the automatic control on label overlap, choose Designer and select (Styling). Turn Off the Avoid Data Label Overlap under Labels.

To visualize multiple data points associated with the same location, hover over the location to display all the values. The bubble size and color used for overlapping points is based on the average value of all the points at that location.
1. To display values for measures, you can go to More Actions Show/Hide Labels, select the corresponding layer, and under Measures select the measure(s) for which you want to display values.
Use the switch beside Location Clustering to disable or enable clustering.
Use the Maximum Display Points settings to specify when to start clustering data points. You can manage how the cluster is displayed in the geo map using the Cluster Opacity and Cluster Color settings.
Note
- Clustering is strictly enforced when a map contains more than 20,000 data points.
- In the optimized design experience mode, clustering is automatically disabled when the displayed points are below the value set for Maximum Display Points.
- The clustering of points on a map into groups is based on the the k-means algorithm.
Tip
To optimize your geo map performance:
- Disable clustering when working with a small number of data points. This will reduce valuable processing time and resources. When interacting with a geo map, the data points have to regularly reloaded when clustering is enabled.
- You can use the following to reduce the number points displayed in your geo map:
  - Filters
  - Consider using a choropleth layer. This layer aggregates data points into geographic regions.
- Enable clustering when working with more than 5000 or more data points.
To manage thresholds in the geo map, in (Builder) select the icon to the right of the measure.
Go to Show Threshold None to remove all thresholds. Go to Show Threshold Model or Show Threshold Story to specify which type of threshold you want to display. Select Edit Ranges or View all Thresholds to modify the thresholds. If you choose not to display thresholds in geo map, the Bubble Color palette specified for the layer will override the one specified in the threshold. Any palette changes will be reflected in the map legend.
To customize the data that displays for a given data point in the bubble layer, select the icon to right of Layout. You can also use the (More Actions) icon to the right of the geo map to access Add Tooltip or Add Tooltip Chart for a specific bubble layer.
- Select Tooltip Information to specify information displayed as you hover over a given data point in the geo map. Use the provided Tooltip Information field to choose from a selection of measures, dimensions, and dimension attributes, or to create a calculated measure or measure input controls.
  Note
  If you are using a New Model with Measures as your data source, you can choose from a selection of accounts, dimensions, and dimension attributes. Account information will only display in tooltips if a single measure is specified for Bubble Color and Bubble Size.
- Select Tooltip Chart to populate a corresponding table of information for a point in the geo map. Make your selections from the provided list of Measures and Dimensions, and click OK.
Select OK to save all the layer settings.