GIS Manager Overview Page 1 of 92

GIS manager

GIS Manager Overview

The GIS manager provides the ability to work with GIS maps within the Workbench. It offers a number
of visualization options as well as tools for spatial processing.

Similar to any other Workbench manager the GIS manager is organized around 4 different components:

- The GIS explorer that provides functionality for organizing GIS data (e.g. feature classes and
rasters)

- Map data view for visualizing spatial data

- A property control that displays properties of the selected spatial object

- And a tools explorer that contains a list of available tools for spatial processing based on the
selected spatial object.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 2 of 92

GIS manager 
Terminology
The following terminology applies:

A “Feature class” is the GIS data

holder. A feature class may be of
type point, line or polygon. A feature
class contains feature geometries and
a set of associated attributes.

Feature classes are managed using

the GIS explorer in feature class
groups.

Each feature class defines various

“attributes” such as “id” or “name1”.
The value for an attribute may vary,
and usually varies, from one feature
to another. Each row in the attribute
table represents a specific feature.

A “Feature layer” represents how a

feature class is represented in the
Map data view.

A “Feature” is a specific point, line

or polygon within a feature class that
is displayed in the map.

The “legend” is the list of feature

layers and that appears in the Map
data view. The layout of a Feature
layer is controlled by clicking a
feature layer in the legend and
modifying the feature layer properties
in the properties control.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 3 of 92

GIS manager

Organizing GIS data

GIS data are stored in the database and may be queried and organized in groups using the GIS explorer.
The GIS explorer provides access to standard explorer functionality related to organizing groups,
feature classes, and rasters.

All GIS vector data exposed in the GIS explorer are denoted “feature classes”. If a feature class is added
to a map the visualization of a feature class is denoted a “feature layer”. Grid and image based data is
exposed in the GIS explorer as “rasters”. These are added to the map as a “raster layer”.

More:

Create a new group

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 4 of 92

GIS manager > Organizing GIS data

Create a new group

Create a new group by right clicking on the

root node or an existing group, and select Add
new group from the context menu.

The new group is created as a subgroup under the

root (database) node or the group that was
selected.

Once the new group has been added it can be

renamed by right clicking on the group.
Additional functionality for copy, cut, delete and
paste groups are also available.

Shortcuts for each of these action are also

available (see context menu)

Once a group have been created it can be

populated with GIS data either by importing GIS
data or by using “Create New Feature Class….”.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 5 of 92

GIS manager

Create and Import Spatial Data

New GIS data may be created from scratch or imported using an import tool. GIS data are stored as
feature classes or rasters in the database.

More:

Create a new feature class

Import Spatial Data

Export spatial data

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 6 of 92

GIS manager > Create and Import Spatial Data 

Create a new feature class

Right-click on a Group node and

select “Create new feature class”

To create a new feature class name,

geometry type (point, line, polygon)
and projection must be defined.

Note that the Name field cannot

contain “space” or any special
characters.

Optionally an attribute fields may be

defined (default is none). In this case
a field named “Name” has been
defined as a string with length 15
characters.

Press OK to create the feature class.

A new feature class is now added to

the GIS explorer under the selected
group (or root).

In order to create new features in the

feature class first add the (empty)
feature class to an Active map or to
a New Map. 

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 7 of 92

GIS manager > Create and Import Spatial Data

Import Spatial Data

Feature classes can be created in the

database using an import tool.

To activate the import tool first click

on the database node in the GIS
explorer.

In the Tools Explorer choose the

import tool that you want.

If pressing “Run” on the tool property

dialogue, a window will appear
assisting the input specifications.

Please refer to the section “GIS Tools

for vector data” for further details on
the individual import tools.

Raster data can be imported in a

similar manner to feature classes. To
activate import tools for raster data,
click on the raster database to select it.

The raster import tools will then

appear in the Tools Explorer. Press
“Run” on the tool property dialog to
display the import window.

Please refer to the section “GIS Tools

for raster data” for further details on
the individual import tools.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 8 of 92

GIS manager > Create and Import Spatial Data

Export spatial data

Feature classes can be exported to a

file using an export tool.

To activate the export tool simply

click on the feature class to be
exported,

In the Tools Explorer choose the

export tool that you want.

Please refer to the section “GIS Tools

for vector data” for further detail on
the individual export tools.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 9 of 92

GIS manager

Working with the Map data view

The map data view provides functionality for navigation and layout. All navigations options are
available in the toolbar in the top of the GIS data view and layout options are available through the
property control. Some examples on Map view functionality is provided below.

More:

Adding data to a Map data view

Map navigation and properties

Map Layout options (vector data)

Map Layout options (raster data)

Adding Charts to a map

Selecting Features

Selecting features using spatial query tools

Selecting features by querying by Attributes

Saving Selected features in a new feature class

Saving raster data

Zonal statistics tool strip

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 10 of 92

GIS manager > Working with the Map data view

Adding data to a Map data view

To add new data to a map view right-

click on a feature class or raster and
choose “Add to New Map…” from the
context menu.

To add more data to an existing map

data view choose “Add to active
map…”

Feature classes are now visualized as

feature layers in the Map data view
with a predefined simple style.

Rasters are added to a raster layer

using a simple gradient fill style.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 11 of 92

GIS manager > Working with the Map data view 

Map navigation and properties

Basic navigation functionality such

as zoom in and out, pan is located
in the Map data view toolbar.

The “Select object” mode allows

for choosing objects such as the
map data view itself or the feature
layer legend.
Clicking somewhere on the map
data view displays the general Map
properties.

These allows for modifying back-

ground color, adding titles, scales,
north arrow and display some of
the non-editable map properties
(e.g. coordinate system).

Clicking on a Feature layer in the

legend displays the associated
properties of that particular feature
layer including the styles to use
when drawing the feature layer.

Each style provides various

options for changing the
appearance of how a feature class
is displayed including layout, color
coding, text labeling etc

Please refer to “Map Layout

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 12 of 92

GIS manager > Working with the Map data view 

Map Layout options (vector data)

Feature classes may be presented in

the map data view using feature class
attribute values to create different
types of color scales and legends.

To modify the appearance of a feature

layer click select the relevant legend
in the map data view

The associated property dialogue

provides a number of options for
changing the appearance of a feature
layer.

The “style type” contains a list of

different feature layer styles

Clicking the Map data view provides a

limited number of general map
options such as “North arrow”,
“Scale” and “Title”.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 13 of 92

GIS manager > Working with the Map data view 

Map Layout options (raster data)

Grid type rasters are displayed using a

gradient fill based on the value of the
raster pixels. Image rasters are
automatically displayed using the
color values for each pixel.

You can modify the colors and value

range used to display grid type rasters.
Image rasters cannot be modified. To
modify a grid type raster, click on the
layer name in the legend.

The associated property dialogue

provides a number of options for
changing the appearance of a raster
layer. Expand the Layer Style node to
see all the options.

You can quickly select a preset

gradient by choosing one of the pre-
defined raster pallets.

If you want more control over the

gradient colors, you can set the lower
value color and upper value color
directly. In addition, you can set the
upper and lower values to be used to
control what range the gradient will
span.

Finally, you can set the transparency

of the raster so that you can view
other rasters “underneath” the top 
layer raster.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 14 of 92

GIS manager > Working with the Map data view

Adding Charts to a map

Pending Pending
Pending Pending

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 15 of 92

GIS manager > Working with the Map data view

Selecting Features

Click “Select features” in the toolbar.

Select features by clicking on the map.

Note that only features on the “active
layer” can be selected (here Ethiopia is
selected).

Multiple features can be selected by

holding SHIFT key when clicking on
features or by dragging the mouse
while clicking for draw a rectangle.
All features intersecting the rectangle
will be selected.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 16 of 92

GIS manager > Working with the Map data view 

Selecting features using spatial query tools

Different spatial query tools are

available. The spatial query menu
entry is enabled if one or more
features have been selected.

All spatial query tools require that a

“selection layer” is defined. The
selection layer contains features to
be selected using a spatial query.
E.g. a query could be “find dams
located within Ethiopia”. This query
would require:

1: the feature “Ethiopia” is selected

in the feature class “Countries”

2: The feature class “Dams” is used

as “selection layer”.
The result would be as illustrated in
the graphics.

If the attribute data table is open

during a spatial query the selected
features will be highlighted in the
table view as well as on the map.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 17 of 92

GIS manager > Working with the Map data view 

Selecting features by querying by Attributes

To query features by
attributes, start by setting the
active layer.

The attribute query tool is

found in the Query drop-
down list.

Example 1:

This query selects all

features where attribute
“name1_” starts with the
letter “E”.

Example 2:

This query selects all

features with attribute “area”
between 100,000 and
400,000.

The result of the above

query on a specific feature
class is illustrated to the
right.

Note that map view and data

table are synchronized.


Note that the two queries in

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 18 of 92

GIS manager > Working with the Map data view

Saving Selected features in a new feature class

If individual features have been

selected in the map, either using the
selection tool or using spatial or
attribute query tools, the selected
features may be saved in a new feature
class.

Use the “To database” tool to save the

selected features to a new feature
class.

See “To database” tool for further

details.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 19 of 92

GIS manager > Working with the Map data view

Saving raster data

If you create a new raster using a tool

such as the raster interpolation tools
(see GIS Tools for vector data
processing below), you can save this
to the database.
First, select the raster layer you
created by clicking on its name in the
legend.

Then, select and run the To Database

tool in the Tools Explorer.

This will permanently save the raster

to the raster database.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 20 of 92

GIS manager > Working with the Map data view 

Zonal statistics tool strip

The zonal statistics tools allow you

to calculate basic statistics about the
grid cell values in a raster within a
specific area.

There are two options to define the

area, you can define the area by
drawing a polygon on the screen, or
you can select a feature.

To calculate zonal statistics, the

raster layer must be selected in the
legend.
When selecting Zonal Statistics by
Polygon, draw the polygon on the
screen over the raster by clicking.
To finish the polygon, double-click.

To calculate statistics within a

polygon feature, the feature layer
you want to select from must be the
active layer, and the raster layer
must be selected in the legend.

Click on the feature you want to

calculate statistics for.

The zonal statistics will be

displayed in the Properties dialog. 

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 21 of 92

GIS manager

Editing GIS data

Various on-screen editing functionality are available for modifying or adding features. Basic editing
functionality is described below.

More:

Editing feature geometry

Adding features to a feature class

Editing feature attribute values

Edit feature class attribute fields

Clip features

Erase features

Split features

Merge features

Catchment Delineation

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 22 of 92

GIS manager > Editing GIS data 

Editing feature geometry

The geometry of GIS feature classes

(vector data) can be edited using on-
screen editing functionality.

All editing functionality is available

through the edit toolstrip which can
be enabled in the data view setting
setting list.

To edit a feature class first select the

“active layer” from the pull-down
menu. In the example two feature
classes are added to the Map View
and the feature class “Countries” are
selected as active layer

In order to edit first bring the active

layer in “Edit mode” by selecting
the Start Editing button.

During editing you may save edits

using the “Save edits” button

Once editing is complete the edit

process is terminated using the
“Stop editing” button.

If current edit session has edit, when

stop editing user is asked whether to
save the edits.

Editing is done on the map by

selecting (clicking) and
subsequently modifying individual
features.

To modify existing features click 

“Edit features” (this is the selected

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 23 of 92

GIS manager > Editing GIS data

Adding features to a feature class

Choose “Sketch new feature” to add

new features to the feature class.

Sketch the feature by adding

individual points and finish by double-
click.

Press “Stop editing” to save edits and

leave Edit mode.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 24 of 92

GIS manager > Editing GIS data 

Editing feature attribute values

Feature class attributes can be edited

using a Data table view.

To activate the data table right click

on a feature and select “Add to data
table …”

Attribute values can be edited

directly in the data view. Once a
field is edited changes are saved
using the “Save” button.

The table data view contains

functionality for undo-redo (until
last save) for cutting and pasting
and for sorting and printing.

Attribute values can be copied and

pasted into the spreadsheets
(spreadsheet manager or excel)
where data can be manipulated and
pasted back into the data table.

Synchronized attribute table and

map selection.

Multi select by “shift + click”

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 25 of 92

GIS manager > Editing GIS data

Edit feature class attribute fields

Attributes can be added to a feature

class or removed from a feature class
attribute table.

To edit attributes select a feature class

and choose “Edit attributes” from the
context menu.

Add or remove attribute fields as

desired.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 26 of 92

GIS manager > Editing GIS data

Clip features

Clip features remove everything

located outside a user specified region.

To use Clip features select the active

layer and press the “Edit”

Digitize the region on the map and end

by “double click”.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 27 of 92

GIS manager > Editing GIS data

Erase features

Erase features remove everything

located within a user specified region.

To use Erase features select the active

layer and press the “Start editing”
button.

Digitize the region on the map and end

by “double click”.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 28 of 92

GIS manager > Editing GIS data

Split features

Split features splits any features along

a user defined line.

To use Split features select the active

layer and press the “start editing”
button.

Digitize the split line on the map. End

by double click.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 29 of 92

GIS manager > Editing GIS data 

Merge features

Merge features combines two or

more selected features into one
feature.

To use merge features select the

active layer and press the “start
editing” button.
Select features to be merged using
any othe selection methods
described previsouly. Multi select
by “shift+click”.

Choose Merge features.

Attributes for one of the selected

features will be assigned to the new
(merged) feature. Select the feature
holding the attributes to be used for
the merged feature.


file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 30 of 92

GIS manager > Editing GIS data 

Catchment Delineation

You can delineate catchments and

trace rivers using a raster
representing elevation values (called
a digital elevation map, or DEM).
First, add the DEM to the map, and
select the DEM layer from in the
catchment delineation toolbar.

Once you have selected the DEM,

the catchment delineation engine
(program) will be initialized. This
can take several minutes for larger
DEMs.

Once the initialization is complete,

two new layers will be added to the
map to display the rivers and
catchments that will be delineated
from the DEM. These are named
after the DEM layer with the words
“Rivers” and “Catchments” added
to them.
Click on the Trace River toolstrip
tool.

On the map data view click at the

upstream end of the river you want
to trace. This will add a river to the
river feature class.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 31 of 92

GIS manager

Projections

The projection of a feature class is defined during import, and the feature class will be stored in the
specified projection (see Import tools).

When a feature class is opened in a Map data view, it will however be reprojected to a common
projection such that the user will not have to handle feature layers of different projections in the same
map. This “common projection” is a user setting which is set in the System manager.

More:

Changing the user projection

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 32 of 92

GIS manager > Projections

Changing the user projection

To change the user projection,

open the System Explorer,
right click on a user and
select Edit from the context
menu.

The User profile data view

opens.

The Coordinate system

setting defines the projection
all feature layers will be
displayed in when opened in a
map view.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 33 of 92

GIS manager

WMS WFS Services

The GIS Manager can display WMS and WFS layers on a map, combined with the feature and raster
layers that you have access to from a database. This allows you to compose a map showing eg: rainfall
station locations from a database, overlaid on a WMS map of the topography that is hosted on a WMS
server.

The following section details how to add a WFS service to the GIS Manager, display a WFS layer on
the map, and delete the WFS service. The same approach is used for WMS layers.

More:

Add a new WFS service

Delete a WFS service

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 34 of 92

GIS manager > WMS WFS Services 

Add a new WFS service

Right click on the WFS

node in the Service group
of the GIS Manager
Explorer, and select Add
new service.

Supply a preferred name

and the URL to the input
dialog

A list of available layers

will be provided in the
explorer

Set the view projection to 

WGS 84, by selecting the

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 35 of 92

GIS manager > WMS WFS Services

Delete a WFS service

Right-click on the WFS

service in the GIS Explorer,
choose Delete from the
context menu.

The WFS service is deleted.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 36 of 92

GIS manager

GIS Tools for vector data processing

The following tools are available for GIS vector data:

More:

Import Tools

Export and Output Tools

Geo processing tools (vector data)

Raster Interpolation

Raster Processing

Temporal Tools

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 37 of 92

GIS manager > GIS Tools for vector data processing

Import Tools

The following tools are available for importing vector data to a feature class.

More:

Import from ASCII file

Import from KLM file

Import from Res11 file

Import from shape file

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 38 of 92

GIS manager > GIS Tools for vector data processing > Import Tools

Import from ASCII file

Description This tool imports point features from an ASCII file.

Input items An ASCII file stored on the file system.
Tool properties
Output items A feature class stored in the database.
Technical reference The tool reads point data stored in an ASCII file formatted as:
and usage tips

X, Y, attribute_1, attribute_2, …, attribute_n

Xvalue_1, Yvalue_1, value_11, value_12, …, value_1n

Xvalue_m, Yvalue_m, value_m1, value_m2, …, value_mn

Where the first line is the header of the file with the names of the attributes
and data starts from the second line.

Further note that:

- If a line starts with “;” or “#” it shall be ignored

- X and Y may be located in different columns but are always named X and Y. Hence, the name
is used to locate the columns containing X and Y coordinates

- Z values can be specified in a column named “Z”

- The following types of attributes are supported: bool, int, double, string

o Attribute type is auto-detected by attempting parsing in the order: bool, int, double.
The 1st one accepted by the parser is used.

o If none of the above can be used type “string” is assumed

o Different rows may contain different attribute types. Hence, the above is done on a
row-by-row basis.

API reference DHI.Solutions.GISManager.UI.Tools.ASCIIFileImportTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Import from ASCII file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 39 of 92

GIS manager > GIS Tools for vector data processing > Import Tools

Import from KLM file

Description This tool imports features from a KLM file.

Input items An KLM file stored on the file system.
Tool properties · Name of feature class including the group path (see below)

· Path to KML file on the file system.

Output items A feature class stored in the database.

Technical reference
and usage tips
The tool imports a standard KLM file where a feature class is defined. It is
not possible to use the tool in cases where features in KML file are loosely
defined in a way that attributes are not shared or features are a mix of points
and/or lines and/or polygons.

API reference DHI.Solutions.GISManager.UI.Tools.KMLFileImportTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Import from KML file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 40 of 92

GIS manager > GIS Tools for vector data processing > Import Tools

Import from Res11 file

Description This tool imports res11 data. It imports the network as GIS data and the time
series data as time series associated to the GIS features.Res11 files can only
be imported if the projection is already defined in the DSS. Otherwise, add
the projection mapping to ESRIProjections.txt file in the application folder.
Input items An res11 file stored on the file system.
Tool properties · Name of feature class including the group path (see below)

· Path to res11 file on the file system.

Output items A feature class stored in the database.

Technical reference
and usage tips
API reference DHI.Solutions.GISManager.UI.Tools.Res11ImportTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Import from Res11 file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 41 of 92

GIS manager > GIS Tools for vector data processing > Import Tools

Import from shape file

Description This tool imports features from a shape file stored on the file system and
creates a feature class in the database.
Input items A shape file stored on the file system.
Tool properties

Feature Class: holds the group and feature class name as it will appear in
the database after import.

File Path: holds the file path to the source shape file.

Coordinate System: If a prj-file is available the coordinate system will be

added automatically. If a prj-file is not available the user must identify the
source file coordinate system on import (from a pull down with a list of
coordinate systems known to the MIKE Workbench).

Output items A feature class stored in the database.

Technical reference As an alternative to specify input data in the property dialogue you may
and usage tips simply press “Run” in the Tool property dialogue. This brings up a user
interface that supports the data load process.

API reference DHI.Solutions.GISManager.UI.Tools.ShapeFileImportTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Import from shape file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 42 of 92

GIS manager > GIS Tools for vector data processing

Export and Output Tools

The following tools are available for exporting data to the file system or for creating different types of
outputs.

More:

Export to KLM file

Export to shape file

To Database

To Table

To Display

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 43 of 92

GIS manager > GIS Tools for vector data processing > Export and Output Tools

Export to KLM file

Description This tool exports a feature class to a KML file.

Input items A selected feature class stored in the database
Tool properties File system path for KML file storage.

Output items A KML file saved on the file system.

Technical reference
and usage tips
None.

API reference DHI.Solutions.GISManager.Tools.KMLFileExportTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Export to KML file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 44 of 92

GIS manager > GIS Tools for vector data processing > Export and Output Tools

Export to shape file

Description This tool exports a feature class to a shape file.

Input items A selected feature class stored in the database
Tool properties File system path for shape file storage.

Output items Shape file saved on the file system.

Technical reference
and usage tips
The tool exports to a standard shape file (dbf, prj, shp and shx) as illustrated
below.

API reference DHI.Solutions.GISManager.Tools.ShapeFileExportTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Export to shape file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 45 of 92

GIS manager > GIS Tools for vector data processing > Export and Output Tools 
To Database

Description The “To Database” tool stores an in memory feature class to the database.
Input items A selected feature class (or selected features in a feature class)
Tool properties

Duplicate Name option: The option in case a feature class with the same
name already exists under the same group. Replace the existing feature
class, rename the feature class being saved or don't save the feature class.

Feature Class Group: The group under which the feature class is saved.

Feature Class Name: The name of the feature class to be saved. (Only
available if naming option is “By Name”).

GIS Data Provider: The GIS data provider to use to save the feature class.

Name Postfix: The postfix to add to the name of the feature class when
saving. (Only available if naming option is “By Postfix”).

Naming Option: The option to define the name of the saved feature class.
If Name is selected, the feature class will be saved with the name provided
in the Feature Class Name property. Otherwise, if Postfix is selected, the
postfix to add to the input feature class name(s) shall be provided.
Output items A feature class stored in the database
Technical reference All GIS tools produces memory objects (feature classes stored in
and usage tips memory). To store these memory objects in the database the “To
Database” tool must be used.

If query tools have been used to select specific features within a feature
class these may be stored in a new feature class using the “To Database”
tool. 

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 46 of 92

GIS manager > GIS Tools for vector data processing > Export and Output Tools

To Table

Description The “To Table” tool adds the attribute table to a table data view.
Input items A feature class
Tool properties The tool has no settings
Output items A table data view with feature class attribute values
Technical reference
and usage tips
API reference DHI.Solutions.Generic.UI.Tools.ToTable
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘To table’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 47 of 92

GIS manager > GIS Tools for vector data processing > Export and Output Tools

To Display

Description The “To Display” tool adds a feature class to a “New map” or to the “Active
map”.
Input items A feature class to be displayed on the map as a feature layer.
Tool properties

Action: “NewDataView” adds the output feature layer to a new map.

“ActiveDataView” adds the output feature layer to the active map.

Output: Identifies the visualizer. Currently always ThinkGeo, but more

visualizers (e.g. ArcMap) may be added in the future.

Output items A feature layer added to the Map data view

Technical reference When running GIS processing tools they always run either “to Display” or
and usage tips “to Table”. Note that the current “Action” setting for the “To Display” tool
will be used when using “To Display” from other GIS tools.
API reference DHI.Solutions.GISManager.Tools.ToDisplayTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘To display’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 48 of 92

GIS manager > GIS Tools for vector data processing

Geo processing tools (vector data)

The following tools are available for processing feature classes.

More:

Dissolve feature class

Intersect feature classes

Measure

Merge feature classes

Union feature classes

Buffer

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 49 of 92

GIS manager > GIS Tools for vector data processing > Geo processing tools (vector data)

Dissolve feature class

Description Combines multiple polygons with identical attribute values (user selected
attribute) into a single feature.
Input items One feature class of type point, line or polygon.
Tool properties

Attribute : the attribute to be used for dissolving the feature class

GIS processor: defaults settings always apply.

Output items A feature class holding dissolved features.

Technical All features with the same value for the selected “dissolve” attribute will be
reference and combined into one feature.
usage tips
API reference DHI.Solutions.GISManager.Tools.DissolveTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Dissolve Feature Class’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 50 of 92

GIS manager > GIS Tools for vector data processing > Geo processing tools (vector data)

Intersect feature classes

Description The intersect tool creates a geometric intersection of two input feature
classes. Only the features, or portions of features, which overlap in all input
feature classes will be written to the output feature class. Attributes from all
input features are mapped to all output features.

Input items Two feature classes of type polygon.

Tool properties

Name of Intersection feature class: the name of the output feature class
(memory object).

GIS processor: defaults settings always apply.

Output items One feature class containing all intersecting features with attributes from all
input features.
Technical Reference
and usage tips
API reference DHI.Solutions.GISManager.Tools.IntersectTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Intersect Feature Classes’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 51 of 92

GIS manager > GIS Tools for vector data processing > Geo processing tools (vector data)

Measure

Description Adds the attributes “area” and “perimeter” to a polygon feature class or
attribute “length” to a line feature class
Input items One feature class of type “polygon” or line
Tool properties

Unit: the unit to be used in calculations.

Output items A feature class (in memory) with attributes added.

Technical reference If attributes with names “area”, “perimeter” or “length” are already in the
and Usage tips input feature class they will be overwritten.
API reference DHI.Solutions.GISManager.Tools.MeasureTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Measure’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 52 of 92

GIS manager > GIS Tools for vector data processing > Geo processing tools (vector data) 
Merge feature classes

Description The merge tool combines two feature classes into one new feature class.

All features from both input feature classes are added to the output feature
class (including overlapping features). Feature geometries are not changed
by the merge tool.
Input items Two feature classes of same type.
Tool properties

Attribute Mapping:Attributes will be kept as in the Master Feature Class.

Attributes from other feature classes can be mapped to the master feature
class attributes as indicated above. No selection means “no attribute
mapping”.

Feature Class Name:The name of the output feature class (in memory
object).

Master Feature Class: attributes from other input feature classes will be
mapped to the attributes of the Master Feature Class (hence above the
Master attributes are the left ones)

Output items A feature class (in memory). To save use the “To database” tool.
Usage tips

The merge tool combines two feature classes into one new feature class.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 53 of 92

GIS manager > GIS Tools for vector data processing > Geo processing tools (vector data)

Union feature classes

Description The Union tool creates a geometric intersection of the input feature classes.
All overlapping and non-overlapping features will be written to the output
feature class.
Input items Two or more feature classes of type polygon
Tool properties
Output items One feature class containing the union of input feature classes
Technical reference The tool functioning is illustrated by the graphics below. Input contains 3
and usage tips different feature classes. Feature class 1 and feature class 2 both contains
attribute “A”. Feature class 3 contains attribute B. The union tool would
create 8 new features holding attributes as outlined in the graphics.

API reference DHI.Solutions.GISManager.Tools.UnionTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Union Feature Classes’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 54 of 92

GIS manager > GIS Tools for vector data processing > Geo processing tools (vector data)

Buffer

Description The buffer tool creates a buffer surrounding one or more selected features
within the same feature class.
Input items A feature class with one or more selected features of type point, line or
polygon.
Tool properties

Distance: the buffer (distance) to be created around selected feature

GIS Processor: default setting is always applicable

Unit: applied unit

Output items A feature class (in memory) containing the buffer delineation
Technical reference Run “To display” to visualize with the source map. Use display option
and usage tips “ActiveDataView” to overlay on the active map.

Use the “To database” tool to store the feature class in the database.

API reference DHI.Solutions.GISManager.Tools.BufferTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Buffer’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 55 of 92

GIS manager > GIS Tools for vector data processing

Raster Interpolation

The following tools are available for interpolating rasters from vector point data.

More:

Flood Map Interpolation

Inverse Distance Weighting Interpolation

Kriging Interpolation

Nearest Neighbour Interpolation

Radial Basis Interpolation

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 56 of 92

GIS manager > GIS Tools for vector data processing > Raster Interpolation

Flood Map Interpolation

Description The flood map interpolation tool.

Input items One raster or feature class.
Tool properties

Output items A raster representing the flood interpolation.

Technical
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.FloodMapInterpolationTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Flood Map InterpolationTool’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 57 of 92

GIS manager > GIS Tools for vector data processing > Raster Interpolation 
Inverse Distance Weighting Interpolation

Description This tool interpolates point data producing a raster with values given by the
specified attribute of the input point feature class. The tool uses the Inverse
Distance Weighted algorithm which assigns to every grid cell the weighted
combination of the in neighboring points. The weights are computed using the
inverse distance. Selection of the points and method the combination of the
values is done using modified Shepard method for non-uniform datasets.
Input items A raster or a feature class.One feature class of type point or a selection of
point features.
Tool properties

Attribute: the attribute to get values for the points to use in the interpolation

Extrapolate values: If true, interpolated values are used even in case where
they are bigger than maximum input value or smaller than minimum input
value. Otherwise maximum and minimum values are used respectively.

Raster definition: The output definition of the raster, consisting of:

Coordinate System: the output coordinate system (set by the system to

the user coordinate system).

Height: the number of cells vertically

Scale X: the size of the cells in the X-direction

Scale Y: the size of the cells in the Y-direction (enter as a negative

number)

Skew X: the rotation parameter in the X-direction (zero for no rotation)

Skew Y: the rotation parameter in the Y-direction (zero for no rotation) 

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 58 of 92

GIS manager > GIS Tools for vector data processing > Raster Interpolation 
Kriging Interpolation

Description This tool interpolates point data producing a raster with values given by the
specified attribute of the input point feature class using the kriging algorithm
which assigns to every grid cell a value calculated using the simple kriging
method with specified covariance method. The interpolated values are
computed using linear regression of input values.
Input items One feature class of type point or a selection of point features.
Tool properties

Attribute: the attribute to get values for the points to use in the interpolation

Covariance Type: The covariance type to use to compute covariance of the

values in two points using the scaled distance between points.

Extrapolate values: If true, interpolated values are used even in case where
they are bigger than maximum input value or smaller than minimum input
value. Otherwise maximum and minimum values are used respectively.

Missing Value: The value to use when the distance to the closest point is
bigger than radius.

Raster Definition: The output definition of the raster. See Inverse Distance
Weighted Interpolation for more detail on these parameters.

Raster Processor: The raster processor to use when executing the tool.
PostGIS Raster Processor is the default processor. Other processors can be
added and used by the tool.

Relative Scaling Factor: The scaling factor to normalize point distances

(typically 1).

Output items A raster representing the kriging interpolated values.

Technical Simple kriging is used which relies on a covariance function rather than an
reference and empirically derived variogram.
usage tips
API reference DHI.Solutions.GISManager.Tools.KrigingInterpolationTool 
Scripting the To create an instance of the tool in the scripting environment use

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 59 of 92

GIS manager > GIS Tools for vector data processing > Raster Interpolation

Nearest Neighbour Interpolation

Description This tool interpolates point data producing a raster with values given by the
specified attribute of the input feature class using the nearest neighbour
algorithm which assigns to every grid cell the value in the closest input point.
Input items One feature class of type point or a selection of point features.
Tool properties

Attribute: the attribute to get values for the points to use in the interpolation

Missing Value: The value to use when the distance to the closest point is bigger
than radius.

Radius: The value for the maximum radius to the closest point so it's value is
used in the interpolation. -1 means infinite radius.

Raster Definition: The output definition of the raster. See Inverse Distance
Weighted Interpolation for more detail on these parameters.

Raster Processor: The raster processor to use when executing the tool. PostGIS
Raster Processor is the default processor. Other processors can be added and
used by the tool.

Output items A raster representing the nearest neighbor interpolated values.

Technical DK-tree structure of the input points are used to provide best performance.
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.NearestNeighbourTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Nearest Neighbour Interpolation’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 60 of 92

GIS manager > GIS Tools for vector data processing > Raster Interpolation 
Radial Basis Interpolation

Description This tool interpolates point data producing a raster with values given by the
specified attribute of the input point feature class using the radial basis
algorithm which assigns to every grid cell a value calculated using a real-
valued function whose value depends only on the distance from the origin f(x)
= f(||x||) or alternatively on the distance from some other point c, called a
center f(x) = f(||x - c||) . Any function that satisfies the property is a radial
function. Radial basis functions are typically used to build up function
approximations

approximating function y(x) is represented as a sum of N radial basis

functions, each associated with a different center xi, and weighted by an
appropriate coefficient wi
Input items One feature class of type point or a selection of point features.
Tool properties

Attribute: the attribute to get values for the points to use in the interpolation

Extrapolate Value: If true, interpolated values are used even in case where
they are bigger than maximum input value or smaller than minimum input
value. Otherwise maximum and minimum values are used respectively.

Radial Basis Function: The radial basis function to use to compute

approximation functions.

Raster Definition: The output definition of the raster. See Inverse Distance
Weighted Interpolation for more detail on these parameters.

Raster Processor: The raster processor to use when executing the tool.
PostGIS Raster Processor is the default processor. Other processors can be
added and used by the tool.

Output items A raster representing the radial basis interpolated values.

Technical
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.RadialBasisInterpolationTool 
Scripting the To create an instance of the tool in the scripting environment use

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 61 of 92

GIS manager > GIS Tools for vector data processing

Raster Processing

The following tools are available for raster processing based on vector data.

More:

Vector to Raster

Zonal Statistics

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 62 of 92

GIS manager > GIS Tools for vector data processing > Raster Processing 
Vector to Raster

Description This tool converts a feature class to a raster using attribute values for each of
the features in the feature class to fill in the raster.
Input items One feature class or set of selected features.
Tool properties

Attribute: The attribute to get values to fill in the raster.

Missing Value: The value to use when data is missing.

Raster definition: The output definition of the raster, consisting of:

Coordinate System: the output coordinate system (set by the system to

the user coordinate system).

Height: the number of cells vertically

Scale X: the size of the cells in the X-direction

Scale Y: the size of the cells in the Y-direction (enter as a negative

number)

Skew X: the rotation parameter in the X-direction (zero for no rotation)

Skew Y: the rotation parameter in the Y-direction (zero for no rotation)

Upper Left X: the X-coordinate for the upper left corner of the raster

Upper Left Y: the Y-coordinate for the upper left corner of the raster

Width: the number of cells horizontally

Raster processor: The raster processor to use when executing the tool.
PostGIS Raster Processor is the default processor. Other processors can be
added and used by the tool.

Output items A raster representing values of the attribute for each input feature.
Technical
reference and
None.

usage tips

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 63 of 92

GIS manager > GIS Tools for vector data processing > Raster Processing

Zonal Statistics

Description This tool calculates statistics on raster values for polygons, lines or points.
Input items One feature class.
Tool properties

Raster: The path to the raster to get statistics from.

Raster Band: The raster band to use to get data from.

Raster Data Provider: The raster data provider that the raster belong to. The
raster is identified by its full path.

Raster Processor: The raster processor to use to make the calculations. PostGIS
Processor is the default raster processor.

Statistics: The list of statistics to be calculated.

Output items A feature class with the calculated statistics added as attributes.
Technical None.
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.RasterProcessing.ZonalStatisticsTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Zonal Statistics’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 64 of 92

GIS manager > GIS Tools for vector data processing

Temporal Tools

The following tools are available for processing of time varying data.

More:

Temporal Zonal Statistics

TimeSeries Step To Feature

Timeseries To Temporal Raster

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 65 of 92

GIS manager > GIS Tools for vector data processing > Temporal Tools 
Temporal Zonal Statistics

Description This tool calculates statistics on time varying raster values for polygons, lines
or points. The output are time series of the selected statistics for each of the
features in the feature class. The time series can be saved similarly to the “To
database” tool or returned as in-memory time series
Input items One feature class.
Tool properties

Attribute: The attribute to use to identify the input features when naming the
output time series.

Raster: The path to the raster to get statistics from.

Name Suffix: Adds a suffix to the time series names.

Overwrite option: Determines how to handle the output. Output time series can
be returned as in-memory time series (No Save option) or saved according to
one of the options in case a time series with the same name already exists.

Save to Database: Indicating whether the output should be saved to the

database.

Save to group: The group in which to save the output time series. The group is
identified by its full path.

Save with name: If a name has been specified, all input time series shall be
given the specified name. If more than one input time series have been
selected, a number suffix will be added to each time series name. If no name
has been specified, the input time series shall be saved with their original
names (plus suffix, if specified). 

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 66 of 92

GIS manager > GIS Tools for vector data processing > Temporal Tools 
TimeSeries Step To Feature

Description This tool copies timeseries values to features in a feature class.

Input items One feature class for which the attribute table will be edited.
Tool
properties

FeatureClass

Add Association: Defines whether the timeseries used will be associate to the
corresponding feature in the feature class.

Target Attribute Name: The attribute to which the timeseries values will written.
If it does not exist, it will be created. If it exists, values will be overwritten.

TS Connection Attribute: The attribute storing the string that will be used to
select which timeseries to read the value from. This will be used along with the
regular expression.

Timeseries

Group Name: The timeseries manager group that contains the timeseries to use
to populate the feature class attribute table.

Timeseries mask (as Regular expression): Regular expression used to filter

timeseries by name. If this is left empty, the tool will assume a one to one match
between the names written in the attribute table and the timeseries names.

Use Timeseries from Feature Association: If set to true, the timeseries associated
to each feature will be considered when applying the mask. If set to false, a
timeseries group will need to be defined.

UseLast: If set to True, this will write the last timestep from the selected

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 67 of 92

GIS manager > GIS Tools for vector data processing > Temporal Tools 
Timeseries To Temporal Raster

Description This tool creates a temporal raster from a set of timeseries and a point feature
class. It uses the tool “TimeSeries Step To Feature” and its help should be
consulted for more information on the timeseries selection.
Input items One feature class representing the geographical location of the timeseries.
Tool
properties

FeatureClass

TS Connection Attribute: The attribute storing the string that will be used to
select which timeseries to read the value from. This will be used along with the
regular expression.

OutputRaster

EndTime: The maximum possible end time of the temporal output raster. If
timeseries do not have timesteps at this particular date/time, no interpolation is
carried out and the raster will end at last available timestep (preceeding
EndTime).

Raster Definition: The definition of the output raster. The editable properties
corresponds to the raster properties, as defined in World Files. This includes the
extent, rotation, cell size and origin of the raster to create. The extent is by
default taken from the feature class extent. Scale X and Scale Y correspond to
the cell size for a raster that is not rotated. The Scale Y is negative because the
origin of the raster is the top left corner. The read only properties are derived
from the editable properties.

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 68 of 92

GIS manager

GIS Tools for raster data processing

The following tools are available for GIS raster data:

More:

Import Tools

Output Tools

Geo processing tools (raster data)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 69 of 92

GIS manager > GIS Tools for raster data processing

Import Tools

The following tools are available for importing raster data.

More:

Import from ASCII Grid

Import from Image file

Import from TIFF file

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 70 of 92

GIS manager > GIS Tools for raster data processing > Import Tools 
Import from ASCII Grid

Description This tool imports rasters stored in an ASCII formatted grid file (as output
by ArcGIS, for example).
Input items An ASCII grid file stored on the file system.
Tool properties When running the tool from the Tools Explorer, a user-friendly data view
interface will appear to assist in setting the tool properties.

Coordinate System: The coordinate system of the data to be imported.

File Path: The path of the file to import.

Raster: The full path of the raster name to import the data to.

Output items A raster stored in the database.

Technical reference The tool imports grids stored in what is known as the ArcInfo ASCII Grid format. It looks like the
following:
and usage tips

ncols 4

nrows 6

xllcorner 0.0

yllcorner 0.0

cellsize 50.0

NODATA_value -9999

-9999 -9999 5 2

-9999 20 100 36

3 8 35 10

32 42 50 6

88 75 27 9 

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 71 of 92

GIS manager > GIS Tools for raster data processing > Import Tools

Import from Image file

Description This tool imports rasters stored in an image file.

Input items An image file stored on the file system in JPEG, TIFF, BMP, PNG, or EXIF
format.
Tool properties When running the tool from the Tools Explorer, a user-friendly data view
interface will appear to assist in setting the tool properties.

File Path: The file path of the Image file to import.

Raster: The name of the Raster to create to store the imported Image file.

Upper Left X: The X coordinate of upper left corner. If “scale image when
zooming” is true, this represents the longitude value of the upper left corner
in decimal degrees (WGS 84). If scale image when zooming is false, this
represents the horizontal offset in pixels from the upper left corner of the
map.

Upper Left Y: The Y coordinate of upper left corner. If “scale image when
zooming” is true, this represents the latitude value of the upper left corner in
decimal degrees (WGS 84). If scale image when zooming is false, this
represents the vertical offset in pixels from the upper left corner of the map

Use scale: A value indicating whether image shall be scaled or not.

Output items A raster stored in the database.

Technical reference To import a georeferenced TIFF file, see the Import from TIFF file tool
and usage tips below.
API reference DHI.Solutions.GISManager.UI.Tools.ImageFileImportTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Import from Image file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 72 of 92

GIS manager > GIS Tools for raster data processing > Import Tools

Import from TIFF file

Description This tool imports raster from a TIFF file.

Input items A raster stored in a TIFF file.
Tool properties When running the tool from the Tools Explorer, a user-friendly data view
interface will appear to assist in setting the tool properties.

Coordinate System: The coordinate system of the data to be imported.

File Path: The file path of the TIFF file to import.

Raster: The full path of the raster name to import the data to.

World File: File containing information about position, scale and skew of
TIFF image.

Output items A raster stored in the database.

Technical reference In contrast to the Import from Image file tool, the TIFF image is imported as
and usage tips a Grid type raster rather than an image. The tool requires a world file (*.tfw)
to be present as well. The world file defines the position, scale, and skew
(rotation) of the raster. More information on world files can be found at
http://en.wikipedia.org/wiki/World_file.

API reference DHI.Solutions.GISManager.UI.Tools.TIFFRasterImportTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Import from TIFF file’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 73 of 92

GIS manager > GIS Tools for raster data processing

Output Tools

The following tools are available for creating different types of raster outputs.

More:

To Database

To Display (Raster)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 74 of 92

GIS manager > GIS Tools for raster data processing > Output Tools

To Database

Description The “To Database” tool stores an in memory feature class to the database.
Input items A selected raster or raster layer.
Tool properties

Duplicate Name option: The option in case raster with the same name
already exists under the same group. Replace the existing raster, rename the
raster being saved or don't save the raster.

Naming Option: The option to define the name of the saved raster. If Name
is selected, the raster will be saved with the name provided in the Raster
Name property. Otherwise, if Postfix is selected, the postfix to add to the
input raster name(s) shall be provided.

Raster Data Provider: The raster data provider to use to save the raster.

Raster Group: The group under which the raster is saved.

Raster Name: The name of the raster to be saved. (Only available if naming
option is “By Name”).

Raster Name Postfix: The postfix to add to the input raster name(s) when
saving. (Only available if naming option is “By Postfix”).

Output items A raster stored in the database

Technical reference Raster tools produce memory objects (rasters stored in memory). To store
and usage tips these memory objects in the database the “To Database” tool must be used.
API reference DHI.Solutions.GISManager.Tools.RasterToDatabaseTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Raster To Database’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 75 of 92

GIS manager > GIS Tools for raster data processing > Output Tools

To Display (Raster)

Description The “To Display (Raster)” tool adds a raster to a “New map” or to the
“Active map”.
Input items A raster to be displayed on the map as a raster layer.
Tool properties

Action: “NewDataView” adds the output raster layer to a new map.

“ActiveDataView” adds the output raster layer to the active map.

Output: Identifies the visualizer. Currently always ThinkGeo, but more

visualizers (e.g. ArcMap) may be added in the future.

Output items A raster layer added to the Map data view

Technical reference When running GIS processing tools they always run either “to Display”.
and usage tips Note that the current “Action” setting for the “To Display” tool will be used
when using “To Display” from other GIS tools.
API reference DHI.Solutions.GISManager.UI.Tools.RasterToDisplayTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Raster To Display’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 76 of 92

GIS manager > GIS Tools for raster data processing

Geo processing tools (raster data)

The following tools are available for processing rasters.

More:

Flow Direction

Project

Raster Calculator

Raster to Vector

Reclassification

Resample

Slope

Slope Length

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 77 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data)

Flow Direction

Description This tool calculates the flow direction of a raster representing elevation values
(DEM) based on the slope of steepest decent from any given cell.
Input items A digital elevation model (DEM) as a raster or raster layer.
Tool properties The flow direction tool has no tool properties.

Output items A raster with values indicating flow direction from each cell. Output flow
direction values are: 0 = None, 1 = East, 2 = Southest, 4 = South, 8 =
Southwest, 16 = West, 32 = Northwest, 64 = North, 128 = Northeast, 256 =
Local minimum, -512 = Undefined.
Technical Flow direction values are often used as input to other tools, such as catchment
reference and delineation. Currently there are no tools that use this tool output directly. (The
usage tips interactive catchment delineation described above calculates the flow direction
internally.)
API reference DHI.Solutions.GISManager.Tools.FlowDirectionTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Flow Direction’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 78 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data)

Project

Description This tool projects a raster to another coordinate system.

Input items Raster or raster layers.
Tool properties

Coordinate System : The coordinate system to project to.

Interpolation Method: The interpolation method to use. Can be Nearest

Neighbor, Bilinear, or Cubic.

Raster Processor: The raster processor to use when executing the tool. PostGIS
Raster Processor is the default processor. Other processors can be added and
used by the tool.

Output items A raster projected into the new coordinate system.

Technical Since coordinate systems are distorted relative to each other when projected,
reference and new cells need to be created, and their values interpolated. “Nearest Neighbor”
usage tips simply selects the nearest value once projected. “Bilinear” linearly interpolates
between the closest 4 input values in two directions. And “Cubic” uses cubic
convolution to interpolate between nearby values.
API reference DHI.Solutions.GISManager.Tools.RasterProjectTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Raster Project’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 79 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data)

Raster Calculator

Description This tool performs raster math on input rasters using syntax commonly found in
spreadsheet programs.
Input items One or more rasters or raster layers.
Tool properties

Formula: The formula to apply to the input rasters. Use syntax normally found
in spreadsheets, but instead of cell references, enter raster names as mapped in
the Mapping property within square brackets. E.g. “[myraster]” The tool can
also produce one output for each input in case “[value]” mapping is used,
meaning the current raster being iterated.

Name Mapping: The mapping of raster names used in the formula to the input
rasters. Do not include brackets. By default the input rasters are mapped to their
raster name.
Output items A raster representing the result of the calculation.
Technical The syntax used for the formula is the same as used in the Spreadsheet
reference and Manager. Formulas can be tested in Spreadsheet Manager and then copied into
usage tips the tool properties, after replacing cell references with the mapped raster names.
API reference DHI.Solutions.GISManager.Tools.RasterCalculatorTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Raster Calculator’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 80 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data)

Raster to Vector

Description This tool creates a feature class with features for each value range specified. If
value ranges are not specified, it creates features for each unique value in the
raster.
Input items Raster or raster layers.
Tool properties

Raster Band : The band from the input rasters that is to be converted.

Tolerance: The tolerance in raster coordinate system used for the simplification
of geometries.

Value Ranges: Defines the values ranges to generate features. If not specified,
all values are used.
Output items A feature class holding features derived from the raster values.
Technical None.
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.RasterToVectorTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Raster to Vector’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 81 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data) 
Reclassification

Description This tool reclassifies a raster replacing single values or ranges of values with
the values to reclassify with. All bands in the raster will be reclassified and
the output raster(s) will have the same definition as input raster(s).
Input items A raster or raster layer.
Tool properties

Keep Unmapped Values: If true, unmapped values are kept; otherwise

unmapped values are replaced by null.

Mapping Type: Defines the type of mapping. If single value, values are
mapped one to one. Otherwise, a range of values is mapped to a new value.

Values Mapping: The mapping of values from the original raster to the
reclassified raster.

Output items A raster with the reclassified values.

Technical None.
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.RasterReclassificationTool
Scripting the To create an instance of the tool in the scripting environment use
tool
def ValueRange_RasterReclassificationTool():

"""

<Script>

<Author>admin</Author>

<Description>Please enter script description here</Description>

</Script>

"""

gisMgr = app.Modules.Get('GIS Manager');

inputRaster = gisMgr.RasterList.Fetch('/MyRaster')

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 82 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data)

Resample

Description This tool resamples a raster to a different cell size.

Input items Any raster or raster layer.
Tool properties

Interpolation Method : The interpolation method to use.

Raster definition: The output definition of the raster, consisting of:

Coordinate System: the output coordinate system (set by the system to

the user coordinate system).

Height: the number of cells vertically

Scale X: the size of the cells in the X-direction

Scale Y: the size of the cells in the Y-direction (enter as a negative

number)

Skew X: the rotation parameter in the X-direction (zero for no rotation)

Skew Y: the rotation parameter in the Y-direction (zero for no rotation)

Upper Left X: the X-coordinate for the upper left corner of the raster

Upper Left Y: the Y-coordinate for the upper left corner of the raster

Width: the number of cells horizontally

Raster Processor : The raster processor to use when executing the tool. PostGIS
Raster Processor is the default processor. Other processors can be added and
used by the tool.
Output items A raster with the specified raster definition and resampled values.
Technical
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.RasterResampleTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Raster Resample’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 83 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data)

Slope

Description This tool calculates the slope for a raster in degrees. The output raster will have
the same definition and as many bands as the corresponding input raster. Output
data type is always float.
Input items A digital elevation model (DEM) as a raster or raster layer.
Tool properties The slope tool has no tool properties.

Output items A raster showing the average slope within each cell based on elevations of
surrounding cells.
Technical Given the following representation of a 3x3 neighborhood of pixels:
reference and
usage tips

ABC

DEF

GHI

The equation for the pixel slope of cell E is: atan(sqrt(((c + 2f + i) - (a + 2d +

g) / 8)^2 + (((g + 2h + i) - (a + 2b + c)) / 8) ^ 2))
API reference DHI.Solutions.GISManager.Tools.RasterSlopeTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Slope’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 84 of 92

GIS manager > GIS Tools for raster data processing > Geo processing tools (raster data)

Slope Length

Description This tool calculates the slope length for each cell in a raster representing
elevation values (DEM) by following the slope down from each cell (similar to
river tracing) and calculating the change in height and the length when the slope
breaks by the SlopeBreak value.
Input items A digital elevation model (DEM) as a raster or raster layer.
Tool properties

Slope Break : The break in slope in percent that will mark the downstream end
of the slope.

Output items A raster representing the slope length from each cell.
Technical None.
reference and
usage tips
API reference DHI.Solutions.GISManager.Tools.SlopeLengthTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Slope Length’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 85 of 92

GIS manager

Soil Erosion Tools

The following tools are available for calculating soil erosion.

More:

RUSLE

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 86 of 92

GIS manager > Soil Erosion Tools

RUSLE

The following tools are available for calculating soil erosion parameters for the RUSLE (Revised
Universal Soil Loss Equation) equation.

More:

Rainfall Erosivity (R)

Soil Erodibility (K)

Slope Length (LS)

Crop Management (C)

Erosion Control (P)

Mean Annual Soil Loss (A)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 87 of 92

GIS manager > Soil Erosion Tools > RUSLE

Rainfall Erosivity (R)

Description Calculates rainfall erosivity (R) for the RUSLE soil erosion equation.
Input items Rasters or raster layers representing distributed rainfall data from which to
calculate the rainfall erosivity factor.
Tool properties

Formula: The raster calculator formula for calculating rainfall erosivity (R)
from the input rainfall intensity and depth rasters.

Name Mapping: The mapping between the input rasters and the raster names
entered in the formula.

For more information on these parameters, see the Raster Calculator tool.
Output items A raster representing the rainfall erosivity factor (R).
Technical reference The default formula for rainfall erosivity is as follows, but can be changed by the user as required.
This equation assumes you have two input grids, “intensity” and “depth”. These need to be mapped in
and usage tips the Name Mapping property to these names.

=(0.29 * (1 - (0.596*EXP(-0.04*[intensity]))))*[depth]*[intensity]
API reference DHI.Solutions.GISManager.Tools.SoilErosionRTool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Soil Erosion Rainfall Erosivity (R)’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 88 of 92

GIS manager > Soil Erosion Tools > RUSLE

Soil Erodibility (K)

Description Calculates soil erodibility (K) for the RUSLE soil erosion equation.
Input items A raster containing values representing the soil type OR a feature class with
polygons representing the soil types.
Tool properties

Mapping: The mapping between the input soil type values and the soil
erodibility factor.

Soil Type Attribute: The feature class attribute which contains the soil type.
(Only used when the input is a feature class).
Output items A raster representing the soil erodibility factor (K).
Technical reference This tool works similarly to the raster Reclassification tool.
and usage tips
The mapped values should be derived from the literature.

API reference DHI.Solutions.GISManager.Tools.SoilErosionKTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Soil Erosion Soil Erodibility (K)’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 89 of 92

GIS manager > Soil Erosion Tools > RUSLE

Slope Length (LS)

Description Calculates slope length (LS) for the RUSLE soil erosion equation.
Input items A raster or raster layer representing a DEM (digital elevation model).
Tool properties The slope length tool has no tool properties.

Output items A raster representing the slope length factor (LS).

Technical reference The tool uses the Slope and SlopeLength tools of the GIS Manager,
and usage tips described in the section on raster geoprocessing tools. From this the slope
length is calculated as follows:

LS = (x / 22.13)n (0.065 + 0.045 s + 0.0065 s^2)

where

x = slope length (m)

s = slope gradient (%) and

n = 0.5 for a slope > 5%, 0.4 for slope between 3.5 - 4.5%, 0.3 for a slope l -
3.5%,

and 0.2 for a slope less than 1%.

This translates into the following spreadsheet formula which is called using
the Raster Calculator Tool:

=POWER([length] / 22.13, [n]) * (0.065 + 0.045 * [slope] + 0.0065 *

[slope] * [slope])

This formula is applied 4 times for each possible value of n and then merged
by adding (again using the Raster Calculator).

API reference DHI.Solutions.GISManager.Tools.SoilErosionLSTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Soil Erosion Slope Length (LS)’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 90 of 92

GIS manager > Soil Erosion Tools > RUSLE

Crop Management (C)

Description Calculates crop management factor (C) for the RUSLE soil erosion
equation.
Input items A raster containing values representing land use (crops) OR a feature class
with polygons representing land use (crops).
Tool properties

Crop Type Attribute: The feature class attribute which contains the crop
type. (Only used when the input is a feature class).

Mapping: The mapping between the input land use (crop) values and the
crop management factor.
Output items A raster representing the crop management factor (C).
Technical reference This tool works similarly to the raster Reclassification tool.
and usage tips
The mapped values should be derived from the literature.

API reference DHI.Solutions.GISManager.Tools.SoilErosionCTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Soil Erosion Crop Management (C)’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 91 of 92

GIS manager > Soil Erosion Tools > RUSLE

Erosion Control (P)

Description Calculates erosion control factor (P) for the RUSLE soil erosion equation.
Input items A raster containing values representing erosion control measures OR a
feature class with polygons representing erosion control measures.
Tool properties

Control Type Attribute: The feature class attribute which contains the
erosion control type. (Only used when the input is a feature class).

Mapping: The mapping between the input land use (control) values and the
erosion control factor.
Output items A raster representing the erosion control factor (P).
Technical reference This tool works similarly to the raster Reclassification tool.
and usage tips
The mapped values should be derived from the literature.

API reference DHI.Solutions.GISManager.Tools.SoilErosionPTool

Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Soil Erosion Erosion Control (P)’)

file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018
GIS Manager Overview Page 92 of 92

GIS manager > Soil Erosion Tools > RUSLE 

Mean Annual Soil Loss (A)

Description Calculates the mean annual soil loss (A) based on the RUSLE soil erosion
equation.
Input items Five rasters representing the RUSLE soil erosion factors:

· Rainfall erosivity (R)

· Soil erodibility (K)
· Slope length (LS)
· Crop Management (C)
· Erosion Control (P)
Tool properties

The tool properties should be selected from the input rasters.

Crop Management (C): The raster representing the crop management

factor (C) of the RUSLE equation.

Erosion Control (P): The raster representing the erosion control factor (P)
of the RUSLE equation.

Rainfall Erosivity (R): The raster representing the rainfall erosivity factor
(R) of the RUSLE equation.

Slope Length (LS): The raster representing the slope length factor (LS) of
the RUSLE equation.

Soil Erodibility (K): The raster representing the soil erodibility factor (K)
of the RUSLE equation.
Output items A raster representing the mean annual soil loss.
Technical reference The mean annual soil loss is calculated by multiplying each of the input
and usage tips factors together:

A = R * K * LS * C * P
API reference DHI.Solutions.GISManager.Tools.SoilErosionATool
Scripting the tool To create an instance of the tool in the scripting environment use

tool = app.Tools.CreateNew(‘Soil Erosion Mean Annual Soil Loss (A)’)



file:///C:/Users/dhi/AppData/Local/Temp/2/~hh554D.htm 12/26/2018