Delta

The Choropleth Map allows you to indicate the difference between the actual and target values of a particular parameter. This difference is called delta.

ChoroplethMap_DeltaSales

Delta Options

To specify delta indication settings, click the Options button next to the data item container.

ChoroplethMap_Delta_OptionsButton

This invokes the Choropleth Map Options dialog. When the map type is set to Delta, this dialog contains two tabs - Common and Format - with the following settings.

ChoroplethMap_DeltaOptionsDialog

  • Value type

    You can specify which values to display within map tooltips. Use the Value type combo box to select the value that will be displayed as the delta value.

    Actual value Absolute variation Percent variation Percent of target
    Map_DeltaValueType_ActualValue Map_DeltaValueType_AbsoluteVariation Map_DeltaValueType_PercentVariation Map_DeltaValueType_PercentOfTarget

    To specify the value type in code, use the DeltaOptions.ValueType property exposed by the DeltaOptions object, which can be accessed via the map's DeltaMap.DeltaOptions property.

  • Result Indication

    You can specify the condition that will be used to select the indicator color. To do this, use the Result indication combo box.

    Greater is good

    Less is good

    Warning if greater

    Warning if less

    No indication

    Map_DeltaResultIndicaion_GreaterIsGood_1

    Map_DeltaResultIndicaion_GreaterIsGood_2

    Map_DeltaResultIndicaion_LessIsGood_1

    Map_DeltaResultIndicaion_LessIsGood_2

    Map_DeltaResultIndicaion_WarningIfGreater_1

    Map_DeltaResultIndicaion_WarningIfGreater_2

    Map_DeltaResultIndicaion_WarningIfLess_1

    Map_DeltaResultIndicaion_WarningIfLess_2

    Map_DeltaResultIndicaion_WarningIfLess_1

    Map_DeltaResultIndicaion_WarningIfGreater_2

    To specify when to display a delta indicator in code, use the DeltaOptionsBase.ResultIndicationMode property exposed by the DeltaOptions object, which can be accessed via the DeltaMap.DeltaOptions property of the map.

  • Threshold type and Threshold value

    You can specify that a required indicator should only be displayed when the difference between the actual and target values exceeds a specified value. For instance, the actual value exceeds the target value by 10%, or by $2K.

    Use the Threshold type combo box to select whether you wish to specify the threshold in percentage values or in absolute values. Then use the Threshold value box to specify the threshold value.

    To do this in code, use the DeltaOptionsBase.ResultIndicationThresholdType and DeltaOptionsBase.ResultIndicationThreshold properties, respectively. These properties are exposed by the DeltaOptions object, which can be accessed via the map's DeltaMap.DeltaOptions property.

The Format tab allows you to specify the numeric display format for different value types, as described in the Formatting Data document. In code, you can use the following properties:

The tab contains the following settings.

Format type

Specifies format types for numeric values. Available types are listed in the DataItemNumericFormatType enumeration.

Unit

Specifies the unit to convert the numeric values. Available types are listed in the DataItemNumericUnit enumeration.

Precision

Specifies the number of fractional digits to display.

Currency

Specifies the currency symbol and format provided by the RegionInfo class.

Culture

Specifies the name of a culture that defines the currency symbol and format.

Include group separator

Specifies whether separators should be inserted between digit groups.