Vous êtes sur la page 1sur 234

Multilizer PDF Translator Free version - translation is limited to ~ 3 pages per translation.

Version 3.2.1

Manuel de l'administrateur

AT321_AM_E1

Multilizer PDF Translator Free version - translation is limited to ~ 3 pages per translation.
Multilizer PDF Translator Free version - translation is limited to ~ 3 pages per translation.

Multilizer PDF Translator Free version - translation is limited to ~ 3 pages per translation.
Multilizer PDF Translator Free version - translation is limited to ~ 3 pages per translation.

Atoll 3.2.1 Manuel de l'administrateur


Parution: AT321_AM_E1 (février 2014)
© Copyright 1997 ‐ 2014 Forsk. Tous droits réservés.
Publié par:
Forsk
7 rue des briquetiers
31700 Blagnac, France
Tél: + 33 562 747 210
Fax: + 33 562 747 211 le logiciel décrit dans le présent document est fourni en vertu d'un contrat de licence. Le logiciel ne peut être utilisé ou copié que dans les termes et
conditions du contrat de licence. Aucune partie du contenu de ce document ne peut être reproduite ou transmise sous quelque forme ou par quelque moyen que ce soit sans
l'autorisation écrite de l'éditeur. Les noms de produits ou de marques mentionnés dans ce document sont des marques commerciales ou des marques déposées de leurs parties
enregistrant respectives. L'éditeur a pris soin de la préparation de ce document, mais ne fait aucune garantie expresse ou implicite d'aucune sorte et n'assume aucune
responsabilité pour les erreurs ou omissions. Aucune responsabilité n'est assumée pour les dommages accessoires ou consécutifs liés à ou découlant de l'utilisation des
informations contenues dans les présentes.

Multilizer PDF Translator Free version - translation is limited to ~ 3 pages per translation.
Atoll 3.2.1 Administrator Manual © Forsk 2014

4
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Table of Contents

Table of Contents

1 Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
1.1 Supported Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
1.2 Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
1.3 Supported Database Management Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
1.4 Supported Installation Configurations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
1.5 Recommended Hardware and Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
1.5.1 User Computers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
1.5.2 Database Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
1.5.3 Application Servers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
1.5.4 Floating Licence Servers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
1.5.5 File Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
1.6 Recommended Computer Network Architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

2 Installing Atoll and Components  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
2.1 Installing Atoll Using the Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
2.2 Installing a Language Pack Using the Setup Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
2.3 Installing Atoll C++ Development Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
2.4 Setup Command Line Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
2.5 Installing and Uninstalling Add‐ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
2.6 Installing and Uninstalling Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
2.7 Atoll Command Line Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
2.8 Troubleshooting and Other Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25

3 Setting Up Distributed Calculation Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
3.1 Setting Up Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
3.2 Setting Up Atoll to Access the Servers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
3.3 Distributed Calculation Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

4 Managing Licences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
4.1 Working with Floating Licences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
4.1.1 HASP Licence Manager and Device Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
4.1.2 nhsrv.ini File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
4.1.3 nethasp.ini File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
4.2 Using the Atoll Licence Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
4.2.1 Licence Manager Interface  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
4.2.2 Updating Licence Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
4.2.3 Testing Licence Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
4.2.4 Reducing the Number of Module Tokens in ALIC Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
4.2.4.1 Activating the Option in the Licence Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
4.2.4.2 Reducing the Number of Module Tokens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
4.2.4.3 Programming a Blank Licence Key Using the Restricted ALIC File  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37

5 Managing Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
5.1 Atoll Database Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
5.2 Customising Atoll Database Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
5.3 Atoll Management Console  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
5.4 Creating New Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
5.4.1 Creating a New Database Using the Atoll Management Console  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
5.4.2 Creating a New Database Using Atoll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
5.5 Upgrading Existing Databases  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
5.6 Working With a Multi‐level Databases  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
5.6.1 Creating Project Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
5.6.2 Archiving Project Databases to Master Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
5.6.3 Refreshing Project Databases from Master Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
5.7 Setting Database Access Privileges  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
5.8 Managing Data Modifications History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54

5
Atoll 3.2.1 Administrator Manual
Table of Contents © Forsk 2014

5.8.1 Setting Up Data Modifications History Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
5.8.2 Enabling/Disabling Data Modifications History Management  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
5.8.3 Updating After Data Structure Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
5.8.4 Purging Old Data Modification Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
5.8.4.1 Purging Old Data Modification Records of a Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
5.8.4.2 Purging Old Data Modification Records of a Database  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
5.9 Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
5.9.1 Appendix 1: Advanced Customisation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
5.9.2 Appendix 2: Setting Up Databases for Co‐planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60

 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
6M 63
6.1 Setting Up Multi‐user Environments  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
6.2 Components of Multi‐user Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
6.2.1 Master Atoll Document  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
6.2.2 Master Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
6.2.3 Shared Geographic Data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
6.2.4 Shared Path Loss Matrices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
6.2.5 User Atoll Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
6.3 Managing User Accounts and Access Rights in Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
6.3.1 Defining Database and Interface Access Rights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66
6.3.2 Creating and Editing User Accounts  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
6.3.3 Resetting User Database Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
6.4 Appendices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
6.4.1 Appendix 1: Checking Data Integrity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
6.4.2 Appendix 2: Database Regionalisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
6.4.3 Appendix 3: Calculating Path Loss Matrices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
6.4.4 Appendix 4: Path Loss Matrices From Different Sources  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

7C
7.1 Coordinate Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
7.1.1 Definition of a Coordinate System  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
7.1.2 Types of Coordinate Systems in Atoll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
7.1.3 Coordinate Systems File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
7.1.4 Creating a Coordinate System in Atoll  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
7.2 Units  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
7.3 BSIC Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80

8 Geographic Data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  81
8.1 Geographic Header File Formats  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
8.1.1 HDR Header File for BIL Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
8.1.2 TFW Header File for TIFF Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
8.1.3 BPW/BMW Header Files for BMP Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
8.1.4 PGW Header File for PNG Files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
8.1.5 JGW Header File for JPG Files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
8.1.6 Generic Raster Header File  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85

 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
9R 87
9.1 XML Import/Export Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
9.1.1 Index.xml File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
9.1.2 XML File Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
9.2 RF 2D Antenna Pattern Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
9.3 Import Format of 3D Antenna Pattern Text Files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
9.4 Microwave 2D Antenna Pattern Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
9.5 Path Loss Matrix File Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
9.5.1 Pathloss.dbf File Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
9.5.2 Pathloss.dbf File Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
9.5.3 LOS File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
9.6 Path Loss Tuning File Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
9.6.1 Pathloss.dbf File Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
9.6.2 Pathloss.dbf File Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
9.6.3 PTS File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
9.7 Interference Matrix File Formats  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
9.7.1 CLC Format (One Value per Line)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
9.7.1.1 CLC File Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
9.7.1.2 DCT File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98

6
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Table of Contents

9.7.2 IM0 Format (One Histogram per Line) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99


9.7.3 IM1 Format (One Value per Line, TX Name Repeated). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
9.7.4 IM2 Format (Co‐ and Adjacent‐channel Probabilities) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
9.8 "Per Transmitter" Prediction File Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
9.8.1 <per_transmitter_prediction>.dbf File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
9.8.2 <per_transmitter_prediction>.dbf File Contents  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

10 Administration and Usage Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . .105
10.1 Geographic Data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
10.2 Path Loss Matrices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
10.3 Atoll Documents  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
10.4 Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
10.5 Calculation Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
10.6 Atoll Administration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
10.7 Process Memory  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.8 Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
10.9 Coverage Prediction Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
10.10 CW Measurements and Drive Test Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
10.11 Antenna Patterns and Import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
10.12 Traffic Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
10.13 Atoll API  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
10.14 Performance and Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
10.15 Appendix: Memory Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
10.15.1 Disk Space Requirements  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
10.15.2 RAM Requirements  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

11 Configuration Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
11.1 Contents of User Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
11.1.1 Geographic Data Set  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
11.1.2 Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
11.1.3 Map Centre and Zoom Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
11.1.4 Folder Configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
11.1.5 Coverage Predictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
11.1.6 Automatic Neighbour Allocation Parameters  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
11.1.7 Automatic Frequency Planning Parameters  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
11.1.8 Automatic Scrambling Code Allocation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
11.1.9 Automatic PN Offset Allocation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
11.1.10 Automatic OFDM Resource Allocation Parameters  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
11.1.11 Microwave Radio Links Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
11.1.12 Macros  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
11.2 Contents of Additional Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
11.2.1 Print Setup Configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
11.2.2 Table Import/Export Configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
11.2.3 Coverage Prediction Report Configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
11.2.4 CW Measurement Import Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
11.2.5 Drive Test Data Import Configuration  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
11.3 Content of the Custom Predictions File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
11.4 Content of the "Value Intervals" Predictions Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

12 Initialisation Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
12.1 Atoll Initialisation File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
12.1.1 General Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
12.1.1.1 Modifying the Default Formats of Site and Transmitter Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
12.1.1.2 Disabling Automatic Renaming of Transmitters and Cells. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
12.1.1.3 Setting the TIFF Colour Convention. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
12.1.1.4 Creating an Event Viewer Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
12.1.1.5 Displaying Insufficient Permission Messages in the Event Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
12.1.1.6 Increasing the Maximum Printing Resolution  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
12.1.1.7 Duplicating Linked Path Loss Matrices on Save As. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
12.1.1.8 Disabling External Storage of Numerical Results Files for Predictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
12.1.1.9 Restricting the List of Predictions for Creating Sector Traffic Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
12.1.1.10 Displaying Path Loss Calculation Details in the Event Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
12.1.1.11 Mapping Atoll Coordinate Systems with MapInfo/ESRI Vector Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
12.1.1.12 Exporting Coverage Prediction Polygons in Text Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
12.1.1.13 Defining Web Map Services Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

7
Atoll 3.2.1 Administrator Manual
Table of Contents © Forsk 2014

12.1.1.14 Improving Point Analysis Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  152


12.1.1.15 Loading Vector Files Dynamically. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  152
12.1.1.16 Excluding Vectors from Imported KML/KMZ Files  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  152
12.1.1.17 Setting the Precision for the Antenna Pattern Verification at Import  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  152
12.1.1.18 Opening Exported XLS Files Automatically in MS Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  153
12.1.1.19 Disabling Creation of New Documents from Templates  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  153
12.1.1.20 Blocking Access to Macros and Add‐ins. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  153
12.1.1.21 Disabling Saving and Opening ZIP Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  153
12.1.1.22 Enabling Notification for Donor Transmitter Parameter Modifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  153
12.1.1.23 Setting the Display Precision of Floating Point Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  153
12.1.1.24 Changing the Path to Linked Geo Data Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  154
12.1.1.25 Exporting/Importing Vector Data with a Display Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  154
12.1.1.26 Using Only Visible Geo Data in Prediction Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  154
12.1.1.27 Exporting BMP, TIF, and PNG Files with a TAB Reference File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  154
12.1.1.28 Co‐Planning: Linking the Sites Folder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  154
12.1.1.29 Disabling Normalisation of MIF/TAB Vector Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  155
12.1.1.30 Adding the Duplicate Site to the Original Site’s Site List  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  155
12.1.1.31 Using Only Visible Clutter Classes in Interference Prediction Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  155
12.1.1.32 Displaying % of Covered Clutter Classes w. r. t. the Focus Zone in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  155
12.1.1.33 Displaying % of Covered Traffic Classes w. r. t. the Focus Zone in Reports  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  155
12.1.1.34 Synchronising Private and Shared Path Loss Matrices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  155
12.1.1.35 Selecting the Logo 2 Check Box by Default in Print Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  156
12.1.1.36 Filtering Predictions by Technology When Reading the XML Studies File  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  156
12.1.1.37 Enabling Event Viewer Messages for MapInfo File Import/Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  156
12.1.1.38 Setting the Resolution of Population Maps in Coverage Prediction Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  156
12.1.1.39 Setting the Precision in Coverage Prediction Reports  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  157
12.1.1.40 Including Pixel‐free Ranges in Coverage Prediction Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  157
12.1.1.41 Changing Hot Spot Reference Surface in Prediction Reports  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  157
12.1.1.42 Exporting Only Visible Value Interval Layers of Coverage Predictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  157
12.1.1.43 Avoiding Overlapping Pixels in Best Server Coverage Prediction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  157
12.1.1.44 Setting the Minimum ATL File Size Requiring Compression  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  158
12.1.1.45 Loading, Activating, and Setting Add‐ins as Visible  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  158
12.1.1.46 Defining Online Map URLs  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  158
12.1.1.47 Changing the Default Cache Location for the Loaded Map Tiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  158
12.1.1.48 Managing Carriage Returns in Imported TXT/CSV Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  159
12.1.1.49 Deleting the Filtering Zone on Removing Filters From Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  159
12.1.2 GUI Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  159
12.1.2.1 Defining the Parameters for the Default Sites Symbol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  159
12.1.2.2 Using a Unique Symbol for Remote Antennas  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  159
12.1.2.3 Keeping Transmitter Symbols From Changing on Search  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  160
12.1.2.4 Displaying Filled Symbols for Inactive Transmitters on the Map  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  160
12.1.2.5 Refreshing the Display Automatically When a New Station is Dropped. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  160
12.1.2.6 Hiding Information Displayed in the Status Bar  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  160
12.1.2.7 Displaying Date and Time in the Event Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  160
12.1.2.8 Setting the Maximum Number of Lines in Coverage Prediction Tool Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  160
12.1.2.9 Changing the Display for Downlink Smart Antenna Results  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  161
12.1.2.10 Adding Exposure Analysis to the List of Multi‐RAT Coverage Predictions (Hidden en 3.2.0.02, ces infos sont dans TN013)
161
12.1.2.11 Displaying Coverage Prediction Comments in the Legend Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  161
12.1.2.12 Displaying Leading Zeros in the CELL_IDENTITY Field  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  161
12.1.2.13 Making the Antenna Additional Electrical Downtilt Accessible. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  161
12.1.2.14 Increasing the Width of the Clutter Description Pane in the Status Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  162
12.1.2.15 Hiding the Technology Name in the Title Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  162
12.1.2.16 Displaying Objects’ Discrete Values with User‐defined Colours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  162
12.1.2.17 Displaying Vertical Beamwidth in Profile Analysis  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  162
12.1.3 Distributed Calculation Server Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  163
12.1.3.1 Detecting and Listing Distributed Calculation Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  163
12.1.3.2 Setting the Distributed Calculation Server Priority. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  163
12.1.3.3 Modifying the Default Detection Time‐out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  163
12.1.4 Licence Management Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  164
12.1.4.1 Setting an Alarm for the Licence End Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  164
12.1.4.2 Blocking Access to Technology Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  164
12.1.4.3 Blocking Access to ACP and AFP Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  164
12.1.4.4 Changing the NetHASP Licence Manager Idle Time Setting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  164
12.1.5 Database Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  165
12.1.5.1 Checking Data Integrity After Database Upgrade and Data Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  165
12.1.5.2 Automatically Running a Database Integrity Check at Open or Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  165

8
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Table of Contents

12.1.5.3 Allowing Null Entries in Non‐nullable Custom Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165


12.1.5.4 Automatically Running GSM Subcell Audit at Open or Refresh  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
12.1.5.5 Modifying the Default Database Connection Time‐out. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
12.1.5.6 Making Atoll Case‐Sensitive for Database Import From Planet  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
12.1.5.7 Setting the Sign for KClutter When Importing Data From Planet EV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
12.1.5.8 Enabling/Disabling Password Prompt at Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
12.1.5.9 Archiving Data to Databases Using Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
12.1.5.10 Keeping Separate Work and Master Path Loss Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
12.1.5.11 Enabling Partial Refresh from Recently Upgraded Databases  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
12.1.5.12 Setting the Type of Database Being Used. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
12.1.6 Common Calculation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
12.1.6.1 Setting the Antenna Patterns Modelling Method  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
12.1.6.2 Disabling Automatic Locking of Coverage Predictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
12.1.6.3 Enabling Shadowing Margin in Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
12.1.6.4 Setting a Default Value for the Cell Edge Coverage Probability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
12.1.6.5 Enabling Indoor Coverage in Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
12.1.6.6 Modifying the Resolution for the LOS Area Calculation Around a Site  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
12.1.6.7 Embedding Path Losses in New Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
12.1.6.8 Stopping Calculations on Error  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
12.1.6.9 Warning About Prediction Validity When Display Options are Modified  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
12.1.6.10 Reading Exact Altitudes From the DTM  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
12.1.6.11 Setting a Common Display Resolution For All Coverage Predictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
12.1.6.12 Setting the Priorities for GUI and Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
12.1.6.13 Setting the Number of Parallel Processors and Threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
12.1.6.14 Disabling Parallel Calculation of Monte Carlo Simulations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
12.1.6.15 Performing Calculations in Read‐Only Documents  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
12.1.6.16 Identifying Transmitter, Repeater, and Remote Antenna Coverage Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
12.1.6.17 Changing the Rounding Method Used for Profile Extraction  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
12.1.6.18 Estimating Required and Used Memory Size for UMTS Simulations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
12.1.6.19 Disabling Calculations Over NoData Values for DTM and Clutter Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
12.1.6.20 Co‐planning: Calculating Predictions in the Current Document Only. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
12.1.6.21 Co‐planning: Calculating Predictions in Serial or in Parallel  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
12.1.6.22 Forcing Neighbour Symmetry Only Inside Focus Zone  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
12.1.6.23 Using Poisson Distribution in Monte Carlo Simulations  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
12.1.6.24 Calculating EIRP from Max Power in Signal Level Predictions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
12.1.6.25 Excluding Filtered Transmitters from the List of Neighbours . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
12.1.6.26 Changing the Weighting Factor of the Effective Inter‐transmitter Distance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
12.1.6.27 Extending the Maximum Inter‐site Distance to Repeaters and Remote Antennas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
12.1.6.28 Forcing the Real Inter‐site Distance Threshold  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
12.1.6.29 Prioritising Individual Inter‐site Distances in Neighbour Importance Calculation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
12.1.6.30 Keeping the Assigned Neighbours which are not Symmetrised with the Reference Transmitter . . . . . . . . . . . . . . . . . . 174
12.1.6.31 Enabling and Disabling Per‐site Path Loss Matrix Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
12.1.6.32 Defining a Global Maximum Path Loss Calculation Radius . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.1.7 GSM GPRS EDGE Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.1.7.1 Considering Inter‐technology Interference  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.1.7.2 Considering Overlapping Zones for IM Calculation Based on Traffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.1.7.3 Setting the Default BSIC Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.1.7.4 Checking Database Consistency Automatically  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.1.7.5 Disabling the Maximum Range Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
12.1.7.6 Enabling the Support for Multi‐band Transmitters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
12.1.7.7 Setting the Best Server Calculation Method in Same Priority HCS Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
12.1.7.8 Hiding Advanced AFP Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
12.1.7.9 Modifying the Thresholds for Important Violations in AFP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
12.1.7.10 Hiding Violations Between Low Importance GSM Neighbours in AFP Results  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
12.1.7.11 Hiding Violations Between Non‐synchronised MALs‐MAIOs in AFP Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
12.1.7.12 Selecting the Interference Matrices Used During the AFP  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
12.1.7.13 Defining the Maximum Number of Transmitters for Reuse Distance  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
12.1.7.14 Making Redundant Fields in the Transmitters Table Read‐only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
12.1.7.15 Setting the Transmission Diversity Gain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
12.1.7.16 Adding Grouped HCS Servers Option in Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
12.1.7.17 Deactivating Frequency Band Filtering in IM Calculation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
12.1.7.18 Starting TRX Indexes at 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
12.1.7.19 Hiding the TRX Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
12.1.7.20 Extending the Allowed Value Range for C/I and Reception Thresholds. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
12.1.7.21 Automatically Correcting Out‐of‐range Subcell Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
12.1.8 UMTS HSPA, CDMA2000, and TD‐SCDMA Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
12.1.8.1 Suppressing Cell Name Carrier Suffixes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

9
Atoll 3.2.1 Administrator Manual
Table of Contents © Forsk 2014

12.1.8.2 Disabling Macro‐diversity (SHO) Gains in Calculations  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  180


12.1.8.3 Calculating and Displaying Peak or Instantaneous HSDPA Throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  180
12.1.8.4 Setting the Power to Use for Intra‐cell Interference in HSDPA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  181
12.1.8.5 Enabling Coverage Predictions of Connection Probabilities  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  181
12.1.8.6 Setting the Calculation Method for HS‐PDSCH CQI  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  181
12.1.8.7 Enabling Orthogonality Factor in Pilot EC/NT Calculation in HSDPA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  181
12.1.8.8 Setting the Maximum Number of Rejections for Mobiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  181
12.1.8.9 Setting the Maximum Number of Rejections for HSDPA Mobiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  182
12.1.8.10 Defining an Offset With Respect to The Thermal Noise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  182
12.1.8.11 Setting Precision of the Rasterisation Process  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  182
12.1.8.12 Defining the Number of Iterations Before Downgrading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  183
12.1.8.13 Adjusting the Working of the Proportional Fair Scheduler  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  183
12.1.8.14 Displaying Ec/I0 of Rejected Mobiles in Simulation Results  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  183
12.1.8.15 Switching Back to the Old Best Server Determination Method  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  184
12.1.8.16 Displaying Automatic Allocation Cost Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  184
12.1.8.17 Selecting SC and PN Offset Allocation Strategies Available in the GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  184
12.1.8.18 Defining a Fixed Interval Between Scrambling Codes  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  184
12.1.8.19 Compressed Mode: Restricting Inter‐carrier and Inter‐technology Neighbour Allocation. . . . . . . . . . . . . . . . . . . . . . .  184
12.1.8.20 Setting the Maximum AS Size for SC Interference Prediction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  185
12.1.8.21 Displaying Uplink Total Losses in Coverage by Signal Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  185
12.1.8.22 Setting the Maximum UL Reuse Factor for HSUPA Users’ Noise Rise Estimation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  185
12.1.9 LTE, WiMAX, and Wi‐Fi Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  185
12.1.9.1 Blocking Access to IEEE Parameters in WiMAX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  185
12.1.9.2 Using Only Bearers Common Between the Terminal’s and Cell’s Equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  186
12.1.9.3 Enabling Display of Signals per Subcarrier Point Analysis in LTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  186
12.1.9.4 Including Cyclic Prefix Energy in LTE Signal Level Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  186
12.1.9.5 Excluding Cyclic Prefix Energy in WiMAX and Wi‐Fi Signal Level Calculation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  186
12.1.9.6 Ignoring Inter‐Neighbour Preamble Index Collision in WiMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  186
12.1.9.7 Ignoring Inter‐Neighbour Physical Cell ID Collision in LTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  187
12.1.9.8 Applying Transmit Diversity Gains to Reference Signals  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  187
12.1.9.9 Renaming OPUSC Zone to PUSC UL in WiMAX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  187
12.1.9.10 Deactivating Uniform Distribution of Resources  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  187
12.1.9.11 Taking Second Order Neighbours into Account in the AFP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  187
12.1.9.12 Excluding the Adjacent Channel Overlap from the AFP Cost Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  188
12.1.9.13 Switching Between Synchronised and Unsynchronised Interference Calculation Methods. . . . . . . . . . . . . . . . . . . . . .  188
12.1.9.14 Setting PDCCH to 100% Loaded in LTE Interference Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  188
12.1.9.15 Calculating EIRP from RS EPRE in LTE Signal Level Predictions  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  188
12.1.9.16 Averaging the Uplink Noise Rise in dB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  189
12.1.9.17 Deactivating Service Max Throughput Demand Downgrading in LTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  189
12.1.9.18 Displaying Pixels with Zero Throughput in Coverage Predictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  189
12.1.9.19 Setting Uplink Noise Rise Control Parameters in LTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  189
12.1.9.20 Using the ABS Patterns Throughout a Cell in LTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  190
12.1.9.21 Applying the ABS Collision Probability on Interference from RS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  190
12.1.9.22 Enabling Multi‐eNode‐B Carrier Aggregation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  190
12.1.9.23 Switching Between Carrier Aggregation Scheduling Methods  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  190
12.1.10 3GPP Multi‐RAT Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  190
12.1.10.1 BSIC, SC, and PCI Allocation with Inter‐technology Neighbour Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  190
12.1.11 Microwave Radio Links Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  191
12.1.11.1 Updating A>>B and B>>A Profiles in Real‐time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  191
12.1.11.2 Disabling Shielding Factor on Wanted Signal at Receiver  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  191
12.1.11.3 Making the ITU‐R P.530‐5 Method Available  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  191
12.1.11.4 Decreasing Calculation Time of Path Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  191
12.1.11.5 Using Old Min C/I Values  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  191
12.1.11.6 Solving Alignment Issue in Generated Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  192
12.1.11.7 Using Default Method for Calculating Unavailability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  192
12.1.11.8 Defining Default Configuration Files for Link Budgets Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  192
12.1.11.9 Defining a Default Configuration File for the Channel Arrangement Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  192
12.1.11.10 Defining a Default Template for Microwave Links Custom Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  193
12.1.12 Measurement Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  193
12.1.12.1 Displaying Additional Information in Drive Test Data  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  193
12.1.12.2 Setting the Number of Transmitters per Drive Test Data Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  193
12.1.12.3 Recalculating Distances of Points From There Serving Cells at Import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  193
12.1.12.4 Defining the BCCH and BSIC Columns for FMT Import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  193
12.1.12.5 Importing Drive Test Data with Scrambling Codes as Integers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  194
12.1.12.6 Importing Drive Test Data for Active and Filtered Transmitters Only. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  194
12.1.13 ACP Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  194
12.1.13.1 Specifying the Location of the Acp.ini File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  194

10
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Table of Contents

12.2 ACP Initialisation File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194


12.2.1 Managing Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
12.2.2 GUI Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
12.2.2.1 Default Values on the Optimisation Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
12.2.2.2 Displaying Advanced Cost Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
12.2.2.3 Automatically Creating Custom Zones on the Optimisation Tab  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
12.2.2.4 Default Values on the Objectives Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
12.2.2.5 Default Values on the Reconfiguration page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
12.2.2.6 Default Values on Sites tab of Reconfiguration page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
12.2.2.7 Custom Columns on Sites tab of Reconfiguration page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
12.2.2.8 Default Values on the Transmitters Tab of the Reconfiguration Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
12.2.2.9 Custom Columns on Transmitters/Remotes tabs of Reconfiguration page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
12.2.2.10 Default Values on the Patterns tab of the Antenna Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
12.2.2.11 Default Values for EMF Exposure  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
12.2.2.12 Controlling Antenna Pattern Smoothing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
12.2.2.13 Default Values on the Antennas Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
12.2.2.14 Defining the Antenna Masking Model  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
12.2.2.15 Defining Multi‐Storey Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
12.2.2.16 Defining Reconfiguration Values in Custom Atoll Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
12.2.2.16.1 Defining Reconfiguration Values for Transmitters and Repeaters Using Custom Atoll Fields  . . . . . . . . . . . . . . . . . . . 209
12.2.2.16.2 Defining Reconfiguration Values for Secondary Antennas Using Custom Atoll Fields  . . . . . . . . . . . . . . . . . . . . . . . . . 210
12.2.2.16.3 Defining Reconfiguration Values for Cells Using Custom Atoll Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
12.2.2.16.4 Defining Reconfiguration Values for Sites Using Custom Atoll Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
12.2.2.16.5 Defining Reconfiguration Values for Antennas Using Custom Atoll Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
12.2.2.17 Defining Site Class Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
12.2.2.17.1 Defining Automatic Site Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
12.2.2.17.2 Automatic Assignment of Site Classes in the ACP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
12.2.2.18 Defining the Appearance of the Optimisation Dialog Box During a Run  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
12.2.2.18.1 Defining the Colours in the Analysis Maps on the Quality Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
12.2.2.18.2 Other Components of the Optimisation Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
12.2.2.19 Defining the Appearance of Predictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
12.2.2.20 Defining New Predictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
12.2.2.21 Defining the Functionality of the Commit Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
12.2.2.22 Defining the Appearance of the Overlay Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
12.2.2.23 Defining the Appearance of the Graph Tab  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
12.2.2.24 Defining the Default Font. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
12.2.2.25 Exporting Optimisation Results in XML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
12.2.2.26 Changing the Colour Legend for the Optimisation Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
12.2.3 ACP Core Engine Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
12.2.3.1 Log File Settings  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
12.2.3.2 Calculation Thread Pool Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
12.2.3.3 Number of Threads Used for Propagation Model Calculations  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
12.2.3.4 Memory Management Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
12.2.3.5 Signal Level and Macro Diversity Gain Calculation Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
12.2.3.5.1 Signal Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
12.2.3.5.2 Macro Diversity Gain (UMTS Only)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
12.2.3.6 Determining Transmitter Altitude . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
12.2.3.7 Automatic Candidate Positioning Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
12.2.3.8 Balancing Speed, Memory Use, and Accuracy in Calculations  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
12.2.3.9 Accessing Raster Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
12.2.3.10 Accessing Path Loss Matrices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
12.2.3.11 Filtering Clutter Class Layers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
12.2.3.12 Preamble Segmentation (WiMAX)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
12.2.3.13 Multi‐antenna Interference Calculation (LTE)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
12.2.3.14 Multi‐antenna Interference Calculation (WiMAX) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
12.2.3.15 Cyclic Prefix Energy in Signal Level Calculation (LTE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
12.2.3.16 Cyclic Prefix Energy in Signal Level Calculation (WiMAX)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
12.2.3.17 Applying Transmit Diversity Gains to Reference Signals (LTE)  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
12.2.3.18 Fixed Ratio Between Pilot Power and Max Power (UMTS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
12.2.3.19 Showing Initial/Final "Total Power"or "DL Load" on Sectors Tab (UMTS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
12.2.3.20 Enabling Multi‐technology Optimisation Including WiMAX  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
12.2.4 EMF Exposure Core Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
12.2.5 Other Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
12.2.5.1 Validity of Coverage Predictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

11
Atoll 3.2.1 Administrator Manual
Table of Contents © Forsk 2014

12
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 1: Getting Started

1 Getting Started
Atoll  is  an open,  scalable, and  flexible  multi‐technology network  design and  optimisation platform that  supports wireless
operators throughout the network life cycle, from initial design to densification and optimisation. Atoll supports a wide range
of implementation scenarios, from standalone to enterprise‐wide server‐based configurations using distributed and multi‐
threaded computing. 
This manual explains how to install, configure, and deploy  Atoll and how to set up back‐end databases and manage users in
a multi‐user environment.
In this chapter, the following are explained:
• "Supported Technologies" on page 13
• "Supported Operating Systems" on page 13
• "Supported Database Management Systems" on page 14
• "Supported Installation Configurations" on page 14
• "Recommended Hardware and Software" on page 14
• "Recommended Computer Network Architecture" on page 16.

1.1 Supported Technologies
Atoll supports the following radio technologies: GSM GPRS EDGE, UMTS HSPA, CDMA2000 1xRTT EV‐DO, LTE, TD‐SCDMA,
WiMAX,  and  Wi‐Fi.  It  also  supports  3GPP  Multi‐RAT  (combined  GSM,  UMTS,  and  LTE)  and  3GPP2  Multi‐RAT  (combined
CDMA2000 and LTE). Atoll Microwave supports detailed design and analysis of microwave link networks.

1.2 Supported Operating Systems
Atoll supports the following versions of Microsoft Windows operating systems. Atoll also supports VMWare ESXi 4.x and 5.1
virtualisation platforms.

Supported Operating Systems for Atoll 32‐bit

t Windows XP Professional SP3 (32‐bit and 64‐bit)
f o s o r c •M
i
t Windows Vista SP2 (32‐bit and 64‐bit)
f o s o r c •M
i
t Windows 7 (32‐bit and 64‐bit)
f o s o r c •M
i
t Windows 8 Professional and Enterprise (32‐bit and 64‐bit)
f o s o r c •M
i
t Windows Server 2003
f o s o r c •M
i
t Windows Server 2008 (32‐bit and 64‐bit)
f o s o r c •M
i
t Windows Server 2008 R2 SP1
f o s o r c •M
i
t Windows Server 2012
f o s o r c •M
i

Supported Operating Systems for Atoll64‐bit 

t Windows 7 (64‐bit)
f o s o r ct Windows 8 Professional and Enterprise (64‐bit)
•M
if o s o r c •M
i t Windows Server 2008 SP2 (64‐bit)
f o s o r c •M
i t Windows Server 2008 R2 SP1
f o s o r c •M
i

t Windows Server 2012
f o s o r c •M
i

Among  other  Microsoft  Windows  components,  Atoll  64‐bit  uses  Microsoft  Access
Database Engine 64‐bit. Microsoft Access Database Engine 64‐bit is included in Microsoft
Office  64‐bit,  and  is  also  available  as  a  free  redistributable  Microsoft  Windows
component from the Forsk support website.
f •Ithe  computer  on  which  you  wish  to  install  and  run  Atoll  64‐bit  already  has
Microsoft Office installed, you must upgrade it to Microsoft Office 64‐bit (version
2010 SP1 or newer).
•If you do not have Mi
crosoft Office installed, you can download and install the
Microsoft  Access  Dat
abase  Engine  64‐bit  redistributable  (version  2010  SP1)
needed by Atoll 64‐bit from the Forsk support website.
Note: Installing Microsoft Office 64‐bit or the Microsoft Access Database Engine 64‐bit
requires uninstalling any 32‐bit Microsoft Office components that may be installed on
the computer.

13
Atoll 3.2.1 Administrator Manual
Chapter 1: Getting Started © Forsk 2014

1.3 Supported Database Management Systems
In a multi‐user environment, databases allow several users to share data without the risk of data inconsistency. In a multi‐user
environment, user documents are connected to a central database, in which users store their work on a common project.
Atoll supports the following RDBMS:
e 10g and 11g. Oracle client version 10.0.2.3 or later should be used.
l c a •O
r
t SQL Server 2005 and 2008
f o s o r c •M
i
t Access 2003 and later
f o s o r c •M
i The physical location of databases varies according to the type of the database. The following table shows where the da

Database Server Client computer


Microsoft Access No Yesa
Microsoft SQL server Yes No
Oracle Yes Yes (Oracle client)
a. It is possible to work with an Atoll document connected to a Microsoft Access database even if Microsoft Access is not
installed on the computer.

1.4 Supported Installation Configurations
Depending on your requirements, Atoll can be installed in a:
• Standalone configuration:
Atoll installed on each individual user computer with a fixed licence key plugged in each computer.
• Workstation‐based multi‐user configuration:
Atoll  installed  on  each  individual  user  computer  on  a  network  with  a  floating  licence  management  server  that
allocates licence tokens to Atoll sessions run by users on their computers.
• Server‐based multi‐user configuration:
Atoll installed on servers connected to user computers and a floating licence management server on a network. The
floating licence management server allocates licence tokens to  Atoll sessions run by the users on the servers. The
servers can be Citrix‐based, where users run Atoll sessions on the servers through the Citrix interface.

1.5 Recommended Hardware and Software
This section provides guidelines for dimensioning client computers and servers on your network for optimum performance
with Atoll. This section lists the recommended hardware and software for:
• "User Computers" on page 14
• "Database Servers" on page 15
• "Application Servers" on page 15
• "Floating Licence Servers" on page 15
• "File Servers" on page 15.

1.5.1 User Computers
The following table lists the required and recommended hardware and software for user computers (clients) intended for
running with Atoll.

Processor Core i7
RAM 8GB or more
Storage 512 GBa (preferably SSD)
Operating system Windows 7 or Windows 8 Professional or Enterprise
a. Depends on the size of the locally stored geographic data and path loss matrices, if any.

User  computers  must  also  have  a  USB  port  available  for  plugging  in  a  fixed  licence  key,  or  the  nethasp.ini  file 
providing information on accessing floating licence server.
If you are working with an Oracle database, you must install Oracle client on the user computers as well. The Oracle client
version 10.0.2.3 or later should be used.

14
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 1: Getting Started

1.5.2 Database Servers
The following table lists the required and recommended hardware and software for an Oracle database server. The same
configuration can be considered valid for other database systems as well.

Processor Xeon E3/E5 family or equivalent
RAM 8GB or more
Storage 2x146 GB (RAID 1) or morea
Oracle: Windows / UNIX / Linux / Solaris
Operating system
SQL Server: Microsoft Windows
Connectivity Gigabit Ethernet or better
Oracle 10g or 11g
RDBMS
Microsoft SQL Server 2005
a. Tablespace of around 100 MB per 10000 transmitters.

1.5.3 Application Servers
Application servers are intended for installing and running Atoll, defining user rights, etc. Users can work with Atoll installed
on these servers through thin clients such as Remote Desktop or Citrix.
The following table lists the required and recommended hardware and software for application servers intended for running
with Atoll.

Processor 1 quad‐core for 2 to 3 users
RAM 4GB per user (minimum 8 GB)
Storage 2x146 GB (RAID 1) 
Connectivity Gigabit Ethernet or better
Windows Server 2008 R2 SP1
Operating system
Windows Server 2012
Remote Desktop
Thin‐client configuration
Citrix XenApp 6.0 or later
Virtualisation VMWare ESXi 4.x or 5.1

The minimum bandwidth between application servers and client computers for satisfactory performance is 300 kbps per user.

1.5.4 Floating Licence Servers
The floating licence management server:
t be accessible to all the user computers / Citrix servers on the network in order to provide licence tokens for 
s•M
u Atoll
sessions.
t have a steady and reliable network connection with user computers / Citrix servers.
s•M
u
t  shave 
•M
u the  HASP  licence  manager  installed  and  running.  For  more  information,  see "Working  with  Floating Licences"
 on page 31

t have the floating licence key plugged in.
s•Mu
n be one of the application servers.
a•C

1.5.5 File Servers
File servers can store geographic data, path loss matrices,  Atoll configuration and initialisation files, and user projects. The
required hard disk space has to be determined from the file sizes of these data. 
Gigabit Ethernet is recommended for connecting user computers, application servers, and file servers. Network bandwidth is
required for data exchange between Atoll sessions and file servers.
Geographic data and shared path loss matrices should be stored on file servers so that the calculation processes accessing
these data do not affect Atoll’s usage and unnecessarily slow down the GUI.

15
Atoll 3.2.1 Administrator Manual
Chapter 1: Getting Started © Forsk 2014

1.6 Recommended Computer Network Architecture
The  following  network  architecture  recommendations  are  based  on  benchmark  tests  carried  out  on  the  network  of  an
average‐size operator, with around 40 to 60 Atoll licences. The results show the requirements in terms of network, hardware,
and software. Based on these following, you can set up your network environment for any number of users.
The benchmark tests were based on the following scenario:
r of end‐users: 40
e bm•N
u
h user working on an 
c a•E Atoll document with:
l number of sites:
a t o•T 1660 sites (around 5000 cells)
r of sites in the calculation area:
e bm•N
u 300 sites (900 cells)
r‐sector path loss calculation radius:
e•P 20 km (i.e., matrices of 40 km x 40 km each)
h loss calculation resolution:
t a•P 50 m
In order to simulate the average activity of Atoll users, each user is assumed to carry out a "Routine Operation" 5 times during
a  three‐hour  working  period.  The  "Routine  Operation"  consists  in  modifying  parameters  for  40  cells  in  30  minutes,
recalculating path loss matrices for these 40 cells, and calculating a best server coverage prediction.
Although a best server coverage prediction does not require a lot of computer resources for calculations, it requires  Atoll to
load all the path loss matrices in memory. When the path loss matrices are stored on a file server, as recommended, this
operation  creates  a  considerable  data  transfer  activity  over  the  network.  The  benchmark  tests  have  been  based  on 
this simulated data transfer activity.

Computer Network Architecture

A centralised network architecture is the most widely used network architecture by  Atoll users. The figure below shows the
recommended architecture along with a per‐user network bandwidth requirement between network components.

Figure 1.1: Recommended Network Architecture and Bandwidth Requirements

Citrix XenApp is used to centralise data and balance user loads between servers. A network based on such an architecture with
Citrix servers must provide high speed connections between the Citrix servers and the file servers.
The required number of Citrix servers depends on the number of users. On the average, one processor per 2 to 3 users is
recommended. Thus, the required number of Citrix servers depends on the number of processors and end‐users.

Computer Network Dimensioning

You should set up your network according to the number of Atoll users, which is related to the size of the planning project. A
country‐wide project would have larger network dimensions than a project that covers a city.

Link
Recommended Bandwidth
From To
End‐user Citrix server 300 kbps per user
Citrix server File server 30 Mbps per user performing calculations

16
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 2: Installing Atoll and Components

2 Installing Atoll and Components
The following sections describe the installation procedures for Atoll and its following components:
r for Fixed Licence Keys
e v i •D
r
d Calculation Server
e t ub i r t s •Di
l Management Console
l o •A
t
d‐ins and macros
•A
d
You need administrator rights for installing Atoll and its components.

2.1 Installing Atoll Using the Setup Wizard
To install Atoll:
f you work with fixed licences, you must unplug the key before the installation and wait for the installation to finish
•I
before plugging it back in.
e UAC (User Account Control) for the following versions of Microsoft Windows. If you are installing 
l b a s •D
i Atoll on
other versions of Microsoft Windows, proceed to step 1.
t Windows Vista
f o s o r c •M
i
t Windows 7
f o s o r c •M
i
t Windows 8
f o s o r c •M
i
t Windows Server 2008
f o s o r c •M
i
t Windows Server 2008 R2
f o s o r c •M
i
t Windows Server 2012
f o s o r c •M
i
To disable UAC:
a. Go to Control Panel > User Accounts.
b. Select Change User Account Control settings. The User Account Control Settings dialogue appears.
c. Choose Never notify.
d. Click OK.
f you are installing 
•I Atoll 64‐bit, make sure that the Microsoft Access Database Engine 64‐bit is already installed on the
computer. Microsoft Access Database Engine 64‐bit is included in Microsoft Office 64‐bit, and is also available as a free
redistributable Microsoft Windows component from Forsk’s support website.
If the computer on which you wish to install and run  Atoll 64‐bit already has Microsoft Office installed, you must
upgrade it to Microsoft Office 64‐bit (version 2010 SP1 or newer). This will automatically install the Microsoft Access
Database Engine 64‐bit.
If you do not have Microsoft Office installed, you can download and install the Microsoft Access Database Engine 64‐
bit redistributable (version 2010 SP1) needed by Atoll 64‐bit from Forsk’s support website.

Installing Microsoft Office 64‐bit or the Microsoft Access Database Engine 64‐bit requires
uninstalling  any  32‐bit  Microsoft  Office  components  that  may  be  installed  on  the
computer.

1. Run the Atoll setup.
The setup program uses a wizard interface, with a step‐wise description of the installation. You can:
k c i l•C Next to proceed to the next step,
k c i l•C Back to go back and modify previously set options, or
k c i l•C Cancel to cancel the installation.
2. Click Next. The Select Destination Location dialogue appears.
3. Select the destination folder for the installation:
f you are installing 
•I Atoll 32‐bit, the default installation folder is:
m Files\Forsk\Atoll in the 32‐bit versions of Microsoft Windows, or
a r g o r P \ :•C
m Files (x86)\Forsk\Atoll in the 64‐bit versions of Microsoft Windows
a r g o r P \ :•C
f you are installing 
•I Atoll 64‐bit, the default installation folder is:
m Files\Forsk\Atoll in the 64‐bit versions of Microsoft Windows
a r g o r P \ :•C
You can select a different location by clicking Browse.

17
Atoll 3.2.1 Administrator Manual
Chapter 2: Installing Atoll and Components © Forsk 2014

 
Figure 2.1: Select Destination Location Dialogue for Atoll

4. Select the Create a system restore point check box if you wish to the Atoll setup to create a system restore point.
5. Click Next. The Select Components dialogue appears.
6. Select the components to install.
• Full installation: Atoll and all its components will be installed.
• Compact installation: Only Atoll will be installed.
• Custom installation: Atoll and the selected components will be installed.

Figure 2.2: Select Components Dialogue

7. Click Next.
If  you  selected  the  Distributed  Calculation  Server  component  for  installation,  the  Logon  Information  dialogue
appears.
If you did not select this component, the Select Start Menu Folder dialogue appears. In which case, proceed to step 8.

Figure 2.3: Select Components Dialogue

a. Enter the Domain name, Username, and Password.
This information will be used to run the distributed calculation service on the computer, and allow other users of
the domain to access this service.
b. Click Next. The Select Start Menu Folder dialogue appears
8. Select the Start Menu folder for Atoll.

18
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 2: Installing Atoll and Components

The default Start Menu folder for Atoll is Atoll. You can select a different folder by clicking Browse.

Figure 2.4: Select Start Menu Folder Dialogue

9. Click Next. The Ready to Install dialogue appears.
10. Review the installation parameters.

Figure 2.5: Ready to Install Dialogue

11. Click Install. Atoll and its selected components are installed on the computer.
f you work with fixed licences and you installed the 
•I Driver for Fixed Licence Keys , restart the computer. Restarting
the computer is necessary for the driver to work.
f you work with fixed licences, plug in the fixed licence key.
•I
•O
n the versions of Microsoft Windows that support UAC (disabled before the installation), run  Atoll once using an
administrator account and with UAC disabled when the installation is complete.

f •Ithe  following  files  do  not  already  exist  in  the  installation  folder,  empty  ones  are created by the setup

• [Atoll installation folder]\Atoll.ini
• [Atoll installation folder]\coordsystems\Favourites.cs
• [Atoll installation folder]\CWMeasurementsImport.ini
• [Atoll installation folder]\DriveTestDataImport.ini
These files are not removed when Atoll is uninstalled.
f you have installed 
•I Atoll on a Citrix server, you must publish it to make it accessible
to users.

To restrict access to the  Atoll installation folder, you can assign read/write access rights
to this folder to administrators and read‐only rights to end‐users.

2.2 Installing a Language Pack Using the Setup Wizard
You can install additional languages to view menus, dialogues, and other user interface items in your preferred language. In
the current version of Atoll, only the French language pack is available.

19
Atoll 3.2.1 Administrator Manual
Chapter 2: Installing Atoll and Components © Forsk 2014

To install the Atoll language pack:
1. Run the Atoll language setup for the language of your choice.
The setup program uses a wizard interface, with a step‐wise description of the installation.
2. Click Next. The Select Destination Location dialogue appears in the language you chose.

Figure 2.6: Select Destination Location Dialogue for a Language Pack

3. Select the destination folder for the installation:
f you are installing a language pack for 
•I Atoll 32‐bit, the default installation folder is:
m Files\Atoll in the 32‐bit versions of Microsoft Windows, or
a r g o r P \ :•C
m Files (x86)\Atoll in the 64‐bit versions of Microsoft Windows
a r g o r P \ :•C
f you are installing a language pack for 
•I Atoll 64‐bit, the default installation folder is:
m Files\Atoll in the 64‐bit versions of Microsoft Windows
a r g o r P \ :•C
You can select a different location by clicking Browse.
The next time you launch  Atoll, the user interface will be displayed in the language corresponding to the installed language
pack.

2.3 Installing Atoll C++ Development Kit
To install the Atoll C++ development kit:
l C++ must be installed before installing the 
a u s i•V Atoll C++ development kit.
• Atoll should be installed for testing the add‐ins.
e UAC (User Account Control) for the following versions of Microsoft Windows. If you are installing 
l b a s •D
i Atoll C++
development kit on other versions of Microsoft Windows, proceed to step 1.
t Windows Vista
f o s o r c •M
i
t Windows 7
f o s o r c •M
i
t Windows 8
f o s o r c •M
i
t Windows Server 2008
f o s o r c •M
i
t Windows Server 2008 R2
f o s o r c •M
i
t Windows Server 2012
f o s o r c •M
i
To disable UAC:
a. Go to Control Panel > User Accounts .
b. Select Change User Account Control settings. The User Account Control Settings dialogue appears.
c. Choose Never notify.
d. Click OK.
1. Run the Atoll C++ development kit setup.
The setup program uses a wizard interface, with a step‐wise description of the installation. You can,
k c i l•C Next to proceed to the next step,
k c i l•C Back to go back and modify previously set options, or
k c i l•C Cancel to cancel the installation.
2. Click Next. The Select Destination Location dialogue appears.
3. Select the destination folder for the installation.
f you are installing the 
•I Atoll C++ development kit with Atoll 32‐bit, the default installation folder is:

20
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 2: Installing Atoll and Components

m Files\Forsk\Atoll in the 32‐bit versions of Microsoft Windows, or
a r g o r P \ :•C
m Files (x86)\Forsk\Atoll in the 64‐bit versions of Microsoft Windows
a r g o r P \ :•C
f you are installing the 
•I Atoll C++ development kit with Atoll 64‐bit, the default installation folder is:
m Files\Forsk\Atoll in the 64‐bit versions of Microsoft Windows
a r g o r P \ :•C
You can select a different location by clicking Browse.

 
Figure 2.7: Select Destination Location Dialogue

4. Click Next. The Ready to Install dialogue appears.
5. Review the installation parameters.

Figure 2.8: Ready to Install Dialogue

6. Click Install. Atoll C++ Development Kit is installed on the computer.

2.4 Setup Command Line Parameters
You can also install Atoll and its components from the command line. The Atoll setup program accepts optional command line
parameters, which can be useful to administrators, and to other programs calling the setup program. For example, when
automating the installation through batch files.
The following command line parameters are accepted by the Atoll setup program.
, /VERYSILENT
TNE L I S•/
Instructs the setup to be silent or very silent. When the setup is silent the wizard window is not displayed but the
installation  progress  window  is.  When  a  setup  is  very  silent  the  installation  progress  window  is  not 
displayed. Everything  else  is  normal.  So,  for  example,  error  messages  during  installation  are  displayed,  and 
also  the  startup prompt.

If the setup is silent and it requires to restart the computer, but the /NORESTART option is not used (see below), it will
display a Reboot now? message box. If it is very silent it will reboot without asking.
• /NOCANCEL
Prevents  the  user  from  cancelling  the  installation  by  disabling  the 
Cancel  button  and  ignoring  clicks  on  the 
Close
button. Useful along with /SILENT or /VERYSILENT.
• /NORESTART
Instructs the setup not to restart the computer even if necessary.
• /SAVEINF="file name"

21
Atoll 3.2.1 Administrator Manual
Chapter 2: Installing Atoll and Components © Forsk 2014

Instructs the setup to save installation settings to the specified file. Use quotes if the file name contains spaces.
• /LOADINF="file name"
Instructs the setup to load the settings from the specified file after having checked the command line. This file can be
prepared using the /SAVEINF command as explained above. Use quotes if the file name contains spaces.
• /DIR="x:\folder name"
Overrides the default installation folder displayed on the  Select Destination Location wizard page. Use quotes if the
folder name contains spaces.
r name"
e d l o f " = PUORG•/
Overrides the default start menu folder name displayed on the  Select Start Menu Folder wizard page. Use quotes if
the folder name contains spaces.
e name"
l i f " =GOL•/
Causes the setup to create a log file listing file installation and actions taken during the installation process. This can
be helpful for troubleshooting. For example, if you suspect a file is not being installed as it should be, the log file will
tell you  if  the  file  was  actually  skipped  and  why. Use  quotes  if  the  filename contains  spaces. If  the 
file cannot be created, the setup will abort with an error message.

• /SVRACCOUNT="domainname\username"
The domain name and user name for installing the distributed calculation server.
• /SVRPASSWD=password
Password for installing the distributed calculation server.
• /TYPE=type name
Overrides the default setup type. The setup type names are:
l installation: full
l u•F
t installation: compact
c a pmo•C
m installation: custom
o t s u•C
For full and compact setup types, the /COMPONENTS parameters are ignored.
• /COMPONENTS="comma separated list of component names"
Overrides  the  default  component  settings.  Using  this  command  line  parameter  causes  the  setup  to 
automatically select a custom installation type. Only the specified components will be selected. Component names are:

• Atoll: Atoll
• Export to Google Earth add‐in: "Addins\GoogleEarth"
• Best Signal Export add‐in: "Addins\SignalsExport"
r for fixed licence keys: RainbowDongle
e v i •D
r
d calculation server: Atoll_Server
e t ub i r t s •Di
• Atoll Management Console: AMC
Example: To install Atoll, the distributed calculation server, and the driver for fixed licence keys:
/COMPONENTS="Atoll,Atoll_Server,RainbowDongle"

2.5 Installing and Uninstalling Add‐ins
Add‐ins are compiled DLL files which can be placed in any folder and activated by registering them in the Windows registry.
Add‐ins  developed  by  Forsk  have  dedicated  setup  programs,  which  place  the  add‐ins’  DLLs  in  appropriate  locations 
and register them. The setup procedures in these cases are described in the add‐ins’ documentation.
To install an add‐in by registering its DLL:
1. Close Atoll.
2. Right‐click the DLL file in Windows Explorer. The context menu appears.
3. Select Register. The DLL is registered.
You can also register the DLL from the command prompt using regsrv32.exe. Once an add‐in is installed, Atoll loads it
in the list of available add‐ins. It is possible to access and work with add‐ins and macros when there is no ATL file open
in Atoll.

22
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 2: Installing Atoll and Components

Installed add‐ins are automatically loaded by Atoll and appear in the Add‐ins and Macros
dialogue  (Figure 2.9  on  page 23).  If  you  wish  that  a certain add‐in  not  be  loaded,  and
hence be unavailable for activation in this dialogue, you can do so by adding an option in
the Atoll.ini file. For more information, see "Loading, Activating, and Setting Add‐ins as
Visible" on page 158.

To activate or deactivate an installed add‐in in Atoll:
1. In Atoll, select Tools > Add‐ins and Macros. The Add‐ins and Macros dialogue appears (see Figure 2.9 on page 23).
2. Select the add‐in’s check box to activate it, or clear the check box to deactivate it.

Figure 2.9: Add‐ins and Macros Dialogue

Add‐ins installed by the Atoll setup are uninstalled when Atoll is uninstalled. To uninstall any other add‐in by unregistering its
DLL:
1. Close Atoll.
2. Right‐click the DLL file in Windows Explorer. The context menu appears.
3. Select Unregister. The DLL is unregistered.
You can also unregister the DLL from the command prompt using regsrv32.exe /u.

2.6 Installing and Uninstalling Macros
Atoll can load and execute macros written in VBScript.
To load a macro in Atoll:
1. In Atoll, select Tools > Add‐ins and Macros. The Add‐ins and Macros dialogue appears (see Figure 2.9 on page 23).
2. Click Add. The Open dialogue appears.
3. Select the macro file you wish to load.
4. Click Open. The New Script window opens.
5. Specify the script settings:
• Timeout: This is delay after which an unresponsive macro is stopped. To disable the macro timeout, set it to 0. If
you leave the timeout empty, a value of 24 days is used. The default value is 60 seconds.
• UTF‐8 Encoding: Select this option if the macro file contains non‐ASCII characters (for example: "°" or "µ").
Lists of macros available in  Atoll can be stored in user configuration files. Macros listed in the user configuration files are
added to  Atoll when the user configuration files are loaded. For more information, refer to "Contents of User Configuration
Files" on page 118.

23
Atoll 3.2.1 Administrator Manual
Chapter 2: Installing Atoll and Components © Forsk 2014

To remove a macro from Atoll:
1. In Atoll, select Tools > Add‐ins and Macros. The Add‐ins and Macros dialogue appears (see Figure 2.9 on page 23).
2. In the list of available macros, select the macro you wish to remove.
3. Click Delete.
Other commands available in the Add‐ins and Macros dialogue are:
• Edit: Edit the selected macro in the default text editor.
• Run: Execute the selected macro.
• Icon: Assign an icon to the selected macro. Icons assigned to macros appear in the Macros toolbar.
• Refresh: To reload the selected macro file.

2.7 Atoll Command Line Parameters
Atoll supports the following optional command line parameters:

Atoll.exe [-log "logfilename"] [-Ini


"inifilename"] [-Cfg "cfgfilename"] [-Provider providername -UserId username -Password passw

• ‐log "logfilename"
Instructs  Atoll  to  create  a  log  file  containing  all  the  messages  listed  in  the  Events  tab.  This  can  be  helpful  for
troubleshooting. "logfilename" is the full path and file name of the log file inside quotes.
• ‐Ini "inifilename"
Instructs Atoll to load the specified initialisation file when run. This can be used to override the default loading of the
Atoll.ini file located in the  Atoll installation folder. "inifilename" is the full path and file name of the initialisation file
inside quotes.
• ‐Cfg "cfgfilename"
Instructs Atoll to load the specified user configuration file when run. This can be used to override the default loading
of  the  Atoll.cfg  file located  in  the Atoll  installation  folder.  "cfgfilename" is  the  full  path  and  file  name of  the  user
configuration file inside quotes.
• ‐Provider providername
Instructs Atoll to use the mentioned providername to access the database server:

Provider Atoll version providername


32‐bit Microsoft.Jet.OLEDB.4.0
Microsoft Access
64‐bit Microsoft.ACE.OLEDB.12.0
SQL Server 32/64‐bit SQLOLEDB
Oracle (Oracle driver) 32/64‐bit OraOLEDB.Oracle

• ‐DataSource server
Instructs Atoll to access the mentioned database server using the given provider.
• ‐UserId username
Instructs Atoll to access the mentioned Oracle database server using the mentioned username.
• ‐Password password
Instructs Atoll to access the mentioned Oracle database server using the mentioned password.
• ‐Project projectaccount
Instructs Atoll to access the mentioned Oracle database server using the mentioned projectaccount.

e keywords Provider, Password, UserId, DataSource, and Project are case sensitive.
h•T

24
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 2: Installing Atoll and Components

2.8 Troubleshooting and Other Information
Read and follow carefully the instructions in "Installing Atoll Using the Setup Wizard" on page 17 for a smooth installation.
If problems occur and you are unable to resolve them with the help of the following information, contact Forsk’s customer
support.

Microsoft Windows Updates

t is recommended to install new Windows updates. However, it is also recommended to go through the description
•I
of each update patch to see whether it might have a negative effect on your system or network. Pay special attention
to updates and patches related to networking.
•It is also recommended to keep the Windows upda tes uninstall folders, named "$NtUninstall...", under the Windows
folder, in case you have to uninstall a certain 
patch. Some of the update patches might require uninstall folders of
older patches to be available for their own inst
allation.

Fixed licence keys

d licence keys cannot be used with "Server"‐type operating systems. Therefore, you should not install the driver
e x i•F
for fixed licence keys on:
t Windows Server 2003
f o s o r c •M
i
t Windows Server 2008
f o s o r c •M
i
t Windows Server 2008 R2
f o s o r c •M
i
t Windows Server 2012
f o s o r c •M
i
e current version of the driver for fixed licence keys (Sentinel SuperPro driver) installed with 
h•T Atoll is the 7.6.3.
f •I Atoll is unable to access the fixed licence key, even after a clean installation, try reinstalling the Sentinel SuperPro
driver manually. The driver’s setup program (SPI763.exe) is copied by the setup to the Sentinel subfolder in the Atoll
installation folder if you selected the  Driver for Fixed Licence Keys  component during the installation. You can also
download the driver from http://www.safenet‐inc.com.
•Restart the computer when asked by the setup. Restarti
e computer is necessary for the driver for fixed licence
h t   gn keys to work.
•If you get a protection key error message, verify that
fixed licence key is correctly plugged in and that the licence
  eh t  
has not expired.

n case the fixed or the floating licence key becomes unavailable, 
•I Atoll will ask the users currently accessing the key
to save their open documents before Atoll closes. If the key becomes available again, Atoll will let the users continue
working.
•D
o not change the computer’s date.

Citrix

f you have installed 
•I Atoll on a Citrix XenApp server, you must publish it to make it available to the users.

Atoll version and build

u can get information about 
o•Y Atoll (version, build, type of licence and remaining time before expiration, etc.) by
selecting Help > About Atoll in the main menu in Atoll.

Atoll file version and technology

ATL file properties store the Atoll version and build number in which the file was last saved, and the technologies contained
in the file. To access the ATL file properties:
1. Right‐click the ATL file in the Windows Explorer. The context menu appears.
2. Select Properties from the context menu. The file properties dialogue appears.
3. In Windows XP, click the Summary tab and then the Advanced button.
In Windows Vista, 7 and 8, click the Details tab.
The Atoll version and build number in which the ATL file was last saved are stored in the  Revision number property.
The technologies of the document are listed in the Category property.

Support website

u can download the latest versions of 
o•Y Atoll from the Forsk’s support website by logging in with the user name and
password provided to you by Forsk.
e h•T Atoll User Manual and other documents are available on the installation CD. More documents are available for
download on the Forsk’s support website.
e support website also offers you:
h•T

25
Atoll 3.2.1 Administrator Manual
Chapter 2: Installing Atoll and Components © Forsk 2014

e add‐ins, macros, and scripts
l pma•S
e geographic data,
l pma•S
t of fixed issues in the versions available for download,
s i•L
t of known issues, and possible workarounds,
s i•L
• Schedule for upcoming versions,
t of holidays.
s i•L
For full contact details for customer support, see back cover.

Acknowledgement

• Atoll uses Inno Setup for installation. For more information, see http://www.jrsoftware.org/isinfo.php.

Uninstalling Atoll and its components

It is recommended to uninstall Atoll and its components through the Control Panel.
To uninstall Atoll:
n Windows XP or Windows Server 2003:
•I
a. Go to Control Panel > Add or Remove Programs.
b. In the Install/Uninstall tab, select Atoll from the list of installed programs.
c. Click the Remove button.
n Windows Vista, Windows 7 and 8, or Windows Server 2008 and 2012:
•I
a. Go to Control Panel > Programs and Features.
b. In the Uninstall or change a program window, right‐click Atoll. The context menu appears.
c. Select Uninstall.

26
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 3: Setting Up Distributed Calculation Server

gni Up Distributed Calculation Server
3S
tte
Distributed calculation enables you to distribute the calculation of path loss matrices over many computers in a network. The
distributed calculation service is an optional service that can be installed at the same time as Atoll. For more information on
installation, see "Installing Atoll and Components" on page 17.
A computer on which the distributed calculation service is installed and running is called a distributed calculation server. This
computer, the distributed calculation server, is visible to all the other computers on the network through  Atoll. You can set
up as many distributed calculation servers as required.
The distributed calculation service does not have a user interface, and hence has lower memory requirements than  Atoll. The
distributed  calculation  server  uses  the  standard Atoll  API  to  exchange  data  with  the  path  loss  calculator  and 
Atoll.  The
distributed calculation service supports dual‐processor configurations and up to four threads.
Any version of Atoll can work with the distributed calculation service of the same or later version. Consequently, any version
of the distributed calculation service can work with the same or previous versions of Atoll (versions still maintained by Forsk).
For distributed calculation server options available through the Atoll.ini file, see "Distributed Calculation Server Options" on
page 163.

3.1 Setting Up Servers
When  installed,  the  distributed  calculation  service  automatically  starts  and  remains  available  as  long  as  the 
computer  is turned on. The service does not require any active user session on the computer, i.e., the service keeps running even w
there is no user logged on. The service’s executable (AtollSvr.exe) is installed in the Atoll installation folder.
The  Atoll  distributed  calculation  service  is  listed  as  Atoll  Server  in  the  Services  management  console  under  Control
Panel >Administrative Tools.
During calculations, the distributed calculation servers require access to geographic data for calculating the path loss matrices.
The distributed calculation service must be run with a user account that has sufficient privileges to access the required data. 
To modify the user account through which the distributed calculation service is run on a computer:
1. Log on to the computer with a user account with administrator rights.
2. Go to Control Panel > Administrative Tools > Services.
3. In the list of services, right‐click the Atoll Server service. The context menu appears.
4. Select Properties. The Atoll Server Properties dialogue appears.

Figure 3.1: Atoll Server Properties

5. On the Log On tab, enter the user name and password for the user account through which you wish to run this service.
6. Click OK.

27
Atoll 3.2.1 Administrator Manual
Chapter 3: Setting Up Distributed Calculation Server © Forsk 2014

Running More Than One Instance of the Service

By default, a single instance of the distributed calculation service is run. You can, however, run up to 9 additional distributed
calculation services (a total of 10 including the first one) manually.
To manually run additional distributed calculation services, double‐click the AtollSvr.exe file located in the  Atoll installation
folder. For each new instance of the service, a command prompt window opens. To stop an additional, manually run service,
close the command prompt window corresponding to it.

Atoll can detect a total of 10 instances of the distributed calculation service. If you run
more than 9 additional distributed calculation services, they will not be detected by  Atoll
and can cause the operating system to stop responding.

Stopping and Starting the Distributed Calculation Server

To stop the distributed calculation service:
1. Log on to the computer with a user account with administrator rights.
2. Go to Control Panel > Administrative Tools > Services .
3. In the list of services, right‐click the Atoll Server service, and select Stop or Start from the context menu.

Uninstalling the Distributed Calculation Server

To uninstall the distributed calculation service:
1. Log on to the computer with a user account with administrator rights.
2. Stop the distributed calculation service:
a. Go to Control Panel > Administrative Tools > Services.
b. In the list of services, right‐click the Atoll Server service, and select Stop from the context menu.
3. Unregister the service:
a. Select Start > Run. The Run dialogue appears.
b. Type  "<Atoll  Installation  Path>\AtollSvr.exe  /UnregServer".  <Atoll  Installation  Path>  is  the  path  to  the Atoll
installation folder.
c. Click Run.
This will remove the distributed calculation service from the computer.

3.2 Setting Up Atoll to Access the Servers
To activate distributed calculations in Atoll:
1. Select Tools > Distributed Calculations from the main menu. The Distributed Calculations dialogue appears.
2. Select the Activate distributed calculation  check box.
a. To use all the available distributed calculation servers, click All.
b. To use selected distributed calculation servers only, click Detect.
Atoll  searches  for  the  available  distributed  calculation  servers  on  the  network.  The  available  distributed
calculation servers are listed in the edit box.
c. Remove the distributed calculation servers that you do not wish to include.
3. Click OK. The selected distributed calculation servers are now available for path loss calculations.

3.3 Distributed Calculation Process
Once distributed calculations have been set up on the calculation server and on the user sides, the path loss calculations run
by the user are distributed over the available calculation servers. The calculation process is as follows:
1. Atoll user runs path loss calculations.
2. Atoll sends the needed network data to the available calculation servers.
3. Either Atoll sends the needed geographic data to the calculation servers or the servers access the geographic data on
a file server.

28
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 3: Setting Up Distributed Calculation Server

4. Distributed calculation servers calculate the path loss matrices one by one.
Distributed  calculation  servers  that  have  spare  threads  start  the  calculations  using  these  threads.  If  no 
thread  is available, the request is placed in a queue to wait for a thread to become available.

Atoll  session.  Any  error  or  warning  messages


5. For  each  calculated  path  loss  matrix,  a  confirmation  is  sent  to  the 
generated are passed back to the Atoll session and displayed in the Event Viewer.
Atoll  transfers  the  calculations  back  to  the  local
If  an  error  occurs  on  any  of  the  distributed  calculation  servers, 
computer. However, to avoid memory saturation, Atoll uses one thread on the local computer and calculates the path
loss matrices one by one. It does not attempt creating more than one thread. 
6. In order to reduce the amount of data flow in the network, distributed calculation servers send the results directly to
the storage location (which can also be on a file server, not necessarily on the user’s computer that requested the
calculations).
7. Atoll user can then request the path loss matrices from the file server if they are needed for coverage predictions.

29
Atoll 3.2.1 Administrator Manual
Chapter 3: Setting Up Distributed Calculation Server © Forsk 2014

30
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 4: Managing Licences

4 Managing Licences
Atoll can be used on:
s with fixed licence keys plugged in to USB slots on the computers themselves, or
r e t u pmo•C
s connected to a licence server with a floating licence key plugged in to a USB port on the server.
r e t u pmo•C
The driver for fixed licence keys can be installed at the same time as  Atoll. For more information, see "Installing Atoll and
Components" on page 17.
The software for managing floating licence keys must be installed on a server accessible to the computers on which  Atoll is
going to be used. For more information, see "Working with Floating Licences" on page 31.
For information on the Atoll licence management utility, see "Using the Atoll Licence Manager" on page 33.

4.1 Working with Floating Licences
A floating licence key can be used when users work with Atoll on computers on a network. In a floating licence environment,
licence keys are not plugged in to each individual user’s computer, but a shared licence key with multiple tokens is available
to users through a server.
A  floating  licence  server  is  a  computer,  accessible  to  other  computers  on  a  network,  on  which  the  floating  licence
management software has been installed and a floating licence key plugged in. The floating licence server can be one of the
computers on which Atoll is installed.
The floating licence management software and the floating licence key control the number of potential Atoll users. A floating
licence system has a defined maximum number of tokens available. This is the maximum number of computers on which  Atoll
can be run simultaneously. Each computer that runs  Atoll takes one token from the floating licence key, even if more than
one Atoll session is run on the same computer. The token is released and made available for other users when all the  Atoll
sessions on the computer are closed.
If a computer is connected to a floating licence server and also has a fixed licence key plugged in, the fixed licence key is
accessed first.
Atoll  uses  a  3rd‐party  floating  licence  management  system  called  HASP  from  Aladdin.  The  floating  licence  management
system includes:
• HASP floating licence key: Hardware key programmed with the numbers of tokens available for each module.
• HASP licence manager: Interface between Atoll and the floating licence key.
• HASP device driver: Interface between the HASP licence manager and floating licence key.
• HASP monitor: Enables you to check the number of used and available tokens.
• nhsrv.ini file: Installed on the floating licence server to enable computers to use tokens. 
• nethasp.ini file: Installed on the computers to facilitate access to the floating licence server.
nhsrv.ini and nethasp.ini files are used if they exist. Default settings are used otherwise.

u can download the HASP licence manager, the HASP device driver, and the HASP
o•Y
monitor  from  http://www3.safenet‐inc.com/support/hasp/hasp4/enduser.aspx.
Newer versions can be available for download at the website than those provided on
the Atoll installation disk.
n e•W
downloading 
h setup  files  from  the  Aladdin  website,  remember  to  download setup files for HASP4, not H
 correct (recommended) version of the device driver setup to download is the one
e h•T
 works with "HASP4 API v8.x or Envelope 12.x". 
t ath
P hardware key is supported by Windows 2000 Server and Windows Server 2003
S•HA
 HASP Licence Manager 8.20 or above.
h twi

4.1.1 HASP Licence Manager and Device Driver
The HASP licence manager controls the allocation and retrieval of licence tokens available on a floating licence key. It uses the
HASP device driver for communicating with the floating licence key.
The HASP licence manager can be installed on a computer running Windows 2000 or later. A USB port must be available on
the server for plugging in the floating licence key.

31
Atoll 3.2.1 Administrator Manual
Chapter 4: Managing Licences © Forsk 2014

•D
o not plug the floating licence key in the server before installing the device drivers.
Wait for the HASP licence manager setup to indicate when to plug in the key.
•If the floating licence server is protected by a firewall, port 475 must be op
en when
using the UDP or TCP protocols.
e cthe 
•O
n HASP  licence  manager  has  been  installed,  the  floating  licence  key  must always remain plugged in.

n •Icase  the  fixed  or  the  floating  licence  key  becomes  unavailable,  Atoll  will  ask  the
users currently accessing the key to save their open documents before  Atoll closes. If
the key becomes available again, Atoll will let the users continue working.
e floating licence key can become unavailable and a key protection error message
h•T
appears in  Atoll if the licence management server is heavily loaded. Check if there is
any application running on the server that might be causing the problem. If this is the
case, remove any such application from memory. If this is not possible, try changing
the latency associated to the HASP licence manager in accessing the key.

Installation and Startup

The HASP licence manager, the HASP device driver, and the floating licence key must be installed on the server.
The following options should be selected when installing the HASP licence manager:
• Choose "Service" as the type of installation.
This means that the licence manager will run as a service, and will be accessible even if there is no user logged on. You
can choose to install it as an application, but in that case you will have to run the licence manager manually every time
you log on to the server and you will have to stay logged on for the licence server to be available to the Atoll users.
• Accept automatic driver installation.
This will install the HASP device driver required by the HASP licence manager.
e the device driver is successfully installed, plug in the floating licence key.
c •O
n
e installed, start the HASP licence manager.
c •O
n
If you selected "Service" as the type of installation, the licence manager will start in service mode. An icon will be
available in the task bar. You can access the network communication protocols by double‐clicking this icon.
The HASP licence manager window displays a list of supported protocols which can be modified through the Load and
Remove menus. Closing this window does not stop the licence manager. The icon remains available in the taskbar as
long as the service is running.
To stop the HASP licence manager:
a. Go to Control Panel > Administrative Tools > Services.
b. In the list of services, right‐click the HASP Loader service, and select Stop from the context menu.
u can also copy (from the installation CD) or create the nhsrv.ini file on the floating licence server (in the HASP
o•Y
licence manager installation folder). The HASP licence manager settings in this file can be modified according to the
your requirements. For more information on the contents of the nhsrv.ini file, see "nhsrv.ini File" on page 32.

To restrict access to the HASP licence manager installation folder, you can assign read/
write access rights to this folder to administrators and read‐only rights to end‐users.

HASP Monitor (Optional)

You can install the HASP monitor on the floating licence server, or on one or several other computers, to monitor the token
allocation and retrieval activity. The HASP monitor displays the list of computers using tokens available on the floating licenc
e key.

4.1.2 nhsrv.ini File
The nhsrv.ini file can be used to define a list of computers allowed to request tokens from the floating licence server.

File Location

If used, the nhsrv.ini file must be located in a folder listed in the system path variable, such as the Windows folder (usually
C:\Windows).

32
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 4: Managing Licences

File Contents

The following is a sample of the nhsrv.ini file that shows how to set a list of computers allowed access to the floating licence
server. Complete syntax can be found on the HASP installation CD or on the Aladdin website.

[NHS_SERVER]
;NHS_IP_LIMIT = <IpAddr0>[,<IpAddr1>,<IpAddr2>,...]
;Specifies
the
IP
addresses
of
computers
served
by
the
licence
manager
;Example:
10.1.1.1,
10.1.1.*

;For use, remove the semi-colon before NHS_IP_LIMIT

4.1.3 nethasp.ini File
The nethasp.ini file enables Atoll to locate the floating licence server quickly. Without the nethasp.ini file, finding the floating
licence server on the network can take a long time.

File Location

The nethasp.ini file should be located in the Atoll installation folder (recommended). If, for some reason, it is not possible to
store the file in the Atoll installation folder, it can be stored in (in the order in which it is searched for by Atoll):
e Windows folder (usually C:\Windows)
h•T
•A folder listed in the system path variable
A nethasp.ini file located in the  Atoll installation folder has priority over any nethasp.ini file located in the Windows folder,
which in turn has priority over any nethasp.ini file located in a folder listed in the system path variable.
Storing the nethasp.ini file in the Windows folder instead of the  Atoll installation folder can be useful if you have more than
one version of Atoll installed, and you wish to access the same floating licence server. This avoids making a copy of the file in
each Atoll installation folder.

File Contents

The following is a sample of the nethasp.ini file with the minimum required information. Complete syntax can be found on
the HASP installation CD or on the Aladdin website.

[NH_COMMON]
NH_IPX = Disabled ;Use the IPX protocol - Enabled or Disabled ;
NH_NETBIOS = Disabled Use the NETBIOS protocol - Enabled or Disabled NH_TCPIP = Ena
;Use the TCP/IP protocol - Enabled or Disabled N
[ H_TCPIP]

NH_SERVER_ADDR = 3CT000J ;(a )IP address of the floating licence server


NH_TCPIP_METHOD = UDP ;(b )Send TCP or UDP packets
NH_USE_BROADCAST = Disabled ;Use TCP/IP broadcast - Enabled or Disabled
a. It is recommended to enter the server name within the domain.
For example, for servername.domainname.com, enter servername only.
Only one server name is supported in the nethasp.ini file.
b. For HASP Licence Manager 8.20 and later, Aladdin recommends UDP as the default TCP/IP method.

e the NH_SESSION and NH_SEND_RCV entries from the nethasp.ini file if these
v ome•R
exist. 
e fields define the timeout delays depending to the network. They can be useful
s e h•T
in slow networks and should be set only if required.

4.2 Using the Atoll Licence Manager
Atoll Licence Manager enables you to monitor, troubleshoot, and update licence keys. You must not use the licence manager
without  full  instructions  and  details  from  Forsk  customer  support.  Modifying  parameters  in  the  licence  manager  without
proper input from Forsk customer support can damage your fixed or floating licences and block access of  Atoll users to the
licences.

33
Atoll 3.2.1 Administrator Manual
Chapter 4: Managing Licences © Forsk 2014

4.2.1 Licence Manager Interface
To open the Atoll licence manager:
1. Close Atoll.
2. Go to the Atoll installation folder.
3. Run Lic.exe. The licence manager opens (see Figure 4.1 on page 34).

Figure 4.1: Atoll Licence Manager

4. Under Available licences, select a licence key in order to display the information related to it.

The Clear all button is reserved for Forsk use only.

Under Selected key the following information is available for the selected key:
• Number:  Unique  key  number  given  by  the  key  provider.  This  number  must  be  communicated  to  Forsk,  when
requested, for reprogramming the licence key.
• Type: The type of key, Fixed licence or Floating licence.
• Reference: Unique floating licence key reference provided by Forsk. This number must be communicated to Forsk,
when requested, for reprogramming the licence key. This reference is also printed on the sticker on the key.
• Location (server): Name of the floating licence management server on which the floating licence key is plugged.
• Under Modules and licences, all the Atoll modules available on the selected key are listed along with the numbers
of licence tokens of each.
• Under Number of licences, the Modify buttons are reserved for Forsk use only.
• Under Dates and durations, the following dates and durations are available:
• Licence start
• Licence end
n of validity
o i t a r •D
u
e bomb
m i•T

34
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 4: Managing Licences

A purchased  Atoll licence corresponds to a particular  Atollversion. There is no time limit on using this version.


However, yearly maintenance must be purchased in order to access newer versions with updates and bug fixes.
When you purchase maintenance, Forsk reprograms your licence keys to allow access to new versions.
The Time bomb date is the end date for maintenance. When the time bomb date passes, the licence key stops
working.  You  can  then  choose  to  either  purchase  maintenance  for  the  next  year,  and  benefit  from  the 
new
features and bug fixes, or have the licence key reprogrammed without maintenance for the next year, in which case user

Atoll can inform you about the approaching time bomb date 30 days in advance. This alert can be configured
through the Atoll.ini file.

•D
o  not  attempt  to  modify  the  Time  bomb  settings  on  the  fixed  licence  key.  Contact Forsk’s customer su

•D
o not change the computer’s date.

• Under Profile signature, the PID (profile signature or ID) is the encrypted description of the user rights available
on the key. Each key has a unique PID.
• Under Current profile summary, all of the above information is summarised.

4.2.2 Updating Licence Keys
Atoll licence manager enables administrators to update licence keys by loading new key programming data from ALIC files
provided by Forsk. To update a licence key, you must have the ALIC file sent by Forsk.

Do  not  attempt  to  reprogram  a  licence  key  without  full 


information and support from Forsk customer support.

To update a licence key:
1. Close all Atoll sessions.
Atoll reads licence information from the key at the start of each session. This information is kept in memory as long
as a session is running. If a licence key is updated while a session is still running, the running session will not read the
updated licence information from the key and will expire according to the old licence information.
2. Go to the Atoll installation folder.
3. Run Lic.exe. The licence manager opens (see Figure 4.1 on page 34).
4. Under Available licences, select the key to update. If the key does not appear in the available licences list, check that
it is plugged in to your computer.
5. Under Key programming, click Load. The Open dialogue appears.
6. Select the ALIC file provided by Forsk.
7. Click Save. The key is updated.

4.2.3 Testing Licence Keys
The Atoll licence manager enables administrators to test licence keys.
To test a licence key:
1. Close Atoll.
2. Go to the Atoll installation folder.
3. Run Lic.exe. The licence manager opens (see Figure 4.1 on page 34).
4. Under Available licences, select the key to test. If the key does not appear in the available licences list, check that it
is plugged in to your computer.
5. Under Key programming, click Test. The Key test dialogue appears.

35
Atoll 3.2.1 Administrator Manual
Chapter 4: Managing Licences © Forsk 2014

Figure 4.2: Test Key Dialogue

6. In the Key test dialogue, under Modules, select the module that you wish to test.
7. Click Test. The test shows whether the selected module is available on the key or not.

Never test a module for a future date. If you enter a future date when testing a key, this
can reduce the time left for using the key.

4.2.4 Reducing the Number of Module Tokens in ALIC Files
ALIC files are used by ForskAlcatel‐Lucent to program fixed or floating licence keys. ALIC files consist of a prefix which includes
either the letter A (for floating licence keys) or R (for fixed licence keys) followed by the reference number of the key. One
ALIC file corresponds to one unique key with the same reference number on its sticker.
OEM clients can create new ALIC files, containing reduced numbers of module tokens, from an existing ALIC file. The ALIC files
containing reduced numbers of module tokens can then be used for programming floating licence keys allowing the use of
only the selected modules.
The following sections describe how you can activate this feature and use it for creating reduced token ALIC files.

4.2.4.1 Activating the Option in the Licence Manager
The feature is available through the Licence Manager (Lic.exe). To activate this feature, add the following lines in the Atoll.ini
file before running Lic.exe:

[RestrictAlicModuleCount]
AD384D8F-93EF-481D-B007-8F5B7E0033BC = 1

4.2.4.2 Reducing the Number of Module Tokens
Once you have activated the feature, you can use the licence manager to reduce the number of modules allowed on a new
ALIC file as follows:
1. Close all Atoll sessions.
2. Run the licence manager. For more information, see "Using the Atoll Licence Manager" on page 33.
A fixed or floating licence key must be plugged in to the computer on which you are running the licence manager. This
key is required for opening the licence manager window. The ALIC file that you will create will not be for this key. The
dongle for which you are going to create the new ALIC file with the reduced number of tokens should be blank and
not plugged in to any computer.
3. Click the Reducing programming file tokens button. The Open dialogue appears.
4. Select the ALIC file from which you wish to create another ALIC file with a reduced number of tokens.
5. Click Open. The Module Restriction dialogue appears.
6. In the Module Restriction dialogue, set the number of tokens of each module that you wish to allow in the new ALIC
file.
You can only reduce the numbers of tokens. To reduce the number of the Base modules, you must first reduce the
corresponding numbers of other modules.
7. Click Generate. A new ALIC file is generated with the numbers of module tokens that you selected. This file is located
in the same folder as the original ALIC file.

36
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 4: Managing Licences

8. Close the licence manager.
9. Make a backup copy of the original ALIC file.
10. Remove the ".restricted" extension from the new ALIC file name.

4.2.4.3 Programming a Blank Licence Key Using the Restricted ALIC File
Once you have generated the new ALIC file with the reduced numbers of module tokens, you can programme a new blank
licence key using this file.
To program the licence key with the new ALIC file with reduced numbers of tokens:
1. Close all Atoll sessions.
2. Plug the licence key in to the computer.
If it is a floating licence key, set the ADDR_SERVER in the nethasp.ini file equal to the name of your computer.
To check that the key is available:
a. Run Lic.exe.
b. Under Available licences, select the blank key. The Modules and licences section should be empty for the blank
key.
c. Close Lic.exe.
3. Double‐click the ALIC file. A message will appear indicating that the programming was successful.
4. Check the new contents of the key with Lic.exe.
If the contents of the key are correct, you can send the key to your customer.
Forsk sends a new ALIC file every year to update the time bomb and maintenance dates. One year after this first programming,
after receiving the ALIC corresponding to the key, the same process has to be carried out using the new ALIC file, and the
generated ALIC files have to be sent to the customers to enable them to update their keys.

37
Atoll 3.2.1 Administrator Manual
Chapter 4: Managing Licences © Forsk 2014

38
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

5 Managing Databases
In  Atoll,  you  can  work  with  standalone  documents,  i.e.,  documents  without  any  back‐end  database,  or  with  documents
connected to databases. Standalone documents are more portable, however a back‐end database is required when working
in a multi‐user environment. In multi‐user environments, several users work on the same project and a central data storage
is necessary for keeping the data modifications made by a team of radio planning and optimisation engineers.
Atoll enables you create databases, upgrade them to newer versions, archive and refresh data with databases, manage and
resolve data conflicts, and create and work with multi‐level databases.
A database server can store one or more databases. For example, a GSM, a UMTS, and a microwave links database can be
stored on the same database server using the same RDBMS (Oracle, for example).
In this chapter, the following are explained:
• "Atoll Database Templates" on page 39
• "Customising Atoll Database Structures" on page 40
• "Atoll Management Console" on page 42
• "Creating New Databases" on page 43
• "Upgrading Existing Databases" on page 45
• "Working With a Multi‐level Databases" on page 49
• "Setting Database Access Privileges" on page 53
• "Managing Data Modifications History" on page 54

5.1 Atoll Database Templates
All the technology modules available in Atoll (GSM, UMTS, LTE, CDMA2000, TD‐SCDMA, WiMAX, Wi‐Fi, and Microwave Radio
Links) are based on database templates. These templates are used for creating  Atoll documents with the appropriate data
structure required for planning for any technology. Databases (using RDBMS) can then be created from any Atoll document.
These databases are hence also based on the data structure defined by the Atoll database templates.
In each new major release, database templates undergo modifications required to support new features. These modifications
are applied to existing  Atoll documents and databases by  Atoll and the  Atoll Management Console , respectively. It is also
possible  to  upgrade  an  existing  database  manually,  but  due  to  the  complex  nature  of  the  upgrade  process,  it  is  highly
recommended to use the Atoll Management Console for upgrading existing databases.
Each database template is an MS Access MDB file located in the templates folder in the Atoll installation folder. For the list of
tables and fields, and their relationships, in each database template, see these chapters in the 
Data Structure Reference Guide:
• Chapter 1: "GSM GPRS EDGE Data Structure"
• Chapter 2: "UMTS HSPA Data Structure"
• Chapter 3: "CDMA2000 Data Structure"
• Chapter 4: "LTE Data Structure"
• Chapter 5: "3GPP Multi‐RAT Data Structure"
• Chapter 6: "3GPP2 Multi‐RAT Data Structure"
• Chapter 7: "TD‐SCDMA Data Structure"
• Chapter 8: "WiMAX and Wi‐Fi Data Structure"
• Chapter 9: "Microwave Links Data Structure"

Database template files must not be modified without consulting Forsk customer support.

•ehT  r e l a t i o n s h i p s   i n   t h e   d a t a b a s e   s c h e m a   f i g u r e s   a r e   r e p r e s e n t e d  
duiinr e c t i o n a l   a r r o w s   s h o u l d   b e   r e a d   a s :     =   n or ¥ 1
n the tables, 
•I primary keys are listed in bold and italic characters.
n the database schema figures, 
•I primary keys  are in bold and underlined characters,
and required fields are in bold characters.

The following table lists the types of fields used in  Atoll database templates, their sizes, and the equivalent field types and
sizes in different RDBMS:

39
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

Atoll Oracle Equivalent Microsoft SQL Server Equivalent Microsoft 


Access 
Field Type Length Field Type Length Field Type Length Equivalent
Single
Float 4 FLOAT 32 real 4
Double 8 FLOAT 64 float 8 Double
Integer 4 NUMBER 11 int 4 Long Integer
Short 2 NUMBER 6 tinyint 1 Integer
Boolean 2 NUMBER 1 bit 1 Yes/No
Text 1 VARCHAR2 1 varchar 1 1
Variable Variable Variable
Text
Memo Variable VARCHAR2 2000 varchar 4000 Memo
2 > 2000
CLOB
Binary Variable image 16 OLE Object
BLOB3 Variable

1. Lengths for these fields are specified in parentheses in the database structure tables.
2. CLOB: Character large object
3. BLOB: Binary large object

If you export the contents of an  Atoll document, already connected to a database, to
another RDBMS (for example, if you export a document connected to an Oracle database
to  SQL  Server),  some  field  types  will  be  converted  according  to  the  above  table.  This
conversion does not have any impact on the document in Atoll.

For  more  information  on  the Atoll  Management  Console  and  upgrading  databases,  see  "Atoll  Management  Console"  on
page 42 and "Upgrading Existing Databases" on page 45, respectively.

5.2 Customising Atoll Database Structures
Atoll database structures can be customised by:
g custom fields to data tables,
n i d •A
d
g user‐defined default values for fields, and
n i t t e•S
g user‐defined choice lists for text fields.
n i t t e•S
Custom  fields,  as  well  as  user‐defined  default  values  and  choice  lists  for  standard  and  custom  fields,  are  stored  in 
the CustomFields table.

Adding Custom Fields to Data Tables

Custom fields can be added to data tables at different stages keeping in mind that:
m o fields 
t s u•C added  directly  to  the  Atoll  database  templates  (MDB  files),  using  Microsoft  Access  2003,  will  be
available  in  all  new Atoll  documents  created  from  that  template.  A  new  database  created  by  exporting  such  a
document will also contain these custom fields.
m fields added to an 
o t s u•C Atoll document through the  Atoll user interface will not be automatically added to the
corresponding Atoll database template. However, a new database created by exporting such a document will contain
these custom fields. For more information on adding custom fields to Atoll documents through the user interface, see
the User Manual.
m fields added to an 
o t s u•C Atoll database will be available in all new Atoll documents created from that database.
To add a custom field to a data table:
1. Add the custom field to the definition of the data table by defining its name, type, and size.
2. Add a corresponding record in the CustomFields table and enter values for each of the following fields:

User Interface 
Field Description
Caption
TABLE_NAME Database name of the data table that contains the field
COLUMN_NAME Name Database name of the field
DEFAULT_VALUE Default value User‐defined default value (optional)
CHOICE_LIST Choice list User‐defined choice list for text fields (optional)

40
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

User Interface 
Field Description
Caption
Caption of the field as it will appear in the user interface (optional but 
CAPTION Legend
recommended)
Semicolon‐separated list of the names of groups to which the field belongs 
GROUP_NAME Group
(optional)
1: Custom field only accepts values listed in the choice list
CHOICE_TYPE Restricted
0: Custom field accepts values other that those listed in the choice list
1: Custom field is read‐only in the user interface
DISPLAY_TYPE Read‐only
0: Custom field is modifiable in the user interface

Custom fields are for information only and are not taken into account in any calculation.
You  can  find  these  fields  on  the Other  Properties  tab  of  an  object  type’s Properties
dialogue.

Setting User‐defined Default Values for Fields

You can set your own default values for standard as well as custom fields using the CustomFields table. User‐defined default
values entered in the CustomFields table have precedence over the predefined default values.
To enter a user‐defined default value for any field, add a new record in the CustomFields table and enter values for each of
the following fields:

User Interface 
Field Description
Caption
TABLE_NAME Database name of the data table that contains the field
COLUMN_NAME Name Database name of the field
DEFAULT_VALUE Default value User‐defined default value

For  floating  point  default  values,  make  sure  that  all  the  users  have  the  same 
decimal symbol.

Setting User‐defined Choice Lists for Text Fields

You can set your own choice lists for standard as well as custom text fields using the CustomFields table. User‐defined choice
lists entered in the CustomFields table have precedence over the predefined choice lists.
To enter a user‐defined choice list for any text field, add a new record in the CustomFields table and enter values for each of
the following fields:

User Interface 
Field Description
Caption
TABLE_NAME Database name of the data table that contains the text field
COLUMN_NAME Name Database name of the text field
CHOICE_LIST Choice list Choice list items, one per line

For example, you can replace the default choice list available for the SUPPORT_INFO field in the Sites table with a different
list of options corresponding to the different types of towers and pylons that may exist in your network.

u o•Ycan  enter  one  of  the  choice  list  items  in  the  DEFAULT_VALUE  in order  to  set  a default value for the t
r custom text fields, you can set the CHOICE_TYPE to 1 if you want the custom text
o•F field  to  only  accept  value
ICE_TYPE 
CH
O is considered to be 0 meaning that users are allowed to enter values other than those
ined in the choice list.
fde

41
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

5.3 Atoll Management Console
The Atoll Management Console provides the database administrator the possibility of globally managing the database with
the easy‐to‐use step‐by‐step procedures which use wizard interfaces. The Atoll Management Console lets you:
e databases (see 
t a e r•C "Creating New Databases" on page 43)
• Upgrade database structures from one major version to the next (see "Upgrading Existing Databases" on page 45)
k with multi‐level databases (see 
r•Wo "Working With a Multi‐level Databases" on page 49)
• Manage data modifications history in databases (see "Managing Data Modifications History" on page 54)
• Manage user accounts and access rights (see "Managing User Accounts and Access Rights in Oracle" on page 65)
The Atoll Management Console supports:
• Oracle
t SQL Server
f o s o r c •M
i
The Atoll Management Console can be installed with  Atoll. For more information, see "Installing Atoll and Components" on
page 17. You can run the  Atoll Management Console  from the Windows Start menu program group or by double‐clicking
AMC.msc  in  the  management  subfolder  of  the Atoll  installation  folder.  The Atoll  Management  Console  runs  using  the
Microsoft Management Console environment.
When the  Atoll Management Console is run for the first time, you must register your database server in order to have the
databases installed on the server to be available in the Atoll Management Console.
To register a database server:
1. In the Atoll Management Console  window, in the left pane, right‐click the  Database item under the Administration
Atoll. The context menu appears.
2. Select Register a New Server. The Data Link Properties dialogue appears.
3. Click the  Provider tab. On the  Provider tab, select the provider for your database server depending on whether it is
Oracle or SQL Server.

Figure 5.1: Data Link Properties dialogue ‐ Provider Tab

4. Click  Next. On the  Connection tab, enter the server name, and the user name and password required to access the


database server.
You can check to see if the entered information is correct by clicking the Test Connection button.
5. Click  OK. The selected database server is registered and available in the  Atoll Management Console (see Figure 5.2
on page 42). You now have access to the features offered by the Atoll Management Console.

Figure 5.2: Atoll Management Console

42
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

The  tree  in  the  left  pane  lists  the  registered  database  servers.  Registered  database  servers  can  be  con
disconnected ().
The right pane lists the databases available on the connected database server currently selected in the left pan
user can be the owner of one of the listed databases. The user name of the owner of a database appears in pare
the title bar. One Oracle user can create and own one database. For each new database, you must create a new
of the database.

The following details are available for databases created or upgraded using the Atoll Management Console:

r the database corresponds to the current 
e h t e•Wh Atoll  v e r s i o n   ( )   o r   a   p r e v i o u s   v e r s i o n,  (n) o t   y e t   u p g r a d e d   t o
the current version.
e type of the database: master or project.
h•T
A master database can have one or more project databases created from and connected to it. For more information
on master and project databases, see "Working With a Multi‐level Databases" on page 49.
e technology of the network modelled by the database.
h•T
e path of the shared path loss folder.
h•T
To view details of a database:
1. In the right pane, right‐click the database in the list. The context menu appears.
2. Select Properties. The database Properties dialogue appears.
3. The Properties dialogue contains two tabs:
• General tab: The General tab displays the Name, Description, Owner, Type, and Version of the database.
• Statistics tab: The Statistics tab displays the number of records in each table of the database.

5.4 Creating New Databases
New databases can be created using the Atoll Management Console or by directly exporting a document to a database from
Atoll. In this section, the following are explained:
• "Creating a New Database Using the Atoll Management Console" on page 43
• "Creating a New Database Using Atoll" on page 45

5.4.1 Creating a New Database Using the Atoll Management 
Console
You can create new databases using the Atoll Management Console.

You must have administrator rights to the database and to the server for creating new
databases.

To create a new database:
1. In the  Atoll Management Console  window, in the left pane, right‐click the database server on which you want to
create a new database. The context menu appears.
2. Select New > Database. The New Database Wizard dialogue appears. 

Figure 5.3: New Database Wizard

43
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

Figure 5.3: New Database Wizard

3. Click Next. The Specify the database owner page appears.
4. Select Use the current connection if you want to create a new database using the current user, or select 
Create a new
user and enter a Name and Password to create a new user that will be owner of the new database.

If  your  password  must  contain  special  characters,  for  example,  !,  ?,  etc.,  type  the
password inside double quotation marks: "mypassword!" instead of mypassword!

5. Click Next. The Name the database and specify a network type page appears.
6. Enter a  Name for the new database and select the  Network type. The  Network type can be  one of the database
templates installed with Atoll.

Atoll and the  Atoll Management Console must have the same version. This means that
the Atoll Management Console can create databases based on the database templates
installed with Atoll of the same version.

7. Click Next. The Specify units and coordinate systems page appears.
8. Select a Transmission power unit and a Reception threshold unit.
9. Under Coordinate systems, select a Cartographic projection system and the System to be used in the database.
10. Click Next. The Ready to create database page appears. This page provides a summary of the selected parameters.
11. Click Execute. The Atoll Management Console creates the new database with the defined parameters on the selected
database server.
A database created using the Atoll Management Console contains an ATOLL_ADMIN table with the following structure:

Field Type Description


NAME Text (50) The name of the database
Text 
DESCRIPTION Description of the database
(255)
ATOLL_VERSION Text (10) The current version of Atoll
ATOLL_BUILD Integer Current build of Atoll
ATOLL_DBTYPE Text (10) Type of Atoll database (i.e., Master or Project)

44
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

Field Type Description


ATOLL_TEMPLATE Text (50) Atoll database template used to create the database
DBSCHEMA Memo An image of the schema of the original database

Among other uses, the ATOLL_ADMIN table is used to speed up the database upgrade to the next version. This table stores
the data required by the Atoll Management Console for database upgrade. 
Databases created with Atoll, instead of the Atoll Management Console, and databases that have never been upgraded using
the  Atoll  Management  Console   contain  a  smaller  ATOLL_ADMIN  table,  with  just  the  NAME,  ATOLL_VERSION,  and
ATOLL_BUILD fields. Upgrading such databases using the Atoll Management Console can take a long time because the  Atoll
Management Console must search for the data required for the upgrade in the whole database.
For more information on upgrading databases, see "Upgrading Existing Databases" on page 45.
All the tables in a database created using the Atoll Management Console (except the COORDSYS and UNITS tables) contain a
non‐modifiable, integer DB_RECORD_ID field. This field is used to store the ID of every record in the table. It is not added to
Microsoft Access databases.

5.4.2 Creating a New Database Using Atoll
You can create new databases in all supported RDBMS using Atoll.
To create a new database:
1. Run Atoll.
2. Create a new Atoll document or open an existing one. The new database will be created from this document.
3. Select Document > Database > Export. The Export to a Database dialogue appears.
4. In the Export to a Database dialogue, select the database type in the Save as type list.

By setting an option in the Atoll.ini file, you can instruct  Atoll to always use a defined
database type (MS Access, SQL Server, or Oracle). In this case, the  Export to a Database
dialogue will be skipped and the database‐specific authentication dialogue will appear
immediately. For more information, see "Setting the Type of Database Being Used" on
page 167.

5. Depending on the selected database type, enter the user name and password of the database owner.
6. Click Save. Atoll asks whether you want to connect the document to the new database.
7. Click Yes or No. Atoll creates a new database based on the document.
A database created using Atoll contains an ATOLL_ADMIN table with the following structure:

Field Type Description


NAME Text (50) The name of the database
ATOLL_VERSION Text (10) The current version of Atoll
ATOLL_BUILD Integer Current build of Atoll

e rcreating 
o f e•B the  database,  make  sure  that  you  have  defined  the  coordinate systems and units in the source do
any required 
  d e dad custom fields. Custom fields of the source document are created in the new database.

f •Iyou  want  to  add  a  custom  field  to  the  data  structure  after  you  have  created  the
database,  you  will  have  to  add  it  directly  in  the  database  and  not  through Atoll.
Custom fields added to a database are available to users connected to the database
when they create a new Atoll document from the database or refresh an existing one.

5.5 Upgrading Existing Databases
In each new major release, data structure changes must be made in the database in order to support the new features added
in  the  version.  The  data  structures  of  standalone Atoll  documents,  i.e.,  documents  not  connected  to  any  database  are
upgraded when they are opened in the new Atoll version. You can upgrade databases using the Atoll Management Console.

45
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

•D
o not skip a major version of  Atoll. For example, if you are currently using Atoll 2.8.x,
you should first upgrade the database to  Atoll 3.1.x before upgrading to  Atoll 3.2.x.
Upgrading your database will be simpler if you do not skip a major version. If you skip
or  have  skipped  an  intermediate  major  version,  you  must  upgrade  your  database
twice in order to make it compatible with the new version.
•If you are upgrading a database which was neither created nor already upgraded (at
least once) using the  Atoll Management Console , see "Upgrading Databases for the
First Time" on page 47 first.

The  Microwave  Radio  Links  template  now  supports  Radio  Series.  Similar 
microwave radios  belong  to  the  same  radio  series.  In  order  to  organise  the 
microwave  radios (microwave equipment) in radio series before the database upgrade:

1. In  Atoll  2.8.x,  add  a  custom  field  named  FAMILY  of  type  Text  (50)  to  the
MWEquipments table.
2. Enter the radio series names in this field for each radio, i.e., group the radios of
the same series under the same radio series name in the FAMILY field.
Without this manual organisation of the microwave radios into radio series, the database
upgrade will create one radio series for each microwave radio.

To upgrade a database using the Atoll Management Console:
1. In the Atoll Management Console window, in the right pane, right‐click the database that you want to upgrade. The
context menu appears.
2. Select Upgrade Database. The Database Update Wizard dialogue appears.
The  Database Upgrade Wizard  displays the current database version and the version to which the database will be
upgraded.
3. Click Next. The Name the database page appears.
4. Enter a Name and description for the database.
5. Click Next.
The  Database  Upgrade  Wizard  reads  the  database  to  determine  the 
Atoll  database  template  using  which  it  was
created. If there is more than one template corresponding to the network, select the template to be used for the
upgrade and click Next.
The Atoll Management Console upgrades the database.

f •Isome  of  the  tables  in  a  database  have  been  replaced  by  views,  the  Database
Upgrade Wizard asks to select the views to upgrade. Select the views that you want
the Atoll Management Console to upgrade and click Execute.
If, for example, the definition of a view is given by the condition:
Select Field1, Field2 from Table1 where (Condition1);
The wizard first upgrades the schema of Table1 and then upgrades the definition of
the view. The upgraded definition will take the newly added fields into account.
n you upgrade a 3GPP Multi‐RAT database, the 
e•Wh Atoll Management Console adds
any missing tables to the database. For example, a database created by exporting a
3GPP  Multi‐RAT  document  containing  only  GSM  contains  only  GSM  tables.  When
upgraded, the  Atoll Management Console  will add the UMTS and LTE tables to the
database as well.

Obsolete fields in the data structure are automatically deleted from the database by the  Atoll Management Console during
the upgrade.

If you use the  Atoll Management Console ’s history management tool, you must repair


the upgraded database in order to continue using this tool. For more information, see
"Managing Data Modifications History" on page 54.

Once the database has been upgraded to the new version,
1. Install the new Atoll versions for the end‐users, and
2. Ask all the end‐users to fully refresh data in their Atoll documents from the database.

46
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

When users open their existing documents in the new Atoll version, they are asked whether they want to upgrade the
documents’ data structures to the new version or to disconnect the documents from the database. On selecting the
upgrade option, Atoll upgrades the document data structures to make them compatible with the new version.

Notes on Document Data Structure Upgrade

e h•T
data  structure  of  an  Atoll  document  not  connected  to  any  database  is
automatically upgraded to the new Atoll version when the document is opened and
saved in the new version.
e saved, it is not possible to open the document in an earlier 
c •O
n Atoll version.
e data structure of an 
h•T Atoll document connected to a database not yet upgraded
to the new version can be upgraded by:
r opening the document in the new 
e h t i•E Atoll version, disconnecting it from the
database, and saving it in the new version, or
• Upgrading  the  database  to  the  new  version  and  then  opening  and  saving  the
document in the new Atoll version.
e disconnected from its database, it is not possible to reconnect the document
c •O
n
to any database.
e fields in the data structure of a document not connected to any database
t e l o s •O
b
are automatically deleted by Atoll when the document is saved in the new version.
f •Ithe  database  has  been  upgraded  to  the  new  version  but  an  Atoll  document
connected  to  the  database  has  not  yet  been  upgraded,  it  is  possible  to  open  the
document  in  the  previous  Atoll  version  as  read‐only.  It  is  also  not  possible  to
interact  with  the  upgraded  database  (archive,  refresh,  etc.,  are  not  allowed).  To
make  the  document  write‐accessible  in  the  previous  Atoll  version,  it  must  be
disconnected from the upgraded database.

It  is  possible  to  upgrade  an  existing  database  manually  (not  recommended)  by  adding  and  deleting  tables  and 
fields  as
required by the new version. For information on manually upgrading a database, see "Upgrading Databases Manually" on page 48.

Upgrading Databases for the First Time

If  you  want  to  upgrade  a  database  which  was  neither  created  nor  already  upgraded  (at  least  once)  using  the  Atoll
Management Console, you must first upgrade the database to the same version as the current version of the database. This
is required so that the  Atoll Management console adds the required information to the database to make it upgradable to
newer versions.
To upgrade the database:
1. Before installing the new version of Atoll, install the Atoll Management Console (if not already installed) compatible
with the existing version of Atoll.
2. Upgrade  the  database  (as  described  in  "Upgrading  Existing  Databases"  on  page 45)  using  the 
Atoll  Management
Console to the existing version of Atoll.
The Atoll Management Console adds additional fields to the ATOLL_ADMIN table and DB_RECORD_ID fields in all the
tables, as described in "Creating a New Database Using the Atoll Management Console" on page 43. Once the  Atoll
Management Console  has performed the necessary modifications, you can upgrade the database to the new  Atoll
version.
3. Install the new version of Atoll and the Atoll Management Console.
4. Upgrade the database (as described in "Upgrading Existing Databases" on page 45), using the new version of the Atoll
Management Console, to the new version of Atoll.
When a new version of the Atoll Management Console is installed, the setup overwrites the Windows registry key that stores
the information about the Admin.dll file, and the existing version of the Atoll Management Console can no longer be used.
If you have already installed the new version of the  Atoll Management Console, you will have to register the old Admin.dll
again, upgrade the database to the existing version, register the new Admin.dll, and upgrade the database to the new version
using the new Atoll Management Console.

For the  Atoll Management Console  to be able to recognise obsolete or deleted fields


from database tables, it is imperative that the ATOLL_ADMIN table exist in the database.
This  means  that  when  upgrading  a  database  for  the  first  time  using  the  Atoll
Management  Console,  the  database  administrator  will  have  to  remove  the  obsolete
fields  manually.  Once  the  Atoll  Management  Console  has  been  used  to  upgrade  a
database, it will be able to recognise obsolete or deleted fields in the following upgrades.

47
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

Upgrading Databases Manually

Due to the complex nature of the database upgrade process, it is highly recommended to use the Atoll Management Console
for upgrading existing databases. You should only proceed with a manual upgrade of your database, as described below, if
and only if an automatic upgrade using the Atoll Management Console is not possible.
The  following  procedure  is  not  recommended  for  customised  Atoll  databases  and  only  suits  very  simple  databases.
Parameters and settings (triggers, views, user privileges, custom fields, etc.) defined in advanced database configurations are
lost following the manual database upgrade.
1. In the previous version of Atoll, create a new document from the database.
2. In the new version of Atoll, open the document created in step 1. Atoll upgrades the document data structure to make
it compatible with the new version.
3. Using  the  upgraded  document,  create  a  new  database  as  explained  in  "Creating  a  New  Database  Using 
Atoll"  on page 45.

If  you  are  upgrading  your  database  using  a  script  based  on  the  data  structure
modifications listed in the Data Structure Reference Guide, you must:
d the ATOLL_ADMIN table to the database. For more information on this table,
•A
d
see "Creating a New Database Using the Atoll Management Console" on page 43.
r LTE databases, rename the smart antenna models and equipment as follows:
o•F
e  texisting 
e l •D
e smart  antenna  equipment  ("Optimum  Beamforming  Smart Antenna") from the SmartAntennas t

e  texisting 
e l •D
e smart  antenna  model  ("Optimum  Beamformer")  from  the SmartAntennasModels table.
e a new sm
t a e r•C
a") in the SmartAntennas table. Set the smart antenna model for this
n n e An
t
ent to "Conventional Beamformer."
mp i ueq

Adding a Technology in a Multi‐RAT Database

A multi‐RAT Atoll document can be based on one or two radio technologies out of a maximum of three (GSM, UMTS, and LTE).
Provided such a document has already been exported to a database, you can add a technology to the corresponding database
through the Atoll Management Console.
1. Start the Atoll Management Console.
2. When the Atoll Management Console opens, right‐click on Database in the left pane. The context menu appears.
3. Select Register a New Server. The Data Link Properties dialogue is displayed.
4. On the Provider tab, select an OLE DB provider and click Next.
5. On the Connection tab, specify a database in the Select or enter a database name field.
6. Click the Test Connection button. If the connection is successful, click OK to close the Data Link Properties dialogue.
7. Upgrade the database if necessary, as explained in "Upgrading Existing Databases" on page 45.
8. In the right pane, right‐click the database you want to upgrade with an additional technology and select  Multi‐RAT:
View/Add Technologies. The Technologies in the Multi‐RAT Database dialogue is displayed.

Figure 5.4: Technologies in the Multi‐RAT Database

9. Select the technology you want to add and click OK. 

48
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

u cannot deselect a technology already present in a multi‐RAT database.
o•Y

A new record is added to the networks table for each technology added to the database.

5.6 Working With a Multi‐level Databases
Atoll Management Console allows you to set up and work with multi‐level databases using Oracle. In this optional database
architecture,  the  master  database  is  not  directly  accessible  to  end‐users.  Groups  of  end‐users  work  with  their  respective
project databases which are in turn connected to the master database. The end‐users archive data to and refresh data from
their respective project databases, and the database administrator manages the connections and data exchange between the
project databases and the master database.
For example, you can have a country‐wide master database and more than one regional project databases. End‐users can here
work with their local region’s project database, and would not have to unnecessarily load country‐wide data.

Figure 5.5: Working With a Single Level Database

Project  databases  are intermediate  databases created  from a  common  master  database. A project database contains 


the
original master database, that remains hidden from the end‐users, and an copy of the master database accessible to the end
‐ users. When a user modifies a record, only its accessible copy is modified in the project database. The original value in the
master  database  remains  unchanged  until  the  database  administrator  archives  all  the  modifications  from  the  project databas

Figure 5.6: Working With Project Databases

Project databases can be used to improve performance and ensure data security and reliability. Instead allowing all the end‐
users to work directly with the master database, one or many project databases can be created with copies of the entire
master database or a part of the master database corresponding to a given physical location or region.

Creating and working with project databases restricts the number of users who have access to the master database. This
reduces  the  risk  of  conflicts  in  the  database  as  only  the  database  administrator  can  archive  modifications  from 
project databases to the master database.

For example, if a country‐wide network database is accessible to all end‐users:

49
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

e probability of human error increases with the number of users who can modify data.
h•T
e probability of conflicts increases with the number of users accessing the database.
h•T
e performance is reduced because the entire network is loaded every time a user accesses the database.
h•T
r routine city‐wide planning, an end‐user does not require the entire country’s database to be loaded.
o•F
Project databases can be created using filters on sites, thus allowing users to work with regional databases. A possible scenario
is depicted in the figure below:

Figure 5.7: Multiple Project Databases From a Single Master Database

Multi‐level databases can be set up using the Atoll Management Console. In this section, the following are explained:
• "Creating Project Databases" on page 50
• "Archiving Project Databases to Master Databases" on page 52
• "Refreshing Project Databases from Master Databases" on page 53

5.6.1 Creating Project Databases
You can create project databases using the Atoll Management Console.

For creating a project database, you must have enough rights to be able to create new
tables in the master database schema.

To create a project database from an existing master database:
1. In the Atoll Management Console window, in the right pane, right‐click the master database from which you want to
create a project database. The context menu appears.
2. Select Create a Project Database. The Project Database Creation Wizard dialogue appears.
3. Click Next. The Specify the server and the owner of the project database page appears.
4. Select the Destination server for the project database.
5. Under  Owner, select  Current user  if you want to create the new project database using the current user, or select
Create a new user  and enter a  User name and Password to create a new user that will be owner of the new project
database.

Some versions of Oracle let you create a new user through this dialogue but the new user
is  not  assigned  DBA  rights,  which  makes  the  new  user  unable  to  create  the 
project database. Therefore, it is recommended to create the new user with DBA rights directly
in the database before create the project database using the Atoll Management Console
using the new user account.

6. Click Next. The Name the database page appears.

50
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

7. Enter a Name and Description for the new project database.
8. Click Next. The Specify the sites to include in the project database page appears.
9. On this page, choose from one of the following options:
• Include all the sites of the master database
Select this option if you want to create a project database that contains all the data of the master database.
• Include a site list contained in the master database
Select this option if you want to create a project database containing the network data corresponding to the sites
included in a site list of the master database, and select a site list. This option is only available when at least one
site list exists in the master database.
• Select the sites to include using an SQL condition
Select this option if you want to create a project database containing the network data corresponding to the sites
that  verify  an  SQL  condition  (for  example,  sites  that  have  a  common  parameter  or  flag),  and  enter  the 
SQL condition.

• Include the sites contained within a polygon contained in a file
Select this option if you want to create a project database containing the network data corresponding to the sites
that are located inside a polygon, and select the file containing the polygon to use.
10. Click  Next. The  Atoll Management Console  creates the new project database with the defined parameters on the
selected database server.
The project database will have the type PROJECT listed in the Atoll Management Console window.

Figure 5.8: New Project Database Wizard

A project database created using the  Atoll Management Console  contains an ATOLL_ADMIN_PRJ table, in addition to the


ATOLL_ADMIN table, with the following structure:

Field Type Description


NAME Text (50) The name of the project database
Text 
MASTER_CONNECTION Connection parameters to the master database
(255)
MASTER_DBSCHEMA Text (50) The name of the original schema of the master database
Data extraction method used to select the sites to include in the project 
SEL_METHOD Short
database

51
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

Field Type Description


Text 
SEL_PARAM Site selection method parameters (the SQL condition, if any)
(255)
SEL_PGON Memo Site selection polygon (if used)

You can view the details stored in the ATOLL_ADMIN_PRJ table in the project database properties. To view the above details
of a project database:
1. In the right pane, right‐click the project database in the list. The context menu appears.
2. Select Properties. The database Properties dialogue appears.
3. The Properties dialogue contains three tabs:
• General tab: The General tab displays the Name, Description, Owner, Type, and Version of the database.
• Project Database tab: Under Source master database, the Project Database tab displays the Connection settings
to and the  Owner of the master database. Under  Site selection, this tab displays the site filtering  Method and
Settings used for creating the project database.
• Statistics tab: The Statistics tab displays the number of records in each table of the project database.
The project database contains a copy of all the original tables of the master database. The names of the original tables are
prefixed with "O_". For example, the ANTENNAS table of the master database is stored in the project database under the
name O_ANTENNAS. The COORDSYS and UNITS are not copied to the project database because their contents cannot be
different from those of the master database.
All the tables in a project database contain a non‐modifiable, integer O_RECORD_ID field and a Boolean O_CHANGED field.
The O_RECORD_ID field is used to locate records in the master database. Modified records are archived in master database
using the O_RECORD_ID of the project database and DB_RECORD_ID of the master database. The O_CHANGED field is set to
TRUE for records modified in the project database.

5.6.2 Archiving Project Databases to Master Databases
Changes made in the project databases can be archived to the master database using the  Atoll Management Console. The
Archive dialogue lets you select changes you want to archive.
To archive the changes from a project database to its master database:
1. In the Atoll Management Console window, in the right pane, right‐click the project database from which you want to
archive changes to its master database. The context menu appears.
2. Select Archive. If pending changes exist, the  Archive dialogue appears. The  Archive dialogue lists the records of the
project database for which the O_CHANGED field is TRUE.
3. In the Archive dialogue, you can do the following:
• Select a site list in Filter by site list to filter the pending changes by a site list.
k c i l•C Archive All to archive all the changes to the master database.
• Select the check boxes to the left of the changes that you want to archive and click  Archive Sel. to archive only the
selected changes.
k c i l•C Undo All to overwrite all the changes in the project database with data from the master database.
• Select the check boxes to the left of the changes that you want to undo and click Undo Sel. to overwrite only the
selected changes in the project database with data from the master database.
• Select the Check conflicts check box to see whether conflicts occurred during the archive.
A conflict occurs when the project database contains a different original value of a field than the current value of
the  field  in  the  master  database.  This  can  occur  if  the  master  database  has  been  updated  with  changes 
from another source and the project database has not yet been refreshed with data from the master database.

52
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

Figure 5.9: Archiving Changes in Master Databases

Under Errors, Atoll Management Console displays errors that occurred during archive.
4. Once archive is complete, click Close.

5.6.3 Refreshing Project Databases from Master Databases
Project databases can be refreshed with data from the master database using the  Atoll Management Console.
To refresh a project database with data from its master database:
1. In the Atoll Management Console window, in the right pane, right‐click the project database that you want to refresh
with data from its master database. The context menu appears.
2. Select Refresh. If pending changes exist, the Refresh a Project Database dialogue appears. 
3. In the Refresh a Project Database dialogue, you can:
• Select Refresh unmodified data only to keep any changes in the project database and only update unmodified
records from the master database. During the refresh, the  Atoll Management Console will reload records from
the master database for which the O_CHANGED field is FALSE in the project database.
• Select Cancel your changes and reload all data from the master database to overwrite modified and unmodified
records in the project database with data from the master database.
1. Click OK. The project database is refreshed with data from the master database.

5.7 Setting Database Access Privileges
You can assign different levels of privileges to different users for accessing (reading/writing) tables and views of a database.
You can grant user privileges for Database, Table, Column, and Row levels keeping the following in mind:
• Database Level:
Users trying to create a new Atoll document from a database are provided a list of available databases to select from.
The list can be limited to a few databases based on the user connection properties (log in).
e Level:
l b a•T
For consistency reasons, all the tables available in an Atoll database must be readable by all the users who have access
to the database. However, write access (INSERT, DELETE, UPDATE) can be granted on a limited number of tables.
n Level:
mu l o•C
Similar to table level, all the columns of all the tables in an Atoll database must be readable and selectable by all the
users who have access to the database. Different write permissions can be granted for columns of the tables. For
example, custom fields can be assigned read and write permissions without restrictions.
w Level:
o•R
Row level permissions can be set by defining custom views on Atoll tables. Access to these views can be based on user
connection  properties  (log  in),  on  external  table  references,  or  on  the  geographic  locations  of  sites  (e.g.,  through
polygons, or when using the spatial features of databases).

53
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

All of these permissions can be set as regular SELECT, INSERT, UPDATE, and DELETE privileges on database objects. Triggers
can also be used to prevent users making certain actions on the database.
Different permissions for different  users can be granted directly or through database  roles. Database roles enable you to
define permission templates, which can then be assigned to existing or new users of the database.
You can use the Atoll Management Console for defining user access rights to database tables and elements in the Atoll GUI.
For more information on managing user access rights, see "Managing User Accounts and Access Rights in Oracle" on page 65.

5.8 Managing Data Modifications History
The  Atoll Management Console allows you to keep and manage the history of modifications made in the network data by
different users. The history management tool keeps track of all the modifications made in the following  Atoll tables:

Technology Tracked Tables
Sites, Transmitters, TRGs, TRXs, Repeaters, SecondaryAntennas, Neighbours, 
GSM GPRS EDGE
NeighboursExt
Sites, Transmitters, CDMACells, Repeaters, SecondaryAntennas, Neighbours, 
UMTS HSPA
NeighboursExt
Sites, Transmitters, T4GCells, Repeaters, SecondaryAntennas, Neighbours, 
LTE
NeighboursExt
sites, ltransmitters, utransmitters, gtransmitters, lcells, ucells, gtrgs, gtrxs, 
lrepeaters, urepeaters, grepeaters, lsecondaryantennas, usecondaryantennas, 
3GPP Multi‐RAT gsecondaryantennas, lneighbours, uneighbours, gneighbours, lneighext, uneighext, 
gneighext, guneighbours, ugneighbours, glneighbours, lgneighbours, ulneighbours, 
luneighbours
Sites, Transmitters, CDMACells, Repeaters, SecondaryAntennas, Neighbours, 
CDMA2000 1xRTT 1xEV‐DO
NeighboursExt
Sites, Transmitters, WCells, Repeaters, SecondaryAntennas, Neighbours, 
WiMAX
NeighboursExt
Sites, MWLinks, MWHubs, MWPMP, MWMultiHops, MWMultiHopsLinks, 
Microwave Radio Links
MWRepeaters

You can, however, enable or disable history management for table as required (see "Enabling/Disabling Data Modifications
History Management" on page 55 for more information). If you want, you can also purge old data modifications history (see
"Purging Old Data Modification Records" on page 56 for more information).
The history management tool is available for Oracle databases. The following section describes how to set up the history
management tool using the Atoll Management Console.

5.8.1 Setting Up Data Modifications History Management
When you set up history management for any database, the  Atoll Management Console  adds new tables to the database
structure. For each tracked table, it adds a corresponding history table that has the same name as the tracked table with the
suffix  "_H".  Each  history  table  has  the  same  structure  as  the  corresponding  tracked  table,  but  with  the  following  four
additional fields. These fields enable the Atoll Management Console to store the modifications made by users to each tracked
table:

Field Type Description


HISTORY_ID Integer A unique ID of the modification history record
MODIFIED_BY Text (50) The user who made the modification
MODIFIED_DATE Date The date when the modification was made
HISTORY_STATUS Text (10) Status of the modification history record

The above fields are also added to all the tracked tables in order to store information about the latest modification. Therefore,
opening any tracked table, you can see when a record was last modified, by whom, and the type of modification.
To set up data modifications history management for a database:
1. In the Atoll Management Console window, in the right pane, right‐click the database for which you want to set up
data modifications history management. The context menu appears.
2. Select Manage Data Modifications History. The Data Modifications History Management dialogue appears.
3. Click Yes when asked whether you want to make your database compatible with the data modifications history tool.

54
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

The  Atoll Management Console updates the database structure to make it compatible with the data modifications
history tool. Data modifications history is enabled for the database.
Once  finished,  it  opens  the Data  Modifications  History  Management  dialogue  (see  Figure 5.10  on  page 56).  This
dialogue lists all the tables for which the data modifications history management has been enabled, the total numbers
of records in these tables, and the status of the history management.
All the modifications made in the tables listed in "Managing Data Modifications History" on page 54 are stored in the history
tables added to the database.
If you want, you can disable the data modifications history management for any table. For more information, see "Enabling/
Disabling Data Modifications History Management" on page 55.

5.8.2 Enabling/Disabling Data Modifications History Management
You  can  enable  or  disable  data  modifications  history  management  for  any  table.  You  can  enable  or  disable  history
management for each individual table. When history management is enabled for a table, the MODIFIED_BY, MODIFIED_DAT
E,
and HISTORY_STATUS fields are updated with each modification, and a copy of each modification is stored in the history tabl
e corresponding  to  the  table.  When  history  management  is  disabled  for  a  table,  the  MODIFIED_BY,  MODIFIED_DATE, 
and HISTORY_STATUS  fields  are  still  updated  with  each  modification,  but  the  history  of  modifications  is  not  stored  in  the co

To enable data modifications history management for a table:
1. In the Atoll Management Console window, in the right pane, right‐click the database for which you want to enable
data modifications history management. The context menu appears.
2. Select Manage Data Modifications History. The Data Modifications History Management dialogue appears.
3. In  the Data  Modifications  History  Management  dialogue, right‐click  the  table  for which  you  want  to  enable  data
modifications history management. The context menu appears.
4. Select Enable in the context menu.
Data modifications history management is now enabled for this table. The  Status in the Data Modifications History
Management dialogue is set to OK for this table.
To disable data modifications history management for a table:
1. In the Atoll Management Console window, in the right pane, right‐click the database for which you want to disable
data modifications history management. The context menu appears.
2. Select Manage Data Modifications History. The Data Modifications History Management dialogue appears.
3. In  the Data  Modifications History  Management dialogue,  right‐click  the  table  for  which  you  want  to  enable  data
modifications history management. The context menu appears.
4. Select Disable in the context menu.
History  management  is  now  disabled  for  this  table.  The Status  in  the Data  Modifications  History  Management
dialogue is set to Deactivated for this table.

5.8.3 Updating After Data Structure Upgrade
When you modify the structure of a tracked database table (for which data modifications history management is enabled),
either automatically upgrading your database using the Atoll Management Console, or manually by adding or removing fields,
or by modifying a field type, the corresponding data modifications history management table becomes invalid and has to be
updated to match the new structure of the tracked table.
The  Status  column  of  the Data Modifications History  Management dialogue shows an  error  for  the  tracked table  whose
history management table does not match its structure.
To update the data modifications history management tables:
1. In  the Atoll  Management  Console  window,  in  the  right  pane,  right‐click  the  database  whose  tables  you  want  to
update. The context menu appears.
2. Select Manage Data Modifications History. The Data Modifications History Management dialogue appears.
3. In the  Data Modifications History Management  dialogue, right‐click the table that you want to update. The context
menu appears.
4. Select Install/Repair in the context menu.
The Atoll Management Console repairs the data structure of the history management table to match the structure of
the corresponding tracked table.

55
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

5.8.4 Purging Old Data Modification Records
History management tables store the lists of all the modifications made by all the users. These tables can therefore quickly
become very large and require a lot of disk space. You can purge old data modifications history (records) from these tables in
order to gain disk space.
In this section, the following is explained:
• "Purging Old Data Modification Records of a Table" on page 56
• "Purging Old Data Modification Records of a Database" on page 57.

5.8.4.1 Purging Old Data Modification Records of a Table
To purge old data modification records from a history management table:
1. In the Atoll Management Console window, in the right pane, right‐click the database in which you want to purge old
data modifications history. The context menu appears.
2. In  the  context  menu,  select  Manage  Data  Modifications  History.  The Data  Modifications  History  Management
dialogue appears (see Figure 5.10 on page 56).

Figure 5.10: Data Modifications History Management Dialogue

3. In the  Data Modifications History Management dialogue, right‐click the table for which you want to purge old data
modifications history. The context menu appears.
4. In the context menu, select Purge. The table record purge dialogue appears (see Figure 5.11 on page 56).

Figure 5.11: Table Record Purge Dialogue

5. Under  Purge data modifications recorded before , move the slider to select from which date onwards you want to


keep the data modification history records.
All the data modification history records before this date will be deleted.  Number of records  shows the number of
records that will be left after the purge. Data size shows the size of the records that will be left after the purge.
6. Under  Options, select the  Keep creation and deletion records  check box if you want to keep the records related to
creation and deletion.
7. Click Purge. All the history records before the selected date are deleted from the history management table.
If you selected the  Keep creation and deletion records check box, creation and deletion records before the selected
date are not deleted.

56
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

5.8.4.2 Purging Old Data Modification Records of a Database
To purge old data modification records from all the history management tables of a database:
1. In the Atoll Management Console window, in the right pane, right‐click the database in which you want to purge old
data modifications history. The context menu appears.
2. In  the  context  menu,  select  Manage  Data  Modifications  History.  The Data  Modifications  History  Management
dialogue appears (see Figure 5.10 on page 56).
3. In  the Data  Modifications  History  Management  dialogue,  click  the Scheduler  button.  The  database  record  purge
dialogue appears (see Figure 5.12 on page 57).

Figure 5.12: Database Record Purge Dialogue 

4. Under Conditions, select the records to purge:
• None: Select None if you do not want to purge any record.
• Keep only records of N last months: Select Keep only records of N last months and enter the number of months
prior to which records of data modifications will be purged.
• Keep creation and deletion records: Select the Keep creation and deletion records check box if you want to keep
all the creation and deletion records, independent of the above options.
5. If you wish to purge records now, click the Run now button.
6. If you wish to schedule regular purges, under  Scheduling, define the purge frequency:
a. Period: Select the frequency of the scheduled regular purges.
b. Day: Select the day of the week (Monday to Sunday), month (1 to 28), or year (1 to 365), depending on the purge
periodicity defined in Period, on which the scheduled purges will run.
c. Time: Enter the time, i.e., the hour (0 to 23) and minutes (0 to 59) at which scheduled purges will run.
Scheduled  regular  purges  will  delete  all  the  data  modification  records  according  to  the  criteria  defined  under
Conditions.
7. Set the Off/On slider to On to turn on the scheduled purges.
Setting the Off/On slider to Off lets you suspend the scheduled purges and keep the schedule settings.
8. Click the Update button to store the schedule parameters.
The current purge status is shown under Status. Status information includes:
• Last execution:  Time of execution of the last purge.
• Result: Whether the last purge was successful or not.
• Next execution: Time of execution of the next scheduled purge.
You can click the View logs under Status to view the history of past purges (see Figure 5.12 on page 57).
9. Click the Close button.

57
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

Scheduled regular purges are programmed as a scheduled job in Oracle using the DBMS_SCHEDULER.create_job function. The
following SQL string generates scheduled job:

"BEGIN DBMS_SCHEDULER.create_job
(" "job_name => 'AHMS_%s'," "job_type => '%s',"

"job_action => '%s',"


"start_date =>
SYSTIMESTAMP," "repeat_interval => '%s'," "end_date => NULL,"

"enabled => %s,"


"comments => '%s'); END;"

Here:

Parameter Description
job_name AHMS_<schema_name>
job_type PLSQL_BLOCK
job_action Actual PL‐SQL code for the purge
start_date SYSTIMESTAMP
Frequency of the scheduled purge
repeat_interval
For example, once a month, on the 15th, at 1:30am: "freq=month;monthday=15;byhour=1;byminute=30"
end_date NULL
enabled TRUE or FALSE, based on the user input
comments Custom character string with codes for easy identification of the scheduler type

5.9 Appendices
The first appendix shows how to use SQL for Oracle database customisation and the second appendix shows how to set up
databases for co‐planning taking the example of GSM and UMTS MS Access databases.

5.9.1 Appendix 1: Advanced Customisation
You can use SQL in order to manage access to and share the Sites table (example 1), or to restrict the connection to a set of
transmitters for some users (example 2). To implement the following two examples, you must log on as the owner of the
tables through SQL Plus 8.

Example 1: Managing Site Sharing

Assumptions:
n string = AtollDB
o i t c e n no•C
M Project account = AtollADMINGSM, password = ADMINGSM
•G
S
• UMTS Project account = AtollADMINUMTS, password = ADMINUMTS
n Project account = AtollADMIN, password = ADMIN
ommo•C
To share the Sites table:
1. Create the AtollADMIN.SITES table and copy all sites from AtollADMINGSM.SITES to AtollADMIN.SITES.

SQL > connect AtollADMIN/ADMIN@AtollDB;


create
>
SQL
table
AtollADMIN.SITES
select
from
as
AtollADMINGSM.SITES;
* create
>
SQL
unique
index
AtollADMIN_SITES
AtollADMIN.SITES(NAME);
on

2. Replace the AtollADMINGSM.SITES table by an AtollADMINGSM.SITES view.

SQL > connect AtollADMINGSM/ADMINGSM@AtollDB;


SQL > drop table AtollADMINGSM.SITES;
SQL > connect AtollADMIN/ADMIN@AtollDB;
SQL > grant delete on AtollADMIN.SITES to AtollADMINGSM with grant option;

58
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

SQL > grant insert on AtollADMIN.SITES to AtollADMINGSM with grant option;


SQL > grant select on AtollADMIN.SITES to AtollADMINGSM with grant option;
SQL > grant update on AtollADMIN.SITES to AtollADMINGSM with grant option; SQL > cre

3. Follow the same procedure for UMTS (AtollADMIN.SITES already created).

SQL > connect AtollADMINUMTS/ADMINUMTS@AtollDB;


SQL > drop table AtollADMINUMTS.SITES;
SQL > connect AtollADMIN/ADMIN@AtollDB;
SQL > grant delete on AtollADMIN.SITES to AtollADMINUMTS with grant option;
SQL > grant insert on AtollADMIN.SITES to AtollADMINUMTS with grant option;
SQL > grant select on AtollADMIN.SITES to AtollADMINUMTS with grant option;
SQL > grant update on AtollADMIN.SITES to AtollADMINUMTS with grant option; SQL > cr

4. Commit.

SQL > commit;

Example 2: Managing Users by Postal Code

To restrict access to transmitters for some users by postal code:
1. Add a ‘POSTCODE’ field to the SITES table.

SQL > alter table SITES add (POSTCODE number);

2. Rename the SITES table to be able to hide it by a view.

SQL > rename SITES to PRIVATE_SITES;

3. Create a POSTCODETABLE table to link users and postcodes (one user can be linked to several postcodes).

SQL > create table POSTCODETABLE (USERNAME varchar2(30), POSTCODE number);

You can fill this table using this instruction.

SQL > insert into POSTCODETABLE values (‘USER1’, 75);

4. Create a view owned by this user hiding the actual SITES table through these commands.

SQL > create view SITES as


select * from PRIVATE_SITES
where POSTCODE in
(selectPOSTCODEfromPOSTCODETABLEwhereUSERNAME=USER)withcheckoption;

"with check option" is very important as it specifies that insert and update operations performed through the view
must result in rows that the view query can select.
5. Hide the TRANSMITTERS table, so that  Atoll can only select transmitters whose associated sites are present in the
SITES view.

SQL
rename
> TRANSMITTERS
to
PRIVATE_TRANSMITTERS;
SQL
create
> viewTRANSMITTERS
as

select * from PRIVATE_TRANSMITTERS


where SITE_NAME in (select NAME from SITES);

6. Commit.

SQL > commit;

59
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

The error message "ORA‐01402: view WITH CHECK OPTION ‐ clause violation" appears if
you try to archive a record that does not match the project.

5.9.2 Appendix 2: Setting Up Databases for Co‐planning
Two co‐planning approaches are possible in Atoll:
o‐planning GSM, UMTS, and LTE using a unified multi‐technology data structure, i.e., working with a 3GPP Multi‐RAT
•C
document.
o‐planning any two radio technologies (GSM, UMTS, LTE, CDMA2000, TD‐SCDMA, and WiMAX), with two separate
•C
data structures, by linking Atoll documents.
In terms of database, while the first approach provides an integrated multi‐technology co‐planning environment, the second
requires setting up sharing of the Sites table between the databases of the two technologies being co‐planned. The Sites table
must be shared between the databases of the two technologies being co‐planned so that the sites where sectors of both
technologies are installed are listed only once in a common Sites table. In other words, the Sites tables in the databases of the
two technologies must be views of a common Sites table.
This section describes table sharing between GSM and UMTS, although the same description can be applied to any two radio
technology modules of Atoll
You can create views to share tables that have the same structure in the databases of the two technologies being co‐planned,
i.e., the Sites and Antennas tables. In the following, we assume that the Sites tables of the GSM and UMTS documents contain
the same data and that two users, named GSMUser and UMTSUser in this example, exist in the databases.
To set up a shared Sites table for a GSM‐UMTS co‐planning project in Oracle or SQL Server:
1. Make backups of the GSM and UMTS documents.
2. Open the GSM document in Atoll.
3. Delete all the transmitters from the Transmitters table and all the sites from the Sites table.
4. Export the GSM document to the database by entering the user name and password for GSMUser.
5. Log in as GSMUser to the database.
6. Delete the Sites table.
7. Open the UMTS document in Atoll.
8. Export the UMTS document to the database by entering the user name and password for UMTSUser.
9. Log in as UMTSUser to the database.
10. Right‐click the Sites table and select Create a View from the context menu. The Create View dialogue appears.
a. Enter Sites as the view name.
b. Enter GSMUser as the name of the schema which will contain the view.
c. Select Table as object type.
d. Enter UMTSUser as the name of the schema you want to use.
e. Select Sites as the object used to model the view.
11. Click Create. The view of the Sites table from UMTSUser is created in GSMUser. The GSMUser  Sites table is now the
same as UMTSUser Sites table.
12. Set up user privileges for the Sites view in GSMUser to allow each user to Import, Update, Delete, and Select.
To set up a shared Sites table for a GSM‐UMTS co‐planning project in Microsoft Access:
1. Make backups of the GSM and UMTS documents.
2. Open the GSM document in Atoll.
3. Delete all the transmitters from the Transmitters table and all the sites from the Sites table.
4. Export the GSM document to a Microsoft Access database (GSM.mdb).
5. Open GSM.mdb in Microsoft Access.
6. Delete the Sites table.
7. Open the UMTS document in Atoll
8. Export the UMTS document to a Microsoft Access database (UMTS.mdb).
9. Open GSM.mdb in Microsoft Access.

60
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 5: Managing Databases

10. In Microsoft Access 2003 and earlier, select File > Get External Data > Link Tables. In Microsoft Access 2007 and later,


select External Data > Access Database.
11. In Microsoft Access 2003 and earlier, the Link dialogue appears. Select UMTS.mdb. In Microsoft Access 2007 and later,
the Get External Data ‐ Access Database dialogue appears, specify UMTS.mdb as data source and select Link to data
source by creating a linked table.
12. Click OK. The Link Tables dialogue appears.
13. Select the Sites table.
14. Click OK. Microsoft Access creates a Sites table in GSM.mdb which is linked to the Sites table in UMTS.mdb. The tables
contain the same data.
Once the linked Sites table has been created in the GSM database, you have to define the relations of this table with the other
tables in the database. See the Data Structure Reference Guide for detailed information on database tables.

e UMTS Sites table has more fields than the GSM Sites table. Therefore, you should
h•T
replace the GSM Sites table with the UMTS one.
•When you upgrade one by one the databases that s re the Sites table, any triggers
ah
that you might have set on the Sites table of the
atabase that is upgraded first might

be overwritten by the triggers set on the Sites t
le of the database upgraded last. In
ba order  to 
avoid  the  triggers  being  overwritten,  you 
  rename 
na c the  triggers  on  the Sites 
table  of  the  database  upgraded  first  (by 
ing, 
dd afor  example,  the  database
technology as prefix to the trigger names) before
pgrading the other database(s).

Ensuring Database Consistency Between Linked Documents

When users work with two Atoll documents and databases at the same time, it is important to have a protection mechanism
against database inconsistencies. If a user archives the changes made in one document but forgets to archive the changes
made in the other, this can create inconsistencies between the two networks.
To ensure database consistency, you can save or archive the linked documents at the same time, i.e., when a user saves or
archives one document, Atoll automatically saves or archives the other. This can be done using a macro triggered by the save
or archive operation.

61
Atoll 3.2.1 Administrator Manual
Chapter 5: Managing Databases © Forsk 2014

62
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 6: Multi‐user Environments

6M
i‐user Environments
tlu
A multi‐user environment is where more than one user work simultaneously on an Atoll project, sharing data over a network.
In large, structured multi‐user environments, groups of users can work on specific parts of a common, large‐scale project. For
example, different user groups can work on different regions of a country‐wide network. In this chapter, the following are
explained:
• "Setting Up Multi‐user Environments" on page 63
• "Components of Multi‐user Environments" on page 63
• "Managing User Accounts and Access Rights in Oracle" on page 65

6.1 Setting Up Multi‐user Environments
The  general  process of  setting  up  a  multi‐user  environment  is  described  below.  Each  component  is  described  in 
detail  in "Components of Multi‐user Environments" on page 63.
1. Create the master  Atoll document with the required network data and geographic data. For more information, see
"Master Atoll Document" on page 64 and "Shared Geographic Data" on page 64.
2. Export the master  Atoll document to a new database and keep the document connected to the new database. For
more information, see "Master Database" on page 64.
3. Create  the  private  path  loss  matrices  folder  for  the  master Atoll  document  and  calculate  the  private  path  loss
matrices. For more information, see "Shared Path Loss Matrices" on page 65.
4. Create  user  Atoll  documents  from  the  master  database.  For  more  information,  see  "User  Atoll  Documents"  on
page 65.
5. In the user Atoll documents, add the required geographic data and set the master Atoll document’s private path loss
matrices folder as the shared path loss matrices folder of the user documents.

e h•T Atoll administrator should regularly update the shared path loss matrices.
•A
s  the  users  work  on  the  network  and  archive  changes  in  the  database,  the  Atoll
administrator  should  regularly  run  data  integrity  checks  on  the  master  Atoll
document  after  loading  modified  data  from  the  master  database.  For  more
information, see "Appendix 1: Checking Data Integrity" on page 69.

6.2 Components of Multi‐user Environments
Figure 6.1 on page 63 shows the components of a multi‐user environment.

Figure 6.1: Components of Multi‐user Environments

63
Atoll 3.2.1 Administrator Manual
Chapter 6: Multi‐user Environments © Forsk 2014

In this section, the following are explained:
• "Master Atoll Document" on page 64
• "Master Database" on page 64
• "Shared Geographic Data" on page 64
• "Shared Path Loss Matrices" on page 65
• "User Atoll Documents" on page 65

6.2.1 Master Atoll Document
It is the source  Atoll document that contains the entire project’s  network data.  It is  created and maintained  by  the  Atoll
administrator. This document is initially used to create the radio network database with which all the end‐users work. The
master Atoll document allows the administrator to globally manage all the data shared by the end‐users.
The  master Atoll  document  is  also  used  for  calculating  path  loss  matrices  for  the  transmitters  of  the  entire  network  and
keeping the path loss matrices up to date with the user modifications to the radio network data. The document also contains
the required geographic data for path loss calculations. Geographic data are usually located on file servers and linked to the
document, not embedded in the ATL file. The private path loss matrices of this document are used as shared path loss matrices
by the end‐users. The shared path loss matrices folder is usually located on a file server accessible to all the users on the
network.
For exceptionally large networks, you can also work with more than one master  Atoll document (for example, one master
document per region). However, the multi‐user environment set up remains the same. Master  Atoll documents should not
have redundant radio network data (same sites, for example), and should ideally cover different geographical regions. For
more information on regionalisation, see "Appendix 2: Database Regionalisation" on page 70.

If you wish to add custom fields in the  Atoll document, you should first add the field in
the database, and then update your  Atoll document from the database. Custom fields
added in an Atoll document connected to a Microsoft Access database are automatically
added to the database. However, this is not the case with other RDBMS, such as Oracle.

6.2.2 Master Database
The master database  stores the  radio network  data  shared  by  all the  end‐users.  It  can be  created by exporting  the  radio
network data in the master  Atoll document to a database from  Atoll (for more information, see "Creating a New Database
Using Atoll" on page 45). An empty database can also be created using the  Atoll Management Console, and populated with
data later on (for more information, see "Creating a New Database Using the Atoll Management Console" on page 43).
Only radio network data are stored in the database, i.e., sites, transmitters, antennas, etc. Parameters related to geographic
data files, their paths, folder configurations, prediction definitions, zones, traffic maps, measurements can be stored in user
configuration files (see "Configuration Files" on page 117 for details).
For large networks, you can subdivide the network’s master database into regions. For more information on regionalisation,
see  "Appendix  2: Database  Regionalisation"   on  page 70.  For  more  information  on  database  management, 
see "Managing Databases"   on  page 39.  The  recommended  database  server  configuration  is  provided  in 
"Recommended  Hardware  and Software" on page 14. 

The  same  database  server  can  be  used  to  store  one  or  more  master  databases
corresponding  to  different  technologies.  For  example,  a  GSM  database  and  a 
UMTS
database can be stored on the same database server using the same RDBMS (Oracle, for example).

6.2.3 Shared Geographic Data
Geographic data files are usually stored on a file server accessible to and shared by all the users working on the same network.
User configuration files (CFG or GEO) are used to store the parameters related to geographic data. For more information, see
"Configuration Files" on page 117.
The administrator can set up different user configuration files (CFG) for separate user groups. User configuration files can be
created  so  that  only  the  geographic  data  required  by  a  user  are  loaded.  It  is  possible  to  load  a  user  configuration  file
automatically when running Atoll. User configuration files can be shared and exchanged between users working on the same
project. For more information, see "Atoll Command Line Parameters" on page 24.
Geographic data files are usually large files, and it is recommended that these be stored externally and not embedded in 
Atoll
documents. The recommended file server configuration is provided in "Recommended Hardware and Software" on page 14. 

64
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 6: Multi‐user Environments

If  users  modify  geographic  data  locally,  for  example  edit  clutter  or  traffic  in  their
respective projects, they should store these modified geographic data locally so that the
modifications do not impact other users.

6.2.4 Shared Path Loss Matrices
Shared path loss matrices are usually stored on a file server accessible to and shared by all the users working on the same
project. These path losses are calculated using the master  Atoll document by the  Atoll administrator. The private path loss
matrices of the master Atoll document are used as shared path loss matrices by the end‐users.
The Atoll administrator is the owner of the shared path loss matrices, and must have read/write access to the shared path
loss matrices folder. End‐users should have read‐only access to this folder.
Atoll  document  with  the  modifications  made  to  the  master
It  is  the  administrator’s  duty  to  regularly  update  the  master 
database by the end‐users, and to calculate the shared path loss matrices using the master  Atoll document on a routine basis.
This task can be carried out using a macro. For more information, see "Appendix 3: Calculating Path Loss Matrices" on page 70.
Shared path loss matrices are available for use in calculations to all the end‐users. However, end‐users are not allowed to
modify the shared path loss matrices.

The shared path loss matrices must be unlocked in order for users to be able to work with
them. You can check whether path loss matrices are unlocked in the Propagation tab of
the Transmitters folder’s properties dialogue.

6.2.5 User Atoll Documents
User Atoll documents are created from the master database. These can contain the entire project network data or only a part
of it. User documents are the working documents of the  Atoll end‐users connected to the master database, the geographic
data, and the shared path loss matrices folder.
You should load data from the master database in each user  Atoll document and save it before setting the shared path loss
matrices folder for the document. For any modifications made by end‐users in their  Atoll documents that render some shared
path losses invalid, Atoll calculates the invalid path loss matrices locally for the end‐users and stores them in their private path
loss  matrices  location.  Shared  path  loss  matrices  are  only  used  in  calculations  if  valid  private  path  loss  matrices  are  not
available. Therefore, in order to use shared path loss matrices, you must delete the corresponding private path loss matrices.
If users are going to work on regions of a network, the regionalisation should be set up before creating the user documents.
For more information on regionalisation, see "Appendix 2: Database Regionalisation" on page 70.

If you wish to add custom fields in the  Atoll document, you should first add the field in
the database, and then update your  Atoll document from the database. Custom fields
added in an Atoll document connected to a Microsoft Access database are automatically
added to the database. However, this is not the case with other RDBMS, such as Oracle.

6.3 Managing User Accounts and Access Rights in  Oracle


The Atoll Management Console enables you to create and delete database user accounts, edit user account information, and
define user access rights to different components of a project such as database tables, and radio data and parameters in 
Atoll.
In order to be able to manage user accounts and access rights using the  Atoll Management Console, you first have to make
the database compatible with the user management tool. This is done automatically when the user management tool is run
on a database for the first time. The database has to be of the same version as the Atoll Management Console being used to
manage user accounts and access rights.
To make your database compatible with the user management tool:
1. In the Atoll Management Console window, right‐click the database whose user accounts you wish to manage.
2. Select Manage Users. The User Management dialogue appears (see Figure 6.2 on page 66).
3. Click Yes when asked whether you want to make your database compatible with the user management tool.
The Atoll Management Console adds a GUIUserRights table in the database with the following structure:

Field Type Description


ATOLL_USER Text (50) Name of the user account

65
Atoll 3.2.1 Administrator Manual
Chapter 6: Multi‐user Environments © Forsk 2014

Field Type Description


RIGHTS Memo Semi‐colon separated set of interface access rights

Each user’s interface access rights are stored in a unique record in the GUIUserRights table. The contents of the RIGHTS field
have the following syntax:
RADIOPARAMS;CALCPARAMS;PROPAGMODELS;PASSWORD
The syntax is explained in detail in "Defining Database and Interface Access Rights" on page 66.
If  interface  access  rights  are  not  defined  for  a  database,  i.e.,  the  GUIUserRights  table  does  not  exist,  all  the  users  have
unrestricted access to the Atoll interface.
If interface access rights are defined for a database, and a user creates a document from the database or opens a document
connected to the database, Atoll retrieves the interface access rights for the user when he enters his user name and password
to access the database.
If the database is not reachable, the user is not listed in the GUIUserRights table, or if the password is not correct, the user’s
interface access rights are set to read‐only by default (for more information, see "Defining Database and Interface Access
Rights" on page 66). If the user is listed in the GUIUserRights table, his interface access rights are read and applied to the 
Atoll
interface (table grids and properties dialogues). A message is displayed in the Event Viewer window to inform the user of his
interface access rights. It is possible to remove interface access restrictions by disconnecting the document from the database.
However, a disconnected document cannot be reconnected to the database.
The GUIUserRights table is also stored in the Atoll document, and is updated when the document is saved. Hence, users can
work on their documents without actually being connected to the database, and still have their usual interface access rights
applied in the document.

Atoll does not ask for the user name and password when a document is opened using the
API. The interface access rights stored in the document are used.

When database connection properties are modified for a document, for example, when a different user enters his user name
and password in the connection properties, Atoll reads and applies the interface access rights defined for the new user.

6.3.1 Defining Database and Interface Access Rights
For any existing user account, you can set the database and 
Atoll interface access rights using the Atoll Management Console.
To manage database and Atoll interface access rights for an existing user account:
1. In the Atoll Management Console window, right‐click the database whose user accounts you wish to manage.
2. Select Manage Users. The User Management dialogue appears (see Figure 6.2 on page 66).

Figure 6.2: User Account and Access Rights Management Dialogue

3. Under Atoll projects, select the project for which you want to manage user accounts.

66
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 6: Multi‐user Environments

4. Under List of users, select the user account whose database and interface access rights you want to set.
Users who have database access rights in the selected database are marked with the green icon () . Users who do
not have any database access rights in the selected database (Category = No Access) are marked with the red icon
. Locked (deactivated) user accounts are marked with a yellow lock icon ()
() . For more information on locked
user accounts, see "Creating and Editing User Accounts" on page 68.
You can use the Filter list to display:

• All users:  U s e r s   w i t h   a c c e s s  , (  )w i t h o u t   a c c e s s  , (  )o r   l o c k e d   ( )
• Users with access  ( )
• Administrators: Users with administrator rights among the users with access
• Standard users: Users with standard rights among the user with access
• Read‐only users: Users with read‐only access rights among the users with access
5. Under Database rights, you can select a database access Rights category:
• No access: User without read and write access to the database. The database is not visible to these users and they
are not allowed to create Atoll documents based on this database.
• Read‐only: Users allowed to create Atoll documents from the database but without write permissions to any table
of the database, i.e., users cannot archive changes made in the Atoll document to the database.
• Standard: Users with read and write access to some tables of the database. These tables include radio network
data tables including sites, transmitters, cells, subcells, repeaters, remote antennas, secondary antennas, intra‐
and inter‐technology neighbours and exceptional pairs, site and transmitter lists, microwave point‐to‐point, point‐
to‐multipoint, and multi‐hop links, microwave repeaters, microwave hubs.
• Administrator: Users with read and write access to all the tables of the database.
Database access rights are stored in the user account properties in Oracle. If you are working with an RDBMS other
than Oracle, you will not be able to set database access rights. You can, however, still set interface access rights as
explained below.
6. Under Interface rights, you can select interface access rights for:
• Access to radio data: 
• Full: (RADIOPARAMS = ALL) Users with read and write access to all the tables and properties dialogues.
• Standard:  (RADIOPARAMS  =  STD)  Users  with  read  and  write  access  to  radio  network  data  tables  and
properties  dialogues  including  sites,  transmitters,  cells,  subcells,  repeaters,  remote  antennas, 
secondary
antennas, intra‐ and inter‐technology neighbours and exceptional pairs, site and transmitter lists, microwave point‐to
• Read‐only: (RADIOPARAMS = NONE) Users with read‐only access to tables and properties dialogues, i.e., users
are not allowed to modify radio network data and parameters.

• Database  access  rights  and  access  rights  to  radio  data  in  Atoll  can  be  set
independently. For example, a user can have full access rights in the interface but not
be allowed to archive changes to the database.
• However, access rights in the interface should only be granted if the user has at least
read‐only access to the database.

• Access to calculation settings: 
• All:  (CALCPARAMS  =  ALL)  Users  with  read  and  write  access  to  all  coverage  predictions,  their  calculation
settings,  and  to  microwave  calculation  settings  (Models,  Objectives,  and  Clutter  Categories  tabs  of  the
Properties dialogue of the Microwave Radio Links folder).
• Standard: (CALCPARAMS = STD) Users with access to customised coverage predictions only, and allowed to
modify coverage conditions and display settings. These users do not have access to the microwave calculation
settings mentioned above.
• Customised only: (CALCPARAMS = NONE) Users with access to customised coverage predictions only, but not
allowed to modify coverage conditions and display settings. These users do not have access to the microwave
calculation settings mentioned above.
• Access to propagation models: 
• Full: (PROPAGMODELS = ALL) Users with read and write access to all propagation models and their properties.
• Read only:  (PROPAGMODELS = NONE) Users with read‐only access to the properties of all the propagation
models. Adding and deleting propagation models is also not allowed.
• Password confirmation: 
• Yes:  (PASSWORD  =  STD) Atoll  will  ask  users  for  password  when  opening  a  document  connected  to  this
database or creating a new document from this database.
• No: (PASSWORD = NONE) Atoll will not ask users for password when opening a document connected to this
database or creating a new document from this database.

67
Atoll 3.2.1 Administrator Manual
Chapter 6: Multi‐user Environments © Forsk 2014

7. Click OK. The database and interface access rights of the selected user are saved in the database.

6.3.2 Creating and Editing User Accounts
You can create and edit user accounts using the Atoll Management Console.
To manage user accounts:
1. In the Atoll Management Console window, right‐click the database whose user accounts you want to manage.
2. Select Manage Users. The User Management dialogue appears (see Figure 6.2 on page 66).
3. To create a new user account:
a. Under Users, click Create. The Create/Edit User dialogue appears (Figure 6.3 on page 68).
b. Under Identification, enter a User name (in block letters) and Password, and select a Tablespace for the new user
account.
c. Under Advanced, select Use operating system authentication if you want to use OS authentication prefix with the
user name, and Unlimited tablespace privilege if you want to assign this system privilege to the user.
d. Click OK. The new user account is created.
4. To edit a user account:
a. Under List of users, select the user account whose information you want to edit.
b. Under Users, click Edit. The Create/Edit User dialogue appears (Figure 6.3 on page 68).
c. Under Identification, modify the user’s Password or assigned Tablespace.
d. Under Advanced, select Use operating system authentication if you want to use OS authentication prefix with the
user name, and Unlimited tablespace privilege if you want to assign this system privilege to the user.
e. Click OK. The modified user account information is saved.
5. To deactivate (lock) a user account:
a. Under List of users, select the user account you want to deactivate.
b. Under Users, click Edit. The Create/Edit User dialogue appears (Figure 6.3 on page 68).
c. Under Advanced, select Account locked check box.
d. Click OK. The user account is deactivated and can no longer be used.
6. To delete a user account:
a. Under List of users, select the user account you want to delete.
b. Under Users, click Delete. The user account is deleted.

Figure 6.3: Creating or Editing a User Account

6.3.3 Resetting User Database Permissions
The permissions reset feature enables you to rebuild user database permissions while keeping existing role assignments.
You can reset user permissions from the Atoll Management Console.

68
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 6: Multi‐user Environments

This feature is particularly useful after a major Atoll upgrade or after tables were added as a result of a project customization,
and for all unforeseen reasons which can require fixing user database permissions.
The permissions reset process does not remove any object privileges which assigned prior to rebuilding the database. It just
looks for new objects and assigns permissions based on existing user profiles ("Administrator", "Standard" or "Read‐only").
To reset user permissions:
1. Open the database for which you want to reset user permissions in the Atoll Management Console window.
2. Under Database rights, click on the Reset button. 
3. Acknowledge the message informing you about the rebuilding process duration.

The duration of the database rebuilding process depends on the number of users and on
the database processing speed.

6.4 Appendices
The following appendices provide additional information on:
• "Appendix 1: Checking Data Integrity" on page 69
• "Appendix 2: Database Regionalisation" on page 70
• "Appendix 3: Calculating Path Loss Matrices" on page 70
• "Appendix 4: Path Loss Matrices From Different Sources" on page 71

6.4.1 Appendix 1: Checking Data Integrity
Atoll includes data consistency and integrity checking tools that allow you to check data consistency between the different
Atoll tables (Sites, Transmitters, etc.). It is recommended that the  Atoll administrator runs data integrity checks regularly on
the master Atoll document after it is updated with data modifications in the master database.
To perform data integrity check:
n •I Atoll, select Document > Data Audit > Integrity Check.
Atoll  searches  for  records  with  integrity  problems  which  can  occur  with  objects  that  have  foreign  keys.  Integrity
problems occur when records refer records that do not exist. For example, transmitters located on sites that do not
exist in the Sites table, transmitters referring to an antenna that does not exist in the Antennas table, etc.). Records
with integrity problems can be deleted when found.
To perform undefined record check:
n •I Atoll, select Document > Data Audit > Undefined Record Check.
Atoll  searches  for  undefined  records  such  as  sites  without  transmitters,  transmitters  without  subcells,  TRXs,  and
neighbours in GSM, transmitters without cells, and cells without neighbours in UMTS, CDMA2000, TD‐SCDMA, LTE,
WiMAX, and Wi‐Fi. Atoll lists all the undefined records found in the Event Viewer.
To perform duplicate record check:
n •I Atoll, select Document > Data Audit > Duplicate Record Check.
Atoll searches for records that have the same identifier. For example, sites with the same name, transmitters with the
same name, etc. Atoll lists all the duplicate records in the Event Viewer.
To perform microwave data check:
1. In Atoll, select Document > Data Audit > Microwave Link Data Check. The Microwave Data Check dialogue appears.
2. In the Microwave Data Check dialogue, select the data to check.
3. Select List all the checks to list all the checks in the Event Viewer .
4. Click OK.
Atoll searches the microwave links tables for problems related to the selected checks.  Atoll lists the problems found
in the Event Viewer.

If  you  fix  any  problems  in  the Atoll  document,  you  must  archive  the  changes  in  the
database in order to fix the problems for all the users working with that database.

69
Atoll 3.2.1 Administrator Manual
Chapter 6: Multi‐user Environments © Forsk 2014

6.4.2 Appendix 2: Database Regionalisation
You can subdivide the network into regions in the following ways:
• Static regionalisation using multi‐level databases 
Static regionalisation can be based on site lists, SQL filters, or geographic zones in the form of filtering polygons. Static
regionalisation is carried out by creating project databases from the master database, i.e., multi‐level databases as
explained in "Working With a Multi‐level Databases" on page 49.
Static  regionalisation  requires  manual  synchronisation  between  the  master  database  and  the  regional  project
databases using the Atoll Management Console. In a multi‐level database environment, end‐users work with project
databases, refreshing and archiving data as they continue to work on their respective regions of the network. Data
archive  and  refresh  between  the  project  databases  and  the  master  database  are  performed  by  the 
administrator alone.

: High performance.
e g a t n a v •A
d
• Disadvantage: Manual Synchronisation between the master and the project databases.
• Dynamic regionalisation using Oracle Spatial or Oracle Locator 
Dynamic regionalisation can be based on Oracle Spatial, which does not create separate regional databases from the
master  database,  but  rather  lets  the  different  users  work  with the master database directly  while managing their
access privileges according to their user connection properties. In an  Atoll multi‐user environment, you can create
such regionalisation without installing Oracle Spatial. You can implement this solution using Oracle Locator, which is
provided in the standard Oracle installation.
Specific  documents  explaining  how  to  set  up  this  regionalisation,  using  Oracle,  in  any 
Atoll  master  database  are
available  on  demand  from  Forsk.  These  documents  provide  scripts  for  creating  different  types  of  users,  e.g.,  the
administrator, advanced user, read‐only user, etc., and give examples of how to set up regions in the network and how
to assign user rights to each region.
: Once set up, does not require administrator intervention.
e g a t n a v •A
d
• Disadvantage: Slow performance (archiving data in the database takes a long time).

6.4.3 Appendix 3: Calculating Path Loss Matrices
You can calculate only the invalid path loss matrices or all the path loss matrices in Atoll or using a macro.

You should only calculate the shared path loss matrices when they are not being accessed
by users.

To calculate invalid path loss matrices only:
1. Right‐click the Transmitters folder. The context menu appears.
2. Select Calculations > Calculate Path Loss Matrices.
Atoll calculates path loss matrices for all active transmitters in the folder or subfolder. Only invalid and nonexistent
matrices are calculated.
To calculate all the path loss matrices (valid and invalid):
1. Right‐click the Transmitters folder. The context menu appears.
2. Select Calculations > Force Path Loss Matrix Calculation.
Atoll calculates all the path loss matrices for all active transmitters in the folder or subfolder.
You can write a script or macro to update path loss matrices automatically at regular intervals. The script or macro should:
1. Start Atoll (Start).
2. Open the master Atoll document (Open).
3. Refresh the contents of the document with data from the database (Refresh).
4. Calculate path loss matrices (Calculate).
5. Save the master Atoll document (Save).
6. Close Atoll (Exit).
A path loss update macro is available from Forsk on demand.

70
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 6: Multi‐user Environments

You should also make regular backups of the master  Atoll document. The above macro
could also create a backup ATL file of the master Atoll document on a regular basis. This
file can be overwritten daily, whenever path losses are calculated.

6.4.4 Appendix 4: Path Loss Matrices From Different Sources
Atoll  calculates  path  loss  matrices  and  creates  path  loss  matrix  storage  files  using  the  propagation  models  assigned  to
transmitters. Atoll can also work with path loss matrices calculated by other tools. To use path loss matrices from different
sources, make sure that the path loss matrices are:
e in a format compatible with 
l b a l i a •Av Atoll. File formats are described in "Path Loss Matrix File Format" on page 92.
d at the location set in the 
e r o t•S Atoll document.
. If the path loss matrices are not valid, 
d i l a•V Atoll will automatically calculate them the next time they are used.

Path loss matrices calculated by other tools should include antenna pattern attenuation
(i.e., should be masked) in order to be consistent with the path loss matrices calculated
by Atoll.

The  shared  path  loss  matrices  architecture  can  contain  path  loss  matrices  from  different  sources.  The  Pathloss.dbf 
file
provides the means to manage several sources of path loss matrices. This file stores, among other information, the validity status an

Let us assume that users of group A wish to work with the path loss matrices generated by  Atoll only, and users of group B
wish  to work with path loss matrices generated  by a different tool for a part of  the network and with path loss matrices
generated by Atoll where the matrices from the other tool are not available.
Let  us  assume  that  the  shared  path  loss  matrices  folder  where  Atoll  stores  the  generated  path  loss  matrices  files  is
C:\Path_Loss_Internal, and the folder where the other tool stores its path loss matrices is C:\Path_Loss_External.
The Pathloss.dbf file in the Path_Loss_Internal folder will store the path to the LOS files for each transmitter in the network.
This folder can be set as the shared path loss matrices folder in the ATL files of group A users.
To set up the shared path loss matrices folder for group B users, you must create a new folder with a Pathloss.dbf file in it.
This folder can be called C:\Path_Loss_Mixed. The Pathloss.dbf file in this folder can be a copy of the Pathloss.dbf file in the
Path_Loss_Internal folder with the paths to the LOS files modified. For example, if the path loss matrices generated by the
other  tool  include  Transmitter_1,  the  Pathloss.dbf  file  in  the  Path_Loss_Mixed  folder  will  have  all  the  same  entries 
as Pathloss.dbf file in the Path_Loss_Internal folder except for the path for the Transmitter_1 path loss matrices file.  Figure
6.4 on page 71 explains this concept.

Figure 6.4: Path Loss Architecture for Multiple Source Path Loss Matrices

Once the Pathloss.dbf file in the Path_Loss_Mixed folder is updated with the correct paths corresponding to the different
transmitters, the Path_Loss_Mixed folder can be set as the shared path loss matrices folder in the ATL files of group B users.
If a group B user changes some parameters which make some path loss matrices invalid,  Atoll will recalculate the private path
loss matrices with the propagation models assigned to the transmitters. The external path loss matrix will no longer be used.

71
Atoll 3.2.1 Administrator Manual
Chapter 6: Multi‐user Environments © Forsk 2014

72
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 7: Coordinate Systems and Units

7 Coordinate Systems and Units
7.1 Coordinate Systems
A map  or a geo‐spatial  database is a flat representation of data collected over a curved surface. Projection is a means of
producing all or part of a spheroid on a flat surface, which cannot be done without distortion. It is up to the cartographer to
choose the characteristic (distance, direction, scale, area, or shape) that he wants to produce accurately on a flat surface at
the  expense  of  the  other  characteristics,  or  to  make  a  compromise  on  several  characteristics.  The  projected  zones 
are referenced using cartographic coordinates (metre, yard, etc.). Two projection methods are widely used:

• The Lambert Conformal‐Conic Method: A portion of the earth is projected on a cone conceptually secant at one or
two standard parallels. This projection method is useful for representing countries or regions that have a predominant
east‐west expanse.
• The Universal Transverse Mercator (UTM) Method:  A portion of the earth is projected on a cylinder tangent to a
meridian (which is transverse or crosswise to the equator). This projection method is useful for mapping large areas
that are oriented north‐south.
A  geographic  system  is  not  a  projection,  but  a  representation  of  a  location  on  the  surface  of  the  earth  in 
geographic
coordinates (degree‐minute‐second, gradient) with the latitude and longitude with respect to a meridian (e.g., Paris for NTF system a

References:
1. Snyder, John. P., Map Projections Used by the US Geological Survey, 2nd Edition,
United States Government Printing Office, Washington, D.C., 313 pages, 1982.
2. http://www.colorado.edu/geography/gcraft/notes/gps/gps_f.html 
3. http://www.epsg.org/Geodetic.html
4. http://geodesie.ign.fr/contenu/fichiers/documentation/pedagogiques/
transfo.pdf (French)

7.1.1 Definition of a Coordinate System
A geographic coordinate system is a latitude and longitude coordinate system. The latitude and longitude are related to an
ellipsoid, a geodetic datum, and a prime meridian. The geodetic datum provides the position and orientation of the ellipsoid
relative to the earth.
Cartographic  coordinate systems  are obtained  by transforming each (latitude, longitude) value into an  (easting, northing)
value. A projection coordinate system is obtained by transforming each (latitude, longitude) value into an (easting, northing)
value.  Projection  coordinate  systems  are  geographic  coordinate  systems  that  provide  longitude  and  latitude,  and 
the
transformation method characterised by a set of parameters. Different methods might require different sets of parameters. For exam

e longitude of the natural origin (central meridian)
h•T
e latitude of the natural origin
h•T
e False Easting value
h•T
e False Northing value
h•T
•A scaling factor at the natural origin (central meridian)
Basic definitions are presented below.

Geographic Coordinate System

The  geographic  coordinate  system  is  a  datum  and  a  meridian. 


Atoll  enables  you  to  choose  the  most  suitable  geographic
coordinate system for your geographic data.

Datum

The datum consists of the ellipsoid and its position relative to the WGS84 ellipsoid. In addition to the ellipsoid, translation,
rotation, and distortion parameters define the datum.

Meridian

The standard meridian is Greenwich, but some geographic coordinate systems are based on other meridians. These meridians
are defined by the longitude with respect to Greenwich.

73
Atoll 3.2.1 Administrator Manual
Chapter 7: Coordinate Systems and Units © Forsk 2014

Ellipsoid

The ellipsoid is the pattern used to model the earth. It is defined by its geometric parameters.

Projection

The projection is the transformation applied to project the ellipsoid of the earth on to a plane. There are different projection
methods that use specific sets of parameters.

Projection Coordinate System

The  projection  coordinate  system  is  the  result  of  the  application  of  a  projection  to  a  geographic  coordinate  system.  It
associates a geographic coordinate system and a projection.  Atoll enables you to choose the projection coordinate system
matching your geographic data.

7.1.2 Types of Coordinate Systems in Atoll
Depending on the working environment, there can be either two or four coordinate systems used in Atoll. If you are working
with stand‐alone documents, i.e., documents not connected to databases, there are two coordinate systems used in Atoll:
n coordinate system
o i t c e j o r•P
y coordinate system
a l p s •D
i
If you are working in a multi‐user environment, Atoll uses four coordinate systems:
n coordinate system for the 
o i t c e j o r•P Atoll document
y coordinate system for the 
a l p s •D
i Atoll document
l projection coordinate system for the database
a n r e t n•I
l display coordinate system for the database
a n r e t n•I

Projection Coordinate System

The projection coordinate system is the coordinate system of the available raster geographic data files. You should set the
projection coordinate system of your Atoll document so that it corresponds to the coordinate system of the available raster
geographic data. You can set the projection coordinate system of your document in the Options dialog.
All the raster geographic data files that you want to import and use in an  Atoll document must have the same coordinate
system. You cannot work with raster geographic data files with different coordinate systems in the same document.

If  you  import  vector  geographic  data  (e.g.,  traffic,  measurements,  etc.)  with 
different coordinate systems, it is possible to convert the coordinate systems of these data into
the projection coordinate system of your Atoll document.

The projection coordinate system is used to keep the coordinates of sites (radio network data) consistent with the geographic
data.
When you import a raster geographic data file,  Atoll reads the geo‐referencing information from the file (or from its header
file, depending on the geographic data file format), i.e., its Northwest pixel, to determine the coordinates of each pixel. Atoll
does not use any coordinate system during the import process. However, the geo‐referencing information of geographic data
files are considered to be provided in the projection coordinate system of the document.

Display Coordinate System

The display coordinate system is the coordinate system used for the display, e.g., in dialogs, in the Map window rulers, in the
status bar, etc. The coordinates of each pixel of geographic data are converted to the display coordinate system from the
projection coordinate system for display. The display coordinate system is also used for sites (radio network data). You can
set the display coordinate system of your document in the Options dialog.
If you import sites data, the coordinate system of the sites must correspond to the display coordinate system of your  Atoll
document.
If you change the display coordinate system in a document which is not connected to a database, the coordinates of all the
sites are converted to the new display system.

If the coordinate systems of all your geographic data files and sites (radio network data)
are the same, you do not have to define the projection and display coordinate systems
separately. By default, the two coordinate systems are the same.

74
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 7: Coordinate Systems and Units

Internal Coordinate Systems

The internal coordinate systems are the projection and the display coordinate systems stored in a database. The projection
and  display coordinate systems  set  by  the  administrator  in the central Atoll  project are  stored  in the  database when  the
database is created, and cannot be modified by users. Only the administrator can modify the internal coordinate systems
manually by editing the entries in the CoordSys and the Units tables. All  Atoll documents opened from a database will have
the internal coordinate systems of the database as their default projection and display coordinate systems.
When exporting an Atoll project to a database, the currently chosen display coordinate system becomes the internal display
coordinate system for the database, and the currently chosen projection coordinate system becomes the internal projection
coordinate system for the database.
Although Atoll stores both the coordinate systems in the database, i.e., the projection and the display coordinate systems,
the only relevant coordinate system for the database is the internal display coordinate system because this coordinate system
is the one used for the coordinates of sites (radio network data).
Users working on documents connected to a database can modify the coordinate systems in their documents locally, and save
these changes in their documents, but they cannot modify the coordinate systems stored in the database.
If you change the display coordinate system in a document which is not connected to a database, the coordinates of all the
sites are converted to the new display system.
If you change the display coordinate system in a document which is connected to a database, the coordinates of all the sites
Atoll  document  locally  but  not  in  the  database  because  the  internal
are  converted  to  the  new  coordinate  system  in  the 
coordinate systems cannot be changed.
Atoll uses the internal coordinates systems in order to keep the site coordinates consistent in the database which is usually
accessed by a large number of users in a multi‐user environment.

7.1.3 Coordinate Systems File Format
The Coordsystems folder located in the Atoll installation directory contains all the coordinate systems, both geographic and
cartographic,  offered  in  the  tool.  Coordinate  systems  are  grouped  by  regions.  A  catalogue  per  region  and  a  "Favourites"
catalogue are available in Atoll. The Favourites catalogue is initially empty and can be filled by the user by adding coordinate
systems  to  it.  Each  catalogue  is  described  by  an  ASCII  text  file  with  .cs  extension.  In  a  .cs  file,  each  coordinate  system  is
described in one line. The line syntax for describing a coordinate system is:

Code="Nameofthesystem";UnitCode;DatumCode;ProjectionMethodCode,ProjectionParameters;"Comments"

Examples: 

4230 = "ED50"; 101; 230; 1; "Europe - west"

32045 = "NAD27 / Vermont"; 2; 267; 6, -72.5, 42.5, 500000, 0, 0.9999643; "United States - Vermont"

You should keep the following points in mind when editing or creating .cs files:
e h•T
identification  code  enables  Atoll  to  differentiate  coordinates  systems.  In  case  you  create  a  new  coordinate
system, its code must be an integer value higher than 32767.
n e•W
describing 
h a  new  datum,  you  must  enter  the  ellipsoid  code  and  parameters  instead  of  the  datum  code  in brackets. 

Code
"Name
= of
the
system";
Unit
Code;
{Ellipsoid
Code,
Dx,
Dy,
Dz,
Rx,
Ry,
Rz,
S};
Projection
Method
Code,
Projection
Parameters;
"Comments"

e can be up to seven projection parameters. These parameters must be ordered according to the parameter index
r e h•T
  e e(s "Projection Parameter Indices" on page 78). Parameter with index 0 is the first one. Projection parameters are delimited
UTM projections, you must provide positive UTM zone numbers for north UTM zones and negative numbers for
  r o•F south UTM zones.

u can add all other information as comments (such as usage or region).
o•Y
Codes of units, data, projection methods, and ellipsoids, and projection parameter indices are listed in the tables below.

75
Atoll 3.2.1 Administrator Manual
Chapter 7: Coordinate Systems and Units © Forsk 2014

Unit Codes

Code Cartographic Units Code Geographic Units


0 Metre 100 Radian
1 Kilometre 101 Degree
2 Foot 102 Grad
3 Link 103 ArcMinute
4 Chain 104 ArcSecond
5 Yard
a 6N
7 Mile
c e p ‐ s 1 n U

Datum Codes

Code Datum Code Datum


121 Greek Geodetic Reference System 1987 260 Manoca
125 Samboja 261 Merchich
126 Lithuania 1994 262 Massawa
130 Moznet (ITRF94) 263 Minna
131 Indian 1960 265 Monte Mario
201 Adindan 266 M'poraloko
202 Australian Geodetic Datum 1966 267 North American Datum 1927
203 Australian Geodetic Datum 1984 268 NAD Michigan
204 Ain el Abd 1970 269 North American Datum 1983
205 Afgooye 270 Nahrwan 1967
206 Agadez 271 Naparima 1972
207 Lisbon 272 New Zealand Geodetic Datum 1949
208 Aratu 273 NGO 1948
209 Arc 1950 274 Datum 73
210 Arc 1960 275 Nouvelle Triangulation Française
211 Batavia 276 NSWC 9Z‐2
212 Barbados 277 OSGB 1936
213 Beduaram 278 OSGB 1970 (SN)
214 Beijing 1954 279 OS (SN) 1980
215 Reseau National Belge 1950 280 Padang 1884
216 Bermuda 1957 281 Palestine 1923
217 Bern 1898 282 Pointe Noire
218 Bogota 283 Geocentric Datum of Australia 1994
219 Bukit Rimpah 284 Pulkovo 1942
221 Campo Inchauspe 285 Qatar
222 Cape 286 Qatar 1948
223 Carthage 287 Qornoq
224 Chua 288 Loma Quintana
225 Corrego Alegre 289 Amersfoort
226 Cote d'Ivoire 290 RT38
227 Deir ez Zor 291 South American Datum 1969
228 Douala 292 Sapper Hill 1943
229 Egypt 1907 293 Schwarzeck
230 European Datum 1950 294 Segora

76
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 7: Coordinate Systems and Units

Code Datum Code Datum


231 European Datum 1987 295 Serindung
232 Fahud 296 Sudan
233 Gandajika 1970 297 Tananarive 1925
234 Garoua 298 Timbalai 1948
235 Guyane Francaise 299 TM65
236 Hu Tzu Shan 300 TM75
237 Hungarian Datum 1972 301 Tokyo
238 Indonesian Datum 1974 302 Trinidad 1903
239 Indian 1954 303 Trucial Coast 1948
240 Indian 1975 304 Voirol 1875
241 Jamaica 1875 305 Voirol Unifie 1960
242 Jamaica 1969 306 Bern 1938
243 Kalianpur 307 Nord Sahara 1959
244 Kandawala 308 Stockholm 1938
245 Kertau 309 Yacare
247 La Canoa 310 Yoff
248 Provisional South American Datum 1956 311 Zanderij
249 Lake 312 Militar‐Geographische Institut
250 Leigon 313 Reseau National Belge 1972
251 Liberia 1964 314 Deutsche Hauptdreiecksnetz
252 Lome 315 Conakry 1905
253 Luzon 1911 322 WGS 72
254 Hito XVIII 1963 326 WGS 84
255 Herat North 901 Ancienne Triangulation Française
256 Mahe 1971 902 Nord de Guerre
NAD 1927 Guatemala/Honduras/Salvador 
257 Makassar 903
(Panama Zone)
258 European Reference System 1989

Projection Method Codes

Code Projection Method Code Projection Method


0 Undefined 8 Oblique Stereographic
o projection > Longitude / Latitude
1N 9 New Zealand Map Grid
m a 2L 10 Hotine Oblique Mercator
m a 3L 11 Laborde Oblique Mercator
e 4M
a 5C 13 Oblique Mercator
6 Transverse Mercator 14 UTM Projection
n a r 7T

Ellipsoid Codes

Code Name Major Axis Minor Axis


i 1A 6377563.396 6356256.90890985
i 2A 6377340.189 6356034.44761111
s u 3A 6378160 6356774.71919531
e 4B 6377397.155 6356078.96261866
e 5B 6377492.018 6356173.50851316
e 6B 6377483.865 6356165.38276679

77
Atoll 3.2.1 Administrator Manual
Chapter 7: Coordinate Systems and Units © Forsk 2014

Code Name Major Axis Minor Axis


l 7C 6378293.63924683 6356617.98173817
l 8C 6378206.4 6356583.8
l 9C 6378693.7040359 6357069.45104614
10 Clarke 1880 (Benoit) 6378300.79 6356566.43
11 Clarke 1880 (IGN) 6378249.2 6356515
12 Clarke 1880 (RGS) 6378249.145 6356514.86954978
13 Clarke 1880 (Arc) 6378249.145 6356514.96656909
14 Clarke 1880 (SGA 1922) 6378249.2 6356514.99694178
15 Everest 1830 (1937 Adjustment) 6377276.345 6356075.41314024
16 Everest 1830 (1967 Definition) 6377298.556 6356097.5503009
17 Everest 1830 (1975 Definition) 6377301.243 6356100.231
18 Everest 1830 Modified 6377304.063 6356103.03899315
19 GRS 1980 6378137 6356752.31398972
20 Helmert 1906 6378200 6356818.16962789
21 Indonesian National Spheroid 6378160 6356774.50408554
22 International 1924 6378388 6356911.94612795
23 International 1967 6378160 6356774.71919530
24 Krassowsky 1940 6378245 6356863.01877305
25 NWL 9D 6378145 6356759.76948868
26 NWL 10D 6378135 6356750.52001609
27 Plessis 1817 6376523 6355862.93325557
28 Struve 1860 6378297 6356655.84708038
29 War Office 6378300.583 6356752.27021959
30 WGS 84 6378137 6356752.31398972
31 GEM 10C 6378137 6356752.31398972
32 OSU86F 6378136.2 6356751.51667196
33 OSU91A 6378136.3 6356751.61633668
34 Clarke 1880 6378249.13884613 6356514.96026256
35 Sphere 6371000 6371000

Projection Parameter Indices

Index Projection Parameter Index Projection Parameter


ne number T 0U 4 Scale factor at origin
o 0L 4 Latitude of 1st parallel
a 1L 5 Azimuth of central line
a 2F 5 Latitude of 2nd parallel
a 3F 6 Angle from rectified to skewed grid

7.1.4 Creating a Coordinate System in Atoll
Atoll provides a large default catalogue of coordinate systems. However, it is possible to add new geographic and cartographic
coordinate systems. New coordinate systems can be created from scratch or initialised based on existing ones.
To create a new coordinate system from scratch:
1. Select Document > Properties. The Properties dialogue opens.
2. Select the Coordinates tab.

3. Click the Browse  b u t t o n   ( )   t o   t h e   r i g h t  Projection. The Coordinate Systems dialogue appears.
of 
4. Click New. The Coordinate System dialogue appears.

78
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 7: Coordinate Systems and Units

5. In the Coordinate System dialogue:
a. Select the coordinate systems catalogue to which you want to add the new coordinate system.
b. Under General, enter a  Name for the new coordinate system and select a Unit. In Use, you can enter comments
about its usage. Atoll assigns the code automatically.
c. Under  Category,  select  the  Type  of  coordinate  system.  Enter  the  longitude  and  latitude  for  a  geographic
coordinate system, or the type of projection and its set of associated parameters for a cartographic coordinate
system (false easting and northing, and the first and second parallels).
d. Under  Geo,  specify  the  meridian  and  choose  a Datum  for  the  coordinate  system.  The  associated  ellipsoid  is
automatically selected. You can also describe a geodetic datum by selecting "<Customised>" in the Datum list. In
this  case,  you  must  select  an Ellipsoid  and  enter  parameters  (Dx,  Dy,  Dz,  Rx,  Ry,  Rz,  and  S)  needed  for  the
transformation of the datum into WGS84.
6. Click OK. The new coordinate system is added to the selected coordinate system catalogue.
To  create  a  new  coordinate  system  based  on  an  existing  system,  select  a  coordinate  system  in  the 
Coordinate  Systems
dialogue before clicking  New in step 4. The new coordinate system is initialised with the values of the selected coordinate
system.

7.2 Units
In the  Atoll documents, you can define measurement units for reception, transmission, antenna gain, distance, height and
offset,  and  temperature.  You  can  accept  the  default  measurement  units,  or  you  can  change  them  using  the  document
properties dialogue.

Transmission and Reception Power Units

Depending on the working environment, Atoll can use either one or two measurement units for the transmission/reception
power.
If you are working with stand‐alone documents, i.e., documents not connected to databases, there is only one measurement
unit used in Atoll for display. It corresponds to the transmission/reception power unit defined in the Atoll document.
If you are working in a multi‐user environment, Atoll uses two measurement units:
•A  measurement  unit  for  display  in  the  Atoll  document.  It  corresponds  to  the  transmission/reception  power  unit
defined in the current  Atoll document. It is used for the display in the dialogues and in the tables, e.g., reception
thresholds  (coverage  prediction  properties,  microwave  link  properties,  etc.),  and  received  signal  levels
(measurements, point analysis, coverage predictions, microwave link properties, etc.).
•A
n internal measurement unit for the database. The internal unit is the transmission/reception power unit stored in
the database. It corresponds to the transmission/reception power unit used in the master Atoll document when the
database is created. Users working in documents connected to a database can modify the transmission/reception
power unit and save this change in their documents locally, but they cannot modify the internal power unit stored in
the database. Only the administrator can modify it manually by editing the entry in the Units tables.

Antenna Gain Units

Depending on the working environment, Atoll can use either one or two measurement units for the antenna gain.
If you are working with stand‐alone documents, i.e., documents not connected to databases, there is only one measurement
unit used in Atoll for display. It corresponds to the antenna gain unit defined in the Atoll document.
If you are working in a multi‐user environment, Atoll uses two measurement units:
•A measurement unit for display in the  Atoll document. It corresponds to the antenna gain unit defined in the current
Atoll document and it is used for the display in the dialogues and in the tables.
•A
n internal measurement unit for the database. The internal unit is the antenna gain unit stored in the database. It
corresponds to the antenna gain unit used in the master Atoll document when the database is created. Users working
in documents connected to a database can modify the antenna gain unit and save this change in their documents
locally, but they cannot modify the antenna gain unit stored in the database. Only the administrator can modify it
manually by editing the entry in the Units tables.

Distance Units

Atoll uses the distance unit defined in the current  Atoll document as display unit of the distances in the dialogues, in the
tables, and in the status bar.
Metre  is  used  as  the  internal  measurement  unit  for  the  distance  in  all 
Atoll  documents  whether  they  are  connected  to
databases or not. The internal measurement unit is not stored in the database and cannot be changed.

79
Atoll 3.2.1 Administrator Manual
Chapter 7: Coordinate Systems and Units © Forsk 2014

Height and Offset Units

Atoll uses the height and offset unit defined in the current Atoll document as display unit of the heights and the offsets in the
dialogues, in the tables, and in the status bar.
Atoll documents whether they are connected
Metre is used as the internal measurement unit for the heights and offsets in all 
to databases or not. The internal measurement unit is not stored in the database and cannot be changed.

Temperature Units

Atoll uses the temperature unit defined in the current  Atoll document as display unit of the temperatures in the dialogues
and in the tables.
Atoll  documents  whether  they  are
Degree  Celsius  is  used  as  the  internal  measurement  unit  for  the  temperature  in  all 
connected to databases or not. The internal measurement unit is not stored in the database and cannot be changed.

7.3 BSIC Format
Depending on the working environment, there can be either one or two types of BSIC formats. If you are working with stand‐
alone documents, i.e., documents not connected to databases, there is only one BSIC format:
y BSIC format
a l p s •D
i
If you are working in a multi‐user environment, Atoll uses two type of formats:
y BSIC format for the 
a l p s •D
i Atoll document
l BSIC format for the database
a n r e t n•I
The display format is used for the display in dialogs and tables. You can set the display format for your document from the
Transmitters folder’s context menu.
The internal format is the BSIC format stored in a database. The BSIC format set by the administrator in the central  Atoll
project is stored in the database when the database is created, and cannot be modified by users. Only the administrator can
modify the internal format manually by editing the corresponding entry in the Units tables. All Atoll documents opened from
a database will have the internal format of the database as their default BSIC format.
Users working on documents connected to a database can modify the format in their documents locally, and save this change
in their documents, but they cannot modify the format stored in the database.

80
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 8: Geographic Data

8 Geographic Data
Atoll supports several geographic data types; DTM (Digital Terrain Model), clutter, scanned images, vector data, traffic maps,
population,  and  custom  geographic  data. Atoll  offers  import/export  filters  for  the  most  commonly  used  geographic  data
formats.
The following table summarizes the supported formats and filters:
Geographic Data Types
Import 
File Format Clutter  Clutter  Raster  Vector  Web Map  Georeferencing
Export DTM Traffic Maps Population
Classes Heights Images Data Services
User profile raster (8‐bit) 
8, 16, or 32‐ 8, 16, or 32‐ 1, 4, 8 or 24‐ 8, 16, or 32‐
BIL Both 8‐bit User density raster (16, 32‐ HDR files
bit bit bit bit
bit)
User profile raster (8‐bit), 
1, 4, 8 or 24‐ 8, 16, or 32‐
TIFF Both 8 or 16‐bit 8‐bit 8 or 16‐bit User density raster (16, 32‐ Yes TFW files
bit bit
bit)
User profile density
Sector traffic maps 1, 4, 8 or 24‐
Planet Both 16‐bit 16‐bit 16‐bit User profile raster (16‐bit) Yes index files
bit
User density raster (16‐bit)

User profile raster (8‐bit) 
BMP Both 8‐bit 8‐bit 8‐bit User density raster (16, 32‐ 1 to 24‐bit 8 or 32‐bit Yes BPW or BMW files
bit)
User profile density
DXF Import Yes Yes
Sector traffic maps
User profile density
SHP Both Vector Yes Yes
Sector traffic maps
MapInfo User profile density
Both Vector Yes Yes
(MIF, TAB) Sector traffic maps
User profile raster (8‐bit)
Erdas Imagine 8, 16, and  8, 16, and  1, 4, 8 or 24‐ 8, 16, or 32‐
Import 8‐bit User density raster (16, 32‐ Yes
(IMG) 32‐bit 32‐bit bit bit
bit)
ArcView Grid
Export Text Text Text Text Text Text Embedded data
(TXT)
Atoll Geo Data User profile densities
Both Vector Yes Embedded data
(AGD) Sector traffic maps
Vertical Mapper  Clutter  Clutter  User profile raster Raster 
Both DTM Vector Embedded data
(GRD, GRC) Classes Heights User density raster Images
ECW Import 24‐bit ERS files
PNG Both All All PGW files
JPEG Both All All JGW files

You can import custom geographic data types other than those listed above into 
Atoll. Custom maps can be taken into account
in clutter statistics and coverage prediction reports.
Custom file formats supported by Atoll are:
L (8, 16, 32‐bits)
I•B
F (8, 16, 32‐bits)
F I•T
P (8, 32‐bits)
M•B
s Imagine (8, 16, 32‐bits)
a d r•E
• MIF/TAB
• SHP
l Mapper (GRD, GRC)
a c i t r e•V
• AGD

D files can be used for georeferencing for any type of binary raster file.
•W
L
e smallest supported resolution for raster files is 1m
h•T . There is no restriction on the
resolution of images.
•DTM, clutter classes, a
 clutter height maps must have an integer resolution.
dn
•All the raster maps you
ant to import in an ATL document must be represented in

the same projection syst
.me

81
Atoll 3.2.1 Administrator Manual
Chapter 8: Geographic Data © Forsk 2014

8.1 Geographic Header File Formats
Header files are used to describe how data is organised within a data file. This section covers the following topics:
• "HDR Header File for BIL Files" on page 82
• "TFW Header File for TIFF Files" on page 83
• "BPW/BMW Header Files for BMP Files" on page 84
• "PGW Header File for PNG Files" on page 84
• "JGW Header File for JPG Files" on page 84
• "Generic Raster Header File" on page 85

8.1.1 HDR Header File for BIL Files
The HDR file is a text file that contains meta‐data describing the organisation of the BIL file. The header file is made of rows,
each row having the following format:

keyword value

where ‘keyword’ corresponds to an attribute type, and ‘value’ defines the attribute value.
Keywords required by Atoll are described below. Other keywords are ignored.

ulxmap coordinate
x the
of
centre
the
of
upper-left
pixel.
coordinate
y the
of
centre
the
of
upper-left
pixel.
ulymap
xdim size
x inmetre
of
pixel.
a size
y inmetre
of
pixel.
a
ydim
ncols Number
of
columns
in
the
image.
Number
of
rows
in
the
image.
nrows
nbits Number of bits per pixel per band; 8 or 16 for DTMs or Clutter heights
(altitude in metres), 8 for clutter classes file (clutter code), 16 for path loss

nbands Number of spectral bands in the image, (1 for DTM and 8 bit pictures). byteorder
Byte
order
in
which
image
pixel
values
are
stored.
Accepted
values
are
(Motorola
M byte
order)
or
(Intel
I byte
order).

layout Must be ‘bil’.


bandrowbytes Number of bytes per band per row.
totalrowbytes Total number of bytes of data per row.
skipbytes Bytetobeskippedintheimagefileinordertoreachthebeginningoftheimagedata.Defaultvalueis0.

Four additional keywords can optionally be managed.

pixeltype Type of data read (in addition to the length)

This can be:

UNSIGNDINT Undefined 8, 16, 24 or 32 bits


SIGNEDINT Integer 16 or 32 bits
FLOAT Real 32 or 64 bits

In some cases, this keyword can be replaced by datatype defined as follows:

datatype Type of data read (in addition to the length)

This can be:

82
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 8: Geographic Data

Un Undefined n bits (8, 16, 24 or 32 bits)
In Integer n bits (16 or 32 bits)
Rn Real n bits (32 or 64 bits)
RGB24 Integer 3 colour components on 24 bits

The other optional keywords are: valueoffset, valuescale, and nodatavalue.
By default, integer data types are chosen with respect to the pixel length (nbits).

valueoffset Real value to be added to the read value (Vread)


valuescale Scaling factor to be applied to the read value

So, we have  V = Vread ´ valuescale + valueoffset

nodatavalue Value corresponding to “NO DATA”

DTM Sample

Here, the data is 20 m.

nrows 1500
ncols 1500
nbands 1
nbits 8 or 16
byteorder M
layout bil
skipbytes 0
ulxmap 975000
ulymap 1891000
xdim 20.00
ydim 20.00

Clutter Classes Sample

nrows 1500
ncols 1500
nbands 1
nbits 8
byteorder M
layout bil
skipbytes 0
ulxmap 975000
ulymap 1891000
xdim 20.00
ydim 20.00

8.1.2 TFW Header File for TIFF Files
TFW files contain the spatial reference data of associated TIFF files. The TFW file structure is simple; it is an ASCII text file that
contains six lines. You can open a TFW file using any ASCII text editor. The TFW file structure is as follows:

Line Description
1x dimension of a pixel in map units
2a amount of translation
3a
e 4n

83
Atoll 3.2.1 Administrator Manual
Chapter 8: Geographic Data © Forsk 2014

Line Description
5x‐axis map coordinate of the centre of the upper‐left pixel
6y‐axis map coordinate of the centre of the upper‐left pixel
a. Atoll does not use the lines 2 and 3 when importing a TIFF format geographic file.

Clutter Classes Sample

100.00
0.00
0.00
-100.00
60000.00
2679900.00

8.1.3 BPW/BMW Header Files for BMP Files
The header file is a text file that describes how  organised in the BMP file. The header file is made of rows, each row having
the following description:

Line Description
1x dimension of a pixel in map units
2a
3 amount of rotation
e 4n
5x‐axis map coordinate of the centre of the upper‐left pixel
6y‐axis map coordinate of the centre of the upper‐left pixel

Atoll supports BPW and BMW header file extensions for Import, but exports headers with BPW file extensions.

Clutter Classes Sample

100.00
0.00
0.00
-100.00
60000.00 2679900.00

8.1.4 PGW Header File for PNG Files
A  PNG  world  file  (PGW  file)  is  a  plain  text  file  used  by  geographic  information  systems  (GIS)  to  provide 
georeferencing information for raster map images in PNG format. The world file parameters are:

Line Description
1x dimension of a pixel in map units
2a
3 amount of rotation
e 4n
5x‐axis map coordinate of the centre of the upper‐left pixel
6y‐axis map coordinate of the centre of the upper‐left pixel

8.1.5 JGW Header File for JPG Files
A  JPEG  world  file  (JGW  file)  is  a  plain  text  file  used  by  geographic  information  systems  (GIS)  to  provide 
georeferencing information for raster map images in JPEG format. The world file parameters are:

84
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 8: Geographic Data

Line Description
1x dimension of a pixel in map units
2 amount of translation
3a
e 4n
5x‐axis map coordinate of the centre of the upper‐left pixel
6y‐axis map coordinate of the centre of the upper‐left pixel

8.1.6 Generic Raster Header File
WLD is a header format for Atoll that can be used for any raster data file for georeferencing. At the time of import of any raster
data file, Atoll can use the corresponding WLD file to read the georeferencing information related to the raster data file. The
WLD file contains the spatial reference data of any associated raster data file. The WLD file structure is simple; it is an ASCII
text file containing six lines. You can open a WLD file using any ASCII text editor.
The WLD file is a text file that describes how  organised in the associated raster data file. The header file is made of rows, each
row having the following description:

Line Description
1x dimension of a pixel in map units
2 amount of translation
3a
e 4n
5x‐axis map coordinate of the centre of the upper‐left pixel
6y‐axis map coordinate of the centre of the upper‐left pixel

Clutter Classes File Sample

100.00
0.00
0.00
-100.00
60000.00 2679900.00

85
Atoll 3.2.1 Administrator Manual
Chapter 8: Geographic Data © Forsk 2014

86
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

o Data Formats
9R
ida
Radio network data in Atoll includes the following, depending on the technology used in the network being planned:
: The geographic location of transmitters (sectors, installed antennas, other equipment). A site can have one or
e t i•S
more transmitters.
• Antenna: The radiation patterns and gains for antennas installed at transmitters.
: A group of radio devices installed at a site with there transmission/reception characteristics (antennas,
r e t t i ms n a r•T
feeders, TMAs, other equipment). A transmitter can have one or more cells or subcells.
: An RF carrier available at a transmitter in UMTS, CDMA2000, TD‐SCDMA, LTE, WiMAX, and Wi‐Fi networks. A cell
l l e•C
is fully defined by the "transmitter‐carrier" pair. Each cell in these networks is independent, i.e., has its own identifier,
power levels, performance characteristics.
•TRX: An RF carrier available at a transmitte
in GSM networks. A transceiver (TRX) can carry one ARFCN which can
  r
correspond to the BCCH (7 traffic timeslots) 
 TCH (8 traffic timeslots).
ro
•Subcell: A subcell is a group of TRXs with t
 same radio characteristics. A subcell is fully defined by the "transmitter‐
eh
TRX type" pair.
•Base station: This is the generic name for a
ell site ("site‐transmitter‐cell" or "site‐transmitter‐subcells"). Technology‐
c  
specific names can be BTS, Node‐B, eNode‐B, e
. ct
•RF repeater: An RF repeater receives, amplif
s, and retransmits RF carriers both in downlink and uplink. The repeater
ei
receives signals from a donor transmitter whi
 it retransmits using a coverage‐side antenna with amplification.
hc

e antenna: Transmitter antennas located at a remote location with respect to the transmitter’s site.
t ome•R
e link: A point‐to‐point link using microwave frequencies used for backhaul in radio access networks or for
v awo r c •Mi
fixed wireless access.
P microwave link: A group of microwave links originating from a common node to serve more than one location. 
M•P
e vmicrowave 
i s s a•P repeater:  A  passive  microwave  repeater  receives  and  retransmits  microwave  signals  without amplification. Passiv

9.1 XML Import/Export Format
All the data tables in an  Atoll document can be exported to XML files.  Atoll creates the following files when data tables are
exported to XML files:
•A
n index.xml file which contains the mapping between the data tables in  Atoll and the XML file created for each table.
e XML file per data table which contains the data table format (schema) and the data.
•O
n
When  XML  files  are  imported  to  a  document,  the  table  and  field  definitions  are  not  modified,  i.e.,  the  Networks 
and CustomFields tables are exported to XML file but are not imported.
The following sections describe the structures of the XML files created at export.

9.1.1 Index.xml File Format
The index.xml file stores the system (GSM, UMTS, etc.) and the technology (TDMA, CDMA, etc.) of the document, and the
version of Atoll used for exporting the data tables to XML files. It also contains the mapping between the data tables in the
Atoll document and the XML file corresponding to each data table.
The root tag <Atoll_XML_Config...> of the index.xml file contains the following attributes:

Attribute Description
Atoll_File_System Corresponds to the SYSTEM_ field of the Networks table of the exported document
Atoll_File_Technology Corresponds to the TECHNOLOGY field of the Networks table of the exported document
Atoll_File_Version Corresponds to the Atoll version

The index file also contains the mapping between the tables exported from  Atoll and the XML files corresponding to each
table. This list is sorted in the order in which tables must be imported in Atoll.
The list is composed of <XML_Table.../> tags with the following attributes:

Attribute Description
XML_File Corresponds to the exported XML file name (e.g., "Sites.xml")
Atoll_Table Corresponds to the exported Atoll table name (e.g., "Sites")

A sample extract of the index.xml is given below:

87
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

<Atoll_XML_Config Atoll_File_System="UMTS" Atoll_File_Technology="CDMA"


Atoll_File_Version="3.x.x build xxxx">
<XML_Table XML_File="CustomFields.xml" Atoll_Table="CustomFields" />
<XML_Table XML_File="CoordSys.xml" Atoll_Table="CoordSys" />
...
</Atoll_XML_Config>

Note that no closing tag </XML_Table> is required.

9.1.2 XML File Format
Atoll creates an XML file per exported data table. This XML file has two sections, one for storing the description of the table
structure, and the second for the data itself. The XML file uses the standard XML rowset schema (schema included in the XML
file between <s:Schema id=‘RowsetSchema’> and </s:Schema> tags).

Rowset Schema

The XML root tag for XML files using the rowset schema is the following:

<xml
xmlns:s='uuid:BDC6E3F0-6DA3-11d1-A2A3-00AA00C1488
2' xmlns:dt='uuid:C2F41010-65B3-11d1-A29F-00AA00C14882' xmlns:rs='urn:schemas-microsoft-com:

The schema definition follows the root tag and is enclosed between the following tags:

<s:Schema id=‘RowsetSchema’>
<!-Schemaisdefinedhere,using<s:ElementType>and<s:AttributeType>tags-></s:Schema>

In the rowset schema, after the schema description, the data are enclosed between <rs:data> and </rs:data>.
Between these tags, each record is handled by a <z:row … /> tag having its attributes set to the record field values since in the
rowset schema, values are handled by attributes. Note that no closing tag </z:row> is required.
A sample extract of a Sites.xml file containing the Sites table with only one site is given below:

<xml
xmlns:s='uuid:BDC6E3F0-6DA3-11d1-A2A3-00AA00C1488
2' xmlns:dt='uuid:C2F41010-65B3-11d1-A29F-00AA00C14882' xmlns:rs='urn:schemas-microsoft-com:

<s:Schema id='RowsetSchema'>
<s:ElementType name='row' content='eltOnly' rs:updatable='true'>
<s:AttributeType name='NAME' rs:number='1' rs:maydefer='true'
rs:writeunknown='true' rs:basetable='Sites' rs:basecolumn='NAME'
rs:keycolumn='true'>
<s:datatype dt:type='string' dt:maxLength='50'/>
</s:AttributeType>
<s:AttributeType name='LONGITUDE' rs:number='2' rs:maydefer='true'
rs:writeunknown='true' rs:basetable='Sites'
rs:basecolumn='LONGITUDE'> <s:datatype dt:type='float' dt:maxLength='8' rs:precision='15

</s:AttributeType>
<s:AttributeType name='LATITUDE' rs:number='3' rs:maydefer='true'
rs:writeunknown='true' rs:basetable='Sites'
rs:basecolumn='LATITUDE'> <s:datatype dt:type='float' dt:maxLength='8' rs:precision='15'

</s:AttributeType>

88
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

<s:AttributeType name='ALTITUDE' rs:number='4'


rs:nullable='true' rs:maydefer='true' rs:writeunknown='true' rs:basetable='Sites' rs

<s:datatype dt:type='r4' dt:maxLength='4' rs:precision='7'


rs:fixedlength='true'/>
</s:AttributeType>
<s:AttributeType name='COMMENT_' rs:number='5'
rs:nullable='true' rs:maydefer='true' rs:writeunknown='true' rs:basetable='Sites' rs

<s:datatype dt:type='string' dt:maxLength='255'/>


</s:AttributeType>
<s:extends type='rs:rowbase'/>
</s:ElementTyp
e> </s:Schema> <rs:data>

<rs:insert>
<z:row NAME='Site0' LONGITUDE='8301' LATITUDE='-9756'/>
</rs:insert>
</rs:data>
</xml>

9.2 RF 2D Antenna Pattern Format
This section describes the format of the DIAGRAM field of the Antennas table. This field stores the antenna diagrams in a 2D
(angle vs. attenuation) format. This is the format of the contents of the DIAGRAM field of the Antennas table when it is copied
from, pasted to, imported to (from TXT or CSV files), and exported from (from TXT, CSV, or XLS files) the Antennas table. 
Antenna patterns can also be imported in Planet 2D‐format antenna files and 3D antenna files. The file format required for
3D antenna file import is described in "Import Format of 3D Antenna Pattern Text Files" on page 91.
The format of 2D antenna patterns containing co‐polar diagrams only can be understood from Figure 9.1 on page 89.

Pattern Co-polar Horizontal Diagram Pattern Co-polar Vertical Diagram End


Discriptor 1 Discriptor 2

2 0 0 360 0 0 1 0 2 0.1 …1 0 360 0 0 1 0.1 …0


Figure 9.1: 2D RF Antenna Pattern Format Containing Co‐polar Diagrams Only

The contents of the DIAGRAM field are formatted as follows:
• Pattern Descriptor 1: Space‐separated list of parameters.
• First entry: The number of co‐polar diagrams. For example, 2.
• Second entry: First co‐polar diagram type = 0 for azimuth (horizontal) diagram.
• Third entry: The elevation angle of the azimuth diagram.
• Fourth entry: The number of angle‐attenuation pairs in the first co‐polar diagram. For example, 360.
o‐polar Horizontal Diagram:
•C  Horizontal co‐polar diagram (the second entry in the preceding descriptor is 0). The
format is space‐separated angle attenuation pairs. For example, 0 0 1 0 2 0.1....
• Pattern Descriptor 2: Space‐separated list of parameters.
• First entry: Second co‐polar diagram type = 1 for elevation (vertical) diagram.
• Second entry: The azimuth angle of the elevation diagram.
• Third entry: The number of angle‐attenuation pairs in the second co‐polar diagram. For example, 360.
o‐polar Vertical Diagram:
•C  Vertical co‐polar diagram (the first entry in the preceding descriptor is 1). The format is
space‐separated angle attenuation pairs. For example, 0 0 1 0.1....
• End: The number cross‐polar diagrams = 0.
The  format  of  2D  antenna  patterns  containing  co‐polar  and  cross‐polar  diagrams  can  be  understood  from  Figure 9.2  on
page 90.

89
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

Pattern Co-polar Horizontal Diagram Pattern Co-polar Vertical Diagram


Discriptor 1 Discriptor 2

Pattern Cross-polar Horizontal Diagram Pattern Cross-polar Vertical Diagram


Discriptor 3 Discriptor 4

2 0 0 360 0 0 1 0 2 0.1 …1 0 360 0 0 1 0.1 …


2 0 0 360 0 0 1 0 2 0.1 …1 0 360 0 0 1 0.1 …
Figure 9.2: 2D RF Antenna Pattern Format Containing Co‐polar and Cross‐polar Diagrams

The contents of the DIAGRAM field are formatted as follows:
n Descriptor 1:
r e t t a•P  Space‐separated list of parameters.
• First entry: The number of co‐polar diagrams. For example, 2.
• Second entry: First co‐polar diagram type = 0 for azimuth (horizontal) diagram.
• Third entry: The elevation angle of the azimuth diagram.
• Fourth entry: The number of angle‐attenuation pairs in the first co‐polar diagram. For example, 360.
o‐polar Horizontal Diagram:
•C  Horizontal co‐polar diagram (the second entry in the preceding descriptor is 0). The
format is space‐separated angle attenuation pairs. For example, 0 0 1 0 2 0.1....
n Descriptor 2:
r e t t a•P  Space‐separated list of parameters.
• First entry: Second co‐polar diagram type = 1 for elevation (vertical) diagram.
• Second entry: The azimuth angle of the elevation diagram.
• Third entry: The number of angle‐attenuation pairs in the second co‐polar diagram. For example, 360.
o‐polar Vertical Diagram:
•C  Vertical co‐polar diagram (the first entry in the preceding descriptor is 1). The format is
space‐separated angle attenuation pairs. For example, 0 0 1 0.1....
n Descriptor 3:
r e t t a•P  Space‐separated list of parameters.
• First entry: The number of cross‐polar diagrams. For example, 2.
• Second entry: First cross‐polar diagram type = 0 for azimuth (horizontal) diagram.
• Third entry: The elevation angle of the azimuth diagram.
• Fourth entry: The number of angle‐attenuation pairs in the first cross‐polar diagram. For example, 360.
s‐polar Horizontal Diagram:
s o r•C  Horizontal cross‐polar diagram (the second entry in the preceding descriptor is 0).
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0 2 0.1....
n Descriptor 4:
r e t t a•P  Space‐separated list of parameters.
• First entry: Second cross‐polar diagram type = 1 for elevation (vertical) diagram.
• Second entry: The azimuth angle of the elevation diagram.
• Third entry: The number of angle‐attenuation pairs in the second cross‐polar diagram. For example, 360.
s‐polar Vertical Diagram:
s o r•C  Vertical cross‐polar diagram (the first entry in the preceding descriptor is 1). The format
is space‐separated angle attenuation pairs. For example, 0 0 1 0.1....
You can use a 3rd party software or develop a tool to convert the contents of the DIAGRAM field into binary. In binary, each
antenna is described by a header and a list of value pairs.
The header is defined as follows:
• flag: (Integer, 32 bits) ‐1 for omni diagrams, 0 for directional
• num: (Short integer, 16 bits) Number of diagrams (0, 1, 2, 3, 4)
• siz0: (Short integer, 16 bits) Size of the first diagram (horizontal co‐polar section, elevation = 0°)
• siz1: (Short integer, 16 bits) Size of the second diagram (vertical co‐polar section, azimuth = 0°)
• siz2: (Short integer, 16 bits) Size of the third diagram (horizontal cross‐polar)
• siz3: (Short integer, 16 bits) Size of the fourth diagram (vertical cross‐polar)
• prec: (Short integer, 16 bits) Precision of the following angle values (100)
Then follows the content of each of the defined diagrams, i.e., the diagrams whose sizes ( siz0, siz1, siz2, siz3) are not zero.
Each diagram consists of a list of value pairs. The number of value pairs in a list depends on the value of the  siz0, siz1, siz2,
and siz3 parameters. For example, siz2 = 5 means there are five value pairs in the third diagram.
The value pairs in each list are:
• ang:  (Short  integer,  16  bits)  The  first  component  of  the  value  pair  is  the  angle  in  degrees  multiplied  by  100.  For
example, 577 means 5.77 degrees.
• loss: (Short integer, 16 bits) The second component of the value pair is the loss in dB for the given angle ang.
All the lists of value pairs are concatenated without a separator.

90
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

9.3 Import Format of 3D Antenna Pattern Text Files
Text files containing 3D antenna patterns that can be imported in Atoll must have the following format:
• Header: The text file can contain a header with additional information. When you import the antenna pattern you can
indicate the row number in the file where the header ends and the antenna pattern begins.
• Antenna Pattern: Each row contains three values to describe the 3D antenna pattern. The columns containing the
values can be in any order:
• Azimuth: Allowed range of values is from 0° to 360°. The smallest increment allowed is 1°.
• Tilt: Allowed range of values is from ‐90° to 90° or from 0° to 180°. The smallest increment allowed is 1°.
• Attenuation: The attenuation in dB.

9.4 Microwave 2D Antenna Pattern Format
This section describes the format of the PATTERN field of the MW Antennas table. This field stores the antenna diagrams in a
2D (angle vs. attenuation) format. This is the format of the contents of the PATTERN field of the MW Antennas table when it
is  copied  from,  pasted  to,  imported  to  (from  TXT  or  CSV  files),  and  exported  from  (from  TXT,  CSV,  or  XLS  files) 
the  MW Antennas table. 
Antenna patterns can also be imported in Planet 2D‐format antenna files and 3D antenna files. The file format required for
3D antenna file import is described in "Import Format of 3D Antenna Pattern Text Files" on page 91. 
The format of 2D antenna patterns can be understood from Figure 9.3 on page 91.

Pattern Co-polar H-V Diagram Pattern Co-polar H-H Diagram


Discriptor 1 Discriptor 2

Pattern Cross-polar H-V Diagram Pattern Cross-polar H-H Diagram


Discriptor 3 Discriptor 4

Pattern Co-polar V-V Diagram Pattern Co-polar V-H Diagram


Discriptor 5 Discriptor 6

Pattern Cross-polar V-V Diagram Pattern Cross-polar V-H Diagram


Discriptor 7 Discriptor 8

4 0 1 0 360 0 0 1 0.5 ...


0 0 0 360 0 0 1 0.5 ...
1 1 0 360 0 0 1 0.5 ...
1 0 0 360 0 0 1 0.5 ...
4 0 1 0 360 0 0 1 0.5 ...
0 0 0 360 0 0 1 0.5 ...
1 1 0 360 0 0 1 0.5 ...
1 0 0 360 0 0 1 0.5 ...
Figure 9.3: 2D Microwave Antenna Pattern Format

The contents of the PATTERN field are formatted as follows:
• Pattern Descriptor 1: Space‐separated list of parameters.
• First entry: The number of H_polarisation diagrams. For example, 4.
• Second and third entries: First diagram type = 0 1, for co‐polar H‐V diagram ("EL HH" in Atoll).
• Fourth entry: The elevation angle of the azimuth diagram.
• Fifth entry: The number of angle‐attenuation pairs in the first co‐polar diagram. For example, 360.
o‐polar H‐V Diagram:
•C  Co‐polar H‐V diagram (the second and third entries in the preceding descriptor are 0 1). 
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....
• Pattern Descriptor 2: Space‐separated list of parameters.
• First and second entries: Second diagram type = 0 0, for co‐polar H‐H diagram ("HH" in Atoll).
• Third entry: The azimuth angle of the elevation diagram.

91
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

• Fourth entry: The number of angle‐attenuation pairs in the second co‐polar diagram. For example, 360.
o‐polar H‐H Diagram:
•C  Co‐polar H‐H diagram (the first and second entries in the preceding descriptor are 0 0). 
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....
n Descriptor 3:
r e t t a•P  Space‐separated list of parameters.
• First and second entries: Third diagram type = 1 1, for cross‐polar H‐V diagram ("EL VH" in Atoll).
• Third entry: The elevation angle of the azimuth diagram.
• Fourth entry: The number of angle‐attenuation pairs in the third co‐polar diagram. For example, 360.
s‐polar H‐V Diagram:
s o r•C  Cross‐polar H‐V diagram (the second and third entries in the preceding descriptor are 0 1).
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....
n Descriptor 4:
r e t t a•P  Space‐separated list of parameters.
• First and second entries: Fourth diagram type = 1 0, for cross‐polar H‐H diagram ("VH" in Atoll).
• Third entry: The azimuth angle of the elevation diagram.
• Fourth entry: The number of angle‐attenuation pairs in the fourth co‐polar diagram. For example, 360.
s‐polar H‐H Diagram:
s o r•C  Cross‐polar H‐H diagram (the first and second entries in the preceding descriptor are 0 0).
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....
n Descriptor 5:
r e t t a•P  Space‐separated list of parameters.
• First entry: The number of V_polarisation cross‐polar diagrams. For example, 4.
• Second and third entries: First diagram type = 0 1, for co‐polar V‐V diagram ("EL VV" in Atoll).
• Fourth entry: The elevation angle of the azimuth diagram.
• Fifth entry: The number of angle‐attenuation pairs in the first cross‐polar diagram. For example, 360.
o‐polar V‐V Diagram:
•C  Co‐polar V‐V diagram (the first and second entries in the preceding descriptor are 1 1). 
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....
n Descriptor 6:
r e t t a•P  Space‐separated list of parameters.
• First and second entries: Second diagram type = 0 0, for co‐polar V‐H diagram ("VV" in Atoll).
• Third entry: The azimuth angle of the elevation diagram.
• Fourth entry: The number of angle‐attenuation pairs in the second cross‐polar diagram. For example, 360.
o‐polar V‐H Diagram:
•C  Co‐polar V‐H diagram (the first and second entries in the preceding descriptor are 1 0). 
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....
n Descriptor 7:
r e t t a•P  Space‐separated list of parameters.
• First and second entries: Third diagram type = 1 1, for cross‐polar V‐V diagram ("EL HV" in Atoll).
• Third entry: The elevation angle of the azimuth diagram.
• Fourth entry: The number of angle‐attenuation pairs in the third cross‐polar diagram. For example, 360.
s‐polar V‐V Diagram:
s o r•C  Cross‐polar V‐V diagram (the first and second entries in the preceding descriptor are 1 1).
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....
n Descriptor 8:
r e t t a•P  Space‐separated list of parameters.
• First and second entries: Fourth diagram type = 1 0, for cross‐polar V‐H diagram ("HV" in Atoll).
• Third entry: The azimuth angle of the elevation diagram.
• Fourth entry: The number of angle‐attenuation pairs in the fourth cross‐polar diagram. For example, 360.
s‐polar V‐H Diagram:
s o r•C  Cross‐polar V‐H diagram (the first and second entries in the preceding descriptor are 1 0).
The format is space‐separated angle attenuation pairs. For example, 0 0 1 0.5....

9.5 Path Loss Matrix File Format
When path loss matrices are stored externally, i.e., outside the ATL file, the path loss matrices folder contains a ‘pathloss.dbf’
file containing the calculation parameters of the transmitters and one LOS (path loss results) file per calculated transmitter.
The path loss matrices folder also contains a LowRes folder with another pathloss.dbf file and one LOS (path loss results) file
per transmitter that has an extended path loss matrix.
The formats of the pathloss.dbf and LOS files are described here.

9.5.1 Pathloss.dbf File Format
The pathloss.dbf file has a standard DBF (dBase III) format. The file can be opened in Microsoft Access, but it should not be
modified without consulting the Forsk customer support.
For general information, the format of DBF files in any Xbase language is as follows:

Notations used in the following tables: FS = FlagShip; D3 = dBaseIII+; Fb = FoxBase; D4 =
dBaseIV; Fp = FoxPro; D5 = dBaseV; CL = Clipper

92
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

DBF Structure

Byte Description Remarks


0...n DBF header (see next part for size, byte 8)

1st record of fixed length (see next parts); 2nd record (see next part for size, byte10) …; last 
n+1 If .dbf is not empty
record

last optional: 0x1a (eof byte)

DBF Header

The DBF header size is variable and depends on the field count.

Byte Size Contents Description Applies to


00 1 0x03 plain .dbf FS, D3, D4, D5, Fb, Fp, CL
0x04 plain .dbf D4, D5 (FS)
0x05 plain .dbf D5, Fp (FS)
0x43 with .dbv memo var size FS
0xB3 with .dbv and .dbt memo FS
0x83 with .dbt memo FS, D3, D4, D5, Fb, Fp, CL
0x8B with .dbt memo in D4 format D4, D5
0x8E with SQL table D4, D5
0xF5 with .fmp memo Fp
01 3 YYMMDD Last update digits All
04 4 ulong Number of records in file All
08 2 ushort Header size in bytes All
10 2 ushort Record size in bytes All
12 2 0,0 Reserved All
14 1 0x01 Begin transaction D4, D5
0x00 End Transaction D4, D5
0x00 ignored FS, D3, Fb, Fp, CL
15 1 0x01 Encrypted D4, D5
0x00 normal visible All
16 12 0 (1) multi‐user environment use D4,D5
28 1 0x01 production index exists Fp, D4, D5
0x00 index upon demand All
29 1 n language driver ID D4, D5
0x01 codepage437 DOS USA Fp
0x02 codepage850 DOS Multi ling Fp
0x03 codepage1251 Windows ANSI Fp
0xC8 codepage1250 Windows EE Fp
0x00 ignored FS, D3, Fb, Fp, CL
30 2 0,0 reserved All
32 n*32 Field Descriptor (see next paragraph) all
+1 1 0x0D Header Record Terminator all

Field descriptor array in the DBF header (32 bytes for each field):

Byte Size Contents Description Applies to

0 11 ASCI field name, 0x00 termin all


11 1 ASCI field type (see next paragraph) all
12 4 n,n,n,n Fld address in memory D3

93
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

Byte Size Contents Description Applies to


n,n,0,0 offset from record begin Fp
0,0,0,0 ignored FS, D4, D5, Fb, CL
16 1 byte Field length, bin (see next paragraph) all \ FS,CL: for C field type
17 1 byte decimal count, bin all / both used for fld lng
18 2 0,0 reserved all
20 1 byte Work area ID D4, D5
0x00 unused FS, D3, Fb, Fp, CL
21 2 n,n multi‐user dBase D3, D4, D5
0,0 ignored FS, Fb, Fp, CL
23 1 0x01 Set Fields D3, D4, D5
0x00 ignored FS, Fb, Fp, CL
24 7 0...0 reserved all
31 1 0x01 Field is in .mdx index D4, D5
0x00 ignored FS, D3, Fb, Fp, CL

Field type and size in the DBF header, field descriptor (1 byte):

Size Type Description/Storage Applies to


ASCII (OEM code page chars)
C 1...n Char all
rest= space, not \0 term.
n = 1...64kb (using deci count) FS
n = 1...32kb (using deci count) Fp, CL
n = 1...254 all
e Dt   a8 D 8 ASCII digits (0...9) in the YYYYMMDD format all
ASCII digits (‐.0123456789)
F 1...n Numeric variable pos. of float.point FS, D4, D5, Fp
n = 1...20
ASCII digits (‐.0123456789)
N 1...n Numeric all
fix posit/no float.point
n = 1...20 FS, Fp, CL
n = 1...18 D3, D4, D5, Fb
l a c i L g I chars (YyNnTtFf space)
  o1 IL C S A FS, D3, Fb, Fp, CL
ASCII chars (YyNnTtFf?) D4, D5 (FS)
10 digits repres. the start block posit. in .dbt file, or 10 
M 10 Memo all
spaces if no entry in memo
Variable, bin/asc data in .dbv
4bytes bin= start pos in memo
4bytes bin= block size
V 10 Variable FS
1byte = subtype
1byte = reserved (0x1a)
10 spaces if no entry in .dbv

binary data in .ftp
P 10 Picture Fp
structure like M
binary data in .dbt
B 10 Binary D5
structure like M
OLE objects
G 10 General D5, Fp
structure like M
t   i rn t o 2 h  2 s binary int max +/‐ 32767 FS
g   i n n t4 o   4 l binary int max +/‐ 2147483647 FS
8 8 double binary signed double IEEE FS

Each DBF record (fixed length):

94
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

Byte Size Description Applies to


d   f l ae g   " *t "   0ol er   n o 1tl   d e el e t e dd   "   " A
x‐times contents of fields, fixed length, unterminated.
1…n 1… All
For n, see (2) byte 10…11

9.5.2 Pathloss.dbf File Contents
The DBF file provides information that is needed to check validity of each path loss matrix.

Field Type Description


TX_NAME Text Name of the transmitter
FILE_NAME Text Name (and optionally, path) of .los file
MODEL_NAME Text Name of propagation model used to calculate path loss
Signature (identity number) of model used in calculations. You can check it in the 
propagation model properties (General tab).
The Model_SIG is used for the purpose of validity. A unique Model_SIG is assigned to 
MODEL_SIG Text each propagation model. When model parameters are modified, the associated model 
ID changes. This enables Atoll to detect path loss matrix invalidity. In the same way, two 
identical propagation models in different projects do not have the same model ID .a
ULXMAP Float X‐coordinate of the top‐left corner of the path loss matrix upper‐left pixel
ULYMAP Float Y‐coordinate of the top‐left corner of the path loss matrix upper‐left pixel
RESOLUTION Float Resolution of path loss matrix in metre
NROWS Float Number of rows in path loss matrix
NCOLS Float Number of columns in path loss matrix
FREQUENCY Float Frequency band
TILT Float Transmitter antenna mechanical tilt
AZIMUTH Float Transmitter antenna azimuth
TX_HEIGHT Float Transmitter height in metre
TX_POSX Float X‐coordinate of the transmitter
TX_POSY Float Y‐coordinate of the transmitter
ALTITUDE Float Ground height above sea level at the transmitter in metre
RX_HEIGHT Float Receiver height in metre
Logical number referring to antenna pattern. Antennas with the same pattern will have 
ANTENNA_SI Float
the same number.
Maximum path loss stated in 1/16 dB. This information is used, when no calculation 
MAX_LOS Float
radius is set, to check the matrix validity.
CAREA_XMIN Float Lowest x‐coordinate of centre pixel located on the calculation radiusb
CAREA_XMAX Float Highest x‐coordinate of centre pixel located on the calculation radius
CAREA_YMIN Float Lowest y‐coordinate of centre pixel located on the calculation radius
CAREA_YMAX Float Highest y‐coordinate of centre pixel located on the calculation radius
WAREA_XMIN Float Lowest x‐coordinate of centre pixel located in the computation zonec
WAREA_XMAX Float Highest x‐coordinate of centre pixel located in the computation zone
WAREA_YMIN Float Lowest y‐coordinate of centre pixel located in the computation zone
WAREA_YMAX Float Highest y‐coordinate of centre pixel located in the computation zone
Locking status
LOCKED Boolean 0: path loss matrix is not locked
1: path loss matrix is locked.

Atoll indicates if losses due to the antenna pattern are taken into account in the path 
loss matrix.
INC_ANT Boolean
0: antenna losses not taken into account
1: antenna losses included

95
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

a. In order to benefit from the calculation sharing feature, users must retrieve the propagation models from the same
central  database.  This  can  be  done  using  the  Open  from  database  command  for  a  new  document  or  the  Refresh
command for an existing one. Otherwise, Atoll generates different model_ID (even if same parameters are applied on
the same kind of model) and calculation sharing become unavailable due to inconsistency.
b. These coordinates enable Atoll to determine the area of calculation for each transmitter.
c. These coordinates enable Atoll to determine the rectangle including the computation zone.

9.5.3 LOS File Format
The  LOS  (path  loss  results)  files  are  binary  files  with  a  standard  row‐column  structure.  Data  are  stored  starting 
from  the
southwest to the northeast corner of the area. The file contains 16‐bit signed integer values in the range [‐32768; +32767] with a 1/16 d

9.6 Path Loss Tuning File Format
Atoll can tune path losses calculated by propagation models using CW measurements or drive test Data. Path losses are tuned
by merging measurement data with propagation results on pixels corresponding to the measurement points and the pixels in
the vicinity. Path losses surrounding the measurement points are smoothed for homogeneity.
Measuremment paths that are used for path loss tuning are stored as a catalogue in a folder containing a pathloss.dbf file and
one PTS (path loss tuning) file per transmitter. A tuning file can contain several measurement paths.
For more information on the path loss tuning algorithm, see the Technical Reference Guide.

9.6.1 Pathloss.dbf File Format
See "Pathloss.dbf File Format" on page 92.

9.6.2 Pathloss.dbf File Contents
The DBF file provides information about the measured transmitters involved in the tuning.

Field Type Description


TX_NAME Text Name of the transmitter
FILE_NAME Text Name (and optionally, path) of .pts file
AREA_XMIN Float Not used
AREA_XMAX Float Not used
AREA_YMIN Float Not used
AREA_YMAX Float Not used

9.6.3 PTS File Format
The PTS (path loss tuning) files contain a header and the list of measurement points.
Header:
•4 bytes: version
•4 bytes: flag (can be used to manage flags like active flag)
0 bytes: GUID
•5
•4 bytes: number of points
• 255 bytes: original measurement name (with prefix "Num" for drive test data and "CW" for CW measurements)
• 256 bytes: comments
•4 bytes: X_RADIUS
•4 bytes: Y_RADIUS
•4 bytes: gain = measurement gain ‐ losses
•4 bytes: global error
•4 bytes: rx height
•4 bytes: frequency
•8 bytes: tx Position

List of measurement points:
•4 bytes: X

96
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

•4 bytes: Y
•4 bytes: measurement value
•4 bytes: incidence angle.

9.7 Interference Matrix File Formats
Interference matrices are used by GSM, LTE, and WiMAX AFPs (automatic frequency planning tools). Interference matrices
can be imported and exported using the following formats:
: CLC, IM0, IM1, IM2
M•G
S
E and WiMAX: IM2, TXT, CSV
T•L
Interference matrix files must contain interference probability values between 0 and 1, and not in precentage (between 0 and
100%). When interference matrix files are imported,  Atoll does not check their validity and imports interference probability
values for loaded transmitters only. 
In the following format descriptions and samples, lines starting with the "#" are considered as comments.

In GSM interference matrices:
e h•T
interferer  TRX  type  is  not  specified  and  is  always  considered  to  be  BCCH. Subcells  have  differen
erference histogram will be shifted by XdB with respect to the BCCH interference
tin histogram.
 no power offset is defined on the interfered TRX type, it is possible to set "All".
f•I

r o•F
each  interfered  subcell‐interferer  subcell  pair,  Atoll  saves  probabilities  for
several C/I values (6 to 24 values), including five fixed ones: –9, 1, 8, 14, and 22 dB.
Between two fixed C/I value, there can be up to three additional values (this number
depends on the probability variation between the fixed values). The C/I values have
0.5 dB accuracy and probability values are calculated and stored with an accuracy of
0.002  for  probabilities  between  1  and  0.05,  and  with  an  accuracy  of  0.0001 
for probabilities lower than 0.05.

9.7.1 CLC Format (One Value per Line)
The CLC format uses wo ASCII text files: a CLC file and a DCT file. Interference matrices are imported by selecting the CLC file
to import. Atoll looks for the associated DCT file in the same directory and uses it to decode transmitter identifiers. If no DCT
file is available, Atoll assumes that the transmitter identifiers are the transmitter names, and the columns 1 and 2 of the CLC
file must contain the names of the interfered and interfering transmitters instead of their identification numbers.

9.7.1.1 CLC File Format
The CLC file consists of two parts. The first part is a header used for format identification. It must start with and contain the
following lines:

# Calculation Results Data File.


# Version 1.1, Tab separated format. Commented lines start with #.

The second part details interference histogram of each interfered subcell‐interfering subcell pair. The lines after the header
are considered as comments if they start with "#". If not, they must have the following format:

<Column1><tab><Column2><tab><Column3><tab><Column4><tab><Column5><newline>

The 5 tab‐separated columns are defined in the table below:

Column Name Description


Identification number of the interfered transmitter. If the column is empty, 
Column1 Interfered transmitter
its value is identical to the one of the line above.
Identification number of the interferer transmitter. If the column is null, its 
Column2 Interfering transmitter
value is identical to the one of the line above.
Interfered subcell. If the column is null, its value is identical to the one of the 
Column3 Interfered TRX type line above. In order to save storage, all subcells with no power offset are not 
duplicated (e.g. BCCH, TCH).

97
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

Column Name Description


Column4 C/I threshold C/I value. This column cannot be null.
Probability to have C/I the value specified in column 4 (C/I threshold). This 
Column5 Probability C/I > Threshold
field must not be empty.

The columns 1, 2, and 3 must be defined only in the first line of each histogram.

Sample

# Calculation Results Data File.


# Version 1.1, Tab separated format. Commented lines start with #.
# Remark: C/I results do not incorporate power offset values.
# Fields are:
##------------#------------#------------#-----------#------------------#
#| Interfered | Interfering| Interfered | C/I | Probability |
Transmitter|
Threshold
#|
##------------#------------#------------#-----------#------------------#
Threshold
>=C/I
| |Transmitter|
type
Trx

#
# Warning, The parameter settings of this header can be wrong if
# the "export" is performed following an "import". They
# are correct when the "export" follows a "calculate".
#
# Service Zone Type is "Best signal level of the highest priority HCS layer". # Margin is 5.

# Cell edge coverage probability 75%.


# Traffic spreading was Uniform
##---------------------------------------------------------------------# 1 2 T

9 0.944
10 0.904
11 0.892
14 0.844
15 0.832
16 0.812
17 0.752
22 0.316
25 0.292 1 2 BCCH,TCH

a
8 1
9 0.944
10 .904
13 0.872 14 0.84

17 0.772
a. If the TCH and BCCH histograms are the same, they are not repeated. A single record indicates that the histograms
belong to TCH and BCCH both.

9.7.1.2 DCT File Format
The .dct file is divided into two parts. The first part is a header used for format identification. It must start with and contain
the following lines:

# Calculation Results Dictionary File.

98
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

# Version 1.1, Tab separated format. Commented lines start with #.

The second part provides information about transmitters taken into account in AFP. The lines after the header are considered
as comments if they start with "#". If not, they must have the following format:

<Column1><tab><Column2><newline>

Column Name Type Description


Column1 Transmitter name Text Name of the transmitter
Column2 Transmitter Identifier Integer Identification number of the transmitter
Column3 BCCH during calculation Integer BCCH used in calculations
Column4 BSIC during calculation Integer BSIC used in calculations
Column5 % of vic’ coverage Float Percentage of overlap of the victim service area
Column6 % of int’ coverage Float Percentage of overlap of the interferer service area

The  last four  columns  describe  the  interference  matrix  scope.  One  transmitter  per  line  is  described  separated  with 
a tab character.

Sample

# Calculation Results Dictionary File.


# Version 2.1, Tab separated format. Commented lines start with #.
# Fields are:
##-----------#-----------#-----------#-----------#---------#---------#
#|Transmitter|Transmitter|BCCH during|BSIC during|% of vic'|% of int'|
#|Name |Identifier |calculation|calculation|coverage |coverage |
##-----------#-----------#-----------#-----------#---------#---------# #

Warning,
# The
parameter
settings
of
this
header
can
be
wrong
the
if
#"export"
is
performed
following
an
"import".
They

# are correct when the "export" follows a "calculate".


#
# Service Zone Type is "Best signal level per HCS layer".
# Margin is 5.
# Cell edge coverage probability is 75%.
Traffic
# spreading
was
Uniform
(percentage
interfered
of area)
##---------------------------#

Site0_0 1 -1 -1 100 100


Site0_1 2 -1 -1 100 100
Site0_2 3 -1 -1 100 100
Site1_0 4 -1 -1 100 100
Site1_1 5 -1 -1 100 100
Site1_2 6 -1 -1 100 100
Site2_0 7 -1 -1 100 100 Site2_1 8 -1 -1 100 100

9.7.2 IM0 Format (One Histogram per Line)
This file contains one histogram per line for each interfered/interfering subcell pair. The histogram is a list of C/I values with
associated probabilities.
The .im0 file consists of two parts. The first part is a header used for format identification. It must start with and contain the
following lines:

# Calculation Results Data File.

99
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

# Version 1.1, Tab separated format. Commented lines start with #.

The second part details interference histogram of each interfered subcell‐interferer subcell pair. The lines after the header
are considered as comments if they start with "#". If not, they must have the following format:

<Column1><tab><Column2><tab><Column3><tab><Column4><newline>

The 4 tab‐separated columns are defined in the table below:

Column Name Description


Column1 Interfered transmitter Name of the interfered transmitter.
Column2 Interfering transmitter Name of the interferer transmitter.
Interfered subcell. In order to save storage, all subcells with no power offset 
Column3 Interfered TRX type
are not duplicated (e.g. BCCH, TCH).
C/I value and the probability associated to this value separated by a space 
Column4 C/I probability 
character. This entry cannot be null.

Sample

# Calculation Results Data File.


# Version 1.1, Tab separated format. Commented lines start with #.
# Remark: C/I results do not incorporate power offset values.
# Fields are:
#--------------------------------------------
---------------------------- #Transmitter Interferer TRX type {C/I Probability} val

#
# Warning, The parameter settings of this header can be wrong if
# the "export" is performed following an "import". They
# are correct when the "export" follows a "calculate".
#
# Service Zone Type is "Best signal level of the highest priority HCS layer". # Margin is 5.

# Cell edge coverage probability 75%.


# Traffic spreading was Uniform
##---------------------------------------------------------------------# #

Site0_2 Site0_1 BCCH,TCH-10 1 -9 0.996 -6 0.976 -4 0.964 -1 0.936 0 0.932 1 0.924 4 0.

9 0.832 10 0.824 11 0.804 14


0.712 17 0.66 Site0_2 Site0_3 BCCH,TCH-10 1 -9 0.996 -6 0.976 -4 0.972 -1 0.948 0 0.94

11 0.772 13 0.688 14 0.636 15 0.608 18 0.556


Site0_3 Site0_1 BCCH,TCH-10 1 -9 0.996 -6 0.98 -3 0.948 0 0.932 1 0.924 4 0.892 7 0.85

10 0.784 11 0.764 14 0.644 15 0.616 18 0.564


Site0_3 Site0_2 BCCH,TCH-9 1 -6 0.972 -3 0.964 -2 0.96 0 0.94
1 0.932 4 0.904 7 0.876 8 0.86 9 0.844
11 0.804 13 0.744 14 0.716 15 0.692 18 0.644

9.7.3 IM1 Format (One Value per Line, TX Name Repeated)
This  file  contains  one  C/I  threshold  and  probability  pair  value  per  line  for  each  interfered/interfering  subcell  pair. 
The histogram is a list of C/I values with associated probabilities.

100
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

The .im1 file consists of two parts. The first part is a header used for format identification. It must start with and contain the
following lines:

# Calculation Results Data File.


# Version 1.1, Tab separated format. Commented lines start with #.

The second part details interference histogram of each interfered subcell‐interferer subcell pair. The lines after the header
are considered as comments if they start with "#". If not, they must have the following format:

<Column1><tab><Column2><tab><Column3><tab><Column4><tab><Column5><newline>

The 5 tab‐separated columns are defined in the table below:

Column Name Description


Column1 Interfered transmitter Name of the interfered transmitter.
Column2 Interfering transmitter Name of the interferer transmitter.
Interfered subcell. In order to save storage, all subcells with no power offset 
Column3 Interfered TRX type
are not duplicated (e.g. BCCH, TCH).
Column4 C/I threshold C/I value. This column cannot be null.
Probability to have C/I the value specified in column 4 (C/I threshold). This 
Column5 Probability C/I > Threshold
field must not be empty.

Sample

# Calculation Results Data File.


# Version 1.1, Tab separated format. Commented lines start with #.
# Remark: C/I results do not incorporate power offset values.
# Fields are:
#----------------------------------------
-------------------------------- #Transmitter Interferer TRX type C/I Probabi

#
# Warning, The parameter settings of this header can be wrong if
# the "export" is performed following an "import". They
# are correct when the "export" follows a "calculate".
#
# Service Zone Type is "Best signal level of the highest priority HCS layer". # Margin is 5.

# Cell edge coverage probability 75%.


# Traffic spreading was Uniform
##---------------------------------------------------------------------# Site0_2 Site0

Site0_2 Site0_1 BCCH,TCH -9 0.996


Site0_2 Site0_1 BCCH,TCH -6 0.976
Site0_2 Site0_1 BCCH,TCH -4 0.964
Site0_2 Site0_1 BCCH,TCH -1 0.936
Site0_2 Site0_1 BCCH,TCH 0 0.932
Site0_2 Site0_1 BCCH,TCH 1 0.924
Site0_2 Site0_1 BCCH,TCH 4 0.896
Site0_2 Site0_1 BCCH,TCH 7 0.864
Site0_2 Site0_1 BCCH,TCH 8 0.848
Site0_2 Site0_1 BCCH,TCH 9 0.832
Site0_2 Site0_1 BCCH,TCH 10 0.824 ...

101
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

9.7.4 IM2 Format (Co‐ and Adjacent‐channel Probabilities)
IM2  files  contain  co‐channel  and  adjacent‐channel  interference  probabilities  for  each  interfered  transmitter  – 
interfering
transmitter pair. In GSM, there is only one set of values for all the subcells of the interfered transmitter. Each line must have the followin

<Column1><SEP><Column2><SEP><Column3><SEP><Column4><newline>

Where the separator (<SEP>) can either be a tab or a semicolon.
The four columns are defined in the table below:

Column Name Description


Column1 Interfered transmitter Name of the interfered transmitter
Column2 Interfering transmitter Name of the interferer transmitter
Column3 Co‐channel probability Co‐channel interference probability
Column4 Adjacent‐channel probability Adjacent channel interference probability

Sample

# Calculation Results Data File.


# Version 1.1, Tab separated format. Commented lines start with #.
# Remark: C/I results do not incorporate power offset values.
# Fields are:
#-------------------------------------------
----------------------------- #Transmitter Interferer Co-channel Adjacent channe

#
# Warning, The parameter settings of this header can be wrong if
# the "export" is performed following an "import". They
# are correct when the "export" follows a "calculate".
#
# Service Zone Type is "Best signal level of the highest priority HCS layer". # Margin is 5.

# Cell edge coverage probability 75%.


# Traffic spreading was Uniform
##---------------------------------------------------------------------# Site0_2 Site0_1

Site0_2 Site0_3 0.27


0.024 Site0_3 Site0_1 0.276 0.02 Site0_3 Site0_2 0.226 0.028

The columns in the sample above are separated with a tab. These columns can also be separated with a semilcolon:

Site0_2;Site0_1;0.226667
;0.024
Site0_2;Site0_3;0.27;0.024 Site0_3;Site0_1;0.276;0.02 Site0_3;Site0_2;0.226;0.028

9.8 "Per Transmitter" Prediction File Format
When a coverage prediction is calculated by value intervals it is stored externally, i.e., outside the ATL file. A corresponding
’<doc_name>\{<GUID>}’ folder is actually created where the ATL document is located, as soon as the latter is saved. 

102
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 9: Radio Data Formats

The calculation of the coverage prediction is either global or "per transmitter".
n the calculation is global, the results are stored in two files for the entire prediction: one HDR file and one BIL
e•W
h
file (both identified by the prediction name).
•When a calculation is "per transmitter", one HDR
ile and one BIL file are created for each transmitter in the prediction
f  
(both identified by the transmitter’s name). In s
e "per transmitter" predictions, an additional DBF file is created for
mo
the entire prediction (identified by the predicti
 name). The DBF file contains information on each transmitter and a
no
pointer to each transmitter’s specific HDR and BI
files. 
  L

In LTE, when a  Cell Identifier Collision Zones (DL) prediction is calculated by value intervals with the display type set
"No. of interferers per cell", the HDR file and the BIL file are created for each cell in the prediction (both identified by
the cell’s name).
The format and the content of the DBF file is described here.

In both cases, an XML file describing the prediction is also created in the corresponding
’<doc_name>\{<GUID>}’ folder. 

9.8.1 <per_transmitter_prediction>.dbf File Format
The format of ‘<per_transmitter_prediction>.dbf’ files is identical to the format described in "Pathloss.dbf File Format" on
page 92.

9.8.2 <per_transmitter_prediction>.dbf File Contents
The ‘<per_transmitter_prediction>.dbf’ files generated in specific ’{<GUID>}’ folders provide information that is needed to
check the validity of each "per transmitter" prediction> calculated by value intervals.

Field Type Description


TX_NAME Text Name of the transmitter
FILE_NAME Text Name of the transmitter’s BIL result file
RESOLUTION Float Resolution of the calculation, same as ’xdim’ and ’ydim’ in the HDR file
AREA_XMIN Float Same as ’ulxmap’ in the HDR file
AREA_XMAX Float Same as ’ulxmap’ + ’xdim’ * ’ncols’ in the HDR file
AREA_YMIN Float Same as ’ulymap’ in the HDR file
AREA_YMAX Float Same as ’ulymap’ + ’ydim’ * ’nrows’ in the HDR file
NBITS Float Same as ’nbits’ in the HDR file
NBANDS Float Same as ’nbands’ in the HDR file
BYTE_ORDER Float Same as ’byteorder’ in the HDR file
BAND_ROW_BYTES Float Same as ’bandrowbytes’ in the HDR file
TOTAL_ROW_BYTES Float Same as ’totalrowbytes’ in the HDR file
SKIP_BYTES Float Same as ’skipbytes’ in the HDR file
DATA_TYPE Text Same as ’datatype’ in the HDR file
NO_DATA_VALUE Same as ’nodatavalue’ in the HDR file

103
Atoll 3.2.1 Administrator Manual
Chapter 9: Radio Data Formats © Forsk 2014

104
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 10: Administration and Usage Recommendations

10 Administration and Usage Recommendations
This chapter lists various technical recommendations for optimising your work with Atoll.

10.1 Geographic Data
Location of the Geographic Data

n multi‐user environments, it is recommended to place all the geographic data on a file server accessible to all the
•I
users. This approach avoids the need to replicate the geographic data on all the workstations.
c data should either be located on each server or accessible through a fast network connection, e.g., 1
i h p a r g o•G
e Gbps.
u can restrict access to the geographic data locations by assigning read/write access rights to administrators and
o•Y
read‐only rights to end‐users.

Link or Embed

y  lembed 
•O
n geographic  data  in  ATL  files  if  you  wish  to  make  a  portable  document.  In  all  other  cases,  it  is
recommended to link geographic data files to the Atoll documents.
t is recommended to set the paths to linked geographic data files using the Universal Naming Convention (UNC).
•I
Following  the  UNC,  an  absolute  path,  such  as  "C:\Program  Files\Forsk\Geo  Data\...",  is  represented  as
"\\Computer\C\Program Files\Forsk\Geo Data\...", where "Computer" is the computer name, and "C" is the share
name of disk C.

Example:

Absolute Path C:\Program Files\Forsk\Geo Data\...
Relative Path \Program Files\Forsk\Geo Data\...
UNC Path \\Computer\C\Program Files\Forsk\Geo Data\...

If you define paths to geographic data files using the UNC, Atoll will be able to keep track of the linked files even if the
Atoll document is moved to another computer.

Size of Tiles

e network planning tools require geographic data to be available in small tiles in order to work more efficiently.
mo•S
For  a  country‐wide  project,  this  can  lead  to  hundreds  of  files  describing  the  geographic  data. 
Atoll  is  designed  to
optimise memory consumption, which enables it to perform efficiently with regional tiles (1 tile/file per region). In
Atoll, Merging small tiles to build a regional tile can improve performance greatly.
o note as well:
•T
• Recommended file size: 100 to 200 MB
•Erdas Imagine Pyramids files can be bi
r.e g g
•ECW files can be of any size (no limit
ons).
i ta

Recommended Formats

n order to improve performance, it is recommended to use uncompressed DTM and clutter files, for example, BIL
•I
files. Using compressed geographic data files, for example, compressed TIF or Erdas Imagine, can cause performance
reduction due to decompression of these files in real time. If you are using compressed geographic data files, it is
strongly recommended to:
, hide the status bar that displays geographic data information in real time. You can hide the status bar from
r e h t i•E
the View menu.
, disable the display of some of the information contained in the status bar, such as altitude, clutter class, and
•O
r
clutter height using an option in the Atoll.ini file, see "Hiding Information Displayed in the Status Bar" on page 160.
e following table shows the recommended file formats for different geographic data:
h•T

Geographic data type Recommended file format
Scanned maps ECW
Vectors SHP

105
Atoll 3.2.1 Administrator Manual
Chapter 10: Administration and Usage Recommendations © Forsk 2014

10.2 Path Loss Matrices
Shared Path Loss Matrices

d path 
e r a h•Sloss matrices should be accessible through a  fast network  connection, e.g., 1 Gbps. These results are
accessed by  Atoll during calculations, and should be available to the users through a fast network connection, i.e.,
30 Mbps at least per user.
•You can restrict access to t
e shared path loss matrices folder by assigning read/write access rights to administrators
h
and read‐only rights to end‐u
ers.
s

Private Path Loss Matrices

• Atoll synchronises the private path loss matrices with the shared path loss matrices. If private path loss matrices are
invalid, and the corresponding shared path loss matrices are valid, Atoll deletes the invalid private path loss matrices
and uses the shared ones. You can make  Atoll verify and remove private path loss matrices, valid or invalid, whose
corresponding  shared  path  loss  matrices  are  valid.  This  can  be  useful  for  disk  space  management.  For  more
information, see "Synchronising Private and Shared Path Loss Matrices" on page 155.

Link or Embed

y  lembed 
•O
n path  loss  matrices  in  ATL  files  if  you  wish  to  make  a  portable  document.  In  all  other  cases,  it  is
recommended to link path loss matrices to the Atoll documents.
Externalising path loss matrices to shared or private path loss folders will keep the ATL file size reasonable, which will
result  in  less  fragmentation.  Externalising  path  loss  matrices  does  not  reduce  the  performance  of  display  and
calculations in Atoll.
t is recommended to set the paths to the private and shared path loss matrices folders using the Universal Naming
•I
Convention (UNC).
Following  the  UNC,  an  absolute  path,  such  as  "C:\Program  Files\Forsk\PathLosses\...",  is  represented  as
"\\Computer\C\Program Files\Forsk\PathLosses\...", where "Computer" is the computer name, and "C" is the share
name of disk C.

Example:

Absolute Path C:\Program Files\Forsk\PathLosses\...
Relative Path \Program Files\Forsk\PathLosses\...
UNC Path \\Computer\C\Program Files\Forsk\PathLosses\...

If you define paths to the private and shared path loss matrices folders using the UNC, Atoll will be able to keep track
of the linked files even if the Atoll document is moved to another computer.

Calculating Path Loss Matrices in Multi‐RAT Documents

n the path loss matrices in multi‐RAT documents using the RunPathloss API function, the path loss matrices of
e•W
h
each technology are calculated simultaneously using the same number of threads. For example, if 4 threads are used
to calculate path loss matrices, and there are 3 technologies (GSM, UMTS, and LTE), a total of 12 threads will be used
to calculate the path loss matrices at the same time. This can lead to the following problems:
t CPU resources
n e i c i f f u s n•I
t memory
n e i c i f f u s n•I
t licences if external propagation models are used.
n e i c i f f u s n•I

•Tavoid  these  problems  when  using  the  RunPathloss  API  function  to  calculate  path  loss  matrices  in  multi‐RAT documents, us

e the Distributed Calculation Server, even locally.
•U
s
 your script or macro, deactivate the transmitters of 
n•I the technologies for which you do not want to calculate the
h loss matrices and reactivate them afterwards. Repeat
tpa  it for all technologies.
r ethe 
wo•L number  of  threads  using  the  NumberOfThreadsPathloss  option  in  RemoteCalculation  section  in Atoll.ini. For example
 the RunPathloss function.
g n ius

e csaturation 
r u o s e•R during  the  calculation  of  path  loss  matrices  for  multi‐RAT documents only occurs when using the RunPa

When calculating path loss matrices for a multi‐RAT document using  Atoll, this does
not occur.

106
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 10: Administration and Usage Recommendations

• Atoll synchronises the private path loss matrices with the shared path loss matrices. If private path loss matrices are
invalid, and the corresponding shared path loss matrices are valid, Atoll deletes the invalid private path loss matrices
and uses the shared ones. You can make  Atoll verify and remove private path loss matrices, valid or invalid, whose
corresponding  shared  path  loss  matrices  are  valid.  This  can  be  useful  for  disk  space  management.  For  more
information, see "Synchronising Private and Shared Path Loss Matrices" on page 155.

10.3 Atoll Documents
General

t is recommended to define a rule for making backups of your 
•I Atoll documents at regular intervals.
•D
o not skip a major  Atoll version. For example, if you are currently using  Atoll 2.8.x, you should first upgrade the
document to Atoll 3.1.x before upgrading to Atoll 3.2.x.
Upgrading  your  document  will  be  simpler  if  you  do  not  skip  a  major  version.  If  you  skip  or  have  skipped  an
intermediate major version, you should upgrade your document twice in order to make it compatible with the new
version.

10.4 Databases
General

n order to use 
•I Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
e backups of the database before upgrading.
t a e r•C
t is recommended to define a rule for making backups of the database at regular intervals.
•I
•D
o not skip a major  Atoll version. For example, if you are currently using  Atoll 2.7.x, you should first upgrade the
database to Atoll 2.8.x before upgrading to Atoll 3.1.x.
Upgrading your database will be simpler if you do not skip a major version. If you skip or have skipped an intermediate
major version, you must upgrade your database twice in order to make it compatible with the new version.

Tables and Fields

e and field names are case sensitive.
l b a•T
e and field names should be not more than 20 characters long.
l b a•T
Oracle databases allow a maximum length of 30 characters for field and table names. However, for use in  Atoll, you
must not create tables and fields with names longer than 20 characters. This is because Atoll adds some characters to
the table and field names for certain operations: creating associated triggers, creating project databases, etc. Limiting
the length of table and field names to 20 characters will help avoid database connection and consistency problems.
e and field names should only use alphanumeric characters (A‐Z, a‐z, 0‐9) and underscores (_).
l b a•T
e and field names must not start with a numeric character (0‐9).
l b a•T
e and field names must not contain an SQL or RDBMS‐specific keyword, such as ORDER, DATE, etc.
l b a•T
e and field names must not contain spaces or special characters, such as periods (.), exclamation marks (!), colons
l b a•T
(:), semi‐colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
n fields, system or user‐defined, should always have default values assigned.
a e l oo•B
e CustomFields table enables you to define default values, choice lists, and read/write access for any field in any
h•T
table  in Atoll,  including  user‐defined  fields  that  you  add to  the 
Atoll tables.  The values  defined  in  this table  have
priority over the internal predefined default values. If you define floating point default values, make sure that all the
users have the same decimal separator.
f you wish to add custom fields in the 
•I Atoll document, you should first add the field in the database, and then update
your Atoll document from the database. 
n setting up your database for the first time, try to anticipate user requirements in terms of custom fields in 
e•Wh Atoll
tables. Some requirements of the different user groups can be satisfied if a few general‐purpose user‐defined fields
are added in Atoll tables when setting up the database.
For example, if you add three user‐defined fields (one of type integer, float, and text (limited size)) to the Sites and
Transmitters tables, users will be able to use these for sorting, filtering, grouping, or other purposes. This approach
can help the database function a long time before users require the addition of other custom fields.

•Timprove  performance,  if  your  projects  allow  it,  reduce  the  size  of  the  fields  corresponding  to  the  sites  and transmitte


•Timprove  performance,  unless  absolutely  necessary,  do  not  add  user‐defined  fields  of  Text  type.  Rather,  use
meric field types, which allow sorting and other functions. If you must add Text fields, allocate them the appropriate
nu
ze that would suffice. For example, a 255‐character long Text type field would, for the most part, occupy disk space
si
r no purpose.
fo •To improve performance, you should avoid adding custom fields to the neighbour management tables.

107
Atoll 3.2.1 Administrator Manual
Chapter 10: Administration and Usage Recommendations © Forsk 2014

10.5 Calculation Server
Computation Server Stability and Resource Management

In certain conditions, as described below,  Atoll users might experience a decrease in server performance and stability in a
multi‐user Citrix environment. The principal difference observed might be the inability to run multiple  Atoll sessions on the
server without getting error messages, general application failures, or server crashes. Such problems can occur when the
number of Atoll sessions on the server, carrying out calculations, increases to more than four.

Causes of Instability and Loss of Performance

This general instability and low performance of the servers is due to:
• Insufficient memory resources: globally and per process (Atoll session)
• Insufficient CPU resources
k congestion
r owt •N
e
Atoll can process four simultaneous path loss matrices calculations, which means high CPU and RAM resource consumption,
and as path loss calculations share the amount of memory allocated to the  Atoll session, the total memory requirement can
exceed  the  Microsoft  Windows’  (32‐bit  editions)  limit  of  2GB  per  process.  This  is  especially  the  case  with  large 
Atoll
documents and propagation models that require considerable memory.

Troubleshooting and Solution

As the cause of this problem is resource saturation on the server, resource consumption should be controlled in order to avoid
memory and CPU overloading as follows:
o reduce the impact of a large number of simultaneous path loss calculations, a Distributed Calculation Server should
•T
be set up. Using the Distributed Calculation Server, path loss calculations can be performed outside  Atoll. Using the
Distribution Calculation Server has the following advantages:
h loss calculations are limited to four parallel instances regardless of the number of 
t a•P Atoll sessions running on
the server. This notably improves the memory and CPU consumption.
•A  queuing  system,  integrated  in  the  Distributed  Calculation  Server,  manages  the  calculation  requests  from
different Atoll sessions.
•A failover mechanism automatically switches and hands over the path loss calculations back to  Atoll in case a
problem occurs.
h loss calculations are carried out by a separate process (AtollSvr), which has its own memory allocation apart
t a•P
from Atoll, i.e., the amount of memory needed for calculations does not impacts the Atoll memory allocation.
This set up can introduce considerable improvements in both the number of Atoll sessions per server and the calculations. A
server with four processors (eight threads with hyper‐threading) can accommodate four simultaneous path loss calculations
and use the other four threads for Atoll sessions. Atoll’s interface will also be more efficient and the overall processing time
for various tasks will be improved.

In order to prevent users from deactivating the use of the Distributed Calculation Server,
and hence bypassing the resource control procedure established above, the Atoll.ini file
should be set made read‐only for end‐users.

Apart from the above setup, you can also make some other system improvements:

•Tavoid  error  messages  caused  by  requesting  a  large  number  of  files  over  the  network,  the  following  Microsoft
Wi
ndows registry parameter can be modified in order to dedicate more resources to network read/write operations:
QSTACKSIZE should be set to 30 instead of 11, for example.
IR

o avoid ‘out of memory’ problems, the Pagefile size should be increased so that the server does not run out of global
•T
memory when supporting more than 10  Atoll sessions simultaneously. This is different from the 2GB per process
limit. Virtual memory can be increased from 8GB to 16 GB, for example.
•For 32‐bit Windows operating systems, you can also increase the default 
indows memory allocation limit from 2GB
W
to 3GB as explained in "Process Memory" on page 109.

10.6 Atoll Administration Files
There is no specific order in which configuration and initialisation files should be created or installed on  Atoll workstations
and  servers.  It  is  sufficient  to  have  these  files  created  and  placed  in  the  right  locations  before  running 
Atoll  to  have  the
predefined configuration of all workstations and servers.
If you have already configured these files for one server, and you are setting up another server, you can copy these files to
their respective locations on the new server to have the exact configuration and set‐up as the first. If you do not copy these

108
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 10: Administration and Usage Recommendations

files, or create them, you will not have the same configuration of the new server, but apart from that you will be able to work
with Atoll normally. These files are optional, not obligatory.

Initialisation File (INI)

t is highly recommended that the 
•I Atoll initialisation file be created and modified only by the administrator.
f you are using Windows 2000 Server, state the actual number of processors in the INI file.
•I

User Configuration File (CFG)

e •U
s Atoll to create these files and avoid modifying these files manually as human errors can create problems.
• Uncheck image visibility to avoid loading unnecessary data in the memory.
u can set up your configuration files in the following manner:
o•Y
•A common configuration file that points to the geographic data, macros, and other common parameters in your
Atoll documents.
• Separate configuration files created for your 2G and 3G projects, which would store their respective coverage
prediction  studies  parameters,  traffic  information,  neighbour  allocation  parameters,  and  other  technology‐
specific parameters.
• Separate  configuration  files  based  on,  and  for,  different  groups  of  users.  These  groups  of  users  can  be, 
for
example, groups of users working on different regions, groups of users working on different technologies, groups
of users focusing on certain operations (i.e., performing certain types of coverage predictions, performing the AFP, etc.).

Custom Predictions File

e gprediction 
a r e v o•C studies  can  easily  be  duplicated  within  Atoll.  Before  creating  study  templates,  and  the  XML
studies file, make sure that this study template is aimed at serving a number of users. This means, avoid creating study
templates unless these will be needed for a long time by a number of users. You can use the configuration files to store
your created coverage prediction studies locally. And, you can also use the study duplicate feature to create copies of
existing coverage prediction studies.

10.7 Process Memory
32‐bit Operating Systems

Atoll  can  support  3GB  address  space  on  a  properly  configured  32‐bit  system.  For  more  information,  please  refer  to  the
following  URL:  http://www.microsoft.com/whdc/system/platform/server/PAE/PAEmem.mspx  (/3GB  section  in  “Memory
Support and Windows Operating Systems”).
The following link provides information on how you can setup your Windows Server 2003 systems to activate the 3GB switch
at startup: http://technet.microsoft.com/en‐us/library/bb124810.aspx.

64‐Bit Operating Systems

The 64‐bit editions of Microsoft Windows provide 4GB of memory per process.

10.8 Printing
You should place different layers of geographic and radio data in a definite order when printing a project or a section of the
project. The following order should be followed:
1. Visible objects of the Data tab
All the visible objects of the Data tab are displayed above those in the Geo tab. However, it is strongly recommended
to place vector layers on the top of coverage prediction plots. You can do this by transferring these vector layers to
the Data tab using the context menu.  For performance reasons, it is advised to place vector layers on top of raster
layers before printing a project . Sites and Transmitters must be on the very top, above all other layers. You should
place sites and sectors on the top, then vector layers, and then raster layers.
2. Unidimensional vectors (points)
3. Open polygonal vectors (lines, i.e., roads and other linear items, etc.)
4. Closed polygonal vectors (surfaces, i.e., zones and areas, etc.)
5. Multi‐format maps (vector or raster maps, i.e., population, rain, generic maps, traffic, etc.)
6. Transparent raster maps (clutter class maps, etc.)
7. Non‐transparent maps (images, DTM, clutter height maps, etc.)

109
Atoll 3.2.1 Administrator Manual
Chapter 10: Administration and Usage Recommendations © Forsk 2014

10.9 Coverage Prediction Calculations
f you do not want 
•I Atoll to calculate the shadowing margin during a coverage prediction, it is advised to clear the
Shadowing taken into account check box. This approach is more efficient in terms of performance than selecting this
option and setting the Cell edge coverage probability to 50%.

•Timprove  memory  consumption  and  optimise  the  calculation  times,  you  should  set  the  display  resolutions  of
coverage  predictions  according  to  the  precision  required.  The  following  table  lists  the  levels  of  precision 
that  are usually sufficient:

Size of the coverage prediction Display resolution
City Center 5 m
City 20 m
County 50 m
State 100 m
Country According to the size

10.10 CW Measurements and Drive Test Data
t is recommended to use Fast Display in order to increase display speed. This option is available in the Display tab of
•I
the  Properties dialogues for CW Measurements  and Drive Test  Data folders. Although  this  approach only  displays
measurement points as small squares, it can have a significant impact on performance depending on the number of
measurement points in the Atoll document.
n performing a CW measurements drive test campaign, please follow the recommended procedure described in
e•W
h
the Measurements and Model Calibration Guide.

10.11

Antenna Patterns and Import
Antenna names used in some tools, such as NetAct, can be different from those used in their corresponding antenna
files. To solve this issue, you can create a new file, named "Index", containing the list of antenna names, which would
in fact be the pattern (antenna file) names. You should place this file at the same location as the antenna patterns
(files). This will replace the antenna names with the new antenna names.
•Some Kathrein antenna pattern files might have names different from the an nna pattern names present inside the
et
file. You will have to replace the name of the pattern inside the file by t
 name of the pattern file itself, in order to
eh
import these antennas correctly.
•A Planet Index file contains the path to and the name of each antenna file
vailable. Creating such an Index file when

there are hundreds of antenna patterns available can be a difficult task. Y
 can easily create the index file from the
uo
Microsoft Windows command prompt. You can open the Command Prompt window by electing Start > Run, entering
s   "cmd" 
and  pressing  ENTER.  In  the  Command  Prompt  window,  navigate  directory 
to  the
  containing  the  antenna
pattern files, enter the following command and press ENTER:

dir /b > Index


Thiswillcreateafilecalled"Index"inthesamedirectoryastheantennapatterfilescontainingalis

this file into Atoll, you should use a text editor to remove the line containing the file name "Index."
e electrical tilt, which can be defined in the antenna properties dialogues in 
h•T Atoll, is an additional electrical downtilt.
It  might  be  redundant  to  define  an  additional  electrical  downtilt  for  antennas  whose  patterns  already  include
electrical  tilt.  Users  should  verify  whether  the  antenna  patterns  of  the  antennas  in  their  projects,  do  not 
already include the effect of an electrical tilt.

10.12 Traffic Maps
r profile environment‐based traffic maps should only be used for a precision on traffic that is of the same level as
e •U
s
the statistical clutter available in a project.
•For higher precision on traffic data, you should 
se sector traffic maps or user density traffic maps. User density traffic
u
maps provide you with a means to define a density  or each set of service, terminal type, and mobility type.
f
r traffic maps are best suited for traffic data issued by the OMC.
o t c e•S

110
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 10: Administration and Usage Recommendations

10.13 Atoll API
Correct functioning of Atoll when using Atoll through the API is guaranteed during interactive user sessions only.  Atoll is an
application  that  requires  creating  tool  bars,  creating  menus,  reading  user  profile  options  from  the  Windows’  registry,
accessing printers, etc., even when it is accessed through the API. The same is true for add‐ins working with Atoll.
Even though it is possible to load and use  Atoll when there is no user session open on a computer, its correct functioning is
not guaranteed. Unexpected errors can occur. Particularly, creating objects through CreateObject or CoCreateInstance might
fail.
Therefore, the correct functioning of Atoll requires an open user session on the computer.

10.14 Performance and Memory
Memory Refresh

u can avoid memory fragmentation while working with 
o•Y Atoll documents by saving the Atoll document from time to
time, closing and restarting Atoll, and reopening the document.
This advice is applicable to any application running under Microsoft Windows because many common DLL files are
accessed by applications, and unloading and reloading these DLL files refreshes the memory allocation.
f you are working in a Citrix XenApp environment, you should restart your Citrix server every week or fortnight. The
•I
exact time should be determined by the administrator depending on the state of the network (LAN).
n certain cases, it might be more appropriate to start working on a completely fresh ATL file. If you have been working
•I
on your existing ATL file for a long time, it might become unnecessarily large and might contain some useless remains
from  your  earlier  operations,  e.g.,  traces  of  records  that  no  longer exist  in  the database,  etc.  You  can 
completely refresh your project by following these steps:
a. Open the existing ATL file in Atoll that you want to replace.
b. Create a CFG file from your existing ATL file with all the required information, e.g., geographic data set, coverage
prediction parameters, neighbour allocation parameters, etc. For more information, refer to "Configuration Files"
on page 117.
c. Close the old ATL file.
d. Create a new ATL from the database to create a fresh ATL file.
e. Import the CFG file in the new ATL file.
You now have a clean ATL file to work with, which has all the same information as the old ATL file, and takes up less
space on the hard disk, has less fragmented data, and improved performance.

Memory Allocation

f you have to open several large ATL files simultaneously on the same computer, it is better to open each in a separate
•I
Atoll session rather than to open them all in the same Atoll window. Each Atoll session on the same computer has its
own memory space allocated by the operating system. Each computer consumes a single licence token independent
of the number of Atoll sessions opened simultaneously.
r 32‐bit Windows operating systems, you can also increase the default Windows memory allocation limit from 2G
o•F B
to 3GB as explained in  "Process Memory" on page 109.

File Size

e gpredictions calculated over 
a r e v o•C large  areas require more memory. If you are working on an  Atoll document
covering a large area, with coverage predictions calculated over the entire network, this document will require more
memory for loading all the coverage predictions. You can reduce memory consumption by making copies of your  Atoll
document, and keeping a few coverage predictions in each copy. These ATL files will be faster to load and work with
compared to a single ATL file with all the coverage predictions.
Large coverage predictions can take up a considerable amount of memory even if they are not displayed on the map.
e DTM, clutter, path loss matrices, and any other data that can be externalised, so that the ATL file size does
s i l a n r e t x•E
not become unnecessarily large.

Path Loss Calculation

e starting path loss calculation, verify that the calculation radii and resolutions assigned to the different types of
r o f e•B
transmitters are consistent. For example, calculating path loss matrices of picocells over large calculation radii would
only waste memory and disk space.

111
Atoll 3.2.1 Administrator Manual
Chapter 10: Administration and Usage Recommendations © Forsk 2014

r calculating path loss matrices over large areas, you should use the dual resolution feature in 
o•F Atoll. Define short
calculation radii and fine resolutions for the main path loss matrices, and large calculation radii and low resolutions
for extended path loss matrices. This approach decreases the calculation time significantly compared to calculating
just one matrix per transmitter using a fine resolution. The main path loss matrices should be calculated using the
same resolution as the resolution of the geographic data available. The extended path loss matrices can be calculated
using a lower resolution, e.g., twice the resolution of the geographic data.

Regionalisation

e database regionalisation or site lists if you are working on smaller parts of a large network. 
•U
s Atoll loads only the
Atoll  will  load  a  lot  of  data  that  might  not  be
data  necessary  for  your  working  area.  If  you  load  a  large  network, 
necessary all the time, such as the neighbour relation data.

Performance and Memory Issues in Large GSM Projects

Memory problems might be experienced in the C/I coverage prediction studies, interference matrices calculations, and the
AFP while working on large GSM networks. Large network projects are more susceptible to these problems. If the network is
large but homogeneous, these problems might only appear if the number of transmitters is over 15,000 or so. But, if there a
re
large city centres involved, with each pixel having many overlapping path loss matrices, then this size limit might decrease to around 5,0

Also,  if  the Atoll  session  has  been  open  for  a  long  time,  memory  problems  can  even  appear  while  working  on  smaller
networks. This is because the process memory space (memory space allocated to  Atoll by the operating system) becomes
fragmented.
Following is a list of advice which you can follow in order to avoid such problems:
e regionalisation or site lists: If you load a large network, 
•U
s Atoll will be required to load a lot of data that might not
be necessary all of the time. For example, in a typical large GSM network, you might have around 10,000 transmitter
records, 20,000 subcell records, 50,000 TRX records, and up to 150,000 neighbour records.
e embedded interference matrices: You can store interference matrices listed in the Interference Matrices
s i l a n r e t x•E
folder in external files. Atoll loads interference matrices from the external files to the memory only when needed. You
will also reduce the ATL file size by externalising the interference matrices.
t pcalculation 
a•A
d radii  to  the  cell  type  and  the  EIRP:  Before  calculating  path  loss  matrices,  take  care  to  correctly assoc
 over a large calculation radius, it will unnecessarily burden the C/I and interference matrices computations.
s l lce
erly configure the interference thresholds: These thresholds indicate the level after which an interferer can be
po r•P
ed. The default value for this threshold (‐130 dBm), defined in the Predictions tab of the Predictions folder’s
r onig
rties dialogue, means that the computations will take into account all the interferers. However, if you set it too
epoPr high,  you  m

Min AllSubcells ( RT i – CIT i – M ) RT i – CIT i – M


subcells, i. Where, RTi is the reception threshold of the subcell i, CITi the C/I threshold of this subcell, and M is a safety
margin.
Since this interference threshold is used both in interference matrices calculation and in interference predictions, it is
important to have at least a 3‐dB margin for the interference energy aggregation in C/I studies. We recommend a
safety margin of 5 dB, which can be reduced if any problem is encountered.
•D
o not define very high C/I quality thresholds (Default values: 12 dB for BCCH and 9 dB for TCH). If you want a certain
X type to carry GPRS/EDGE traffic, you can add 1 or 2 dB to this value for that TRX type, and use the option of safety
TR
ma
rgin  in  the  AFP  module’s  Cost  tab.  The  12  dB  and  9  dB  default  values  already  include  safety  margins.  If  you
crement these values too much, it will unnecessarily load the interference matrix generation and the AFP.
in
•D
o not start an AFP session if the interference matrices report indicates problems: All the transmitters should have
terferers and very few of them (not more than 20%) should have more than 70 interferers. If there are too many or
in
o few entries in your interference matrices, the AFP plan will not be optimal.
to
f the memory‐critical task is interference matrices generation: You can generate interference matrices in a piecewise
•I
ma
nner.
is means that you can generate nation‐wide interference matrices with low resolutions based on the percentage of
Th
terfered area (to improve computation time), with a cell edge coverage probability of 50% (which means no access
in
 clutter for reading standard deviation values), and an interference threshold of ‐112 dBm. This will provide rough
to global 
terference 
in matrices  which  can  be  locally  improved.  These  interference  matrices  will  be  less  memory‐ consuming.

Then, use polygon or site list filters to focus on each important location, and calculate local interference matrices wit
h
higher resolutions and reliabilities. Make sure that the computation zone in your project completely encompasses the filtering zo

f the memory‐critical task is the AFP session: Try to make the document lighter, e.g., remove coverage prediction
•I
studies, exit and restart Atoll, and try to generate interference matrices with fewer entries.

112
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 10: Administration and Usage Recommendations

f the memory‐critical task is the traffic capture: You can use traffic load field of the Subcells table to provide traffic
•I
loads directly to the AFP, and possibly skip this step.

Performance and Memory Issues in UMTS/CDMA Simulations

n order to optimise memory usage during simulations, you can set the "Information to retain" option to "Only the
•I
Average  Simulation  and  Statistics".  With  this  option Atoll  uses  much  less  memory  because  it  only  keeps  limited
information in memory during the simulation process. Simulation results are detailed enough to be used in generating
coverage prediction studies.

Performance and Memory Issues in Co‐planning Projects

Co‐planning  with  Atoll  requires  that  both  technology  documents  be  open  in  the  same 
Atoll  window  at  the  same  time.
However,  loading,  for  example,  a  GSM  and  a  UMTS  document  can  cause  memory  saturation  especially  if  the  documents
contain large, country‐wide networks. To decrease the amount of memory used by Atoll in such cases, you can:
d vector layers in main document only. Loading vectors in the linked document is not necessary and only consumes
a o•L
more memory.
•Avoid loading 
ghbours and custom fields which are not required. This can be performed by creating views in the
i en
database. For m
 information, see 
ero "Appendix 2: Setting Up Databases for Co‐planning" on page 60.

10.15 Appendix: Memory Requirements
This part gives some aspects of memory requirements (both RAM and hard disk space) for Atoll depending on the network to
be planned.
Atoll  is  capable  of  performing  computations  in  pixel  sizes  different  from  those  of  the  raster  maps  in  a  project.  It  is
recommended to perform detailed planning with smaller pixel sizes in high density areas, and country‐wide (or region‐wide,
depending on the size) coverage predictions and other calculations using larger pixel sizes. This approach will provide overall
satisfactory results, and will considerably improve the disk space requirements, RAM allocation and calculation time.
Please note that the figures mentioned in the following sections are approximate, and though actual figures can vary, their
deviation  from  the  approximate  values  will  be  negligible.  These  approximate  values  are  computed  through 
simplified
formulas. These formulas do not consider all the input parameters, but only the input parameters that have a considerable impact on

10.15.1 Disk Space Requirements
The amount of disk space required for data varies from project to project. It depends mainly on the size of the planning area,
the  pixel  size,  and  the  number  of  cells.  In  networks  with  only  a  few  cells,  the  amount  of  disk  space  required  is 
chiefly
determined by the size of the planning area. In networks with a large number of sites, transmitters and cells, it is the number of thes

Network‐Wide Input

The file sizes for raster maps (DTM, clutter heights, clutter classes, traffic density or environments, images, etc.) does not
depend on the number of cells, but only on the size of the planning area in pixels.
The following information can provide you with an estimate of disk usage for different geographic data:
• Clutter class maps require 1 byte per pixel (2 bytes for Planet format).
•Background images require from 1 to 3 bytes per pixel.
•Traffic maps require 1 byte per pixel (2 bytes for Planet format).
•DTM or clutter height maps require 2 bytes per pixel.
• Population maps or other generic maps require from 1 to 4 bytes per pixel.
For one clutter map, one DTM map, one traffic map, and one background image, you can estimate 6 bytes per pixel of the
input area. This data can be shared between different planning alternatives of the same network.

Atoll  automatically
If  an  embedded  geographic  data  file  is  deleted  from  the  project, 
compresses the ATL file to avoid file fragmentation.

Cell‐Specific Results

For a project with a large number of cells, it is important to consider the disk space required by the propagation prediction
results of each cell. Here, the cell calculation area and the calculation resolution are important factors.

113
Atoll 3.2.1 Administrator Manual
Chapter 10: Administration and Usage Recommendations © Forsk 2014

Cell‐specific results require 2 bytes per pixel. For example, the propagation results for a sector with a calculation area of 1024
x 1024 pixels will require 2 MB disk space.
If there are different ATL files for planning the same part of the network in different ways, each ATL file will require the same
amount of disk space.
The same rule applies to extended path loss matrices as well.

If embedded path loss matrices are externalised, Atoll automatically compresses the ATL
file to avoid file fragmentation.

Network‐Wide Output

Network‐wide output (raster results) mainly depends on:
e size of the planning area
h•T
e pixel size
h•T
e number of coverage predictions
h•T
e types of coverage predictions
h•T
erage predictions can have a number of layers depending on the calculation criteria. There can be a single layer for the
vCo entire  network  or
er per transmitter, 
yla sector,  or  subcell.  The  resulting  size  depends  on  the  number  of  layers  and  the

number of colours and thresholds. Therefore,  Atoll coverage predictions can require between 1 bit and 2 bytes per pixel of
the calculation area.

• Atoll can compress the coverage prediction results when saving a ATL file to avoid file
fragmentation.
u can consider 14 bytes per pixel as a rough estimate to determine the disk space
o•Y
required for each individual ATL file.

Temporary Disk Space

Atoll requires some disk space to temporarily store intermediate results during calculations. A file is created in the system’s
temporary  directory  whose  size  depends  on  the  calculations.  This  file  is  described  in  the  section  on  RAM  requirements.
Likewise, a temporary file is created when using the "Save As" command. These files are erased after the calculations or once
the storage has finished.

Other Disk Space Requirements

Other objects in a ATL file that require disk space can easily be neglected in real‐life scenarios since the required disk space
depending on the size of the planning area and the number of transmitters is much higher.
ATL files store database tables and calculation results. An empty ATL file requires around 500 KB. Each additional site requires
between 1 and 2KB, which is negligible compared to the size of the propagation results.
Furthermore, the size of vector files is negligible compared to that of other geographic data, as their size is usually much
smaller than the DTM, clutter height, and clutter class maps.

When  saving  an  ATL  file, Atoll  estimates  the  size  of  unused  spaces  in  the  file  due  to
fragmentation.  If  the amount of  unused spaces  is  more  than  half  of  the  useful  space,
Atoll proposes compressing the file.

10.15.2 RAM Requirements
Usually,  512 MB  of  RAM  in  a  workstation  is  sufficient  for  all  operations  with Atoll,  provided  that  there  are  no  other
applications being used in parallel that consume large amounts of memory.
Starting  Atoll  without  loading  a  project  requires  around  20 MB  of  RAM  (as monitored  with  the Windows  Task  Manager).
Loading a project with 500 sites, a few predictions, and some simulations can increase the consumed memory to around 50
to 100 MB.

Monte Carlo Simulations

UMTS Monte‐Carlo simulations are calculations that consume large amounts of memory. The memory requirement of these
calculations is a function of the following:
e number of sites involved
h•T

114
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 10: Administration and Usage Recommendations

e number of transmitters involved
h•T
e number of cells involved
h•T
e number of mobiles generated by the UMTS simulation
h•T
e number of transmitters covering a pixel
h•T
e number of services simulated
h•T
e number of neighbours per cell
h•T
e "Detailed Results" and "Limit Active Set to Neighbours" flags
h•T
e number of links per mobile
h•T
e number of channel elements per site
h•T
t of these parameters have minor influences and the actual requirements are mostly governed by the number of cells and
Mo
s
 number of mobiles generated.
eth
uming that there are three carriers used and the number of transmitters and mobiles is high enough so that the other input
sAs
 be ignored, the required memory can be roughly approximated by:
nca

R = 14.0 ´ t + 3.25 ´ m for normal simulations

R = 14.0 ´ t + 4.3 ´ m using the "detailed results" option

with R: peak RAM requirement in KBytes
 t: number of transmitters affecting the computation zone
 m: number of mobiles generated by the UMTS simulation
Example: To calculate for 500 sites (or 1500 transmitters) and 2400 mobiles, around 28 MB of RAM are required for a normal
simulation and 30 MB if detailed results are to be stored as well.

e note that this is the peak requirement. Less memory will be required once the
s a e l•P
calculations are terminated.
s  approximation 
i h•T also  considers  effects  due  to  the  operating  system,  such  as memory over‐allocation due t
ost cases the actual RAM requirement will be below these calculated figures.
m   in
ore accurate estimation of the used and required memory for UMTS simulations is
m •A 
lable in the Source Traffic tab of the new simulation group dialogue. To activate
i aav
memory estimation feature, you must add an option in the Atoll.ini file. For more
  eth
rmation, see 
o fin "Estimating Required and Used Memory Size for UMTS Simulations" on page 172.

Coverage Predictions

RAM required during coverage prediction calculations (network‐wide raster result) is the same as the required additional disk
space, i.e., between 1 bit and 2 bytes per pixel of the calculation area. Apart from this, temporary memory is required for
calculations like "Coverage by transmitter" and "Coverage by signal level". For these,  Atoll temporarily allocates an average
of 4 bytes more per pixel (8 bytes, if the best server margin is not zero) of the calculation area.
Example: The Paris region has a size of around 10 x 13 km. For a calculation resolution of 25 m, this equals 5.2 million pixels.
If a coverage prediction calculates the signal strength of the UMTS pilot in less than 16 colours, it would require a memory of
4 bits per pixel, or a total of 2.6 MB. During the calculation,  Atoll would also require 4 more bytes per pixel, which equals
20.8 MB more apart from the 2.6 MB.

For  large  networks,  to  avoid  loading  the  entire  computation  zone  in  memory, Atoll
divides  the  coverage  prediction  computations  into  smaller  tiles,  and  carries  out 
the computations on them successively. This subdivision is invisible to the user.

115
Atoll 3.2.1 Administrator Manual
Chapter 10: Administration and Usage Recommendations © Forsk 2014

116
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

11 Configuration Files
Configuration files can be used to store parameter and display settings. These files are optional, not required for working with
Atoll, but are useful means for making work easier.
This chapter describes the formats of these files in detail:
• User configuration files (UTF‐8 encoded XML‐format GEO or CFG files)
A  user  configuration  file  containing  only  the  geographic  data  settings  can  be  saved  with  a  GEO  extension. 
A  user configuration  file  containing  the  geographic  data  settings  and  other  parameter  settings  can  be  saved 
with  a  CFG extension.

User configuration files must be created using  Atoll to ensure correct syntax and structure. It is possible to edit the
contents of these files in an XML editor and make changes if required (for example, to update the paths to geographic
data files). For more information on how to create and load user configuration files in Atoll, see the User Manual.
These files can store:
c data settings
i hp a r g o•G e
, focus, computation, printing, and geographic export zones
g n i r e t l i•F
p centre and zoom level
•M
a
r configurations
e d l o•F
t of coverage predictions in the Predictions folder and their settings
s i•L
c neighbour allocation parameters
i t amo t •A u
c frequency planning parameters (GSM GPRS EDGE documents)
i t amo t •A u
c scrambling code allocation parameters (UMTS HSPA and TD‐SCDMA documents)
i t amo t •A u
c PN offset allocation parameters (CDMA2000 documents)
i t amo t •A u
c OFDM resource allocation parameters (LTE, WiMAX, Wi‐Fi)
i t amo t •A u
e link parameters
v awo r c •M i
l paths to macro files
l u•F

n oand 
i t cdisplay 
e j o r•Pcoordinate  systems  are  stored  in  the  database,  not  in  user configuration files.

n settings are not stored in user configuration files.
o i t a l um i•S

For  more  information  on  the  contents  of  user  configuration  files,  see  "Contents  of  User  Configuration  Files" 
on page 118.

A user configuration file can be automatically loaded when Atoll is run if:
a. The file is identified in the command line parameter ‐Cfg "cfgfilename" (see "Atoll Command Line Parameters" on
page 24 for more information), or
b. The  file  is  named  "Atoll.cfg"  and  is  located  in  the Atoll  installation  folder.  This  file  will  be  ignored  if  a  user
configuration file is loaded through the command line parameter.
• Additional configuration files (UTF‐8 encoded XML‐format CFG files or plain text INI files)
The following parameter settings can be stored in additional configuration files with a CFG extension:
t setup configuration
n i r•P
e import/export configuration
l b a•T
e prediction report configuration
g a r e v o•C
The following parameter settings can be stored in specific INI files:
W measurement import configuration
•C
e test data import configuration
v i •D
r
For  more  information  on  the  contents  of  additional  configuration  files,  see  "Contents  of  Additional 
Configuration Files" on page 141.

• Custom predictions file (UTF‐8 encoded XML files)
This  file  (one  for  all  customised  predictions)  contains  the  list  and  parameter  settings  of  customised  coverage
predictions. By default, this file is named "Studies.xml" and is located in the Atoll installation folder.
The custom predictions file must be created using  Atoll to ensure correct syntax and structure. It is possible to edit
the  contents  of  this  file  in  an  XML  editor  and  make  changes  if  required.  For  more  information  on  working  with
customised predictions in Atoll, see the User Manual. 

117
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

For more information on the contents of the custom predictions file, see "Content of the Custom Predictions File" on
page 145.
• Predictions files calculated by Value Intervals (UTF‐8 encoded XML files)
These files (one per prediction) contain the parameter settings of the coverage predictions calculated with the display
type  (on  the General  tab  of  the Properties  dialog  box)  set  to  "Value  intervals".  By  default,  these  files  are  named
"<prediction_name>.XML" and are located in "C:\<path_to_doc>\<doc_name>.studies\{<Unique_ID>}".

11.1 Contents of User Configuration Files
The descriptions and examples provided below for each parameter set can help understand the format and function of the
user configuration files. The following details are available:
• "Geographic Data Set" on page 118
• "Map Centre and Zoom Level" on page 122
• "Zones" on page 121
• "Folder Configuration" on page 122
• "Coverage Predictions" on page 129
• "Automatic Neighbour Allocation Parameters" on page 131
• "Automatic Frequency Planning Parameters" on page 133
• "Automatic Scrambling Code Allocation Parameters" on page 134
• "Automatic PN Offset Allocation Parameters" on page 136
• "Microwave Radio Links Parameters" on page 138
• "Macros" on page 141.

11.1.1 Geographic Data Set
The following parameters are saved for various geographic data types:
: Format used to display degrees, minutes, and seconds for geographic coordinate systems
> t amr o F e e r g eD
•<
, geoclimatic parameters, vector traffic maps, and other vector layers:
no i t a l upo•P
: Name of the folder
> emaN•<
: (Different combinations of the following parameters exist in different display settings.)
>ya l ps i D •<
y type <type>, selected field <FieldSelector>, field description <FieldDesc> containing <FieldId> (same
a l p s •D
i
as  <FieldSelector>)  and  <FieldTitle>,  visibility  flag  <visible>,  and  visibility  range  between  <minZoom> 
and <maxZoom>
• <SymbolFont>  properties,  such  as:  font  name  <Name>,  font  size  <Size>,  font  colour  <Color>,  background
colour <BackColor>, and font style <Style>
•<LabelFont> properties, such as: label font name <Name>, label font size <Size>, label font colour <Color>,
label font background colour <BackColor>, and label font style <Style>
> sproperties, 
me t I•< such  as  for  each  item:  <Value>,  <Min>,  <Max>,  <Legend>,  <MainColor>, <SecondaryColor>, <LineStyle>, <LineWid

• <AddToLegend>: Add to legend option checked or not
: Data type properties, such as <Name>, <Formats>, <Type>, and <Integrable>
> e p y T•<
: Contains the file format, path, coordinate system information.
> e l i F•<
> of and <Path> to linked files, if any
t amr o F•<
• Coordinate  system  information  for  vector  format  data  including:  <CoordinateSystemName>,
<CoordinateSystemCode>, <EllipsoidCode>, <EllipsoidMajorRadius>, <EllipsoidMinorRadius>, <DatumCode>,
<DatumShiftX>, <DatumShiftY>, <DatumShiftZ>, <DatumRotationX>, <DatumRotationY>, <DatumRotationZ>,
<DatumScaleFactor>,  <ProjectionMethod>,  <ProjectionZone>,  <ProjectionLongitudeOrigin>,
<ProjectionLatitudeOrigin>,  <ProjectionFalseEasting>,  <ProjectionFalseNorthing>,  <ProjectionScaleFactor>,
<ProjectionFirstParallel>, <ProjectionSecondParallel>, and <ProjectionAngle>
• Clutter Classes:
: Name of the folder
> emaN•<
: (Different combinations of the following parameters exist in different display settings.)
>ya l ps i D •<
e type <type>, selected field <FieldSelector>, field description <FieldDesc> containing <FieldId> (same
t a l p s •D
i
as <FieldSelector>) and <FieldTitle>, transparency level <Opacity>, visibility flag <visible>, and visibility range
between <minZoom> and <maxZoom>
> sproperties, 
me t I•< such  as  for  each  item:  <Value>,  <Min>,  <Max>,  <Legend>,  <MainColor>, <SecondaryColor>, <LineStyle>, <LineWid

• <AddToLegend>: Add to legend option checked or not
• <Attributes>, such as: <records> and <fields>, which are,
: CODE, COLOR, NAME, HEIGHT, INDOOR
nom
mo•C
• Under <GSM>: STDDEV, COVERI_STDDEV, TX_DIV_GAIN, ANT_HOP_GAIN

118
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

r e<UMTS>: 
d•U
n STDDEV,  EC_IO_STDDEV,  EB_NT_DL_STDDEV,  EB_NT_UL_STDDEV,  ALPHA,  FORTHO, SM_GAIN_FACTOR, STTD

r e d•U
n <LTE>:  STDDEV,  COVERI_STDDEV,  MIMO_GAIN_FACTOR,  DIV_GAIN_OFFSET_DL,
DIV_GAIN_OFFSET_UL
r <1XRTT>: STDDEV, EC_IO_STDDEV, EB_NT_DL_STDDEV, EB_NT_UL_STDDEV, ALPHA, FORTHO
e d•U
n
r e<TD‐SCDMA>: 
d•U
n STDDEV,  EC_IO_STDDEV,  EB_NT_DL_STDDEV,  EB_NT_UL_STDDEV,  FORTHO_UL, FORTHO_DL, ANGULAR_

r e d•U
n <IEEE_802.16e>:  STDDEV,  COVERI_STDDEV,  MIMO_GAIN_FACTOR,  STTD_OFFSET_DL,
STTD_OFFSET_UL
r <Wi‐Fi>: STDDEV, COVERI_STDDEV, MIMO_GAIN_FACTOR, STTD_OFFSET_DL, STTD_OFFSET_UL
e d•U
n
• <DefaultValues>, for the fields stated above.
• Clutter Heights and Digital Terrain Models:
• <Name>: Name of the folder
: (Different combinations of the following parameters exist in different display settings.)
>ya l ps i D •<
e type <type>, selected field <FieldSelector>, field description <FieldDesc> containing <FieldId> (same
t a l p s •D
i
as <FieldSelector>) and <FieldTitle>, transparency level <opacity>, visibility flag <visible>, and visibility range
between <minZoom> and <maxZoom>
> sproperties, 
me t I•< such  as  for  each  item:  <Value>,  <Min>,  <Max>,  <Legend>,  <MainColor>, <SecondaryColor>, <LineStyle>, <Line

• <AddToLegend>: Add to legend option checked or not
: <Format> and <Path> to linked files, if any
> e l i F•<

Sample

Sample with display set to value intervals.
<?xml version="1.0" encoding="UTF-8"?>
<Atoll>
<Geodataset version="2">
<DegreeFormat>0</DegreeFormat>
<Population> // or <GeoClimaticParams> or <Vectors>
<Name>Population</Name> // or <Name>Geoclimatic Parameters</Name>
or <Name>Vectors</Name>
<Display>
<minZoom>500</minZoom>
<maxZoom>20000000</maxZoom>
<visible>Yes</visible>
<Type>ByIntervals</Type>
<FieldSelector>80000001</FieldSelector>
<FieldDesc>
<FieldId>80000001</FieldId>
<FieldTitle>Population (inhab./km²)</FieldTitle>
</FieldDesc>
<SymbolFont>
<Name>Wingdings</Name>
<Size>-120</Size>
<Color>0 0 0</Color>
<BackColor>255 255 255</BackColor>
<Style>0</Style>
</SymbolFont>
<LabelFont>

<Name>MS Shell Dlg</Name>


<Size>-83</Size>
<Color>0 0 0</Color> <BackColor>255
255 255</BackColor>
<Style>0</Style>

119
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

</LabelFont>
<Items>
<Item>
<Min>900.</Min>
<Max>1000.</Max>
<Legend>900 <=Population(Density) <1 000</Legend>
<MainColor>255 96 0</MainColor>
<SecondaryColor>255 0 0</SecondaryColor>

</Item>
</Items>
</Display>
<AddToLegend>0</AddToLegend>
<Type>

<Name>Population</Name>
<Formats>15</Formats>
<Type>800</Type>
<Integrable>1</Integrable>
</Type>
<Files/>
</Population> // or </GeoClimaticParams> or </Vectors>
<ClassifiedClutter UseOnlyDefault="0">

<Display>
<Type>ByIntervals</Type>
<FieldSelector>3</FieldSelector>
<FieldDesc>
<FieldId>3</FieldId>
<FieldTitle>Height (m)</FieldTitle>
</FieldDesc>
<Opacity>50</Opacity>
<Items>
<Item>
<Min>54.</Min>
<Max>56.</Max>
<Legend>54 <=Height (m) <56</Legend>
<MainColor>255 38 0</MainColor>
<SecondaryColor>255 38 0</SecondaryColor>
<LineStyle>5</LineStyle>
<LineWidth>10</LineWidth>
<FillStyle>1</FillStyle>

</Item>
</Items>
<minZoom>500</minZoom>
<maxZoom>20000000</maxZoom>
<visible>Yes</visible>

</Display>
<Attributes>
<fields>
<field length="1" type="uint" name="CODE"/>
<field length="4" type="int" name="COLOR"/>

120
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<field length="50" type="text" name="NAME"/>


<field length="4" type="real" name="HEIGHT"/>
<field length="2147483647" type="text" name="INDOOR"/>
</fields>
<records/>
</Attributes>
<Name>Clutter Classes</Name>
<AddToLegend>0</AddToLegend>
<DefaultValues>

</DefaultValues>
</ClassifiedClutter>
<Altitudes> // or <BuildingHeights>
<Name>Digital Terrain Model</Name> // or <Name>Clutter Heights</Name>
<Display>

<minZoom>500</minZoom>
<maxZoom>20000000</maxZoom>
<visible>Yes</visible>
<Type>ByIntervals</Type>
<FieldSelector>0</FieldSelector>
<FieldDesc>
<FieldId>0</FieldId>
<FieldTitle>Altitude</FieldTitle>
</FieldDesc>
<Opacity>50</Opacity>
<Items>
<Item>
<Min>900.</Min>
<Max>1000.</Max>
<Legend>900 <=Altitude <1 000</Legend>
<MainColor>255 96 0</MainColor>
<SecondaryColor>255 96 0</SecondaryColor>
<LineStyle>5</LineStyle>
<LineWidth>10</LineWidth>
<FillStyle>1</FillStyle>

</Item>
</Items>
</Display>
<AddToLegend>0</AddToLegend>
</Altitudes> // or </BuildingHeights>

</Geodataset>
</Atoll>

11.1.2 Zones
The user configuration files store the coordinates of the vertices of the filtering, focus, computation, printing, and geographic
export zone polygons, i.e., the points forming these polygons. The first and the last points have the same coordinates.

Sample

The following sample has rectangular computation and focus zones of the same size.

121
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<CalculationZone>
<Point>35950.000000 -15445.000000</Point>
<Point>33.000000 -15445.000000</Point>
<Point>33.000000 -33.000000</Point>
<Point>35950.000000 -33.000000</Point>
<Point>35950.000000 -15445.000000</Point>

</CalculationZone>
<FocusZone>
<Point>35950.000000 -15445.000000</Point>
<Point>33.000000 -15445.000000</Point>
<Point>33.000000 -33.000000</Point>
<Point>35950.000000 -33.000000</Point>
<Point>35950.000000 -15445.000000</Point>

</FocusZone>
<Atoll>

11.1.3 Map Centre and Zoom Level
The following parameters are saved:
• <MapPosition>: X and Y coordinates of the centre of the map window and the zoom level.

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<MapPosition CenterX="609433" CenterY="5632019" Scale="250000"/>
</Atoll>

11.1.4 Folder Configuration
The following parameters are saved for the following folders:
s folder:
e t i•S
: Name of the folder
> emaN•<
• <Display>:
e type <type>, selected field <FieldSelector>, field description <FieldDesc> containing <FieldId> (same
t a l p s •D
i
as  <FieldSelector>)  <FieldTitle>  and  <FieldDBName>,  visibility  flag  <Visible>,  and  visibility  range 
between <MinZoom> and <MaxZoom>
• <SymbolFont>  properties,  such  as  font  name  <Name>,  font  size  <Size>,  font  colour  <Color>,  background
colour <BackColor>, and font style <Style>
•<LabelFont> properties, such as label font name <Name>, label font size <Size>, label font colour <Color>, labe
l font background colour <BackColor>, and label font style <Style>
•<Items> properties, such as for each <Item>: <Value>, <Legend>, <MainColor>, <SecondaryColor>, <Symbol>,
and <SymbolSize>

: List of <items> displayed in tip texts
> s p i T a t aD •<
: List of <items> displayed in labels
> s l e b a L•<
• <AddToLegend>: Add to legend option checked or not
• <DefaultConfiguration>:  The  default  configuration  for  the  folder,  this  tag  contains  the  default 
configuration <Filter>, <Groups>, and <Sort> criteria
• <Configuration>: If any configuration exists for the folder, this tag contains the configuration <Name> and the
<Filter>, <Groups>, and <Sort> criteria
• Antennas folder:
: Name of the folder
> emaN
•<
• <DefaultConfiguration>:  The  default  configuration  for  the  folder,  this  tag  contains  the  default 
configuration <Filter>, <Groups>, and <Sort> criteria

122
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

•<Configuration>: If any configuration exists for the folder, this tag contains the configuration <Name> and the
<Filter>, <Groups>, and <Sort> criteria
•Transmitters, Multi‐Hops, and Point to Mu
lders:
o f   •t n i op i t l
<Name>: Name of the folder
• <Display>:
e type <Type>, selected field <FieldSelector>, field description <FieldDesc> containing <FieldId> (same
t a l p s •D
i
as  <FieldSelector>)  <FieldTitle>  and  <FieldDBName>,  visibility  flag  <Visible>,  and  visibility  range  between
<MinZoom> and <MaxZoom>
•<LabelFont> properties, such as label font name <Name>, label font size <Size>, label font colour <Color>, lab
el font background colour <BackColor>, and label font style <Style>
•<Items> properties, such as for each <Item>: <Value>, <Legend>, <MainColor>, <SecondaryColor>, <Symbol>,
and <SymbolSize>

: List of <items> displayed in tip texts
> s p i T a t aD •<
: List of <items> displayed in labels
> s l e b a L•<
• <AddToLegend>: Add to legend option checked or not
• <DefaultConfiguration>:  The  default  configuration  for  the  folder,  this  tag  contains  the  default 
configuration <Filter>, <Groups>, and <Sort> criteria
• <Configuration>: If any configuration exists for the folder, this tag contains the configuration <Name> and the
<Filter>, <Groups>, and <Sort> criteria
•<OFDM_AFP>: LTE, WiMAX, and Wi‐Fi frequen
tion constraint weights:
a co l l a   y c
•<Techno>: Name of the technology
• <NeighbourWeight>: Weight of the first order neighbour relation
• <InterNeighbourWeight>: Weight of the relation between two neighbours of a common cell
• <IMWeight>:Weight of the interference matrices relation
: Weight of the distance‐based relation
> t h g i eWe c n a t s i D •<
: LTE physical cell ID allocation constraint weights:
> c o l l A_ I C P•<
• <NeighbourWeight>: Weight of the first order neighbour relation
• <SecondNeighbourWeight>: Weight of the second order neighbour relation
• <InterNeighbourWeight>: Weight of the relation between two neighbours of a common cell
• <IMWeight>:Weight of the interference matrices relation
: Weight of the distance‐based relation
> t h g i eWe c n a t s i D •<
: Weight of the physical cell ID constraint
> t h g i eWD I•<
: Weight of the PSS ID constraint
> t h g i eWS S P•<
• <SSSWeight>: Weight of the same SSS ID per site constraint
: Weight of the UL DMRS (PCI Mod 30) collision constraint
> t h g i eWGS S RMD LU •<
• <DLRSSCaWeight>: Weight of the single antenna port DL CRS (PCI Mod 6) collision constraint
• <PCFICHREGWeight>: Weight of the PCFICH REG (PCI Mod (N_RB/2)) collision constraint
: WiMAX preamble index allocation constraint weights:
> c o l l A_ I P•<
• <NeighbourWeight>: Weight of the first order neighbour relation
• <SecondNeighbourWeight>: Weight of the second order neighbour relation
• <InterNeighbourWeight>: Weight of the relation between two neighbours of a common cell
• <IMWeight>:Weight of the interference matrices relation
: Weight of the distance‐based relation
> t h g i eWe c n a t s i D •<
: Weight of the preamble index constraint
> t h g i eWx e dn I•<
• <SegmentWeight>: Weight of the segment constraint
: Weight of the same cell permbase per site constraint
> t h g i eWe s a Bmr e P•<
s folder:
k n i•L
• <Name>: Name of the folder
: Contains visibility flag <visible>, and visibility range between <minZoom> and <maxZoom>
>ya l ps i D•<
• <AddToLegend>: Add to legend option checked or not
• <DefaultConfiguration>: The default configuration for the folder
•<LabelFont> properties, such as: label font name <Name>, label fon
ize>, label font colour <Color>, label
S<   e z i s   t
font background colour <BackColor>, and label font style <Style>
> properties, such as:
y a l p s i De t i S•<
• <SymbolFont>  properties,  such  as:  font  name  <Name>,  font  size  <Size>,  font  colour  <Color>,  background
colour <BackColor>, and font style <Style>
•<LabelFont> properties, such as: label font name <Name>, label font size <Size>, label font colour <Color>,
label font background colour <BackColor>, and label font style <Style>
: Symbol used for microwave links
> l obmy S•<
: Caption for microwave links shown or not
> t x e Twoh S•<
> properties, such as:
y a l p s i D r e t a e p e R•<
• <SymbolFont>  properties,  such  as:  font  name  <Name>,  font  size  <Size>,  font  colour  <Color>, 
background colour <BackColor>, and font style <Style>
W Measurements folder:
•C
• <DefaultConfiguration>: The default configuration for the folder
: The minimum <Min> and maximum <Max> distance for measurement filtering
>e c na t s i D
•<

123
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

: The distance unit
> t i nUe c n a t s i D •<
: The minimum <Min> and maximum <Max> measured level for filtering
> e r u s a eM
•<
• <MeasureUnit>: The measurement unit
: The minimum <Min> and maximum <Max> angle for measurement filtering
> e l g nA•<
: Whether the angle is relative to each transmitter’s azimuth or an absolute value
> e v i t a l e R•<
• <Clutter>: For each <Class>, its <Code> and whether it is in the <Filter> or not
: Any advanced filter used for filtering
> d e c n a v dA•<
s>: Path loss tuing parameters, i.e., <Para
e s s o L h t a P•< ius>, <PerpendicularAxisRadius>, <GlobalMargin>,
daR s i xA l e l l <LocalMargin>, and <Threshold>

• <Display>:
e ttype 
a l p<Type>, 
s •D
i selected  field  <FieldSelector>,  visibility  flag  <Visible>,  and  visibility  range  between <MinZoom> and <MaxZoom>

• <SymbolFont>  properties,  such  as:  font  name  <Name>,  font  size  <Size>,  font  colour  <Color>,  background
colour <BackColor>, and font style <Style>
•<LabelFont> properties, such as: label font name <Name>, label font size <Size>, label font colour <Color>,
label font background colour <BackColor>, and label font style <Style>
> sproperties, 
me t I•< such  as  for  each  <Item>:  <Legend>,  <MainColor>,  <SecondaryColor>,  <Symbol>,  and <SymbolSize>

: List of <items> displayed in tip texts
> s p i T a t aD •<
: List of <items> displayed in labels
> s l e b a L•<
• <AddToLegend>: Add to legend option checked or not
e Test Data folder:
v i •Dr
: Name of the technology (if exported from a 3GPP Multi‐RAT document.
> on h c e T•<
• <DefaultConfiguration>: The default configuration for the folder
• <Clutter>: For each <Class>, its <Code> and whether it is in the <Filter> or not
: Any advanced filter used for filtering
> d e c n a v dA•<
: Path loss tuing parameters, i.e., <ParallelAxisRadius>, <PerpendicularAxisRadius>, <GlobalMargin>,
> s e s s o L h t a P•<
<LocalMargin>, and <Threshold>
• <Display>:
e ttype 
a l p<Type>, 
s •D
i selected  field  <FieldSelector>,  visibility  flag  <Visible>,  and  visibility  range  between <MinZoom> and <MaxZoom>

• <SymbolFont>  properties,  such  as:  font  name  <Name>,  font  size  <Size>,  font  colour  <Color>,  background
colour <BackColor>, and font style <Style>
•<LabelFont> properties, such as: label font name <Name>, label font size <Size>, label font colour <Color>,
label font background colour <BackColor>, and label font style <Style>
> sproperties, 
me t I•< such  as  for  each  <Item>:  <Legend>,  <MainColor>,  <SecondaryColor>,  <Symbol>,  and <SymbolSize>

: List of <items> displayed in tip texts
> s p i T a t aD •<
: List of <items> displayed in labels
> s l e b a L•<
• <AddToLegend>: Add to legend option checked or not
n Models and Smart Antenna Models folders:
o i t a g a p o r•P
: Name of the folder
> emaN
•<
• <DefaultConfiguration>:  The  default  configuration  for  the  folder,  this  tag  contains  the  default 
configuration <Filter>, <Groups>, and <Sort> criteria

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<FoldersConfigurations>
<Sites>
<Name>Sites</Name>
<Display>
<minZoom>500</minZoom>
<maxZoom>20000000</maxZoom>
<visible>Yes</visible>
<Type>ByValues</Type>
<FieldSelector>8</FieldSelector>
<FieldDesc>
<FieldId>8</FieldId>
<FieldTitle>Vendor</FieldTitle>

124
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

</FieldDesc>
<SymbolFont>
<Name>Wingdings</Name>
<Size>-120</Size>
<Color>0 0 0</Color>
<BackColor>255 255 255</BackColor>
<Style>32</Style>
</SymbolFont>
<LabelFont>

<Name>MS Shell Dlg</Name>


<Size>-80</Size>
<Color>0 0 0</Color> <BackColor>255
255 255</BackColor>
<Style>33</Style>

</LabelFont>
<Items>
<Item>
<Value>Vendor</Value>
<Legend>Vendor</Legend>
<MainColor>255 0 0</MainColor>
<SecondaryColor>255 255 255</SecondaryColor>
<Symbol>164</Symbol>
<SymbolSize>120</SymbolSize>
</Item>
</Items>
<DataTips>

<Item>0</Item>
</DataTips>
<Labels>

<Item>0</Item>
</Labels>
</Display>
<AddToLegend>1</AddToLegend>
<DefaultConfiguration>
<Groups>Type</Groups>
</DefaultConfiguration>

</Sites>
<Antennas>
<Name>Antennas</Name>
<DefaultConfiguration>
<Filter>([CONSTRUCTOR]= Kathrein)</Filter>
</DefaultConfiguration>
<Configuration>
<Name>Conf</Name>
<Filter>([CONSTRUCTOR]= Kathrein)</Filter>
</Configuration>
</Antennas>
<Transmitters> // or <MWMultiHops> // or <MWHubs>

125
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

<Name>Transmitters</Name> // or <Name>Multi-Hops</Name> //
or <Name>Point to Multipoint</Name>
<Display>
<minZoom>500</minZoom>
<maxZoom>20000000</maxZoom>
<visible>Yes</visible>
<Type>ByValues</Type>
<FieldSelector>0</FieldSelector>
<FieldDesc>
<FieldId>0</FieldId>
<FieldTitle>Automatic</FieldTitle>
</FieldDesc>
<Items>
</Items>
<DataTips>
<Item>0</Item>
</DataTips>
</Display>
<AddToLegend>1</AddToLegend>
<DefaultConfiguration/>
</Transmitters> // or </MWMultiHops> // or </MWHubs>
<MWLinks>

<Name>Links</Name>
<Display>
<minZoom>500</minZoom>
<maxZoom>20000000</maxZoom>
<visible>Yes</visible>
</Display>
<AddToLegend>0</AddToLegend>
<DefaultConfiguration/>
<LabelFont>
<Name>MS Shell Dlg</Name>
<Size>-83</Size>
<Color>0 0 0</Color> <BackColor>255
255 255</BackColor>
<Style>0</Style>

</LabelFont>
<SiteDisplay>
<SymbolFont>
<Name>Wingdings</Name>
<Size>80</Size>
<Color>0 0 0</Color>
<BackColor>255 255 255</BackColor>
<Style>0</Style>
</SymbolFont>
<LabelFont>

<Name>MS Shell Dlg</Name>


<Size>-80</Size>
<Color>0 0 0</Color>

126
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<BackColor>255 255 255</BackColor>


<Style>0</Style>
</LabelFont>
</SiteDisplay>
<Symbol>65444</Symbol>
<ShowText>0</ShowText>
<RepeaterDisplay>
<SymbolFont>

<Name>Wingdings</Name>
<Size>80</Size>
<Color>0 0 0</Color>
<BackColor>255 255 255</BackColor>
<Style>0</Style>
</SymbolFont>
</RepeaterDisplay>

</MWLinks>
<CWMeasurements>
<DefaultConfiguration>
<Distance>
<Min>0.</Min>
<Max>1000.</Max>
</Distance>
<DistanceUnit>0</DistanceUnit>
<Measure>

<Min>-105.</Min>
<Max>-90.</Max>
</Measure>
<MeasureUnit>0</MeasureUnit>
<Angle>

<Min>-180.</Min>
<Max>180.</Max>
</Angle>
<Relative>Yes</Relative>
<Clutter>

<Class>
<Code>1</Code>
<Filter>Yes</Filter>
</Class>
</Clutter>
<Advanced>([DIST]&gt; 500)</Advanced>
</DefaultConfiguration>
<PathLosses>
<ParallelAxisRadius>200.</ParallelAxisRadius>
<PerpendicularAxisRadius>100.</PerpendicularAxisRadius>
<GlobalMargin>30.</GlobalMargin>
<LocalMargin>30.</LocalMargin>
<Threshold>-130.</Threshold>
</PathLosses>
<Display>

127
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

<Type>ByIntervals</Type>
<FieldSelector>Error (P-M) (dB)</FieldSelector>
<SymbolFont>
<Name>Wingdings</Name>
<Size>-120</Size>
<Color>0 0 0</Color>
<BackColor>255 255 255</BackColor>
<Style>0</Style>
</SymbolFont>
<LabelFont>

<Name>MS Shell Dlg</Name>


<Size>-83</Size>
<Color>0 0 0</Color> <BackColor>255
255 255</BackColor>
<Style>0</Style>

</LabelFont>
<Items>
<Item>
<Min>-20.</Min>
<Legend>Error (P-M) (dB) &gt;=-20</Legend>
<MainColor>255 0 0</MainColor>
<SecondaryColor>0 0 0</SecondaryColor>
<Symbol>167</Symbol>
<SymbolSize>100</SymbolSize>

</Item>
</Items>
<DataTips>

<Item>M (dBm)</Item>
</DataTips>
<Labels>
<Item>M (dBm)</Item>
</Labels>
</Display>
</CWMeasurements>
<TestMobileData>

<Techno>GSM</Techno>
<DefaultConfiguration>
<Clutter>
<Class>
<Code>1</Code>
<Filter>Yes</Filter>
</Class>
</Clutter>
<Advanced></Advanced>
</DefaultConfiguration>
<PathLosses>

<ParallelAxisRadius>200.</ParallelAxisRadius>
<PerpendicularAxisRadius>100.</PerpendicularAxisRadius>
<GlobalMargin>30.</GlobalMargin>

128
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<LocalMargin>30.</LocalMargin>
<Threshold>-130.</Threshold>
</PathLosses>
<Display>
<Type>ByIntervals</Type>
<FieldSelector>Ec_I0</FieldSelector>
<SymbolFont>
<Name>Wingdings</Name>
<Size>-120</Size>
<Color>0 0 0</Color>
<BackColor>255 255 255</BackColor>
<Style>0</Style>
</SymbolFont>
<LabelFont>

<Name>MS Shell Dlg</Name>


<Size>-83</Size>
<Color>0 0 0</Color> <BackColor>255
255 255</BackColor>
<Style>0</Style>

</LabelFont>
<Items>
<Item>
<Min>-60.</Min>
<Legend>Ec_I0 &gt;=-60</Legend>
<MainColor>255 0 0</MainColor>
<SecondaryColor>0 0 0</SecondaryColor>
<Symbol>167</Symbol>
<SymbolSize>100</SymbolSize>

</Item>
</Items>
</Display>
</TestMobileData>
<PropagationModels> // or <SmartAntennasModels>
<Name>Propagation Models</Name> // or <Name>Smart Antenna Models</Name>
<DefaultConfiguration/>

</PropagationModels> // or </SmartAntennasModels>
</FoldersConfigurations>
</Atoll>

11.1.5 Coverage Predictions
The list of coverage predictions available in the Predictions folder and the following parameters are saved:
• General tab:
: Name of the technology
> on h c e T•<
• <Name>: Name of the folder
: Prediction resolution
> no i t u l o s e R•<
• <Configuration>: <Filter>, <Groups>, and <Sort> criteria for the prediction
• <LockedStudy>: Locked or not
• Conditions tab: Depend on technologies and prediction types.
• <Reliability>: Cell edge coverage probability
• <Indoor>: Indoor coverage checked or not
: Shadowing margin taken into account or not
> g n i wod a h S h t iW•<

129
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

• ...
y tab:
a l p s •D
i
: (Different combinations of the following parameters exist in different display settings.)
>ya l ps i D •<
y type <type>, selected field <FieldSelector>, field description <FieldDesc> containing <FieldId> (same
a l p s •D
i
as <FieldSelector>) and <FieldTitle>, visibility flag <visible>, opacity <Opacity>, and visibility range between
<minZoom> and <maxZoom>
> sproperties, 
me t I•< such  as  for  each  item:  <Value>,  <Min>,  <Max>,  <Legend>,  <MainColor>, <SecondaryColor>, <LineStyle>, <LineWid

• <AddToLegend>: Add to legend option checked or not
: List of <items> displayed in tip texts
> s p i T a t aD
•<

Sample

GSM coverage by signal level

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<Studies>
<CoverageTRXStudy>
<Techno>GSM</Techno>
<Name>GSM: Coverage by Signal Level 0</Name>
<Display>
<minZoom>500</minZoom>
<maxZoom>20000000</maxZoom>
<visible>Yes</visible>
<Type>ByIntervals</Type>
<FieldSelector>80000008</FieldSelector>
<Opacity>50</Opacity>
<Items>
<Item>
<Min>-75.</Min>
<Legend>Best Signal Level (dBm) &gt;=-75</Legend>
<MainColor>255 147 0</MainColor> <SecondaryColor>0
0 0</SecondaryColor> <LineStyle>5</LineStyle>
<LineWidth>15</LineWidth> <FillStyle>1</FillStyle>

</Item>
<Item>
<Min>-85.</Min>
<Legend>Best Signal Level (dBm) &gt;=-85</Legend>
<MainColor>70 255 0</MainColor>
<SecondaryColor>0 0 0</SecondaryColor>
<LineStyle>5</LineStyle>
<LineWidth>15</LineWidth>
<FillStyle>1</FillStyle>

</Item>
<Item>
<Min>-95.</Min>
<Legend>Best Signal Level (dBm) &gt;=-95</Legend>
<MainColor>0 255 217</MainColor> <SecondaryColor>0
0 0</SecondaryColor> <LineStyle>5</LineStyle>

130
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<LineWidth>15</LineWidth>
<FillStyle>1</FillStyle>
</Item>
<Item>
<Min>-105.</Min>
<Legend>Best Signal Level (dBm) &gt;=-105</Legend>
<MainColor>0 0 255</MainColor>
<SecondaryColor>0 0 0</SecondaryColor>
<LineStyle>5</LineStyle>
<LineWidth>15</LineWidth>
<FillStyle>1</FillStyle>

</Item>
</Items>
<DataTips>

<Item>c0000000</Item>
<Item>c0000001</Item>
</DataTips>
</Display>
<AddToLegend>1</AddToLegend>
<Resolution>50</Resolution>
<GUID>{52D66F26-5710-4F4B-A327-6DAFF337AB21}</GUID>
<LockedStudy>0</LockedStudy>
<ComputeHisto>1</ComputeHisto>
<HistoPerTx>0</HistoPerTx> <HistoLabel></HistoLabel>

<Conditions>
<FieldDbm>
<Min>-105.</Min>
</FieldDbm>
<Reliability>0.75</Reliability>
<TRXType>BCCH</TRXType>
<DefTrgThreshold>1</DefTrgThreshold>
<Indoor>0</Indoor>
<WithShadowing>0</WithShadowing>

</Conditions>
</CoverageTRXStudy>
</Studies>
</Atoll>

11.1.6 Automatic Neighbour Allocation Parameters
The  following  parameters  are  saved  for  intra‐technology  (intra‐carrier  and  inter‐carrier)  and  inter‐technology 
automatic neighbour allocations:
• <ANP_options>: Intra‐technology (intra‐carrier) neighbour allocation parameters
• <ANP_IL_options>:  Intra‐technology  inter‐carrier  neighbour  allocation  parameters  (UMTS  HSPA  and 
CDMA2000 documents)
• <ANP_IT_options>: Inter‐technology neighbour allocation parameters
A <Techno></Techno> tag is also present if the user configuration is exported from a 3GPP Multi‐RAT document. This
tag contains the name of the technology to which the parameters belong.

131
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

The following parameters are saved:
• Parameters common to all technologies:
: Maximum number of neighbours to allocate
> x aMmu n•<
• <useCoSite>: Force co‐site transmitters/cells as neighbours or not
• <useAdjacent>: Force adjacent transmitters/cells as neighbours or not
•<symetric>: Force symmetry between neighbours or not
•<keepNeighbs>: Reset existing neighbours or keep them
•<MaxDist>: Maximum distance between sites
• <PercentCoverage>: Coverage conditions: Minimum percentage of covered area
• <UseShadowing>: Coverage conditions: Take shadowing into account or not
• <reliability>: Coverage conditions: Cell edge coverage probability
• <applyConstraints>: Force exceptional pairs as neighbours or not
: Not implemented yet
> d e s a B v o c•<
: Neighbour importance: minimum factor for coverage
> v oC n i m
•<
: Neighbour importance: maximum factor for coverage
> v oC x am•<
: Neighbour importance: minimum factor for adjacency
> j dAn i m •<
: Neighbour importance: maximum factor for adjacency
> j dA x am•<
: Neighbour importance: minimum factor for co‐site
> s oC n i m•<
: Neighbour importance: maximum factor for co‐site
> s oC x am•<

• <minDistImportance>: Neighbour importance: minimum factor for distance
• <maxDistImportance>: Neighbour importance: maximum factor for distance
•<resolution>: Resolution used for coverage calculation for overlapping (
e default resolution defined in
h t   s n a em   1 ‐
the properties of the Predictions folder is used)
• <UseIndoor>: Coverage conditions: Use indoor losses defined per clutter class or not
• <UseGlobalThreshold>: Coverage conditions for WiMAX and LTE: Whether to use a global minimum preamble C/
N or RSRP, or per‐cell values
• Parameters specific to GSM GPRS EDGE:
• <minField>: Coverage conditions: Minimum BCCH signal level
: Coverage conditions: Margin for the minimum signal level (Handover start)
> n i g r am
•<
: Coverage conditions: Take traffic into account or not
> c i f f a r t•<
: Coverage conditions: Handover end
> x aMa t l e d•<
• Parameters specific to UMTS HSPA, TD‐SCDMA, and CDMA2000 1xRTT 1xEV‐DO:
• <minField>: Coverage conditions: Minimum pilot signal level
: Coverage conditions: Margin for the minimum signal level (E
> n i g r am•< /I  margin) c 0
: Coverage conditions: Take traffic into account or not
> c i f f a r t•<
: Coverage conditions: Handover end
> x aMa t l e d•<
• <EcIoMin>: Coverage conditions: Minimum Ec/I 0
: Coverage conditions: Use maximum power or not
> x amP e s u•<
• <PerCentMaxPower>: Coverage conditions: Percentage of maximum power to consider in calculations
• <EcIoMax>: Coverage conditions: Maximum Ec/I 0
: Coverage conditions: Use maximum E
> x aMo I c E e s u•< /I  or not c 0
: TDrop value (TD‐SCDMA documents, intra‐technology neighbour allocation only)
> po r DT•<
• Parameters specific to WiMAX 802.16e and LTE:
: The handover start margin (intra‐technology neighbour allocation only)
> t r a t SOH•<
• <HOEnd>: The handover end margin (intra‐technology neighbour allocation only)
: RSRP margin from the best server (inter‐technology neighbour allocation only)
> n i g r amS B•<

Sample

UMTS HSPA inter‐technology, intra‐carrier neighbour allocation parameters:

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<ANP_options>
<Techno>UMTS</Techno>
<numMax>16</numMax>
<resolution>-1</resolution>
<minField>-10500</minField>
<margin>500</margin>
<useCoSite>1</useCoSite>
<useAdjacent>1</useAdjacent>

132
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<traffic>0</traffic>
<symetric>0</symetric>
<keepNeighbs>0</keepNeighbs>
<MaxDist>10000</MaxDist>
<PercentCoverage>1000</PercentCoverage>
<UseShadowing>0</UseShadowing>
<reliability>7500</reliability>
<UseIndoor>0</UseIndoor>
<deltaMax>1200</deltaMax>
<applyConstraints>0</applyConstraints>
<covBased>1</covBased>
<minDistImportance>100</minDistImportance>
<maxDistImportance>1000</maxDistImportance>
<minCov>1000</minCov>
<maxCov>3000</maxCov>
<minAdj>3000</minAdj>
<maxAdj>6000</maxAdj>
<minCos>6000</minCos>
<maxCos>10000</maxCos>
<UseGlobalThreshold>0</UseGlobalThreshold>
<EcIoMin>-1400</EcIoMin>
<usePmax>0</usePmax>
<PerCentMaxPower>5000</PerCentMaxPower>
<EcIoMax>-700</EcIoMax>
<useEcIoMax>0</useEcIoMax>
</ANP_options>
</Atoll>

11.1.7 Automatic Frequency Planning Parameters
The following parameters are saved for automatic frequency planning (GSM GPRS EDGE documents):
• <defSeparations__CONF_CO_SITE_BB>: Default co‐site separation rule for two BCCH type TRXs.
• <defSeparations__CONF_CO_CELL_BB>: Default co‐transmitter separation rule for two BCCH type TRXs.
• <defSeparations__CONF_NEIGH_BOUR_BB>: Default neighbour separation rule for two BCCH type TRXs.
• <defSeparations__CONF_CO_SITE_BT>: Default co‐site separation rule for a BCCH and a TCH type TRX.
• <defSeparations__CONF_CO_CELL_BT>: Default co‐transmitter separation rule for a BCCH and a TCH type TRX.
• <defSeparations__CONF_NEIGH_BOUR_BT>: Default neighbour separation rule a for BCCH and a TCH type TRX.
• <defSeparations__CONF_CO_SITE_TT>: Default co‐site separation rule for two TCH type TRXs.
• <defSeparations__CONF_CO_CELL_TT>: Default co‐transmitter separation rule for two TCH type TRXs.
• <defSeparations__CONF_NEIGH_BOUR_TT>: Default neighbour separation rule for two TCH type TRXs.
: Last minute resource freezing options available in the AFP launch wizard
> e t a t S e z e e r f•<
• <numMinutes>: Target time alloted to the AFP
•<useDTX>: Consider the effect of discontinuous
ission or not
ms n a r t   •
<dtxVocalFactor>: Voice activity factor for discontinuous transmission
• <AfpBasedOnInterference>: Load all potential interferers or not
• <AfpBasedOnSeparations>: Load all the subcells potentially involved in separation constraints or not
• <IM_calculate__WithTraffic>: Whether traffic spreading is uniform or based on the maps used in the default traffic
capture (for interference matrices calculation)
tServerZoneMargin>: Margin in case of Best signal level per HCS layer (for interference matrices
s e B _ _ e t a l u c l a c _MI•<
calculation)
• <IM_calculate__ServiceZoneType>: All or Best signal level per HCS layer (for interference matrices calculation)
• <IM_calculate__reliability_X_10000>: Cell edge coverage probability (for interference matrices calculation)
• <TakeTfFromCapt>: Whether traffic loads are read from the default traffic capture or from the Subcells table
• <preferedSenario>: Scenario type, i.e., modification of existing TRXs allowed or not

133
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<AFP_options>
<defSeparations__CONF_CO_SITE_BB>2</defSeparations__CONF_CO_SITE_BB>
<defSeparations__CONF_CO_CELL_BB>3</defSeparations__CONF_CO_CELL_BB>
<defSeparations__CONF_NEIGH_BOUR_BB>2</defSeparations__CONF_NEIGH_BOUR_BB>
<defSeparations__CONF_CO_SITE_BT>2</defSeparations__CONF_CO_SITE_BT>
<defSeparations__CONF_CO_CELL_BT>3</defSeparations__CONF_CO_CELL_BT>
<defSeparations__CONF_NEIGH_BOUR_BT>1</defSeparations__CONF_NEIGH_BOUR_BT>
<defSeparations__CONF_CO_SITE_TT>1</defSeparations__CONF_CO_SITE_TT>
<defSeparations__CONF_CO_CELL_TT>2</defSeparations__CONF_CO_CELL_TT>
<defSeparations__CONF_NEIGH_BOUR_TT>1</defSeparations__CONF_NEIGH_BOUR_TT>
<freezeState>0</freezeState>
<numMinutes>1000</numMinutes>
<useDTX>0</useDTX>
<dtxVocalFactor>70</dtxVocalFactor>
<AfpBasedOnInterference>1</AfpBasedOnInterference>
<AfpBasedOnSeparations>1</AfpBasedOnSeparations>
<IM_calculate__WithTraffic>0</IM_calculate__WithTraffic>
<IM_calculate__BestServerZoneMargin>5</IM_calculate__BestServerZoneMargin>
<IM_calculate__ServiceZoneType>1</IM_calculate__ServiceZoneType>
<IM_calculate__reliability_X_10000>7500</IM_calculate__reliability_X_10000>
<TakeTfFromCapt>1</TakeTfFromCapt>
<preferedSenario></preferedSenario>
</AFP_options>
</Atoll>

11.1.8 Automatic Scrambling Code Allocation Parameters
The following parameters are saved for automatic scrambling code allocation (UMTS HSPA and TD‐SCDMA documents):
: Minimum E
> 0 I c E n iM •<
/I  constraint (not used in TD‐SCDMA)
c 0
: E> n/I i margin (not used in TD‐SCDMA)
g r am
•< c 0
• <reliability>: Cell edge coverage probability (not used in TD‐SCDMA)
: Default re‐use distance
> n iMe c n a t s i D •<
: Clustered strategy available or not
> 0 y g e t a r t S•<
: Distributed per Cell strategy available or not
> 1 y g e t a r t S•<
: One Cluster/SYNC_DL Code per Site strategy available or not
> 2 y g e t a r t S•<
: Distributed per Site strategy available or not
> 3 y g e t a r t S•<
: Scrambling code allocation strategy
> y g e t a r t S•<
• <FromScratch>: Reset all already allocated codes or not
• <UseCurrentNghbs>: Use existing first‐order neighbours or not
: The order of neigbours to take into account, i.e., 1st, 2nd, or 3rd
> r e d r Ob h gN •<
• <ComputeNghbs>: Calculate neighbours using the addition Ec/I 0 conditions or not
: Use a maximum of codes or not
> s e doC x aMe s U •<
• <UseShadowing>: Shadowing taken into account or not (not used in TD‐SCDMA)
• <SameCodeForCarriers>: Allocate carriers identically or not
•<NbClusterPerSite>: Number of transmitters per site among whi
ld be distributed
uoh s   r e t s u•l c   a   h c
<ClustNghbs>: Additional constraint of taking into account the first‐order neighbours in other clusters
• <Clust2ndNghbs>: Additional constraint of taking into account the second‐order neighbours in other clusters
• <NbCodesPerCluster>: The number of scrambling codes in one cluster/SYNC_DL
: Take the minimum reuse distance into account or not
> e c n a t s i De s U •<
• <UseExcepPairs>: Take exceptional pairs into account or not
• <minField>: Minimum pilot signal level constraint (not used in TD‐SCDMA)
: Use the maximum downlink transmission power or not (not used in TD‐SCDMA)
> x amP e s u•<

134
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

• <PerCentMaxPower>:  The  percentage of  the  maximum downlink  power  is <usePmax> is  set to 0 (not used 


in TD‐ SCDMA)
• <Max1stNghbCost>: The maximum cost of 1st order neighbours
• <Max2ndNghbCost>: The maximum cost of 2nd order neighbours
•<Max3rdNghbCost>: The maximum cost of 3rd order neighbours
•<CoplanCost>: The cost for inter‐technology neighbours
• <MaxCoClusterCost>: The maximum cost for same‐cluster/SYNC_DL neighbours
• <MaxDistCost>: The maximum cost for a minimum reuse distance constraint violation
• <ExcepPairCost>: The cost for exceptional pair constraint violation
• <UseIndoor>: Coverage conditions: Use indoor losses defined per clutter class or not
• <UseCloseNghbs>: Take the Close Neighbours constraint into account or not (TD‐SCDMA only)
• <CloseDistance>: Maximum distance within which close neighbours are located (TD‐SCDMA only)
• <CloseImportance>: Minimum importance value of close neighbour (TD‐SCDMA only)
• <MaxCloseCost>: Maximum cost of a close neighbour relation (TD‐SCDMA only)

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<SCP_options>
<MinEcI0>-1500.</MinEcI0>
<margin>500.</margin>
<reliability>5000.</reliability>
<DistanceMin>200000.</DistanceMin>
<Strategy0>1</Strategy0>
<Strategy1>1</Strategy1>
<Strategy2>1</Strategy2>
<Strategy3>1</Strategy3>
<Strategy>0</Strategy>
<FromScratch>1</FromScratch>
<UseCurrentNghbs>1</UseCurrentNghbs>
<NghbOrder>1</NghbOrder>
<ComputeNghbs>0</ComputeNghbs>
<UseMaxCodes>1</UseMaxCodes>
<UseShadowing>1</UseShadowing>
<SameCodeForCarriers>0</SameCodeForCarriers>
<NbClusterPerSite>3</NbClusterPerSite>
<ClustNghbs>0</ClustNghbs>
<Clust2ndNghbs>0</Clust2ndNghbs>
<NbCodesPerCluster>8</NbCodesPerCluster>
<UseDistance>1</UseDistance>
<UseExcepPairs>1</UseExcepPairs>
<minField>-10500</minField>
<usePmax>0</usePmax>
<PerCentMaxPower>5000</PerCentMaxPower>
<Max1stNghbCost>100</Max1stNghbCost>
<Max2ndNghbCost>50</Max2ndNghbCost>
<Max3rdNghbCost>5</Max3rdNghbCost>
<CoplanCost>100</CoplanCost>
<MaxCoClusterCost>50</MaxCoClusterCost>
<MaxDistCost>100</MaxDistCost>
<ExcepPairCost>100</ExcepPairCost>
<UseIndoor>0</UseIndoor>

135
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

<UseCloseNghbs>1</UseCloseNghbs>
<CloseDistance>80000.</CloseDistance>
<CloseImportance>3000.</CloseImportance>
<MaxCloseCost>100</MaxCloseCost>
</SCP_options>
</Atoll>

11.1.9 Automatic PN Offset Allocation Parameters
The following parameters are saved for automatic PN offset allocation (CDMA2000 documents):
: Minimum E
> 0 I c E n iM•<
/I  constraint c 0
: Value for the TDrop
> po r DT•<
• <reliability>: Cell edge coverage probability
: Default re‐use distance
> n iMe c n a t s i D •<
: PN Offset per Cell strategy available or not
> 0 y g e t a r t S•<
: Adjacent PN‐Cluster per Site strategy available
> 1 y g e t a r t S•< Strategy2>: Distributed PN‐Cluster per Site strategy availa
< • t on   r o   t on   r o   e l b
 PN offset allocation strategy
: > y g e t a r t S•<

• <FromScratch>: Reset all already allocated codes or not
• <UseCurrentNghbs>: Use existing neighbours or not
•<NghbOrder>: The order of neigbours to take into ac
., 1st, 2nd, or 3rd
e . i   , t n uo c•
<ComputeNghbs>: Calculate neighbours using the addition Ec/I 0 conditions or not
• <UseShadowing>: Shadowing taken into account or not
• <SameCodeForCarriers>: Allocate same PN offset to cells of the same transmitter or not
: Value for the PILOT_INC
> r c n I t o l i P•<
: Number of PN offsets per cluster
> e z i S r e t s u l CNP•<
: Take the minimum reuse distance into account or not
> e c n a t s i De s U
•<
• <UseExcepPairs>: Take exceptional pairs into account or not
: Use a maximum of codes or not
> s e doC x aMe s U
•<
• <minField>: Minimum pilot signal level constraint
•<usePmax>: Use the maximum downlink transmission po
otn•  r o   r ew
<PerCentMaxPower>: The percentage of the maximum downlink power is <usePmax> is set to 0
• <Max1stNghbCost>: The maximum cost of 1st order neighbours
: The maximum cost of 2nd order neighbours
> t s oCb h gNdn 2 x aM •<
• <Max3rdNghbCost>: The maximum cost of 3rd order neighbours
• <CoplanCost>: The cost for inter‐technology neighbours
• <MaxDistCost>: The maximum cost for a minimum reuse distance constraint violation
: The cost for exceptional pair constraint violation
> t s oC r i a P p e c x E•<
• <UseIndoor>: Coverage conditions: Use indoor losses defined per clutter class or not

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<PNO_options>
<DistanceMin>200000.</DistanceMin>
<Strategy0>1</Strategy0>
<Strategy1>1</Strategy1>
<Strategy2>1</Strategy2>
<Strategy>2</Strategy>
<FromScratch>1</FromScratch>
<UseCurrentNghbs>1</UseCurrentNghbs>
<NghbOrder>1</NghbOrder>
<ComputeNghbs>1</ComputeNghbs>
<SameCodeForCarriers>0</SameCodeForCarriers>
<PilotIncr>4</PilotIncr>
<PNClusterSize>3</PNClusterSize>

136
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<UseDistance>1</UseDistance>
<UseExcepPairs>1</UseExcepPairs>
<UseMaxCodes>1</UseMaxCodes>
<MinEcI0>-1600.</MinEcI0>
<TDrop>-1800.</TDrop>
<reliability>6000.</reliability>
<UseShadowing>0</UseShadowing>
<minField>-10500</minField>
<usePmax>0</usePmax>
<PerCentMaxPower>5000</PerCentMaxPower>
<Max1stNghbCost>100</Max1stNghbCost>
<Max2ndNghbCost>50</Max2ndNghbCost>
<Max3rdNghbCost>5</Max3rdNghbCost>
<CoplanCost>100</CoplanCost>
<MaxDistCost>100</MaxDistCost>
<ExcepPairCost>100</ExcepPairCost>
<UseIndoor>0</UseIndoor>
</PNO_options>
</Atoll>

11.1.10 Automatic OFDM Resource Allocation Parameters
The following parameters are saved for automatic allocation of resources in OFDM networks:
• <UseNeighbs>: Neighbours taken into account or not
• <UseDistance>: Distance taken into account or not
• <UseIM>: Interference matrices taken into account or not
• <BasedOnFrqPlan>: Frequency plan taken into account or not
: Allocate the same segment to co‐transmitter cells or not
> x T r e P g e S ema S•<
• <MinDistance>: Minimum global reuse distance
• <SiteStrategy>: Per‐site or free allocation for SSS ID (LTE) and cell permbase (WiMAX)
• <UniformIDDistribution>: Uniform physical cell ID or preamble index distribution active or not
• <RangeType>: Physical cell ID, preamble index, or zone permbase allocation domain (restricted = 0, entire = 1, custom
= 2, or per‐cell = 3)
• <ExcludedPis>: List of excluded physical cell IDs, preamble indexes, or zone permbases for custom allocation domain
type
Automatically allocated resources in OFDM networks include:
: Frequency and physical cell ID allocation parameters
E T•L
: Frequency, preamble index, and zone permbase allocation parameters
XAM•W i
•W
i‐Fi: Frequency allocation parameters

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<OFDM_AFP_options>
<UseNeighbs>1</UseNeighbs>
<UseDistance>1</UseDistance>
<UseIM>1</UseIM>
<BasedOnFrqPlan>1</BasedOnFrqPlan>
<SameSegPerTx>0</SameSegPerTx>
<MinDistance>100.</MinDistance>
<SiteStrategy>1</SiteStrategy>
<UniformIDDistribution>1</UniformIDDistribution>

137
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

<RangeType>2</RangeType>
<ExcludedPis></ExcludedPis>
</OFDM_AFP_options>
</Atoll>

11.1.11 Microwave Radio Links Parameters
The following parameters are saved for microwave radio links:
: Quality model used for calculations
> l e doMy t i l a uQ •<
, <QualityObjective1>, <QualityObjective2>, <QualityObjective3>: Quality objectives
> 0 e v i t c e j bOy t i l a uQ •<
• <AvailabilityObjective0>,  <AvailabilityObjective1>,  <AvailabilityObjective2>,  <AvailabilityObjective3>:  Availability
objectives
• <RainModel>: Rain model used
: Residual BER
> R E BR•<
: Value of alpha 1
> 1A F L A•<
: Value of alpha 2
> 2A F L A•<
: Reference delay for minimum phase
>My a l eD f e R•<
: Reference delay for non‐minimum phase
>MNy a l eD f e r•<
• <EquipPercent>: Availability objectives ratio for equipment
: Availability objectives ratio for rain
> t n e c r e P n i a R•<
: Average value of k
> y oMk•<
: Minimum value of k
> n iMk•< : Use automatic power control or not
> c p t Ae s U
•<
hod>: Multi‐path occure
t eM0 P•< odh •<IgnoreXPD>: Ignore cross‐polar dis
t em   e c n oni •<IgnorePR>: Ignore passive r
t a n imi r c s r e t a epe

: BER to calculate
> R E Bh c i: Value of BER 1
h>W
•<
1R E B•<: Value of BER 2
> 2 R E B•<

• <Rec838>: Rain model recommendations version
•<UseK1Global>: Use the global value for k1
•<UseK2Global>: Use the global value for k2
• <CALC_LINK_PORTS>: Calculate for given link ports
• <MultilineShared>: Shared multi‐channel frequency diversity
• <NoAcm>: Signal enhancements
• <InterferenceDistanceMax>: Maximum distance for interference filtering
• <InterferenceDropMin>: Local min threshold degradation
• <InterferenceDropMinGlobal>: Global min threshold degradation
•<InterferenceCalcGo>: Interference calculation in the direction
e B
t •<InterferenceCalcReturn>: Interference calculation in the direc
i s   o t   A   e t i s   mo r f   ite B to site A
s   mo r f   no i t
•<InterferenceCalcUplink>: Interference calculation in the uplink

rence calculation in the downlink
l nwoD c lnSurfCorrelation>: Interference correlation surface area
aiCaeRcencenreer fe rf er tent I•<
n I•< •

<InterferenceAutoWeight>: Automatic interference weighting
• <InterferenceUseAtpc>: Power control for interference calculation
• <InterferenceWidth>: Interfered wanted bandwidth
• <InterferenceOverShoot>: Interference over shoot calculation
: Interfered bandwidth co‐channel only
> y l nO l e nn a h c oC•<
• <IgnoreIntraLinkInterference>: Ignore interference between channels of the same link
: Interfering profile calculation step
> no i t u l o s e R•<
• <INTERF_DETAIL>: Calculation details (none, uplink, downlink, both)
> through <ClutterCategory36>: Bitsets for clutter category properties
0 y r o g e t a C r e t t u l C•<
• <ClutterDryCategory0> through <ClutterDryCategory36>: Soil type

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<Microwave>
<QualityModel>6</QualityModel>
<QualityObjective0>3</QualityObjective0>
<QualityObjective1>4</QualityObjective1>

138
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<QualityObjective2>2</QualityObjective2>
<QualityObjective3>1</QualityObjective3>
<AvailabilityObjective0>3</AvailabilityObjective0>
<AvailabilityObjective1>2</AvailabilityObjective1>
<AvailabilityObjective2>1</AvailabilityObjective2>
<RainModel>5</RainModel>
<RBER>1.e-012</RBER>
<ALFA1>10</ALFA1>
<ALFA2>1</ALFA2>
<RefDelayM>6.30000019</RefDelayM>
<refDelayNM>6.30000019</refDelayNM>
<EquipPercent>33.</EquipPercent>
<RainPercent>33.</RainPercent>
<kMoy>1.33</kMoy>
<kMin>0.88</kMin>
<UseAtpc>0</UseAtpc>
<P0Method>1</P0Method>
<IgnoreXPD>1</IgnoreXPD>
<IgnorePR>0</IgnorePR>
<WhichBER>5</WhichBER>
<BER1>1.e-003</BER1>
<BER2>1.e-006</BER2>
<Rec838>1</Rec838>
<UseK1Global>1</UseK1Global>
<UseK2Global>1</UseK2Global>
<CALC_LINK_PORTS>selected</CALC_LINK_PORTS>
<MultilineShared>0</MultilineShared>
<NoAcm>1</NoAcm>
<InterferenceDistanceMax>50000.</InterferenceDistanceMax>
<InterferenceDropMin>1.</InterferenceDropMin>
<InterferenceDropMinGlobal>3.</InterferenceDropMinGlobal>
<InterferenceCalcGo>1</InterferenceCalcGo>
<InterferenceCalcReturn>1</InterferenceCalcReturn>
<InterferenceCalcUplink>0</InterferenceCalcUplink>
<InterferenceCalcDownlink>0</InterferenceCalcDownlink>
<InterferenceRainSurfCorrelation>100.</InterferenceRainSurfCorrelation>
<InterferenceAutoWeight>0</InterferenceAutoWeight>
<InterferenceUseAtpc>0</InterferenceUseAtpc>
<InterferenceWidth>250</InterferenceWidth>
<InterferenceOverShoot>0</InterferenceOverShoot>
<CochannelOnly>0</CochannelOnly>
<IgnoreIntraLinkInterference>1</IgnoreIntraLinkInterference>
<Resolution>50</Resolution>
<INTERF_DETAIL>both</INTERF_DETAIL>
<ClutterCategory0>0</ClutterCategory0>
<ClutterDryCategory0>B</ClutterDryCategory0>
<ClutterCategory1>1</ClutterCategory1>
<ClutterDryCategory1>B</ClutterDryCategory1>
<ClutterCategory2>1</ClutterCategory2>

139
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

<ClutterDryCategory2>B</ClutterDryCategory2>
<ClutterCategory3>1</ClutterCategory3>
<ClutterDryCategory3>B</ClutterDryCategory3>
<ClutterCategory4>0</ClutterCategory4>
<ClutterDryCategory4>B</ClutterDryCategory4>
<ClutterCategory5>1</ClutterCategory5>
<ClutterDryCategory5>B</ClutterDryCategory5>
<ClutterCategory6>2</ClutterCategory6>
<ClutterDryCategory6>B</ClutterDryCategory6>
<ClutterCategory7>2</ClutterCategory7>
<ClutterDryCategory7>B</ClutterDryCategory7>
<ClutterCategory8>2</ClutterCategory8>
<ClutterDryCategory8>B</ClutterDryCategory8>
<ClutterCategory9>4</ClutterCategory9>
<ClutterDryCategory9>B</ClutterDryCategory9>
<ClutterCategory10>2</ClutterCategory10>
<ClutterDryCategory10>B</ClutterDryCategory10>
<ClutterCategory11>2</ClutterCategory11>
<ClutterDryCategory11>B</ClutterDryCategory11>
<ClutterCategory12>2</ClutterCategory12>
<ClutterDryCategory12>B</ClutterDryCategory12>
<ClutterCategory13>2</ClutterCategory13>
<ClutterDryCategory13>B</ClutterDryCategory13>
<ClutterCategory14>2</ClutterCategory14>
<ClutterDryCategory14>B</ClutterDryCategory14>
<ClutterCategory15>1</ClutterCategory15>
<ClutterDryCategory15>E</ClutterDryCategory15>
<ClutterCategory16>1</ClutterCategory16>
<ClutterDryCategory16>E</ClutterDryCategory16>
<ClutterCategory17>0</ClutterCategory17>
<ClutterDryCategory17>E</ClutterDryCategory17>
<ClutterCategory18>1</ClutterCategory18>
<ClutterDryCategory18>E</ClutterDryCategory18>
<ClutterCategory19>1</ClutterCategory19>
<ClutterDryCategory19>E</ClutterDryCategory19>
<ClutterCategory20>1</ClutterCategory20>
<ClutterDryCategory20>E</ClutterDryCategory20>
<ClutterCategory21>1</ClutterCategory21>
<ClutterDryCategory21>E</ClutterDryCategory21>
<ClutterCategory22>1</ClutterCategory22>
<ClutterDryCategory22>E</ClutterDryCategory22>
<ClutterCategory23>1</ClutterCategory23>
<ClutterDryCategory23>E</ClutterDryCategory23>
<ClutterCategory24>1</ClutterCategory24>
<ClutterDryCategory24>E</ClutterDryCategory24>
<ClutterCategory25>1</ClutterCategory25>
<ClutterDryCategory25>E</ClutterDryCategory25>
<ClutterCategory26>1</ClutterCategory26>
<ClutterDryCategory26>A</ClutterDryCategory26>

140
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<ClutterCategory27>1</ClutterCategory27>
<ClutterDryCategory27>A</ClutterDryCategory27>
<ClutterCategory28>1</ClutterCategory28>
<ClutterDryCategory28>A</ClutterDryCategory28>
<ClutterCategory29>1</ClutterCategory29>
<ClutterDryCategory29>A</ClutterDryCategory29>
<ClutterCategory30>1</ClutterCategory30>
<ClutterDryCategory30>A</ClutterDryCategory30>
<ClutterCategory31>1</ClutterCategory31>
<ClutterDryCategory31>E</ClutterDryCategory31>
<ClutterCategory32>1</ClutterCategory32>
<ClutterDryCategory32>E</ClutterDryCategory32>
<ClutterCategory33>1</ClutterCategory33>
<ClutterDryCategory33>E</ClutterDryCategory33>
<ClutterCategory34>1</ClutterCategory34>
<ClutterDryCategory34>E</ClutterDryCategory34>
<ClutterCategory35>1</ClutterCategory35>
<ClutterDryCategory35>E</ClutterDryCategory35>
<ClutterCategory36>1</ClutterCategory36>
<ClutterDryCategory36>E</ClutterDryCategory36>
</Microwave>
</Atoll>

11.1.12 Macros
The following parameters are saved for macros:
•    <Path>: Full path to the macro file
•    <Language>: Language in which the macro is written
•    <Timeout>: The target time allocated to macro execution

Sample

<?xml version="1.0" encoding="UTF-8"?>


<Atoll>
<Macros>
<File>
<Path>C:\TestsAddin\testEvents.vbs</Path>
<Language>VBScript</Language>
<Timeout>3600</Timeout>
</File>
</Macros>
</Atoll>

11.2 Contents of Additional Configuration Files
Complete descriptions of the different additional configuration files are provided below.

11.2.1 Print Setup Configuration
The following parameters are saved for print setup:
e tab <Page>:
g a•P

141
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

r size and orientation <Paper size="" orientation=""/>, margins <Margins right="" left="" bottom="" top="">,
e p a•P
scaling with the fit to page option <Scale fitToPage="">
• Components tab:
s and area inside focus zone only <Map>: <Map insideFZonly="" rulers=""/>
r e l u•R
• Legend <Legend>: Legend flag, outer and inner position, and inside map flag <LegendPos enable="" majorPos=""
minorPos="" insideMap=""/>
s  t<Comments>: 
n em
mo•C Comments  flag,  vertical  and  horizontal  position,  and  the  inside  map  flag  <Position vPos=""  enable=""  hPos="

r tab:
e t oo F / r e d a •H
e
r elogo 
d a •H
e <Logo>:  Logo  flag,  vertical  and  horizontal  position,  and  the  inside  map  flag  <Position  vPos="" enable=""  hPos=""  ins

r etitle 
d a •H
e <Title>:  Header  flag,  vertical  and  horizontal  position,  and  the  inside  map  flag  <Position  vPos="" enable="" hPos="" in
 logo <LogoBottom>: Logo flag, vertical and horizontal position, and the inside map flag <Position vPos=""
r e t oFo


enable=""  hPos=""  insideMap=""/>,  logo  image  <bitmap>,  and  logo  width  and  height  in  pixels 
<Dimensions width="" height=""/>
• Footer  text  <Footer>:  Footer  flag,  vertical  and  horizontal  position,  and  the  inside  map  flag  <Position 
vPos="" enable=""  hPos=""  insideMap=""/>,  footer  text  <text>,  and  font  details  <font  height=""  weight="" 
charset="" face="" italic=""/>

Sample

<?xml version="1.0" encoding="UTF-8"?>


<PrintConfiguration version="1">
<Page>

<Paper size="" orientation="1"/>


<Margins right="2000" left="2000" bottom="2000" top="2000"/>
<Scale fitToPage="1">12 495</Scale>
</Page>
<Map insideFZonly="1" rulers="1"/>
<Legend>
<LegendPos enable="0" majorPos="3" minorPos="0" insideMap="0"/>
</Legend>
<Comments>
<Position vPos="1" enable="0" hPos="1" insideMap="0"/>
<text></text>
<font height="14" weight="400" charset="1" face="MS Shell Dlg" italic="0"/>
</Comments>
<Logo>
<Position vPos="0" enable="1" hPos="0" insideMap="0"/>
<bitmap></bitmap>
<Dimensions width="46" height="18"/>
</Logo>
<Title>
<Position vPos="0" enable="0" hPos="1" insideMap="0"/>
<text></text>
<font height="14" weight="400" charset="1" face="MS Shell Dlg" italic="0"/>
</Title>
<LogoBottom>
<Position vPos="1" enable="0" hPos="0" insideMap="0"/>
<bitmap></bitmap>
<Dimensions width="46" height="18"/>
</LogoBottom>

142
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

<Footer>
<Position vPos="1" enable="0" hPos="1" insideMap="0"/>
<text></text>
<font height="14" weight="400" charset="1" face="MS Shell Dlg" italic="0"/>
</Footer>
</PrintConfiguration>

11.2.2 Table Import/Export Configuration
The following parameters are saved for table import/export:
r flag <TITRE>
e d a •H
e
• Field separator <FLD_SEPARATOR>
l symbol <DEC_SEPARATOR>
am i c •De
• Fields available in the table (field legends) <FIELDS>
• Fields selected for import/export (field legends) <CHOOSEN_FIELDS>

Sample

<?xml version="1.0" encoding="UTF-8"?>


<TITRE>1</TITRE>
<FLD_SEPARATOR>&lt;tab&gt;</FLD_SEPARATOR>
<DEC_SEPARATOR>.</DEC_SEPARATOR>

<FIELDS>
Site
Transmitter
...
</FIELDS>
<CHOOSEN_FIELDS>
Site

Transmitter
...
</CHOOSEN_FIELDS>

11.2.3 Coverage Prediction Report Configuration
The following parameters are saved for coverage prediction reports:
s selected in the 
nmu l o•C Columns to be displayed dialogue <SelectedFields> including the field titles <Field> <Title>

Sample

<?xml version="1.0" encoding="UTF-8"?>


<ReportConfiguration>
<SelectedFields>
<Field>
<Title>Surface (km²)</Title>
</Field>
<Field>
<Title>% of Covered Area</Title>
</Field>
... </SelectedFields>
</ReportConfiguration>

143
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

11.2.4 CW Measurement Import Configuration
More than one CW measurement import configurations can be saved in a single CWMeasurementsImport.ini file.
The following parameters are saved in the CWMeasurementsImport.ini files:
• Configuration name in square brackets
t measurement row (Header)
s r i•F
• Separator (Separator)
l symbol (DecimalSeparator)
am i c •D
e
f files for which the configur
o   e p y•T ion has been defined (Pattern)
ta
 containing the X coordinates 
nmu l o•C index)
X ( •Column containing the Y coordinates (Yindex)
 containing the measurement va
nmu l o•C es (MeasIndex)
ul •Unit of the measurement values (Unit)

• Frequency of the measurements (Frequency)
•Height of the receiver used for measurement
eight)
H(   s
•Gain of the receiver used for measurements 
n)i aG (
•Losses of the receiver used for measurement
osses)
L(   s
•Total number of columns in measurement file
bCol)
N(   s
n types (Col0 to Col
mu l o•C NbCol)
The column type indexes are as follows:

Type Index
Text 0
Integer 1
Real 2
Date 3
<Ignore> 4

Sample

[ConfigurationName]
Header=2
Separator=tab
DecimalSeparator=.
Pattern=*.txt
Xindex=1
Yindex=2
MeasIndex=4
Unit=0
Frequency=2110
Height=1.5
Gain=0
Losses=0
NbCol=23
Col0=1
Col3=4
Col5=0
...

11.2.5 Drive Test Data Import Configuration
More than one drive test data import configurations can be saved in a single DriveTestDataImport.ini file.
The following parameters are saved in the DriveTestDataImport.ini files:
• Configuration name in square brackets
t measurement row (Header)
s r i•F

144
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 11: Configuration Files

• Separator (Separator)
l symbol (DecimalSeparator)
am i c •De
e of files for which the configuration has been defined (Pattern)
p y•T
umn containing the X coordinates (Xindex)
l o•C
umn containing the Y coordinates (Yindex)
l o•C
t of the measurement values (Unit)
i •U
n
ght of the receiver used for measurements (Height)
i •H
e
n of the receiver used for measurements (Gain)
i •G
a
ses of the receiver used for measurements (Losses)
s o•L
st identifier (GenericNameIdOne)
r i•F

d identifier (GenericNameIdTwo)
no c e•S
t of the second identifier (IdFormat)
amr o•F
• Wireless technology (Techno)
l number of columns in measurement files (NbCol)
a t o•T
n types (Col0 to Col
mu l o•C NbCol)
The column type indexes are as follows:

Type Index
Text 0
Integer 1
Long Integer 2
Single 3
Double 4
Date 5
<Ignore> 6

Sample

[ConfigurationName]
Header=2
Separator=tab
DecimalSeparator=.
Pattern=*.*
Xindex=1
Yindex=2
Unit=0
Height=1.5
Gain=0
Losses=0
GenericNameIdOne=
GenericNameIdTwo=BSID
IdFormat=Decimal
Techno=IEEE 802.16e
NbCol=21
Col0=1
Col3=1
Col4=4
...

11.3 Content of the Custom Predictions File
The content of the custom predictions file (by default, studies.XML in the installation folder) is identical to the content found
between the <Studies> and </Studies> tags in the configuration file. For more information, see "Coverage Predictions" on
page 129.

145
Atoll 3.2.1 Administrator Manual
Chapter 11: Configuration Files © Forsk 2014

11.4 Content of the "Value Intervals" Predictions Files
The content of the XML files for coverage predictions calculated by value intervals (by default,  prediction_name>.XML in the
C:\<path_to_doc>\<doc_name>.studies\{<Unique_ID>} folder) is identical to the content found between the <Studies> and </
Studies> tags in the configuration file. For more information, see "Coverage Predictions" on page 129.

146
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 12: Initialisation Files

12 Initialisation Files
Initialisation files can be used to store operational and working environment settings. These files are optional, not required
for working with Atoll, but are useful means for selecting required calculation methods and other settings.
This chapter describes the formats of these files in detail:
l initialisation file
l o •A
t  (Atoll.ini)
This file contains conventions, calculation settings, and other options for 
Atoll. For more information on these options,
see "Atoll Initialisation File" on page 147.
Atoll.ini can be automatically loaded when Atoll is run when it is:
a. Identified in the command line parameter ‐Ini "inifilename" (see "Atoll Command Line Parameters" on page 24 for
more information), or
b. Located  in  the  Atoll  installation  folder.  This  file  will  be  ignored  if  an  initialisation  file  is  loaded  through  the
command line parameter.

u can 
o•Y open  the  Atoll.ini  file  in  the  Atoll  installation  folder for  editing by  pressing
CTRL+SHIFT+i. If no Atoll.ini file exists, a blank Atoll.ini file is created.
u must restart 
o•Y Atoll in order to take into account modifications made in Atoll.ini.
•A given Atoll.ini section, e.g. [GUIUserRights] or [LTE], must occur only once in the file,
with all options pertaining to that section listed under it. If you enter the same section
twice, only the first occurrence of the section will be read and loaded by Atoll.

• ACP initialisation file (ACP.ini)
This  file contains  calculation settings and other  options  for  the Atoll ACP  module.  For more information on these
options, see "ACP Initialisation File" on page 194.

12.1 Atoll Initialisation File
The following main groups of options are available:

• "General Options" on page 147
• "GUI Options" on page 159
• "Distributed Calculation Server Options" on page 163
• "Licence Management Options" on page 164
• "Database Options" on page 165
• "Common Calculation Options" on page 168
• "GSM GPRS EDGE Options" on page 175
• "UMTS HSPA, CDMA2000, and TD‐SCDMA Options" on page 180
• "LTE, WiMAX, and Wi‐Fi Options" on page 185
• "3GPP Multi‐RAT Options" on page 190
• "Microwave Radio Links Options" on page 191
• "Measurement Options" on page 193
• "ACP Options" on page 194

The Atoll initialisation file is a powerful tool. You should not modify any option until and
unless you are absolutely sure of what you are doing.

12.1.1 General Options
12.1.1.1 Modifying the Default Formats of Site and Transmitter Names
Through the Atoll.ini file, it is possible to specify prefixes to be used for naming sites and transmitters.
In case of sites, you must add these lines:

[Site]
Prefix = "newprefix"

Each new site will then be named “newprefixN” instead of “SiteN”, where N is the site number or index.

147
Atoll 3.2.1 Administrator Manual
Chapter 12: Initialisation Files © Forsk 2014

For transmitters, you can define a prefix by adding these lines:

[Transmitter]
Prefix = "newprefix"

Each  new  transmitter  will  be  named  “newprefixN”  instead  of  Sitename_X  (Sitename  is  the  name  of  the  site  where 
the transmitter is located and X is the transmitter sector number on this site). Not adding the above lines, or setting the prefix to
<Auto> (Prefix = "<AUTO>"), will instruct Atoll to keep the conventional naming method, i.e., each transmitter will be named
Sitename_X.
Furthermore, it is also possible to remove the underscore character "_" from the transmitter’s name, i.e., the transmitter can
be named SitenameX instead of Sitename_X. To do this, add the following line in the [Transmitter] section of the Atoll.ini file:

[Transmitter]
Underscore = 0 or 1

Setting this value to 0 means the underscore character will not be used when naming transmitters. The default value is 1. You
can also define whether the suffix X in the transmitter’s name should be a number or a letter. The following two lines define
this option in the Atoll.ini file:

[Transmitter]
SuffixIsNum = 0 or 1
FirstCharSuffix = "A"

When SuffixIsNum = 1, the default, the suffix X in the transmitter name Sitename_X will be a number. When it is set to 0, this
suffix will be a letter. The starting suffix in this case will be A by default but can be changed to any other character through
the second line.
If you are using number suffixes, you can also initialise the number suffix at any other number than 1. To do this, you can add
the following lines under the [Transmitter] section of the Atoll.ini file:

[Transmitter]
First = X

Where, X is a number.

12.1.1.2 Disabling Automatic Renaming of Transmitters and Cells
When the name of any site is modified, Atoll automatically renames the transmitters and cells related to the site according to
the new site name. Similarly, renaming a transmitter renames the corresponding cells automatically. Automatic renaming
according to site names is enabled by default. However, it can be disabled by adding the following lines in the Atoll.ini file:

[AutoRename]
Transmitters = 0
3GCells = 0

" refers to transmitter renaming when the site name is changed.
s r e t t i ms n a r T•"
• "3Gcells" refers to cell renaming when the transmitter name is changed.

12.1.1.3 Setting the TIFF Colour Convention
In the default palette, the first colour indexes represent the useful information and the remaining colour indexes represent
the background. You can export TIFF files with a palette containing the background colour at index 0 along with other colour
indices representing the foreground. This can be helpful when working on TIFF files exported by Atoll in other tools. To do so,
the Atoll.ini file must contain these lines:

[TiffExport]
PaletteConvention = Gis

12.1.1.4 Creating an Event Viewer Log File
You can define  a  log file path  and file name in Atoll.ini in  order to save  all the  warning, error, and  information  messages
displayed in the Event Viewer window to a log file. To do this, add the following lines to Atoll.ini:

148
Atoll 3.2.1 Administrator Manual
AT321_AM_E1 Chapter 12: Initialisation Files

[EventsObserver]
LogPath = FullPath\LogFile.log

The path should be the full path to the log file, which can be, for example, "\\Server\Drive\Root\Folder\Atoll\" or "C:\Program
Files\Forsk\Atoll\" (without quotation marks). "LogFile.log" will be created by Atoll as an ASCII text file, and can have any file
name and extension. Atoll will overwrite any already existing log file with the same name. If  Atoll is unable to overwrite the
existing log file, it will not create any log.
You can also start  Atoll, specifying a log file, by starting it with "Atoll.exe ‐log LogFile.log", either from the command line, or
by modifying the shortcut parameters. If you have a log file defined in the Atoll.ini file, and run  Atoll with the ‐log option in
the command line, the command line log file will have priority over the one mentioned in the Atoll.ini file.
The option available in Atoll.ini is more suitable for running  Atoll using macros. Apart from these options, you also have the
possibility to save the messages in the Event Viewer to a log file during an  Atoll session (through the Event Viewer context
menu).

12.1.1.5 Displaying Insufficient Permission Messages in the Event Viewer
If a user attempts to load an add‐in for which he does not have the necessary permissions, by default, a message will be
displayed in the Event Viewer. By defining an option in the Atoll.ini file, messages regarding insufficient permission will not be
displayed. 

[EventsObserver]
ShowAddinAccessDeniedMsg=0 # 1 by default; insufficient permission messages are shown

12.1.1.6 Increasing the Maximum Printing Resolution
By default, Atoll limits the printing resolution to 150 dpi (dots per inch) to improve performance and consume less memory
when printing. If you want Atoll to print your maps in a higher resolution than 150 dpi, you can add the following lines to the
Atoll.ini file:

[Print]
MaxDPI = 300

300 dpi is given as an example only.

12.1.1.7 Duplicating Linked Path Loss Matrices on Save As
When you save an  Atoll document with linked path loss matrices as another document using Save As,  Atoll creates the the
linked path loss matrices folder corresponding to the created file and copies the existing linked path loss matrices from the
path loss matrices folder of the original document. There can be a large number of LOS files, and copying these files can take
a long time and use a lot of disk space. If you want Atoll not to make copies of the linked path loss matrices, you can add the
following lines to the Atoll.ini file:

[Perfos]
StoreExternPrivLosFilesOnCopy = 0

StoreExternPrivLosFilesOnCopy is set to 1 by default, which means that Atoll makes copies of the linked path loss matrices on
Save  As.  If  you  set  StoreExternPrivLosFilesOnCopy  to  0,  Atoll  does  not  create  the  linked  path  loss  matrices  folder
corresponding to the created file, and the linked path loss matrices of the original Atoll document are used for the new Atoll
document as well.
A file open in  Atoll has exclusive access rights to its private path loss matrices. If two files point to the same linked path loss
matrices folder, the file open first will have access to the the path loss matrices. You will be able to open the second file, but
it will no longer point to any private path loss matrices folder. Therefore, if you have more than one file that points to the
same private path loss matrices folder, you should not open them at the same time.
When StoreExternPrivLosFilesOnCopy is set to 1, you can add another option in the Atoll.ini file to make 
Atoll ask the whether
the user wants Atoll to make copies the linked path loss matrices or not. To add this confirmation step on Save As, add the
following lines in the Atoll.ini file:

[Perfos]
ConfirmStoreExternPrivLosFilesOnCopy = 1

ConfirmStoreExternPrivLosFilesOnCopy is set to 0 by default. This option is ignored when Atoll is run in non‐interactive mode,
for example using the API.

149
Atoll 3.2.1 Administrator Manual
Chapter 12: Initialisation Files © Forsk 2014

12.1.1.8 Disabling External Storage of Numerical Results Files for Predictions
The numerical results of coverage predictions calculated by value intervals are stored externally files. This avoids recalculating
a coverage prediction when the legend is modified and provides a numerical difference feature between basic predictions.
However, the storage of numerical results may require additional disk space when your document contains several coverage
predictions and transmitters, and/or high resolutions are used. if you have limited disk space, you can disable this feature by
adding the following lines in the Atoll.ini file:

[Studies]
NumericalResults = 0

NumericalResults is set to 1 by default, which means that Atoll will generate external results files and require more disk space.

Memory space is not impacted when NumericalResults is set to 1.

12.1.1.9 Restricting the List of Predictions for Creating Sector Traffic Maps
When you create a sector traffic map, i.e., traffic map based on cell coverage areas,  Atoll uses an existing best server coverage
prediction in order to be able to distribute the live traffic data geographically.  Atoll lets you select the best server coverage
prediction on which the traffic map will be based. In the list of available best server coverage predictions,  Atoll lists all the best
server coverage prediction available in the Predictions folder, whether they were created using a margin or without.
If you want Atoll to list only the best server coverage predictions that were created without a margin, i.e., with 0dB margin,
you can add the following lines to the Atoll.ini file:

[Studies]
SelectNullMarginOnly = 1

SelectNullMarginOnly is set to 0 by default, which means that Atoll lists all the best server coverage predictions available.

12.1.1.10 Displaying Path Loss Calculation Details in the Event Viewer
During path loss calculations, Atoll displays details about these calculations in the Tasks tab of the Event Viewer. These details
cannot be copied or saved. If you want access to these details, or to a summary of these details, once the calculations have
finished, you can add the following lines in the Atoll.ini file:

[Pathlosses]
DisplayInvalidityCause = 1
DisplayIndividualSuccessOrFailure = 1 DisplayOverallSuccessOrFailure = 1

Setting the DisplayInvalidityCause option to 1 will display the cause for which path losses were calculated for each transmitter,
setting  DisplayIndividualSuccessOrFailure  to  1  will  display  whether  the  path  loss  calculation  succeeded  or  failed  for 
each
transmitter, and setting DisplayOverallSuccessOrFailure to 1 will display the total number of path loss matrices calculated, the number o

These details are listed in the Events tab of the Event Viewer.

12.1.1.11 Mapping Atoll Coordinate Systems with MapInfo/ESRI Vector Files
It is now possible to define a mapping between the coordinate systems in  Atoll and the coordinate systems defined in the
header files of MapInfo (MIF) and ESRI (PRJ) vector files that you want to import. You can define a mapping between the two
coordinate systems by adding the following lines in the Atoll.ini file:

[MITAB]
Coordinate system definition in the header file = Coordinate system code in Atoll

In this  way,  Atoll is able  to exactly detect the coordinate  system used  by  the  vector file being  imported. In MIF  files, the
CoordSys  clause  defines  the  coordinate  systems,  datum,  unit,  and  other  information.  The  coordinate  system  definition  is
different in the PRJ files. The syntax used in Atoll.ini follows the syntax of the CoordSys clause in MIF files. Using the same
syntax for MIF and PRJ files, Atoll is able to read the detect the coordinate systems for both MapInfo and ESRI vector files.

150