Properties

Owned by graphomate Team
Last updated: Sept 30, 2020 by Stefanie Schröder (Unlicensed)

Basically, you have two possibilities to update the properties of graphomate trees: Using the Standard Properties Sheet, that shows all the parameters in a structured list or via the Additional Properties Sheet. The latter offers a more user-friendly User Interface. However, some special properties can be updated only through the Standard Properties Sheet.

The check boxes  in front of properties in the Additional Properties Sheet are used to control the visibility of elements and activation of functions. The data source to be used can only be assigned via Drag&Drop to the component or to the Additional Properties Sheet under Data Binding.

Important: By pressing the F5 key, both the range of characters as well as the Additional Properties Sheet can be reinitialized. This is sometimes necessary when changes in the Properties are not adopted directly in the character range.

Data Tab

Data Selection

For the graphomate trees two data series can be configured, which respectively have different semantics: 

  • Area Series
    The displayed nodes and their size are determined by the chosen area series.
  • Color Series
    Coloring of trees is done via the Color Series, either by directly calculating the values of the series or by first calculating the deviation from the calculated Area Series and mapping the resulting values on a color scale. The color scale can be set on the Appearance Tab and the method of calculation (direct mapping or deviation) set on the Behavior Tab.
  • Selected Source
    displays the name of the connected Data Source

In order for series to be able to be linked, a Data Source must first be selected. The series label (Series1, Series2) can be renamed via the input box and are displayed in the legend, the descriptions and Tool Tips. The blue box with the x deletes the assignment of data series.

Tree Orientation

Using the Tree Type Option, it can be used to specify whether it is a vertical, horizontal or circular tree. The nodes, links and texts are arranged according to the setting.

Link Layout

Here, you enter the Layout of the link between the nodes of the tree. The layouts curved, straight, "elbow" and cross are at disposal for selection.


Appearance Tab

Labels

Here, you select the Font Size, the Font Family as well as the Text Color of rectangular labels.

Value Format

Select the format of the Trees 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.

The resulting "Format strings" can also be set via the script language (for this, see input options for the extended number format string in the general Manual).

Colors

Use Color Scheme to set the desired color scale for a Tree. The default value is a transition from red via yellow to green. The scales hierarchy 1, 2 and 3 are particularly suitable for the representation of hierarchies. If the Invert Scheme check box is activated, the color scheme will be reversed. For example, this is useful when negative values should be represented as positive.

Use Invert Scheme to revert the chosen color scheme. If e. g. the color scheme is Red to Yellow to Green and you check Invert Scheme, it will be changed to Green to Yellow to Red.

The Infinity Color selected here is displayed when an infinite value results from the deviation calculation (e.g. due to division by 0). The Null Color set here will be displayed if no value can be derived from Color Series (e.g., when the depiction of the series is selected as calculation method although the series was not set).


Behavior Tab

Color Calculation Based On

The Color Calculation Method determines the manner in which the values of Color Series should be taken into account for the coloring of a Tree. The following values can be selected for the method:

  • Series 2
    Once the method is selected, then the values from Color Series are depicted linearly on the color scale (i.e. the greatest value is on the right-hand edge of the scale, the smallest on the left-hand edge).
  • Δ Absolute
    Once the method is selected, then the absolute deviation between the Area and Color Series is calculated; the result of the calculation is depicted linearly on the color scale.
  • Δ Percent
    Once the method is selected, then the percentage deviation between the Area and Color Series is calculated and the result is depicted on the color scale.

Hierarchy

Limit Depth to Level defines up to which depth the tree shall be initially opened.

Area Scale Method

Scale From Zero specifies whether the value 0 is used as the smallest value for scaling the node area. This prevents the node with the smallest value in the data series from being displayed as a tiny dot. Otherwise, the smallest value from the data series is used, resulting in the corresponding node being displayed as a point (with the smallest displayable area).

The Area Scale Method defines the method used for the scaling between the minimum and the maximum node size. In the case of linear scaling, the value range (minimum and maximum value from the data source) is depicted linearly on the minimum and maximum value of the node size, otherwise logarithmically. The logarithmic method allows a more pleasant, visual effect to be achieved for a very large difference within the range of values.

By changing the Min and Max Node Radius of the node radius it is possible to influence the size of the nodes as already mentioned above.


Helper Tab

Description Configuration

Area Value in Description

This setting allows you be shown the value at the node besides the identifier of the characteristic.

Padding

By using the setting for Top, Right, Bottom and Left the side margins of the trees can be configured within the space available. Through this, it can be avoided that overhangs appear, which are not drawn at runtime and they make the tree appear truncated.

Tooltips

Here, you set whether at runtime Tooltips for the user should be displayed. Tooltips are displayed when hovering directly over the node and contain the identifier and the value of the node.


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

At this point, you will find information on the used version of the graphomate trees as well as a link with which you can inform us about errors and feature desires.

Under credits, you will find an overview of the free libraries that we use.