This topic provides information on how to use the GeographicProportionalSymbolSeries element in the UltraGeographicMap™ control.
The following topics are prerequisites to understanding this topic:
This topic contains the following sections:
The GeographicProportionalSymbolSeries is a Scatter Series with data-driven symbol sizes. It implements GeographicProportionalSeries and has all the basic characteristics of the UltraDataChart control’s BubbleSeries.
The following screenshot is a preview of the GeographicProportionalSymbolSeries series in the UltraGeographicMap control displaying the locations of the most populated cites in the world. The RadiusScale of the symbols uses proportional radius scale in order to indicate the significance of these cities based on their population.
Similar to other types of geographic series in the UltraGeographicMap control, the GeographicProportionalSymbolSeries possess an DataSource property for data binding. This property can be bound to an object that implements an IEnumerable interface.
Additionally, each item in the items source must have two numeric data columns for storing geographic location (longitude and latitude) and one numeric column for storing the symbol size. These data columns map to the LongitudeMemberPath, LatitudeMemberPath and RadiusMemberPath properties respectively.
The following table summarizes properties of the GeographicProportionalSymbolSeries used for data binding.
In Visual Basic:
Imports Infragistics.Win.Datavisualization
Imports System.ComponentModel
' create and set data binding to the GeographicProportionalSymbolSeries
Dim geoSeries = New GeographicProportionalSymbolSeries()
geoSeries.DataSource = sampleData
geoSeries.LongitudeMemberPath = "LongColumnName"
geoSeries.LatitudeMemberPath = "LatColumnName"
geoSeries.RadiusMemberPath = "RadiusColumnName"
' add the GeographicProportionalSymbolSeries to the the UltraGeographicMap
Me.GeoMap.Series.Add(geoSeries)In C#:
using Infragistics.Win.Datavisualization;
using System.ComponentModel;
// create and set data binding to the GeographicProportionalSymbolSeries
var geoSeries = new GeographicProportionalSymbolSeries();
geoSeries.DataSource = sampleData;
geoSeries.LongitudeMemberPath = "LongColumnName";
geoSeries.LatitudeMemberPath = "LatColumnName";
geoSeries.RadiusMemberPath = "RadiusColumnName";
// add the GeographicProportionalSymbolSeries to the the UltraGeographicMap
this.GeoMap.Series.Add(geoSeries);The SizeScale determines the size of the symbols in the series. If the SizeScale value is not set, each of the symbol’s sizes is equal to the value of the RadiusMemberPath column. When setting the SizeScale the smallest symbol equals MinimumValue and the largest symbol equals MaximumValue, with all of the remaining symbols scaled proportionately within this range. The SizeScale can be either linear or logarithmic.
The following screenshot demonstrates how the UltraGeographicMap control’s GeographicProportionalSymbolSeries series renders as a result of the following SizeScale settings:
A fill scale defines the color pattern within a single GeographicProportionalSymbolSeries. The GeographicProportionalSymbolSeries series’ FillScale property sets the symbols color with each color axis possessing its own collection of Brushes.
The GeographicProportionalSymbolSeries supports two fill scales:
CustomPaletteBrushScale – Uses the symbol marker’s index to select a brush from the Brushes collection
ValueBrushScale – Uses a set of values, which can be logarithmic, from one of the numeric columns in the DataSource to interpolate a brush. The GeographicProportionalSymbolSeries series determines which values to use in two ways:
FillMemberPath - the property explicitly specifies which column to use
MinimumValue and MaximumValue – user defined values used to determine the range of values
The following screenshot demonstrates how the UltraGeographicMap control’s GeographicProportionalSymbolSeries series renders as a result of the following settings:
The following screenshot demonstrates how the UltraGeographicMap control’s GeographicProportionalSymbolSeries series renders as a result of the following settings:
The following topics provide additional information related to this topic.