---
title: "INTRODUCTION"
slug: "introduction-23-1"
updated: 2024-04-02T11:49:20Z
published: 2024-05-03T09:18:15Z
canonical: "support.keypro.fi/introduction-23-1"
excludeFromSearch: true
excludeFromExternalSearch: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.keypro.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 3.9** 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.

![](https://cdn.document360.io/672fb328-110d-4b2d-9d5f-f1e71883bb64/Images/Documentation/introduction-image-afxtcggi.png)

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**.