# Graphical Encoding Options

Skip to end of metadata- restrictions.empty
- Created by Unknown User (reynard.juanir), last modified by Abraham Toribio on Nov 16, 2020

**The following section **describes the available options and parameters for graphical encoding.

## Visual Entity

Three graphical entities, colour, size and text height, are available for each of the two object types.

**Node Color**

Node color is defined in ranges using an open-ended dialog list (DLIST). A colour is selected by clicking in the appropriate field and selecting a colour from the dialog that appears. The list follows the standard rules for a DLIST.

You can insert and delete rows using the Insert and Delete keys and you can scroll through the list using the arrow keys. Any number of rows can be included in the list but only 16 colours are supported.

The data is presented in discrete stepped ranges. Data is plotted in a selected colour provided it falls within the range: Low Value < Data Value <= High Value.

The Data Range shown in this dialog shows the maximum and minimum value of the selected variable currently contained within all objects in the database.

** Suggest. **The Suggest button will break the minimum and maximum data range into 5 equal partitions and allocate a pre-determined colour to each.

**Node Size**

The node size can be used to represent the value of the data variable in one of two ways, either by an equation or by a stepwise linear function.

**By Equation**

If this option is selected the node size is defined in terms of X, where X is the variable being shown. In its simplest form the equation is size = X, however arbitrary expressions can also be built with the syntax described here. Terms in the expression can consist of:

- numeric constants
- variable names
- arithmetic operators
- pre-defined functions

The following binary arithmetic operators are supported:

+ : addition

- : subtraction

* : multiplication

/ : division

% : remainder

^ : exponentiation (raise to power)

Variables and numeric values can be used and parentheses () can also be used to any level of nesting. Expressions can be sequenced and separated by semicolons, with intermediate variables used. Variable names are alphanumeric strings and are not case-sensitive. White space (blank, tab, new line, etc) has no significance.

The following pre-defined functions are supported. These words are reserved and cannot be used as variable names:

- abs(n) - absolute value of n
- acos(x) - arc cosine of x, in radians
- asin(x) - arc sine of x, in radian
- atan(x) - arc tangent of x, in radians
- ceil(x) - smallest integer >= x
- cos(x) - cosine of x (x in radians)
- cosh(x) - hyperbolic cosine of x (x in radians)
- E10(x) - 10 raised to the power x
- exp(x) - exponential function of x
- floor(x) - largest integer <= x
- log10(x) - base-10 logarithm of x
- log(x) - natural logarithm of x
- sin(x) - sine of x (x in radians)
- sinh(x) - hyperbolic sine of x
- sqrt(x) - square root of x
- tan(h) - tangent of x (x in radians)
- tanh(h) - hyperbolic tangent of x (x in radians)
- j0(x) - bessel function of first kind, order 0
- j1(x) - bessel function of first kind, order 1
- y0(x) - bessel function of second kind, order 0
- y1(x) - bessel function of second kind, order 1
- max(x1,x2) - larger of x1 and x2
- min(x1,x2) - smaller of x1 and x2

Function arguments must be enclosed in parentheses. E.g. sin(y), not siny or sin y.

The function names are not case-sensitive. There are no user-defined functions as yet.

*Examples*: 2.5*a^2/b + 1.2*c^2/sin(d)

**By Linear Relationship**

The node size will be displayed in a stepwise linear function using the Data Value/Node Size relationship entered in the following DLIST.

Insert and delete rows by using the **Insert** and **Delete** keys and you can scroll through the list using the arrow keys. The data is presented in discrete stepped ranges. Data is plotted in a selected colour provided it falls within the range: Low Value < Data Value <= High Value. The Data Range shown in this dialog shows the maximum and minimum value of the selected variable currently contained within all objects in the database.

* Graph. *The graph button will display the data entered in the value/size DLIST as a XY graph.

**Size Interpretation **

** Display. **If this option is selected the size of the node will be in mm regardless of scale.

** Real World. **If this option is selected the node size will be displayed relative to the network scale.

**Suggest**

The Suggest button will break the minimum and maximum data range into either a linear relationship or a linear equation depending on the option selected.

**Node Label Size**

The size of the text used for the node name can be used to represent the value of the data variable in one of two ways, either by an equation or by a stepwise linear function.

**By Equation**

If this option is selected the text size is defined in terms of X, where X is the variable being shown. In its simplest form the equation is size = X, however arbitrary expressions can also be built with the syntax described here. Terms in the expression can consist of:

- numeric constants
- variable names
- arithmetic operators
- pre-defined functions

The following binary arithmetic operators are supported:

+ : addition

- : subtraction

* : multiplication

/ : division

% : remainder

^ : exponentiation (raise to power)

Variables and numeric values can be used and parentheses () can also be used to any level of nesting. Expressions can be sequenced and separated by semicolons, with intermediate variables used. Variable names are alphanumeric strings and are not case-sensitive. White space (blank, tab, new line, etc) has no significance.

The following pre-defined functions are supported. These words are reserved and cannot be used as variable names:

- abs(n) - absolute value of n
- acos(x) - arc cosine of x, in radians
- asin(x) - arc sine of x, in radian
- atan(x) - arc tangent of x, in radians
- ceil(x) - smallest integer >= x
- cos(x) - cosine of x (x in radians)
- cosh(x) - hyperbolic cosine of x (x in radians)
- E10(x) - 10 raised to the power x
- exp(x) - exponential function of x
- floor(x) - largest integer <= x
- log10(x) - base-10 logarithm of x
- log(x) - natural logarithm of x
- sin(x) - sine of x (x in radians)
- sinh(x) - hyperbolic sine of x
- sqrt(x) - square root of x
- tan(h) - tangent of x (x in radians)
- tanh(h) - hyperbolic tangent of x (x in radians)
- j0(x) - bessel function of first kind, order 0
- j1(x) - bessel function of first kind, order 1
- y0(x) - bessel function of second kind, order 0
- y1(x) - bessel function of second kind, order 1
- max(x1,x2) - larger of x1 and x2
- min(x1,x2) - smaller of x1 and x2

Function arguments must be enclosed in parentheses. e.g. sin(y), not siny or sin y.

The function names are not case-sensitive. There are no user-defined functions as yet. Examples: 2.5*a^2/b + 1.2*c^2/sin(d)

**By Linear Relationship**

The text size will be displayed in a stepwise linear function using the Data Value/Node Size relationship entered in the following DLIST.

You can insert and delete rows using the Insert and Delete keys and you can scroll through the list using the arrow keys.

The data is presented in discrete stepped ranges. Data is plotted in a selected colour provided it falls within the range: Low Value < Data Value £ High Value.

The Data Range shown in this dialog shows the maximum and minimum value of the selected variable currently contained within all objects in the database.

* Graph. *The graph button will display the data entered as an XY graph.

**Size**

** Display. **When selected the size of the text is in inches (or mm) regardless of scale.

** Real World. **When selected the text size is displayed relative to the network scale.

**Suggest**

The Suggest button will break the minimum and maximum data range into either a linear relationship or a linear equation depending on the option selected.

**Link Colour**

Link colour is defined in ranges using an open-ended dialog list (DLIST). A colour is selected by clicking in the appropriate field and selecting a colour from the dialog that appears. The list follows the standard rules for a DLIST. You can insert and delete rows using the Insert and Delete keys and you can scroll through the list using the arrow keys. Any number of rows can be included in the list but only 16 colours are supported.

The data is presented in discrete stepped ranges. Data is plotted in a selected colour provided it falls within the range: Low Value < Data Value £ High Value.

The Data Range shown in this dialog shows the maximum and minimum value of the selected variable currently contained within all objects in the database.

*Suggest*

The Suggest button will break the minimum and maximum data range into 5 equal partitions and allocate a pre-determined colour to each.

**Link Width**

The Link width can be used to represent the value of the data variable in one of two ways, either by an equation or by a stepwise linear function.

**By Equation**

If this option is selected the link width is defined in terms of X, where X is the variable being shown. In its simplest form the equation is size = X, however arbitrary expressions can also be built with the syntax described here. Terms in the expression can consist of:

- numeric constants
- variable names
- arithmetic operators
- pre-defined functions

The following binary arithmetic operators are supported:

+ : addition

- : subtraction

* : multiplication

/ : division

% : remainder

^ : exponentiation (raise to power)

Variables and numeric values can be used and parentheses () can also be used to any level of nesting. Expressions can be sequenced and separated by semicolons, with intermediate variables used. Variable names are alphanumeric strings and are not case-sensitive. White space (blank, tab, new line, etc) has no significance.

The following pre-defined functions are supported. These words are reserved and cannot be used as variable names:

- abs(n) - absolute value of n
- acos(x) - arc cosine of x, in radians
- asin(x) - arc sine of x, in radian
- atan(x) - arc tangent of x, in radians
- ceil(x) - smallest integer >= x
- cos(x) - cosine of x (x in radians)
- cosh(x) - hyperbolic cosine of x (x in radians)
- E10(x) - 10 raised to the power x
- exp(x) - exponential function of x
- floor(x) - largest integer <= x
- log10(x) - base-10 logarithm of x
- log(x) - natural logarithm of x
- sin(x) - sine of x (x in radians)
- sinh(x) - hyperbolic sine of x
- sqrt(x) - square root of x
- tan(h) - tangent of x (x in radians)
- tanh(h) - hyperbolic tangent of x (x in radians)
- j0(x) - bessel function of first kind, order 0
- j1(x) - bessel function of first kind, order 1
- y0(x) - bessel function of second kind, order 0
- y1(x) - bessel function of second kind, order 1
- max(x1,x2) - larger of x1 and x2
- min(x1,x2) - smaller of x1 and x2

Function arguments must be enclosed in parentheses. e.g. sin(y), not siny or sin y.

The function names are not case-sensitive. There are no user-defined functions as yet. Examples: 2.5*a^2/b + 1.2*c^2/sin(d)

**By Linear Relationship**

The link width will be displayed in a stepwise linear function using the Data Value/Node Size relationshhhip entered in the following DLIST.

You can insert and delete rows using the Insert and Delete keys and you can scroll through the list using the arrow keys.

The data is presented in discrete stepped ranges. Data is plotted in a selected colour provided it falls within the range: Low Value < Data Value £ High Value.

* Graph. *The graph button will display the data entered in the value/size DLIST as a XY graph.

**Size Interpretation**

* Display. *When selected the width of the link is in inches (or mm) regardless of scale.

** Real World. **If this option is selected the link width will be displayed relative to the network scale.

**Suggest**

The Suggest button will break the minimum and maximum data range into either a linear relationship or a linear equation depending on the option selected.

**Link Label Size**

The size of the text used for the link name can be used to represent the value of the data variable in one of two ways, either by an equation or by a stepwise linear function.

**By Equation**

If this option is selected, the text size is defined in terms of X, where X is the variable being shown. In its simplest form the equation is size = X, however arbitrary expressions can also be built with the syntax described here. Terms in the expression can consist of:

- numeric constants
- variable names
- arithmetic operators
- pre-defined functions

The following binary arithmetic operators are supported:

+ : addition

- : subtraction

* : multiplication

/ : division

% : remainder

^ : exponentiation (raise to power)

- abs(n) - absolute value of n
- acos(x) - arc cosine of x, in radians
- asin(x) - arc sine of x, in radian
- atan(x) - arc tangent of x, in radians
- ceil(x) - smallest integer >= x
- cos(x) - cosine of x (x in radians)
- cosh(x) - hyperbolic cosine of x (x in radians)
- E10(x) - 10 raised to the power x
- exp(x) - exponential function of x
- floor(x) - largest integer <= x
- log10(x) - base-10 logarithm of x
- log(x) - natural logarithm of x
- sin(x) - sine of x (x in radians)
- sinh(x) - hyperbolic sine of x
- sqrt(x) - square root of x
- tan(h) - tangent of x (x in radians)
- tanh(h) - hyperbolic tangent of x (x in radians)
- j0(x) - bessel function of first kind, order 0
- j1(x) - bessel function of first kind, order 1
- y0(x) - bessel function of second kind, order 0
- y1(x) - bessel function of second kind, order 1
- max(x1,x2) - larger of x1 and x2
- min(x1,x2) - smaller of x1 and x2

Function arguments must be enclosed in parentheses. e.g. sin(y), not siny or sin y.

The function names are not case-sensitive. There are no user-defined functions as yet. Examples: 2.5*a^2/b + 1.2*c^2/sin(d)

**By Linear Relationship**

The link label size will be displayed in a stepwise linear function using the Data Value/Node Size relationshhhip entered in the following DLIST.

You can insert and delete rows using the Insert and Delete keys and you can scroll through the list using the arrow keys.

* Graph. *The graph button will display the data entered in the value/size DLIST as a XY graph.

**Size Interpretation**

* Display. *When selected the width of the link is in inches (or mm) regardless of scale.

** Real World. **If this option is selected the link width will be displayed relative to the network scale.

**Suggest**

## Variable

The variable list displayed when one of these buttons is selected shows the data and results that are available for graphical encoding. If the variable selected has multiple instances (ie. Conduit 1, Conduit 2,etc.) then a combination of Variable and Instances must be selected. To show all instances of a selected variable all combinations of Variable: Instance must be selected.

## Preferences

**Hide Arrows **

This check box causes the network to be redrawn with arrowheads suppressed.

#### Fill Nodes

This check box causes the network to be shown with nodes filled with a solid fill pattern of the selected Node Color.

**Legend**

This check box allows a legend showing the graphical attributes to be shown on the network.

**Background **

Sets the background color for the selected visual entity.

**Arrange Items**

The visual entities making up the graphical encoding may be arranged in specific areas of the screen. The following options are available:

**World Coordinates**- allows you to set the location manually based on the dimensions of the model.**Screen Relative**- allows you to**Top Left, Top Right, Bottom Left,**and**Bottom Right**- allows you to set the placement of the legend window in the specified area of the screen.

**Title / Values**

Sets the Font and Color attributes for the Legend windows text content.

## Encode

Encode causes the network to be redrawn with the currently selected "Graphical Encoding" Attributes. A "G" will be displayed in the status bar area of the network window (to the left of the bottom scroll bar) indicating the current view in which the network is drawn includes graphically encoded attributes.

## Restore

This button will remove the graphical encoding attributes from the network window.

## Load

This button allows you to load a pre-defined (saved) set of graphical encoding attributes.

## Save

This button allows you to save the current attributes for re-use in this or other projects.

## Cancel

This button cancels any changes to this dialog and restores the previous network view.