Galigeo Lumira Discovery

Galigeo For Lumira Discovery
User Guide
| Table of Contents | 2
Table of Contents
1 About this Document.......................................................4

1.1 Reading Conventions.....................................................................................5
1.2 Who is this Guide for....................................................................................5
1.3 Application Description.................................................................................. 5
2 Prerequisites................................................................... 6
2.1 Prerequisites................................................................................................ 7
3 Installation and Upgrade.................................................8

3.1 First Time Installation................................................................................... 9
3.2 Upgrade...................................................................................................... 9
3.3 Locate the Extension in Lumira.....................................................................11
4 License.......................................................................... 12
4.1 Activate the 30-Day Trial License.................................................................. 13
4.2 Expired Trial License................................................................................... 14
4.3 Activate a Standard License......................................................................... 15
4.4 Checking License Details..............................................................................16
5 Adding Geodata............................................................. 18
5.1 Map Data from Longitude and Latitude Dimensions......................................... 19
5.2 Add Custom Geodata.................................................................................. 20
5.3 How Does it Work Inside Galigeo Discovery?.................................................. 26
5.4 Duplicating a Standard Layer....................................................................... 27
6 Configuring the Basemap.............................................. 28

6.1 Choose a Basemap..................................................................................... 29
6.2 Import a Custom Basemap.......................................................................... 32
7 Representation Types.................................................... 37
7.1 Legend...................................................................................................... 38
7.2 Accessing BI Information from the Map......................................................... 38
7.3 Customizing a Layer....................................................................................39
7.4 Saving Customized Layers........................................................................... 40
7.5 Ranges of Color and Conditional Formatting................................................... 41
7.6 Proportional Symbols and Pie Charts............................................................. 42
7.7 Unique Values............................................................................................ 45
7.8 Heatmap.................................................................................................... 46
7.9 Smart Mapping Concept...............................................................................48
7.10 Exporting a Layer to GeoJSON....................................................................49
8 Drill Down Feature........................................................ 51

| Table of Contents | 3
8.1 Native Hierarchies....................................................................................... 52

8.2 On-the-fly Hierarchies................................................................................. 52
9 Time Series................................................................... 55
9.1 Create and Run a Time-Series......................................................................56
10 Geocoding....................................................................59
10.1 Geocode Your Addresses on the Fly.............................................................60
11 Flows........................................................................... 62
11.1 Create Flows Between an Origin Dimension and a Destination Dimension.......... 63
12 Extension Export......................................................... 64
12.1 Extension Export....................................................................................... 65
13 Installation of Galigeo Discovery on Lumira Server for

BI Platform.................................................................... 66
13.1 Prerequisites.............................................................................................67
13.2 Install Galigeo Discovery Extension on Lumira Server for BI Platform............... 67
14 Uninstall...................................................................... 68
14.1 Uninstalling Galigeo Discovery.................................................................... 69
15 Troubleshooting...........................................................70
15.1 Basemap not Displayed..............................................................................71
15.2 Dimension not Detected as Geographic........................................................ 71
15.3 Dimension Detected as Geographic but no Data Shown.................................. 72
16 Getting More Information............................................ 73

16.1 Help Page................................................................................................ 74
16.2 Support....................................................................................................74
| 1 About this Document | 4
1 About this Document

Topics: : When using Galigeo For Lumira Discovery (on
Desktop or Server), you can access this documentation
• Reading Conventions directly from within the product by clicking on the Help
• Who is this Guide for button on the top-left of a map.
• Application Description
| 1 About this Document | 5
1.1 Reading Conventions

Steps to follow
Notice
Advice
Important
Example
1.2 Who is this Guide for

This document should be used by persons:
• in charge of installing Galigeo For Lumira Discovery extension to SAP Lumira Discovery
Desktop and/or SAP Lumira Server.
• in charge of using Galigeo For Lumira Discovery extension either with SAP Lumira
Discovery Desktop or SAP Lumira Server in everyday business.
1.3 Application Description

Galigeo For Lumira Discovery provides advanced geomapping visualization and spatial
analysis capabilities to SAP Lumira Discovery. Galigeo For Lumira Discovery offers a large
range of tools and settings for representing and analyzing your different dimensions and
measures. The bundle is composed of two components:
• Galigeo For Lumira Discovery: This is a standard Lumira extension visualization that
brings the geomapping component to SAP Lumira Discovery, and that can be both installed
using the standard Extension Manager within SAP Lumira Discovery, or using the standard
xxx feature within SAP Lumira Designer.
• Galigeo Manager: A desktop application that can be launched without being first
installed, and manages the custom geographic layers and basemaps that will be available
within all the Galigeo for SAP BI Suite, which Galigeo For Lumira Discovery is a part of.
| 2 Prerequisites | 6
2 Prerequisites
Topics:
• Prerequisites
| 2 Prerequisites | 7
2.1 Prerequisites
• SAP Lumira Discovery Desktop 2.0+, all Service Packs
• SAP Lumira Desktop 1.31+, all Service Packs
• An Internet connection for the use of default basemaps
In case of troubles with the Internet connection (for example, you do not see any
basemap), make sure the connection is well configured within SAP Lumira by navigating to
Preferences > Network
If you do not have any proxy in your network structure, set the Proxy configuration to "No
Proxy" and restart SAP Lumira.
• The Longitude/Latitude must be formatted in WGS84 (EPSG:4326), also known as GPS

coordinates.
For example, a point with 40.730610 as latitude and -73.935242 as longitude is valid and
will be located in the city of New York, USA
• Supported geographic layers:
• GeoJSON (usually identified by format *.json or *.geojson) files
• TopoJSON (usually identified by format *.json or *.topojson) files
• Shapefile (usually identified by format *.shp) files
• ArcGIS Feature Service (v10.2+)
• The Feature Services must be public, or secured by tokens
• They must have a feature access (known as query operation) available, which is
usually the case by default
• : All types of geometry are supported: Points, MultiPoints, Polygons,
MultiPolygons, Lines, and MultiLines
• Galigeo Manager:
• Windows 7, 8.x, 10
• 64 bits operating system
• 4GB+ of RAM
• Administrator rights, or at least Write accesses to the C:/Users/<your_name>/*
folders.
| 3 Installation and Upgrade | 8
3 Installation and Upgrade

Topics:
• First Time Installation

• Upgrade
• Locate the Extension in
Lumira
3.1 First Time Installation

Before installing the extension for the first time, make sure you have the latest version. The
latest Galigeo For Lumira Discovery bundle can be downloaded from the Galigeo website.
• Once downloaded, the bundle needs to be uncompressed
: The Galigeo For Lumira Discovery bundle is composed of the Galigeo For Lumira
Discovery extension (GaligeoDiscovery-x.x.xxx.zip), its documentation and the
Galigeo Manager application which helps you configure your extension
• Start the SAP Lumira Discovery Desktop software
• Click on the top-left icon to open the menu, then click onExtensions to open the SAP
Lumira Extension Manager
• Click on the + icon on the top-right of the dialog box, and navigate to the location
where the Galigeo For Lumira Discovery extension was uncompressed, and select it (e.g.
GaligeoDiscovery-2.0.105.zip)
• Restart SAP Lumira Discovery Desktop application when prompted
• To activate your trial license or benefit from the advanced features of the extension, open
the Galigeo Manager application by running the galigeomanager.exe executable from the
/[Download location]/Galigeo/GaligeoManager/ folder (see corresponding chapters in
this guide)
3.2 Upgrade
• Start with deleting the old Galigeo Manager folder (/<path to folder>/Galigeo/
GaligeoManager)
• Before installing the new extension, make sure you have the latest version of the Galigeo
For Lumira Discovery extension available
• The Galigeo For Lumira Discovery bundle can be downloaded from the Galigeo website
• Uncompress the bundle in a folder
: The Galigeo For Lumira Discovery bundle is composed of the Galigeo For Lumira
Discovery extension (GaligeoDiscovery-x.x.xxx.zip), its documentation and the
Galigeo Manager application which helps you configure your extension
• Start the SAP Lumira Discovery Desktop application
• Click on the top-left icon to open the menu, then click onExtensions to open the SAP
Lumira Extension Manager
• Then click on the Thrash icon located on the top-right of the Extension card
• Restart SAP Lumira Discovery Desktop application when prompted

• Then see the Chapter 3.1 (First Time Installation) to install the new Galigeo For
Lumira Discovery extension.
: Start the Galigeo Manager application to reapply your custom configuration
automatically (/<path to folder>/Galigeo/GaligeoManager/galigeomanager.exe
after the upgrade is complete.
3.3 Locate the Extension in Lumira

After the installation is complete, you can select the Galigeo extension from the Chart Picker
by selecting Galigeo Map, as seen below.
| 4 License | 12
4 License
Topics: This chapter helps you to activate the 30-day trial licence, as
well as a standard license in the case you have one.
• Activate the 30-Day Trial
License To learn more about standard licensing, feel free to contact
the Galigeo team
• Expired Trial License
• Activate a Standard License
• Checking License Details
| 4 License | 13
4.1 Activate the 30-Day Trial License

When trying to create or open a Galigeo Map visualization in Lumira without having a license
activated, you will get the following message:
: Note that in the picture above, you can click on the Guide me! button to access
useful information (including this documentation online) in order to get started fast.
To activate your 30-day trial license, open Galigeo Manager by double-clicking on /[Download
location]/Galigeo/GaligeoManager/galigeomanager.exe.
: As Galigeo Manager will act as the centerpiece when it comes to managing your
geodata for Galigeo Discovery, it's strongly advised to create a shortcut of it on your
desktop so you can access it with ease.
When opened for the first time, Galigeo Manager will ask you for some information in order
to generate the 30-day trial license.
After successfully entering the needed information, a pop-up will be displayed on the top-
right of Galigeo Manager.
| 4 License | 14
Note that every time you will open Galigeo Manager beyond this point, a pop-up displayed on
the top-right will tell you your license status.
You can now access all features inside Galigeo Discovery.

Note that you can see more details about the status of your license status by going into
Help > License > Info
: The 30-day trial license is only available once per user and cannot be reset after it
has expired.
: If your license is about to expire, you will receive a notification from within Galigeo
Discovery. We strongly advice you to activate a new license, if you have one, as soon
as such message is displayed.
4.2 Expired Trial License

Once the 30-day trial license has expired, you won't be able to use Galigeo Discovery
anymore.
A message will be displayed within Galigeo Discovery, and nothing will be displayed on the
map.
If you want to keep on having access to the product, you will have to enter a standard license
(see chapter 4.3 - Entering the License in Galigeo Manager)
If you do not have such standard license and want to purchase one, feel free to contact the
Galigeo team
| 4 License | 15
4.3 Activate a Standard License

To activate a Standard License, open Galigeo Manager by double-clicking [Download
location]\Galigeo\GaligeoManager\galigeomanager.exe or from the shortcut you had
previously created.
On the top-menu, go to Help > License > Add
On the newly opened dialog-box, paste the whole license you own as follows:
| 4 License | 16
Click on the Add button, and a message will tell you that the Standard License has been
activated.
: If you see an error message after adding your license, make sure that you copied
the whole license message and try again.
: If after making sure that the whole license content was well copied and pasted you
still experience an error message, make sure that you have the correct Write accesses
to the C:/Users/<your_name>/* folders, and then try to run the activation process
again.
Press the Close button.
The license is now activated.
4.4 Checking License Details

To access the license details, open Galigeo Manager by double-clicking [Download
location]\Galigeo\GaligeoManager\galigeomanager.exe or from the shortcut you had
previously created.
On the top-menu, go to Help > License > Info
| 4 License | 17
A dialog box will open showing the license details.

| 5 Adding Geodata | 18
5 Adding Geodata
Topics: In order to be able to represent data on different
geographical geodata (also known as layers), we need to add
• Map Data from Longitude these geodata in the custom catalog.
and Latitude Dimensions
By default, Galigeo Discovery comes with a standard catalog.
• Add Custom Geodata
This catalog contains a list of standard layers that can be
• How Does it Work Inside used without the need to beforehand configure them.
Galigeo Discovery?
But you can of course also import your own geodata that
• Duplicating a Standard
are relevant to your business if they are not available in the
Layer
default layers.
Importing custom geodata can be fulfilled using the Galigeo
Manager application, delivered in the Galigeo For Lumira
Bundle, about which we talked a little bit in the License
chapter (4.*).
We will discuss here the core - but easy to understand
concepts mandatory to optimally use Galigeo Manager.
5.1 Map Data from Longitude and Latitude

Dimensions
If you have dimensions in your BI dataset that contains valid latitude and longitude values,
Galigeo Discovery can map them directly on the fly.
This will also work in you have a single dimension containing concatenated values of latitude
and longitude.
The latitude and longitude values have to respect some rules:
• The values must be in WGS84 (EPSG:4326) also known as GPS coordinates.
• The dimension name that contains the longitude values must be called either "Longitude"
or "X", or contain the pattern "lon", "lng", or "wgs" + "x" (case insensitive)
• The dimension name that contains the latitude values must be called either "Latitude" or
"Y", or contain the pattern "lat", or "wgs" + "y" (case insensitive)
• If the latitude and longitude are concatenated into one dimension, their respective values
must be separated by either a blank space " ", an underscore "_", or a semicolon ";"
• If the latitude and longitude are concatenated into one dimension, the name of this
dimension must be either "LongitudeLatitude", "LonLat", "LatitudeLongitude" or "LatLon"
regarding the order of the concatenation
For example, a point with 40.730610 as latitude and -73.935242 as longitude is valid and will
be located in the city of New York, USA
5.2 Add Custom Geodata

First, open Galigeo Manager by double-clicking [Download location]\Galigeo
\GaligeoManager\galigeomanager.exe or from the shortcut you have previously created.
: Onscreen messages will guide you through the whole process, in order to easily
import your first geodata and then be able to use it in Galigeo Discovery.
Click on the Geodata tab on the top-left.
A new panel will appear on the left. You can browse through all the default layers embedded
by default by just clicking on each line of the catalog.
: You can also browse all the default geodata provided by default at the end of this
documentation.
Click on "Add Geodata" button in order to open a new dialog box.
Inside the newly-opened dialog box, you can choose what content you are going to import.
If it is a GeoJSON (*.geojson, *.json),or a Shapefile (.shp), select the File radio button
(selected by default), then click on the File button.
An explorer dialog will appear that will allow the selection of the desired file.
If it is an ArcGIS feature service, by clicking on the ArcGIS Feature Service option, the dialog
will invite the user to enter the REST URL of the cartographic layer that is intended to be
used:
No matter which type of geodata you have chosen (static files or ESRI services), finish the
import by clicking the OK button at the bottom of the dialog-box.
The layer will be shown in the map view section.
You will just have to go through a little part of configuration before being able to
use the imported geodata within Galigeo Discovery.
The core concept here are called Layer field and Geodimension.
As our solutions uses BI data in order to put them in relation with geodata, it is necessary
to have a join between these two types of data, to have a BI field and a geodata field that
contain the same values (or at least some common values). The Layer Field is one of the
dimensions coming from the geodata (e.g. "STATES_ABBR" field with "NV", "CA", … values).
The Geodimensions are the term(s) that will be automatically recognized in the BI dataset
field names to match the join field (e.g. : "States abbreviation" or "States code" or “States
name” or "States", …).
In order to know which dimension contain the geodata, once it has been imported and
displayed on the mapn, you can click at your ease on one of its features (either a marker, a
polygon or a line). This will display a pop-up, also known as infowindow, that will contain all
the geodata dimensions and their corresponding values for the specific feature you clicked
on.
: Quick example:
If you have a dimension in your BI dataset called "Maintenance Block" containing
values like "Block 1001", "Block 1002", "Block 1053" and so on, when clicking
randomly on one of the feature from an imported geodata (here a polygon), we can
see that this geodata contains a "NAME10" dimension, containing values that could be
matched with our "Maintenance Block" dimension coming from BI.
So in order to complete the configuration, as in our BI dataset the dimension is called

"Maintenance Block", just type in "Maintenance Block" in the Geodimension input. If
tomorrow we use another dataset with a dimension containing the same values than
"Maintenance Block" but with a different name (e.g. "MTN_BLK"), we can just open this
layer again in Galigeo Manager and add "MTN_BLK" is the Geodimension input.
At the end, our configuration looks like this:
Just hit "Save" and we are good to go to use this layer in Galigeo Discovery.
After a layer has been configured and saved in Galigeo Manager, it becomes immediately
available in Galigeo Discovery. There is no need to restart Lumira.
All saved custom geodata will save themselves in the Custom Layers tab. You can import as
many layers as you want, with different sources from each.
If you want to edit a given custom layer later on, you can just open it back from the Custom
Layers tab.
Any custom geodata can be removed from Galigeo Manager, and thus from Galigeo
Discovery, using the Delete button, then validating the confirmation box.
: Before deleting a custom layer you previously imported and configured, make sure
that first, it is not used anymore in any Lumira visualizations, and second, make sure
you have a copy of the original file somewhere, as it will be permanently deleted from
any Galigeo folder, and thus unrecoverable.
: For the time being, only custom layers can be deleted. Standard layers embedded
inside Galigeo Manager by default cannot be deleted.
5.3 How Does it Work Inside Galigeo Discovery?

When creating a visualization in Lumira using Galigeo Discovery, you will drag and drop
dimensions and measures like you would do for other standard charts.
When you drag a dimension in the Geodimension feed in Lumira, the dimension becomes a
potential candidate to be detected as a geographical dimension, even if it's not typed as one
in Lumira.
The way it works is that Galigeo Discovery embeds a Smart Mapping engine, that will try to
find out if the dimensions you gave as input can be displayed on the map.
To do so, it is going to compare the names of the dimensions you set in the visualization,
with the ones contained in the Geodimension input of each geodata within Galigeo Manager.
Below is a diagram that sums up, in an easy to understand manner, the high-level process
underlying the concept.
5.4 Duplicating a Standard Layer

As you understood from the two previous chapters (5.1 and 5.2), the link between BI and
geodata is made through a Geodimension name.
By default, Galigeo provides embedded geodata, such as Administrative Boundaries for USA
(including ZIP Codes), France, Germany, Australia, ...
These geodata also come with predefined geodimensions, that might not suit your BI dataset
dimensions.
For this reason, you have two possibilities.
• You rename your dimensions from within the BI, this is something very easy to do with
Lumira
• You duplicate the default geodata within Galigeo Manager, an set it to some new
geodimension(s) that will match your BI dimension names.
When duplicating a default geodata, a copy is created and the default layer still exists.
The duplicated geodata then behaves like any other custom layers, i.e. you can modify its
Layer Field and add/modify/delete new geodimensions whenever you want.
The duplicated geodata can also be deleted if needed, which is not the case for the default
geodata it has been duplicated from.
| 6 Configuring the Basemap | 28
6 Configuring the Basemap

Topics: It is possible to choose between default basemaps or import
one of yours using the Galigeo Manager application, delivered
• Choose a Basemap in the Galigeo Discovery Bundle, about which we talked a
• Import a Custom Basemap little bit in the License chapter (4.*).
6.1 Choose a Basemap

First, open Galigeo Manager by double-clicking [Download location]\Galigeo
\GaligeoManager\galigeomanager.exe or from the shortcut you had previously created.
Then, on the top-left corner you will see the Basemap tab. Click on it, a panel will appear on
the left side of the application.
By default, the ESRI Light Gray basemap is already selected.
You can browse through the list of predefined basemaps and click on them in order to define
a new default basemap that will be set as the default basemap in Galigeo Discovery.
: You can use any of the predefined basemaps without having to purchase further
licensing, except for the Baidu Maps and Baidu Satellite ones, which require a key
(licensing) not provided by Galigeo.
Each time you will click on a different basemap, the map will be updated accordingly, and
a message on the top-right corner will tell you that this basemap is now the one by default
within Galigeo Discovery.
In order to see the newly selected basemap within Galigeo Discovery, you don't need to
restart Lumira.
: The basemap will be applied for all the Lumira Documents using Galigeo for Lumira,
even the ones created before switching the basemap.
6.2 Import a Custom Basemap

First, open Galigeo Manager by double-clicking on [Download location]\Galigeo
\GaligeoManager\galigeomanager.exe or open it from the shortcut you had previously
created.
Then, on the top-left corner you will see the Basemap icon. Click on it, and a panel will
appear on the left hand side of the application.
At the top of the newly opened panel, you will see a "+" button, click on it in order to open a
new dialog box.
The dialog box will guide you through the process that will let you import your own custom
basemap.
The supported types of basemaps supported are:

• ESRI-Tiled Services (WMTS Services are currently not supported)
• OSM-like URLs (for example: http://{s}.tile.opentopomap.org/{z}/{x}/{y}.png) - This
type of basemaps are generally described by URLs ending in {x}/{y}.png or .jpg
• WMS Services v1.1+ (OGC Standard)
: Quick example:
• Basemap Name - The name of the basemap you are importing, it will help you
identifying it when you will open Galigeo Manager the next time
• Basemap URL - The URL of the basemap, basically the service that will retrieve all the
tiles of the basemap
• Attribution - The basemap copyright info that will be displayed on the bottom-right of the
map if it has been filled
• API Key - If your basemap requires an API key, enter it there. Galigeo won't be providing
any API key.
Once the configuration is done, click on Add, and if the URL provided is correct, the basemap
will be displayed on the map.
You can find the layer you configured on the basemap list on the left (with a default
thumbnail not configurable for the moment).
7 Representation Types
Topics: This section describes what are the available representations
with the Galigeo Discovery extension. Galigeo Discovery
• Legend embeds a Smart Mapping engine, that will analyze the
• Accessing BI Information dimensions and measures provided to each visualization,
from the Map trying to find the best way to put it on the map.
• Customizing a Layer The user can at any time change the representation chosen
• Saving Customized Layers by the Smart Mapping engine, or customize it.
• Ranges of Color and
Conditional Formatting
• Proportional Symbols and
Pie Charts
• Unique Values
• Heatmap
• Smart Mapping Concept
• Exporting a Layer to
GeoJSON
| 7 Representation Types | 38
7.1 Legend
As your data starts appearing on the map (see chapters 5.* for more information), they will
also filled into the legend, displayed at the bottom-left corner of the map.
The legend will display for each layer the manner in which it is represented.
It is also possible from the legend that a user will have the possibility to customize each layer
if he so wants (see chapter 7.2).
7.2 Accessing BI Information from the Map

When clicking on a feature on the map, an infowindow will open (click somewhere else on the
map to close it).
The infowindow will contain all the dimensions and their relative values that were set to the
visualization.
It is also from this infowindow that you will be able access Lumira functionalities like filtering,
exporting, drilling-down, ... See chapters 8.* and 9.* for more information.
The measure with a green background is the measure currently used to create the
representation of the given layer.
7.3 Customizing a Layer

You can customize the way a layer is represented (look and feel) directly from the legend.
To do so, on the legend, click on one of the cog icons displayed on the right of the layer
name.
You will then have access to several new icons, each one corresponding to a different type of
representation.
: According to what your layer is made of (polygons, points or lines), you won't
have access to all types of representation. For example, you cannot display lines as a
heatmap (or it would display something not relevant).
: The customization is only accessible from the Visualize Room. It is thus only
accessible to users that have the rights to create visualizations, either because they
are using Lumira Desktop, or they have enough rights on Lumira Server.
7.4 Saving Customized Layers

: This part is really important. The standard saving mechanism will not ensure that
what you have customized in Galigeo Discovery will also be saved when you will close
Lumira. The process to ensure that the customization will be saved is very easy, and
you have to make sure to follow it in order to guarantee that you will find everything
as you left it when reopening Lumira.
: To ensure your customization will be saved:
• After your customization is done, from the left menu, navigate to Design, and click
the Save Properties button. Then save your Lumira document.
: Example:
7.5 Ranges of Color and Conditional Formatting

Ranges of color is a way to display data by creating several ranges defined by two
boundaries, and different colors (that logically form a gradient, but this is not mandatory).
This is also what is known as choropleth when we deal with polygons, but ultimately this type
of representation can be applied to any type of geometry (polygon, line, point).
By default , Galigeo Discovery Smart Mapping engine will calculate the ranges automatically
regarding the values contained in a given measure, by applying different algorithms like
quantile classification.
You can control each break from the legend. This process is known as conditional
formatting.
To customize a range color, just click on the given color you want to change.
To customize the boundaries of a range, click on the values, and you are then given the
possibility to edit it.
: If you decide to input predefined values for a range, the ranges will thus not be
recalculated after the refresh of the dataset due to some other action that could lead to
a potential modification of the ranges.
: When modifying the boundaries of a range, the other ranges will not be
automatically recalculated. That means that ranges can potentially be overlapping,
which however won't have any side effect for Galigeo Discovery. If a value is not
covered by one of the ranges, it will display in light gray on the map.
7.6 Proportional Symbols and Pie Charts

Proportional symbols is a way to display data by applying different sizes to a symbol
according to its value.
It can only be applied to layers with points or polygons as geometry. If the geometry is
polygon, the centroid of each polygon will be automatically computed by Galigeo For Lumira
Smart Mapping engine in order to place the proportional symbol.
You can customize the color of the proportional symbol. Note that by default, all the symbols
have the same color.
To customize symbols color, just click on a symbol and choose the color you want to use.
You can also mix the size of each symbol with another information that will displayed as a
color (a turnover mixed with a category of product for example).
To enable this, just drag any dimension in the Color field, below the Geodimension field.
When doing this, the Galigeo Discovery Smart Mapping engine will handle two cases:
• There is only one category per symbol (value).
In this case, proportional symbols take different colors regarding their category value.
: Each category color can be customized, see the chapter about unique values
representation (7.5).
• There is more than one category per symbol (value).
In this case, the proportional symbols are displayed as pie charts.
The size of each pie chart is recalculated by summing the values of each category per
symbol.
: Each category color can be customized, see the chapter about unique values
representation (7.5).
: You do not have the hand on weather the symbol will displayed as standard
symbol or pie chart. Galigeo Discovery Smart Mapping engine will analyze the dataset
automatically and chooses the best one to correctly represent the data on the map.
7.7 Unique Values

Unique values is a way to display data by applying diverging color to each different values
contained in the associated measure.
Unique values representation can be applied to any type of geometry: point, polygon, line.
In Lumira, a measure is mandatory to create a visualization, and can only contain numeric
values. So just apply a unique values representation, your different categories must be
numeric.
In order to apply different colors as categories contained in an alphanumerical dimension,
please look at chapter 7.4.
To customize the color of a category, just click on the given color you want to change.
7.8 Heatmap
Heatmap, also known as heat map, is a graphical representation of data where the individual
values contained in a matrix are represented as colors.
Heatmap can only be applied to a layer with points as geometry.
You cannot customize any attribute of the heatmap.
The heatmap can be generated whether there is a measure or not attached to the
visualization. In the case there is no measure, the density of points will be taken into account
to create the heatmap.
When a layer is displayed as heatmap, a new control appears on the left of the map.
This control lets you control the granularity of the heatmap with a slider.
7.9 Smart Mapping Concept

When dragging and dropping dimensions and measures coming from BI, the Smart Mapping
module will automatically analyze them and try to figure out the best way to represent those
on the map.
: Quick example:
If you drag a Latitude dimensions and a Longitude dimensions, markers will be mapped
on the fly. If you then drag a measure containing negative and positive values, this is
how the map will respond:
The Smart Mapping engine decided to display the markers as proportional symbols,
differentiated by two colors: green for positive values and red for negative values,
so you can differentiate markers by their respective value and the fact their value is
negative or positive in a matter of seconds. This result is obtained without having to
configure anything.
Of course, you will then still be able to customize the color of positive and/or negative
values the same way you would do for any other type of representation.
: The example above is just one of the multiple ways Smart Mapping will handle the
BI data in order to always display something relevant. You will be able to discover
more applications of Smart Mapping when using the extension in Lumira.
7.10 Exporting a Layer to GeoJSON

You can export any of the layers that was created to GeoJSON (*.geojson).
The main point of this is being able to open the GeoJSON file to any GIS tool (ArcMap, QGIS,
MapInfo) and do further geoanalysis.
To export a layer, click on the save icon (floppy disk) next to the layer name.
A dialog box will then open, asking you where do you want to save the file.
: The exported layer will embed all the information coming from BI you bound to the
visualization.
: At the moment, you can not export all layers at once in bulk. You have to export
them one by one.
8 Drill Down Feature
Topics: Galigeo Discovery embeds a Smart Mapping engine that will
let you leverage two kind of hierarchies:
• Native Hierarchies
• Native hierarchies
• On-the-fly Hierarchies
• On-the-fly hierarchies
Both types are not limited to any number of neither levels,
nor geographical types (polygons, lines, points).
: Regarding the version of SAP Lumira 2.0 Discovery,
the native drill-down feature might not be available.
Contact support@galigeo.com for more information
| 8 Drill Down Feature | 52
8.1 Native Hierarchies

To leverage native hierarchies, just drag your hierarchies as you would do with a single
dimension.
Galigeo Discovery will detect it as a hierarchy, and the drill-down & drill-up buttons will be
automatically available for you to navigate through the different levels of the hierarchy.
: You are not limited to the Lumira Geographical Hierarchy, as any type of Custom
Hierarchy will also work.
The most important is that all the dimensions contained in the hierarchy should be
dimensions that can be detected as geographical dimensions by Galigeo Discovery, even if
their type in Lumira is not geographic (for more information see Chapter 5).
To drill-down/drill-up, just click on a feature on the map. A pop-up (also known as
infowindow) will open and you will have access to the Drill-down and/or Drill-up button(s).
When clicking on Drill-down or Drill-up button(s), native Lumira filtering mechanism will
occur, the same than if you were using a hierarchy on a standard chart.
: For technical reasons, when using a native hierarchy, all the other dimension(s)
provided to Galigeo Discovery should not be possible to detect as geographical ones.
8.2 On-the-fly Hierarchies

The Galigeo Discovery Smart Mapping engine is also able to detect hierarchies even if they
have not been defined on the Lumira side, based on the dimensions that have been set when
| 8 Drill Down Feature | 53
creating a visualization, and to create an "on-the-fly" hierarchy where you will still be able to
drill-down and up through all the levels.
In order to detect such a hierarchy, some conditions must be fulfilled:
• At least two dimensions and one measure have been provided
• The top level dimension, that will become the top level of hierarchy, must be made of
polygons
• The order you set your dimensions matters, and will help the Smart Mapping engine in
order to build the hierarchy on the fly.
: Quick example:
On the screenshot above, we see two different geodata represented on the map (proportional
symbols, coming from the Latitude and Longitude dimensions, and choropleth, coming from
the Sales Territory dimension).
There, the Latitude/Longitude dimensions are on top of the Sales Territory dimension, so as a
result both are represented on the map at the same time
The Smart Mapping engine could not find any hierarchy configuration.
On the screenshot above, we just switched the order of the dimensions, and now only the
Sales Territory dimension is displayed on the map (as choropleth).
If we click on a polygon, we have now access to the Drill-down button, even if there is no
pre-established hierarchy present.
The Smart Mapping engine detected a hierarchy configuration (Sales Territory > Latitude/
Longitude) and activated it by default.
: You can then create more advanced On-the-fly hierarchy just being careful of the
order the dimensions are set to the visualization, like in the example above.
: On-the-fly hierarchy, being completely created on the Galigeo side, cannot benefit
from all the same capabilities than a native hierarchy would do. The filtering process is
for example not accessible.
9 Time Series
Topics:
• Create and Run a Time-

Series
| 9 Time Series | 56
9.1 Create and Run a Time-Series

Time Series are brought to you out of the box when using Galigeo Discovery.
In order to enable a time series, click on the Time Series icon in the top-left of the map.
You can then access a list of all the dimensions (including measures) you have set for the
visualization from a drop-down list.
Just select one of the dimension from the list, and the time series will start playing by itself.
All the values from the dimension are automatically sorted.
| 9 Time Series | 57
A Time Slider will also appear at the bottom of the map, displaying some controls as well as
the currently displayed value.
To control the time series, you can:

• Click on the Pause/Resume button to pause or resume the time series, directly from the
time series slider
• Click on the Cancel button, that will stop the time series and hide the time series slider.
: Technically, you are not limited to select a dimension typed as "Date" by Lumira
to create a time-series. Any dimension is going to work. The Time Series can thus be
used to go across a dimension representing a category, instead of a time period.
10 Geocoding
Topics:
• Geocode Your Addresses on

the Fly
| 10 Geocoding | 60
10.1 Geocode Your Addresses on the Fly

Galigeo Discovery offers you the possibility to geocode on the fly your addresses in order to
see them on the map, and apply KPI on them.
In order to enable a geocoding, you have to match the following requirements:
• Internet connection
• Access to Galigeo Server (located in domain api.galigeo.com)
Please be aware that by default, your addresses will be sent to a remote server in order to be
geocoded. Please make sure that this workflow is compliant with the security rules in place in
your company.
If it does not fit your requirements, please contact support@galigeo.com for more details.
Before geocoding your addresses, you have to make sure they contain enough context in
order for the geocoding module to make sure they will be easily localized.
For this matter, it is recommended to create a new calculated dimensions that will
concatenate, for example:
• The street name
• The city name/zipcode/county name/region name/... (regarding what you have available)
• The country name (important)
While not mandatory, when concatenating the relevant dimensions together, it is
recommended to separate them with a comma, like in the example below.
Other characters might work as well, like white space or semicolon.
Name your newly created dimension with one of the keywords below in order for the
dimension to be detected as a dimension to be geocoded (case insensitive):
• "address", "addresses", "addr", "adresse", "adr", "customer", "anschrift",
"dirección", "direccion"
Or add the keyword "geocode" to your dimension name. (e.g.: TECH_1_geocode)
| 10 Geocoding | 61
When dragging in this dimension, Galigeo Discovery will detect it and start the geocoding
process.
If the addresses are valid and complete enough, you will see them appearing on the fly on
the map.
When using Galigeo Discovery with a trial license, you are limited to a maximum of 2000
addresses per visualization, and maximum of 10000 geocoded addresses as total.
Galigeo keep the right of modifying these threshold numbers without prior warnings.
For more information, please contact support@galigeo.com.
| 11 Flows | 62
11 Flows
Topics:
• Create Flows Between an

Origin Dimension and a
Destination Dimension
| 11 Flows | 63
11.1 Create Flows Between an Origin Dimension

and a Destination Dimension
Galigeo Discovery offers you the possibility to automatically link two dimensions and create
flows between them.
The way it works is based on semantics.
The origin dimension needs to contains one of the following patterns in its name (case
insensitive):
• "orig", "origin", "start", "from",
The destination dimension needs to contains one of the following patterns in its name (case
insensitive):
• "dest", "destination", "ship to", "shipping", "to "
If the requirements are met, flows will automatically created between the two layers.
If no Category is provided, the metrics defined in the Indicator field will be shown on the
flows by different color ranges.
If a Category is defined, it will be used to color the flows, while the metrics defined in the
Indicator field will be shown on the flows by different widths of the flows.
Flows cannot be selected themselves, but you can select either the origins or the destinations
to access filtering, etc.
Flows can be part of a custom hierarchy.
If either the origin and / or the destination are originally coming from layers made of
polygons or lines, a centroid for each geometry will be automatically generated.
| 12 Extension Export | 64
12 Extension Export
Topics: : This part is really important, following it carefully
will make sure that the whole configuration (custom
• Extension Export geodata, custom basemaps, ...) you have imported
locally on your desktop will also be available on the BI
Platform
| 12 Extension Export | 65
12.1 Extension Export

The Galigeo Discovery extension can be exported with its configuration (custom geodata,
custom basemaps, ...) to make it easy to share or install it on SAP Lumira Server (either BI
Platform or Team edition).
• To do so, open Galigeo Manager by double-clicking [Download location]\Galigeo
\GaligeoManager\galigeomanager.exe or from the shortcut you had previously created.
• Then open the File > Export extension... menu and select the location for the extension
to be saved to (e.g. C:/Users/<your_name>/My Documents).
• Install the newly exported extension to Lumira Server, using either the BI Platform CMC or
Admin Environment regarding the platform you are on.
: Technically, only one extension can be installed on Lumira Server side at a time. For
this reason, the role of deploying Galigeo Discovery extension to Lumira Server should
be taken by an IT Admin, or anyone having Admin rights on the Lumira Server, that
will make sure Galigeo Discovery configuration will cover all the needs of the Lumira
documents (*.lums) pushed to Lumira Server.
: The process described in this chapter can also be used to share a configuration
across a company department, even if the target is Lumira Desktop. For example, one
can import some custom geodata, export a new Galigeo Discovery extension using the
steps above, and then deploy the generated extension to some other Lumira Desktops.
Then all the users will have access to the previously imported geodata directly with
Galigeo Discovery, without having to import it themselves first.
| 13 Installation of Galigeo Discovery on Lumira Server for BI Platform | 66
13 Installation of Galigeo Discovery on

Lumira Server for BI Platform
Topics: : If you are using a freemium license, even if the
installation of Galigeo For Lumira Discovery on the
• Prerequisites BI PLatform will work technically speaking, you won't
• Install Galigeo Discovery be able to access its features. Please send a mail to
Extension on Lumira Server contact@galigeo.com to learn more.
for BI Platform
| 13 Installation of Galigeo Discovery on Lumira Server for BI Platform | 67
13.1 Prerequisites
• Lumira Server for BI Platform 2.0+ (all SP) must be already installed.
• You must have Administrator Rights when connecting to Lumira Server, for either BI
Platform or Team Edition.
• Your license must not be a "freemium" one
: The following steps will explain how to install Galigeo Discovery on SAP Lumira For
BusinessObjects BI Platform. If you are using SAP Lumira Server for Teams and need
assistance, please contact the Galigeo team
: Please consult the official SAP Lumira Server installation documentations for further
details.
13.2 Install Galigeo Discovery Extension on

Lumira Server for BI Platform
Log on the Central Management Console (CMC) as Administrator.
Usually, the CMC URL is located under http://<host:port>/BOE/CMC (replace host and port
by their actual values).
After being logged on, go toApplications from the drop-down.
Double-click on SAP Lumira from the list of applications.
Click on Extensions on the navigation panel that just opened.
Click on Select file input, and chose the Galigeo Discovery extension archive (logically, the
one you have exported from Galigeo Manager, see chapter 10.1).
Click on the Upload button and wait until you see the List of extensions uploaded table
being updated.
| 14 Uninstall | 68
14 Uninstall
Topics:
• Uninstalling Galigeo
Discovery
| 14 Uninstall | 69
14.1 Uninstalling Galigeo Discovery

To uninstall the extension, open the SAP Lumira Extension Manager using File >
Extensions, then click on the Uninstall button next to the Galigeo Map extension.
After the deleting confirmation message, a message will appear in red prompting for a restart
of Lumira Desktop.
: Note that the same process can be applied for SAP Lumira Server (process the same
steps than described in chapter 11.2, and click Uninstall after selecting the Galigeo
Extension). Check the official SAP Lumira Server documentations for more information.
| 15 Troubleshooting | 70
15 Troubleshooting
Topics: This chapter does aim to answer all the questions you could
have regarding the use of the product.
• Basemap not Displayed
It just gives a quick overview of the main questions (and
• Dimension not Detected as
their respective solution) that are often ask and can be solved
Geographic
directly by the user.
• Dimension Detected as
Geographic but no Data If you need further troubleshooting at any time, please send
Shown a mail at support@galigeo.com.
| 15 Troubleshooting | 71
15.1 Basemap not Displayed

Geodata are displaying finely but no basemap is shown
Several answers:
• Your access to internet is not well configured. Please check chapter 2.1. Restart Lumira
after making changes to configure your internet access.
• You are trying to reach a custom basemap you have defined in Galigeo Manager, but the
configuration is broken, or the API key (if relevant) for the basemap has expired. In this
case, go to Galigeo Manager and fix the basemap configuration, see chapter 6.2.
15.2 Dimension not Detected as Geographic

You set a dimension to the visualization that is supposed to be displayed as a geodata on the
map, but it does not appear.
Several answers:
• Make sure the geodimension(s) keyword(s) of the aforesaid geodata is(are) correctly
declared in Galigeo Manager. Please check chapter 5.2 for more information. After making
sure everything is well configured, reload the current visualization by adding, removing or
switching to another visualization and going back to see if it fixed the issue.
• Galigeo Discovery Smart Mapping engine detected and created a hierarchy on the fly. In
this case, some geodata won't automatically appear, and you will have to drill-down to
access them. Check chapter 9.2 for more information.
15.3 Dimension Detected as Geographic but no
Data Shown
A message at the bottom of the map is telling you no feature has been added to a given
layer.
• That means the dimension was detected as geographical, but there is no value that match
between the values contained in the BI dimension and the values contained in the geodata
dimension. Please check the Layer Field of the given geodata is correctly configured
in Galigeo Manager. Please check chapter 5.2 for more information. After making sure
everything is well configured, reload the current visualization by adding, removing or
switching to another visualization and going back to see if it fixed the issue.
16 Getting More Information
Topics: To make sure you do not miss any further news about Galigeo
Discovery, or other Galigeo products for SAP BI, follow
• Help Page Galigeo on:
• Support
• Twitter
• LinkedIn
• Facebook
16.1 Help Page
When using Galigeo Discovery, you can access the documentation at any time by clicking on
the Help button, symbolized by a question mark.
16.2 Support
In case you need help you can:
• Click on the Ask us anything pop-up from within Galigeo Manager (internet connection will
be required)
• If your license is not a "freemium" one, send us an e-mail at support@galigeo.com

Galigeo Lumira Discovery

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Galigeo Lumira Discovery

Uploaded by

Copyright:

Available Formats

Galigeo For Lumira Discovery

1 About this Document.......................................................4

3 Installation and Upgrade.................................................8

6 Configuring the Basemap.............................................. 28

8 Drill Down Feature........................................................ 51

8.1 Native Hierarchies....................................................................................... 52

13 Installation of Galigeo Discovery on Lumira Server for

16 Getting More Information............................................ 73

1 About this Document

1.1 Reading Conventions

1.2 Who is this Guide for

1.3 Application Description

• The Longitude/Latitude must be formatted in WGS84 (EPSG:4326), also known as GPS

3 Installation and Upgrade

• First Time Installation

3.1 First Time Installation

• Restart SAP Lumira Discovery Desktop application when prompted

3.3 Locate the Extension in Lumira

4.1 Activate the 30-Day Trial License

You can now access all features inside Galigeo Discovery.

4.2 Expired Trial License

4.3 Activate a Standard License

4.4 Checking License Details

A dialog box will open showing the license details.

5.1 Map Data from Longitude and Latitude

5.2 Add Custom Geodata

So in order to complete the configuration, as in our BI dataset the dimension is called

At the end, our configuration looks like this:

5.3 How Does it Work Inside Galigeo Discovery?

5.4 Duplicating a Standard Layer

6 Configuring the Basemap

6.1 Choose a Basemap

By default, the ESRI Light Gray basemap is already selected.

6.2 Import a Custom Basemap

The supported types of basemaps supported are:

7.2 Accessing BI Information from the Map

7.3 Customizing a Layer

7.4 Saving Customized Layers

7.5 Ranges of Color and Conditional Formatting

7.6 Proportional Symbols and Pie Charts

7.7 Unique Values

7.9 Smart Mapping Concept

7.10 Exporting a Layer to GeoJSON

8.1 Native Hierarchies

8.2 On-the-fly Hierarchies

• Create and Run a Time-

9.1 Create and Run a Time-Series

To control the time series, you can:

• Geocode Your Addresses on

10.1 Geocode Your Addresses on the Fly

• Create Flows Between an

11.1 Create Flows Between an Origin Dimension

12.1 Extension Export

13 Installation of Galigeo Discovery on

13.2 Install Galigeo Discovery Extension on

14.1 Uninstalling Galigeo Discovery

15.1 Basemap not Displayed

15.2 Dimension not Detected as Geographic

• If your license is not a "freemium" one, send us an e-mail at support@galigeo.com

You might also like