Properties

Owned by Konradin Schoemers (Unlicensed)
Last updated: Jul 02, 2019 by Stefanie Schröder (Unlicensed)
7 min read

Basically, there are two possibilities to maintain the features of graphomate treemaps: with the Standard Properties Sheet, which lists all parameters in a structured list or with the Additional Properties Sheet. The latter provides a user-friendly interface. There are some special features, which can only be maintained on the Standard Properties Sheet.

The Checkboxes  next to the features in the Additional Properties Sheet are used to control the visibility of chart elements. The chosen Data Source can only be attributed to the component via Drag&Drop or via the Standard Properties Sheet under Data Binding.

Clicking the F5 key (Reload Application) reinitializes the canvas as well as the Additional Properties Sheet. This is sometimes necessary when changes in the properties are not directly accepted in the canvas.

Data Tab

Data Selection

For the graphomate treemaps two Data Series with different semantics can be selected:

  • Area Series:
    The size of the treemap rectangles is drawn in relation and proportional to the values of the Area Series.
  • Color Series:
    The coloring of the treemap is done with the Color Series. Either the values of the data series are mapped to a color scale directly or the deviation to the Area Series is calculated first and mapped afterwards. The color scheme can be chosen on the Appearance tab and the calculation method (direct mapping or deviation) can be set on the Behavior tab.

In order to assign the data series, a data source must be selected first. The series labels can be customized via the input box and will be displayed in the legend, descriptions and tooltips.

Click on "x" to delete the assignment of the Data Series.

Title

Enter a title for your treemap at this point. If the Checkbox is activated, the Title will be shown. Line breaks are adopted. 


Appearance Tab

Labels

Sets the appearance of the font.

Font Size

Sets the font size for the rectangle labels.

Text Color

Sets the text color for the rectangle labels.

Value Format

Select the format of the treemap values:

  • Basic:
    Select the format of the absolute and percentage values according to guidelines of numeral.js

  • Extended:
    If a fixed format is preferred, put the format for absolute and percentage values here. Choosing a “(“ in the box Negative Sign will show negative values in brackets: (1234). The parameter in the box Scaling is used as a divisor for scaling the data label. The resulting format string can also be set via scripting language.

Set the property Use Formatted Data in the Standard Properties Sheet on true to use the formatting of the Data Source.

Colors

At this point, different settings for coloring the treemap can be made:

  • Scheme:
    Change the color scheme for the treemap here. The default setting is a gradient from red to yellow to green. Especially suitable for showing hierarchies are the color scales Hierarchy1, 2 and 3.
  • Invert Scheme:
    If the Checkbox is activated, the color scheme is reversed (eg. useful if negative values are shown as positive (or vice versa))
  • Infinity:
    The color selected here will be displayed when the deviation calculation returns an infinite value (eg. division by zero).
  • Null:
    The color set here is displayed when no value can be derived from the color series (eg. if the color calculating is based on the series, but no series was assigned).



Behavior Tab

Color Calculation Based On

The Color Calculation Method determines in which way the values of the Color Series will be calculated for coloring the treemap. The following options are possible:

  • <name of the Color Series>:
    Choose this method to depict the values of the Color Series linearly on the color scale (ie, the largest value is on the right end of the scale, the lowest on the left).
  • Δ Absolute:
    Choose this method to calculate the absolute deviation between Area und Color Series; the result is depicted linearly on the color scale.
  • Hierarchy:
    Choose this method to color the treemap according to its hierarchical structure.

Formula for absolute deviation calculation:

Formula for percentual deviation calculation:

Hierarchy

The different settings here determine how the hierarchy of the treemap is displayed:

Embedded

Embedded treemaps show the hierarchy by additional frames in order to display the hierarchy level explicitly. If the Checkbox is activated, the frames are displayed and there are the following additional options:

  • Root Node Description:
    The Root Node is the root of the hierarchy, the node that is displayed as the outer frame in the embedded mode. Often this node is simply labeled as totals in the data source. At this point you can rename the label of the outer frame.
  • Top Padding:
    Set the width of the spacing between the top side of the frames and the treemap in the embedded mode at this point.
  • Rest Padding:
    Set the width of the spacing between the frames and the treemap (for the left, right and bottom side) in the embedded mode at this point.

Is the Top Padding smaller than the set font size, the description in the frame is automatically hidden.

If you want just thin frames without labels in order to make the hierarchy more legible in efficient space, you have to set both Padding values to 1.

Limit Depth

If the Checkbox is activated, the hierarchy shown is limited to a certain depth (entry in field Level). That way the treemap shows only the hierarchy from the root up to the specified depth, all other levels of the hierarchy are cut off.

Hide Overflowing Descriptions

If the Checkbox is activated, all rectangle labels, that would extend horizontally beyond the rectangle width, are hidden. Thus the treemap appears visually balanced and the focus is on the major elements.

Outer Padding

While changing the Outer Padding value the distance between the chart and the surrounding frame in Designer can be set.


Helper Tab

Legend

Here you can change the settings for the legend. In addition to the visibility (activating the Checkbox) you have the following options:

  • Area Descriptor:
    The labeling of the legend is generated from the metadata of the corresponding data series. If you want to change the labeling of Area Series, you can do it here.
  • Color Descriptor:
    Customize the labeling of the Color Series in the legend here.

Description Configuration

Here you can change the rectangle labels. The labels are showing information about the corresponding dimension member. In addition to the visibility (activating the Checkbox) you have the following options:

  • Path:
    The path shows the higher-order nodes of the hierarchy, leading to the current dimension member.
  • Name:
    This option displays the name of the dimension member.
  • Area Value:
    This option displays the name and the value for the Area Series.
  • Color Value:
    This option displays the name and the value for the Color Series (or the calculated deviation tot he Area Series). 

Tooltip Configuration

The settings in the Tooltip Configuration are analogous to those in the Description Configuration, but apply to the tooltips shown at runtime in the treemap (thus the effect of the settings in the Tooltip Configuration is not visible at design time). Possible settings are also these: Path, Name, Area Value and Color Value.


Context Menu Tab

In this tab you will be able to choose which options are available in the context menu. An activated checkbox means this options will be shown. The first checkbox enables or disables the context menu altogether. Once activated the context menu will be accessible during runtime by right clicking on the component. The active operations will be usable as follows.

Sorting

With Sorting data from the available dimensions can be sorted in ascending or descending order.

Filters

Allows you to filter the data by member for all available dimensions.

Context Sensitive Filters

Shows filters corresponding to the currently clicked dimension.

Filter and Hide

In addition to the normal filtering this operation also removes the corresponding dimension from our initial view.

Clear Filters

Resets previously set filters.

Drilldown

Adds another dimension to the component.

Drillup

Removes a dimension from the chart (this can cause an error which makes a reload neccessary).

Zero Display

Sets the way zero values are displayed.

Member Display

Lets you choose the way member names are displayed (text or key).

A reload resets all changes made with the context menu.

Position For Totals

Sets the positions for each total value per dimension to be displayed before or after other values.

Total Display

Enable or disable totals for each dimension.

Custom Events

There are 10 possible events which can be linked to your own scripts. These can be defined in the property sheet and triggered using the corresponding button in the context menu.

In the Additional Properties Sheet the names for these buttons is customizable.

All operations are executed directly on the data source, but without changing it.


Search Tab

At this point you can search for the name, function or group of a property which are displayed at the Additional Properties Sheet. The appropriate settings are then displayed directly and can be changed here.

Info Popup

Here you can find the version number of our graphomate treemaps as well as a link where you may report bugs or propose wishes for new features.

A list of all open-source libraries that we used can be found under Credits.