fx - CLUSTER SETTINGS

Home navigation:   NPGeoMap Properties Dialog > Dynamic Marker & Lines Layer > Cluster >

fx - CLUSTER SETTINGS

Zum deutschen Handbuch wechseln NPGeoMap

Version 2.5.84, 07.12.2017

CLUSTER SETTINGS

GENERAL CLUSTER INFO SETTINGS
MouseOver and PopUps with QlikView visualizations.

GENERAL CLUSTER SETTINGS
Object transparency and setting the source of Markers to cluster.

HEXAGON CLUSTER SETTINGS
Settings only for Hexagon Grid Cluster.

CIRCLE CLUSTER SETTINGS
Settings only for Circle Cluster.

click to expand

click to expand

cllick to exapand

cllick to exapand

The values for nearly all features may be entered as calculated formulas or variables.

For detailed information about the notation in expression editors go to chapter The fx‑editor.

CLUSTER SETTINGS

SETTING / VALUES

EXPLANATION

 

 

CLUSTER SETTINGS

General Settings for Circle and Hexagon Grid Cluster.

GENERAL CLUSTER INFO SETTINGS

MouseOver and PopUps with QlikView visualizations.

QVChart

QV object ID

ID of the QlikView object displayed in the PopUp

Fill in the ID of a QlikView object or chart (see screenshot on the right) to display it in the PopUp defined in the feature below.

Basically all QlikView visualizations can be used, however this feature is optimized for displaying QlikView charts. The only condition is that the object has to be on the same sheet and it will be displayed in the PopUp the same way and size as it is. Nonetheless you can move it far over the edge, in the background or behind an other object to hide it.

If there are PopUp Variables defined in the Expert Settings and in QlikView, the QlikView chart can also be reduced to their content before.

click to expand

click to expand

Popup

content

content displayed in the PopUp

A PopUp is a kind of dialog or a small window, that opens or "pops up" if you click on an item, for which a PopUp is defined. NPGeoMap can display text and dynamic content in a PopUp - in this case a Circle Clustermarker or a Hexagon.
The whole PopUp content can be edited with HTML.
Right in the feature QVChart above you can also add any QlikView object or chart in this PopUp. The content you add at this point will appear just above the QlikView visualization.
Use QlikView variables, fields and formulas for dynamic content
or these NPGeoMap #Hashtag Variables:

o[#Distance]
Cluster size:
Circle Clustermarker show max. height and width of the clustered area,
Hexagons show their radius

o[#UnitsFactor]
Unit is meter, kilometer (default), miles or feet - set in unitsFactor

o[#MarkerKPI]
Sums up all KPI values of the clustered Markers, set in fx‑DYNAMIC

o[#EndMarkerKPI]
Sums up all KPI values of the clustered Endmarkers, set in fx‑DYNAMIC

o[#MarkerCount]
Amount of clustered Markers
Anzahl aller aktuell innerhalb des Clusters befindlichen Marker

o[#EndMarkerCount]
Amount of clustered Endmarkers

Example:

& '#Popup=' & 'Hello World'
Example (see sceenshot):
& '#Popup=' & '[#MarkerCount] Marker'

(See details about notation in chapter fx‑editor).

 

000_warning Important: If you want to use local image files, you have to indicate the following QlikView image path:

Extensions/NPGeoMap_v2_3/images/[...]

Example with image:

& '#Popup=' & '<div style="text-align:center; background:#F0F0F0; padding:5px; border: 5px solid gray;border-radius:10px "> PopUp <br>
             <img src="Extensions/NPGeoMap_v2_3/images\flag.png" alt="Company Logo" style="align:center;width:50px;">
              </div>'

You can copy-paste this example to try it yourself!

If the feature "popupautoclose" is disabled in the Expert Settings, you may keep several PopUps open at the same time.

000_pinTip: There's a CSS file "info.css" located in the NPGeoMap Extension directory (subfolder "css"), which can be customized to define the default presentation of PopUps, MouseOvers and SketchBoxes.
(If you configure this file make sure to save a backup, when installing an NPGeoMap update - the actual file will probably be replaced.)

More information about integrating QlikView fields or formulas and further details on notation see chapter fx‑Editor.

 

click to expand

click to expand

click to expand

click to expand

MouseOver

content

Inhalt für MouseOver

MouseOver (Tooltip) for Cluster.
It appears next to the cursor, if it hovers on a Circle Clustermarker or Hexagon.
This text may contain HTML, like for example a <br> tag to set a line break. Furthermore a delay and the duration time of MouseOvers can be configured in the Expert Settings.

Use QlikView variables, fields and formulas for dynamic content
or these NPGeoMap #Hashtag Variables:

o[#Distance]
Cluster size:
Circle Clustermarker show max. height and width of the clustered area,
Hexagons show their radius

o[#UnitsFactor]
Unit is meter, kilometer (default), miles or feet - set in unitsFactor

o[#MarkerKPI]
Sums up all KPI values of the clustered Markers, set in fx‑DYNAMIC

o[#EndMarkerKPI]
Sums up all KPI values of the clustered Endmarkers, set in fx‑DYNAMIC

o[#MarkerCount]
Amount of clustered Markers
Anzahl aller aktuell innerhalb des Clusters befindlichen Marker

o[#EndMarkerCount]
Amount of clustered Endmarkers

Example:

& '#MouseOver=' & 'Hello World'
Example (see sceenshot):
& '#MouseOver=' & '[#MarkerCount] Marker'

(See details about notation in chapter fx‑editor).

 

000_warning Important: If you want to use local image files, you have to indicate the following QlikView image path:

Extensions/NPGeoMap_v2_3/images/[...]

Example with image:

& '#MouseOver=' & '<div style="text-align:center; background:#F0F0F0; padding:5px; border: 5px solid gray;border-radius:10px "> MouseOver <br>
             <img src="Extensions/NPGeoMap_v2_3/images\flag.png" alt="Company Logo" style="align:center;width:50px;">
              </div>'

You can copy-paste this example to try it yourself!

000_pinTip: There's a CSS file "info.css" located in the NPGeoMap Extension directory (subfolder "css"), which can be customized to define the default presentation of PopUps, MouseOvers and SketchBoxes.
(If you configure this file make sure to save a backup, when installing an NPGeoMap update - the actual file will probably be replaced.)

More information about integrating QlikView fields or formulas and further details on notation see chapter fx‑Editor.

 

click to expand

click to expand

click to expand

click to expand

 

 

GENERAL CLUSTER SETTINGS

Object transparency and setting the source of Markers to cluster.

Opacity

number

 transparency in percent

Transparency of the fill color for Cluster Marker in percent:

0% - colors are covering
100% - completely transparent

ClusterSource

text

Marker to cluster (default is 0)

Defines which Markers (layers) are clustered:

 0 = all Markers

 S = StartMarkers

 E = EndMarkers

 1 = first Simple Marker block

 2 = second Simple Marker block

... (and so on for all following Simple Marker blocks)

Several layers are separated by comma - no need to consider order or upper/lower case.

Example:
& '#ClusterSource=' & '0'
all Markers are clustered

& '#ClusterSource=' & 'S,1'

StartMarkers and the first Simple Marker block are clustered - all other Markers are displayed regularly

 

 

HEXAGON CLUSTER SETTINGS

Only for Hexagon Grid Cluster

ColorClass

class name/ID

calculated color class for Hexagons (default is  "EVEN_GRADIENT_COLOR")

Set the color class for Hexagons - name/ID of the class in fx-CLASSES.
Default classes are:

EVEN_GRADIENT_COLOR

EVEN_RANGE_COLOR

FIXED_RANGE_COLOR

QUANTILE_RANGE_COLOR

New custom classes can be configured easily - learn more.

ColorSource

number

source for calculating Hexagon color class (default is 0)

Source for calculating Hexagon colors.
Choose if color gradation displays the amount of clustered Markers or their summarized values.

  0 - auto (if set, values of the KPI feature, otherwise values of the color features, otherwise the amount of Markers.)
  1 - amount of Markers
  2 - number values of the color features
  3 - number values of the KPI features

The number values refer to the respective settings in the fx‑editors:
Dynamic Markers - Color% and KPI
Simple Markers - coordinates

ShowMarker

0

hide clustered Markers (default)

1

show clustered Markers

Choose if clustered Markers are hidden or if they are displayed additionally to the Hexagon Grid Cluster.

  0 - Markers are hidden (only Hexagons are visible)
  1 - Marker Layer is displayed above the Hexagon Grid Cluster

This feature is very suitable for a DrillDown, for example showing Markers if there are less than 50 selected for detailed analysis.
Another good option is to use this setting in a QlikView button, so the user can hide and unhide the Markers in addition to the Hexagon Grid.

BorderColor

color

(default is white)

Hexagon border color.

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

BorderWidth

number

(default is 1)

Hexagon border width in pixels.

 

 

CIRCLE CLUSTER SETTINGS

Only for Circle Cluster

 

The following four settings are for auto-calculation of color and size of the Circle Clustermarkers.
If not set, the Cluster Ranges beneath will be used.

CircleColorClass

class name/ID

calculated color class for Clustermarkers (default is "CLUSTER_RANGE_COLOR")

CircleSizeClass

class name/ID

calculated size class for Clustermarkers (default is "CLUSTER_RANGE_SIZE")

Set the classes for automatic calculated colors and sizes of Circle Clustermarkers - name/ID of the class in fx-CLASSES.
Default color classes are:

EVEN_GRADIENT_COLOR

EVEN_RANGE_COLOR

FIXED_RANGE_COLOR

QUANTILE_RANGE_COLOR

Default size classes are:

EVEN_GRADIENT_SIZE

EVEN_RANGE_SIZE

FIXED_RANGE_SIZE

QUANTILE_RANGE_SIZE

New custom classes can be configured easily - learn more.

CircleColorSource

number

source for calculating Clustermarker color class (default is 1)

CircleSizeSource

number

source for calculating Clustermarker size class (default is 1)

Source for calculating colors and sizes of Circle Clustermarkers.
Choose if color and size gradation displays the amount of clustered Markers or their summarized values.

  0 - auto (if set, values of the KPI feature, otherwise values of the color features, otherwise the amount of Markers.)
  1 - amount of Markers (default)
  2 - number values of the color features
  3 - number values of the KPI features

The number values refer to the respective settings in the fx‑editors:
Dynamic Markers - Color% and KPI
Simple Markers - coordinates

BorderColor

color

 border color of Clustermarkers (default is white)

Circle Clustermarker border color.
If the fixed Ranges beneath are used instead of the classes above, an individual border color for each range can be set. Otherwise this border color is the same for all Clustermarkers.

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

CLUSTER RANGE 1

If the features above are NOT set, this cluster range system is used automatically.
It works basically like a FixedRange, but is bound to five levels. Advantage over the class system is that you can set an individual border color for each range here.
Apart from that this is a historical setting due to downwards compatibility, which was extended with the new class settings above.

Range1

number

 maximum number of Markers in this range

If there is a number of Markers aggregated, between the value set in "Threshold" and the value set in this feature, they will be displayed with the Cluster Marker defined in Range1.
Further if the number of aggregated Markers is between the value set in Range1 and the value set in Range2, they will be displayed with the Cluster Marker defined in Range2 - and so on.
That's why the last range doesn't have a maximum number of aggregated Markers.

Color1

color

 fill color of the Cluster Markers in this range

Fill color of the Cluster Markers in this range.

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

BorderColor1

color

 border color of the Cluster Markers in this range

Border color of the Cluster Markers in this range.

When setting colors you can use Hex-Codes, HTML color names or RGB
Example: color red = #FF0000 or red or RGB(255, 0, 0)
(Detailed information in chapter The fx‑editor)

Image1

file path

 file path of the image displayed for Cluster Markers in this range

Instead of a colored circle you can also display a image for Cluster Markers - just fill in the file path here.
Please note that the file has to be saved within the NPGeoMap extension directory. By default the demo images are saved in the sub folder "images".

Keep in mind that all Cluster Markers, if image or not, are always labeled with the number of Markers they summed up. Therefore the image should be something where this number is still readable.

click to expand

click to expand

Size1

number

 size of the Cluster Markers in this range

Size of the Cluster Markers in this range in pixel.

Range2 - Range5

Range2 to Range5 are structured the same way.
The number of ranges cannot be changed - that means it doesn't work if blocks of range features are added. If required, you could use the FixedRange via class settings instead.