Layer Theme Editor

The Layer Theme Editor is displayed when the Edit button of the Theme column is clicked for a network object type on the GeoPlan Properties - Layers and Themes Page.

This topic describes the Layer Theme Editor, which is the dialog used to set up themes. Refer to the Managing Themes topic for more information on how to create, edit or delete GeoPlan themes.

The Layer Theme Editor allows you to change the display options for themes and contour plots for every network object and ground model on the GeoPlan Window. It consists of:

ClosedShow me

Layer Theme Editor

Every layer (object type or ground model) can have an ordered set of themes and a default theme.

A default theme, or Base Theme, is provided for each network object or ground model. It is always the last theme in the list box in the event of there being several themes for the same layer. Some additional themes may be provided for some specific layers.

Note

The Base Theme may be edited (amendments are limited) but may not be moved, disabled or deleted.

Users can create other themes, also known as Sub Themes, by using the Sub Theme Editor Pane toolbar.

Themes names/types are displayed in a list box inside the Sub Theme Manager Pane.

The current theme, whose settings are currently displayed in the Sub Theme Editor Pane is identified by the green background on the painter's palette image in front of its name.

When you start InfoWorks ICM for the first time, every layer has at least one Base Theme.

The Sub Theme Manager Pane toolbar allows you to manage themes.

Button

Description

Add

Add new sub theme. This displays a blank Sub Theme Editor Pane. Enter a name for the new sub-theme and specify the desired settings.

Delete

Deletes the current sub theme. Clicking on this button brings up a confirmation message . Click on Yes to confirm permanent deletion of the sub theme or click on No to cancel.

Move Up

Promotes the current sub theme. Clicking on this button raises the selected sub theme to the next level. You can click on this button several times to bring the sub theme up one level per click.

Move Down

Demotes the current sub-theme. Clicking on this button lowers the selected sub theme to the next level. You can click on this button several times to bring the sub theme down one level per click.

Duplicate

Copies the current sub theme. Clicking on this button creates a copy of the currently selected sub theme. The sub theme editor pane will contain the same settings as the copied sub-theme.
Enabled / Disable Theme button

Enables / disables the current sub theme. Clicking on this button shows / hides the theme so that it is / it is not displayed on the GeoPlan Window or on the Thematic Key Window. When a sub theme is disabled, its icon is greyed out with the disable icon displayed on top.

Click the button again to enable (show) the theme.

The order in which sub themes appear in the Sub Theme Manager Pane determines the order in which they are applied to the Geoplan. Please refer to the Theme Precedence topic for further details.

Settings for the currently selected theme appear on the sub theme editor pane.

Name

Name of the current theme.

Field

The field name in the dropdown list is the name in the database.

If the field selected is a choice list field (value selected from a dropdown list in the property sheet or grid view e.g. node type), the option to only show choices will be displayed. Please refer to the Creating a New Sub-Theme section of the Managing Themes topic for further details.

The list will contain simulation as well as fixed parameters if the GeoPlan has been opened to view the results of a simulation. Simulation parameters are prefixed with sim. Maximum values in addition have MAX_ as the first part of the parameter name.

The list will also contain any SQL expressions previously added using the Edit SQL functionality described below.

SQL

Use the SQL button to add and edit SQL expressions. The Expression dialog (a simplified version of the SQL Dialog - SQL Page) will be displayed. Select parameters using the Field Type and Field dropdown of the Expression Page.

Added SQL expressions will become available in the Field name dropdown list (see above).

Use the Display precision dropdown box to select the number of decimal places to be shown when displaying SQL expression results in labels.

Simulation parameters are prefixed with sim. If a second set of results is open for comparison in the same GeoPlan, the second set of simulation parameters are prefixed with sim2.

For example: sim.qnode - sim2.qnode can be used to compare nodal inflow results between two simulations.

You can use SQL expressions that return non-numeric results such as text strings and date types, and then theme on their results. For example, if there are some nodes with a system type of "other" and you use a user defined field, such as user text 1, for providing more information about them, then, if you want to highlight the nodes in the network that have this additional information, you can use the expression:

iif (user_text_1 IS NULL, system_type, user_text_1)

to select the applicable nodes, and then set the sub-theme parameters to show the applicable nodes in the network.

Note that theming using SQL expressions may not work as expected under the following circumstances:

  • Using SQL expressions that return different field types for different objects (e.g. some numbers, some strings). The correct expression type may not be identified.
  • Trying to set up SQL themes when there are no objects of the appropriate type in the network. This will assume a numeric expression type.

In either of the above cases, it may be impossible to correctly identify the return type of the SQL expression and values may be converted using a different rule than you expected (e.g. all string values become zero).

Visible Range

A visible range over which the theme is applied should be set. Depending on the visibility control type set in the General page of the Options dialog, the min and max will be zoom or scale levels.

For each, select an existing level from the drop-down list or type in a new level. If you type in a new value, the software behaviour (exact new level, closest higher level, or closest lower level picked) will rely on the settings set in the Zoom/ Scale section of the Options - General page.

Legend Control

Controls whether the current theme is to be shown in the Thematic Key Window and printed legend.

Range

The most valid range settings for your previous selections are selected by default. You can select the range settings you require if the default ones are not suitable.

Range Settings are:

Continuous. Displays objects differently based on a series of ranges of a parameter. Suitable for parameters with continually variable values, such as depth or flow.

Individual. Displays objects differently based on individual values (rather than ranged values) of a parameter. Suitable for parameters with a small number of discrete values.

Direction. Only available for 2D results fields with directional (angle) parameters such as, sim.minangle2d (Direction at first min velocity), and displays objects based on degree ranges.

Flag. This is a special case of the Individual settings where the discrete value being displayed is the data flag.

Use AutoRange - With this option checked, InfoWorks ICM automatically re-scales the values if you open a different network or simulation.

Relative Palette - InfoWorks ICM will apply the selected set of colours in the Ranged Themes Grid to the area currently being viewed on the GeoPlan. Values are automatically re-scaled when the GeoPlan zoom is changed. (Applies to Flood, Ground Model and Rainfall themes.)

Absolute Values - Removes any sign and simply uses the absolute value of the parameter. Ideal for flow or velocity to remove the effect of direction. For example, flow will be negative if it is from the downstream to upstream end of a pipe in a simulation. This negative value would probably be misleading in a theme.

Theme Nulls - Allows the user to set up a theme for field values that have not been explicitly assigned (NULL values). Ticking this box :

  • adds a #NULL row in the Ranged Themes grid.
  • adds a "bin" for #NULL value in the Draw Style Preview.
Tip

A #NULL value is a value that has not been explicitly assigned (nothing has been set in the corresponding dropdown list), and is distinctively different from a #NOT value.

Draw Style Preview

Displays a preview of the current theme for the permitted values detailed in the Value column of the Ranged Themes grid. If not all of the permitted values are shown in the preview section due to lack of space, the preview area will be outlined with dashed lines.

A cumulative frequency histogram of the theme ranges is displayed at the bottom of the preview. This may be used in conjunction with the Ranged Themes AutoScale functionality in order to select a suitable distribution.

Properties

Specifies the theme properties that are shown and customisable in the Ranged Themes grid. Property check boxes that are ticked in the Properties box will have a corresponding column in the Ranged Themes grid.

Select the desired properties for your theme.

Ranged Themes
  • Plus and minus buttons ( ) - respectively add or remove values within the range; hold the button down to add or remove multiple values. The number of ranges is displayed next to the buttons. When values are added, these are calculated according to the distribution type that has been selected (see below).
  • Value column: Either use the values automatically set up by InfoWorks ICM or fill in the values you need manually.
  • Autoscale button (Unavailable for choice lists such as node type, for example). Click to apply a different type of distribution for the values. Click on the button until the desired distribution is obtained. Use in conjunction with the cumulative frequency histogram displayed in the Draw Style Preview to select a suitable distribution. Available distribution types are:
    • Linear (default)
    • S curve
    • N curve
    • Exponential - (useful if most of the parameter values are in the low end)
    • Log - (useful if most of the parameter values are in the high end)

    For a Direction range setting, the AutoScale function automatically scales the values to provide a complete range; -180 degrees (West) through -90 degrees (South), 0 degrees (East) and 90 degrees (North) to 180 degrees (West again).

  • Fix column - Check this box to fix the value of the range to the current value. When fixed, this value will not change when the value column is scaled (When the Use AutoRange check box in Range is ticked).

    It is possible to fix/unfix all the values at once, by using the Toggle All button (see below).

    • Toggle All - click this button to turn on/ off the fix for all the values of the range at once.

    Note that the Fix column is not available for Direction ranges.

  • Available attributes - these are listed in the sections below. Use the check boxes and the dropdown boxes to set up the sub theme.
    • Auto-Theme button - this button is very similar to the Autoscale button for the Value column. It is particularly useful if you have added intermediate values by using the Plus button at the top right-hand corner of the Ranged Themes section ( buttons). Set a value for the top and bottom property settings in the grid and then click the Auto-Theme button so that the software interpolate between the low and high values to create a graduated distribution. For properties relating to colour, clicking again on this button cycles through different ways of traversing the colour space between the high and low value.

The following sections detail all the available attributes for a variety of themes:

Attribute

Description

Symbol

Check the box to use a symbol other than the default setting (circle).

Select the desired symbol for each value in the corresponding dropdown list.

Symbol size

Check the box to use a symbol size other than the default setting (60).

Select the desired size for each value in the corresponding dropdown list.

Symbol colour

Check the box to use a symbol colour other than the default setting (black).

Select the desired colour for each value in the corresponding dropdown list.

Symbol visibility (%)

Check the box to use a visibility other than the default one (100%) for the symbol.

Use the slider to control the symbol visibility for each value (Slider at the left end indicates 0% visibility whilst slider at the right end means 100% visibility).

Circles

Check the box to use circles in the theme.

Select the desired number of concentric circles for each value in the corresponding dropdown list.

You can use the Circles attribute to indicate flooding at a node on the GeoPlan Window during replays of a simulation.

Symbol font

Check the box to use a font other than the default one (Ariel) for the character symbols.

Select the desired font for each value from the dropdown list in the Choose Symbol dialog.
Symbol font character

Check the box to use symbol characters in the theme.

Select the desired character for each value from the chart in the Choose Symbol dialog.

Note

When specifying Symbol Font Characters for point objects, to prevent the 'normal' symbol being drawn at the same time as the Symbol Font Character, ensure that the Symbol box is checked, and that the symbol value is set to None.
Tip

The Auto-Theme button (see Sub Theme Editor Pane section), which is available for most of the attributes, interpolates between set low and high values for the range and generates graduated intermediate values for the values in-between.

Attribute

Description

Symbol

Check the box to use a symbol other than the default setting (None).

Select the desired symbol for each value in the corresponding dropdown list.

Symbol size

Check the box to use a symbol size other than the default setting (60).

Select the desired size for each value in the corresponding dropdown list.

Symbol colour

Check the box to use a symbol colour other than the default setting (black).

Select the desired colour for each value in the corresponding dropdown list.

Symbol visibility (%)

Check the box to use a visibility other than the default one (100%) for the symbol.

Use the slider to control the symbol visibility for each value (Slider at the left end indicates 0% visibility whilst slider at the right end means 100% visibility).

Symbol font

Check the box to use a font other than the default one (Ariel) for the character symbols.

Select the desired font for each value from the dropdown list in the Choose Symbol dialog.
Symbol font character

Check the box to use symbol characters in the theme.

Select the desired character for each value from the chart in the Choose Symbol dialog.

Line Colour

Check the box to use a line colour other than the default setting (black).

Select the desired colour for each value in the corresponding dropdown list.

Line Visibility

Check the box to use a visibility other than the default one (100%) for the line.

Use the slider to control the symbol visibility for each value.

Line Style

Check the box to use a line style other than the default setting (solid).

Select the desired style for each value in the corresponding dropdown list.

Line Width

Check the box to use a line width other than the default setting (1).

Select the desired style for each value in the corresponding dropdown list.

Arrows

Check the box to use arrows in the theme.

Select the desired number of arrows for each value in the corresponding dropdown list.

Arrow Style

To be used in conjunction with the Arrow property.

Check the box to use arrow styles in the theme.

Select the desired style (-->-- or <--->) for each value in the corresponding dropdown list.

Tip Arrow

Note that end arrows always point outwards irrespective of the sign on the arrows count. Also, when multiple end arrows are used, the heads work backwards from the line end.
Tip

The Auto-Theme button (see Sub Theme Editor Pane section), which is available for most of the attributes, interpolates between set low and high values for the range and generates graduated intermediate values for the values in-between.

Attribute

Description

Symbol

Check the box to use a symbol other than the default setting (None).

Select the desired symbol for each value in the corresponding dropdown list.

Symbol size

Check the box to use a symbol size other than the default setting (60).

Select the desired size for each value in the corresponding dropdown list.

Symbol colour

Check the box to use a symbol colour other than the default setting (black).

Select the desired colour for each value in the corresponding dropdown list.

Symbol visibility (%)

Check the box to use a visibility other than the default one (100%) for the symbol.

Use the slider to control the symbol visibility for each value (Slider at the left end indicates 0% visibility whilst slider at the right end means 100% visibility).

Symbol font

Check the box to use a font other than the default one (Ariel) for the character symbols.

Select the desired font for each value from the dropdown list in the Choose Symbol dialog.
Symbol font character

Check the box to use symbol characters in the theme.

Select the desired character for each value from the chart in the Choose Symbol dialog.

Line Colour

Check the box to use a line colour other than the default setting (black).

Select the desired colour for each value in the corresponding dropdown list.

Line Visibility

Check the box to use a visibility other than the default one (100%) for the line.

Use the slider to control the symbol visibility for each value.

Line Style

Check the box to use a line style other than the default setting (solid).

Select the desired style for each value in the corresponding dropdown list.

Line Width

Check the box to use a line width other than the default setting (1).

Select the desired style for each value in the corresponding dropdown list.

Fill Colour

Check the box to use a fill colour other than the default setting (black).

Select the desired colour for each value in the corresponding dropdown list.

Fill Visibility

Check the box to use a visibility other than the default one (100%) for the fill.

Use the slider to control the symbol visibility for each value.

Fill Style

Check the box to use a fill style other than the default setting (solid).

Select the desired style for each value in the corresponding dropdown list.
Tip

The Auto-Theme button (see Sub Theme Editor Pane section), which is available for most of the attributes, interpolates between set low and high values for the range and generates graduated intermediate values for the values in-between.

2D zones have two special themes that are provided by default:

  • Note

    Both themes are disabled by default. This is identifiable by the greyed out palette with the disabled icon () overlay in front of their name in the Sub Theme Manager Pane. To enable these themes, select them in the Sub Theme Manager Pane and click on the Enable / Disable button () on the toolbar.

    • Flow arrows or 2D arrows. This theme uses arrows with varying lengths as indicators of the velocity in a mesh element (The field mapped is 2DTriangle.sim.speed2d - speed2d) during replays of a simulation. Arrow length, line colour and visibility have been auto-themed, i.e. lowest and highest values have been set and intermediate values have been interpolated.

    • Depth or 2D triangles - this theme uses the fill colour and visibility of 2D triangles as indicators of flood depth within the triangles (The field mapped is 2DTriangle.sim.depth2d - depth2d) during replays of a simulation. Fill colour and visibility have been auto-themed.

    For 2D Zones with results, the following attributes can be used in a theme to provide, for example, arrows scaled by speed and oriented by direction.

    Attribute

    Description

    Arrow Length

    Check the box to use an arrow length other than the default setting (100).

    Select the desired length for each value from the corresponding dropdown list.

    Arrow Angle

    Check the box to use an angle for the arrow other than the default setting (0).

    Use the slider to control the arrow angle for each value.

    Tip

    When using this property with a Direction range setting, a larger the value count will provide a higher degree of accuracy when Autoscaled.
    Tip

    The Auto-Theme button (see Sub Theme Editor Pane section), which is available for most of the attributes, interpolates between set low and high values for the range and generates graduated intermediate values for the values in-between.

    Attribute

    Description

    Fill Colour

    Check the box to use a fill colour other than the default setting (black).

    Select the desired colour for each value in the corresponding dropdown list.

    Fill Style

    Check the box to use a fill style other than the default setting (solid).

    Select the desired style for each value in the corresponding dropdown list.
    Tip

    The Auto-Theme button (see Sub Theme Editor Pane section), which is available for most of the attributes, interpolates between set low and high values for the range and generates graduated intermediate values for the values in-between.

    Typical contour themes are ground model themes and flood themes.

    See Displaying a Ground Model on the GeoPlan and Displaying Flood Extents for more details, as these themes are specialised themes and may have different attributes and sources to the others themes.

    OK - Closes the dialog and applies changes.

    Cancel - Closes the dialog and does not apply any changes.

    Apply - Applies changes to the selected theme without closing the dialog.

    Help - Opens the related Help topic.

    GeoPlan Themes

    Managing Themes

    Theme Precedence

    GeoPlan Properties Dialog

    GeoPlan Properties - Layers and Themes Page

    GeoPlan Window

    Viewing Replays of the Simulation

    Displaying the Ground Model on the GeoPlan

    Displaying Flood Extents