INTRODUCTION

This user manual describes the functions of the browser-based KeyHeat software. The software is designed for the documentation and management of district heating networks. The software is used to maintain up-to-date information on network objects, customers and maintenance. The generated network model can be utilized for network maintenance, planning and renovation.

Software overview

The software is used with Internet browsers and requires no additional software installation on the user’s workstation. The network data that is used is stored in an online database from where the browser receives the data.

You can handle the network data through object-specific forms for various types of network objects. In other words, you use object forms to create and update information on both properties and location. The functions available to you, meaning the actions that users can take, depend on your access rights.

3D compatibility

KeyHeat 2024.3 includes a 3D-compatible database as a default, and it enables basic 3D functions through the user interface. In addition to X and Y coordinates, you can also use the elevation coordinate Z. Please note that addresses, print series, and diagrams are still saved in 2D format.

User interface

The user interface can be divided into three sections. The toolbar is displayed at the top of the screen, and you can use it to open object forms to view and edit objects. The toolbar also includes other tools, such as tools for searching addresses and reading survey files.

The user interface consists of a toolbar, map view, and coordinate section.

The map view is the largest displayed section, which also includes a floating map toolbar. Map tools allow you, for example, to zoom in and out in the map view, measure distances, and print the maps you need.

The bottom of the screen contains the coordinate section, displaying the position coordinates of the mouse pointer as you move the mouse pointer over the map area. With the coordinate section, you can also move to the desired coordinates. In addition, the instructions bar at the bottom displays instructions while various buttons and tools are used.

Hardware requirements

You use KeyHeat via your web browser, so the minimum requirements and recommended equipment greatly depend on the browser you use:

1. Browser: Microsoft Edge or Google Chrome with the latest updates. Firefox is also supported but require the fastest possible CPU (i7, i9). You must also enable cookies in the browser.
2. Operating system: Should be in accordance with the browser’s requirements. Keypro Oy tests the system functionalities with Windows-based equipment. Linux Ubuntu 18 or newer is recommended.
3. Processor: The minimum CPU is Intel Core i3. Intel Core i5 or i7 are recommended (or some equivalent from the AMD).
4. Display: Minimum resolution of 1366 x 768 pixels (1920 x 1080 pixels recommended).
5. RAM: Minimum 8 GB (16 GB recommended, with browser requirements considered).

User roles

Users are assigned a role in the system, and the user privileges specified for that role determine the functions available. Read-only users can view both the properties and location information of objects, but they cannot edit or add objects in the system. The buttons required for these functions are not visible to read-only users. If a user has read and write access to properties or location information, the related buttons are visible. In addition to the above, an Admin user can, for example, modify default values. The tools and functions available to the user are determined based on user rights.

The system also allows the configuration of so-called area-specific user privileges that provide users with the right to view and handle objects within a certain area only. Limitations can also be set based on, for example, the owners of objects.