visual bi extensions for sap lumira (lmx) - user...

Visual BI Extensions for SAP Lumira (LMX)

- User Guide -

Visual BI Extensions (LMX) User Guide P a g e | 2 of 63

1 Copyright 4

1.1 Trademark Information 4

1.2 Patent Information 4

1.3 SAP Trademarks 4

2 Introduction 5

2.1 Document History 5

2.2 Who Should Read This Guide? 5

2.3 What is the Visual BI Extensions for SAP Lumira (LMX) Suite? 5

2.4 Supported Platforms 5

3 Getting Started 6

3.1 Overview of the Visual BI Extensions for SAP Lumira (LMX) Suite 6

3.1.1 LMX-Choropleth 6

3.1.2 LMX-Geographical Layers 6

4 Visual BI Extensions for SAP Lumira – LMX-Choropleth 7

4.1 Overview of LMX – Choropleth Extension 7

4.2 Common Features of the LMX – Choropleth Extension 7

4.3 Data Source Requirements for the LMX Choropleth Extensions 9

4.4 How to use the LMX Choropleth Extension for a Choropleth Map 10

4.5 How to use the LMX Choropleth Extensions for a Bubble Map 21

4.6 Additional Properties for Choropleth Map Component 28

4.6.1 Category Home 28

4.6.2 Category Data Series 28

4.6.3 Category Data Label 29

4.6.4 Category Title 29

4.6.5 Category Subtitle 30

4.6.6 Category Legend 31

4.6.7 Category Tooltip 32

4.6.8 Category Zoom 33

4.6.9 Category Style 33

5 Visual BI Extensions for SAP Lumira – LMX-Geographic Layers 34

5.1 LMX-Geographic Layers 34

5.2 Features of LMX Geographic Layers Extension 34


5.2.1 Bubble Layer 34

5.2.2 Marker Layer 35

5.2.3 Marker Cluster Layer 35

5.2.4 Heat Map Layer 36

5.3 Data Source Requirements for LMX-Geographic Layers 37

5.4 How to use the LMX-Geographic Layer – Bubble Layer 38

5.5 How to use the LMX-Geographic Layer – Marker Layer 45

5.6 How to use the LMX-Geographic Layer – Marker Cluster Layer 48

5.7 How to use the LMX-Geographic Layer – Heatmap Layer 52

5.8 How to use the LMX-Geographic Layer – Map Settings 55

5.9 Additional Properties for Geographical Layers Component 58

5.9.1 Category Bubble 58

5.9.2 Category Marker 58

5.9.3 Category Marker Cluster 59

5.9.4 Category Heatmap 60

5.9.5 Category Map Settings 60

6 Further Information 62


1 Copyright

©Visual BI Solutions, Inc. (“Visual BI”). All rights reserved. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Visual BI. Under the law, reproducing includes translating into another language or format.

As between the parties, Visual BI retains title to, and ownership of, all proprietary rights with respect to the software contained within its products. The software is protected by United States copyright laws and international treaty provision. Therefore, you must treat the software like any other copyrighted material (e.g. a book or sound recording).

Every effort has been made to ensure that the information in this manual is accurate. Visual BI Solutions is not responsible for printing or clerical errors. Information in this document is subject to change without notice.

1.1 Trademark Information

Visual BI® and the Visual BI logo design are trademarks of Visual BI. in the United States and various other countries. All other trademarks are the property of their respective owners.

1.2 Patent Information

The accompanying product is protected by one or more U.S. and foreign patents and/or pending patent applications held by Visual BI.

1.3 SAP Trademarks

SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. All other product and service names mentioned are the trademarks of their respective companies. Please see http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.

www.visualbi.com

[email protected]

Phone: +1 888-227-2794

Fax: +1 888-227-7192

Plano, TX Dallas, TX Chennai, India


2 Introduction

2.1 Document History

This document is valid for the releases shown in the table below (see Table 2.1):

Major Release Minor Release Patch Date

1 0 0 April 2016

Table 2.1: Document History

2.2 Who Should Read This Guide?

The User Guide for the Visual BI Extensions for SAP® Lumira ™ (LMX) is meant for users that are going to create SAP Lumira documents.

2.3 What is the Visual BI Extensions for SAP Lumira (LMX) Suite?

The Visual BI Extensions (LMX) suite is a custom component package released by Visual BI Solutions for SAP®Lumira ™ consisting of two extensions namely LMX-Choropleth and LMX-Geographic Layers. The LMX suite uses 400 maps out-of-the-box integrated with SAP Lumira to add Location Analytics to your SAP Lumira visualizations. The extensions offer options such as Geographic Layer options including Heat, Marker, Cluster, Choropleth, and Bubble Layer.

2.4 Supported Platforms

https://visualbi.com/wp-content/uploads/Visual-BI-Extensions-for-SAP-Lumira-Supported-Platforms.pdf



3 Getting Started

3.1 Overview of the Visual BI Extensions for SAP Lumira (LMX) Suite

The Visual BI Extensions for SAP Lumira (LMX) suite is an extensions package released by Visual BI Solutions consisting of two extensions - LMX-Choropleth and LMX-Geographic Layers. The LMX suite provides over 400 maps out-of-the-box integrated with SAP Lumira to add Location Analytics capabilities to your visualizations. In addition, the extensions offer geographic layer options such as Choropleth, Marker, Cluster, and Bubble Layer.

3.1.1 LMX-Choropleth

The Choropleth Map is one of the most frequently used maps in data visualization. It uses a coloring scheme (different colors or a graduated color scale) inside defined areas on a map in order to show value levels and indicate the average values of a measure in those areas. Some of the key features of Choropleth Map are listed below:

It can effectively be used to report area values at virtually any scale, from global to local – and the data can be thought about in many different ways at many different levels of analysis, from general overall patterns to the detection of details.

It is helpful for finding intriguing hot spots, detecting relationships between the encoded variable and geographic location (and the many variables entangled with location), or letting people know how their area compares with others.

3.1.2 LMX-Geographical Layers

This LMX-Geographic Layers extension allows you to leverage longitude and latitude based maps and visualize the information in different forms of map layers, such as Bubble Layer, Marker Layer, Marker Cluster Layer and Heat Layer. Some of the key features of Geographical Layers are listed below:

It displays the measures on any geographical level.

It represents the metrics with proportional bubbles.

It visualizes your coverage and performance with true Heat maps.


4 Visual BI Extensions for SAP Lumira – LMX-Choropleth

4.1 Overview of LMX – Choropleth Extension

The LMX-Choropleth extension allows you to visualize your information in form of choropleth maps as well as bubble maps. In the next section we will outline the general features of the component and then walk you through a step by step workflow of the component itself.

4.2 Common Features of the LMX – Choropleth Extension

After you installed the extensions and started SAP Lumira, the extensions are available as part of the panel providing you access to all the visualization options in SAP Lumira (see Figure 4.1).

Figure 4.1: Extensions

Custom Extensions are grouped together and appear as the last icon in the list of the available visualization options (see Figure 4.1).


After you selected the extension – for example the LMX Choropleth Desktop extension – you also have the option to open the Additional Properties of the map, so that you can configure the details right in the Visualize area of SAP Lumira (see Figure 4.2).

Figure 4.2: Additional Properties

After opening the Additional Properties, you are presented with several categories (see Figure 4.3) which you can use to configure the details for your map.

Figure 4.3: Additional Properties details


4.3 Data Source Requirements for the LMX Choropleth Extensions

The LMX Choropleth component is able to provide you with a large set of out-of-the-box maps based on common regional definitions, such as Continents, Countries, Regions, and districts. The component is able to leverage several common geographic definitions, such as FIPS codes, regional abbreviations, geo keys, or the full name of the geographic region. In addition, the component is able to provide you with a drill down option, for example to navigate from a World Map showing the value per country to a map from the United States showing the value per state.

Type of Data Example Value

Geo ID US.MA

Key MA

WOE-ID 2347580

State FIPS Code 25

FIPS Code US25

Name Massachusetts

Table 4.1: Example Geographic Keys

Table 4.1 shows a few examples of possible geographic keys and abbreviations supported by the component, using the state Massachusetts as an example.

Country Key Country Name Region Name Profit Costs Revenue

CA Canada British Columbia 100 50 150

CA Canada Manitoba 100 50 150

DE Germany Berlin 100 50 150

DE Germany Brandenburg 100 50 150

DK Denmark North Jutland 100 50 150

DK Denmark Central Jutland 100 50 150

GB United Kingdom England 100 50 150

GB United Kingdom Northern Ireland 100 50 150

US United States of America Arizona 100 50 150

US United States of America California 100 50 150

Table 4.2: Sample Data set for LMX-Choropleth


Table 4.2 shows a sample data set which can be used in combination with the LMX Choropleth component in SAP Lumira. The sample data set contains:

- A Dimension for the Country Key

- A Dimension for the Country Name

- A Dimension for the Region Name

- Several measures

Using such a data set would allow you to leverage either one of the dimensions with the Country information and the dimension with the Region information to configure the map details. Given that our sample data contains two dimensions, we would also be able to configure a drill down scenario allowing the user to navigate from a World Map showing the information per Country to a map showing the details for the Regions for a selected Country.

4.4 How to use the LMX Choropleth Extension for a Choropleth Map

In the following steps, we will outline how you can use the LMX Choropleth Extension in SAP Lumira and visualize your geographic information. For our example, we will assume that our data source contains the following elements:

Dimension Country Key containing a list of Country Codes

Dimension Region Name containing a list of Regions based on their full names

Measure Profit

Prerequisite:

To make sure that you can view the basemap provided by SAP Lumira, please follow the steps outlined below to ensure that your Network configuration in the Preferences is configure correct:

1. In SAP Lumira, select the menu File • Preferences • Network (see Figure 4.4).

Figure 4.4: SAP Lumira Preferences


2. In the Network properties, ensure that the Proxy configurations are configured as needed for your environment. 3. Click Done to confirm the configurations.

After we configured the preferences in SAP Lumira, we can now setup our first map. You can follow the steps outlined below:

1. In SAP Lumira select the menu File • New for creating a New Project. 2. For our example, we will assume that you have the data available in form of a Microsoft Excel file. 3. Select the option Microsoft Excel in the list of data source and click Next (see Figure 4.5).

Figure 4.5: Add new data set

4. You will be asked to select the data source. Select the data source and click Open (see Figure 4.6).

Figure 4.6: Select data source


5. After selecting the data source, you will be able to preview the selected data set in SAP Lumira. Click Create to create a new Project based on the selected data set (see Figure 4.7).

Figure 4.7: Selected data set

6. You will be presented with a new empty SAP Lumira document (see Figure 4.8).

Figure 4.8: SAP Lumira Document


7. Now select the entry LMX-Choropleth Desktop from the Chart Extensions (see Figure 4.9).

Figure 4.9: SAP Lumira Extensions

8. You are presented with an empty map from the Extension and you can now start the configuration (see Figure 4.10).

Figure 4.10: LMX Extension


9. For our example, we will click on the “+” sign next to the Measures and choose measure Profit (see Figure 4.11).

Figure 4.11: Select Measure

10. Click on the “+” sign next to the property Dimensions and select the dimensions Country Key and Region Name (see Figure 4.12).

Figure 4.12: Select Dimensions


11. Click Open Additional Properties. 12. You will be shown the Additional Properties for the map and you can now configure the detailed settings (see

Figure 4.13).


13. Navigate to the category Home of the Additional Properties (see Figure 4.14).

Figure 4.14: Category Home


14. In the category Home you can configure the following properties:

Category Property Description

General

Map Type You can choose between Choropleth and Bubble map.

Select Map Source

Here you can choose which map will be your starting map. Maps are based on different categories such as World, Continents, Countries, etc.,

Table 4.3: Category Home

15. For our example we are configuring the following values:

Map Type: Choropleth

Select Map Source: WORLD MAP 16. Navigate to the category Data Series (see Figure 4.15).

Figure 4.15: Category Data Series

17. In this category you can configure which measure will be used for the visualization and which dimensions of your data source will be mapped to each level of the map.

18. For our example we will map the items in the following steps. 19. Set the property Select Measure to the measure Profit. 20. Set the property Aggregate Function to the option SUM. 21. For the Map Level 0, set the property Select Dimension to the dimension Country Key. 22. Set the property Data Format to the value Postal Code (e.g. MA). 23. Activate the option Enable Level One for the Map Level 1 (see Figure 4.16).



24. Set the property Select Dimension to the value Region Name for Map Level 1. 25. Set the property Data Format to the value Full Name (e.g. Massachusetts). 26. Scroll Down to the area Z-Axis in the category Data Series (see Figure 4.17).

Figure 4.17: Z-Axis Properties

Using the Z-Axis Chart option, you can display additional – non geographic – information, for example the revenue broken down by another dimension such as product, month, year, week. The Z-Axis chart can be displayed on top of the map and you can select the areas in the map to filter the information displayed in the Z-Axis chart.

27. Activate the option Enable Z-Axis Chart. 28. Set the property X-Axis (Dimension) to the value Region Name. 29. Set the property Y-Axis (Measure) to the value Profit. 30. Set the property Aggregate Function to the option SUM. 31. Set the property Chart Type to the option Column Chart. 32. Navigate to the category Data Label (see Figure 4.18).


Figure 4.18: Category Data Label

33. This category allows you to specify the details for the data labels of the map. Figure 4.19 shows the World Map with activated Data Label.

Figure 4.19: Map with Data Label

34. Activate the option Enable. 35. Set the property Text Color to a Black color. 36. Set the property Font Style to the value Bold. 37. Set the property Font Size to the value 12. 38. Set the property Font Family to the value Arial. 39. Click ( ) on the right hand side of the toolbar for the Additional Properties to save your configurations and

close the Additional Properties for the map.


40. The initial view of the map should show a World Map with the measure displayed for each Country (see Figure 4.20).

Figure 4.20: World Map

41. You can then use a double-click and drill down from a country shown in the World Map to the more detailed country map showing the Regions for the selected country (see Figure 4.21).

Figure 4.21: Country Map

42. You can use the Back button (top right corner) to navigate back to the World Map. 43. Using a single-click you can activate the display of the configured Z-Axis chart (see Figure 4.22). You can select

multiple countries using the CTRL button together with a mouse click, so that you can compare several values.


Figure 4.22: Z-Axis Chart

In the last set of steps we used a sample data set and visualized the information in form of a Choropleth Map. The process of setting up a Bubble Map is explained in the next section.


4.5 How to use the LMX Choropleth Extensions for a Bubble Map

In the following steps, we will outline how you can use the LMX Choropleth component to create a bubble map using your own data with SAP Lumira. For our example, we will assume that our data source contains the following elements:

Dimension Country Key containing a list of Country Codes

Dimension Region Name containing a list of Regions based on their full names

Measure Profit

For our example, you can follow the steps below to setup a new Bubble Map using the LMX extension:

1. In SAP Lumira select the menu File • New for creating a New Project. 2. For our example, we will assume that you have the data available in form of a Microsoft Excel file. Select the

option Microsoft Excel in the list of data source and click Next (see Figure 4.23).

Figure 4.23: Add new dataset



Figure 4.24: Open File

4. After selecting the data source, you will be able to preview the selected data set in SAP Lumira. Click Create to create a new Project based on the selected data set (see Figure 4.25).

Figure 4.25: Selected Data Source

5. You are being presented with a new SAP Lumira document and you can start the configuration of your map (see Figure 4.26).


Figure 4.26: New SAP Lumira Document

6. Now select the LMX-Choropleth Extension from the Chart Extensions (see Figure 4.27).


7. You will be presented with the initial map (see Figure 4.28).


Figure 4.28: Initial Map

8. For our example, set the property Measure to the value Profit (see Figure 4.29).

Figure 4.29: Measures

9. Set the property Dimensions to the values Country Key and Region Name (see Figure 4.30).


Figure 4.30: Dimensions

10. Click Open Additional Properties. 11. You can now use the Additional Properties to configure the details of the map (see Figure 4.31).


12. Navigate to the category Home (see Figure 4.32).


Figure 4.32: Category Home

13. In the category Home you can configure the following properties:


General

Map Type You can choose between Choropleth and Bubble.

Select Map Source

Here you can choose which map will be your starting map. Maps are based under different categories such as World, Continents, Custom, USA, etc.,


14. For our example we are configuring the following values:

Map Type Bubble

Select Map Source WORLD MAP 15. Navigate to the category Data Series (see Figure 4.33).


16. In this category you can configure which measure will be used and how the geographic dimensions will be mapped to each level of the map.

17. Set the property Select Measure to the value Profit. 18. Set the property Aggregate Function to the option SUM. 19. Set the property Select Dimension to the value Country Key for the Map Level 0. 20. Set the property Data Format to the value Postal Code (e.g. MA).


Map level 1

For the Bubble Map component, Map level 1 is not applicable.

21. Now navigate to the category Style (see Figure 4.34).

Figure 4.34: Bubble Map Style

22. Set the property Bubble Map Color to yellow. 23. Set the property Bubble Size to the value 30. 24. Click ( ) on the right side of the toolbar in the Additional Properties to save your configurations. 25. You should now have a World Map representing the information in form of a bubble for each country (see Figure

4.35).

Figure 4.35: Bubble Map

We used a sample data set and visualized the information in form of a Bubble Map. In the next section we will explain all the available Additional Properties of the mapping component.


4.6 Additional Properties for Choropleth Map Component

As a custom extension the Choropleth Map also comes with a set of Additional Properties. The Choropleth Map provides Additional Properties in the categories: Home, Data Series, Data Label, Title, Subtitle, Legend, Tooltip, Zoom and Style. In the following sections you will find a more detailed description of each of those properties.

4.6.1 Category Home

Below you can see the Additional Properties for the category Home and their descriptions.


General Map Type You can choose between Choropleth and Bubble.

Select Map Source Here you can choose which map will be your starting map. Maps are divided into different categories such as World, Continents, and Countries.


4.6.2 Category Data Series

Below you can see the Additional Properties for the category Data Series and their descriptions.


General Select Measure Here you can choose the measure for the map.

Aggregate Function You can choose between SUM and AVG based on the selected Measure.

Map Level 0 Select Dimension Here you can configure the dimension for the top level of the map.

Data Format You can view the respective Data Format for the selected Dimension. The types of Data Format are Postal Code, FIPS, State FIPS Code, Geo Key, etc.,

Map Level 1 Enable Level One This property allows you to active Map Level 1.

Select Dimension Here you can configure the dimension for Map Level 1.

Data Format You can view the respective Data Format for the selected Dimension. The types of Data Format are Postal Code, FIPS, State FIPS Code, Geo Key, etc.,

Z – Axis Enable Z – Axis Chart This property allows you to active the Z-Axis Chart.

X-Axis (Dimension) Here you can configure the dimension for the X-Axis.

Y-Axis (Measure) Here you can choose the measure for the Z-Axis Chart.

Aggregate Function You can choose Aggregate Function based on the selected Measure. The available options are SUM and AVG.

Chart Type Here you can choose the chart type for the Z-Axis Chart. The available options are Line Chart, Area Chart, Column Chart and Bar Chart.



Chart Title Here you can set the Title Text for the Chart.

Enable Subtitle on Chart This property allows you to active the Subtitle for the Chart.

Chart Subtitle Here you can set the Chart Subtitle for the Z-Axis chart.

Table 4.6: Category Data Series

4.6.3 Category Data Label

Below you can see the Additional Properties for the category Data Label and their descriptions.


Data Label Enable Data Label This property allows you to active the Data Label.

Text Color Sets the Text Color for the Data Label.

Font Style Sets the Font Style for Data Label.

Font Size Sets the Font Size for Data Label.

Font Family Sets the Font Family for the Data Label.

Table 4.7: Category Data Label

4.6.4 Category Title

Below you can see the Additional Properties for the category Title and their descriptions.


General Enable Title This property allows you to active the Title.

Title Text Here you can enter the Title Text.

Horizontal Alignment This property allows you to configure the horizontal alignment of the Title. The available options are Left, Right and Center.

Vertical Alignment This property allows you to configure the vertical alignment of the Title. The available options are Auto, Top, Bottom and Middle.

Horizontal Offset This property allows you to specify a Horizontal Offset of the Title relative to its default alignment.

Vertical Offset This property allows you to specify a Vertical Offset of the Title relative to its default alignment.

Floating When enabled, the plot area will not assign specific space for the title.

Margin Here you can specify the space between the title and the map plot area or the map subtitle (if enabled).

Font Color Sets the Font Color for the Title Text.

Font Style Sets the Font Style for the Title Text.

Font Size Sets the Font Size for the Title Text.



Style Font Family Sets the Font Family for the Title Text.

Table 4.8: Category Title

4.6.5 Category Subtitle

Below you can see the Additional Properties for the category Subtitle and their descriptions.


General Enable Subtitle This property allows you to active the Subtitle.

Subtitle Text Here you can enter the Subtitle Text.

Horizontal Alignment This property allows you to configure the horizontal alignment of the Subtitle. The available options are Left, Right and Center.

Vertical Alignment This property allows you to configure the vertical alignment of the Subtitle. The available options are Auto, Top, Bottom and Middle.

Horizontal Offset This property allows you to specify a Horizontal Offset of the Subtitle relative to its default alignment.

Vertical Offset This property allows you to specify a Vertical Offset of the Subtitle relative to its default alignment.

Floating When enabled, the plot area will not assign specific space for the subtitle.

Style Font Color Sets the Font Color for the Subtitle Text.

Font Style Sets the Font Style for the Subtitle Text.

Font Size Sets the Font Size for the Subtitle Text.

Font Family Sets the Font Family for the Subtitle Text.

Table 4.9: Category Subtitle


4.6.6 Category Legend

Below you can see the Additional Properties for the category Legend and their descriptions.


General Enable Legend This property enables / disables the Legend.

Enable Legend Title This property enables / disables the Legend Title.

Legend Title Here you can enter the text for the Legend Title.

Layout This property allows to specify the layout for the Legend. You can choose Horizontal or Vertical.

Horizontal Alignment This property allows to set the Horizontal Alignment for the Legend.

Vertical Alignment This property allows to set the Vertical Alignment for the Legend.

Floating When this property is enabled, the plot area will not assign specific space for the legend.

Box Width This property allows to set the Box Width for the Legend.

Margin Distance between the legend and the axis labels/plot area; Applicable only when the legend is not floating

Shadow Apply a drop shadow to the legend area.

Padding Here you can set the inner padding of the legend box.

Style Background Color This property allows to set the Background Color for the Legend.

Font Color Sets the Font Color for the Legend.

Font Size Sets the Font Size for the Legend.

Font Style Sets the Font Style for the Legend.

Font Family Sets the Font Style for the Legend.

Border Color This property allows to set the Border Color for the Legend.

Border Width This property allows to set the Border Width for the Legend.

Border Radius This property allows to set the Background Radius for the Legend.

Legend Item Hidden Color Here you can set the color that will be used for hidden items in the Legend.

Legend Item Hover Color Here you can set the color that will be when hovering over items in the Legend.



Legend Item Reverse Order This property allows to enable / disable a reverse order of the Legend Items.

RTL Support This property allows to enable / disable the Right To Left Support for the Legend.

Table 4.10: Category Legend

4.6.7 Category Tooltip

Below you can see the Additional Properties for the category Tooltip and their descriptions.


General Animation Enables the animation for the tooltip.

Enable This property enables / disables the display of the Tooltip.

Follow Pointer Enables the Tooltip's ability to follow the mouse pointer.

Follow Touch Move Enables the Tooltip's ability to follow the pointer for touch devices.

Hide Delay This is the amount of milliseconds by which the hiding of the tooltip is delayed, after the user moved the focus away from the particular data point.

No of Decimals No. of decimals to show within the Tooltip for each data point.

Thousand Separator Here you can define the Thousand Separator.

Decimal Separator Here you can define the Decimal Separator.

Value Prefix Here you can add a Prefix to the Tooltip.

Value Suffix Here you can add a Suffix to the Tooltip.

Style Shadow Applies a drop shadow to the tooltip.

Tooltip Background Color Define the Background Color for the Tooltip.

Tooltip Border Color Define the Border Color for the Tooltip.

Tooltip Border Radius Define the Border Radius for the Tooltip.

Tooltip Border Width Define the Border Width for the Tooltip.

Tooltip Font Color Set the Font Color for the Tooltip.

Tooltip Font Style Set the Font Style for the Tooltip.

Tooltip Font Size Set the Font Size for the Tooltip.

Tooltip Font Family Set the Font Family for the Tooltip.

Table 4.11: Category Tooltip


4.6.8 Category Zoom

Below you can see the Additional Properties for the category Zoom and their descriptions.


General Enable Navigation This property enables / disables the Navigation.

Horizontal Alignment Set the Horizontal Alignment for the Reset Zoom button.

Vertical Alignment Set the Vertical Alignment for the Reset Zoom button.

Table 4.12: Category Zoom

4.6.9 Category Style

Below you can see the Additional Properties for the category Style and their descriptions.


Map Border Width Here you can specify the Border Width for the map.

Background Color Here you can set the background color or gradient for the outer chart area.

Heatmap Minimum Range Color Here you can set the color for the Minimum range.

Maximum Range Color Here you can set the color for the Maximum range.

Mouse Hover Color Here you can set the color for the Mouse Hover.

Bubble Map Bubble Map Color Here you can specify the color for the Bubble Map.

Bubble Size Here you can specify the size for the Bubble.

Z-Axis Chart Z-Axis Title Font Family Here you can set the Font Family for the Z-Axis Title.

Z-Axis Subtitle Font Family Here you can set the Font Family for the Z-Axis Subtitle.

Table 4.13: Category Style

In the next section you would be instructed on how to setup a new map layer using the LMX-Geographic Layer component.


5 Visual BI Extensions for SAP Lumira – LMX-Geographic Layers

5.1 LMX-Geographic Layers

The LMX-Geographic Layers extension allows you to leverage longitude and latitude based information and visualize the information in different forms of map layers, such as a Bubble Layer, Marker Layer, Marker Cluster Layer, and Heat map Layer.

5.2 Features of LMX Geographic Layers Extension

In the following sections, we will outline the features of the LMX Geographic Layers component in SAP Lumira.

5.2.1 Bubble Layer

The Bubble Layer can be used to visualize a measure with the help of colored bubbles (or circles). The radius of the circle corresponds to the value of the configured measure. The center of the bubble lies at the latitude and longitude value of the data point. The exact value of the measure corresponding to each bubble can be displayed in the form of a tooltip on hovering over the data point (see Figure 5.1).

Figure 5.1: Bubble Layer


5.2.2 Marker Layer

A Marker Layer can be used to visualize a data point in the form of a marker on the map. The corresponding measure can be visualized with the help of tooltip, on hovering above each of the marker. Each marker has an icon embedded in it that can be customized; either from a predefined list of icons or a custom icon (see Figure 5.2).

Figure 5.2: Marker Layer

5.2.3 Marker Cluster Layer

A Marker Cluster Layer is similar to a Marker Layer, but brings together neighboring markers to form a single cluster that makes the visualization cleaner. The user can define how close two markers need to be in order for them to form a cluster (see Figure 5.3).

Figure 5.3: Marker Cluster Layer


5.2.4 Heat Map Layer

A Heat Map Layer is used to map the data points to color intensities. The measure corresponds to the intensity of the color shown in the map. The range of colors to be used can be selected by the user (see Figure 5.4).

Figure 5.4: Heat Map Layer


5.3 Data Source Requirements for LMX-Geographic Layers

The LMX-Geographic Layer requires a data source with both Longitude and Latitude information available. The information such as Longitude and Latitude can be leveraged in form of a dimension.

Below you can see a sample data set showing the following dimension:

- Latitude - Longitude

and showing the following measures:

- Sales - Profit

Country City Latitude Longitude Sales Profit

USA Houston 29.76 -95.37 485 443

USA Washington D C 38.91 -77.03 210 426

USA New York 40.71 -74 250 172

Russia Moscow 55.76 37.61 902 386

France Paris 48.86 2.35 575 382

UK London 51.51 -0.13 532 295

Germany Berlin 52.52 13.41 570 222

India Mumbai 19.07 72.87 253 308

Canada Vancouver 49.28 -123.12 900 394

Canada Toronto 43.65 -79.38 746 180

Australia Sydney -33.87 151.21 382 134

Australia Perth -31.95 115.85 895 268

China Beijing 39.904 116.407 838 452

Japan Tokyo 35.69 139.69 734 315

South Africa Cape Town -33.9249 18.4241 666 313

Table 5.1: Sample Data set for LMX Geographical Layers


5.4 How to use the LMX-Geographic Layer – Bubble Layer

Bubble Layer is used to visualize a measure with the help of colored bubbles (or circles). The radius of the circle corresponds to the selected measure value. The center of the bubble lies at the latitude-longitude value of the data point. In the following steps we will outline the steps required to setup a new map using the LMX-Geographic Layer component and to setup a new layer representing the data in form of a bubble layer. For our example we will assume, that the data source contains the following elements:

Dimension Longitude.

Dimension Latitude.

Measure Profit.

For our example, you can follow the steps below to setup a new LMX Geographic Layer as Bubble Layer:

1. In SAP Lumira select the menu File • New for creating a New Project. 2. For our example we will assume that you have the data available in form of a Microsoft Excel file. Select the

option Microsoft Excel in the list of data source and click Next (see Figure 5.5).

Figure 5.5: Add new Dataset



Figure 5.6: Select Data Source

4. After selecting the data source, you will be able to preview the selected data set in SAP Lumira (see Figure 5.7). Click Create to create a new Project based on the selected data set.

Figure 5.7: New Dataset

5. You will be presented with a new SAP Lumira document and you can start the configuration of the map (see Figure 5.8).


Figure 5.8: New SAP Lumira Document

6. Now select the LMX-Geographic Layers Extension from the Chart Extensions list (see Figure 5.9).


7. For our example, set the property Measure to the value Profit (see Figure 5.10).


Figure 5.10: Select Measure

8. Set the property Dimensions to the values Latitude and Longitude (see Figure 5.11).

Figure 5.11: Select Dimensions

9. Click Open Additional Properties. 10. You are presented with the Additional Properties of the Extension (see Figure 5.12).



11. Navigate to the Category Bubble (see Figure 5.13).



12. You can now configure the Bubble Layer by providing the necessary details as shown in Table 5.2.


Activate Bubble(s) Layer Name Here you can enter a name for the Bubble Layer (It accepts alphanumeric values and underscore).

Max range of bubble radius Common for all Bubble Layers, sets the maximum radius for the bubble.

Selection Highlight Color Sets the color for the situation when a bubble is selected.

Measure Select the measure for the layer.

Color Fill Select the color for the fill of the bubbles.

Opacity Set the opacity for the fill color.

Add/Update Click to add / update the layer.

New Create a new layer

Table 5.2: Bubble Layer

13. Activate the option Activate Bubble(s). 14. Set the property Layer Name based on your choice. 15. For our example, set the property Max range of bubble radius to the value 30. 16. Set the property Select Highlight Color to the value Red color (see Figure 5.14).


17. Set the property Measure to the value Profit. 18. Set the property Color Fill to a blue color. 19. For our example, set the property Opacity to the value 1.0. 20. Click Add/Update to add the newly configured layer.


21. The newly created bubble layer will be added to the list of configure bubble layers (see Figure 5.15).

Figure 5.15: List of Layer

22. You can use the Edit option to edit an already existing layer. 23. You can use the Delete option to delete the layer. 24. You can activate the Display option to display the configured layer as part of your map. 25. Now click ( ) on the right side of the toolbar in the Additional Properties to save your configurations and to

close the Additional Properties. 26. You should now see a map with blue colored bubbles that represent the selected Measure (see Figure 5.16).


In the next section you would be guided on how to setup a new map layer representing the data in form of Markers using the LMX-Geographic Layer component.


5.5 How to use the LMX-Geographic Layer – Marker Layer

A Marker Layer can be used to visualize a data point in the form of a marker on the map. The corresponding measure can be visualized with the help of tooltip, on hovering above each marker. In the following section we will outline the steps required to setup a new layer representing the data in form of Markers. For our example, we will re-use the same data which we used in the previous steps.

You can follow the steps below to setup a new LMX Geographic Layer as Marker Layer.

1. In SAP Lumira, follow the previous steps adopted for the setup of Bubble Layer right from opening a new project up to accessing the Additional Properties (see Figure 5.17).


2. Navigate to the Category Marker (see Figure 5.18).

Figure 5.18: Category Marker


3. You can now configure a Marker Layer by providing the necessary details as shown in Table 5.3:


Activate Marker(s) Layer Name Here you can enter the name for a Marker Layer (Should contain only alphanumeric values and underscore).

Measure Select the Measure for the layer.

Marker Type Select from Standard, Symbol, or a custom marker via a URL.

Marker Color Set the color for the Marker.

Marker Symbol Here you can select a sumbol, in cae you selected the Marker Type as Symbol.

Icon URL In case you would like to setup a custom icon, you can provide the URL.

Icon Color Set the Icon color for the standard marker.

Icon Width (in px) Sets the Icon Width for Marker.

Icon Height (in px) Sets the Icon Height for Marker.

Add/Update You can click Add / Update to either add a new layer or update an existing layer.

New Create a new layer.

Table 5.3: Marker Layer

4. Activate the option Activate Marker(s). 5. Set the property Layer Name based on your choice. 6. For our example, set the property Measure to the value Profit. 7. Set the property Marker Type to the values Marker-Standard. 8. Set the property Marker Color to a blue color. 9. Select a Marker Symbol. 10. Click Add / Update to add the new layer to the map. 11. The newly created marker layer will be added to the list of available layers. 12. You can use the Edit option to edit an already existing layer. 13. You can use the Delete option to delete the layer. 14. You can activate the Display option to display the configured layer as part of your map. 15. Now click ( ) on the right side of the toolbar in the Additional Properties to save your configurations and to

close the Additional Properties. 16. You should now receive a map with markers visualizing the data points (see Figure 5.19).


Figure 5.19: Marker Layer

In the next section you would be guided on how to setup a new map layer representing the data in form of Marker Clusters using the LMX-Geographic Layer component.


5.6 How to use the LMX-Geographic Layer – Marker Cluster Layer

A Marker Cluster Layer is similar to a Marker Layer, but it brings together the neighboring markers to form a single cluster. In the following section we will outline the steps required to setup a new layer representing the data in form of a Marker Cluster. For our example, we will re-use the same data, which we used in the previous steps.

You can follow the steps below to setup a new LMX Geographic Layer as Marker Cluster:

1. In SAP Lumira, follow the previous steps adopted for the setup of Bubble Layer right from opening a new project up to navigating to the Additional Properties (see Figure 5.20).


2. Navigate to the Category Marker Cluster (see Figure 5.21).

Figure 5.21: Category Marker Cluster


3. You can now configure the Marker Cluster Layer by providing the necessary details as shown in Table 5.4:


Activate Marker Cluster(s) Cluster Layer Name Enter a name for the layer (Should be only alphanumeric values and underscore)

Measure Select the measure for the layer.

Marker Color Select the color for the Marker.

Icon Color Select the color for the Icon.

Cluster Icon Select the Icon for the Cluster.

Cluster Radius Define how close two markers need to be in order to cluster them.

Enable Cluster Boundary Shows a blue boundary when hovering over a cluster.

Zoom to bounds Zooms in to show all markers when clicked on a cluster.

Spiderfy on Max Zoom If two or more markers are very close, then on maximum zoom, the markers will be shown at the vertices of a web.

Remove Outside Visible Bounds Removes all markers from the map that are outside the visible range of the viewport

Disable Clustering at Zoom Disables clustering at the defined zoom level.

Spiderfy Distance Multiplier Choose the relative distance bewteen two markers that are very close

Add/Update Click Add / Update to add or update the layer.


Table 5.4: Marker Cluster Layer

4. Activate the option Activate Marker Cluster(s). 5. Set the property Layer Name. 6. For our example, set the property Measure to the value Profit. 7. Set the property Marker Color to a red color. 8. Set the property Icon Color to a blue color (see Figure 5.22).


Figure 5.22: Marker Cluster

9. Set the property Cluster Icon. 10. For our example, set the property Cluster Radius to the value 60. 11. Activate the option Enable Cluster Boundary. 12. Activate the option Zoom to Bounds (see Figure 5.23).


13. Activate the option Spiderfy on Max Zoom. 14. Activate the option Remove Outside Visible Bounds. 15. Set the property Disable Clustering at Zoom to the value 5. 16. Set the property Spiderfy Distance Multiplier to the value 5. 17. Click Add / Update to add the new layer to the map. 18. The newly created marker layer will be added to the list of available layers. 19. You can use the Edit option to edit an already existing layer. 20. You can use the Delete option to delete the layer. 21. You can activate the Display option to display the configured layer as part of your map. 22. Now click ( ) on the right side of the toolbar in the Additional Properties to save your configurations and to

close the Additional Properties. 23. You should now receive a map with Marker Clusters (see Figure 5.24).



In the next section you would be guided on how to setup a new map layer representing the data in form of a Heat map using the LMX-Geographic Layer component.


5.7 How to use the LMX-Geographic Layer – Heatmap Layer

A Heat map Layer can be used to map the data points to color intensities. The measure corresponds to the intensity of the color shown in the map. The range of colors to be used can be selected by the user.

In the following steps we will outline the steps required to setup a new layer representing the data in form of a Heat map. For our example, we will re-use the same data which we used in the previous steps.

You can follow the steps below to setup a new LMX Geographic Layer as a Heat map:

1. In SAP Lumira, follow the previous steps adopted for the setup of a Bubble Layer right from opening a new project up to navigating to the Additional Properties (see Figure 5.25).

Figure 5.25: Heat Map Layer

2. Navigate to the Category Heat map (see Figure 5.26).

Figure 5.26: Category Heat map


3. You can now configure the Heat map Layer by providing the necessary details as shown in Table 5.5:


Activate Heat(s)

Layer Name Enter name for layer (Should contain only alphanumeic values and underscore)

Measure for Intensity

Select the measure corresponding to the layer.

By default, the property Measure for Intensity will be set to “Standard Intensity”. In this scenario, the heat map will have a uniform intensity throughout the map.

Gradient Select the colors

Radius Select the range for the Radius of Heat map

Opacity Select the opacity range of the Heat map Layer

Zoom Adjust zoom level of the Heat map Layer

Add/Update Add the layer with above config to the map


Table 5.5: Heat map Layer

4. Activate the option Activate Heat(s). 5. Set the property Layer Name. 6. For our example, set the property Measure to the value Profit. 7. Set the colors for the property Gradient. 8. For our example we will set the property Radius to the value 23 (see Figure 5.27).

Figure 5.27: Heat map Properties

9. Set the property Opacity to the value 0.9. 10. Set the property Zoom to the value 5. 11. Click Add / Update to add the new layer to the map. 12. The newly created Heat map layer will be added to the list of available layers. 13. You can use the Edit option to edit an already existing layer. 14. You can use the Delete option to delete the layer.


15. You can activate the Display option to display the configured layer as part of your map. 16. Now click ( ) on the right side of the toolbar in the Additional Properties to save your configurations and to

close the Additional Properties. 17. You should now receive a map with Heat map layer (see Figure 5.28).

Figure 5.28: Map with Heat map Layer

In the next section you would be guided on how to setup the different backgrounds for the Basemap using the LMX-Geographic Layer component.


5.8 How to use the LMX-Geographic Layer – Map Settings

The LMX-Geographic Layer provides the ability for the user to select from a list of different basemap layer. In the following section, we will outline the steps required to select from the different basemap layer.

You can follow the steps below to configure the different basemap layer:

1. In SAP Lumira, follow the previous steps adopted for the setup of a Bubble Layer right from opening a new SAP Lumira document up to navigating to the Additional Properties (see Figure 5.29).


2. Navigate to the Category Map Settings (see Figure 5.30).

Figure 5.30: Category Map Settings


3. You can now configure the Map Settings by providing the necessary details as shown in Table 5.6:


Map Settings - Basemap Standard OSM Type of Basemap

Black and White Type of Basemap

National Geographic Type of Basemap

Open Terrain – Cycling Type of Basemap

Street Map Type of Basemap

High Detail Type of Basemap

Mapquest Type of Basemap

Hot OSM Type of Basemap

Topography and Relief Type of Basemap

Open Terrain – Transport Type of Basemap

Dark Streets Type of Basemap

Staellite View Type of Basemap

Map Settings Auto map positioning and zoom

Zoom level of the map auto adjusted according to dataset

Start Location – Latitude

Here you can specify the Latitude value for the starting location.

Start Location - Longitude

Here you can specify the Longitude value for the starting location.

Starting Zoom Level Here you can specify the starting Zoom Level.

Table 5.6: Map Settings

4. For our example we will set the property Basemap to the value National Geographic. 5. Activate the option Auto Map Positioning and Zoom. When this property is activated, you will not be able to set

the values for the properties Start Location -Latitude, Start Location –Longitude, and Starting Zoom Level. 6. Now click ( ) on the right side of the toolbar in the Additional Properties to save your configurations and to

close the Additional Properties.


7. You should now receive a map based on your configured settings (see Figure 5.31).

Figure 5.31: Map Display

In the next section we will review the details of all the Additional Properties.


5.9 Additional Properties for Geographical Layers Component

As a extension component the Geographical Layers also comes with a set of Additional Properties. The Geographical Layers provide Additional Properties in the categories: Bubble, Marker, Marker Cluster, Heat map and Map Settings. In the following sections, you will find a list of available properties and a table with a more detailed description of each of those properties.

5.9.1 Category Bubble

Below you can see the Additional Properties for the category Bubble and their descriptions.


Activate Bubble(s) Layer Name Here you can enter a name for the Bubble Layer (It accepts only alphanumeic values and underscore).

Max range of bubble radius This property allows to specify the maximum range of the bubble radius.

Selection Highlight Color Here you can set the color for the selected bubbles.

Measure Here you can select the measure for the bubble layer.

Color Fill Here you can specify the fill color.

Opacity Here you can specify the opacity for the color.

Add/Update You can use Add / Update to add a new or update an existing layer.

New Clicking on New will generate a new layer.

Table 5.7: Category Bubble

5.9.2 Category Marker

Below you can see the Additional Properties for the category Marker and their descriptions.


Activate Marker(s) Layer Name

Here you can enter a name for the Marker Layer (It accepts only alphanumeic values and underscore).

Measure Here you can select the measure for the marker layer.

Marker Type Select from Standard, Symbol and URL marker types.

Marker Color Set the color for the Marker.

Marker Symbol In case Symbol is selected as Marker Type you can then choose the symbole for the marker layer.

Icon URL In case you choose to use a customer marker icon, you can then define the URL to the custom icon here.

Icon Color Sets the Icon Color.

Icon Width (in px) Sets the Icon Width.

Icon Height (in px) Sets the Icon Height.





Table 5.8: Category Marker

5.9.3 Category Marker Cluster

Below you can see the Additional Properties for the category Marker Cluster and their descriptions.


Activate Marker Cluster(s) Cluster Layer Name

Here you can enter a name for the Cluster Marker Layer (It accepts only alphanumeic values and underscore).

Measure Here you can select the measure for the marker cluster layer.

Marker Color Sets the Marker Color.

Icon Color Sets the Icon Color.

Cluster Icon Here you can choose an icon for the cluster.

Cluster Radius Define how close two markers need to be in order to cluster them

Enable Cluster Boundary Shows a blue boundary when hovering over a cluster

Zoom to bounds Zooms in to show all markers when clicked on a cluster

Spiderfy on Max Zoom If two or more markers are very close, then on maximum zoom, the markers will be shown at the vertices of a web

Remove Outside Visible Bounds Removes all markers from the map that are outside the visible range of the viewport

Disable Clustering at Zoom Disables clustering at the defined zoom level

Spiderfy Distance Multiplier Choose the relative distance bewteen two markers that are very close



Table 5.9: Category Marker Cluster


5.9.4 Category Heat map

Below you can see the Additional Properties for the category Heat map and their descriptions.


Activate Heat(s) Layer Name

Here you can enter a name for the Heat map Layer (It accepts only alphanumeic values and underscore).

Measure Here you can select the measure for the Heat map layer.

Gradient Select the colors

Radius Select the range for the Radius of Heat map

Opacity Select the opacity range of the Heat map Layer

Zoom Adjust zoom level of the Heat map Layer



Table 5.10: Category Heat map

5.9.5 Category Map Settings

Below you can see the Additional Properties for the category Map Settings and their descriptions.


Map Settings - Basemap Standard OSM Type of Basemap

Black and White Type of Basemap

National Geographic Type of Basemap

Open Terrain – Cycling Type of Basemap

Street Map Type of Basemap

High Detail Type of Basemap

Mapquest Type of Basemap

Hot OSM Type of Basemap

Topography and Relief Type of Basemap

Open Terrain – Transport Type of Basemap

Dark Streets Type of Basemap

Staellite View Type of Basemap

Map Settings Auto map positioning and zoom

Zoom level of the map auto adjusted according to dataset

Start Location – Latitude Here you can specify the Latitude value for the starting location.

Start Location - Longitude Here you can specify the Longitude value for the starting location.



Starting Zoom Level Here you can specify the starting Zoom Level.

Table 5.11: Category Map Settings


6 Further Information

You can find further information about the Visual BI Extensions for SAP Lumira here:

Installation Guide

https://visualbi.com/wp-content/uploads/visualbi-extensions-for-sap-businessobjects-lumira-lmx-installation-

guide.pdf

User Guide

https://visualbi.com/wp-content/uploads/visualbi-extensions-for-sap-businessobjects-lumira-lmx-user-guide.pdf

Supported Platforms:


Product Documentation

http://visualbi.com/lmx-extensions-sap-lumira/lmx-downloads/

https://visualbi.com/wp-content/uploads/visualbi-extensions-for-sap-businessobjects-lumira-lmx-installation-guide.pdf

https://visualbi.com/wp-content/uploads/visualbi-extensions-for-sap-businessobjects-lumira-lmx-installation-guide.pdf

https://visualbi.com/wp-content/uploads/visualbi-extensions-for-sap-businessobjects-lumira-lmx-user-guide.pdf


http://visualbi.com/lmx-extensions-sap-lumira/lmx-downloads/


www.visualbi.com

[email protected]

Phone: +1 888-227-2794

Fax: +1 888-227-7192

Plano, TX Dallas, TX Chennai, India

visual bi extensions for sap lumira (lmx) - user...

Documents