Formatting an Image Layout Visualization

Once you have created an Image Layout visualization, you can specify formatting options to change the image displayed in the visualization, determine whether to display areas or bubble markers on top of the image, and so on. Steps to format an Image Layout visualization are below.

Prerequisites

You must have Edit Dashboard and Run Dashboard privileges.
The procedure below assumes that you have already created the visualization that you want to format.

To format an Image Layout visualization:

Click the name of the quick dashboard to run it, then click the visualization you want to format.
If the Properties panel is not displayed, from the toolbar, click the Edit Visualization icon. Hover the cursor over the panel, then click the arrow icon in the top right and select the Show Properties option.
You can determine whether the visualization displays areas or bubble markers. From the Display Mode drop-down list, select one of the following:

Note: The options available may vary depending on the type of display mode the visualization's shape file supports. All display modes are available for shape files designed to display areas. The Bubble display mode is available for shape files designed to display bubble markers.
- To allow XBRi to decide whether to show areas or bubble markers, select Automatic.
- To display areas, select Area.
- To display bubble markers, select Bubble.
You can select the shape file to use to display the visualization. A shape file is an HTML file that contains the image that you want to display in the visualization, as well as the location of each area or bubble marker you want to display on top of the image. XBRi provides several default shape files for you to choose from, including a map of countries of the world and a map of states in the United States. You can define your own shape file for use in the visualization. For steps, see Customizing an Image Layout visualization.

From the Shape File drop-down list, select the name of the shape file you want to use. If the attribute you placed in the Geo Attribute area has a geo role, shape files with the same geo role will be displayed as options in the drop-down list.
You can determine how bubble markers in the visualization are sized. From the Type drop-down list, select one of the following:
- To allow XBRi to decide how to size the bubble markers, select Automatic.
- To manually specify the maximum size of bubble markers in the visualization, select Manual. In the Value field, type the maximum size of the bubble markers as a ratio between .01 and 1. For example, type 1 to display the largest bubble markers at the maximum size at which the visualization can display bubble markers.

You can have regions or bubble markers in the visualization automatically colored based on the value of a metric, or have bubble markers automatically replaced with images. To do so, you must define a threshold on the metric in the Color By area, as described in the steps below.

To define a threshold in an Image Layout visualization:

From the Color By area in the Map panel, hover the cursor over the metric you want to create the threshold based on, then click the arrow icon. Select Thresholds. The Threshold dialog box opens.
From the Show drop-down list, select the type of formatting you want to apply to metric values that meet the threshold condition, as follows:
- To create a threshold to change the background color used to display metric values, select a set of colors to apply to the values, such as Green or Red.
- To replace metric values with an image, select Images. From the second drop-down list, select the images you want to display. The options include:
- - Arrows
  - Regular Pin
  - Rounded Pin
From the Based on drop-down list, select the metric to use to define the threshold.
From the second drop-down list, select one of the following:
- To create a threshold based on the value of the metric, select Value. For example, you can display metric values greater than 5 million in blue.
- To create a threshold based on the top and bottom x metric values, select Rank. For example, you can display the top 5 metric values in red, and display the bottom 5 metric values in green.
- To create a threshold based on the top and bottom x percent of metric values, select Percent. For example, you can display the top 10% of metric values with a green flag, the next 40% of metric values with a yellow flag, and the bottom 50% of metric values with a red flag.
From the Break By drop-down list, select the attribute level at which you want to restart counting rank or percent values for the metric. This option is only available for thresholds based on rank or percent values.
Each band displayed in the dialog box represents a different range of values. You can click and drag a thumb left or right along the slider to increase or decrease the range of values covered by the band.
Do one of the following:
- To create a new band, press CTRL and click a band to divide it into two separate bands.
- To change the color applied to the range of values covered by a band, double-click the band, then select the new color from the palette.
- To delete a band, hover the cursor over the band, then click the x icon. The band is deleted.
You can preview your changes by clicking Apply. Once you have finished defining the threshold, click OK. The threshold is created.