You are on page 1of 360

Atoll

Wireless Network Engineering Software

Data Structure Reference Guide

Version 3.4.0

AT340_DSR_E2
Atoll 3.4.0 Data Structure Reference Guide
Release: AT340_DSR_E2 (November 2018)
© Copyright 1997-2018 Forsk. All Rights Reserved.
Published by:
Forsk
7 rue des Briquetiers
31700 Blagnac, France
Tel: +33 562 747 210
Fax: +33 562 747 211
The software described in this document is provided under a licence agreement. The software may only be used or copied under the terms and
conditions of the licence agreement. No part of the contents of this document may be reproduced or transmitted in any form or by any means
without written permission from the publisher.
The product or brand names mentioned in this document are trademarks or registered trademarks of their respective registering parties.
Third party services that are not part of Atoll are governed by the terms and conditions of their respective providers, which are subject to change
without notice.
The publisher has taken care in the preparation of this document, but makes no expressed or implied warranty of any kind and assumes no
responsibility for errors or omissions. No liability is assumed for incidental or consequential damages in connection with or arising out of the
use of the information contained herein.
Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Table of Contents

Table of Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1 GSM GPRS EDGE Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
1.1 Data Structure Changes from Atoll 3.3 to 3.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
1.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
1.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
1.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
1.2.1 AfpModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
1.2.2 Antennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
1.2.3 BSICDomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
1.2.4 BSICGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
1.2.5 BTSEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
1.2.6 CellTypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
1.2.7 CodecEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
1.2.8 CodecModeAdaptations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
1.2.9 CodecModes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
1.2.10 CodecQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
1.2.11 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
1.2.12 CustomFields Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
1.2.13 EGPRSCodingSchemes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
1.2.14 EGPRSDimensioningModel Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
1.2.15 EGPRSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
1.2.16 EGPRSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
1.2.17 EGPRSMobility Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
1.2.18 EGPRSQuality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
1.2.19 EGPRSServiceQuality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
1.2.20 EGPRSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
1.2.21 EGPRSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
1.2.22 EGPRSTerminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
1.2.23 EGPRSTrafficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
1.2.24 EGPRSUserProfiles Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
1.2.25 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
1.2.26 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
1.2.27 FrequencyDomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
1.2.28 FrequencyGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
1.2.29 HSNDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
1.2.30 HSNGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
1.2.31 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
1.2.32 Layers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
1.2.33 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
1.2.34 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
1.2.35 NeighboursConstraintsExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
1.2.36 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
1.2.37 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
1.2.38 PropagationModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
1.2.39 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
1.2.40 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39

© 2018 Forsk. All Rights Reserved. 3


Atoll 3.4.0 Data Structure Reference Guide
Table of Contents

1.2.41 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39


1.2.42 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
1.2.43 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
1.2.44 SeparationRules Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
1.2.45 Separations Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.2.46 Sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.2.47 SitesLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1.2.48 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.2.49 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.2.50 TplTransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.2.51 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
1.2.52 TRGConfigurations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
1.2.53 TRGs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
1.2.54 TRXEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
1.2.55 TRXs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
1.2.56 TRXTypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
1.2.57 TSConfigurationNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
1.2.58 TSConfigurations Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
1.2.59 TxsLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
1.2.60 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
1.2.61 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
1.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

2 UMTS HSPA Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57


2.1 Data Structure Changes from Atoll 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
2.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
2.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
2.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
2.2.1 Antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
2.2.2 BTSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
2.2.3 CDMACells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
2.2.4 CdmaEqptsHSUPARssUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
2.2.5 CDMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
2.2.6 CDMAEquipmentsCEsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
2.2.7 CoordSys Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
2.2.8 CustomFields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.2.9 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.2.10 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
2.2.11 HSDPABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
2.2.12 HSDPABearerSelectTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
2.2.13 HSDPAQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
2.2.14 HSPAMIMOConfigs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.2.15 HSUPABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.2.16 HSUPABearerSelection Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.2.17 HSUPAQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.2.18 HSUPAUECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
2.2.19 InterfReductionFactors Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
2.2.20 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
2.2.21 MUGTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2.2.22 Neighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2.2.23 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2.2.24 NeighboursConstraintsExt Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.2.25 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.2.26 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.2.27 PropagationModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
2.2.28 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

4 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Table of Contents

2.2.29 R99Bearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73


2.2.30 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
2.2.31 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
2.2.32 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
2.2.33 Schedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
2.2.34 ScramblingCodesDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
2.2.35 ScramblingCodesGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
2.2.36 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
2.2.37 Separations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
2.2.38 ServiceQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
2.2.39 Sites Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
2.2.40 SitesLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
2.2.41 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
2.2.42 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
2.2.43 TplTransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
2.2.44 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
2.2.45 TxsLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
2.2.46 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
2.2.47 UECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
2.2.48 ulayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
2.2.49 UERxEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
2.2.50 UMTSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
2.2.51 UMTSMobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
2.2.52 UMTSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
2.2.53 UMTSServicesQuality Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
2.2.54 UMTSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
2.2.55 UMTSTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
2.2.56 UMTSTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
2.2.57 UMTSUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
2.2.58 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
2.2.59 uterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
2.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

3 CDMA2000 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95


3.1 Data Structure Changes from Atoll 3.3 to 3.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
3.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
3.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
3.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
3.2.1 Antennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
3.2.2 BTSEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
3.2.3 CarriersType Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
3.2.4 CDMACells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
3.2.5 CDMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
3.2.6 CDMAEquipmentsCEsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
3.2.7 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
3.2.8 CustomFields Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
3.2.9 DLBearersSelection Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
3.2.10 DLDORABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
3.2.11 DORABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.2.12 DORABearersProba Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.2.13 DORATerminalT2PRatios Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.2.14 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.2.15 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
3.2.16 InterfReductionFactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
3.2.17 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
3.2.18 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

© 2018 Forsk. All Rights Reserved. 5


Atoll 3.4.0 Data Structure Reference Guide
Table of Contents

3.2.19 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105


3.2.20 NeighboursConstraintsExt Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
3.2.21 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
3.2.22 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
3.2.23 PnCodesDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
3.2.24 PnCodesGroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
3.2.25 PropagationModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
3.2.26 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
3.2.27 Receivers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
3.2.28 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
3.2.29 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
3.2.30 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
3.2.31 Separations Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
3.2.32 ServiceQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.2.33 Sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.2.34 SitesLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
3.2.35 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
3.2.36 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
3.2.37 TplTransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
3.2.38 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
3.2.39 TxsLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
3.2.40 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
3.2.41 UERxEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
3.2.42 ULBearersSelection Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
3.2.43 UMTSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
3.2.44 UMTSMobility Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
3.2.45 UMTSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
3.2.46 UMTSServicesQuality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
3.2.47 UMTSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
3.2.48 UMTSTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
3.2.49 UMTSTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
3.2.50 UMTSUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
3.2.51 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
3.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

4 LTE Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127


4.1 Data Structure Changes from Atoll 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
4.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
4.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
4.2.1 Antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
4.2.2 BTSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
4.2.3 CoordSys Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
4.2.4 CustomFields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
4.2.5 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
4.2.6 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.2.7 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.2.8 lcagroupdefs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
4.2.9 lcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
4.2.10 lcchdivgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
4.2.11 lcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
4.2.12 lcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
4.2.13 lframeconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4.2.14 llayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4.2.15 lmbsfnareadefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
4.2.16 lmbsfnareas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

6 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Table of Contents

4.2.17 lpcidomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138


4.2.18 lpcigroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
4.2.19 lprachdomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
4.2.20 lprachgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
4.2.21 lrelayLinks Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
4.2.22 lrepetitions Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
4.2.23 lterminalbands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
4.2.24 MUGTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
4.2.25 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
4.2.26 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
4.2.27 NeighboursConstraintsExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
4.2.28 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
4.2.29 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
4.2.30 PropagationModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
4.2.31 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
4.2.32 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
4.2.33 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
4.2.34 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
4.2.35 Schedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
4.2.36 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
4.2.37 Sites Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
4.2.38 SitesLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
4.2.39 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
4.2.40 SmartAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
4.2.41 SmartAntennasModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
4.2.42 T4GBearerQualityCurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
4.2.43 T4GBearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
4.2.44 T4GBearersRequiredCI Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
4.2.45 T4GCells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
4.2.46 T4GEnvironmentDefs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
4.2.47 T4GEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
4.2.48 T4GMimoConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
4.2.49 T4GMobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
4.2.50 T4GServices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
4.2.51 T4GServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
4.2.52 T4GTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
4.2.53 T4GTraficEnvironments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
4.2.54 T4GUECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
4.2.55 T4GUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
4.2.56 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
4.2.57 TplTransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
4.2.58 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
4.2.59 TxsLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
4.2.60 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
4.2.61 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
4.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

5 5G NR LTE Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167


5.1 Data Tables Common to All Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
5.1.1 antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
5.1.2 btsequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
5.1.3 coordsys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
5.1.4 customfields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
5.1.5 environmentdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
5.1.6 feederequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
5.1.7 interratirfs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

© 2018 Forsk. All Rights Reserved. 7


Atoll 3.4.0 Data Structure Reference Guide
Table of Contents

5.1.8 mobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172


5.1.9 networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
5.1.10 propagationmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
5.1.11 receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
5.1.12 repeaterequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
5.1.13 services Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
5.1.14 servicesusage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
5.1.15 sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
5.1.16 siteslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
5.1.17 siteslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
5.1.18 terminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
5.1.19 tmaequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
5.1.20 trafficenvs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
5.1.21 units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
5.1.22 userprofiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
5.2 5G NR LTE Data Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
5.2.1 lrelaylinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
5.2.2 tpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
5.2.3 xgbearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
5.2.4 xgbfmodels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
5.2.5 xgbfpatterns Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
5.2.6 xgcagroupdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
5.2.7 xgcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
5.2.8 xgcarriers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
5.2.9 xgcchgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
5.2.10 xgcells5gnr Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
5.2.11 xgcellslte Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
5.2.12 xgcellsnbiot Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
5.2.13 xgcellsuids Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
5.2.14 xgcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
5.2.15 xgcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
5.2.16 xgequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
5.2.17 xgfreqbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
5.2.18 xgiddomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
5.2.19 xgidgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
5.2.20 xgirfs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
5.2.21 xglayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
5.2.22 xgmuggains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
5.2.23 xgneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
5.2.24 xgneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
5.2.25 xgqigraphs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
5.2.26 xgrepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
5.2.27 xgrepetitions Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
5.2.28 xgschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
5.2.29 xgsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
5.2.30 xgservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
5.2.31 xgsfnclusterdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
5.2.32 xgsfnclusters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
5.2.33 xgtchgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
5.2.34 xgterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
5.2.35 xgterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
5.2.36 xgthresholds Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
5.2.37 xgtransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
5.2.38 xgtxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
5.2.39 xgtxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
5.2.40 xguecategories Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

8 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Table of Contents

6 3GPP Multi-RAT Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207


6.1 Tables Common to 3GPP Technologies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
6.1.1 Data Structure Changes from Atoll 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
6.1.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
6.1.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
6.1.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
6.1.2.1 antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.2 btsequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.3 coordsys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.4 customfields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.5 environmentdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.6 feederequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.7 internetchprotect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.8 mobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
6.1.2.9 networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
6.1.2.10 propagationmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
6.1.2.11 receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
6.1.2.12 repeaterequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
6.1.2.13 services Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
6.1.2.14 servicesusage Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
6.1.2.15 sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
6.1.2.16 siteslists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
6.1.2.17 siteslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
6.1.2.18 smartantennasmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
6.1.2.19 terminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
6.1.2.20 tmaequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
6.1.2.21 trafficenvs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
6.1.2.22 units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
6.1.2.23 userprofiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
6.2 GSM-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
6.2.1 Data Structure Changes from Atoll 3.2 to 3.3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
6.2.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
6.2.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
6.2.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
6.2.2.1 gafpmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.2 gbsicdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.3 gbsicgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.4 gcelltypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.5 gcodecequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.6 gcodecmodeadapts Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.7 gcodecmodes Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.8 gcodecqualtables Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.9 gcodingschemes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.10 gcsequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.11 gcsquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
6.2.2.12 gdimensmodel Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.13 gfreqdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.14 gfreqgroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.15 gfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.16 ghsndomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.17 ghsngroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.18 glayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.19 glneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
6.2.2.20 glneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.21 gneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.22 gneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.23 gneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.24 gneighextconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.25 gqualityindicators Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.26 grepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.27 gsecondaryantennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.28 gseparationrules Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.29 gseparations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
6.2.2.30 gservicequality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
6.2.2.31 gservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
6.2.2.32 gterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
6.2.2.33 gtpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
6.2.2.34 gtransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
6.2.2.35 gtrgconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
6.2.2.36 gtrgs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
6.2.2.37 gtrxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217

© 2018 Forsk. All Rights Reserved. 9


Atoll 3.4.0 Data Structure Reference Guide
Table of Contents

6.2.2.38 gtrxs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217


6.2.2.39 gtrxtypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
6.2.2.40 gtsconfignames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
6.2.2.41 gtsconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
6.2.2.42 gtxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
6.2.2.43 gtxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
6.2.2.44 guneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
6.2.2.45 guneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
6.3 UMTS-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.1 Data Structure Changes from 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.1.1 Added Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.1.2 Deleted Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.2.1 ucells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.2.2 uceuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.2.3 uequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.2.4 ufrequencybands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
6.3.2.5 ugneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.2.6 ugneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.2.7 uhsdpabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.2.8 uhsdpabearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.2.9 uhsdpaqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.2.10 uhspamimoconfigs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.2.11 uhsupabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
6.3.2.12 uhsupabearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2.13 uhsupaqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2.14 uhsuparessuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2.15 uhsupauecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2.16 uinterfreducfactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2.17 ulayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2.18 ulneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
6.3.2.19 ulneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.20 umobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.21 umugtables Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.22 uneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.23 uneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.24 uneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.25 uneighextconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.26 upscdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.27 upscforbidpairs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.28 upscgroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.3.2.29 uqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.30 ur99bearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.31 urepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.32 uschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.33 usecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.34 uservicequaltables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.35 uservices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.36 uservicesquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.37 uterminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.38 uterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.39 utpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3.2.40 utransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.3.2.41 utxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.3.2.42 utxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.3.2.43 uuecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.3.2.44 uuerxequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.4 LTE-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.4.1 Data Structure Changes from 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.4.1.1 Added Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
6.4.1.2 Deleted Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.4.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.4.2.1 lbearerqualitycurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.4.2.2 lbearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.4.2.3 lbearersrequiredci Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.4.2.4 lcagroupdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.4.2.5 lcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
6.4.2.6 lcells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
6.4.2.7 lcchdivgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
6.4.2.8 lcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
6.4.2.9 lcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

10 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Table of Contents

6.4.2.10 lequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227


6.4.2.11 lframeconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
6.4.2.12 lfrequencybands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
6.4.2.13 lgneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
6.4.2.14 lgneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.15 llayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.16 lmbsfnareadefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.17 lmbsfnareas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.18 lmimoconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.19 lmugtables Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.20 lneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.21 lneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.22 lneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.23 lneighextconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
6.4.2.24 lpcidomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.25 lpcigroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.26 lprachdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.27 lprachgroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.28 lqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.29 lrelaylinks Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.30 lrepetitions Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.31 lrepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.32 lschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.33 lsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.34 lservices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
6.4.2.35 lsmartantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.36 lterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.37 lterminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.38 ltpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.39 ltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.40 ltxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.41 ltxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.42 luecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.43 luneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
6.4.2.44 luneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231

7 3GPP2 Multi-RAT Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233


7.1 Tables Common to 3GPP2 Technologies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
7.1.1 Data Structure Changes from Atoll 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
7.1.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
7.1.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
7.1.2.1 antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.2 btsequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.3 coordsys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.4 customfields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.5 environmentdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.6 feederequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.7 internetchprotect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.8 mobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
7.1.2.9 networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
7.1.2.10 propagationmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
7.1.2.11 receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
7.1.2.12 repeaterequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
7.1.2.13 services Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
7.1.2.14 servicesusage Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
7.1.2.15 sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
7.1.2.16 siteslists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
7.1.2.17 siteslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
7.1.2.18 smartantennasmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
7.1.2.19 terminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
7.1.2.20 tmaequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
7.1.2.21 trafficenvs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
7.1.2.22 units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
7.1.2.23 userprofiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
7.2 CDMA2000-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
7.2.1 Data Structure Changes from 3.3 to 3.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
7.2.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
7.2.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
7.2.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
7.2.2.1 ccarrierstype Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239

© 2018 Forsk. All Rights Reserved. 11


Atoll 3.4.0 Data Structure Reference Guide
Table of Contents

7.2.2.2 ccells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239


7.2.2.3 cceuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.4 cdlbearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.5 cdldorabearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.6 cdorabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.7 cdorabearersproba Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.8 cdoratermt2pratios Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.9 cequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.10 cfrequencybands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.11 cinterfreducfactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.12 clneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
7.2.2.13 clneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.2.2.14 cmobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.2.2.15 cneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.2.2.16 cneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.2.2.17 cneighext Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.2.2.18 cneighextconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.2.2.19 cpnodomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.2.2.20 cpnoforbidpairs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.21 cpnogroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.22 cqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.23 crepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.24 csecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.25 cservicequaltables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.26 cservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.27 cservicesquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.28 cterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.29 ctpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.30 ctransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.31 ctxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
7.2.2.32 ctxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.2.2.33 cuerxequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.2.2.34 culbearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.3 LTE-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.3.1 Data Structure Changes from 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.3.1.1 Added Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.3.1.2 Deleted Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2.1 lbearerqualitycurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2.2 lbearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2.3 lbearersrequiredci Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2.4 lcagroupdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2.5 lcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2.6 lcells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.3.2.7 lcchdivgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.2.8 lcneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.2.9 lcneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.2.10 lcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.2.11 lcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.2.12 lequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.2.13 lframeconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
7.3.2.14 lfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.15 llayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.16 lmbsfnareadefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.17 lmbsfnareas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.18 lmimoconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.19 lmugtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.20 lneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.21 lneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.22 lneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.23 lneighextconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.24 lpcidomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.25 lpcigroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
7.3.2.26 lprachdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.27 lprachgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.28 lqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.29 lrelaylinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.30 lrepetitions Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.31 lrepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.32 lschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.33 lsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.3.2.34 lservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

12 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Table of Contents

7.3.2.35 lsmartantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248


7.3.2.36 lterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248
7.3.2.37 lterminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
7.3.2.38 ltpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
7.3.2.39 ltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
7.3.2.40 ltxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
7.3.2.41 ltxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
7.3.2.42 luecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249

8 TD-SCDMA Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251


8.1 Data Structure Changes from Atoll 3.3 to 3.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
8.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
8.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
8.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
8.2.1 Antennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
8.2.2 AntennasLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
8.2.3 AntennasListsNames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.2.4 BTSEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.2.5 CDMACells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.2.6 CDMACellsTS Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
8.2.7 CDMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
8.2.8 CDMAEquipmentsCEsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
8.2.9 CodesRelativityClusters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
8.2.10 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
8.2.11 CustomFields Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
8.2.12 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
8.2.13 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
8.2.14 HSDPABearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
8.2.15 HSDPABearerSelectTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
8.2.16 HSUPABearers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
8.2.17 HSUPABearerSelection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
8.2.18 HSUPAUECategories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
8.2.19 InterfReductionFactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
8.2.20 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
8.2.21 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
8.2.22 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
8.2.23 NeighboursConstraintsExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
8.2.24 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
8.2.25 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
8.2.26 PropagationModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
8.2.27 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
8.2.28 R99Bearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
8.2.29 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
8.2.30 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
8.2.31 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
8.2.32 SACIGainCDF Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
8.2.33 ScramblingCodesDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
8.2.34 ScramblingCodesGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
8.2.35 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
8.2.36 Separations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
8.2.37 ServiceQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
8.2.38 ServiceRUsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
8.2.39 Sites Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
8.2.40 SitesLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
8.2.41 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
8.2.42 SmartAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
8.2.43 SmartAntennasModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
8.2.44 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

© 2018 Forsk. All Rights Reserved. 13


Atoll 3.4.0 Data Structure Reference Guide
Table of Contents

8.2.45 TplTransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273


8.2.46 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
8.2.47 TxsLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
8.2.48 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
8.2.49 UECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
8.2.50 UERxEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
8.2.51 UMTSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
8.2.52 UMTSMobility Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
8.2.53 UMTSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
8.2.54 UMTSServicesQuality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
8.2.55 UMTSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
8.2.56 UMTSTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
8.2.57 UMTSTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
8.2.58 UMTSUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
8.2.59 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
8.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

9 WiMAX, Wi-Fi, and LPWA Data Structures . . . . . . . . . . . . . . . . . . . . . . . . . 287


9.1 Data Structure Changes from Atoll 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
9.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
9.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
9.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
9.2.1 Antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
9.2.2 BTSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
9.2.3 CoordSys Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
9.2.4 CustomFields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
9.2.5 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
9.2.6 FrameConfigurations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.2.7 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.2.8 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.2.9 MUGTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.2.10 Neighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.2.11 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.2.12 NeighboursConstraintsExt Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.2.13 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.2.14 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.2.15 PermutationZones Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.2.16 PropagationModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.2.17 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.2.18 Receivers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.2.19 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.2.20 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.2.21 Schedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.2.22 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.2.23 Sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.2.24 SitesLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.2.25 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.2.26 SmartAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.2.27 SmartAntennasModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.2.28 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.2.29 TplTransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
9.2.30 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
9.2.31 TxsLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
9.2.32 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
9.2.33 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
9.2.34 WBearerQualityCurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

14 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Table of Contents

9.2.35 WBearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308


9.2.36 WBearersRequiredCI Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
9.2.37 WCCHDivGains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
9.2.38 WCells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
9.2.39 WEnvironmentDefs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
9.2.40 WEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
9.2.41 WLayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
9.2.42 WMimoConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
9.2.43 WMobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
9.2.44 WPIDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
9.2.45 WPIGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
9.2.46 WServices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
9.2.47 WServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
9.2.48 WTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
9.2.49 WTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
9.2.50 WUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
9.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

10 Microwave Links Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319


10.1 Data Structure Changes from Atoll 3.3 to 3.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
10.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
10.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10.2.1 BHNodes Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10.2.2 BHSegments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10.2.3 BHSegmentsMedia Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
10.2.4 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
10.2.5 CustomFields Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
10.2.6 MWAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
10.2.7 MWBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
10.2.8 MWBranchingConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
10.2.9 MWCapacities Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
10.2.10 MWCompatibilities Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
10.2.11 MWCompatibilitiesGuides Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
10.2.12 MWDefaultsCurves Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
10.2.13 MWDesignRules Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
10.2.14 MWEPO Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
10.2.15 MWEPOLinkClass Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
10.2.16 MWEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
10.2.17 MWFamilies Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.2.18 MWFamilyBrConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.2.19 MWFrequencies Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.2.20 MWFrontages Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.2.21 MWGuides Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.2.22 MWHubs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.2.23 MWIrfs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.2.24 MWLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.2.25 MWLinkTypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
10.2.26 MWManufacturers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
10.2.27 MWMediumTypes Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
10.2.28 MWModulations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
10.2.29 MWMultiHops Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
10.2.30 MWMultiHopsLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
10.2.31 MWOperatingModes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
10.2.32 MWOTLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
10.2.33 MWPMP Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341

© 2018 Forsk. All Rights Reserved. 15


Atoll 3.4.0 Data Structure Reference Guide
Table of Contents

10.2.34 MWPorts Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342


10.2.35 MWRepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
10.2.36 MWSubbands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
10.2.37 MWTplHubs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
10.2.38 MWTplLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
10.2.39 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
10.2.40 PropagationModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
10.2.41 Sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
10.2.42 SitesLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
10.2.43 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
10.2.44 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
10.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350

11 Radio Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353


11.1 XML Import/Export Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
11.1.1 Index.xml File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
11.1.2 XML File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
11.2 RF 2D Antenna Pattern Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
11.3 Import Format of 3D Antenna Pattern Text Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
11.4 Microwave 2D Antenna Pattern Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358

16 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Introduction

Introduction

This Data Structure Reference Guide provides reference material covering the Atoll database structure and file
format for database administrators and advanced users.

About Atoll

Atoll is a multi-technology wireless network design and optimisation platform that supports wireless operators
throughout the network lifecycle, from initial design to densification and optimisation. Atoll offers unique
capabilities of using both predictions and live network data throughout the network planning and optimisation
process.
Atoll includes integrated single RAN–multiple RAT network design capabilities for both 3GPP and 3GPP2 radio
access technologies including 5G NR, LTE, NB-IoT, UMTS, GSM, and CDMA. It provides operators and vendors with
a powerful framework for designing and optimising current and future integrated multi-technology networks.
Atoll supports the latest technology advances such as massive MIMO, 3D beamforming, and mmWave propagation
for the design and roll-out of 5G networks.
Atoll’s integration and customisation features help operators smoothly streamline planning and optimisation
processes. Atoll supports a wide range of implementation scenarios, from standalone to enterprise-wide server-
based configurations. Atoll has become the industry standard for radio network planning and optimisation.
If you are interested in learning more about Atoll, please contact your Forsk representative to inquire about our
training solutions.

About Forsk

Forsk is an independent software company providing operators and vendors with wireless network design and
optimisation products. Atoll, Forsk’s flagship product, is the market-leading wireless network planning and
optimisation software on the market; it allows operators to streamline planning and optimisation activities by
combining predictions and live network data.
With more than 9000 active licenses installed with 500+ customers in 140 countries, Atoll has become the industry
standard for wireless network design and optimisation.
Forsk distributes and supports Atoll directly from offices and technical support centres in France, USA, and China
as well as through a worldwide network of distributors and partners.

Getting Help
The online help system that is installed with Atoll is designed to give you quick access to the information you need
to use the product effectively. It contains the same material as the Atoll 3.4.0 User Manual.
You can browse the online help from the Contents view, the Index view, or you can use the built-in Search feature.
You can also download manuals from the Forsk web site at:
http://www.forsk.com/support/

© 2018 Forsk. All Rights Reserved. 17


Atoll 3.4.0 Data Structure Reference Guide
Introduction

Printing Help Topics

You can print individual topics or chapters from the online help.
To print help topics or chapters:
1. In Atoll, click Help > Help Topics.
2. In the Contents tab, expand the table of contents.
3. Right-click the section or topic that you want to print and click Print. The Print Topics dialog box appears.
4. In the Print Topics dialog box, select what you want to print:
 If you want to print a single topic, select Print the selected topic.
 If you want to print an entire section, including all topics and sections in that section, select Print the
selected heading and all subtopics.
5. Click OK.

About Atoll Documentation

The following PDF manuals are available to customers with a valid maintenance contract for Atoll and Atoll
Microwave and can be downloaded from the Forsk web site at:
http://www.forsk.com/support/
 Atoll User Manual
 Atoll Administrator Manual
 Atoll Licensing Guide
 Atoll Data Structure Reference Guide
 Atoll Technical Reference Guide
 Atoll Task Automation Guide
 Atoll Model Calibration Guide
To read PDF manuals, download Adobe Reader from the Adobe web site at:
http://get.adobe.com/reader/
Hardcopy manuals are also available. For more information, contact to your Forsk representative.

Contacting Technical Support

Forsk provides global technical support for its products and services. To contact the Forsk support team, visit the
My Forsk web site at:
http://www.forsk.com/support/
Alternatively, depending on your geographic location, contact one of the following support teams:

Forsk US
For North and Central America, contact the Forsk US support team:
 Tel.: 1-888-GO-ATOLL (1-888-462-8655)
 Fax: 1-312-674-4822
 Email: support_us@forsk.com
Opening Hours: Monday to Friday 8.00 am to 8.00 pm (Eastern Standard Time)

Forsk China
For Asia (except Japan), contact the Forsk China support team:
 Tel: +86 20 8557 0016

18 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Introduction

 Fax: +86 20 8553 8285


 Email: atollsupport@forsk.com.cn
Opening Hours: Monday to Friday 9.00am to 5.30pm (GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi.

Forsk Head Office


For all other regions, contact the Forsk Head Office support team:
 Tel.: +33 562 747 225
 Fax: +33 562 747 211
 Email: support@forsk.com
Opening Hours: Monday to Friday 9.00 am to 6.00 pm (GMT +1:00)

© 2018 Forsk. All Rights Reserved. 19


Atoll 3.4.0 Data Structure Reference Guide
Introduction

20 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

1 GSM GPRS EDGE Data Structure


Atoll supports integrated network planning for GSM GPRS EDGE networks. This section describes the GSM GPRS
EDGE data structure used in Atoll. It lists all the tables and fields found in the GSM GPRS EDGE template and the
relationships between them.

 Primary keys are listed in bold and italic characters.

1.1 Data Structure Changes from Atoll 3.3 to 3.4

1.1.1 Added Tables and Fields

FeederEquipments Table

Field Type Description Attributes

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

Sites Table

Field Type Description Attributes


ALIAS_ Text (60) Site alias. Nullable: Yes
Default:

Transmitters Table

Field Type Description Attributes


ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

TRGs Table

Field Type Description Attributes

MIN_MAL_LENGTH Integer Minimum MAL (mobile allocation list) length. Nullable: Yes
Default: 2

© 2018 Forsk. All Rights Reserved. 21


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

1.1.2 Deleted Tables and Fields

 ChannelModels table

1.2 Data Structure

1.2.1 AfpModels Table

For AFP models.

Field Type Description Attributes

DATA Binary AFP model parameter settings. Nullable: Yes


Default:
DESCRIPTION Text (255) Additional information about the AFP model. Nullable: Yes
Default:

NAME Text (50) Name of the AFP model. Nullable: No


Default:

SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:
TYPE Text (50) ProgID of the model. Nullable: No
Default:

1.2.2 Antennas Table

For antennas.

Field Type Description Attributes

BEAMWIDTH Float The half-power beamwidth of the antenna model. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the antenna model. Nullable: Yes
Default:

CONSTRUCTOR Text (50) Name of the antenna manufacturer. Nullable: Yes


Default:
DIAGRAM Binary Antenna horizontal and vertical patterns. Nullable: Yes
Default:

ELECTRICAL_AZIMUTH Float The electrical azimuth of the antenna model. Nullable: Yes
Default:

ELECTRICAL_TILT Float The electrical tilt of the antenna model. Nullable: Yes
Default:
FMAX Double Maximum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:

22 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

FMIN Double Minimum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:

GAIN Float Antenna model gain compared to an isotropic radiator. Unit: dBi. Nullable: No
Default: 0

NAME Text (50) Name of the antenna model. Nullable: No


Default:
PHYSICAL_ANTENNA Text (50) Name of the physical antenna to which the antenna model belongs. Nullable: Yes
Default:

 The format of the binary field, DIAGRAM, is described in "RF 2D Antenna Pattern
Format" on page 355.

1.2.3 BSICDomains Table

For names of BSIC domains.

Field Type Description Attributes


NAME Text (50) Name of the BSIC domain. Nullable: No
Default:

1.2.4 BSICGroups Table

For BSIC groups belonging to BSIC domains.

Field Type Description Attributes


DOMAIN_NAME Text (50) Name of the BSIC domain. Nullable: No
Default:

EXCLUDED Text (225) List of BSICs not belonging to the group. Nullable: Yes
Default:

EXTRA Text (225) List of additional BSICs belonging to the group. Nullable: Yes
Default:
FIRST Integer First BSIC belonging to the group. Nullable: Yes
Default: 0

LAST Integer Last BSIC belonging to the group. Nullable: Yes


Default: 0

NAME Text (50) Name of the BSIC group. Nullable: No


Default:
STEP Integer Step between the first and last BSIC belonging to the group. Nullable: Yes
Default: 1

 The FIRST and LAST fields of this table are of type Integer in the template (.mdb)
and in a database (if connected to one). But these fields are of type Text when
accessed or retrieved from an add-in.

© 2018 Forsk. All Rights Reserved. 23


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

1.2.5 BTSEquipments Table

For BTS equipment.

Field Type Description Attributes

CONFIG_DL_LOSSES Float Downlink losses due to transmitter components (duplexer, combiner, etc.). Nullable: Yes
Unit: dB. Default: 0

CONFIG_UL_LOSSES Float Uplink losses due to transmitter components (duplexer, combiner, etc.). Unit: Nullable: Yes
dB. Default: 0

NAME Text (50) Name of transmitter equipment. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of transmitter equipment. Unit: dB. Nullable: Yes
Default: 0

RHO_FACTOR Short CDMA rho factor for self interference (not used in other technologies). Nullable: Yes
Default: 100

1.2.6 CellTypes Table

For cell types.

Field Type Description Attributes

NAME Text (50) Name of the cell type. Nullable: No


Default:

1.2.7 CodecEquipments Table

For codec configurations.

Field Type Description Attributes

IDEAL_LINK_ADAPTATION Boolean Whether ideal link adaptation is used or not. True=Yes; False=No. Nullable: No
Default: True
IDEAL_QI_NAME Text (20) Name of the quality indicator used for ideal link adaptation. Nullable: Yes
Default:

NAME Text (50) Name of codec equipment. Nullable: No


Default:

REFERENCE_NOISE Float Receiver reference noise. Nullable: No


Default: -113

1.2.8 CodecModeAdaptations Table

For codec mode selection.

24 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

CODEC_EQT Text (50) Name of the codec equipment. Nullable: No


Default:

CODEC_MODE Text (50) Name of the codec mode. Nullable: No


Default:
FREQUENCY_BAND Text (20) Name of the frequency band corresponding to the codec mode adaptation Nullable: Yes
thresholds. Default:

HOPPING Short Frequency hopping mode corresponding to the codec mode adaptation Nullable: Yes
thresholds. 1=No; 2=Ideal. Default:

MAL_LENGTH Integer Length of the mobile allocation list. Nullable: Yes


Default:
MIN_CIR Float C/I threshold for codec mode selection without ideal link adaptation. Unit: dB. Nullable: Yes
Default: 0

MOBILITY Text (50) Mobility type corresponding to the codec mode adaptation thresholds. Nullable: Yes
Default:

1.2.9 CodecModes Table

For codec types and modes.

Field Type Description Attributes

_8PSK_MODULATION Boolean Whether 8PSK modulation is used or not. True=Yes; False=No. Nullable: No
Default: False
CODEC_TYPE Text (50) Name of codec type Nullable: No
Default:

HR Boolean Whether the codec mode is a half-rate mode. True=Yes; False=No. Nullable: No
Default: False

MAX_RATE Float Maximum supported throughput of the codec mode. Unit: kbps. Nullable: No
Default: 0

NAME Text (50) Name of the codec mode. Nullable: No


Default:
SELECTION_PRIORITY Short Codec mode selection priority. Nullable: No
Default: 0

1.2.10 CodecQualityTables Table

For codec performance graphs.

Field Type Description Attributes

C_I_TABLE Memo Codec quality indicator graphs as a function of the C/I. Nullable: Yes
Default:

C_N_TABLE Memo Codec quality indicator graphs as a function of the C/N. Nullable: Yes
Default:
CODEC_EQT Text (50) Name of the codec equipment. Nullable: No
Default:

CODEC_MODE Text (50) Name of the codec mode. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 25


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

FREQUENCY_BAND Text (20) Name of the frequency band corresponding to the codec quality graphs. Nullable: Yes
Default:

HOPPING Short Frequency hopping mode corresponding to the codec quality graphs. 1=No; Nullable: Yes
2=Ideal. Default:

MAL_LENGTH Integer Length of the mobile allocation list. Nullable: Yes


Default:
MOBILITY Text (50) Mobility type corresponding to the codec mode quality graph. Nullable: Yes
Default:

QI_NAME Text (20) Name of the quality indicator. Nullable: No


Default:

1.2.11 CoordSys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

Field Type Description Attributes

CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default: 0
DATUM_CODE Double Identification code of the datum. Nullable: Yes
Default: 0

DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0
DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0

DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes


Default: 0

DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes


Default: 0
DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes
Default: 0

ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No


Default: 0

ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes


Default: 0
ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes
Default: 0

GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:

PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes


Default: 0
PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes
Default: 0

26 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes


Default: 0

PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0
PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes


Default: 0

1.2.12 CustomFields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:

CHOICE_LIST Memo Choice list for text fields. Nullable: Yes


Default:
CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default: 0

COLUMN_NAME Text (50) Name of the custom field. Nullable: No


Default:

DEFAULT_VALUE Text (50) Default value for the field. Nullable: Yes
Default:
DISPLAY_TYPE Integer Whether the field is hypertext or regular and modifiable or read-only. Nullable: Yes
0=Regular and modifiable; 1=Regular and read-only; 2=Hypertext and mod- Default: 0
ifiable; 3=Hypertext and read-only

GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:
TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.

© 2018 Forsk. All Rights Reserved. 27


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.
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


 Table and field names are case sensitive.
 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any 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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the
appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

1.2.13 EGPRSCodingSchemes Table

For GPRS, EGPRS, and EGPRS2 coding schemes.

28 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

CS_NUMBER Short Coding scheme number. Nullable: No


Default: 1

DATA_CODING Short Type of FEC coding. 0=Convolutional; 1=Turbo. Nullable: No


Default: 0
MAX_THROUGHPUT Float Maximum throughput of the coding scheme. Unit: kbps. Nullable: No
Default: 1

MODULATION Short Modulation. 0=GMSK; 1=8-PSK; 2=QPSK; 3=16QAM; 4=32QAM. Nullable: No


Default: 0

NAME Text (50) Name of the coding scheme. Nullable: No


Default:
TECHNOLOGY Text (15) Coding scheme technology. GPRS; GPRS/EDGE; EGPRS2. Nullable: No
Default: ’GPRS’

1.2.14 EGPRSDimensioningModel Table

For network dimensioning models.

Field Type Description Attributes

MAX_CHANNELS Text (4) Maximum number of TRXs that can be allocated to a transmitter. Nullable: No
Default: ’16’

MAX_TRXS_TO_ADD_FOR_PA Integer Maximum number of TRXs to add for packet-switched services. Nullable: Yes
CKET Default: 100
MIN_DEDICATED_PDCH Integer Minimum number of timeslots dedicated to packet-switched traffic. Nullable: No
Default: 0

NAME Text (50) Name of the service. Nullable: No


Default:

PDCH_BLOCKING_PROBA_KP Boolean Whether the dimensioning model takes the blocking probability into account Nullable: No
I or not. True=Yes; False=No. Default: False

PDCH_DELAY_KPI Boolean Whether the dimensioning model takes the service delay into account or not. Nullable: No
True=Yes; False=No. Default: False
PDCH_THROUGHPUT_MIN_K Boolean Whether the dimensioning model takes the minimum throughput into Nullable: No
PI account or not. True=Yes; False=No. Default: True

QUEUING_MODEL Text (50) Queuing model. Erlang B; Erlang C. Nullable: Yes


Default: ’Erlang B’

1.2.15 EGPRSEnvironmentDefs Table

For traffic environment types.

© 2018 Forsk. All Rights Reserved. 29


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

DENSITY Float Number of users per km2. Nullable: Yes


Default: 0

ENVIRONMENT Text (50) Name of the traffic environment. Nullable: No


Default:
MOBILITY Text (50) Mobility type corresponding to the traffic environment. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the traffic environment. Nullable: No
Default:

1.2.16 EGPRSEquipments Table

For GPRS, EGPRS, and EGPRS2 configurations.

Field Type Description Attributes

NAME Text (50) Name of the equipment. Nullable: No


Default:
REFERENCE_NOISE Float Receiver reference noise. Nullable: Yes
Default: -113

TECHNOLOGY Text (15) Equipment technology. GPRS; GPRS/EDGE. Nullable: Yes


Default: GPRS

1.2.17 EGPRSMobility Table

For mobility types.

Field Type Description Attributes

NAME Text (50) Name of mobility type. Nullable: No


Default:

SPEED Float Average user speed corresponding to the mobility type. Unit: km/h. Nullable: No
Default:

1.2.18 EGPRSQuality Table

For GPRS, EGPRS, and EGPRS2 performance graphs.

Field Type Description Attributes

C_THRESHOLD Float Coding scheme selection threshold (C). Nullable: Yes


Default: 1

C_THROUGHPUTS Memo Throughput graphs as a function of the received power. Nullable: Yes
Default:

COVERI_THRESHOLD Float Coding scheme selection threshold (C/I). Unit: dB. Nullable: Yes
Default: 1
COVERI_THROUGHPUTS Memo Throughput graphs as a function of the C/I. Nullable: Yes
Default: ’0’

CS_NAME Text (10) Name of the coding scheme. Nullable: Yes


Default:

30 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

EQUIPMENT Text (50) Name of the GPRS/EDGE configuration. Nullable: No


Default:

FREQUENCY_BAND Text (20) Name of the frequency band corresponding to the coding scheme quality Nullable: Yes
graphs. Default:

HOPPING Short Frequency hopping mode corresponding to the coding scheme quality Nullable: Yes
graphs. 1=No; 2=Ideal. Default:
MAL_LENGTH Integer Length of the mobile allocation list. Nullable: Yes
Default:

MOBILITY Text (50) Mobility type corresponding to the coding scheme quality graph. Nullable: Yes
Default:

1.2.19 EGPRSServiceQuality Table

For graphs used for the packet-switched traffic dimensioning.

Field Type Description Attributes

AVAIL_CONNECTIONS Float Number of available connections. Nullable: Yes


Default: 1
DIMENSIONING_MODEL Text (50) Name of the dimensioning model. Nullable: No
Default:

LOAD_BLOCKING_PROBA Memo Blocking probability graphs as function of the traffic load. Nullable: Yes
Default: ’1’

LOAD_DELAY Memo Delay graphs as function of the traffic load. Nullable: Yes
Default: ’1’

LOAD_RF Memo Throughput reduction factor graphs as function of the traffic load. Nullable: Yes
Default: ’1’

1.2.20 EGPRSServices Table

For services.

Field Type Description Attributes

DL_ACTIVITY Float Activity factor for voice services on the downlink. Nullable: Yes
Default: 1

DL_MBR Float Downlink maximum bit rate. Unit: kbps. Nullable: Yes
Default: 0

MAX_BLOCKING_RATE Float Maximum probability that a packet is blocked (delayed). GoS for circuit- Nullable: Yes
switched services. Default: 2
MAX_DELAY Float Maximum delay allowed for the service. Nullable: Yes
Default: 1

MAX_TS_SUPPORT Integer Maximum number of timeslots supported by the service. Nullable: Yes
Default: 4

MIN_THROUGHPUT Float Downlink guaranteed bit rate. Unit: kbps. Nullable: Yes
Default: 15
MIN_THROUGHPUT_RATIO Float Dimensioning target of the percentage of surface where the guaranteed bit Nullable: Yes
rate is reached. Default: 95

MIN_THROUGHPUT_UL Float Uplink guaranteed bit rate. Unit: kbps. Nullable: Yes
Default: 15

© 2018 Forsk. All Rights Reserved. 31


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

NAME Text (50) Name of the service. Nullable: No


Default:

PRIORITY Short Service priority. 0=Lowest. Nullable: Yes


Default: 0

REQ_AVERAGE_UL_RATE Float Average requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default:
TH_OFFSET Float Fixed offset to map throughput to the application layer. Nullable: Yes
Default: 0

TH_SCALE_FACTOR Float Ratio between application throughput and MAC layer throughput. Nullable: Yes
Default: 95

TYPE Short Type of service. 0=Circuit; 1=Packet (max bit rate); 2=Packet (constant bit Nullable: No
rate). Default: 0
UL_ACTIVITY Float Activity factor for voice services on the uplink. Nullable: Yes
Default: 1

UL_MBR Float Uplink maximum bit rate. Unit: kbps. Nullable: Yes
Default: 0

1.2.21 EGPRSServicesUsage Table

For user profile parameters.

Field Type Description Attributes

CALL_DURATION Float Average duration of a call for circuit-switched services. Unit: s. Nullable: Yes
Default:

CALL_NUMBER Float Average number of calls per hour for circuit-switched services or average Nullable: Yes
number of sessions per hour for packet-switched services. Default: 0
DL_VOLUME Float Data volume transferred on the downlink during a session for packet- Nullable: Yes
switched services. Unit: kB. Default:

SERVICE Text (50) Name of the service corresponding to the user profile. Nullable: No
Default:

TERMINAL Text (50) Name of the terminal corresponding to the user profile. Nullable: No
Default:
UL_VOLUME Float Data volume transferred on the uplink during a session for packet-switched Nullable: Yes
services. Unit: kB. Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the user profile. Nullable: No
Default:

1.2.22 EGPRSTerminals Table

For terminal types.

32 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

CODEC_EQUIPMENT Text (50) Name of the codec equipment. Nullable: Yes


Default:

DL_AVAIL_CARRIERS Short Number of simultaneous carriers. Nullable: Yes


Default: 1
DL_AVAIL_TIME_SLOT Float Number of timeslots the terminal can multiplex in downlink. Nullable: Yes
Default: 1

DTX Boolean Whether the terminal uses discontinuous transmission or not. True=Yes; Nullable: No
False=No. Default: True

EGPRS_EQUIPMENT Text (50) Name of the equipment used by the GPRS/EDGE transmitter. Nullable: Yes
Default:
GAIN Float Terminal antenna gain. Unit: dB. Nullable: Yes
Default: 0

LOSS Float Terminal antenna loss. Unit: dB. Nullable: Yes


Default: 0

MAX_CS Short Highest coding scheme (CS) available for GPRS. Nullable: Yes
Default: 4
MAX_MCS Short Highest coding scheme (MCS) available for EDGE. Nullable: Yes
Default: 12

NAME Text (50) Name of the terminal. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8
PMAX Float Maximum transmission power of the terminal. Nullable: Yes
Default: 33
PMIN Float Minimum transmission power of the terminal. Nullable: Yes
Default: -40

PRIMARY_BAND Text (50) Primary frequency band. Nullable: No


Default:

SAIC Boolean Whether the terminal supports single antenna interference cancellation or Nullable: No
not. True=Yes; False=No. Default: False
SECONDARY_BAND Text (50) Secondary frequency band. Nullable: Yes
Default:

TECHNOLOGY Text (15) Terminal technology. GSM; GPRS; GPRS\EDGE. Nullable: Yes
Default:

1.2.23 EGPRSTrafficEnvironments Table

For traffic environment clutter weighting.

Field Type Description Attributes

CLUTTER_WEIGHTS Binary Clutter weighting for traffic environment maps. Nullable: Yes
Default:
NAME Text (50) Name of the traffic environment. Nullable: No
Default:

© 2018 Forsk. All Rights Reserved. 33


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

1.2.24 EGPRSUserProfiles Table

For names of user profiles.

Field Type Description Attributes

NAME Text (50) Name of the user profile. Nullable: No


Default:

1.2.25 FeederEquipments Table

For feeders.

Field Type Description Attributes

CONNECTOR_LOSSES_DL Float Feeder connector losses in downlink. Unit: dB. Nullable: Yes
Default: 0

CONNECTOR_LOSSES_UL Float Feeder connector losses in uplink. Unit: dB. Nullable: Yes
Default: 0
LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes
Default:

LOSS_PER_METER Float Feeder loss per meter. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the feeder. Nullable: No


Default:

1.2.26 FrequencyBands Table

For frequency bands.

Field Type Description Attributes

CHANNEL_WIDTH Double Channel width. Unit: kHz. Nullable: No


Default: 1
EXCLUDED_CHANNELS Text (255) List of channel numbers not part of the usable spectrum. Nullable: Yes
Default:

FIRST_CHANNEL Integer First channel number in the frequency band. Nullable: No


Default: 0

FREQUENCY Double Downlink start frequency of the first channel of the frequency band. Unit: Nullable: No
MHz. Default: 1000
LAST_CHANNEL Integer Last channel number in the frequency band. Nullable: No
Default: 0

MAX_CHANNEL_NUM Integer Extended channel offset for E-GSM. Nullable: Yes


Default:

MULTIPLEX_FACTOR Integer Number of timeslots per channel. Nullable: No


Default: 1
NAME Text (20) Name of the frequency band. Nullable: No
Default:

34 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

1.2.27 FrequencyDomains Table

For frequency bands belonging to frequency domains.

Field Type Description Attributes

FREQUENCY_BAND_NAME Text (50) Name of the frequency band on which domain is based. Nullable: No
Default:

NAME Text (50) Name of the frequency domain. Nullable: No


Default:

1.2.28 FrequencyGroups Table

For frequency groups belonging to frequency domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the frequency domain. Nullable: No


Default:
EXCLUDED Text (255) List of frequencies not belonging to the group. Nullable: Yes
Default:

EXTRA Text (225) List of additional frequencies belonging to the group. Nullable: Yes
Default:

FIRST Integer First frequency belonging to the group. Nullable: Yes


Default: 0
LAST Integer Last frequency belonging to the group. Nullable: Yes
Default: 0

NAME Text (50) Name of the frequency group. Nullable: No


Default:

STEP Integer Step between the first and last frequency belonging to the group. Nullable: Yes
Default: 1

1.2.29 HSNDomains Table

For names of HSN domains.

Field Type Description Attributes

NAME Text (50) Name of the HSN domain. Nullable: No


Default:

1.2.30 HSNGroups Table

For HSN groups belonging to HSN domains.

© 2018 Forsk. All Rights Reserved. 35


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the HSN domain. Nullable: No


Default:

EXCLUDED Text (225) List of HSNs not belonging to the group. Nullable: Yes
Default:
EXTRA Text (225) List of additional HSNs belonging to the group. Nullable: Yes
Default:

FIRST Integer First HSN belonging to the group. Nullable: Yes


Default: 0

LAST Integer Last HSN belonging to the group. Nullable: Yes


Default: 0
NAME Text (50) Name of the HSN group. Nullable: No
Default:

STEP Integer Step between the first and last HSN belonging to the group. Nullable: Yes
Default: 1

1.2.31 InterNetChProtect Table

For inter-network interference reduction factor graphs.

Field Type Description Attributes

ICP Memo Inter-RAT interference reduction graph as a function of frequency difference Nullable: Yes
between channels. Default:
ITF_BW Double Channel width of the interferer cell. Unit: kHz. Nullable: No
Default: 0

ITF_TECHNO Text (50) Technology of the interfering cell. Nullable: No


Default:

V_BW Double Channel width of the interfered cell. Unit: kHz. Nullable: No
Default: 0

1.2.32 Layers Table

For HCS layers.

Field Type Description Attributes

MAX_SPEED Float Maximum user speed supported by the layer. Unit: km/h. Nullable: Yes
Default: 300
MIN_PRIORITY_POWER Float Minimum power value for the HCS layer. Nullable: Yes
Default: -130

NAME Text (50) Name of the network layer. Nullable: No


Default:

PRIORITY Short Layer priority. 0=Lowest. Nullable: No


Default: 1

1.2.33 Neighbours Table

For intra-technology neighbour relations.

36 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (100) Name of the neighbour transmitter. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (100) Name of the source transmitter. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

1.2.34 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour transmitter. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source transmitter. Nullable: No


Default:

1.2.35 NeighboursConstraintsExt Table

For inter-technology neighbour allocation constraints.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour transmitter. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source transmitter. Nullable: No


Default:

1.2.36 NeighboursExt Table

For inter-technology neighbour relations.

© 2018 Forsk. All Rights Reserved. 37


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (100) Name of the neighbour transmitter. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (100) Name of the source transmitter. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

1.2.37 Networks Table

For network-level parameters.

Field Type Description Attributes

DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes


Default:
DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No
Default: 50

DMAX Float Maximum radius for a cell. Nullable: No


Default: -1

INTERFERERS_RX_THRESH Float Lowest received interference level. Nullable: Yes


Default: -130

NAME Text (50) Name of the network. Nullable: No


Default:
SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:

SYSTEM_ Text (50) Name of the system. Nullable: No


Default: ‘GSM’
TECHNOLOGY Text (10) Name of the technology. Nullable: No
Default: ‘TDMA’

THERMAL_NOISE Float Thermal noise. Nullable: Yes


Default: -121

1.2.38 PropagationModels Table

For propagation models.

38 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

DATA Binary Propagation model parameter settings. Nullable: Yes


Default:

DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:
NAME Text (50) Name of the propagation model. Nullable: No
Default:

SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

TYPE Text (50) ProgID of the model. Nullable: No


Default:

1.2.39 QualityIndicators Table

For quality indicators (BER, BLER, etc.).

Field Type Description Attributes

CS_QI Boolean Whether the quality indicator is used for circuit-switched services or not. Nullable: No
True=Yes; False=No. Default: True

MEAS_PARAM Short Measurement on which the quality indicator is based. 1=C; 2=CIR. Nullable: Yes
Default: 1

NAME Text (20) Name of the quality indicator. Nullable: No


Default:
PS_QI Boolean Whether the quality indicator is used for packet-switched services or not. Nullable: No
True=Yes; False=No. Default: True

USE_INTERPOLATION Boolean Whether interpolation can be used for the quality indicator graph to find val- Nullable: No
ues between defined ones. True=Yes; False=No. Default: True

1.2.40 Receivers Table

For receiver parameters.

Field Type Description Attributes

ADJ_CHANNEL_PROT Float Adjacent channel interference reduction (ACIR = 1/(1/ACS + 1/ACLR)). Unit: Nullable: No
dB. Default: 18

ANTENNA Text (50) Antenna model of the default receiver. If not defined, an isotropic receiver is Nullable: Yes
used. Default:
HEIGHT Float Height of the default receiver. Nullable: No
Default: 1.5

LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0

NAME Text (50) Name of the default receiver. Nullable: No


Default:

1.2.41 RepeaterEquipments Table

For repeater equipment.

© 2018 Forsk. All Rights Reserved. 39


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the repeater equipment. Nullable: Yes
Default:

MANUFACTURER Text (50) Name of the repeater equipment manufacturer. Nullable: Yes
Default:
MAX_AMPLIFIER_GAIN Float Maximum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 90

MAX_OUTPUT_DL Float Maximum downlink output power. Nullable: Yes


Default: 30

MAX_OUTPUT_UL Float Maximum uplink output power. Nullable: Yes


Default: 12
MIN_AMPLIFIER_GAIN Float Minimum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 50

NAME Text (50) Name of the repeater equipment. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the repeater equipment. Unit: dB. Nullable: Yes
Default: 5
STEP_AMPLIFIER_GAIN Float Step of amplifier gain. Unit: dB. Nullable: Yes
Default: 1

TIME_DELAY Float Processing delay of the repeater equipment. Unit: us. Nullable: Yes
Default: 5

1.2.42 Repeaters Table

For repeaters.

Field Type Description Attributes

AMPLIFIER_GAIN Float Repeater amplifier gain. Unit: dB. Nullable: Yes


Default: 80

AZIMUT Float Azimuth of the donor side antenna. Nullable: Yes


Default: 0
DONOR_CELLID Text (100) Name of the donor transmitter. Nullable: No
Default:

DONOR_LINK_LOSS Float Loss over the donor-repeater link. Unit: dB. Nullable: Yes
Default: 0

DONOR_LINK_TYPE Short Type of the donor-repeater link. 1=Off air; 2=Microwave; 3=Fibre. Nullable: No
Default: 1
DONOR_PROPAG_MODEL Text (50) Name of the propagation model used for the donor-repeater link. Nullable: Yes
Default:

DOWNTILT Float Downtilt of the donor side antenna. Nullable: Yes


Default: 0

EIRP Float Repeater’s effective isotropic radiated power. Nullable: Yes


Default: 0
EQUIPMENT_NAME Text (50) Name of the repeater equipment. Passive repeaters do not have equipment Nullable: Yes
(no amplification). Default:

FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:

FEEDERLENGTH Float Length of donor side downlink feeder. Nullable: Yes


Default: 0

40 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

HEIGHT Float Height of the donor side antenna. Nullable: Yes


Default: 25

REC_ANTENNA Text (50) Name of the donor side antenna model. Nullable: Yes
Default:

REC_FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes


Default: 0
TX_ID Text (100) Name of the repeater. Nullable: No
Default:

 Repeater properties are saved in two tables: the donor-side parameters are in
 the Repeaters table and the coverage-side parameters in the Transmitters
table.
 The repeater EIRP taken into account in calculations is stored in the
Repeaters table (the EIRP column of the Transmitters table is not used).

1.2.43 SecondaryAntennas Table

For additional antennas.

Field Type Description Attributes

ANTENNA Text (50) Name of the secondary antenna model installed on a transmitter. Nullable: No
Default:
AZIMUT Float Azimuth of the secondary antenna. Nullable: No
Default: 0

PERCENT_POWER Float Percentage of power dedicated to the secondary antenna. Nullable: No


Default: 0

REDT Float Remote electrical tilt of the secondary antenna. Nullable: Yes
Default: 0

TILT Float Mechanical downtilt of the secondary antenna. Nullable: No


Default: 0
TX_ID Text (100) Name of the transmitter on which the secondary antenna is installed. Nullable: No
Default:

1.2.44 SeparationRules Table

For default separation constraints between each type of subcells.

Field Type Description Attributes

DEFAULT_MIN_SEP Short Minimum required separation between allocated frequency channels. Nullable: No
Default: 1

RELATION_TYPE Short Type of the relation. 1=Co-subcell; 2=Co-transmitter; 3=Co-site; 4=Neigh- Nullable: No
bour. Default: 1
TRX_TYPE Text (15) First TRX type. Nullable: No
Default: ’All’

TRX_TYPE_OTHER Text (15) Second TRX type. Nullable: No


Default: ’All’

© 2018 Forsk. All Rights Reserved. 41


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

1.2.45 Separations Table

For separation constraints between types of subcells.

Field Type Description Attributes

MIN_SEP Integer Minimum required frequency channel separation. Nullable: No


Default: 1

TRX_TYPE Text (15) First TRX type. Nullable: No


Default: “All”

TRX_TYPE_OTHER Text (15) Second TRX type. Nullable: No


Default: “All”
TX_ID Text (100) Name of the first transmitter. Nullable: No
Default:

TX_ID_OTHER Text (100) Name of the second transmitter. Nullable: No


Default:

1.2.46 Sites Table

For sites.

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:
ALTITUDE Float User-defined site altitude. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0
NAME Text (50) Name of the site. Nullable: No
Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50

SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

1.2.47 SitesLists Table

For sites belonging to site lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the site list. Nullable: No


Default:

SITE_NAME Text (60) Name of the sites belonging to the list. Nullable: No
Default:

42 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

1.2.48 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

1.2.49 TMAEquipments Table

For tower-mounted amplifiers.

Field Type Description Attributes

DL_LOSSES Float Downlink losses of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the tower mounted amplifier. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

UL_GAIN Float Uplink gain of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

1.2.50 TplTransmitters Table

For station templates.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default:

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: Yes
Default:
AZIMUT Float Azimuth of the main antenna. Nullable: No
Default:

BSIC_DOMAIN Text (50) Name of the base station identity code domain. Nullable: Yes
Default:

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:
CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default:

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CELL_RESELECT_OFFSET Integer Cell reselection offset. Unit: dB. Nullable: Yes


Default:

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default:

© 2018 Forsk. All Rights Reserved. 43


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

CELL_TYPE Text (50) Type of cell. Nullable: Yes


Default:

CODEC_EQUIPMENT Text (50) Name of the codec equipment. Nullable: Yes


Default:

CODING_SCHEME_NUMBER Short The highest coding scheme supported by the GPRS/EDGE transmitters. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

EGPRS_EQUIPMENT Text (255) Name of the equipment used by the GPRS/EDGE transmitter. Nullable: Yes
Default:

EIRP Float Transmitter’s effective isotropic radiated power. Nullable: Yes


Default:
ENABLE_EGPRS Boolean Whether the transmitter uses GPRS/EDGE or not. True=Yes; False=No. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder equipment. Nullable: Yes


Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default:
FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes
Default:

FN_OFFSET Integer Frame number offset. Nullable: Yes


Default:

HEIGHT Float Antenna height above the ground. Nullable: No


Default:

LAYER Text (50) Name of the network layer. Nullable: Yes


Default:
LAYER_RECEPTION_THRESH Float Minimum received power for admittance on a layer. Nullable: Yes
OLD Default:

LOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default:

MAX_EXT_NEIGHB_NUMBER Short Maximum number of inter-technology neighbours for the transmitter. Nullable: Yes
Default:
MAX_NEIGHB_NUMBER Short Maximum number of intra-technology neighbours for the transmitter. Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:

MIN_RANGE Integer Minimum coverage range. Nullable: Yes


Default:
MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes
Default:

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default:

NAME Text (50) Name of the station template. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default:

NUM_SECTORS Integer Number of sectors in the station template. Nullable: Yes


Default: 3

PBCCH_CELL_RESELECT_OFF Integer Cell reselection offset for GPRS/EDGE transmitter using PBCCH. Nullable: Yes
SET Default:

44 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

PBCCH_IN_USE Boolean Whether a GPRS/EDGE transmitter used PBCCH or not. True=Yes; False=No. Nullable: No
Default:

PBCCH_RECEPTION_THRESH Float Reception threshold value for GPRS/EDGE cells using PBCCH. Nullable: Yes
OLD Default:

POWER Float Transmission power. Nullable: Yes


Default:
PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:

PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default:
REQ_CHANNELS Integer Number of required frequency channels. Nullable: Yes
Default:

REUSE_DISTANCE Float Minimum reuse distance for resource allocation by the AFP. Nullable:
Default:

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable:
Default:
SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:

SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable:


Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default:
TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TRX_MAX_NUMBER Short Maximum number of TRXs that can be allocated by TRX dimensioning. Nullable: Yes
Default:

TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default:

1.2.51 Transmitters Table

For transmitters.

Field Type Description Attributes


ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True
ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: Yes
Default:

AZIMUT Float Azimuth of the main antenna. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 45


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

BSIC Text (10) Base station identity code. Nullable: Yes


Default:

BSIC_DOMAIN Text (50) Name of the base station identity code domain. Nullable: Yes
Default:

BSIC_FROZEN Boolean Whether the AFP is allowed to modify the base station identity code or not. Nullable: No
True=No; False=Yes. Default: False
BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes
Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default: 4000

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default: 50

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CELL_IDENTITY Integer Cell identity. Nullable: Yes


Default:
CELL_RESELECT_OFFSET Integer Cell reselection offset. Unit: dB. Nullable: Yes
Default: 0

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default: 2000

CELL_TYPE Text (50) Type of cell. Nullable: Yes


Default:

CHANNELS Text (255) Physical channels used by the transmitter. Nullable: Yes
Default:
CODEC_EQUIPMENT Text (50) Name of the codec equipment. Nullable: Yes
Default:

CODING_SCHEME_NUMBER Integer The highest coding scheme supported by the GPRS/EDGE transmitters. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:
CONTROL_CHANNEL Integer Physical channel used as the broadcast control channel (BCCH). Nullable: Yes
Default:

COST_FACTOR Double Transmitter AFP weight. Nullable: Yes


Default: 1

DX Float X coordinate relative to the site location. Nullable: Yes


Default: 0
DY Float X coordinate relative to the site location. Nullable: Yes
Default: 0

EGPRS_EQUIPMENT Text (50) Name of the equipment used by the GPRS/EDGE transmitter. Nullable: Yes
Default:

EIRP Float Transmitter’s effective isotropic radiated power. Nullable: Yes


Default: 43
ENABLE_EGPRS Boolean Whether the transmitter uses GPRS/EDGE or not. True=Yes; False=No. Nullable: No
Default: False

FBAND Text (20) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder. Nullable: Yes


Default:

46 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default: 0

FN_OFFSET Integer Frame number offset. Nullable: Yes


Default: 0
FROZEN Boolean Whether the AFP is allowed to modify frequencies assigned to TRXs or not. Nullable: No
True=No; False=Yes. Default: False

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default: 25

HEXAGON_GROUP Text (50) Group of hexagons used to create the transmitter. Nullable: Yes
Default:
HOP_MODE Text (25) The hopping mode of the default traffic subcell of the transmitter. Nullable: Yes
Default:

HSN_FROZEN Boolean Whether the AFP is allowed to modify the HSN or not. True=No; False=Yes. Nullable: No
Default: False

LAYER Text (50) Name of the network layer. Nullable: Yes


Default:
LAYER_RECEPTION_THRESH Float Minimum received power for admittance on a layer. Nullable: Yes
OLD Default:

LOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the transmitter. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the transmitter. Nullable: Yes
Default:
MAX_RANGE Integer Maximum coverage range. Nullable: Yes
Default: 35000

MIN_RANGE Integer Minimum coverage range. Nullable: Yes


Default: 0

MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes


Default: 0
MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes
Default: 0

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default: 5

NUM_TRX Float The total number of TRXs in the transmitter. Nullable: Yes
Default: 0
PBCCH_CELL_RESELECT_OFF Integer Cell reselection offset for GPRS/EDGE transmitter using PBCCH. Nullable: Yes
SET Default: 0

PBCCH_IN_USE Boolean Whether a GPRS/EDGE transmitter used PBCCH or not. True=Yes; False=No. Nullable: No
Default: False

PBCCH_RECEPTION_THRESH Float Reception threshold value for GPRS/EDGE cells using PBCCH. Nullable: Yes
OLD Default: -102
POWER Float Transmission power. Nullable: Yes
Default:

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default: ’Default model’

PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

© 2018 Forsk. All Rights Reserved. 47


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default: 0

REQ_CHANNELS Integer Number of required TRXs. Nullable: Yes


Default: 1

REUSE_DISTANCE Float Minimum reuse distance for resource allocation by the AFP. Nullable: Yes
Default:
RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:
SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes
Default: 0

SITE_NAME Text (60) Name of the site on which the transmitter is located. Nullable: No
Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default: 0
TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TRX_MAX_NUMBER Short Maximum number of TRXs that can be allocated by TRX dimensioning. Nullable: Yes
Default: 16

TX_ID Text (100) Name of the transmitter. Nullable: No


Default:

TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default: 0
USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

1.2.52 TRGConfigurations Table

For subcell types.

Field Type Description Attributes

_8PSK_PWBCKFF Float Power reduction due to higher order modulation. Unit: dB. Nullable: Yes
Default: 3

ASSIGN_MODE Text (25) AFP allocation mode. "Free" or "Group constrained". Nullable: No
Default: ‘Free’

BAD_QUAL_UB Float Additional constraints on subcell quality (considered in AFP): maximum Nullable: No
probability to have C/I lower than C_OVER_I_MIN. Default: 1
C_OVER_I_MIN Float Minimum required C/I. Unit: dB. Nullable: No
Default: 12

CELL_TYPE Text (50) Type of cell. Nullable: No


Default:

COST_FACTOR Float Subcell AFP weight. Nullable: No


Default: 1
DEF_DTX Boolean By default, whether the TRXs of the transmission use discontinuous trans- Nullable: No
mission or not. True=Yes; False=No. Default: True

48 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

DEF_HOP_MODE Text (25) Default frequency hopping mode used by the subcells of the transmitter. Nullable: No
“Non Hopping”; “Base Band Hopping”; “Synthesized Hopping”. Default: ‘Non Hopping’

DEF_MIN_RECEPTION Float Default required minimum received power to be served by a subcell of the Nullable: No
transmitter. Default: -102

DEF_POWER_OFFSET Float Default average power offset with respect to the BCCH channel of subcells Nullable: No
of the transmitter. Default: 0
DEF_TRX_EQUIPMENT Text (25) Default TRX equipment of TRXs belonging to the subcell. Nullable: Yes
Default:

FREQUENCY_DOMAIN Text (50) Name of the frequency domain. Nullable: No


Default:

HR_RATIO Float Percentage of half rate voice traffic in the subcell. Unit: %. Nullable: Yes
Default: 40
HSN_DOMAIN Text (50) Name of the HSN domain. Nullable: No
Default:

HSN_FROZEN Boolean Whether the AFP is allowed to modify the HSN or not. True=No; False=Yes. Nullable: No
Default: False

MAXIMAL_MAL Integer Maximum length of the MAL (mobile allocation list). Nullable: No
Default: 48
MEAN_POWER_CONTROL Float Average downlink power control gain. Unit: dB. Nullable: Yes
Default: 0

TRAFFIC_OVERFLOW_TARGE Float The percentage of traffic that is considered to overflow from the subcell. Nullable: Yes
T Default: 0

TRX_TYPE Text (15) Type of TRX. Nullable: No


Default:

TS_CONFIGURATION_NAME Text (50) Timeslot configuration. Nullable: Yes


Default:
TX_DIVERSITY_MODE_DL Short Downlink diversity support. 0=None; 1=TX diversity; 2=Antenna hopping. Nullable: Yes
Default: 0

1.2.53 TRGs Table

For subcells.

Field Type Description Attributes

_8PSK_PWBCKFF Float Power reduction due to higher order modulation. Unit: dB. Nullable: Yes
Default: 3

AFP_BLOCKED_COST Float Secondary AFP quality indicator. Nullable: Yes


Default: 0
AFP_CONGESTION Float Secondary AFP indicator depicting the spectral congestion state. Nullable: Yes
Default: 0

AFP_COST Float Main AFP quality indicator. Nullable: Yes


Default: 0

AFP_FREEZE_DIM Boolean Wether the AFP is allowed to modify the number of TRXs (dimensioning) or Nullable: No
not. True=No; False=Yes. Default: False
AFP_SEP_COST Float Secondary AFP quality indicator. Nullable: Yes
Default: 0

ASSIGN_MODE Text (25) AFP allocation mode. "Free" or "Group constrained". Nullable: Yes
Default: ‘Free’

© 2018 Forsk. All Rights Reserved. 49


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

BAD_QUAL_UB Float Additional constraints on subcell quality (considered in AFP): maximum Nullable: Yes
probability to have C/I lower than C_OVER_I_MIN. Default: 1

BLOCKING_PROBA Float Blocking probability. Unit: %. Nullable: Yes


Default: 0

C_OVER_I_MIN Float Minimum required C/I. Unit: dB. Nullable: Yes


Default: 12
COST_FACTOR Float Subcell AFP weight. Nullable: Yes
Default: 1

CS_ERLANGS Float Circuit-switched demand in Erlangs. Nullable: Yes


Default: 0

DEF_TRX_EQUIPMENT Text (25) Default TRX equipment of TRXs belonging to the subcell. Nullable: Yes
Default:
DTX Boolean Whether the TRXs of the subcell use discontinuous transmission or not. Nullable: No
True=Yes; False=No. Default: True

DTX_GAIN_DL Float Gain due to discontinuous transmission. Unit: dB. Nullable: Yes
Default: 0

EFFECTIVE_TRAFFIC_OVERFL Float Effective traffic overflow. Nullable: Yes


OW Default:
EXCLUDED Text (250) List of frequencies not allowed for the TRXs of the subcell. Nullable: Yes
Default:

FREQUENCY_DOMAIN Text (50) Name of the frequency domain. Nullable: Yes


Default:

HOP_MODE Text (25) The hopping mode of a subcell. “Non Hopping”; “Base Band Hopping”; “Syn- Nullable: Yes
thesized Hopping”. Default: ‘Non Hopping’

HR_RATIO Float Percentage of half rate voice traffic in the subcell. Unit: %. Nullable: Yes
Default: 40
HSN Integer Assigned HSN. Nullable: Yes
Default:

HSN_DOMAIN Text (50) Name of the HSN domain. Nullable: Yes


Default:

HSN_FROZEN Boolean Whether the AFP is allowed to modify the HSN or not. True=No; False=Yes. Nullable: No
Default: False
MAXIMAL_MAL Integer Maximum length of the MAL (mobile allocation list). Nullable: Yes
Default: 48

MEAN_POWER_CONTROL Float Average downlink power control gain. Unit: dB. Nullable: Yes
Default: 0

MIN_MAL_LENGTH Integer Minimum MAL (mobile allocation list) length. Nullable: Yes
Default: 2
MIN_RECEPTION Float Minimum received power required to be covered by the subcell. Nullable: No
Default: -102

POWER_OFFSET Float The average power offset with respect to the BCCH channel. Unit: dB. Nullable: No
Default: 0

PREFERRED_FREQ_GROUP Text (50) Frequency group which should be used if possible. Nullable: Yes
Default:
PS_DATA_ERLANGS Float Packet-switched demand in data Erlangs. Nullable: Yes
Default: 0

REQ_CHANNELS Integer Number of required frequency channels. Nullable: No


Default: 0

SYNCHRO_NAME Text (50) Name of the synchronisation set. Nullable: Yes


Default:

50 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

TRAFFIC_LOAD Float Traffic load of the subcell. Nullable: No


Default: 1

TRAFFIC_OVERFLOW_TARGE Float The percentage of traffic that is considered to overflow from the subcell. Nullable: Yes
T Default: 0

TRX_TYPE Text (15) Type of TRX. Nullable: No


Default:
TS_CONFIGURATION_NAME Text (50) Timeslot configuration. Nullable: Yes
Default:

TX_DIVERSITY_MODE_DL Short Downlink diversity support. 0=None; 1=TX diversity; 2=Antenna hopping. Nullable: Yes
Default: 0

TX_ID Text (100) Name of the transmitter to which the subcell belongs. Nullable: No
Default:
UL_TRAFFIC_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes
Default: 1

VAMOS_RATIO Float Percentage of VAMOS (Voice services over Adaptive Multi-user channels on Nullable: Yes
One Slot) traffic in the subcell. Unit: %. Default: 0

1.2.54 TRXEquipments Table

For TRX equipment.

Field Type Description Attributes

COMMENT_ Text (100) Additional information about the TRX equipment. Nullable: Yes
Default:

GMSK_POWER Float Nominal output power for GMSK modulation. Nullable: Yes
Default: 47
MAX_CS Short Highest coding scheme (CS) available for GPRS. Nullable: No
Default: 4

MAX_MCS Short Highest coding scheme (MCS) available for EDGE. Nullable: No
Default: 12

NAME Text (25) Name of the TRX equipment. Nullable: No


Default:

1.2.55 TRXs Table

For TRXs.

Field Type Description Attributes


_8PSK_PWBCKFF Float Power reduction due to higher order modulation. Unit: dB. Nullable: Yes
Default: 3

AFP_RANK Short Rank of this TRX according to the AFP Nullable: Yes
Default: 0

CN_LIST Text (255) List of frequencies assigned to a TRX. Nullable: Yes


Default:
DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default: 0

FROZEN Boolean Whether the AFP is allowed to modify frequency assigned to the TRX or not. Nullable: No
True=No; False=Yes. Default: False

© 2018 Forsk. All Rights Reserved. 51


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

MAIO Integer Assigned MAIO (Mobile Allocation Index Offset). Nullable: Yes
Default:

TRX_EQUIPMENT Text (25) Name of the TRX equipment. Nullable: Yes


Default:

TRX_NUMBER Integer Order of the TRX within a subcell. Nullable: No


Default:
TRX_TYPE Text (15) TRX type. Nullable: No
Default:

TX_ID Text (100) Name of the transmitter to which the TRX belongs. Nullable: No
Default:

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default: 0
UPLINK_NOISE_RISE Float Uplink noise rise. Unit: dB. Nullable: Yes
Default: 0

1.2.56 TRXTypes Table

For TRX types (BCCH, TCH, TCH_INNER, etc.).

Field Type Description Attributes

IS_BCCH Boolean Whether the TRX is of type BCCH or not. True=Yes; False=No. Nullable: No
Default: False

IS_TCH_DEF Boolean Whether the TRX is of type TCH or not. True=Yes; False=No. Nullable: No
Default: False

NAME Text (15) Name of the TRX type. Nullable: No


Default:
PRIORITY Short TRX type priority. 0=Lowest. Nullable: Yes
Default: 0

TRAFFIC_POOL Short Traffic pool to which the TRX type belongs. Nullable: Yes
Default: 1

1.2.57 TSConfigurationNames Table

For names of timeslot configurations.

Field Type Description Attributes

NAME Text (50) Name of the timeslot configuration. Nullable: No


Default:

1.2.58 TSConfigurations Table

For timeslot configurations.

52 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

CIRCUIT_TS Integer Number of timeslots that support circuit-switched traffic. Nullable: No


Default: 0

COMPOSITE_TS Integer Number of timeslots that support both circuit and packet switched traffic. Nullable: No
Default: 8
NAME Text (50) Name of the timeslot configuration. Nullable: No
Default:

PACKET_TS Integer Number of timeslots dedicated to packet-switched traffic. Nullable: No


Default: 0

TRX_NUMBER Integer Order of the TRX within a subcell. Nullable: No


Default: 1

1.2.59 TxsLists Table

For transmitters belonging to transmitter lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the transmitter list. Nullable: No


Default:

TX_NAME Text (100) Name of the transmitters belonging to the list. Nullable: No
Default:

1.2.60 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

NAME Text (50) Name of the transmitter list Nullable: No


Default:

1.2.61 Units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, the
database internal coordinate system, and the internal BSIC format.

Field Type Description Attributes

BSIC_FORMAT Integer Base station identity code format. 0=Decimal; 1=Octal. Nullable: Yes
Default: 1
COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes
Default: -1

© 2018 Forsk. All Rights Reserved. 53


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Field Type Description Attributes

GAIN_UNIT Integer Unit used for gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0

PROJECTION Integer Projection coordinate system of the document. Nullable: Yes


Default: -1

RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0
TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No
Default: 0

1.3 Relationships

Many-to-One Relationships (  1)

BSICGroups.DOMAIN_NAME BSICDomains.NAME
CodecEquipments.IDEAL_QI_NAME QualityIndicators.NAME

CodecModeAdaptations.CODEC_EQT CodecEquipments.NAME

CodecModeAdaptations.CODEC_MODE CodecModes.NAME

CodecModeAdaptations.FREQUENCY_BAND FrequencyBands.NAME

CodecModeAdaptations.MOBILITY EGPRSMobility.NAME

CodecQualityTables.CODEC_EQT CodecEquipments.NAME

CodecQualityTables.CODEC_MODE CodecModes.NAME

CodecQualityTables.FREQUENCY_BAND FrequencyBands.NAME

CodecQualityTables.MOBILITY EGPRSMobility.NAME

CodecQualityTables.QI_NAME QualityIndicators.NAME

EGPRSEnvironmentDefs.ENVIRONMENT EGPRSTrafficEnvironments.NAME

EGPRSEnvironmentDefs.MOBILITY EGPRSMobility.NAME

EGPRSEnvironmentDefs.USER_PROFILE EGPRSUserProfiles.NAME

EGPRSQuality.CS_NAME EGPRSCodingSchemes.NAME

EGPRSQuality.EQUIPMENT EGPRSEquipments.NAME

EGPRSQuality.FREQUENCY_BAND FrequencyBands.NAME

EGPRSQuality.MOBILITY EGPRSMobility.NAME

EGPRSServiceQuality.DIMENSIONING_MODEL EGPRSDimensioningModel.NAME

EGPRSServicesUsage.SERVICE EGPRSServices.NAME

EGPRSServicesUsage.TERMINAL EGPRSTerminals.NAME

EGPRSServicesUsage.USER_PROFILE EGPRSUserProfiles.NAME

EGPRSTerminals.CODEC_EQUIPMENT CodecEquipments.NAME

EGPRSTerminals.EGPRS_EQUIPMENT EGPRSEquipments.NAME

EGPRSTerminals.PRIMARY_BAND FrequencyBands.NAME

EGPRSTerminals.SECONDARY_BAND FrequencyBands.NAME

FrequencyDomains.FREQUENCY_BAND_NAME FrequencyBands.NAME

FrequencyGroups.DOMAIN_NAME FrequencyDomains.NAME

HSNGroups.DOMAIN_NAME HSNDomains.NAME

Neighbours.NEIGHBOUR Transmitters.TX_ID

Neighbours.TRANSMITTER Transmitters.TX_ID

54 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 1: GSM GPRS EDGE Data Structure

Many-to-One Relationships (  1)

NeighboursConstraints.NEIGHBOUR Transmitters.TX_ID

NeighboursConstraints.TRANSMITTER Transmitters.TX_ID

NeighboursConstraintsExt.TRANSMITTER Transmitters.TX_ID

NeighboursExt.TRANSMITTER Transmitters.TX_ID

Networks.DEFAULT_MODEL PropagationModels.NAME

Receivers.ANTENNA Antennas.NAME

Repeaters.DONOR_CELLID Transmitters.TX_ID

Repeaters.DONOR_PROPAG_MODEL PropagationModels.NAME

Repeaters.EQUIPMENT_NAME RepeaterEquipments.NAME

Repeaters.FEEDER_NAME FeederEquipments.NAME

Repeaters.REC_ANTENNA Antennas.NAME

Repeaters.TX_ID Transmitters.TX_ID

SecondaryAntennas.ANTENNA Antennas.NAME

SecondaryAntennas.TX_ID Transmitters.TX_ID

Separations.TX_ID Transmitters.TX_ID

Separations.TX_ID_OTHER Transmitters.TX_ID

SitesLists.LIST_NAME SitesListsNames.NAME

SitesLists.SITE_NAME Sites.NAME

Transmitters.ANTENNA_NAME Antennas.NAME
Transmitters.BSIC_DOMAIN BSICDomains.NAME

Transmitters.BTS_NAME BTSEquipments.NAME

Transmitters.CELL_TYPE CellTypes.NAME
Transmitters.CODEC_EQUIPMENT CodecEquipments.NAME

Transmitters.EGPRS_EQUIPMENT EGPRSEquipments.NAME

Transmitters.FBAND FrequencyBands.NAME
Transmitters.FEEDER_NAME FeederEquipments.NAME

Transmitters.LAYER Layers.NAME

Transmitters.PROPAG_MODEL PropagationModels.NAME
Transmitters.PROPAG_MODEL2 PropagationModels.NAME

Transmitters.SITE_NAME Sites.NAME

Transmitters.TMA_NAME TMAEquipments.NAME

TRGConfigurations.CELL_TYPE CellTypes.NAME

TRGConfigurations.DEF_TRX_EQUIPMENT TRXEquipments.NAME

TRGConfigurations.FREQUENCY_DOMAIN FrequencyDomains.NAME

TRGConfigurations.HSN_DOMAIN HSNDomains.NAME

TRGConfigurations.TRX_TYPE TRXTypes.NAME

TRGConfigurations.TS_CONFIGURATION_NAME TSConfigurationNames.NAME
TRGs.DEF_TRX_EQUIPMENT TRXEquipments.NAME

TRGs.FREQUENCY_DOMAIN FrequencyDomains.NAME

TRGs.HSN_DOMAIN HSNDomains.NAME

TRGs.TRX_TYPE TRXTypes.NAME

TRGs.TS_CONFIGURATION_NAME TSConfigurationNames.NAME

TRGs.TX_ID Transmitters.TX_ID

TRXs.TRX_EQUIPMENT TRXEquipments.NAME

© 2018 Forsk. All Rights Reserved. 55


Atoll 3.4.0 Data Structure Reference Guide
Chapter 1: GSM GPRS EDGE Data Structure

Many-to-One Relationships (  1)

TRXs.TRX_TYPE TRXTypes.NAME

TRXs.TX_ID Transmitters.TX_ID

TSConfigurations.NAME TSConfigurationNames.NAME

TxsLists.LIST_NAME TxsListsNames.NAME

TxsLists.TX_NAME Transmitters.TX_ID

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

56 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

2 UMTS HSPA Data Structure


Atoll supports integrated network planning for UMTS HSPA networks. This section describes the UMTS HSPA data
structure used in Atoll. It lists all the tables and fields found in the UMTS HSPA template and the relationships
between them.

 ? ??????? ???? ??? ?????? ?? ???? ??? ?????? ???????????

2.1 Data Structure Changes from Atoll 3.3 to 3.4

2.1.1 Added Tables and Fields

FeederEquipments Table

Field Type Description Attributes

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

Sites Table

Field Type Description Attributes


ALIAS_ Text (60) Site alias. Nullable: Yes
Default:

Transmitters Table

Field Type Description Attributes


ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

uterminalbands Table

Field Type Description Attributes

LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0

© 2018 Forsk. All Rights Reserved. 57


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

2.1.2 Deleted Tables and Fields

None.

2.2 Data Structure

2.2.1 Antennas Table

For antennas.

Field Type Description Attributes

BEAMWIDTH Float The half-power beamwidth of the antenna model. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the antenna model. Nullable: Yes
Default:

CONSTRUCTOR Text (50) Name of the antenna manufacturer. Nullable: Yes


Default:

DIAGRAM Binary Antenna horizontal and vertical patterns. Nullable: Yes


Default:
ELECTRICAL_AZIMUTH Float The electrical azimuth of the antenna model. Nullable: Yes
Default:

ELECTRICAL_TILT Float The electrical tilt of the antenna model. Nullable: Yes
Default:

FMAX Double Maximum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:
FMIN Double Minimum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:
GAIN Float Antenna model gain compared to an isotropic radiator. Unit: dBi. Nullable: No
Default: 0

NAME Text (50) Name of the antenna model. Nullable: No


Default:

PHYSICAL_ANTENNA Text (50) Name of the physical antenna to which the antenna model belongs. Nullable: Yes
Default:

 The format of the binary field, DIAGRAM, is described in the "RF 2D Antenna Pattern
Format" on page 355.

2.2.2 BTSEquipments Table

For NodeB equipment.

58 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

CONFIG_DL_LOSSES Float Downlink losses due to transmitter components (duplexer, combiner, etc.). Nullable: Yes
Unit: dB. Default: 0

CONFIG_UL_LOSSES Float Uplink losses due to transmitter components (duplexer, combiner, etc.). Unit: Nullable: Yes
dB. Default: 0
NAME Text (50) Name of transmitter equipment. Nullable: No
Default:

NOISE_FIGURE Float Noise figure of transmitter equipment. Unit: dB. Nullable: Yes
Default: 0

RHO_FACTOR Short CDMA rho factor for self interference (not used in other technologies). Nullable: Yes
Default: 100

2.2.3 CDMACells Table

For cells.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True

AS_THRESHOLD Float Maximum signal level difference with the best-server to enter the active set. Nullable: Yes
Unit: dB. Default: 5

CARRIER Integer Carrier number. Nullable: Yes


Default: 0
CELL_ID Text (50) Name of the cell. Nullable: No
Default:

CELL_IDENTITY Integer Cell identity. Nullable: Yes


Default:

CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: No


Default: 0

COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:
DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default: 0

DYN_HS_SCCH_POWER_ALL Boolean HS-SCCH power allocation mode. True=Dynamic; False=Static. Nullable: No


OC Default: True

DYN_HSDPA_POWER_ALLOC Boolean HSDPA power allocation mode. True=Dynamic; False=Static. Nullable: No


Default: False
HO_MARGIN Float Handover margin. Unit: dB. Nullable: No
Default: 0

HS_SCCH_POWER Float HS-SCCH transmission power. Equals maximum available power in dynamic Nullable: Yes
allocation. Default:

HSDPA_MAX_CODES Short Maximum number of HS-PDSCH codes. Nullable: Yes


Default: 16
HSDPA_MAX_USERS Short Maximum number of simultaneous HSDPA users. Nullable: Yes
Default: 64

HSDPA_MIN_CODES Short Minimum number of HS-PDSCH codes. Nullable: Yes


Default: 1

HSDPA_PWR Float HSDPA transmission power. Nullable: Yes


Default:

© 2018 Forsk. All Rights Reserved. 59


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

HSDPA_SCHEDULER Text (50) HSDPA scheduler. Nullable: Yes


Default:

HSPA_SUPPORT Short Supported HSPA features. 0=None; 1=HSDPA; 2=HSPA; 3=HSPA+. Nullable: No
Default: 0

HSUPA_DLPOWER Float Power dedicated to downlink HSUPA channels (E-AGCH, E-RGCH, E-HICH). Nullable: Yes
Default:
HSUPA_MAX_USERS Short Maximum number of simultaneous HSUPA users. Nullable: Yes
Default: 15

HSUPA_UL_LOAD Float Uplink load factor due to HSUPA users. Nullable: Yes
Default:

LAYER Short Index of the network layer. Nullable: No


Default: 0
LOCKED_SC Boolean Scrambling code allocation status. True=Locked; False=Modifiable. Nullable: No
Default: False

MAX_DL_LOAD Float Maximum allowed downlink load as percentage of max power. Unit: %. Nullable: Yes
Default: 50

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:
MAX_INTERCAR_NEIGHB_NB Integer Maximum number of inter-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Integer Maximum number of intra-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_R99BEARER_DL_RATE Float Maximum downlink R99 throughput. Unit: kbps. Nullable: Yes
Default: 1000

MAX_R99BEARER_UL_RATE Float Maximum uplink R99 throughput. Unit: kbps. Nullable: Yes
Default: 1000
MAX_UL_LOAD Float Maximum allowed uplink load. Unit: %. Nullable: Yes
Default: 75

MIMO_SUPPORT Short Supported MIMO features. 0=None; 1=Transmit Diversity; 2=SU-MIMO. Nullable: No
Default: 0

NUM_HS_SCCH Short Number of HS-SCCH channels. Nullable: Yes


Default: 1
NUM_HSDPA_USERS Short Number of served HSDPA users. Nullable: Yes
Default:

NUM_HSUPA_USERS Short Number of served HSUPA users. Nullable: Yes


Default:

OTHERS_CCH_POWER Float Transmission power of other common channels (except SCH). Nullable: Yes
Default: 30
PILOT_POWER Float Power of the pilot channel. Nullable: Yes
Default: 33

POWER_MAX Float Cell's maximum transmission power. Nullable: Yes


Default: 43

PWR_HEADROOM Float Power control headroom for DCH. Unit: dB. Nullable: Yes
Default: 0
REUSE_DIST Float Minimum reuse distance for scrambling codes. Nullable: Yes
Default:

RSCP_MIN Float Minimum received signal code power for coverage. Nullable: Yes
Default: -150

SC_DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: Yes
Default:

60 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

SCH_POWER Float Power of the synchronisation (SCH) channel. Nullable: Yes


Default: 21

SCRAMBLING_CODE Integer Scrambling code. Nullable: Yes


Default:

TOTAL_POWER Float Total downlink transmission power. Nullable: Yes


Default:
TX_CELL_ORDER Short Order of the cell within a transmitter. Nullable: Yes
Default:

TX_ID Text (50) Name of the transmitter to which the cell belongs. Nullable: No
Default:

UL_LOAD Float Uplink load factor. Unit: %. Nullable: Yes


Default:
UL_REUSE_FACTOR Float Uplink (I intra+ I extra)/ I intra. Unit: dB. Nullable: Yes
Default:

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default: 0

2.2.4 CdmaEqptsHSUPARssUse Table

For HSUPA resource consumption in site equipment.

Field Type Description Attributes

BEARER_INDEX Short HSUPA bearer index. Nullable: No


Default:

CHANNEL_ELTS_UL Integer Number of channel elements used for uplink. Nullable: Yes
Default: 1
EQUIPMENT Text (50) Name of the site equipment Nullable: No
Default:

IUB_RATE_UL Float Iub backhaul rate for uplink. Unit: kbps. Nullable: Yes
Default: 15

2.2.5 CDMAEquipments Table

For site equipment.

Field Type Description Attributes

CARRIER_SELECTION Short Intra-Node-B carrier selection mode. 0=Min UL load factor; 1=Min DL total Nullable: No
power; 2=Random; 3=Sequential. Default: 0
CES_OVERHEAD_DL Integer Number of channel elements used by downlink overhead channels. Nullable: No
Default: 0

CES_OVERHEAD_UL Integer Number of channel elements used by uplink overhead channels. Nullable: No
Default: 0

ENABLE_COMPRESSED_MOD Boolean Whether compressed mode is active or not. True=Yes; False=No. Nullable: No
E Default: False
HSDPA_MULTI_BAND Short Whether HSDPA multi-band support is active or not. 0=Inactive; 1=Active. Nullable: No
Default: 0

IUB_E1_RATE Float Supported rate per E1 line. Unit: kbps. Nullable: No


Default: 2048

© 2018 Forsk. All Rights Reserved. 61


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

IUB_HSDPA_PERCENT Short Iub HSDPA backhaul overhead. Unit: %. Nullable: No


Default: 20

IUB_OVERHEAD_DL Float Iub common transport channel backhaul overhead. Unit: kbps. Nullable: No
Default: 40

MANUFACTURER Text (50) Name of the site equipment manufacturer. Nullable: Yes
Default:
MUD_FACTOR Float MUD factor for uplink interference cancellation. Nullable: No
Default: 0

NAME Text (50) Name of the site equipment. Nullable: No


Default:

RAKE_EFFICIENCY Float Efficiency of the rake receiver. Nullable: No


Default: 1
SCHEDULER_ALGO Text (50) Scheduler algorithm. Nullable: Yes
Default:

USE_NEIGHBOURS Boolean Whether the active set selection is limited to neighbours or not. True=Yes; Nullable: No
False=No. Default: False

2.2.6 CDMAEquipmentsCEsUse Table

For channel elements consumption in site equipment.

Field Type Description Attributes

CHANNEL_ELTS_DL Integer Number of channel elements used for downlink. Nullable: No


Default: 1

CHANNEL_ELTS_UL Integer Number of channel elements used for uplink. Nullable: No


Default: 1
EQUIPMENT Text (50) Name of the site equipment. Nullable: No
Default:

IUB_RATE_DL Float Iub backhaul rate for downlink. Unit: kbps. Nullable: Yes
Default: 15

IUB_RATE_UL Float Iub backhaul rate for uplink. Unit: kbps. Nullable: Yes
Default: 15
SERVICE Text (50) Name of the R99 radio bearer. Nullable: No
Default:

2.2.7 CoordSys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

62 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default: 0

DATUM_CODE Double Identification code of the datum. Nullable: Yes


Default: 0
DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes
Default: 0

DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0
DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0

DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes


Default: 0

DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes


Default: 0
DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes
Default: 0

ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No


Default: 0

ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes


Default: 0
ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes
Default: 0
GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:

PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes


Default: 0

PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes


Default: 0
PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes
Default: 0

PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0
PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 63


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

2.2.8 CustomFields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:

CHOICE_LIST Memo Choice list for text fields. Nullable: Yes


Default:

CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default: 0
COLUMN_NAME Text (50) Name of the custom field. Nullable: No
Default:

DEFAULT_VALUE Text (50) Default value for the field. Nullable: Yes
Default:

DISPLAY_TYPE Integer Whether the field is hypertext or regular and modifiable or read-only. Nullable: Yes
0=Regular and modifiable; 1=Regular and read-only; 2=Hypertext and mod- Default: 0
ifiable; 3=Hypertext and read-only

GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:

TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.
 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.
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


 Table and field names are case sensitive.
 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any table in Atoll, including user-defined fields that you add to the Atoll tables. The values defined in this

64 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the
appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

2.2.9 FeederEquipments Table

For feeders.

Field Type Description Attributes

CONNECTOR_LOSSES_DL Float Feeder connector losses in downlink. Unit: dB. Nullable: Yes
Default: 0

CONNECTOR_LOSSES_UL Float Feeder connector losses in uplink. Unit: dB. Nullable: Yes
Default: 0

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:
LOSS_PER_METER Float Feeder loss per meter. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the feeder. Nullable: No


Default:

2.2.10 FrequencyBands Table

For frequency bands.

Field Type Description Attributes

BAND_WIDTH Double Carrier width. Unit: MHz. Nullable: Yes


Default: 5
DELTA_CN Integer Step between two adjacent carrier numbers. Nullable: Yes
Default: 1

EXCLUDED_CHANNELS Text (255) List of carrier numbers not part of the usable spectrum. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 65


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

FIRST_CARRIER Integer First carrier number in the frequency band. Nullable: Yes
Default: 0

FREQUENCY Double Downlink start frequency of the first carrier of the frequency band. Unit: MHz. Nullable: Yes
Default: 2110

LAST_CARRIER Integer Last carrier number in the frequency band. Nullable: Yes
Default: 0
NAME Text (50) Name of the frequency band. Nullable: No
Default:

2.2.11 HSDPABearers Table

For HSDPA bearers.

Field Type Description Attributes

BEARER_INDEX Short HSDPA bearer index. Nullable: No


Default:

HSPDSCH_NUM Short Number of HS-PDSCH channels used by the HSDPA bearer. Nullable: Yes
Default: 5
MODULATION Short Modulation used by the HSDPA bearer. 0=QPSK; 1=16QAM; 2=64QAM. Nullable: No
Default: 0

RLC_PEAK_THROUGHPUT Float Peak RLC throughput of the bearer. Unit: kbps. Nullable: Yes
Default: 0

TRANSPORT_BL_SIZE Integer Transport block size. Unit: bits. Nullable: Yes


Default: 0

2.2.12 HSDPABearerSelectTables Table

For HSDPA bearer selection graphs.

Field Type Description Attributes

BEST_BEARER_TABLE Memo HSDPA bearer selection graphs. Nullable: Yes


Default:
CQI_TABLE Memo Quality indicator graphs as a function of CPICH or HS-PDSCH quality. Nullable: Yes
Default:

MOBILITY Text (50) Mobility type corresponding to the HSDPA bearer selection thresholds. Nullable: Yes
Default:

RX_EQUIP Text (50) Reception equipment corresponding to the HSDPA bearer selection thresh- Nullable: Yes
olds. Default:

2.2.13 HSDPAQualityTables Table

For HSDPA bearer performance graphs.

66 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

BEARER_INDEX Short HSDPA bearer index. Nullable: No


Default:

DL_QI_TABLE Memo Downlink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:
MOBILITY Text (50) Mobility type corresponding to the HSDPA quality graph. Nullable: Yes
Default:

QI_NAME Text (50) Name of the quality indicator. Nullable: No


Default:

RX_EQUIP Text (50) Reception equipment corresponding to the HSDPA quality indicator graphs. Nullable: No
Default:

2.2.14 HSPAMIMOConfigs Table

For HSPA MIMO gains.

Field Type Description Attributes

DL_DIVERSITY_GAIN Float Downlink diversity gain. Unit: dB. Nullable: Yes


Default: 0

HSDPA_BEARER_INDEX Short HSDPA bearer index. Nullable: Yes


Default: 0

MAX_MIMO_GAIN_TABLE Memo Maximum MIMO gain graphs as function of HS-PDSCH Ec/Nt. Nullable: Yes
Default:
MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default: 1

MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default: 1

MOBILITY Text (50) Mobility type corresponding to the MIMO gain graph. Nullable: Yes
Default:

RX_EQUIP Text (50) Reception equipment corresponding to the MIMO gain graphs. Nullable: No
Default:

2.2.15 HSUPABearers Table

For HSUPA bearers.

Field Type Description Attributes


BEARER_INDEX Short HSUPA bearer index. Nullable: No
Default:

EDPDCH_NUM Short Number of E-DPDCH codes used. Nullable: Yes


Default:

MIN_SF Integer Smallest spreading factor. Nullable: Yes


Default:

© 2018 Forsk. All Rights Reserved. 67


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

MODULATION Short Modulation used by the HSUPA bearer. 0=QPSK; 1=16QAM. Nullable: No
Default: 0

RLC_PEAK_RATE Float RLC throughput of the bearer. Unit: kbps: Nullable: Yes
Default:

TRANSPORT_BL_SIZE Integer Transport block size. Unit: bits. Nullable: Yes


Default:
TTI_LENGTH Float Duration of TTI. Unit: ms. Nullable: Yes
Default:

2.2.16 HSUPABearerSelection Table

For HSUPA bearer selection thresholds.

Field Type Description Attributes

BEARER_INDEX Short HSUPA bearer index. Nullable: Yes


Default: 0

EARLY_TERM_TABLE Memo Early termination probability graphs as a function of the number of repeti- Nullable: Yes
tions. Default:
EC_NT_REQ Float Required E-DPDCH Ec/Nt. Unit: dB. Nullable: Yes
Default:

MOBILITY Text (50) Mobility type corresponding to the HSUPA bearer selection thresholds. Nullable: Yes
Default:

REPEAT_NUM Integer Number of retransmissions to ensure error-free reception. Nullable: Yes


Default: 1

RX_EQUIP Text (50) Reception equipment corresponding to the HSUPA bearer selection thresh- Nullable: Yes
olds. Default:

2.2.17 HSUPAQualityTables Table

For HSUPA bearer performance graphs.

Field Type Description Attributes

BEARER_INDEX Short HSUPA bearer index. Nullable: No


Default:

MOBILITY Text (50) Mobility type corresponding to the HSUPA quality graph. Nullable: Yes
Default:

QI_NAME Text (50) Name of the quality indicator. Nullable: No


Default:
REPEAT_NUM Integer Number of retransmissions to ensure error-free reception. Nullable: Yes
Default: 1

RX_EQUIP Text (50) Reception equipment corresponding to the HSUPA quality indicator graphs. Nullable: No
Default:

UL_QI_TABLE Memo Uplink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:

68 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

2.2.18 HSUPAUECategories Table

For HSUPA UE categories.

Field Type Description Attributes

MAX_BLOCK_SIZE_10MS Integer Maximum transport block size for TTI=10ms. Nullable: Yes
Default:

MAX_BLOCK_SIZE_2MS Integer Maximum transport block size for TTI=2ms. Nullable: Yes
Default:

MAX_EDPDCH_NUM Short Maximum number of E-DPDCH codes for HSUPA. Nullable: Yes
Default:
MIMO_SUPPORT Short Supported MIMO features. 0=None; 1=MIMO. Nullable: No
Default: 0

MIN_SF Integer Smallest spreading factor. Nullable: Yes


Default:

MODULATION Short Highest modulation used by the HSUPA UE category. 0=QPSK; 1=16QAM; Nullable: No
2=64QAM. Default: 0
MULTI_CARRIER Short Multi-carrier mode. 0=None; 1=2C. Nullable: No
Default: 0

TTI_2MS Boolean Whether the UE category uses 2ms TTI or not. True=Yes; False=No. Nullable: No
Default: False

UE_CATEGORY Short HSUPA UE category. Nullable: No


Default:
UE_CATEGORY_NAME Text (50) Name of the HSUPA UE category. Nullable: Yes
Default:

2.2.19 InterfReductionFactors Table

For interference reduction factors between carriers.

Field Type Description Attributes

CARRIER1 Integer Number of the first carrier in the inter-carrier IRF relation. Nullable: No
Default: 0

CARRIER2 Integer Number of the second carrier in the inter-carrier IRF relation. Nullable: No
Default: 0

FACTOR Double Interference reduction factor between two carrier numbers. Unit: dB. Nullable: No
Default: 200

2.2.20 InterNetChProtect Table

For inter-network interference reduction factor graphs.

© 2018 Forsk. All Rights Reserved. 69


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

ICP Memo Inter-RAT interference reduction graph as a function of frequency difference Nullable: Yes
between channels. Default:

ITF_BW Double Channel width of the interferer cell. Unit: kHz. Nullable: No
Default: 0
ITF_TECHNO Text (50) Technology of the interfering cell. Nullable: No
Default:

V_BW Double Channel width of the interfered cell. Unit: kHz. Nullable: No
Default: 0

2.2.21 MUGTables Table

For multi-user diversity gains.

Field Type Description Attributes

CELL_NUMBER Short Number of cells corresponding to the multi-user diversity gain graph. Nullable: No
Default: 0
MUG_TABLE Memo Multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:

SCHEDULER_NAME Text (50) Scheduler corresponding to the multi-user diversity gain graph. Nullable: No
Default:

2.2.22 Neighbours Table

For intra-technology neighbour relations.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

RELATION_TYPE Short Type of the neighbour relation. 0=Intra-carrier; 1=Inter-carrier. Nullable: Yes
Default:

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

2.2.23 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

70 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

2.2.24 NeighboursConstraintsExt Table

For inter-technology neighbour allocation constraints.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

2.2.25 NeighboursExt Table

For inter-technology neighbour relations.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

2.2.26 Networks Table

For network-level parameters.

© 2018 Forsk. All Rights Reserved. 71


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

ADD_MRC_SOFTERSOFT Boolean Whether MRC gain should be applied to softer/soft handovers or not. Nullable: No
True=Yes; False=No. Default: False

COMPRESSED_DELTA_DL_QU Float Downlink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
AL Default: 1
COMPRESSED_DELTA_UL_QU Float Uplink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
AL Default: 1

COMPRESSED_ON_ECIO Boolean Whether compressed mode is active on Ec/Io threshold or not. True=Yes; Nullable: No
False=No. Default: True

COMPRESSED_ON_RSCP Boolean Whether compressed mode is active on RSCP threshold or not. True=Yes; Nullable: No
False=No. Default: False
COMPRESSED_THRESHOLD Float Ec/Io threshold for compressed mode activation. Unit: dB. Nullable: No
Default: -13

CQI_CPICH_BASED Boolean Whether CQI determination is based on CPICH quality or HS-PDSCH quality. Nullable: No
True=CPICH; False=HS-PDSCH. Default: True

DEFAULT_HOGAIN_UL Float Default uplink soft handover gain. Unit: dB. Nullable: No
Default: 0
DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes
Default: ‘Cost-Hata’

DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No


Default: 50

DMAX Float Maximum radius for a cell. Nullable: No


Default: -1
HSDPA_NTISNTOT Boolean Whether Nt includes the pilot signal for HS-SCCH, HS-PDSCH and CPICH for Nullable: No
CQI determination or not. True=Yes; False=No. Default: False
INTERFERERS_RX_THRESH Float Lowest received interference level. Nullable: Yes
Default: -130

IOISNTOT Boolean Whether Io includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: True

NAME Text (50) Name of the network. Nullable: No


Default:
NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False

POWERS_RELATIVE_TO_PILO Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
T values or as offsets to the pilot power. True=Relative; False=Absolute. Default: False

PTOT_RELATIVE_TO_PMAX Boolean Whether the total cell power is defined as absolute value or as offset to the Nullable: No
maximum power. True=Relative; False=Absolute. Default: False
RSCP_COMPRESSED_THRES Float RSCP threshold for compressed mode activation. Unit: dB. Nullable: No
HOLD Default: -100

RSCP_MIN Float Minimum received signal code power for coverage. Nullable: Yes
Default: -150

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:
SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:

SPREADING_WIDTH Float Spreading width. Unit: MHz. Nullable: Yes


Default: 3.84

SYSTEM_ Text (50) Name of the system. Nullable: No


Default: ‘UMTS’
TECHNOLOGY Text (10) Name of the technology. Nullable: No
Default: ‘CDMA’

72 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

2.2.27 PropagationModels Table

For propagation models.

Field Type Description Attributes

DATA Binary Propagation model parameter settings. Nullable: Yes


Default:

DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:

NAME Text (50) Name of the propagation model. Nullable: No


Default:
SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

TYPE Text (50) ProgID of the model. Nullable: No


Default:

2.2.28 QualityIndicators Table

For quality indicators (BER, BLER, etc.).

Field Type Description Attributes

CS_QI Boolean Whether the quality indicator is used for circuit-switched services or not. Nullable: No
True=Yes; False=No. Default: True
MEAS_PARAM Short Measurement on which the quality indicator is based. 1=CPICH Ec/Io; Nullable: Yes
2=CPICH Ec/Nt; 3=DCH Eb/Nt; 4=HS-PDSCH Ec/Nt; 5=E-DPDCH Ec/Nt. Default: 1

NAME Text (20) Name of the quality indicator. Nullable: No


Default:

PS_QI Boolean Whether the quality indicator is used for packet-switched services or not. Nullable: No
True=Yes; False=No. Default: True

USE_INTERPOLATION Boolean Whether interpolation can be used for the quality indicator graph to find val- Nullable: No
ues between defined ones. True=Yes; False=No. Default: True

2.2.29 R99Bearers Table

For release 99 bearers.

Field Type Description Attributes

ACTIVE_SPREADING_FACTOR Integer Downlink spreading factor for active users. Nullable: Yes
_DL Default: 256

DL_NOMINAL_BIT_RATE Float Downlink nominal throughput of the R99 bearer. Unit: kbps. Nullable: Yes
Default: 9.6

DPCCH_DPCH_RATIO_DL Float Ratio between DPCCH and DPCH powers in downlink. Nullable: Yes
Default: 0
DPCCH_DPCH_RATIO_UL Float Ratio between DPCCH and DPCH powers in uplink. Nullable: Yes
Default: 0

INACTIVE_SPREADING_FACT Integer Downlink spreading factor for inactive users. Nullable: Yes
OR_DL Default: 256

NAME Text (50) Name of the R99 bearer. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 73


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

PTCH_MAX Float Maximum allowed traffic channel power. Nullable: Yes


Default: 21

PTCH_MIN Float Minimum allowed traffic channel power. Nullable: Yes


Default: -20

TYPE Short Type of the R99 bearer. 0=None; 1=Interactive; 2=Conversational; 3=Back- Nullable: Yes
ground; 4=Streaming. Default: 0
UL_NOMINAL_BIT_RATE Float Uplink nominal throughput of the R99 bearer. Unit: kbps. Nullable: Yes
Default: 9.6

2.2.30 Receivers Table

For receiver parameters.

Field Type Description Attributes

ADJ_CHANNEL_PROT Float Adjacent channel interference reduction (ACIR = 1/(1/ACS + 1/ACLR)). Unit: Nullable: No
dB. Default: 18

ANTENNA Text (50) Antenna model of the default receiver. If not defined, an isotropic receiver is Nullable: Yes
used. Default:
HEIGHT Float Height of the default receiver. Nullable: No
Default: 1.5

LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0

NAME Text (50) Name of the default receiver. Nullable: No


Default:

2.2.31 RepeaterEquipments Table

For repeater equipment.

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the repeater equipment. Nullable: Yes
Default:
MANUFACTURER Text (50) Name of the repeater equipment manufacturer. Nullable: Yes
Default:

MAX_AMPLIFIER_GAIN Float Maximum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 90

MAX_OUTPUT_DL Float Maximum downlink output power. Nullable: Yes


Default: 30
MAX_OUTPUT_UL Float Maximum uplink output power. Nullable: Yes
Default: 12

MIN_AMPLIFIER_GAIN Float Minimum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 50

74 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

NAME Text (50) Name of the repeater equipment. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the repeater equipment. Unit: dB. Nullable: Yes
Default: 5

STEP_AMPLIFIER_GAIN Float Step of amplifier gain. Unit: dB. Nullable: Yes


Default: 1
TIME_DELAY Float Processing delay of the repeater equipment. Unit: us. Nullable: Yes
Default: 5

2.2.32 Repeaters Table

For repeaters.

Field Type Description Attributes

AMPLIFIER_GAIN Float Repeater amplifier gain. Unit: dB. Nullable: Yes


Default: 80

AZIMUT Float Azimuth of the donor side antenna. Nullable: Yes


Default: 0
DONOR_CELLID Text (100) Name of the donor transmitter. Nullable: No
Default:

DONOR_LINK_LOSS Float Loss over the donor-repeater link. Unit: dB. Nullable: Yes
Default: 0

DONOR_LINK_TYPE Short Type of the donor-repeater link. 1=Off air; 2=Microwave; 3=Fibre. Nullable: No
Default: 1

DONOR_PROPAG_MODEL Text (50) Name of the propagation model used for the donor-repeater link. Nullable: Yes
Default:
DOWNTILT Float Downtilt of the donor side antenna. Nullable: Yes
Default: 0

EQUIPMENT_NAME Text (50) Name of the repeater equipment. Passive repeaters do not have equipment Nullable: Yes
(no amplification). Default:

FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:
FEEDERLENGTH Float Length of donor side downlink feeder. Nullable: Yes
Default: 0

HEIGHT Float Height of the donor side antenna. Nullable: Yes


Default: 25

REC_ANTENNA Text (50) Name of the donor side antenna model. Nullable: Yes
Default:
REC_FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes
Default: 0

TOTAL_GAIN Float Total gain of the repeater. Unit: dB. Nullable: Yes
Default: 0

TX_ID Text (100) Name of the repeater. Nullable: No


Default:

 Repeater properties are saved in two tables: the donor-side parameters are in the
Repeaters table and the coverage-side parameters in the Transmitters table.

© 2018 Forsk. All Rights Reserved. 75


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

2.2.33 Schedulers Table

For schedulers.

Field Type Description Attributes

NAME Text (30) Name of the scheduler. Nullable: No


Default:

SCHEDULING_METHOD Short Scheduling method. 0=Max C/I; 1=Round Robin; 2=Proportional Fair. Nullable: Yes
Default: 0

2.2.34 ScramblingCodesDomains Table

For names of scrambling code domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: No


Default:

2.2.35 ScramblingCodesGroups Table

For scrambling code groups belonging to scrambling code domains.

Field Type Description Attributes


DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: No
Default:

EXCLUDED Text (225) List of scrambling codes not belonging to the group. Nullable: Yes
Default:

EXTRA Text (225) List of additional scrambling codes belonging to the group. Nullable: Yes
Default:

FIRST Integer First scrambling code belonging to the group. Nullable: Yes
Default: 0
LAST Integer Last scrambling code belonging to the group. Nullable: Yes
Default: 0

NAME Text (50) Name of the scrambling code group. Nullable: No


Default:

STEP Integer Step between the first and last scrambling code belonging to the group. Nullable: Yes
Default: 1

76 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

2.2.36 SecondaryAntennas Table

For additional antennas.

Field Type Description Attributes

ANTENNA Text (50) Name of the secondary antenna model installed on a transmitter. Nullable: No
Default:

AZIMUT Float Azimuth of the secondary antenna. Nullable: No


Default: 0

PERCENT_POWER Float Percentage of power dedicated to the secondary antenna. Nullable: No


Default: 0
REDT Float Remote electrical tilt of the secondary antenna. Nullable: Yes
Default: 0

TILT Float Mechanical downtilt of the secondary antenna. Nullable: No


Default: 0

TX_ID Text (100) Name of the transmitter on which the secondary antenna is installed. Nullable: No
Default:

2.2.37 Separations Table

For scrambling code allocation constraints.

Field Type Description Attributes

TX_ID Text (100) Name of the first transmitter. Nullable: No


Default:

TX_ID_OTHER Text (50) Name of the second transmitter. Nullable: No


Default:

2.2.38 ServiceQualityTables Table

For release 99 performance graphs.

Field Type Description Attributes

DL_QI_TABLE Memo Downlink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:

MOBILITY Text (50) Mobility type corresponding to the quality indicator graph. Nullable: Yes
Default:
QI_NAME Text (50) Name of the quality indicator. Nullable: No
Default:

RX_EQUIP Text (50) Reception equipment corresponding to the quality indicator graph. Nullable: No
Default:

SERVICE Text (50) Name of the R99 radio bearer corresponding to the quality indicator graph. Nullable: No
Default:
UL_QI_TABLE Memo Uplink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:

© 2018 Forsk. All Rights Reserved. 77


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

2.2.39 Sites Table

For sites.

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

ALTITUDE Float User-defined site altitude. Nullable: Yes


Default:

CDMA_EQUIPMENT Text (50) CDMA site equipment assigned to the site. Nullable: Yes
Default:
CHANNEL_ELEMENTS_DL Integer Number of available channel elements for downlink. Nullable: No
Default: 256

CHANNEL_ELEMENTS_UL Integer Number of available channel elements for uplink. Nullable: No


Default: 256

COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:
LATITUDE Double Y coordinate or latitude. Nullable: No
Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0

MAX_IUB_RATE_DL Float Maximum Iub backhaul rate for downlink. Unit: kbps. Nullable: No
Default: 12288
MAX_IUB_RATE_UL Float Maximum Iub backhaul rate for uplink. Unit: kbps. Nullable: No
Default: 12288

NAME Text (60) Name of the site. Nullable: No


Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50

SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

2.2.40 SitesLists Table

For sites belonging to site lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the site list. Nullable: No


Default:

SITE_NAME Text (60) Name of the sites belonging to the list. Nullable: No
Default:

2.2.41 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

78 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

2.2.42 TMAEquipments Table

For tower-mounted amplifiers.

Field Type Description Attributes

DL_LOSSES Float Downlink losses of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the tower mounted amplifier. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0
UL_GAIN Float Uplink gain of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

2.2.43 TplTransmitters Table

For station templates.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default:

ANTDIVGAIN Float Antenna diversity gain. Unit: dB. Nullable: Yes


Default:
ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: No
Default:

AS_THRESHOLD Float Maximum signal level difference with the best-server to enter the active set. Nullable: Yes
Unit: dB. Default:

AZIMUT Float Azimuth of the main antenna. Nullable: Yes


Default:

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:
CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default:

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CARRIERS Text (255) List of carriers used by the transmitters. Nullable: Yes
Default:

CDMA_EQUIPMENT Text (50) Name of the CDMA site equipment. Nullable: Yes
Default:
CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: Yes
Default:

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default:

CELLS_POWER_SHARING Boolean Whether the cell powers are shared for HSDPA users or not. True=Yes; Nullable: No
False=No. Default:

© 2018 Forsk. All Rights Reserved. 79


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

CHANNEL_ELEMENTS_DL Integer Number of channel elements for downlink. Nullable: Yes


Default:

CHANNEL_ELEMENTS_UL Integer Number of channel elements for uplink. Nullable: Yes


Default:

COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:
DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default:

DYN_HS_SCCH_POWER_ALL Boolean HS-SCCH power allocation mode. True=Dynamic; False=Static. Nullable: No


OC Default:

DYN_HSDPA_POWER_ALLOC Boolean HSDPA power allocation mode. True=Dynamic; False=Static. Nullable: No


Default:
FBAND Text (50) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder equipment. Nullable: Yes


Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default:
FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes
Default:

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default:

HO_MARGIN Float Handover margin. Unit: dB. Nullable: Yes


Default:

HS_SCCH_POWER Float HS-SCCH transmission power. Equals maximum available power in dynamic Nullable: Yes
allocation. Default:
HSDPA_MAX_CODES Short Maximum number of HS-PDSCH codes. Nullable: Yes
Default:

HSDPA_MAX_USERS Short Maximum number of simultaneous HSDPA users. Nullable: Yes


Default:

HSDPA_MIN_CODES Short Minimum number of HS-PDSCH codes. Nullable: Yes


Default:
HSDPA_PWR Float HSDPA transmission power. Nullable: Yes
Default:

HSDPA_SCHEDULER Text (50) HSDPA scheduler. Nullable: Yes


Default:

HSPA_SUPPORT Short Supported HSPA features. 0=None; 1=HSDPA; 2=HSPA; 3=HSPA+. Nullable: Yes
Default:
HSUPA_DLPOWER Float Power dedicated to downlink HSUPA channels (E-AGCH, E-RGCH, E-HICH). Nullable: Yes
Default:

HSUPA_MAX_USERS Short Maximum number of simultaneous HSUPA users. Nullable: Yes


Default:

HSUPA_UL_LOAD Float Uplink load factor due to HSUPA users. Nullable: Yes
Default:
LAYER_LIST Text (50) List of network layer indexes used by the cells of the station template. Nullable: Yes
Default:

MAX_DL_LOAD Float Maximum allowed downlink load as percentage of max power. Unit: %. Nullable: Yes
Default:

MAX_EXT_NEIGHB_NUMBER Short Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:

80 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

MAX_INTERCAR_NEIGHB_NB Integer Maximum number of inter-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_IUB_RATE_DL Float Maximum Iub backhaul rate for downlink. Unit: kbps. Nullable: Yes
Default:

MAX_IUB_RATE_UL Float Maximum Iub backhaul rate for uplink. Unit: kbps. Nullable: Yes
Default:
MAX_NEIGHB_NUMBER Short Maximum number of intra-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_R99BEARER_DL_RATE Float Maximum downlink R99 throughput. Unit: kbps. Nullable: Yes
Default:

MAX_R99BEARER_UL_RATE Float Maximum uplink R99 throughput. Unit: kbps. Nullable: Yes
Default:
MAX_RANGE Integer Maximum coverage range. Nullable: Yes
Default:

MAX_UL_LOAD Float Maximum allowed uplink load. Unit: %. Nullable: Yes


Default:

MIMO_SUPPORT Short Supported MIMO features. 0=None; 1=Transmit Diversity; 2=SU-MIMO. Nullable: Yes
Default:
MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes
Default:

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default:

MULTI_CARRIER Short Multi-carrier mode. 0=None; 1=DL multi-cell; 2=DL/UL multi-cell. Nullable: Yes
Default:

NAME Text (50) Name of the station template. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default:

NUM_HS_SCCH Short Number of HS-SCCH channels. Nullable: Yes


Default:

NUM_HSDPA_USERS Short Number of served HSDPA users. Nullable: Yes


Default:
NUM_HSUPA_USERS Short Number of served HSUPA users. Nullable: Yes
Default:

NUM_RX_ANTENNAS Short Number of reception antenna ports available at the transmitter. 1; 2; 4. Nullable: Yes
Default:

NUM_SECTORS Integer Number of sectors in the station template. Nullable: Yes


Default: 3
NUM_TX_ANTENNAS Short Number of transmission antenna ports available at the transmitter. Nullable: Yes
Default:

OTHERS_CCH_POWER Float Transmission power of other common channels (except SCH). Nullable: Yes
Default:

PILOT_POWER Float Power of the pilot channel. Nullable: Yes


Default:
POWER_MAX Float Cell's maximum transmission power. Nullable: Yes
Default:

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:

PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

© 2018 Forsk. All Rights Reserved. 81


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

PWR_HEADROOM Float Power control headroom for DCH. Unit: dB. Nullable: Yes
Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default:

REUSE_DIST Float Minimum reuse distance for scrambling codes. Nullable: Yes
Default:
RSCP_MIN Float Minimum received signal code power for coverage. Nullable: Yes
Default:

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default:

SC_DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: Yes
Default:
SCH_POWER Float Power of the synchronisation (SCH) channel. Nullable: Yes
Default:

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:
SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes
Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default:

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TOTAL_POWER Float Total downlink transmission power. Nullable: Yes


Default:
TX_DIVERSITY_CFG Integer Transmit diversity configuration. 1=No diversity; 2=Open loop; 3=Closed Nullable: Yes
loop. Default:

TX_MAX_POWER Float Maximum power sharable between sectors. Nullable: Yes


Default:

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default:
UL_LOAD Float Uplink load factor. Unit: %. Nullable: Yes
Default:

UL_REUSE_FACTOR Float Uplink (I intra+ I extra)/ I intra. Unit: dB. Nullable: Yes
Default:

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default:

2.2.44 Transmitters Table

For transmitters.

82 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:
ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No
Default: True

ANTDIVGAIN Float Antenna diversity gain. Unit: dB. Nullable: Yes


Default: 0

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: Yes
Default:
AZIMUT Float Azimuth of the main antenna. Nullable: Yes
Default: 0

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default: 4000
CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default: 50

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:
CELL_SIZE Float Hexagon radius. Nullable: Yes
Default: 2000
CELLS_POWER_SHARING Boolean Whether the cell powers are shared for HSDPA users or not. True=Yes; Nullable: No
False=No. Default: False

COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DX Float X coordinate relative to the site location. Nullable: Yes


Default: 0
DY Float X coordinate relative to the site location. Nullable: Yes
Default: 0

FBAND Text (50) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder. Nullable: Yes


Default:
FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes
Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default: 0

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default: 25
HEXAGON_GROUP Text (50) Group of hexagons used to create the transmitter. Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:

MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes


Default: 0
MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 83


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

MULTI_CARRIER Short Multi-carrier mode. 0=None; 1=DL multi-cell; 2=DL/UL multi-cell. Nullable: Yes
Default: 0

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default: 5

NUM_RX_ANTENNAS Short Number of reception antenna ports available at the transmitter. 1; 2; 4. Nullable: No
Default: 1
NUM_TX_ANTENNAS Short Number of transmission antenna ports available at the transmitter. Nullable: No
Default: 1

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default: ’Default model’

PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:
REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default: 0

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:
SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:

SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes


Default: 0

SITE_NAME Text (60) Name of the site on which the transmitter is located. Nullable: No
Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default: 0
TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TX_DIVERSITY_CFG Short Transmit diversity configuration. 1=No diversity; 2=Open loop; 3=Closed Nullable: Yes
loop. Default: 0

TX_ID Text (100) Name of the transmitter. Nullable: No


Default:
TX_MAX_POWER Float Maximum power sharable between sectors. Nullable: Yes
Default: 43

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

2.2.45 TxsLists Table

For transmitters belonging to transmitter lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the transmitter list. Nullable: No


Default:
TX_NAME Text (100) Name of the transmitters belonging to the list. Nullable: No
Default:

84 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

2.2.46 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

NAME Text (50) Name of the transmitter list. Nullable: No


Default:

2.2.47 UECategories Table

For HSDPA UE categories.

Field Type Description Attributes

MAX_BLOCK_SIZE Integer Maximum transport block size. Nullable: Yes


Default: 26000

MAX_HSPDSCH_NUM Short Maximum number of HS-PDSCH channels for HSDPA. Nullable: Yes
Default: 5
MIMO_SUPPORT Short Supported MIMO features. 0=None; 1=MIMO. Nullable: No
Default: 0

MIN_INTERTTI_NUM Short Minimum number of TTI between two used TTIs. Nullable: Yes
Default: 1

MODULATION Short Highest modulation used by the HSDPA UE category. 0=QPSK; 1=16QAM; Nullable: No
2=64QAM. Default: 0
MULTI_CARRIER Short Multi-carrier mode. 0=None; 1=2C; 2=3C; 3=4C; 4=6C; 5=8C. Nullable: No
Default: 0

UE_CATEGORY Short HSDPA UE category. Nullable: No


Default:

UE_CATEGORY_NAME Text (50) Name of the HSDPA UE category. Nullable: Yes


Default:

2.2.48 ulayers Table

For heterogeneous network (HetNet) deployment layers.

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer. Nullable: No


Default:
MAX_SPEED Float Maximum user speed supported by the layer. Unit: km/h. Nullable: Yes
Default: 300

NAME Text (50) Name of the network layer. Nullable: No


Default:

PRIORITY Short Layer priority. 0=Lowest. Nullable: No


Default: 0

© 2018 Forsk. All Rights Reserved. 85


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

2.2.49 UERxEquipments Table

For names of UE reception equipment.

Field Type Description Attributes

NAME Text (50) Name of reception equipment. Nullable: No


Default:

2.2.50 UMTSEnvironmentDefs Table

For traffic environment types.

Field Type Description Attributes

DENSITY Float Number of users per km2. Nullable: Yes


Default: 0

ENVIRONMENT Text (50) Name of the traffic environment. Nullable: No


Default:
MOBILITY Text (50) Mobility type corresponding to the traffic environment. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the traffic environment. Nullable: No
Default:

2.2.51 UMTSMobility Table

For mobility types.

Field Type Description Attributes

HSSCCH_ECNT Float Target HS-SCCH Ec/Nt for HSDPA. Unit: dB. Nullable: Yes
Default: -12

MEAN_SPEED Float Average user speed corresponding to the mobility type. Unit: km/h. Nullable: Yes
Default: 0
NAME Text (50) Name of the mobility type. Nullable: No
Default:

TADD Float Minimum Ec/Io for best server selection. Unit: dB. Nullable: No
Default:

2.2.52 UMTSServices Table

For services.

86 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

ADPCH_ACTIVITY Float Activity factor for HSDPA users. Nullable: Yes


Default: 0.1

BODY_LOSS Float Body loss. Unit: dB. Nullable: No


Default: 0
CARRIER_LIST Text (50) List of preferred or allowed carrier numbers. Nullable: Yes
Default:

CARRIER_SUPPORT Integer Type of carrier list. 0=Prefered carriers; 1=Allowed carriers. Nullable: Yes
Default: 0

CPC_SUPPORT Short Continuous packet connectivity support. 0=None; 1=HSPA DRX/DTX; 2=HS- Nullable: Yes
SCCH-less operation; 4=HS-FACH. Default: 0
DL_ACTIVITY Float Activity factor for circuit switched services on the downlink. Nullable: Yes
Default: 1

DL_DP Float Inter-packet arrival time on the downlink. Unit: ms. Nullable: Yes
Default: 0

DL_DPC Float Reading time between two packet calls on the downlink. Unit: ms. Nullable: Yes
Default: 0
DL_GBR Float Downlink guaranteed bit rate. Unit: kbps. Nullable: Yes
Default:

DL_MBR Float Downlink maximum bit rate. Unit: kbps. Nullable: Yes
Default:

DL_NPC Integer Number of packet calls during a session on the downlink. Nullable: Yes
Default: 1
DL_PACKET_EFFICIENCY Float Packet efficiency factor on the downlink. Nullable: Yes
Default:
DL_SP Integer Packet size on the downlink. Unit: Byte. Nullable: Yes
Default: 1500

DL_SPC_MAX Float Maximum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 2000

DL_SPC_MIN Float Minimum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 4
EDPCH_ACTIVITY Float Activity factor for HSUPA users. Nullable: Yes
Default: 0.1

ENABLE_DOWNGRADING Boolean Whether bearer downgrading is allowed or not. True=Yes; False=No. Nullable: No
Default: True

NAME Text (50) Name of the service. Nullable: No


Default:
PRIORITY Integer Service priority. 0=Lowest. Nullable: Yes
Default: 0

R99BEARER Text (50) Name of the R99 bearer. Nullable: Yes


Default:

REQ_AVERAGE_DL_RATE Float Average requested throughput on the downlink. Unit: kbps. Nullable: Yes
Default:
REQ_AVERAGE_UL_RATE Float Average requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default:

SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the service. Nullable: No
Default: “-1”

TH_OFFSET Float Fixed offset to map throughput to the application layer. Nullable: No
Default: 0
TH_SCALE_FACTOR Float Ratio between application throughput and RLC layer throughput. Nullable: No
Default: 95

© 2018 Forsk. All Rights Reserved. 87


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

TYPE Short Type of service. 0=Circuit (R99); 1=Packet (R99); 2=Packet (HSDPA - Best Nullable: No
effort); 3=Packet (HSPA - Best effort); 4=Packet (HSPA - Constant bit rate); Default: 0
5=Packet (HSDPA - Variable bit rate); 6=Packet (HSPA - Variable bit rate).

UL_ACTIVITY Float Activity factor for circuit-switched service on the uplink. Nullable: Yes
Default: 1

UL_DP Float Inter-packet arrival time on the uplink. Unit: ms. Nullable: Yes
Default: 0

UL_DPC Float Reading time between two packet calls in uplink. Unit: ms. Nullable: Yes
Default: 0
UL_GBR Float Uplink guaranteed bit rate. Unit: kbps. Nullable: Yes
Default:

UL_MBR Float Uplink maximum bit rate. Unit: kbps. Nullable: Yes
Default:

UL_NPC Integer Reading time between two packet calls on the uplink. Unit: ms. Nullable: Yes
Default: 1
UL_PACKET_EFFICIENCY Float Number of packet calls during a session on the uplink. Nullable: Yes
Default:

UL_SP Integer Packet size on the uplink. Unit: bytes. Nullable: Yes
Default: 1500

UL_SPC_MAX Float Maximum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 2000
UL_SPC_MIN Float Minimum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 4

USE_HANDOFF Boolean Whether the service supports soft handover or not. True=Yes; False=No. Nullable: No
Default: False

2.2.53 UMTSServicesQuality Table

For release 99 service access thresholds.

Field Type Description Attributes

DL_TARGET_QUAL Float Downlink quality target. Unit: dB. Nullable: Yes


Default: 0

DL_TGT_QUAL_DIVCLOSED Float Downlink quality target for closed-loop diversity. Unit: dB. Nullable: Yes
Default: 0
DL_TGT_QUAL_DIVOPEN Float Downlink quality target for open-loop diversity. Unit: dB. Nullable: Yes
Default: 0

MOBILITY Text (50) Mobility type corresponding to the R99 bearer quality requirements. Nullable: No
Default:

RX_EQUIP Text (50) Name of the reception equipment corresponding to the R99 bearer quality Nullable: No
requirements. Default: “Standard”
SERVICE Text (50) Name of the R99 bearer. Nullable: No
Default:

UL_TARGET_QUAL Float Uplink quality target. Unit: dB. Nullable: Yes


Default: 0

UL_TGT_QUAL_DIV2RX Float Uplink quality target for 2-port reception diversity. Unit: dB. Nullable: Yes
Default: 0
UL_TGT_QUAL_DIV4RX Float Uplink quality target for 4-port reception diversity. Unit: dB. Nullable: Yes
Default: 0

88 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

2.2.54 UMTSServicesUsage Table

For user profile parameters.

Field Type Description Attributes

CALL_DURATION Float Average duration of a call for circuit-switched services. Unit: s. Nullable: Yes
Default:

CALL_NUMBER Float Average number of calls per hour for circuit-switched services or average Nullable: Yes
number of sessions per hour for packet-switched services. Default: 0

DL_VOLUME Float Data volume transferred on the downlink during a session for packet- Nullable: Yes
switched services. Unit: kB. Default:
SERVICE Text (50) Name of the service corresponding to the user profile. Nullable: No
Default:

TERMINAL Text (50) Name of the terminal corresponding to the user profile. Nullable: No
Default:

UL_VOLUME Float Data volume transferred on the uplink during a session for packet-switched Nullable: Yes
services. Unit: kB. Default:
USER_PROFILE Text (50) Name of the user profile corresponding to the user profile. Nullable: No
Default:

2.2.55 UMTSTerminals Table

For terminals types.

Field Type Description Attributes

ACTIVE_SET_SIZE Short Maximum number of servers in the active set. Nullable: No


Default: 3

CPC_SUPPORT Short Continuous packet connectivity support. 0=None; 1=HSPA DRX/DTX; 2=HS- Nullable: Yes
SCCH-less operation; 4=HS-FACH. Default: 0

ENABLE_COMPRESSED_MOD Boolean Whether compressed mode is active or not. True=Yes; False=No. Nullable: No
E Default: False
GAIN Float Terminal antenna gain. Unit: dB. Nullable: Yes
Default: 0

HSPA_SUPPORT Short Supported HSPA features. 0=None; 1=HSDPA; 2=HSPA. Nullable: No


Default: 0

HSUPA_UE_CATEGORY Short HSUPA UE category. Nullable: Yes


Default: 1
LOSS Float Terminal antenna loss. Unit: dB. Nullable: Yes
Default: 0

MUD_FACTOR Float Multi-user detection factor to model intra-cell interference reduction for Nullable: Yes
HSDPA terminals. Default: 0

NAME Text (50) Name of the terminal. Nullable: No


Default:
NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

NUM_RX_ANTENNAS Short Number of reception antenna ports available at the terminal. 1; 2. Nullable: No
Default: 1

PMAX Float Maximum transmission power of the terminal. Nullable: Yes


Default: 21

© 2018 Forsk. All Rights Reserved. 89


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

PMIN Float Minimum transmission power of the terminal. Nullable: Yes


Default: -20

RAKE_EFFICIENCY Float Efficiency of the rake receiver. Nullable: Yes


Default: 1

RHO_FACTOR Short CDMA rho factor for self interference. Nullable: No


Default: 100
RX_EQUIP Text (50) Name of the reception equipment associated with the terminal. Nullable: Yes
Default: “Standard”

SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the terminal. Nullable: No
Default: “-1”

UE_CATEGORY Short HSDPA UE category of the terminal. Nullable: Yes


Default: 1

2.2.56 UMTSTraficEnvironments Table

For traffic environment clutter weighting.

Field Type Description Attributes


CLUTTER_WEIGHTS Binary Clutter weighting for traffic environment maps. Nullable: Yes
Default: Yes

NAME Text (50) Name of the traffic environment. Nullable: No


Default:

2.2.57 UMTSUserProfiles Table

For names of user profiles.

Field Type Description Attributes

NAME Text (50) Name of the user profile. Nullable: No


Default:

2.2.58 Units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, and the
database internal coordinate system.

Field Type Description Attributes

COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes


Default: -1

90 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Field Type Description Attributes

GAIN_UNIT Integer Unit used for gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0

PROJECTION Integer Projection coordinate system of the document. Nullable: Yes


Default: -1

RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0
TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No
Default: 0

2.2.59 uterminalbands Table

For frequency bands supported by terminals.

Field Type Description Attributes

FBAND_NAME Text (50) Name of the frequency band supported by the terminal. Nullable: No
Default:

LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0
NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

TERMINAL_NAME Text (50) Name of the terminal corresponding to the supported frequency band. Nullable: No
Default:

2.3 Relationships

Many-to-One Relationships (  1)

CdmaCells.HSDPA_SCHEDULER Schedulers.NAME

CdmaCells.LAYER ulayers.LAYER_INDEX

CdmaCells.SC_DOMAIN_NAME ScramblingCodesDomains.DOMAIN_NAME

CdmaCells.TX_ID Transmitters.TX_ID

CdmaEqptsHSUPARssUse.BEARER_INDEX HSUPABearers.BEARER_INDEX

CdmaEqptsHSUPARssUse.EQUIPMENT CdmaEquipments.NAME
CdmaEquipments.SCHEDULER_ALGO Schedulers.NAME

CdmaEquipmentsCEsUse.EQUIPMENT CdmaEquipments.NAME

CdmaEquipmentsCEsUse.SERVICE R99Bearers.NAME
HSDPABearerSelectTables.MOBILITY UMTSMobility.NAME

HSDPABearerSelectTables.RX_EQUIP UERxEquipments.NAME

HSDPAQualityTables.BEARER_INDEX HSDPABearers.BEARER_INDEX

HSDPAQualityTables.MOBILITY UMTSMobility.NAME

HSDPAQualityTables.QI_NAME QualityIndicators.NAME

HSDPAQualityTables.RX_EQUIP UERxEquipments.NAME

HSPAMIMOConfigs.HSDPA_BEARER_INDEX HSDPABearers.BEARER_INDEX

HSPAMIMOConfigs.MOBILITY UMTSMobility.NAME

© 2018 Forsk. All Rights Reserved. 91


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

Many-to-One Relationships (  1)

HSPAMIMOConfigs.RX_EQUIP UERxEquipments.NAME

HSUPABearerSelection.BEARER_INDEX HSUPABearers.BEARER_INDEX

HSUPABearerSelection.MOBILITY UMTSMobility.NAME

HSUPABearerSelection.RX_EQUIP UERxEquipments.NAME

HSUPAQualityTables.BEARER_INDEX HSUPABearers.BEARER_INDEX

HSUPAQualityTables.MOBILITY UMTSMobility.NAME

HSUPAQualityTables.QI_NAME QualityIndicators.NAME

HSUPAQualityTables.RX_EQUIP UERxEquipments.NAME

MUGTables.SCHEDULER_NAME Schedulers.NAME

Neighbours.NEIGHBOUR CdmaCells.CELL_ID

Neighbours.TRANSMITTER CdmaCells.CELL_ID

NeighboursConstraints.NEIGHBOUR CdmaCells.CELL_ID

NeighboursConstraints.TRANSMITTER CdmaCells.CELL_ID

NeighboursConstraintsExt.TRANSMITTER CdmaCells.CELL_ID

NeighboursExt.TRANSMITTER CdmaCells.CELL_ID

Networks.DEFAULT_MODEL PropagationModels.NAME

Receivers.ANTENNA Antennas.NAME

Repeaters.DONOR_CELLID Transmitters.TX_ID

Repeaters.DONOR_PROPAG_MODEL PropagationModels.NAME
Repeaters.EQUIPMENT_NAME RepeaterEquipments.NAME

Repeaters.FEEDER_NAME FeederEquipments.NAME

Repeaters.REC_ANTENNA Antennas.NAME
Repeaters.TX_ID Transmitters.TX_ID

ScramblingCodesGroups.DOMAIN_NAME ScramblingCodesDomains.DOMAIN_NAME

SecondaryAntennas.ANTENNA Antennas.NAME
SecondaryAntennas.TX_ID Transmitters.TX_ID

Separations.TX_ID CdmaCells.CELL_ID

Separations.TX_ID_OTHER CdmaCells.CELL_ID
ServiceQualityTables.MOBILITY UMTSMobility.NAME

ServiceQualityTables.QI_NAME QualityIndicators.NAME

ServiceQualityTables.RX_EQUIP UERxEquipments.NAME

ServiceQualityTables.SERVICE R99Bearers.NAME

Sites.CDMA_EQUIPMENT CdmaEquipments.NAME

SitesLists.LIST_NAME SitesListsNames.NAME

SitesLists.SITE_NAME Sites.NAME

Transmitters.ANTENNA_NAME Antennas.NAME

Transmitters.BTS_NAME BTSEquipments.NAME
Transmitters.FBAND FrequencyBands.NAME

Transmitters.FEEDER_NAME FeederEquipments.NAME

Transmitters.PROPAG_MODEL PropagationModels.NAME

Transmitters.PROPAG_MODEL2 PropagationModels.NAME

Transmitters.SITE_NAME Sites.NAME

Transmitters.TMA_NAME TMAEquipments.NAME

TxsLists.LIST_NAME TxsListsNames.NAME

92 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 2: UMTS HSPA Data Structure

Many-to-One Relationships (  1)

TxsLists.TX_NAME Transmitters.TX_ID

UMTSEnvironmentDefs.ENVIRONMENT UMTSTraficEnvironments.NAME

UMTSEnvironmentDefs.MOBILITY UMTSMobility.NAME

UMTSEnvironmentDefs.USER_PROFILE UMTSUserProfiles.NAME

UMTSServices.R99BEARER R99Bearers.NAME

UMTSServicesQuality.MOBILITY UMTSMobility.NAME

UMTSServicesQuality.RX_EQUIP UERxEquipments.NAME

UMTSServicesQuality.SERVICE R99Bearers.NAME

UMTSServicesUsage.SERVICE UMTSServices.NAME

UMTSServicesUsage.TERMINAL UMTSTerminals.NAME

UMTSServicesUsage.USER_PROFILE UMTSUserProfiles.NAME

UMTSTerminals.HSUPA_UE_CATEGORY HSUPAUECategories.UE_CATEGORY

UMTSTerminals.RX_EQUIP UERxEquipments.NAME

UMTSTerminals.UE_CATEGORY UECategories.UE_CATEGORY

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

uterminalbands.FBAND_NAME FrequencyBands.NAME

uterminalbands.TERMINAL_NAME UMTSTerminals.NAME

© 2018 Forsk. All Rights Reserved. 93


Atoll 3.4.0 Data Structure Reference Guide
Chapter 2: UMTS HSPA Data Structure

94 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

3 CDMA2000 Data Structure


Atoll supports integrated network planning for CDMA2000 networks. This section describes the CDMA2000 data
structure used in Atoll. It lists all the tables and fields found in the CDMA2000 template and the relationships
between them.

 Primary keys are listed in bold and italic characters.

3.1 Data Structure Changes from Atoll 3.3 to 3.4

3.1.1 Added Tables and Fields

FeederEquipments Table

Field Type Description Attributes

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

Sites Table

Field Type Description Attributes


ALIAS_ Text (60) Site alias. Nullable: Yes
Default:

Transmitters Table

Field Type Description Attributes


ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

3.1.2 Deleted Tables and Fields

None.

© 2018 Forsk. All Rights Reserved. 95


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

3.2 Data Structure

3.2.1 Antennas Table

For antennas.

Field Type Description Attributes

BEAMWIDTH Float The half-power beamwidth of the antenna model. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the antenna model. Nullable: Yes
Default:

CONSTRUCTOR Text (50) Name of the antenna manufacturer. Nullable: Yes


Default:

DIAGRAM Binary Antenna horizontal and vertical patterns. Nullable: Yes


Default:
ELECTRICAL_AZIMUTH Float The electrical azimuth of the antenna model. Nullable: Yes
Default:

ELECTRICAL_TILT Float The electrical tilt of the antenna model. Nullable: Yes
Default:

FMAX Double Maximum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:
FMIN Double Minimum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:

GAIN Float Antenna model gain compared to an isotropic radiator. Unit: dBi. Nullable: No
Default: 0

NAME Text (50) Name of the antenna model. Nullable: No


Default:

PHYSICAL_ANTENNA Text (50) Name of the physical antenna to which the antenna model belongs. Nullable: Yes
Default:

 The format of the binary field, DIAGRAM, is described in "RF 2D Antenna Pattern
Format" on page 355.

3.2.2 BTSEquipments Table

For NodeB equipment.

Field Type Description Attributes

CONFIG_DL_LOSSES Float Downlink losses due to transmitter components (duplexer, combiner, etc.). Nullable: Yes
Unit: dB. Default: 0

96 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

CONFIG_UL_LOSSES Float Uplink losses due to transmitter components (duplexer, combiner, etc.). Unit: Nullable: Yes
dB. Default: 0

NAME Text (50) Name of transmitter equipment. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of transmitter equipment. Unit: dB. Nullable: Yes
Default: 0
RHO_FACTOR Short CDMA rho factor for self interference (not used in other technologies). Nullable: Yes
Default: 100

3.2.3 CarriersType Table

For carrier type definition (1xEV-DO or 1xRTT).

Field Type Description Attributes

CARRIER Integer Carrier number Nullable: No


Default: 0

TYPE Short Type of carrier. 0=1xRTT; 1=1xEV-DO. Nullable: Yes


Default: 0

3.2.4 CDMACells Table

For cells.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True
BCMCS_RATE Float BCMCS service rate. Unit: kbps. Nullable: Yes
Default: 204.8

BCMCS_TS_PCT Float Percentage of timeslots dedicated to BCMCS service. Unit: %. Nullable: Yes
Default: 5

CARRIER Integer Carrier number. Nullable: Yes


Default: 0
CCH_TS_PCT Float Percentage of time slots dedicated to common control channels. Unit: %. Nullable: Yes
Default: 3

CELL_ID Text (100) Name of the cell. Nullable: No


Default:

CELL_IDENTITY Integer Cell identity. Nullable: Yes


Default:
COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:

DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default: 0

DRC_ER_RATE Float DRC erasure rate. Nullable: Yes


Default: 25
IDLE_POWER_GAIN Float Gain dedicated to transmitted power in idle state. Unit: dB. Nullable: Yes
Default: -10

LOCKED_PNO Boolean PN offset allocation status. True=Locked; False=Modifiable. Nullable: No


Default: False

© 2018 Forsk. All Rights Reserved. 97


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

MAX_DL_LOAD Float Maximum allowed downlink load as percentage of max power. Unit: %. Nullable: Yes
Default: 50

MAX_EVDO_USERS Integer Maximum number of EV-DO users. Nullable: No


Default: 256

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:
MAX_INTERCAR_NEIGHB_NB Integer Maximum number of inter-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Integer Maximum number of intra-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_UL_LOAD Float Maximum allowed uplink load. Unit: %. Nullable: Yes


Default: 75
MUG_TABLE Memo Multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:

PAGING_POWER Float Transmission power of the paging channel. Nullable: Yes


Default: 30

PILOT_POWER Float Power of the pilot channel. Nullable: Yes


Default: 33
PN_DOMAIN_NAME Text (50) PN offset domain name. Nullable: Yes
Default:

PN_OFFSET Integer PN offset. Nullable: Yes


Default:

POOLED_PWR Float Amount of power which can be borrowed in the BTS power pool. Unit: dB. Nullable: No
Default: 1

POWER_MAX Float Cell's maximum transmission power. Nullable: Yes


Default: 43
REUSE_DIST Float Minimum reuse distance for PN offsets. Nullable: Yes
Default:

ROT_RANGE Float Range of acceptable noise rise. Unit: dB. Nullable: Yes
Default: 1

ROT_TARGET Float Receiver noise rise over thermal target. Unit: dB. Nullable: Yes
Default: 4
RSCP_MIN Float Minimum received signal code power. Nullable: Yes
Default: -150

SYNCHRO_POWER Float Power of the synchronisation (SCH) channel. Nullable: Yes


Default: 23

TADD Float Minimum Ec/Io for best server selection. Unit: dB. Nullable: Yes
Default: -14
TDROP Float Ec/Io threshold for active set rejection. Unit: dB. Nullable: Yes
Default: -17

TOTAL_POWER Float Total downlink transmission power. Nullable: Yes


Default:

TX_CELL_ORDER Short Order of the cell within a transmitter. Nullable: Yes


Default:
TX_ID Text (100) Name of the transmitter to which the cell belongs. Nullable: No
Default:

UL_LOAD Float Uplink load factor. Unit: %. Nullable: Yes


Default:

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default: 0

98 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

3.2.5 CDMAEquipments Table

For site equipment.

Field Type Description Attributes

CARRIER_SELECTION Short Intra-Node-B carrier selection mode. 0=Min UL load factor; 1=Min DL total Nullable: No
power; 2=Random; 3=Sequential. Default: 0

CE_SHARED_ALL_SECTORS Boolean Whether channel elements are shared among sectors of a site or not. Nullable: No
True=Yes; False=No. Default: False

CES_OVERHEAD_DL Integer Number of channel elements used by downlink overhead channels. Nullable: No
Default: 0
CES_OVERHEAD_UL Integer Number of channel elements used by uplink overhead channels. Nullable: No
Default: 0

MANUFACTURER Text (50) Name of the site equipment manufacturer. Nullable: Yes
Default:

MUD_FACTOR Float MUD factor for uplink interference cancellation. Nullable: No


Default: 0
NAME Text (50) Name of the site equipment. Nullable: No
Default:

RAKE_EFFICIENCY Float Efficiency of the rake receiver. Nullable: No


Default: 1

SPP Boolean Whether the equipment supports sector power pooling or not. True=Yes; Nullable: No
False=No. Default: False
USE_NEIGHBOURS Boolean Whether the active set selection is limited to neighbours or not. True=Yes; Nullable: No
False=No. Default: False

3.2.6 CDMAEquipmentsCEsUse Table

For channel elements consumption in site equipment.

Field Type Description Attributes

CHANNEL_ELTS_DL Float Number of channel elements used for downlink. Nullable: No


Default: 1

CHANNEL_ELTS_UL Float Number of channel elements used for uplink. Nullable: No


Default: 1

EQUIPMENT Text (50) Name of the site equipment. Nullable: No


Default:
TERMINAL Text (50) Name of the terminal corresponding to the channel element usage. Nullable: No
Default:

3.2.7 CoordSys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

© 2018 Forsk. All Rights Reserved. 99


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default: 0

DATUM_CODE Double Identification code of the datum. Nullable: Yes


Default: 0
DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes
Default: 0

DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0
DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0

DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes


Default: 0

DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes


Default: 0
DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes
Default: 0

ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No


Default: 0

ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes


Default: 0
ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes
Default: 0
GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:

PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes


Default: 0

PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes


Default: 0
PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes
Default: 0

PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0
PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes


Default: 0

100 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

3.2.8 CustomFields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:

CHOICE_LIST Memo Choice list for text fields. Nullable: Yes


Default:

CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default: 0
COLUMN_NAME Text (50) Name of the custom field. Nullable: No
Default:

DEFAULT_VALUE Text (50) Default value for the field. Nullable: Yes
Default:

DISPLAY_TYPE Integer Whether the field is hypertext or regular and modifiable or read-only. Nullable: Yes
0=Regular and modifiable; 1=Regular and read-only; 2=Hypertext and mod- Default: 0
ifiable; 3=Hypertext and read-only

GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:

TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.
 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.
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


 Table and field names are case sensitive.
 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any table in Atoll, including user-defined fields that you add to the Atoll tables. The values defined in this

© 2018 Forsk. All Rights Reserved. 101


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the
appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

3.2.9 DLBearersSelection Table

For downlink bearer selection thresholds.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: Yes


Default: 0

CI_REQ Float Required pilot C/I. Unit: dB. Nullable: Yes


Default:

EARLY_TERM_TABLE Memo Early termination probability graphs as a function of the number of repeti- Nullable: Yes
tions. Default:
MOBILITY Text (50) Mobility type corresponding to the downlink bearer selection thresholds. Nullable: Yes
Default:

MODULATION Short Modulation. 0=QPSK; 1=8PSK; 2=16QAM; 3=64QAM. Nullable: No


Default: 0

NUM_SLOTS Integer Number of slots. Nullable: Yes


Default: 1
RX_EQUIP Text (50) Reception equipment corresponding to the bearer selection thresholds. Nullable: Yes
Default: "Standard"

3.2.10 DLDORABearers Table

For downlink EV-DO Rev. A bearers.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: No


Default:

RLC_PEAK_RATE Float RLC throughput of the bearer. Unit: kbps: Nullable: Yes
Default: 0
TRANSPORT_BLOCK_SIZE Integer Transport block size. Unit: bits. Nullable: Yes
Default: 0

102 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

3.2.11 DORABearers Table

For uplink EV-DO Rev. A bearers.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: No


Default:

RLC_PEAK_RATE Float RLC throughput of the bearer. Unit: kbps: Nullable: Yes
Default: 0

TRANSPORT_BLOCK_SIZE Integer Transport block size. Unit: bits. Nullable: Yes


Default: 0

3.2.12 DORABearersProba Table

For uplink EV-DO Rev. A bearer probabilities.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: No


Default:

PROBA Float Probability of using an EV-DO Rev A bearer. Nullable: No


Default: 0

SERVICE Text (50) Name of the service corresponding to the bearer selection probabilities. Nullable: No
Default:

3.2.13 DORATerminalT2PRatios Table

For uplink traffic to pilot gains.

Field Type Description Attributes

AUX_PILOT_GAIN Float Auxiliary pilot gain. Unit: dB. Nullable: Yes


Default:
BEARER_INDEX Short Bearer index. Nullable: No
Default: 0

HC_T2P_GAIN Float Traffic to pilot gain for high capacity services. Unit: dB. Nullable: Yes
Default:

LL_T2P_GAIN Float Traffic to pilot gain for low latency services. Unit: dB. Nullable: Yes
Default:
TERMINAL Text (50) Name of the terminal corresponding to the EV-DO Rev A T2P ratios. Nullable: No
Default:

3.2.14 FeederEquipments Table

For feeders.

© 2018 Forsk. All Rights Reserved. 103


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

CONNECTOR_LOSSES_DL Float Feeder connector losses in downlink. Unit: dB. Nullable: Yes
Default: 0

CONNECTOR_LOSSES_UL Float Feeder connector losses in uplink. Unit: dB. Nullable: Yes
Default: 0
LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes
Default:

LOSS_PER_METER Float Feeder loss per meter. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the feeder. Nullable: No


Default:

3.2.15 FrequencyBands Table

For frequency bands.

Field Type Description Attributes

BAND_WIDTH Double Carrier width. Unit: MHz. Nullable: Yes


Default: 5

DELTA_CN Integer Step between two adjacent carrier numbers. Nullable: Yes
Default: 1

EXCLUDED_CHANNELS Text (255) List of carrier numbers not part of the usable spectrum. Nullable: Yes
Default:
FIRST_CARRIER Integer First carrier number in the frequency band. Nullable: Yes
Default: 0

FREQUENCY Double Downlink start frequency of the first carrier of the frequency band. Unit: MHz. Nullable: Yes
Default: 2110

LAST_CARRIER Integer Last carrier number in the frequency band. Nullable: Yes
Default: 0

NAME Text (50) Name of the frequency band. Nullable: No


Default:

3.2.16 InterfReductionFactors Table

For interference reduction factors between carriers.

Field Type Description Attributes


CARRIER1 Integer Number of the first carrier in the inter-carrier IRF relation. Nullable: No
Default: 0

CARRIER2 Integer Number of the second carrier in the inter-carrier IRF relation. Nullable: No
Default: 0

FACTOR Double Interference reduction factor between two carrier numbers. Unit: dB. Nullable: No
Default: 200

3.2.17 InterNetChProtect Table

For inter-network interference reduction factor graphs.

104 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

ICP Memo Inter-RAT interference reduction graph as a function of frequency difference Nullable: Yes
between channels. Default:

ITF_BW Double Channel width of the interferer cell. Unit: kHz. Nullable: No
Default: 0
ITF_TECHNO Text (50) Technology of the interfering cell. Nullable: No
Default:

V_BW Double Channel width of the interfered cell. Unit: kHz. Nullable: No
Default: 0

3.2.18 Neighbours Table

For intra-technology neighbour relations.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

RELATION_TYPE Short Type of the neighbour relation. 0=Intra-carrier; 1=Inter-carrier. Nullable: Yes
Default:

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

3.2.19 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

Field Type Description Attributes


IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0
TRANSMITTER Text (50) Name of the source cell. Nullable: No
Default:

3.2.20 NeighboursConstraintsExt Table

For inter-technology neighbour allocation constraints.

© 2018 Forsk. All Rights Reserved. 105


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:
STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

3.2.21 NeighboursExt Table

For inter-technology neighbour relations.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

3.2.22 Networks Table

For network-level parameters.

Field Type Description Attributes

ADD_MRC_SOFTERSOFT Boolean Whether MRC gain should be applied to softer/soft handovers or not. Nullable: No
True=Yes; False=No. Default: False
DEFAULT_HOGAIN_UL Float Default uplink soft handover gain. Unit: dB. Nullable: No
Default: 0

DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes


Default: ‘Cost-Hata’

DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No


Default: 50
DMAX Float Maximum radius for a cell. Nullable: No
Default: -1

INTERFERERS_RX_THRESH Float Lowest received interference level. Nullable: Yes


Default: -130

IOISNTOT Boolean Wether Io includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: True
NAME Text (50) Name of the network. Nullable: No
Default:

106 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False

POWERS_RELATIVE_TO_PILO Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
T values or as offsets to the pilot power. True=Relative; False=Absolute. Default: False

PTOT_RELATIVE_TO_PMAX Boolean Whether the total cell power is defined as absolute value or as offset to the Nullable: No
maximum power. True=Relative; False=Absolute. Default: False
RSCP_MIN Float Minimum received signal code power for coverage. Nullable: Yes
Default: -150

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:
SPREADING_WIDTH Float Spreading width. Unit: MHz. Nullable: Yes
Default: 1.2288

SYSTEM_ Text (50) Name of the system. Nullable: No


Default: ‘1xRTT’

TECHNOLOGY Text (10) Name of the technology. Nullable: No


Default: ‘CDMA’
UC_PWC_ON_PILOT Boolean Whether the uplink power control is based on pilot’s target or not. True=Yes; Nullable: No
False=No. Default: False

3.2.23 PnCodesDomains Table

For names of PN offset domains.

Field Type Description Attributes


DOMAIN_NAME Text (50) Name of the PN offset domain. Nullable: No
Default:

3.2.24 PnCodesGroups Table

For PN offset groups belonging to PN offset domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the PN offset domain. Nullable: No


Default:

EXCLUDED Text (225) List of PN offsets not belonging to the group. Nullable: Yes
Default:
EXTRA Text (225) List of additional PN offsets belonging to the group. Nullable: Yes
Default:

FIRST Integer First PN offset belonging to the group. Nullable: Yes


Default: 0

LAST Integer Last PN offset belonging to the group. Nullable: Yes


Default: 0
NAME Text (50) Name of the PN offset group. Nullable: No
Default:

STEP Integer Step between the first and last PN offset belonging to the group. Nullable: Yes
Default: 1

© 2018 Forsk. All Rights Reserved. 107


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

3.2.25 PropagationModels Table

For propagation models.

Field Type Description Attributes

DATA Binary Propagation model parameter settings. Nullable: Yes


Default:

DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:

NAME Text (50) Name of the propagation model. Nullable: No


Default:
SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

TYPE Text (50) ProgID of the model. Nullable: No


Default:

3.2.26 QualityIndicators Table

For quality indicators (BER, BLER, etc.).

Field Type Description Attributes

CS_QI Boolean Whether the quality indicator is used for circuit-switched services or not. Nullable: No
True=Yes; False=No. Default: True
MEAS_PARAM Short Measurement on which the quality indicator is based. 1=Pilot Ec/Io; 2=Pilot Nullable: Yes
C/I; 3=DCH Eb/Nt; 4=DCH C/I. Default: 1

NAME Text (20) Name of the quality indicator. Nullable: No


Default:

PS_QI Boolean Whether the quality indicator is used for packet-switched services or not. Nullable: No
True=Yes; False=No. Default: True

USE_INTERPOLATION Boolean Whether interpolation can be used for the quality indicator graph to find val- Nullable: No
ues between defined ones. True=Yes; False=No. Default: True

3.2.27 Receivers Table

For receiver parameters.

Field Type Description Attributes

ADJ_CHANNEL_PROT Float Adjacent channel interference reduction (ACIR = 1/(1/ACS + 1/ACLR)). Unit: Nullable: No
dB. Default: 18

ANTENNA Text (50) Antenna model of the default receiver. If not defined, an isotropic receiver is Nullable: Yes
used. Default:

HEIGHT Float Height of the default receiver. Nullable: No


Default: 1.5
LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0

NAME Text (50) Name of the default receiver. Nullable: No


Default:

108 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

3.2.28 RepeaterEquipments Table

For repeater equipment.

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the repeater equipment. Nullable: Yes
Default:

MANUFACTURER Text (50) Name of the repeater equipment manufacturer. Nullable: Yes
Default:

MAX_AMPLIFIER_GAIN Float Maximum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 90
MAX_OUTPUT_DL Float Maximum downlink output power. Nullable: Yes
Default: 30

MAX_OUTPUT_UL Float Maximum uplink output power. Nullable: Yes


Default: 12

MIN_AMPLIFIER_GAIN Float Minimum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 50
NAME Text (50) Name of the repeater equipment. Nullable: No
Default:

NOISE_FIGURE Float Noise figure of the repeater equipment. Unit: dB. Nullable: Yes
Default: 5

STEP_AMPLIFIER_GAIN Float Step of amplifier gain. Unit: dB. Nullable: Yes


Default: 1
TIME_DELAY Float Processing delay of the repeater equipment. Unit: us. Nullable: Yes
Default: 5

3.2.29 Repeaters Table

For repeaters.

Field Type Description Attributes

AMPLIFIER_GAIN Float Repeater amplifier gain. Unit: dB. Nullable: Yes


Default: 80

AZIMUT Float Azimuth of the donor side antenna. Nullable: Yes


Default: 0

DONOR_CELLID Text (100) Name of the donor transmitter. Nullable: No


Default:
DONOR_LINK_LOSS Float Loss over the donor-repeater link. Unit: dB. Nullable: Yes
Default: 0

DONOR_LINK_TYPE Short Type of the donor-repeater link. 1=Off air; 2=Microwave; 3=Fibre. Nullable: No
Default: 1

DONOR_PROPAG_MODEL Text (50) Name of the propagation model used for the donor-repeater link. Nullable: Yes
Default:
DOWNTILT Float Downtilt of the donor side antenna. Nullable: Yes
Default: 0

EQUIPMENT_NAME Text (50) Name of the repeater equipment. Passive repeaters do not have equipment Nullable: Yes
(no amplification). Default:

FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 109


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

FEEDERLENGTH Float Length of donor side downlink feeder. Nullable: Yes


Default: 0

HEIGHT Float Height of the donor side antenna. Nullable: Yes


Default: 25

REC_ANTENNA Text (50) Name of the donor side antenna model. Nullable: Yes
Default:
REC_FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes
Default: 0

TOTAL_GAIN Float Total gain of the repeater. Unit: dB. Nullable: Yes
Default: 0

TX_ID Text (100) Name of the repeater. Nullable: No


Default:

 Repeater properties are saved in two tables: the donor-side parameters are in the
Repeaters table and the coverage-side parameters in the Transmitters table.

3.2.30 SecondaryAntennas Table

For additional antennas.

Field Type Description Attributes

ANTENNA Text (50) Name of the secondary antenna model installed on a transmitter. Nullable: No
Default:

AZIMUT Float Azimuth of the secondary antenna. Nullable: No


Default: 0
PERCENT_POWER Float Percentage of power dedicated to the secondary antenna. Nullable: No
Default: 0

REDT Float Remote electrical tilt of the secondary antenna. Nullable: Yes
Default: 0

TILT Float Mechanical downtilt of the secondary antenna. Nullable: No


Default: 0
TX_ID Text (100) Name of the transmitter on which the secondary antenna is installed. Nullable: No
Default:

3.2.31 Separations Table

For PN offset allocation constraints.

Field Type Description Attributes

TX_ID Text (100) Name of the first transmitter. Nullable: No


Default:

TX_ID_OTHER Text (100) Name of the second transmitter. Nullable: No


Default:

110 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

3.2.32 ServiceQualityTables Table

For 1xRTT performance graphs.

Field Type Description Attributes

DL_QI_TABLE Memo Downlink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:

MOBILITY Text (50) Mobility type corresponding to the quality indicator graph. Nullable: Yes
Default:

QI_NAME Text (50) Name of the quality indicator. Nullable: No


Default:
RX_EQUIP Text (50) Reception equipment corresponding to the quality indicator graph. Nullable: No
Default: ’Standard’

SERVICE Text (50) Name of the R99 radio bearer corresponding to the quality indicator graph. Nullable: No
Default:

UL_QI_TABLE Memo Uplink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:

3.2.33 Sites Table

For sites.

Field Type Description Attributes

ALIAS_ Text(60) Site alias Nullable: Yes


Default:

ALTITUDE Float User-defined site altitude. Nullable: Yes


Default:

CDMA_EQUIPMENT Text (50) CDMA site equipment assigned to the site. Nullable: Yes
Default:

CHANNEL_ELEMENTS_DL Integer Number of available channel elements for downlink. Nullable: Yes
Default: 256
CHANNEL_ELEMENTS_UL Integer Number of available channel elements for uplink. Nullable: Yes
Default: 256

COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

EVDO_CES Integer Number of EVDO channel elements per carrier. Nullable: Yes
Default: 96
LATITUDE Double Y coordinate or latitude. Nullable: No
Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0

NAME Text (60) Name of the site. Nullable: No


Default:
PYLON_HEIGHT Float Height of the pylon. Nullable: Yes
Default: 50

SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 111


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

3.2.34 SitesLists Table

For sites belonging to site lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the site list. Nullable: No


Default:

SITE_NAME Text (60) Name of the sites belonging to the list. Nullable: No
Default:

3.2.35 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

3.2.36 TMAEquipments Table

For tower-mounted amplifiers.

Field Type Description Attributes


DL_LOSSES Float Downlink losses of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the tower mounted amplifier. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

UL_GAIN Float Uplink gain of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

3.2.37 TplTransmitters Table

For station templates.

Field Type Description Attributes


ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No
Default:

ANTDIVGAIN Float Antenna diversity gain. Unit: dB. Nullable: Yes


Default:

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: No
Default:
AZIMUT Float Azimuth of the main antenna. Nullable: Yes
Default:

BCMCS_RATE Float BCMCS service rate. Unit: kbps. Nullable: Yes


Default:

112 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

BCMCS_TS_PCT Float Percentage of timeslots dedicated to BCMCS service. Unit: %. Nullable: Yes
Default:

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default:
CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:
CARRIERS Text (255) List of carriers used by the transmitters. Nullable: Yes
Default:

CCH_TS_PCT Float Percentage of time slots dedicated to common control channels. Unit: %. Nullable: Yes
Default:

CDMA_EQUIPMENT Text (50) Name of the CDMA site equipment. Nullable: Yes
Default:
CELL_SIZE Float Hexagon radius. Nullable: Yes
Default:

CHANNEL_ELEMENTS_DL Integer Number of channel elements for downlink. Nullable: Yes


Default:

CHANNEL_ELEMENTS_UL Integer Number of channel elements for uplink. Nullable: Yes


Default:

COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:
DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default:

DRC_ER_RATE Float DRC erasure rate. Nullable: Yes


Default:

EVDO_CES Integer Number of EVDO channel elements per carrier. Nullable: Yes
Default:
FBAND Text (50) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder equipment. Nullable: Yes


Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default:
FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes
Default:

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default:

IDLE_POWER_GAIN Float Gain dedicated to transmitted power in idle state. Unit: dB. Nullable: Yes
Default:
MAX_DL_LOAD Float Maximum allowed downlink load as percentage of max power. Unit: %. Nullable: Yes
Default:

MAX_EVDO_USERS Integer Maximum number of EV-DO users. Nullable: Yes


Default:

MAX_EXT_NEIGHB_NUMBER Short Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 113


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

MAX_INTERCAR_NEIGHB_NB Integer Maximum number of inter-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Short Maximum number of intra-carrier neighbours for the cell. Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:
MAX_UL_LOAD Float Maximum allowed uplink load. Unit: %. Nullable: Yes
Default:

MC_MODE_MUG Memo Multi-user gain graph used in multi-carrier mode. Nullable: Yes
Default:

MC_MODE_UL_ECNT_MIN Float Required Ec/Nt for multi-carrier mode in the uplink. Unit: dB. Nullable: Yes
Default:
MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes
Default:

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default:

MUG_TABLE Memo Multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:
MULTI_CARRIER Short Multi-carrier mode. 0=None; 1=Multi-carrier. Nullable: Yes
Default:

NAME Text (50) Name of the station template. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default:

NUM_SECTORS Integer Number of sectors in the station template. Nullable: Yes


Default: 3
PAGING_POWER Float Transmission power of the paging channel. Nullable: Yes
Default:

PILOT_POWER Float Power of the pilot channel. Nullable: Yes


Default:

PN_DOMAIN_NAME Text (50) PN offset domain name. Nullable: Yes


Default:
POOLED_PWR Float Amount of power which can be borrowed in the BTS power pool. Unit: dB. Nullable: Yes
Default:

POWER_MAX Float Cell's maximum transmission power. Nullable: Yes


Default:

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:
PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default:

REUSE_DIST Float Minimum reuse distance for PN offsets. Nullable: Yes


Default:
ROT_RANGE Float Range of acceptable noise rise. Unit: dB. Nullable: Yes
Default:

ROT_TARGET Float Receiver noise rise over thermal target. Unit: dB. Nullable: Yes
Default:

RSCP_MIN Float Minimum received signal code power. Nullable: Yes


Default: -150

114 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default:

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:
SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes
Default:

SYNCHRO_POWER Float Power of the synchronisation (SCH) channel. Nullable: Yes


Default:

TADD Float Minimum Ec/Io for best server selection. Unit: dB. Nullable: Yes
Default:
TDROP Float Ec/Io threshold for active set rejection. Unit: dB. Nullable: Yes
Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default:

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:
TOTAL_POWER Float Total downlink transmission power. Nullable: Yes
Default:

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default:

UL_LOAD Float Uplink load factor. Unit: %. Nullable: Yes


Default:

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default:

3.2.38 Transmitters Table

For transmitters.

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True
ANTDIVGAIN Float Antenna diversity gain. Unit: dB. Nullable: Yes
Default: 0

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: Yes
Default:

AZIMUT Float Azimuth of the main antenna. Nullable: Yes


Default: 0
BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes
Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default: 4000

© 2018 Forsk. All Rights Reserved. 115


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default: 50

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:
CELL_SIZE Float Hexagon radius. Nullable: Yes
Default: 2000

COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DX Float X coordinate relative to the site location. Nullable: Yes


Default: 0
DY Float X coordinate relative to the site location. Nullable: Yes
Default: 0

FBAND Text (50) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder. Nullable: Yes


Default:
FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes
Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default: 0

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default: 25

HEXAGON_GROUP Text (50) Group of hexagons used to create the transmitter. Nullable: Yes
Default:
MAX_RANGE Integer Maximum coverage range. Nullable: Yes
Default:

MC_MODE_MUG Memo Multi-user gain graph used in multi-carrier mode. Nullable: Yes
Default:

MC_MODE_UL_ECNT_MIN Float Required Ec/Nt for multi-carrier mode in the uplink. Unit: dB. Nullable: Yes
Default: 0
MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes
Default: 0

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default: 0

MULTI_CARRIER Short Multi-carrier mode. 0=None; 1=Multi-carrier. Nullable: Yes


Default: 0
NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default: 5

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default: ’Default model’

PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:
REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default: 0

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

116 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:

SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes


Default: 0

SITE_NAME Text (60) Name of the site on which the transmitter is located. Nullable: No
Default:
TILT Float Mechanical downtilt of the main antenna. Nullable: Yes
Default: 0

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TX_ID Text (100) Name of the transmitter. Nullable: No


Default:
TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

3.2.39 TxsLists Table

For transmitters belonging to transmitter lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the transmitter list. Nullable: No


Default:

TX_NAME Text (50) Name of the transmitters belonging to the list. Nullable: No
Default:

3.2.40 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

NAME Text (50) Name of the transmitter list. Nullable: No


Default:

3.2.41 UERxEquipments Table

For UE reception equipment.

Field Type Description Attributes

NAME Text (50) Name of reception equipment. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 117


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

3.2.42 ULBearersSelection Table

For uplink bearer selection thresholds.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: Yes


Default: 0

EARLY_TERM_TABLE Memo Early termination probability graphs as a function of the number of repeti- Nullable: Yes
tions. Default:

HC_ECNT_REQ Float Required pilot Ec/Nt for high capacity services. Unit: dB. Nullable: Yes
Default:
LL_ECNT_REQ Float Required pilot Ec/Nt for low latency services. Unit: dB. Nullable: Yes
Default:

MOBILITY Text (50) Mobility type corresponding to the uplink bearer selection thresholds. Nullable: Yes
Default:

MODULATION Short Modulation. 0=QPSK; 1=8PSK; 2=16QAM; 3=64QAM. Nullable: No


Default: 0
NUM_SUBFRAMES Integer Number of subframes. Nullable: Yes
Default: 1

RX_EQUIP Text (50) Reception equipment corresponding to the bearer selection thresholds. Nullable: Yes
Default: "Standard"

3.2.43 UMTSEnvironmentDefs Table

For traffic environment types.

Field Type Description Attributes

DENSITY Float Number of users per km2. Nullable: Yes


Default: 0

ENVIRONMENT Text (50) Name of the traffic environment. Nullable: No


Default:
MOBILITY Text (50) Mobility type corresponding to the traffic environment. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the traffic environment. Nullable: No
Default:

3.2.44 UMTSMobility Table

For mobility types.

118 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

COVERI_THROUGHPUTS Memo Throughput graphs as a function of the C/I. Nullable: Yes


Default: '38.4 -10.5 76.8 -
7.5 153.6 -4.5 307.2 -2.
614.4 1 921.6 3.3 1228.8 5
1843.2 9.2 2457.6 11.5'

DELTA_TADD Float Offset to the T_ADD defined per cell. Unit: dB. Nullable: Yes
Default: 0
DELTA_TDROP Float Offset to the T_DROP defined per cell. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the mobility type. Nullable: No


Default:

UL_ECNT_MIN Float Minimum uplink Ec/Nt (EV-DO). Unit: dB. Nullable: Yes
Default: -22

3.2.45 UMTSServices Table

For services.

Field Type Description Attributes


BODY_LOSS Float Body loss. Unit: dB. Nullable: No
Default: 0

CARRIER Integer Carrier number. Nullable: No


Default: -1

DLFCH_ACTIVITYFACTOR Float Occupancy time of the downlink fundamental channel. Nullable: Yes
Default: 1

DLRATE_16 Float Probability to transmit sixteen times the nominal rate on the supplementary Nullable: Yes
channel (SCH) on the downlink. Default: 0
DLRATE_2 Float Probability to transmit twice the nominal rate on the supplementary channel Nullable: Yes
(SCH) on the downlink. Default: 0

DLRATE_4 Float Probability to transmit four times the nominal rate on the supplementary Nullable: Yes
channel (SCH) on the downlink. Default: 0

DLRATE_8 Float Probability to transmit eight times the nominal rate on the supplementary Nullable: Yes
channel (SCH) on the downlink. Default: 0
DOWN_153K6_76K8 Float EV-DO Rev.0 Downgrading probability (153.6 -> 76.8). Unit: 1/255. Nullable: Yes
Default: 0

DOWN_19K2_9K6 Float EV-DO Rev.0 Downgrading probability (19.2 -> 9.6). Unit: 1/255. Nullable: Yes
Default: 0

DOWN_38K4_19K2 Float EV-DO Rev.0 Downgrading probability (38.4 -> 19.2). Unit: 1/255. Nullable: Yes
Default: 0
DOWN_76K8_38K4 Float EV-DO Rev.0 Downgrading probability (76.8 -> 38.4). Unit: 1/255. Nullable: Yes
Default: 0

ENABLE_DOWNGRADING Boolean Whether bearer downgrading is allowed or not. True=Allowed; False=Not Nullable: No
allowed. Default: True

EVDO_ULRATE_1 Float Probability of transmitting 9.6 kbps for an EVDO service. Nullable: Yes
Default: 0
MIN_RATE_DL Float Downlink guaranteed bit rate. Unit: kbps. Nullable: Yes
Default: 0

MIN_RATE_UL Float Uplink guaranteed bit rate. Unit: kbps. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 119


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

NAME Text (50) Name of the service. Nullable: No


Default:

PRIORITY Integer Service priority. 0=Lowest. Nullable: Yes


Default: 0

QOS_CLASS Short QoS class. 0=Best Effort; 1=Guaranteed Bit Rate. Nullable: Yes
Default: 0
TCP_ACK_CURVE Memo Reverse link throughputs graph as function of the forward link application Nullable: Yes
layer throughput. Default: '0 0 300 10 600 20
900 30 1200 40 1500 50
1800 60 2400 80'

TCP_SERVICE Boolean Whether the service uses TCP or not. True=Yes; False=No. Nullable: No
Default: False

TH_OFFSET Float Fixed offset to map throughput to the application layer. Nullable: No
Default: 0

TH_SCALE_FACTOR Float Ratio between application throughput and RLC layer throughput. Nullable: No
Default: 95
TYPE Short Type of service. 0=Speech; 1=1xRTT Data; 2=1xEV-DO Rev 0; 3=1xEV-DO Rev Nullable: Yes
A; 4=1xEV-DO Rev B. Default: 0

UL_OPERATION_MODE Short Mode of operation of the service. 0=High Capacity; 1=Low Latency. Nullable: Yes
Default: 0

ULFCH_ACTIVITYFACTOR Float Occupancy time of the uplink fundamental channel for 1xRTT or probability Nullable: Yes
to transmit the nominal rate on the uplink supplementary channel (SCH) for Default: 1
1xEVDO.

ULRATE_16 Float Probability to transmit sixteen times the nominal rate on the uplink supple- Nullable: Yes
mentary channel (SCH). Default: 0

ULRATE_2 Float Probability to transmit twice the nominal rate on the uplink supplementary Nullable: Yes
channel (SCH). Default: 0
ULRATE_4 Float Probability to transmit four times the nominal rate on the uplink supplemen- Nullable: Yes
tary channel (SCH). Default: 0

ULRATE_8 Float Probability to transmit eight times the nominal rate on the uplink supplemen- Nullable: Yes
tary channel (SCH). Default: 0

UP_19K2_38K4 Float EV-DO Rev.0 upgrading probability (19.2 -> 38.4). Unit: 1/255. Nullable: Yes
Default: 0
UP_38K4_76K8 Float EV-DO Rev.0 upgrading probability (38.4 -> 76.8). Unit: 1/255. Nullable: Yes
Default: 0

UP_76K8_153K6 Float EV-DO Rev.0 upgrading probability (76.8 -> 153.6). Unit: 1/255. Nullable: Yes
Default: 0

UP_9K6_19K2 Float EV-DO Rev.0 upgrading probability (9.6 -> 19.2). Unit: 1/255. Nullable: Yes
Default: 0
USE_HANDOFF Boolean Whether the service supports soft handover or not. True=Yes; False=No. Nullable: No
Default: False

3.2.46 UMTSServicesQuality Table

For 1xRTT service access thresholds.

120 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

DL_TARGET_QUAL Float Downlink quality target. Unit: dB. Nullable: Yes


Default:

FCH2PILOT Float FCH to pilot power gain. Unit: dB. Nullable: Yes
Default: 0
MOBILITY Text (50) Mobility type corresponding to the service quality requirements. Nullable: Yes
Default:

PTCH_MAX Float Maximum allowed fundamental traffic channel power. Nullable: Yes
Default: 34

PTCH_MIN Float Minimum allowed fundamental traffic channel power. Nullable: Yes
Default: 14
RX_EQUIP Text (50) Name of the reception equipment corresponding to the service quality Nullable: No
requirements. Default: ’Standard’

SCH_RATE Integer SCH rate factor (0 -> 16). Nullable: No


Default: 0

SCH2PILOT Float SCH to pilot power gain. Unit: dB. Nullable: Yes
Default: 0
SERVICE Text (50) Name of the service. Nullable: No
Default:

TERMINAL Text (50) Name of the terminal corresponding to the R99 bearer quality graphs. Nullable: No
Default:

UL_ECNT_MIN Float Minimum uplink Ec/Nt (EV-DO). Unit: dB. Nullable: Yes
Default: 0
UL_TARGET_QUAL Float Uplink quality target. Unit: dB. Nullable: Yes
Default:

3.2.47 UMTSServicesUsage Table

For user profile parameters.

Field Type Description Attributes

CALL_DURATION Float Average duration of a call for circuit-switched services. Unit: s. Nullable: Yes
Default:

CALL_NUMBER Float Average number of calls per hour for circuit-switched services or average Nullable: Yes
number of sessions per hour for packet-switched services. Default: 0

SERVICE Text (50) Name of the service corresponding to the user profile. Nullable: No
Default:
TERMINAL Text (50) Name of the terminal corresponding to the user profile. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the user profile. Nullable: No
Default:

3.2.48 UMTSTerminals Table

For terminal types.

© 2018 Forsk. All Rights Reserved. 121


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

ACK_GAIN Float ACK channel gain. Unit: dB. Nullable: Yes


Default: 4

ACK_GAIN_DORA Float ACK channel gain for EV-DO Rev A. Unit: dB. Nullable: No
Default: 3
ACTIVE_SET_SIZE Short Maximum number of servers in the active set. Nullable: Yes
Default: 6

DRC_GAIN_NOHO Float DRC gain (No handover case). Unit: dB. Nullable: Yes
Default: -1

DRC_GAIN_NOHO_DORA Float DRC gain (No handover case) for 1xEvDo Rev A. Unit: dB. Nullable: No
Default: -1
DRC_GAIN_SOFT Float DRC gain (any kind of soft handover). Unit: dB. Nullable: Yes
Default: -3

DRC_GAIN_SOFT_DORA Float DRC gain (any kind of soft handover) for 1xEvDo Rev A. Unit: dB. Nullable: No
Default: -3

DRC_GAIN_SOFTER Float DRC gain (only softer handover). Unit: dB. Nullable: Yes
Default: -1
DRC_GAIN_SOFTER_DORA Float DRC gain (only softer handover) for 1xEvDo Rev A. Unit: dB. Nullable: No
Default: -1

FWD_BASEDATARATE Float Downlink nominal throughput supported by the receiver on the fundamental Nullable: No
channel. Unit: kbps. Default: 9.6

GAIN Float Terminal antenna gain. Unit: dB. Nullable: Yes


Default: 0
HANDOFF_TYPE Short Type of handover supported by the terminal. 0=Locked; 1=Unlocked. Nullable: No
Default: 0
LOSS Float Terminal antenna loss. Unit: dB. Nullable: Yes
Default: 0

MODULATION Short Modulation. 0=QPSK; 1=8PSK; 2=16QAM; 3=64QAM. Nullable: No


Default: 0

NAME Text (50) Name of the terminal. Nullable: No


Default:
NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

NOISE_FACTOR_SEC Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

NOISE_FACTOR_THIRD Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8
NUM_CARRIERS_MAX Short Maximum number of carriers supported in multi-carrier mode. Nullable: Yes
Default: 3

PILOT_POWER_PCT Float Percentage of maximum power dedicated to the uplink pilot channel. Nullable: Yes
Default: 0

PMAX Float Maximum transmission power of the terminal. Nullable: Yes


Default: 23
PMIN Float Minimum transmission power of the terminal. Nullable: Yes
Default: -50

PRIMARY_BAND Text (50) Primary frequency band. Nullable: Yes


Default:

RAKE_EFFICIENCY Float Efficiency of the rake receiver. Nullable: Yes


Default: 1
RAKE_NUM_FINGERS Short Number of active set links that can be combined. Nullable: Yes
Default: 3

122 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Field Type Description Attributes

REV_BASEDATARATE Float Uplink nominal throughput supported by the receiver on the fundamental Nullable: No
channel. Unit: kbps. Default: 9.6

RHO_FACTOR Short CDMA rho factor for self interference. Nullable: No


Default: 94

RRI_GAIN_DORA Float RRI gain for 1xEvDo Rev A. Unit: dB. Nullable: No
Default: -6
RX_EQUIP Text (50) Name of the reception equipment associated with the terminal. Nullable: No
Default: ‘Standard’

SCH_AS_SIZE Short Maximum number of transmitters possibly connected with the receiver for Nullable: Yes
the supplementary channel (SCH). Default: 3

SECONDARY_BAND Text (50) Secondary frequency band. Nullable: Yes


Default:
SUPPORTED_TECHNO Short Technology supported by the terminal. 0=Voice; 1=1xRTT; 2=1xEV-DO Rev 0; Nullable: No
3=1xEV-DO Rev A; 4=1xEV-DO Rev B. Default: 0

THIRD_BAND Text (50) Third frequency band. Nullable: Yes


Default:

TRAFFIC_GAIN_153_6 Float Traffic gain (153.6 kbps). Unit: dB. Nullable: Yes
Default: 18
TRAFFIC_GAIN_19_2 Float Traffic gain (19.2 kbps). Unit: dB. Nullable: Yes
Default: 7

TRAFFIC_GAIN_38_4 Float Traffic gain (38.4 kbps). Unit: dB. Nullable: Yes
Default: 10

TRAFFIC_GAIN_76_8 Float Traffic gain (76.8 kbps). Unit: dB. Nullable: Yes
Default: 13

TRAFFIC_GAIN_9_6 Float Traffic gain (9.2 kbps). Unit: dB. Nullable: Yes
Default: 4

3.2.49 UMTSTraficEnvironments Table

For traffic environment clutter weighting.

Field Type Description Attributes

CLUTTER_WEIGHTS Binary Clutter weighting for traffic environment maps. Nullable: Yes
Default: Yes

NAME Text (50) Name of the traffic environment. Nullable: No


Default:

3.2.50 UMTSUserProfiles Table

For names of user profiles.

Field Type Description Attributes

NAME Text (50) Name of the user profile. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 123


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

3.2.51 Units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, and the
database internal coordinate system.

Field Type Description Attributes

COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes


Default: -1

GAIN_UNIT Integer Unit used for gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0

PROJECTION Integer Projection coordinate system of the document. Nullable: Yes


Default: -1
RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0

TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No


Default: 0

3.3 Relationships

Many-to-One Relationships (  1)

CdmaCells.PN_DOMAIN_NAME PnCodesDomains.DOMAIN_NAME

CdmaCells.TX_ID Transmitters.TX_ID

CdmaEquipmentsCEsUse.EQUIPMENT CdmaEquipments.NAME
CdmaEquipmentsCEsUse.TERMINAL UMTSTerminals.NAME

DLBearersSelection.BEARER_INDEX DLDORABearers.BEARER_INDEX

DLBearersSelection.MOBILITY UMTSMobility.NAME
DLBearersSelection.RX_EQUIP UERxEquipments.NAME

DORABearersProba.BEARER_INDEX DORABearers.BEARER_INDEX

DORABearersProba.SERVICE UMTSServices.NAME

DORATerminalT2PRatios.BEARER_INDEX DORABearers.BEARER_INDEX

DORATerminalT2PRatios.TERMINAL UMTSTerminals.NAME

Neighbours.NEIGHBOUR CdmaCells.CELL_ID

Neighbours.TRANSMITTER CdmaCells.CELL_ID

NeighboursConstraints.NEIGHBOUR CdmaCells.CELL_ID

NeighboursConstraints.TRANSMITTER CdmaCells.CELL_ID
NeighboursConstraintsExt.TRANSMITTER CdmaCells.CELL_ID

NeighboursExt.TRANSMITTER CdmaCells.CELL_ID

Networks.DEFAULT_MODEL PropagationModels.NAME
PnCodesGroups.DOMAIN_NAME PnCodesDomains.DOMAIN_NAME

Receivers.ANTENNA Antennas.NAME

Repeaters.DONOR_CELLID Transmitters.TX_ID

Repeaters.DONOR_PROPAG_MODEL PropagationModels.NAME

Repeaters.EQUIPMENT_NAME RepeaterEquipments.NAME

Repeaters.FEEDER_NAME FeederEquipments.NAME

Repeaters.REC_ANTENNA Antennas.NAME

124 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 3: CDMA2000 Data Structure

Many-to-One Relationships (  1)

Repeaters.TX_ID Transmitters.TX_ID

SecondaryAntennas.ANTENNA Antennas.NAME

SecondaryAntennas.TX_ID Transmitters.TX_ID

Separations.TX_ID CdmaCells.CELL_ID

Separations.TX_ID_OTHER CdmaCells.CELL_ID

ServiceQualityTables.MOBILITY UMTSMobility.NAME

ServiceQualityTables.QI_NAME QualityIndicators.NAME

ServiceQualityTables.RX_EQUIP UERxEquipments.NAME

ServiceQualityTables.SERVICE UMTSServices.NAME

Sites.CDMA_EQUIPMENT CdmaEquipments.NAME

SitesLists.LIST_NAME SitesListsNames.NAME

SitesLists.SITE_NAME Sites.NAME

Transmitters.ANTENNA_NAME Antennas.NAME

Transmitters.BTS_NAME BTSEquipments.NAME

Transmitters.FBAND FrequencyBands.NAME

Transmitters.FEEDER_NAME FeederEquipments.NAME

Transmitters.PROPAG_MODEL PropagationModels.NAME

Transmitters.PROPAG_MODEL2 PropagationModels.NAME

Transmitters.SITE_NAME Sites.NAME
Transmitters.TMA_NAME TMAEquipments.NAME

TxsLists.LIST_NAME TxsListsNames.NAME

TxsLists.TX_NAME Transmitters.TX_ID
ULBearersSelection.BEARER_INDEX DORABearers.BEARER_INDEX

ULBearersSelection.MOBILITY UMTSMobility.NAME

ULBearersSelection.RX_EQUIP UERxEquipments.NAME
UMTSEnvironmentDefs.ENVIRONMENT UMTSTraficEnvironments.NAME

UMTSEnvironmentDefs.MOBILITY UMTSMobility.NAME

UMTSEnvironmentDefs.USER_PROFILE UMTSUserProfiles.NAME
UMTSServicesQuality.MOBILITY UMTSMobility.NAME

UMTSServicesQuality.RX_EQUIP UERxEquipments.NAME

UMTSServicesQuality.SERVICE UMTSServices.NAME

UMTSServicesQuality.TERMINAL UMTSTerminals.NAME

UMTSServicesUsage.SERVICE UMTSServices.NAME

UMTSServicesUsage.TERMINAL UMTSTerminals.NAME

UMTSServicesUsage.USER_PROFILE UMTSUserProfiles.NAME

UMTSTerminals.PRIMARY_BAND FrequencyBands.NAME

UMTSTerminals.RX_EQUIP UERxEquipments.NAME
UMTSTerminals.SECONDARY_BAND FrequencyBands.NAME

UMTSTerminals.THIRD_BAND FrequencyBands.NAME

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

© 2018 Forsk. All Rights Reserved. 125


Atoll 3.4.0 Data Structure Reference Guide
Chapter 3: CDMA2000 Data Structure

126 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

4 LTE Data Structure


Atoll supports integrated network planning for LTE networks. This section describes the LTE data structure used in
Atoll. It lists all the tables and fields found in the LTE template and the relationships between them.

 Primary keys are listed in bold and italic characters.

4.1 Data Structure Changes from Atoll 3.3 to 3.4

4.1.1 Added Tables and Fields

FeederEquipments Table

Field Type Description Attributes

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

lcagroups Table

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0

LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

lcompsets Table

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0

LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

© 2018 Forsk. All Rights Reserved. 127


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

lframeconfigs Table

Field Type Description Attributes

PRACH_RB Text (50) Comma-separated list of resource blocks numbers used for PRACH trans- Nullable: Yes
mission Default:

PRACH_SUBFRAMES Text (50) Comma-separated list of subframe numbers used for PRACH transmission Nullable: Yes
Default:

lrepetitions Table (New)

Field Type Description Attributes

CONFIGURATION Short NB-IoT deployment configuration. 0=Any; 1=Standalone; 2=Guardband; Nullable: No


3=Inband. Default: 0

COVERAGE_LEVEL Float User-defined minimum coverage level. Unit = dBm. Nullable: No


Default: 0
EQUIPMENT Text (50) Name of the reception equipment. Nullable: No
Default:

GAIN Memo Graph of gain values vs. bearer index. Nullable: Yes
Default:

MOBILITY Text (50) Name of the mobility type (UE speed). Empty= “All”. Nullable: Yes
Default:
REPETITIONS Integer Number of repetitions required to attain the coverage level. Nullable: Yes
Default: 1

SUBCARRIER_WIDTH Short NB-IoT subcarrier width. 0=Any; 1=3.75 kHz; 2=15 kHz. Nullable: No
Default: 0

lterminalbands Table

Field Type Description Attributes

CA_SUPPORT Short Whether the terminal supports carrier aggregation using the frequency band. Nullable: No
0=No; 1=Yes. Default: 1
LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0

Sites Table

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

T4GBearersRequiredCI Table

Field Type Description Attributes

BEARERS_REQUIRED_COVERI Memo Uplink bearer selection thresholds. Nullable: Yes


_UL Default:

128 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

T4GCells Table

Field Type Description Attributes

AFP_NPCI_STRATEGY Short AFP inband NPCI allocation strategy. 0=None; 1=Identical as LTE. Nullable: Yes
Default: 0

CELLSIZE_RSI_MAPPING Text (50) Name of the cell size to PRACH RSI mapping. Nullable: Yes
Default:
RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT. Nullable: No
Default: 0

T4GMimoConfigs Table

Field Type Description Attributes

MUMIMO_GAIN Memo Graphs of MU-MIMO gains vs. the number of MU-MIMO users. Nullable: Yes
Default:

Tpltransmitters Table

Field Type Description Attributes

N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes


Default:

RAT Short Radio access technology of the station template. 0=LTE; 1=NB-IoT. Nullable: No
Default:

Transmitters Table

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:
N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

4.1.2 Deleted Tables and Fields

None.

© 2018 Forsk. All Rights Reserved. 129


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

4.2 Data Structure

4.2.1 Antennas Table

For antennas.

Field Type Description Attributes

BEAMWIDTH Float The half-power beamwidth of the antenna model. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the antenna model. Nullable: Yes
Default:
CONSTRUCTOR Text (255) Name of the antenna manufacturer. Nullable: Yes
Default:

DIAGRAM Binary Antenna horizontal and vertical patterns. Nullable: Yes


Default:

ELECTRICAL_AZIMUTH Float The electrical azimuth of the antenna model. Nullable: Yes
Default:
ELECTRICAL_TILT Float The electrical tilt of the antenna model. Nullable: Yes
Default:

FMAX Double Maximum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:

FMIN Double Minimum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:
GAIN Float Antenna model gain compared to an isotropic radiator. Unit: dBi. Nullable: No
Default: 0

NAME Text (50) Name of the antenna model. Nullable: No


Default:

PHYSICAL_ANTENNA Text (50) Name of the physical antenna to which the antenna model belongs. Nullable: Yes
Default:

 The format of the binary field, DIAGRAM, is described in "RF 2D Antenna Pattern
Format" on page 355.

4.2.2 BTSEquipments Table

For eNodeB equipment.

Field Type Description Attributes

CONFIG_DL_LOSSES Float Downlink losses due to transmitter components (duplexer, combiner, etc.). Nullable: Yes
Unit: dB. Default: 0

130 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

CONFIG_UL_LOSSES Float Uplink losses due to transmitter components (duplexer, combiner, etc.). Unit: Nullable: Yes
dB. Default: 0
NAME Text (60) Name of transmitter equipment. Nullable: No
Default:

NOISE_FIGURE Float Noise figure of transmitter equipment. Unit: dB. Nullable: Yes
Default: 0

RHO_FACTOR Float CDMA rho factor for self interference (not used in other technologies). Nullable: Yes
Default: 0

4.2.3 CoordSys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

Field Type Description Attributes

CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default: 0
DATUM_CODE Double Identification code of the datum. Nullable: Yes
Default: 0

DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0
DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0

DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes


Default: 0

DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes


Default: 0
DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes
Default: 0

ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No


Default: 0

ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes


Default: 0
ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes
Default: 0

GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:

PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes


Default: 0
PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 131


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes


Default: 0
PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0

PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes
Default: 0

4.2.4 CustomFields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:
CHOICE_LIST Memo Choice list for text fields. Nullable: Yes
Default:

CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default:

COLUMN_NAME Text (50) Name of the custom field. Nullable: No


Default:
DEFAULT_VALUE Text (50) Default value for the field. Nullable: Yes
Default:

DISPLAY_TYPE Integer Whether the field is hypertext or regular and modifiable or read-only. Nullable: Yes
0=Regular and modifiable; 1=Regular and read-only; 2=Hypertext and mod- Default: 0
ifiable; 3=Hypertext and read-only
GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:

TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.

132 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.
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


 Table and field names are case sensitive.
 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any 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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the
appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

4.2.5 FeederEquipments Table

For feeders.

© 2018 Forsk. All Rights Reserved. 133


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

CONNECTOR_LOSSES_DL Float Feeder connector losses in downlink. Unit: dB. Nullable: Yes
Default: 0

CONNECTOR_LOSSES_UL Float Feeder connector losses in uplink. Unit: dB. Nullable: Yes
Default: 0

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:
LOSS_PER_METER Float Feeder loss per meter. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the feeder. Nullable: No


Default:

4.2.6 FrequencyBands Table

For frequency bands.

Field Type Description Attributes

ADJ_CHANNEL_PROT Float Adjacent channel interference reduction (ACIR = 1/(1/ACS + 1/ACLR)). Unit: Nullable: No
dB. Default: 28

CHANNEL_WIDTH Double Channel width. Unit: MHz. Nullable: Yes


Default: 5
DELTA_CN Integer Step between two adjacent channel numbers. Nullable: Yes
Default: 1

DL_FREQUENCY Double Downlink start frequency of the first channel of the frequency band. Unit: Nullable: Yes
MHz. Default: 2110

DUPLEXING_METHOD Short Duplexing method used in the frequency band. 0=FDD; 1=TDD. Nullable: No
Default: 0

EXCLUDED_CHANNELS Text (255) List of channel numbers not part of the usable spectrum. Nullable: Yes
Default:
FIRST_CHANNEL Integer First channel number in the frequency band. Nullable: Yes
Default: 0

GUARD_BAND Float Guard band between two adjacent channels. Unit: MHz. Nullable: Yes
Default: 0

LAST_CHANNEL Integer Last channel number in the frequency band. Nullable: Yes
Default: 0
N_RB Integer Number of resource blocks per channel. Nullable: Yes
Default: 25

NAME Text (50) Name of the frequency band. Nullable: No


Default:

SAMPLING_FREQUENCY Float Sampling frequency. Unit: MHz. Nullable: No


Default: 7.68
UL_FREQUENCY Double Uplink start frequency of the first channel of the frequency band. Unit: MHz. Nullable: Yes
Default:

4.2.7 InterNetChProtect Table

For inter-network interference reduction factor graphs.

134 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

ICP Memo Inter-RAT interference reduction graph as a function of frequency difference Nullable: Yes
between channels. Default:

ITF_BW Double Channel width of the interferer cell. Unit: kHz. Nullable: No
Default: 0

ITF_TECHNO Text (50) Technology of the interfering cell. Nullable: No


Default:
V_BW Double Channel width of the interfered cell. Unit: kHz. Nullable: No
Default: 0

4.2.8 lcagroupdefs Table

For the definitions of carrier aggregation groups.

Field Type Description Attributes

CA_GROUP_MEMBER_CELL Text (100) Name of cells belonging to a carrier aggregation group. Nullable: No
Default:

CA_GROUP_NAME Text (50) Name of the carrier aggregation group. Nullable: No


Default:

4.2.9 lcagroups Table

For the names of carrier aggregation groups.

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0

LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

NAME Text (50) Name of the carrier aggregation group. Nullable: No


Default:

4.2.10 lcchdivgains Table

For control channel diversity gains.

Field Type Description Attributes

EQUIPMENT Text (50) Name of the reception equipment corresponding to the control channel diver- Nullable: No
sity gains. Default:
MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default: 1

© 2018 Forsk. All Rights Reserved. 135


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default: 1
MOBILITY Text (50) Mobility type corresponding to the control channel diversity gains. Nullable: Yes
Default:

PBCH_DIV_GAIN Float PBCH diversity gain. Unit: dB. Nullable: Yes


Default: 0

PDCCH_DIV_GAIN Float PDCCH diversity gain. Unit: dB. Nullable: Yes


Default: 0

4.2.11 lcompsetdefs Table

For CoMP set definitions.

Field Type Description Attributes

COMP_SET_MEMBER_CELL Text (100) Name of the CoMP cooperating set. Nullable: No


Default:
COMP_SET_NAME Text (50) Name of the CoMP set member cell. Nullable: No
Default: 0

4.2.12 lcompsets Table

For CoMP set names and parameters.

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0
COLLISION_PROBA_DL Memo Downlink collision probabilities of resource blocks vs. normalised CoMP set Nullable: Yes
load. Default:

COLLISION_PROBA_UL Memo Uplink collision probabilities of resource blocks vs. normalised CoMP set Nullable: Yes
load Default: 0

DL_COMP_SCHEME Short Downlink CoMP scheme applicable to this CoMP set. Nullable: Yes
Default:
LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

NAME Text (50) Name of the CoMP cooperating set. Nullable: No


Default:

RX_SET_SIZE Short Maximum number of CoMP points (cells) that can be coordinated (CS/CB) Nullable: Yes
or simultaneously receiving from a UE (JT). Default: 0
TX_SET_SIZE Short Maximum number of CoMP points (cells) that can be coordinated (CS/CB) Nullable: Yes
or simultaneously transmitting to a UE (JT). Default: 0

UL_COMP_SCHEME Short Uplink CoMP scheme applicable to this CoMP set. Nullable: Yes
Default: 0

136 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

4.2.13 lframeconfigs Table

For frame configurations.

Field Type Description Attributes

CELLEDGE_PWR_BOOST Float Ratio of the transmission power of cell-edge frequency blocks to cell-centre Nullable: Yes
frequency blocks for Soft FFR and Partial Soft FFR. Unit: dB. Default:
CYCLIC_PREFIX Short Cyclic prefix used by the cell. 0=Normal; 1=Extended. Nullable: Yes
Default: 0

ICIC_MODE Short The inter-cell interference coordination mode used by the frame configura- Nullable: No
tion. 0=Time switched FFR; 1=Hard FFR; 2=Soft FFR; 3=Partial Soft FFR. Default: 0

MBSFN_SC_SPACING Short MBSFN subcarrier spacing. 0=15 kHz; 1=7.5 kHz. Nullable: Yes
Default: 0
N_RB_GROUP0 Text (255) Frequency blocks belonging to the first group (PSS ID 0). Nullable: Yes
Default:

N_RB_GROUP1 Text (255) Frequency blocks belonging to the second group (PSS ID 1). Nullable: Yes
Default:

N_RB_GROUP2 Text (255) Frequency blocks belonging to the third group (PSS ID 2). Nullable: Yes
Default:
N_RB_TOTAL Short Number of frequency blocks for which the configuration is defined. Nullable: Yes
Default: 0

NAME Text (50) Name of the frame configuration. Nullable: No


Default:

PDCCH_SYMBOLS Short Number of OFDM symbols per subframe corresponding to the PDCCH. 0; 1; Nullable: Yes
2; 3; 4. Default: 1
PRACH_PREAMBLE_FORMAT Short PRACH preamble format. 0; 1; 2; 3; 4. Nullable: Yes
Default:

PRACH_RB Text (50) Comma-separated list of resource blocks numbers used for PRACH trans- Nullable: Yes
mission Default:

PRACH_SUBFRAMES Text (50) Comma-separated list of subframe numbers used for PRACH transmission Nullable: Yes
Default:

PUCCH_AVG_NRB Float Average number of frequency blocks corresponding to the PUCCH. Nullable: Yes
Default: 2
SSF_CONFIG Short TDD special subframe configuration. 0; 1; 2; 3; 4; 5; 6; 7; 8. Nullable: Yes
Default:

4.2.14 llayers Table

For heterogeneous network (HetNet) deployment layers.

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer. Nullable: No


Default: 0

MAX_SPEED Float Maximum user speed supported by the layer. Unit: km/h. Nullable: Yes
Default: 300

NAME Text (50) Name of the network layer. Nullable: No


Default:
PRIORITY Short Layer priority. 0=Lowest. Nullable: No
Default: 0

© 2018 Forsk. All Rights Reserved. 137


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

4.2.15 lmbsfnareadefs Table

For MBSFN area definitions.

Field Type Description Attributes

MBSFN_AREA_NAME Text (50) Name of the MBSFN area. Nullable: No


Default:
MBSFN_MEMBER_CELL Text (100) Name of MBSFN area member cell. Nullable: No
Default: 0

4.2.16 lmbsfnareas Table

For MBSFN area names and parameters.

Field Type Description Attributes

MBSFN_AREA_ID Short MBSFN area ID. Nullable: Yes


Default: 0

MBSFN_AREA_MCE Text (100) Name of the MBSFN area coordinator cell. Nullable: No
Default:

NAME Text (50) Name of the MBSFN area. Nullable: No


Default:

4.2.17 lpcidomains Table

For physical cell ID domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the physical cell ID domain. Nullable: No


Default:

4.2.18 lpcigroups Table

For physical cell ID groups.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the physical cell ID domain. Nullable:


Default:

EXCLUDED Text (225) List of physical cell IDs not belonging to the group. Nullable: Yes
Default:
EXTRA Text (225) List of additional physical cell IDs belonging to the group. Nullable: Yes
Default:

138 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

FIRST Integer First physical cell ID belonging to the group. Nullable: Yes
Default: 0
LAST Integer Last physical cell ID belonging to the group. Nullable: Yes
Default: 0

NAME Text (50) Name of the physical cell ID group. Nullable: No


Default:

STEP Integer Step between the first and last physical cell ID belonging to the group. Nullable: Yes
Default: 1

4.2.19 lprachdomains Table

For PRACH RSI domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the PRACH RSI domain. Nullable: No


Default:

4.2.20 lprachgroups Table

For PRACH RSI groups.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the PRACH RSI domain. Nullable:


Default:

EXCLUDED Text (225) List of PRACH RSIs not belonging to the group. Nullable: Yes
Default:
EXTRA Text (225) List of additional PRACH RSIs belonging to the group. Nullable: Yes
Default:

FIRST Integer First PRACH RSI belonging to the group. Nullable: Yes
Default: 0

LAST Integer Last PRACH RSI belonging to the group. Nullable: Yes
Default: 0
NAME Text (50) Name of the PRACH RSI group. Nullable: No
Default:

STEP Integer Step between the first and last PRACH RSI belonging to the group. Nullable: Yes
Default: 1

4.2.21 lrelayLinks Table

For donor-side propagation parameters of relay nodes.

© 2018 Forsk. All Rights Reserved. 139


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

ANTENNA Text (50) Name of the donor side antenna model. Nullable: Yes
Default:

AZIMUT Float Azimuth of the donor side antenna. Nullable: Yes


Default: 0

DONOR_CELL_ID Text (100) Name of the donor cell. Nullable: Yes


Default:
FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:

FEEDERLENGTH_DL Float Length of donor side downlink feeder. Nullable: Yes


Default: 0

FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes


Default: 0
HEIGHT Float Height of the donor side antenna. Nullable: Yes
Default: 5

PROPAG_MODEL Text (50) Name of the propagation model used for the donor-relay link. Nullable: Yes
Default:

RELAY_SITE_NAME Text (60) Name of the relay node site. Nullable: No


Default:
TILT Float Downtilt of the donor side antenna. Nullable: Yes
Default: 0

4.2.22 lrepetitions Table

Field Type Description Attributes

CONFIGURATION Short NB-IoT deployment configuration. 0=Any; 1=Standalone; 2=Guardband; Nullable: No


3=Inband. Default: 0

COVERAGE_LEVEL Float User-defined minimum coverage level. Unit = dBm. Nullable: No


Default: 0
EQUIPMENT Text (50) Name of the reception equipment. Nullable: No
Default:

GAIN Memo Graph of gain values vs. bearer index. Nullable: Yes
Default:

MOBILITY Text (50) Name of the mobility type (UE speed). Empty= “All”. Nullable: Yes
Default:
REPETITIONS Integer Number of repetitions required to attain the coverage level. Nullable: Yes
Default: 1

SUBCARRIER_WIDTH Short NB-IoT subcarrier width. 0=Any; 1=3.75 kHz; 2=15 kHz. Nullable: No
Default: 0

4.2.23 lterminalbands Table

For frequency bands supported by terminals.

140 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

CA_SUPPORT Short Whether the terminal supports carrier aggregation using the frequency band. Nullable: No
0=No; 1=Yes. Default: 1

FBAND_NAME Text (50) Name of the frequency band supported by the terminal. Nullable: No
Default:

LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0
NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

TERMINAL_NAME Text (50) Name of the terminal corresponding to the supported frequency band. Nullable: No
Default:

4.2.24 MUGTables Table

For multi-user diversity gains of proportional fair schedulers.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: Yes


Default:

MAX_CINR Float C/(I+N) above which MUG will not be applied. Unit: dB. Nullable: No
Default: 16.8
MOBILITY Text (50) Mobility type corresponding to the MUG graph. Nullable: No
Default:

MUG_TABLE Memo Downlink multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:

MUG_TABLE_UL Memo Uplink multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:

SCHEDULER_NAME Text (30) Scheduler corresponding to the multi-user diversity gain graph. Nullable: No
Default:

4.2.25 Neighbours Table

For intra-technology neighbour relations.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1
NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

RELATION_TYPE Short Type of the neighbour relation. 0=Intra-carrier; 1=Inter-carrier. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:
TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 141


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

4.2.26 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

4.2.27 NeighboursConstraintsExt Table

For inter-technology neighbour allocation constraints.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

4.2.28 NeighboursExt Table

For inter-technology neighbour relations.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

142 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

4.2.29 Networks Table

For network-level parameters.

Field Type Description Attributes

AAS_CRITERION Short Radio parameter on which AAS activation is based. 0=RS C/N; 1=RS C/(I+N); Nullable: Yes
2=PDSCH C/(I+N). Default: 0
AMS_SEL_CRITERION Short Radio parameter on which SU-MIMO activation is based. 0=RS C/N; 1=RS C/ Nullable: Yes
(I+N); 2=PDSCH or PUSCH C/(I+N). Default: 0

BS_SELECTION Short Radio parameter on which best server selection is based. 0=RS level; Nullable: Yes
1=RSRP. Default: 1

CELL_SELECTION Short Serving cell selection method. 2=Random; 3=Standard; 4=Traffic balancing. Nullable: Yes
Default: 3
DEFAULT_CP Short Default cyclic prefix. 0=Normal; 1=Extended. Nullable: Yes
Default: 0

DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes


Default: "Cost-Hata"

DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No


Default: 50
DMAX Float Maximum radius for a cell. Nullable: No
Default: -1

INTERFERERS_RX_THRESH Float Lowest received interference level. Unit: dB. Nullable: Yes
Default: -20

MIMO_INT_PWR_COMB Short Power combining of interfering signals due to multiple antennas. 0=No; Nullable: Yes
1=Yes. Default: 1
MUMIMO_CRITERION Short Radio parameter on which SU-MIMO activation is based. 0=RS C/N; 1=RS C/ Nullable: Yes
(I+N); 2=PDSCH or PUSCH C/(I+N). Default: 0

NAME Text (50) Name of the network. Nullable: No


Default:

PDCCH_SYMBOLS Short Number of OFDM symbols per subframe corresponding to the PDCCH. 0; 1; Nullable: No
2; 3; 4. Default: 1

POWER_CONTROL_MARGIN Float Uplink power adjustment margin. Unit: dB. Nullable: Yes
Default: 1
PUCCH_AVG_NRB Float Average number of frequency blocks corresponding to the PUCCH. Nullable: No
Default: 2

RS_EPRE_DEFINITION Short RS EPRE calculation method. 0=Calculated (equal distribution); 1=User- Nullable: Yes
defined; 2=Calculated (with boost); 3=Calculated (without boost); 4=Inde- Default: 0
pendent.

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:
SSF_CONFIG Short TDD: Special subframe configuration. 0; 1; 2; 3; 4; 5; 6; 7; 8. Nullable: Yes
Default: 0

SYSTEM_ Text (50) Name of the system. Nullable: No


Default: ‘LTE’

TECHNOLOGY Text (10) Name of the technology. Nullable: No


Default: ‘OFDM’
THERMAL_NOISE Float Thermal noise. Nullable: Yes
Default: -121

© 2018 Forsk. All Rights Reserved. 143


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

4.2.30 PropagationModels Table

For propagation models.

Field Type Description Attributes

DATA Binary Propagation model parameter settings. Nullable: Yes


Default:
DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:

NAME Text (50) Name of the propagation model. Nullable: No


Default:

SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:
TYPE Text (50) ProgID of the model. Nullable: No
Default:

4.2.31 QualityIndicators Table

For quality indicators (BER, BLER, etc.).

Field Type Description Attributes

CS_QI Boolean Whether the quality indicator is used for circuit-switched services or not. Nullable: No
True=Yes; False=No. Default: True

MEAS_PARAM Short Measurement on which the quality indicator is based. 1=C; 2=CIR. Nullable: Yes
Default: 0

NAME Text (50) Name of the quality indicator. Nullable: No


Default:

PS_QI Boolean Whether the quality indicator is used for packet-switched services or not. Nullable: No
True=Yes; False=No. Default: True
USE_INTERPOLATION Boolean Whether interpolation can be used for the quality indicator graph to find val- Nullable: No
ues between defined ones. True=Yes; False=No. Default: True

4.2.32 Receivers Table

For receiver parameters.

Field Type Description Attributes

ANTENNA Text (50) Antenna model of the default receiver. If not defined, an isotropic receiver is Nullable: Yes
used. Default:

HEIGHT Float Height of the default receiver. Nullable: No


Default: 1.5

LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0.
NAME Text (50) Name of the default receiver. Nullable: No
Default:

144 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

4.2.33 RepeaterEquipments Table

For repeater equipment.

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the repeater equipment. Nullable: Yes
Default:
MANUFACTURER Text (50) Name of the repeater equipment manufacturer. Nullable: Yes
Default:

MAX_AMPLIFIER_GAIN Float Maximum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 90

MAX_OUTPUT_DL Float Maximum downlink output power. Nullable: Yes


Default: 30
MAX_OUTPUT_UL Float Maximum uplink output power. Nullable: Yes
Default: 12

MIN_AMPLIFIER_GAIN Float Minimum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 50

NAME Text (50) Name of the repeater equipment. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the repeater equipment. Unit: dB. Nullable: Yes
Default: 5

STEP_AMPLIFIER_GAIN Float Step of amplifier gain. Unit: dB. Nullable: Yes


Default: 1

TIME_DELAY Float Processing delay of the repeater equipment. Unit: us. Nullable: Yes
Default: 5

4.2.34 Repeaters Table

For repeaters.

Field Type Description Attributes

AMPLIFIER_GAIN Float Repeater amplifier gain. Unit: dB. Nullable: Yes


Default: 80

AZIMUT Float Azimuth of the donor side antenna. Nullable: Yes


Default: 0
DONOR_CELLID Text (100) Name of the donor transmitter. Nullable: No
Default:

DONOR_LINK_LOSS Float Loss over the donor-repeater link. Unit: dB. Nullable: Yes
Default: 0

DONOR_LINK_TYPE Short Type of the donor-repeater link. 1=Off air; 2=Microwave; 3=Fibre. Nullable: No
Default: 1
DONOR_PROPAG_MODEL Text (50) Name of the propagation model used for the donor-repeater link. Nullable: Yes
Default:

DOWNTILT Float Downtilt of the donor side antenna. Nullable: Yes


Default: 0

EQUIPMENT_NAME Text (50) Name of the repeater equipment. Passive repeaters do not have equipment Nullable: Yes
(no amplification). Default:
FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 145


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

FEEDERLENGTH Float Length of donor side downlink feeder. Nullable: Yes


Default: 0
HEIGHT Float Height of the donor side antenna. Nullable: Yes
Default: 25

REC_ANTENNA Text (50) Name of the donor side antenna model. Nullable: Yes
Default:

REC_FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes


Default: 0
TOTAL_GAIN Float Total gain of the repeater. Unit: dB. Nullable: Yes
Default: 0

TX_ID Text (100) Name of the repeater. Nullable: No


Default:

 Repeater properties are saved in two tables: the donor-side parameters are in the
Repeaters table and the coverage-side parameters in the Transmitters table.

4.2.35 Schedulers Table

For schedulers.

Field Type Description Attributes

BEARER_SELECTION Short Bearer selection criterion. 0=Bearer Index; 1=Peak RLC Throughput; 2=Effec- Nullable: Yes
tive RLC Throughput. Default: 0

NAME Text (30) Name of the scheduler. Nullable: No


Default:

SCHEDULING_METHOD Short Scheduling method. 0=Proportional Fair; 1=Proportional Demand; 3=Max C/ Nullable: Yes
I; 4=Round Robin. Default: 0

TARGET_THROUGHPUT_DAT Short Target throughput when scheduling data services. 0=Peak RLC Throughput; Nullable: Yes
A 1=Effective RLC Throughput; 2=Application Throughput. Default: 0
TARGET_THROUGHPUT_VOIC Short Target throughput when scheduling voice services. 0=Peak RLC Throughput; Nullable: Yes
E 1=Effective RLC Throughput; 2=Application Throughput. Default: 0

UL_BW_ALLOCATION Short Target for the uplink bandwidth allocation process. 0=Full bandwidth; Nullable: Yes
1=Maintain connection; 2=Best bearer. Default: 2

4.2.36 SecondaryAntennas Table

For additional antennas.

146 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

ANTENNA Text (50) Name of the secondary antenna model installed on a transmitter. Nullable: No
Default:

AZIMUT Float Azimuth of the secondary antenna. Nullable: No


Default: 0

PERCENT_POWER Float Percentage of power dedicated to the secondary antenna. Unit: %. Nullable: No
Default: 0
REDT Float Remote electrical tilt of the secondary antenna. Nullable: Yes
Default: 0

TILT Float Mechanical downtilt of the secondary antenna. Nullable: No


Default: 0

TX_ID Text (100) Name of the transmitter on which the secondary antenna is installed. Nullable: No
Default:

4.2.37 Sites Table

For sites.

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:
ALTITUDE Float User-defined site altitude. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0
MAX_S1_RATE_DL Float Maximum S1 backhaul throughput for downlink. Unit: kbps. Nullable: Yes
Default: 950000

MAX_S1_RATE_UL Float Maximum S1 backhaul throughput for uplink. Unit: kbps. Nullable: Yes
Default: 950000

NAME Text (50) Name of the site. Nullable: No


Default:
PYLON_HEIGHT Float Height of the pylon. Nullable: Yes
Default: 50

SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

4.2.38 SitesLists Table

For sites belonging to site lists.

© 2018 Forsk. All Rights Reserved. 147


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

LIST_NAME Text (50) Name of the site list. Nullable: No


Default:

SITE_NAME Text (60) Name of the sites belonging to the list. Nullable: No
Default:

4.2.39 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

4.2.40 SmartAntennas Table

For smart antenna equipment.

Field Type Description Attributes

BROADCAST_ANTENNA Text (50) Broadcast (main) antenna model of the smart antenna. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the smart antenna. Nullable: Yes
Default:
NAME Text (50) Name of the smart antenna. Nullable: No
Default:

SA_MODEL Text (50) Name of the smart antenna model used. Nullable: Yes
Default:

4.2.41 SmartAntennasModels Table

For smart antenna models.

Field Type Description Attributes

SA_DATA Binary Smart antenna model parameter settings. Nullable: Yes


Default:

SA_DESCRIPTION Text (50) Additional information about the smart antenna model. Nullable: Yes
Default:

SA_NAME Text (50) Name of the smart antenna model. Nullable: No


Default:
SA_SIGNATURE Text (50) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

SA_TYPE Text (50) ProgID of the model. Nullable: No


Default:

148 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

4.2.42 T4GBearerQualityCurves Table

For bearer performance graphs.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: No


Default: 0
MOBILITY Text (50) Mobility type corresponding to the bearer quality graphs. Nullable: Yes
Default:

QI_CURVE Memo Quality indicator graph as function of C/I. Nullable: Yes


Default:

QI_NAME Text (50) Name of the quality indicator. Nullable: No


Default:
RX_EQUIP Text (50) Reception equipment corresponding to the quality indicator graph. Nullable: No
Default:

4.2.43 T4GBearers Table

For bearers.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: No


Default: 1

CODING_RATE Float Coding rate. Nullable: Yes


Default: 1

MODULATION Short Modulation. 0=BPSK; 1=QPSK; 2=16QAM; 3=64QAM; 4=256QAM. Nullable: No


Default: 1

NAME Text (50) Name of the radio bearer. Nullable: No


Default:
SPECTRAL_EFFICIENCY Float Bearer spectral efficiency. Unit: bps/Hz. Nullable: Yes
Default: 0

4.2.44 T4GBearersRequiredCI Table

For bearer selection thresholds.

Field Type Description Attributes

AAS_THRESHOLD Float AAS activation threshold. Unit: dB. Nullable: Yes


Default:

AMS_THRESHOLD Float Adaptive MIMO switching threshold. Unit: dB. Nullable: Yes
Default:

BEARERS_REQUIRED_COVERI Memo Required quality for selecting a bearer. Nullable: Yes


Default:
BEARERS_REQUIRED_COVERI Memo Uplink bearer selection thresholds. Nullable: Yes
_UL Default:

© 2018 Forsk. All Rights Reserved. 149


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

MOBILITY Text (50) Mobility type corresponding to the bearer selection thresholds. Nullable: Yes
Default:
MUMIMO_THRESHOLD Float MU-MIMO activation threshold. Unit: dB. Nullable: Yes
Default:

RX_EQUIP Text (50) Reception equipment corresponding to the bearer selection thresholds. Nullable: No
Default:

SCELL_THRESHOLD Float SCell activation threshold. Unit: dB. Nullable: Yes


Default:

4.2.45 T4GCells Table

For cells.

Field Type Description Attributes

AAS_RESULTS Binary Angular distributions of interference. Nullable: Yes


Default:
AAS_USAGE Float Percentage of downlink traffic load carried by the smart antenna. Unit: %. Nullable: Yes
Default: 0

ABS_PATTERN Text (80) The pattern of absolute blank subframes with 1=ABS and 0=non-ABS. Nullable: Yes
Default:

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True
AFP_NPCI_STRATEGY Short AFP inband NPCI allocation strategy. 0=None; 1=Identical as LTE. Nullable: Yes
Default: 0

CELL_ID Text (100) Name of the cell. Nullable: No


Default:

CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: Yes


Default: 0

CELL_SELECTION_TH Float Inter-layer cell selection threshold. Unit: dB. Nullable: Yes
Default: 0
CELL_TYPE Short Type of cell. 1=LTE; 2=LTE-A PCell; 3=LTE+LTE-A PCell; 4=LTE-A SCell DL; Nullable: Yes
5=LTE+LTE-A SCell DL; 6=LTE-A PCell+LTE-A SCell DL; 7=LTE+LTE-A Default: 1
PCell+LTE-A SCell DL; 12=LTE-A SCell DL+LTE-A SCell UL; 13=LTE+LTE-A
SCell DL+LTE-A SCell UL; 14=LTE-A PCell+LTE-A SCell DL+LTE-A SCell UL;
15=LTE+LTE-A PCell+LTE-A SCell DL+LTE-A SCell UL.

CELLSIZE_RSI_MAPPING Text (50) Name of the cell size to PRACH RSI mapping. Nullable: Yes
Default:
CHANNEL Integer Channel number. Nullable: Yes
Default: 0

CHANNEL_STATUS Short Channel allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:
DIVERSITY_SUPPORT Short The type of antenna diversity supported by the cell in downlink. 0=None; Nullable: Yes
1=Transmit diversity; 2=SU-MIMO; 3=Transmit diversity+SU-MIMO; 8=AAS; Default: 1
9=Transmit diversity+AAS; 10=SU-MIMO+AAS; 11=Transmit diversity+SU-
MIMO+AAS; 16=MU-MIMO; 17=Transmit diversity+MU-MIMO; 18=SU-
MIMO+MU-MIMO; 19=Transmit diversity+SU-MIMO+MU-MIMO;
24=AAS+MU-MIMO; 25=Transmit diversity+AAS+MU-MIMO; 26=SU-
MIMO+AAS+MU-MIMO; 27=Transmit diversity+SU-MIMO+AAS+MU-MIMO.

150 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

DIVERSITY_SUPPORT_UL Short The type of antenna diversity supported by the cell in uplink. 0=None; Nullable: Yes
1=Receive diversity; 2=SU-MIMO; 3=Receive diversity+SU-MIMO; 16=MU- Default: 1
MIMO; 17=Receive diversity+MU-MIMO; 18=SU-MIMO+MU-MIMO;
19=Receive diversity+SU-MIMO+MU-MIMO.

DL_FFR_USAGE Float Percentage of the downlink traffic located on the cell-edge. Unit: %. Nullable: Yes
Default: 0

DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes


Default: 1

DL_MU_SM_GAIN Float Average number of co-scheduled MU-MIMO users. Nullable: Yes


Default: 0
DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default: 0

FBAND Text (50) Name of the frequency band used by the cell. Nullable: No
Default:

FRAME_CONFIG Text (50) Name of the cell's frame configuration. Nullable: Yes
Default:
HO_MARGIN Float Handover margin. Unit: dB. Nullable: Yes
Default: 0

ICIC_DELTAPL_TH Float Best to 2nd best path loss difference defining the cell-edge area. Unit: dB. Nullable: Yes
Default: 0

ICIC_SUPPORT Short Inter-cell interference coordination support. 0=None; 1=Static DL; 2=Static Nullable: Yes
UL; 3=Static DL+Static UL. Default: 0
ID_REUSE_MIN_DIST Float The minimum reuse distance for automatic resource allocation by the AFP. Nullable: Yes
Default:

ID_STATUS Short SSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

MAX_DL_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default: 100

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell Nullable: Yes
Default:
MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default:

MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes


Default:

MAX_UL_LOAD Float Maximum traffic load allowed on the uplink. Unit: %. Nullable: Yes
Default: 100
MBSFN_SF_PATTERN Text (80) The pattern of MBSFN transmissions in terms of subframes with 1=MBSFN Nullable: Yes
and 0=unicast. Default:

NOISE_RISE_ICIC_UL Float Uplink noise rise at the cell-edge. Unit: dB. Nullable: Yes
Default: 0

NOISE_RISE_UL Float Uplink noise rise. Unit: dB. Nullable: Yes


Default: 0
NUM_DL_USERS Float Number of users connected on the downlink. Nullable: Yes
Default: 1

NUM_UL_USERS Float Number of users connected on the uplink. Nullable: Yes


Default: 1

P_SCH_ID Short PSS ID. Nullable: Yes


Default: 0
PBCH_POWER_OFFSET Float EPRE offset for PBCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 151


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

PCI_DOMAIN_NAME Text (50) Name of the physical cell ID domain. Nullable: Yes
Default:
PDCCH_POWER_OFFSET Float EPRE offset for PDCCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

PDSCH_POWER_OFFSET Float EPRE offset for PDSCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

PHY_CELL_ID Integer Physical cell ID. Nullable: Yes


Default: 0
PMCH_POWER_OFFSET Float EPRE offset for PMCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

POWER Float Transmission power. Nullable: Yes


Default: 43

PRACH_RSI_DOMAIN_NAME Text (50) Name of the PRACH RSI domain. Nullable: Yes
Default:
PRACH_RSI_LIST Text (50) List of allocated PRACH RSIs. Nullable: Yes
Default:

PRACH_RSI_STATUS Short PRACH RSI allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

PSS_ID_STATUS Short PSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0
RANK Short Index of the network layer. Nullable: Yes
Default:

RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT. Nullable: No
Default: 0

REQ_NUM_PRACH_RSI Short Required number of PRACH RSIs. Nullable: No


Default: 1

RS_EPRE Float Reference signal energy per resource element. Nullable: Yes
Default: 0
RSRQ_THRES Float Minimum RSRP for coverage. Nullable: Yes
Default: -140

RX_EQUIPMENT Text (50) Name of the reception equipment associated with the cell. Nullable: Yes
Default:

S_SCH_ID Short SSS ID. Nullable: Yes


Default: 0
SCH_POWER_OFFSET Float EPRE offset for SS with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

SCHEDULER Text (50) Scheduler used by the cell. Nullable: Yes


Default:

SF_CONFIG Short TDD subframe configuration of the cell. 0=DSUUU-DSUUU; 1=DSUUD- Nullable: Yes
DSUUD; 2=DSUDD-DSUDD; 3=DSUUU-DDDDD; 4DSUUD-DDDDD; 5=DSUDD- Default: 1
DDDDD; 6=DSUUU-DSUUD.

TX_CELL_ORDER Short Order of the cell within a transmitter. Nullable: Yes


Default:
TX_ID Text (100) Name of the transmitter to which the cell belongs. Nullable: No
Default:

UL_FPC_CINR_MAX Float Target PUSCH C/(I+N) provides Po_pusch and is driven by noise rise limita- Nullable: Yes
tions of neighbouring cells. Unit: dB. Default: 20

UL_FPC_FACTOR Float Factor enabling reduction of transmission powers of cell-edge users. FPC Nullable: No
Off; 0; 0.4; 0.5; 0.6; 0.7; 0.8; 0.9; 1. Default: 1

152 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

UL_FPC_NR_MAX Float Maximum uplink noise rise. Unit: dB. Nullable: Yes
Default: 6
UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes
Default: 1

UNIQUE_ID Text (50) Unique cell ID. Nullable: Yes


Default:

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default: 0

4.2.46 T4GEnvironmentDefs Table

For traffic environment types.

Field Type Description Attributes

DENSITY Float Number of users per km2. Nullable: Yes


Default: 0
ENVIRONMENT Text (50) Name of the traffic environment. Nullable: No
Default:

MOBILITY Text (50) Mobility type corresponding to the traffic environment. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the traffic environment. Nullable: No
Default:

4.2.47 T4GEquipments Table

For reception equipment.

Field Type Description Attributes

NAME Text (50) Name of the reception equipment Nullable: No


Default:

4.2.48 T4GMimoConfigs Table

For MIMO gain graphs.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: Yes


Default: 1

EQUIPMENT Text (50) Name of the reception equipment corresponding to the MIMO gains. Nullable: No
Default:
MAX_BLER Float Maximum value of BLER for which the gains are applicable. Nullable: Yes
Default: 1

MAX_MIMO_GAIN Memo Maximum MIMO gain graphs as function of C/(I+N). Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 153


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default: 1
MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default: 1

MOBILITY Text(50) Mobility type corresponding to the MIMO gain graph. Nullable: Yes
Default:

MUMIMO_DIV_GAIN Float Diversity gain applicable with MU-MIMO. Unit: dB. Nullable: Yes
Default: 0
MUMIMO_GAIN Memo Graphs of MU-MIMO gains vs. the number of MU-MIMO users. Nullable: Yes
Default:

STTD_GAIN Float PDSCH diversity gain. Unit: dB. Nullable: Yes


Default: 0

SUMIMO_DIV_GAIN Float PDSCH diversity gain applicable with SU-MIMO. Unit: dB. Nullable: Yes
Default: 0

4.2.49 T4GMobility Table

For mobility types.

Field Type Description Attributes

MEAN_SPEED Float Average user speed corresponding to the mobility type. Unit: km/h. Nullable: Yes
Default: 0
NAME Text (50) Name of mobility type. Nullable: No
Default:

4.2.50 T4GServices Table

For services.

Field Type Description Attributes

BODY_LOSS Float Body loss. Unit: dB. Nullable: No


Default: 0
CA_SUPPORT Short Whether carrier aggregation is supported by the service or not. 0=No; 1=Yes. Nullable: Yes
Default: 1

DL_ACTIVITY Float Activity factor for voice services on the downlink. Nullable: Yes
Default: 1

DL_DP Float Inter-packet arrival time on the downlink. Unit: ms. Nullable: Yes
Default: 0
DL_DPC Float Reading time between two packet calls on the downlink. Unit: ms. Nullable: Yes
Default: 0

DL_GBR Float Downlink guaranteed bit rate. Unit: kbps. Nullable: No


Default: 0

DL_HIGHEST_BEARER Float The highest bearer that can be used by the service in downlink. Nullable: Yes
Default: 15
DL_LOWEST_BEARER Short The lowest bearer that can be used by the service in downlink. Nullable: Yes
Default: 1

154 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

DL_MBR Float Downlink maximum bit rate. Unit: kbps. Nullable: No


Default: 0
DL_NPC Integer Number of packet calls during a session on the downlink. Nullable: Yes
Default: 1

DL_SP Integer Packet size on the downlink. Unit: Byte. Nullable: Yes
Default: 1500

DL_SPC_MAX Float Maximum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 2000
DL_SPC_MIN Float Minimum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 4

MIN_RB_UL Integer Minimum number of required frequency blocks for the service. Nullable: Yes
Default: 1

NAME Text (50) Name of the service. Nullable: No


Default:
PRIORITY Short Service priority. 0=Lowest. Nullable: Yes
Default: 0

QCI Short QCI (QoS Class Identifier) of the service. 1; 2; 3; 4; 5; 6; 7; 8; 9. Nullable: Yes
Default:

REQ_AVERAGE_DL_RATE Float Average requested throughput on the downlink. Unit: kbps. Nullable: Yes
Default:
REQ_AVERAGE_UL_RATE Float Average requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default:

SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the service. Nullable: No
Default: “-1”

TH_OFFSET Float Fixed offset to map throughput to the application layer. Nullable: No
Default: 0

TH_SCALE_FACTOR Float Ratio between application throughput and RLC layer throughput. Nullable: No
Default: 95
TYPE Short Type of service. 0=Voice; 1=Data. Nullable: Yes
Default: 0

UL_ACTIVITY Float Activity factor for voice services on the uplink. Nullable: Yes
Default: 1

UL_DP Float Inter-packet arrival time on the uplink. Unit: ms. Nullable: Yes
Default: 0
UL_DPC Float Reading time between two packet calls in uplink. Unit: ms. Nullable: Yes
Default: 0

UL_GBR Float Uplink guaranteed bit rate. Unit: kbps. Nullable: No


Default: 0

UL_HIGHEST_BEARER Float Highest bearer allowed to be used for the service in uplink. Nullable: Yes
Default: 15
UL_LOWEST_BEARER Short Lowest bearer allowed to be used for the service in uplink. Nullable: Yes
Default: 1

UL_MBR Float Uplink maximum bit rate. Unit: kbps. Nullable: No


Default: 0

© 2018 Forsk. All Rights Reserved. 155


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

UL_NPC Integer Reading time between two packet calls on the uplink. Unit: ms. Nullable: Yes
Default: 1
UL_SP Integer Packet size on the uplink. Unit: bytes. Nullable: Yes
Default: 1500

UL_SPC_MAX Float Maximum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 2000

UL_SPC_MIN Float Minimum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 4

4.2.51 T4GServicesUsage Table

For user profile parameters.

Field Type Description Attributes

CALL_DURATION Float Average duration of a call for circuit-switched services. Unit: s. Nullable: Yes
Default:
CALL_NUMBER Float Average number of calls per hour for circuit-switched services or average Nullable: Yes
number of sessions per hour for packet-switched services. Default: 0

DL_VOLUME Float Data volume transferred on the downlink during a session for packet- Nullable: Yes
switched services. Unit: kB. Default:

SERVICE Text (50) Name of the service. Nullable: No


Default:
TERMINAL Text (50) Name of the terminal corresponding to the user profile. Nullable: No
Default:

UL_VOLUME Float Data volume transferred on the uplink during a session for data services. Unit: Nullable: Yes
kB. Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the user profile. Nullable: No
Default:

4.2.52 T4GTerminals Table

For terminal types.

Field Type Description Attributes

ANTENNA Text (50) Name of the antenna model of the terminal. Nullable: Yes
Default:

COMP_SUPPORT Short Coordinated multipoint transmission and reception capabilities of the ter- Nullable: Yes
minal. 0=None; 1=Downlink; 2=Uplink; 3=Downlink+Uplink. Default: 0
DIVERSITY_SUPPORT Short The type of antenna diversity supported by the terminal. 0=None; 1=AAS; Nullable: Yes
2=MIMO; 3=AAS+MIMO. Default: 1

GAIN Float Terminal antenna gain. Unit: dB. Nullable: Yes


Default: 0

IC_MODE Short Supported interference cancelation mode. 0=None; 1=FeICIC. Nullable: No


Default: 0
LOSS Float Terminal antenna loss. Unit: dB. Nullable: Yes
Default: 0

156 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. 1; 2; 4; 8. Nullable: Yes
Default: 1
MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. 1; 2; 4; 8. Nullable: Yes
Default: 1

N_SCELLS_DL Short Maximum number of SCells in downlink. Nullable: Yes


Default: 0

N_SCELLS_UL Short Maximum number of SCells in uplink. Nullable: Yes


Default: 0
NAME Text (50) Name of the terminal. Nullable: No
Default:

NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

PMAX Float Maximum transmission power of the terminal. Nullable: Yes


Default: 23
PMIN Float Minimum transmission power of the terminal. Nullable: Yes
Default: -40

RX_EQUIP Text (50) Name of the reception equipment associated with the terminal. Nullable: Yes
Default: "Default CPE
Reception Equipment"
SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the terminal. Nullable: No
Default: “-1”

UE_CATEGORY Text (50) UE category. Nullable: Yes


Default:

4.2.53 T4GTraficEnvironments Table

For traffic environment clutter weighting.

Field Type Description Attributes

CLUTTER_WEIGHTS Binary Clutter weighting for traffic environment maps. Nullable: Yes
Default:

NAME Text (50) Name of the traffic environment. Nullable: No


Default:

4.2.54 T4GUECategories Table

For UE categories.

Field Type Description Attributes

BEST_MODULATION Short Highest supported modulation in uplink. 0=QPSK; 1=16QAM; 2=64QAM; Nullable: Yes
3=256QAM. Default: 1

DL_TBS_MAX Float Maximum number of transport block bits per TTI in downlink. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 157


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

MAX_MIMO_RX_ANTENNAS Short Maximum number of reception antenna ports. Nullable: Yes


Default: 1
NAME Text (50) Name of the UE category. Nullable: No
Default:

UE_CAT_FOR_DOWNGRADE Text (50) Name of the UE category for downgrade from LTE-A to LTE. Nullable: Yes
Default:

UL_TBS_MAX Float Maximum number of uplink transport block bits per TTI. Nullable: Yes
Default:

4.2.55 T4GUserProfiles Table

For names of user profiles.

Field Type Description Attributes

NAME Text (50) Name of the user profile. Nullable: No


Default:

4.2.56 TMAEquipments Table

For tower-mounted amplifiers.

Field Type Description Attributes

DL_LOSSES Float Downlink losses of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the tower mounted amplifier. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

UL_GAIN Float Uplink gain of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

4.2.57 TplTransmitters Table

For station templates.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default:

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: No
Default:
AZIMUT Float Azimuth of the main antenna. Nullable: Yes
Default:

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:

158 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default:
CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:
CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: Yes
Default:

CELL_SELECTION_TH Float Inter-layer cell selection threshold. Unit: dB. Nullable: Yes
Default:

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default:
CELL_TYPE Short Type of cell. 0=1=LTE; 2=LTE-A PCell; 3=LTE+LTE-A PCell; 4=LTE-A SCell DL; Nullable: Yes
5=LTE+LTE-A SCell DL; 6=LTE-A PCell+LTE-A SCell DL; 7=LTE+LTE-A Default:
PCell+LTE-A SCell DL; 8=12=LTE-A SCell DL+LTE-A SCell UL; 9=13=LTE+LTE-
A SCell DL+LTE-A SCell UL; 10=14=LTE-A PCell+LTE-A SCell DL+LTE-A SCell
UL; 11=15=LTE+LTE-A PCell+LTE-A SCell DL+LTE-A SCell UL.

CHANNEL_LIST Text (255) List of channels used by the transmitters. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DIVERSITY_SUPPORT Short The type of antenna diversity supported by the cell in downlink. 0=None; Nullable: Yes
1=Transmit diversity; 2=SU-MIMO; 3=Transmit diversity+SU-MIMO; 8=AAS; Default:
9=Transmit diversity+AAS; 10=SU-MIMO+AAS; 11=Transmit diversity+SU-
MIMO+AAS; 16=MU-MIMO; 17=Transmit diversity+MU-MIMO; 18=SU-
MIMO+MU-MIMO; 19=Transmit diversity+SU-MIMO+MU-MIMO;
24=AAS+MU-MIMO; 25=Transmit diversity+AAS+MU-MIMO; 26=SU-
MIMO+AAS+MU-MIMO; 27=Transmit diversity+SU-MIMO+AAS+MU-MIMO.

DIVERSITY_SUPPORT_UL Short The type of antenna diversity supported by the cell in uplink. 0=None; Nullable: Yes
1=Transmit diversity; 2=SU-MIMO; 3=Transmit diversity+SU-MIMO; 16=MU- Default:
MIMO; 17=Transmit diversity+MU-MIMO; 18=SU-MIMO+MU-MIMO;
19=Transmit diversity+SU-MIMO+MU-MIMO.

DL_FFR_USAGE Float Percentage of the downlink traffic located on the cell-edge. Unit: %. Nullable: Yes
Default:
DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes
Default:

DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default:

FBAND Text (50) Name of the frequency band used by the cell. Nullable: No
Default:
FEEDER_NAME Text (50) Name of the feeder equipment. Nullable: Yes
Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default:

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default:
FRAME_CONFIG Text (50) Name of the cell's frame configuration. Nullable: Yes
Default:

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default:

HO_MARGIN Float Handover margin. Unit: dB. Nullable: Yes


Default:

© 2018 Forsk. All Rights Reserved. 159


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

ICIC_DELTAPL_TH Float Best to 2nd best path loss difference defining the cell-edge area. Unit: dB. Nullable: Yes
Default:
ICIC_SUPPORT Short Inter-cell interference coordination support. 0=None; 1=Static DL; 2=Static Nullable: Yes
UL; 3=Static DL+Static UL. Default:

ID_REUSE_MIN_DIST Float The minimum reuse distance for automatic resource allocation by the AFP. Nullable: Yes
Default:

LAYER_LIST Text (255) List of network layer indexes used by the transmitters. Nullable: Yes
Default:
MAX_DL_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default:

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default:
MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes
Default:

MAX_UL_LOAD Float Maximum traffic load allowed on the uplink. Unit: %. Nullable: Yes
Default:

MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes


Default:
MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes
Default:

N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes


Default:

NAME Text (50) Name of the station template. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default:
NOISE_RISE_ICIC_UL Float Uplink noise rise at the cell-edge. Unit: dB. Nullable: Yes
Default:

NOISE_RISE_UL Float Uplink noise rise. Unit: dB. Nullable: Yes


Default:

NUM_SECTORS Integer Number of sectors in the station template. Nullable: No


Default:
PBCH_POWER_OFFSET Float EPRE offset for PBCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default:

PCI_DOMAIN_NAME Text (50) Name of the physical cell ID domain. Nullable: Yes
Default:

PDCCH_POWER_OFFSET Float EPRE offset for PDCCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default:
PDSCH_POWER_OFFSET Float EPRE offset for PDSCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default:

PHY_CELLID_LIST Text(255) List of physical cell IDs used by transmitters. Nullable: Yes
Default:

PMCH_POWER_OFFSET Float EPRE offset for PMCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default:
POWER Float Transmission power. Nullable: Yes
Default:

PRACH_RSI_DOMAIN_NAME Text (50) Name of the PRACH RSI domain. Nullable: Yes
Default:

160 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:
PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

RAT Short Radio access technology of the station template. 0=LTE; 1=NB-IoT. Nullable: No
Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default:
REQ_NUM_PRACH_RSI Short Required number of PRACH RSIs. Nullable: Yes
Default:

RS_EPRE Float Reference signal energy per resource element. Nullable: Yes
Default:

RSRQ_THRES Float Minimum RSRP for coverage. Nullable: Yes


Default:
RX_ANTENNAS_PORTS Short Number of reception antenna ports. 0; 1; 2; 4; 8. Nullable: Yes
Default:

RX_EQUIPMENT Text (50) Name of the reception equipment associated with the cell. Nullable: Yes
Default:

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default:
SA_NAME Text (50) Name of the smart antenna. Nullable: Yes
Default:

SCH_POWER_OFFSET Float EPRE offset for SS with respect to RS EPRE. Unit: dB. Nullable: Yes
Default:

SCHEDULER Text (30) Scheduler used by the cell. Nullable: Yes


Default:

SF_CONFIG Short TDD subframe configuration of the cell. 0=DSUUU-DSUUU; 1=DSUUD- Nullable: Yes
DSUUD; 2=DSUDD-DSUDD; 3=DSUUU-DDDDD; 4DSUUD-DDDDD; 5=DSUDD- Default:
DDDDD; 6=DSUUU-DSUUD.

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:
SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:

SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes


Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default:
TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TX_ANTENNAS_PORTS Short Number of transmission antenna ports. 0; 1; 2; 4; 8. Nullable: Yes


Default:

TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default:
TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default:

UL_FPC_CINR_MAX Float Target PUSCH C/(I+N) provides Po_pusch and is driven by noise rise limita- Nullable: Yes
tions of neighbouring cells. Unit: dB. Default:

© 2018 Forsk. All Rights Reserved. 161


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Field Type Description Attributes

UL_FPC_FACTOR Float Factor enabling reduction of transmission powers of cell-edge users. FPC Nullable: Yes
Off; 0; 0.4; 0.5; 0.6; 0.7; 0.8; 0.9; 1. Default:
UL_FPC_NR_MAX Float Maximum uplink noise rise. Unit: dB. Nullable: Yes
Default:

UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes


Default:

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default:

4.2.58 Transmitters Table

For transmitters.

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:
ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: Yes
Default:
AZIMUT Float Azimuth of the main antenna. Nullable: Yes
Default: 0

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default: 4000

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default: 50

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default: 2000
COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DX Float X coordinate relative to the site location. Nullable: Yes


Default: 0

DY Float X coordinate relative to the site location. Nullable: Yes


Default: 0
FEEDER_NAME Text (50) Name of the feeder. Nullable: Yes
Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default: 0

162 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Field Type Description Attributes

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default: 25
HEXAGON_GROUP Text (50) Group of hexagons used to create the transmitter. Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:

MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes


Default: 0
MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes
Default: 0

N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes


Default:

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default: 5
PROPAG_MODEL Text (50) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:

PROPAG_MODEL2 Text (50) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default: 0
RX_ANTENNAS_PORTS Short Number of reception antenna ports. 0; 1; 2; 4; 8. Nullable: Yes
Default: 1

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0

SA_NAME Text (50) Name of the smart antenna. Nullable: Yes


Default:

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:
SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:

SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes


Default: 0

SITE_NAME Text (60) Name of the site on which the transmitter is located. Nullable: No
Default:
TILT Float Mechanical downtilt of the main antenna. Nullable: Yes
Default: 0

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TX_ANTENNAS_PORTS Short Number of transmission antenna ports. 0; 1; 2; 4; 8. Nullable: Yes


Default: 1
TX_ID Text (100) Name of the transmitter. Nullable: No
Default:

TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default: 0

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0
USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

© 2018 Forsk. All Rights Reserved. 163


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

4.2.59 TxsLists Table

For transmitters belonging to transmitter lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the transmitter list. Nullable: No


Default:
TX_NAME Text (100) Name of the transmitters belonging to the list. Nullable: No
Default:

4.2.60 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

NAME Text (50) Name of the transmitter list. Nullable: No


Default:

4.2.61 Units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, and the
database internal coordinate system.

Field Type Description Attributes

COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes


Default: -1

GAIN_UNIT Integer Unit used for gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0

PROJECTION Integer Projection coordinate system of the document. Nullable: Yes


Default: -1

RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0
TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No
Default: 0

4.3 Relationships

Many-to-One Relationships (  1)

lcagroupdefs.CA_GROUP_MEMBER_CELL T4GCells.CELL_ID

lcagroupdefs.CA_GROUP_NAME lcagroups.NAME

lcchdivgains.EQUIPMENT T4GEquipments.NAME

lcchdivgains.MOBILITY T4GMobility.NAME

lcompsetdefs.COMP_SET_MEMBER_CELL T4GCells.CELL_ID

164 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 4: LTE Data Structure

Many-to-One Relationships (  1)

lcompsetdefs.COMP_SET_NAME lcompsets.NAME

lmbsfnareadefs.MBSFN_AREA_NAME lmbsfnareas.NAME

lmbsfnareadefs.MBSFN_MEMBER_CELL T4GCells.CELL_ID

lmbsfnareas.MBSFN_AREA_MCE T4GCells.CELL_ID

lpcigroups.DOMAIN_NAME lpcidomains.DOMAIN_NAME

lprachgroups.DOMAIN_NAME lprachdomains.DOMAIN_NAME

lrelaylinks.ANTENNA Antennas.NAME

lrelaylinks.DONOR_CELL_ID T4GCells.CELL_ID

lrelaylinks.FEEDER_NAME FeederEquipments.NAME

lrelaylinks.PROPAG_MODEL PropagationModels.NAME

lrelaylinks.RELAY_SITE_NAME Sites.NAME

lrepetitions.EQUIPMENT T4GEquipments.NAME

lrepetitions.MOBILITY T4GMobility.NAME

lterminalbands.FBAND_NAME FrequencyBands.NAME

lterminalbands.TERMINAL_NAME T4GTerminals.NAME

MUGTables.BEARER_INDEX T4GBearers.BEARER_INDEX

MUGTables.MOBILITY T4GMobility.NAME
MUGTables.SCHEDULER_NAME Schedulers.NAME

Neighbours.NEIGHBOUR T4GCells.CELL_ID

Neighbours.TRANSMITTER T4GCells.CELL_ID
NeighboursConstraints.NEIGHBOUR T4GCells.CELL_ID

NeighboursConstraints.TRANSMITTER T4GCells.CELL_ID

NeighboursConstraintsExt.TRANSMITTER T4GCells.CELL_ID
NeighboursExt.TRANSMITTER T4GCells.CELL_ID

Networks.DEFAULT_MODEL PropagationModels.NAME

Receivers.ANTENNA Antennas.NAME
Repeaters.DONOR_CELLID Transmitters.TX_ID

Repeaters.DONOR_PROPAG_MODEL PropagationModels.NAME

Repeaters.EQUIPMENT_NAME RepeaterEquipments.NAME

Repeaters.FEEDER_NAME FeederEquipments.NAME

Repeaters.REC_ANTENNA Antennas.NAME

Repeaters.TX_ID Transmitters.TX_ID

SecondaryAntennas.ANTENNA Antennas.NAME

SecondaryAntennas.TX_ID Transmitters.TX_ID

SitesLists.LIST_NAME SitesListsNames.NAME

SitesLists.SITE_NAME Sites.NAME

SmartAntennas.SA_MODEL SmartAntennasModels.SA_NAME

T4GBearerQualityCurves.BEARER_INDEX T4GBearers.BEARER_INDEX
T4GBearerQualityCurves.MOBILITY T4GMobility.NAME

T4GBearerQualityCurves.QI_NAME QualityIndicators.NAME

T4GBearerQualityCurves.RX_EQUIP T4GEquipments.NAME
T4GBearersRequiredCI.MOBILITY T4GMobility.NAME

T4GBearersRequiredCI.RX_EQUIP T4GEquipments.NAME

T4GCells.FBAND FrequencyBands.NAME

© 2018 Forsk. All Rights Reserved. 165


Atoll 3.4.0 Data Structure Reference Guide
Chapter 4: LTE Data Structure

Many-to-One Relationships (  1)

T4GCells.FRAME_CONFIG lframeconfigs.NAME

T4GCells.PCI_DOMAIN_NAME lpcidomains.DOMAIN_NAME

T4GCells.PRACH_RSI_DOMAIN_NAME lprachdomains.DOMAIN_NAME

T4GCells.RANK llayers.LAYER_INDEX

T4GCells.RX_EQUIPMENT T4GEquipments.NAME

T4GCells.SCHEDULER Schedulers.NAME

T4GCells.TX_ID Transmitters.TX_ID

T4GEnvironmentDefs.ENVIRONMENT T4GTraficEnvironments.NAME

T4GEnvironmentDefs.MOBILITY T4GMobility.NAME

T4GEnvironmentDefs.USER_PROFILE T4GUserProfiles.NAME

T4GMimoConfigs.BEARER_INDEX T4GBearers.BEARER_INDEX

T4GMimoConfigs.EQUIPMENT T4GEquipments.NAME

T4GMimoConfigs.MOBILITY T4GMobility.NAME

T4GServices.DL_HIGHEST_BEARER T4GBearers.BEARER_INDEX

T4GServices.DL_LOWEST_BEARER T4GBearers.BEARER_INDEX

T4GServices.UL_HIGHEST_BEARER T4GBearers.BEARER_INDEX

T4GServices.UL_LOWEST_BEARER T4GBearers.BEARER_INDEX
T4GServicesUsage.SERVICE T4GServices.NAME

T4GServicesUsage.TERMINAL T4GTerminals.NAME

T4GServicesUsage.USER_PROFILE T4GUserProfiles.NAME
T4GTerminals.ANTENNA Antennas.NAME

T4GTerminals.RX_EQUIP T4GEquipments.NAME

T4GTerminals.UE_CATEGORY T4GUECategories.NAME
Transmitters.ANTENNA_NAME Antennas.NAME

Transmitters.BTS_NAME BTSEquipments.NAME

Transmitters.FEEDER_NAME FeederEquipments.NAME
Transmitters.PROPAG_MODEL PropagationModels.NAME

Transmitters.PROPAG_MODEL2 PropagationModels.NAME

Transmitters.SA_NAME SmartAntennas.NAME

Transmitters.SITE_NAME Sites.NAME

Transmitters.TMA_NAME TMAEquipments.NAME

TxsLists.LIST_NAME TxsListsNames.NAME

TxsLists.TX_NAME Transmitters.TX_ID

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

166 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

5 5G NR LTE Data Structure


5G NR LTE Atoll documents can contain 5G NR, LTE, and NB-IoT technologies. Tables in the 5G NR LTE template
include the following categories of tables:
 "Data Tables Common to All Technologies" on page 167: These tables are shared and used by all the
technologies.
 "5G NR LTE Data Tables" on page 177: These tables are shared and used by 5G NR, LTE, and NB-IoT.

 Primary keys are listed in bold and italic characters.

5.1 Data Tables Common to All Technologies

5.1.1 antennas Table

For broadcast antenna patterns.

Field Type Description Attributes

BEAMWIDTH Float Half-power beamwidth of the antenna pattern. Nullable: Yes


Default:

COMMENT_ Text (255) Additional information about the antenna pattern. Nullable: Yes
Default:

CONSTRUCTOR Text (50) Name of the antenna manufacturer. Nullable: Yes


Default:
DIAGRAM Binary Antenna 2D or 3D patterns. Nullable: Yes
Default:

ELECTRICAL_AZIMUTH Float Electrical azimuth of the antenna pattern. Nullable: Yes


Default:

ELECTRICAL_TILT Float Electrical tilt of the antenna pattern. Nullable: Yes


Default:

FMAX Double Maximum operating frequency of the antenna pattern. Unit: MHz. Nullable: Yes
Default:
FMIN Double Minimum operating frequency of the antenna pattern. Unit: MHz. Nullable: Yes
Default:

GAIN Float Antenna pattern gain compared to an isotropic radiator. Unit: dBi. Nullable: No
Default: 0

NAME Text (50) Name of the antenna pattern. Nullable: No


Default:
PHYSICAL_ANTENNA Text (50) Name of the physical antenna model to which the antenna pattern belongs. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 167


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

 The format of the binary field, DIAGRAM, is described in "RF 2D Antenna Pattern
Format" on page 355.

5.1.2 btsequipments Table

For transmitter equipment.

Field Type Description Attributes

CONFIG_DL_LOSSES Float Downlink losses due to transmitter components (duplexer, combiner, etc.). Nullable: Yes
Unit: dB. Default: 0
CONFIG_UL_LOSSES Float Uplink losses due to transmitter components (duplexer, combiner, etc.). Unit: Nullable: Yes
dB. Default: 0

NAME Text (50) Name of transmitter equipment. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of transmitter equipment. Unit: dB. Nullable: Yes
Default: 0
RHO_FACTOR Short CDMA rho factor for self interference. Nullable: Yes
Default: 100

5.1.3 coordsys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

Field Type Description Attributes

CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default:

DATUM_CODE Double Identification code of the datum. Nullable: Yes


Default: 0

DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0
DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes
Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0
DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes
Default: 0

DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes


Default: 0

DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes


Default: 0
ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No
Default: 0

ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes


Default: 0

168 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes


Default: 0

GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:

PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes


Default: 0
PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes
Default: 0

PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes


Default: 0

PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0

PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes


Default: 0

5.1.4 customfields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:
CHOICE_LIST Memo Choice list for text fields. Nullable: Yes
Default:

CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default: 0

COLUMN_NAME Text (50) Name of the custom field. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 169


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

DEFAULT_VALUE Text (100) Default value for the field. Nullable: Yes
Default:

DISPLAY_TYPE Integer Whether the field is hyper-text or regular and modifiable or read-only. 0=Reg- Nullable: Yes
ular & Modifiable; 1=Regular &Read-only; 2=Hyper-text & Modifiable; Default: 0
3=Hyper-text & Read-only.

GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:

TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.
 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.
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


 Table and field names are case sensitive.
 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any 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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the

170 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

5.1.5 environmentdefs Table

For traffic environment types.

Field Type Description Attributes

DENSITY Float Number of users per unit area. Nullable: Yes


Default: 0
ENVIRONMENT Text (50) Name of the traffic environment. Nullable: No
Default:

MOBILITY Text (50) Name of the mobility type corresponding to the traffic environment. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the traffic environment. Nullable: No
Default:

5.1.6 feederequipments Table

Field Type Description Attributes

CONNECTOR_LOSSES_DL Float Feeder connector losses in downlink. Unit: dB. Nullable: Yes
Default: 0
CONNECTOR_LOSSES_UL Float Feeder connector losses in uplink. Unit: dB. Nullable: Yes
Default: 0

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

LOSS_PER_METER Float Feeder loss per meter. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the feeder. Nullable: No


Default:

5.1.7 interratirfs Table

For inter-network interference reduction factor graphs.

Field Type Description Attributes

ICP Memo Inter-RAT interference reduction graph as a function of frequency difference Nullable: Yes
between channels. Default:

ITF_BW Double Channel width of the interfering cell. Unit: kHz. Nullable: No
Default:

ITF_TECHNO Text (50) Technology of the interfering cell. Nullable: No


Default:
V_BW Double Channel width of the interfered cell. Unit: kHz. Nullable: No
Default:

© 2018 Forsk. All Rights Reserved. 171


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

5.1.8 mobility Table

For mobility types.

Field Type Description Attributes

MEAN_SPEED Float Average user speed corresponding to the mobility type. Unit: km/h. Nullable: Yes
Default: 0

NAME Text (50) Name of mobility type. Nullable: No


Default:

5.1.9 networks Table

The networks table contains one record for each technology in the document. In each record, only parameters
relevant for the row’s technology are used.

Field Type Description Attributes

BF_CRITERION Short Radio parameter on which beamforming activation is based. 0=C/N; 1=C/ Nullable: Yes
(I+N); 2=Traffic C/(I+N). Default: 0
CELL_SELECTION Short Serving cell selection method. 2=Random; 3=Standard. Nullable: Yes
Default: 0

DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes


Default: “Cost-Hata”

DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No


Default: 100
DMAX Float Maximum radius for a cell. Nullable: No
Default: -1

INTERFERERS_RX_THRESH Float Lowest received interference level. Unit: dB. Nullable: Yes
Default: -20

LTE_RS_EPRE_DEFINITION Short RS EPRE calculation method. 0=Calculated (equal distribution); 1=User- Nullable: Yes
defined; 2=Calculated (with boost); 3=Calculated (without boost); 4=Inde- Default: 0
pendent.

MUMIMO_CRITERION Short Radio parameter on which MU-MIMO activation is based. 0=C/N; 1=C/(I+N); Nullable: Yes
2=Traffic C/(I+N). Default: 0

NAME Text (50) Name of the network. Nullable: No


Default:
POWER_CONTROL_MARGIN Float Uplink power adjustment margin. Unit: dB. Nullable: Yes
Default: 1

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:
SUMIMO_CRITERION Short Radio parameter on which SU-MIMO activation is based. 0=C/N; 1=C/(I+N); Nullable: Yes
2=Traffic C/(I+N). Default: 0

SYSTEM_ Text (50) Name of the system. Nullable: No


Default:

TECHNOLOGY Text (50) Name of the technology. Nullable: No


Default: “OFDM”

172 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

5.1.10 propagationmodels Table

For propagation models.

Field Type Description Attributes

DATA Binary Propagation model parameter settings. Nullable: Yes


Default:

DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:

NAME Text (50) Name of the propagation model. Nullable: No


Default:
SIGNATURE Text (40) Unique global ID of the most recent modification to model Nullable: No
Default:

TYPE Text (50) ProgID of the model. Nullable: No


Default:

5.1.11 receivers Table

For receiver parameters.

Field Type Description Attributes

ANTENNA Text (50) Antenna pattern of the default receiver. If not defined, an isotropic receiver Nullable: Yes
is used. Default:
HEIGHT Float Height of the default receiver. Nullable: No
Default: 1.5

LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0

NAME Text (50) Name of the default receiver. Nullable: No


Default:

5.1.12 repeaterequipments Table

For repeater equipment.

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the repeater equipment. Nullable: Yes
Default:
MANUFACTURER Text (50) Name of the repeater equipment manufacturer. Nullable: Yes
Default:

MAX_AMPLIFIER_GAIN Float Maximum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 90

MAX_OUTPUT_DL Float Maximum downlink output power. Nullable: Yes


Default: 30
MAX_OUTPUT_UL Float Maximum uplink output power. Nullable: Yes
Default: 12

MIN_AMPLIFIER_GAIN Float Minimum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 50

© 2018 Forsk. All Rights Reserved. 173


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

NAME Text (50) Name of the repeater equipment. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the repeater equipment. Unit: dB. Nullable: Yes
Default: 5

STEP_AMPLIFIER_GAIN Float Step of amplifier gain. Unit: dB. Nullable: Yes


Default: 1
TIME_DELAY Float Processing delay of the repeater equipment. Unit: us. Nullable: Yes
Default: 5

5.1.13 services Table

For services.

Field Type Description Attributes

DL_ACTIVITY Float Activity factor of the service in downlink. Nullable: Yes


Default: 1

NAME Text (50) Name of the service. Nullable: No


Default:
REQ_AVERAGE_DL_RATE Float Average requested throughput in downlink. Unit: kbps. Nullable: Yes
Default: 0

REQ_AVERAGE_UL_RATE Float Average requested throughput in uplink. Unit: kbps. Nullable: Yes
Default: 0

SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the service. Nullable: No
Default: “-1”

TECHNO_PRIORITY Text (50) List of supported radio access technologies in the order of priority. Nullable: Yes
Default:
TYPE Short Type of service. 0=Voice; 1=Data; 2=IoT; 4=Broadband. Nullable: Yes
Default: 0

UL_ACTIVITY Float Activity factor of the service in uplink. Nullable: Yes


Default: 1

5.1.14 servicesusage Table

For user profile parameters.

Field Type Description Attributes

CALL_DURATION Float Average duration of a call for voice services. Unit: s. Nullable: Yes
Default:
CALL_NUMBER Float Average number of calls per hour for voice services or average number of Nullable: Yes
sessions per hour for data services. Default: 0

DL_VOLUME Float Data volume transferred in downlink during a session for data services. Unit: Nullable: Yes
kB. Default:

174 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

SERVICE Text (50) Name of the service corresponding to the user profile. Nullable: No
Default:

TERMINAL Text (50) Name of the terminal corresponding to the user profile. Nullable: No
Default:

UL_VOLUME Float Data volume transferred in uplink during a session for data services. Unit: kB. Nullable: Yes
Default:
USER_PROFILE Text (50) Name of the user profile. Nullable: No
Default:

5.1.15 sites Table

For sites.

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

ALTITUDE Float User-defined site altitude. Nullable: Yes


Default:
BH_CAPACITY_DL Float Maximum backhaul throughput for downlink. Unit: kbps. Nullable: Yes
Default: 950000

BH_CAPACITY_UL Float Maximum backhaul throughput for uplink. Unit: kbps. Nullable: Yes
Default: 950000

COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0
LONGITUDE Double X coordinate or longitude. Nullable: No
Default: 0

NAME Text (60) Name of the site. Nullable: No


Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50
SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

5.1.16 siteslists Table

For sites belonging to site lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the site list. Nullable: No


Default:

SITE_NAME Text (60) Name of the sites belonging to the list. Nullable: No
Default:

© 2018 Forsk. All Rights Reserved. 175


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

5.1.17 siteslistsnames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

5.1.18 terminals Table

For terminal types.

Field Type Description Attributes

NAME Text (50) Name of the terminal type. Nullable: No


Default:

SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the terminal. Nullable: No
Default: “-1”

5.1.19 tmaequipments Table

For tower-mounted amplifiers.

Field Type Description Attributes


DL_LOSSES Float Downlink losses of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the tower mounted amplifier. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

UL_GAIN Float Uplink gain of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

5.1.20 trafficenvs Table

For traffic environment clutter weighting.

Field Type Description Attributes


CLUTTER_WEIGHTS Binary Clutter weighting for traffic environment maps. Nullable: Yes
Default:

NAME Text (50) Name of the traffic environment. Nullable: No


Default:

176 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

5.1.21 units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, and the
database internal coordinate system.

Field Type Description Attributes

COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes


Default: -1

GAIN_UNIT Integer Unit used for antenna pattern gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0

PROJECTION Integer Projection coordinate system of the document. Nullable: Yes


Default: -1
RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0

TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No


Default:

5.1.22 userprofiles Table

For names of user profiles.

Field Type Description Attributes

NAME Text (50) Name of the user profile. Nullable: No


Default:

5.2 5G NR LTE Data Tables

5.2.1 lrelaylinks Table

For donor-side propagation parameters of relay nodes.

Field Type Description Attributes

ANTENNA Text (50) Name of the donor side antenna pattern. Nullable: Yes
Default:
AZIMUT Float Downtilt of the donor side antenna. Nullable: Yes
Default: 0

DONOR_CELL_ID Text (100) Name of the donor cell. Nullable: Yes


Default:

FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:
FEEDERLENGTH_DL Float Length of donor side downlink feeder. Nullable: Yes
Default: 0

FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 177


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

HEIGHT Float Height of the donor side antenna. Nullable: Yes


Default: 5

PROPAG_MODEL Text (50) Name of the propagation model used for the donor-relay link. Nullable: Yes
Default:

RELAY_SITE_NAME Text (60) Name of the relay node site. Nullable: No


Default:
TILT Float Azimuth of the donor side antenna. Nullable: Yes
Default: 0

5.2.2 tpltransmitters Table

Field Type Description Attributes


ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No
Default: True

ANTENNA_NAME Text (50) Name of the broadcast antenna pattern assigned to the transmitters of the Nullable: Yes
station template. Default:

AZIMUT Float Azimuth of the broadcast and beamforming antennas. Nullable: Yes
Default: 0
BF_MODEL Text (50) Name of the beamforming antenna model. Nullable: Yes
Default:

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default: 4000

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default: 50

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CARRIER Text (100) Name of the carrier assigned to the cells of the station template. Nullable: Yes
Default:
CELL_EDGE_MARGIN Float LTE RSRP or 5G NR SSS RSRP difference defining the cell-edge area. Unit: dB. Nullable: Yes
Default: 0

CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: Yes


Default: 0

CELL_SELECTION_TH Float Inter-layer cell selection threshold. Unit: dB. Nullable: Yes
Default: 0
CELL_SIZE Float Radius of the cell (schematically represented by an hexagon). Unit: m. Nullable: Yes
Default: 2000

CELL_TYPE Short Type of cell. 5G NR: 1=PCell; 2=SCell (DL)m 4=SCell (UL). LTE: 1=LTE; 2=LTE- Nullable: Yes
A PCell; 4=LTE-A SCell (DL); 8=LTE-A SCell (UL). NB-IoT: 1=Standard; 2=Mul- Default: 1
ticarrier anchor; 4=Multicarrier slave (DL); 8=Multicarrier slave (UL).

COMMENT_ Text (255) Additional information about the station template. Nullable: Yes
Default:

CYCLIC_PREFIX Short Cyclic prefix used by the cells of the station template. 0=Normal; 1=Extended. Nullable: Yes
Default: 0
DL_CELL_EDGE_TRAFFIC Float Percentage of the downlink traffic located on the cell-edge. Unit: %. Nullable: Yes
Default: 0

178 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

DL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in downlink. 0=None; 1=Transmit Diver- Nullable: Yes
sity; 2=SU-MIMO; 4=MU-MIMO. Default: 1

DL_EXTERNAL_NOISE_RISE Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
Default: 0

DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes


Default: 100
DL_MAX_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default: 100

DL_UL_RATIO Float Ratio of the downlink traffic with respect to the total traffic carried by the cell. Nullable: Yes
Default: 50

EQUIPMENT Text (50) Name of the radio equipment associated with the cells of the template. Nullable: Yes
Default:
FEEDER_NAME Text (50) Name of the feeder equipment. Nullable: Yes
Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default: 0
FRAME_CONFIG Short Frame configuration of the cells of the template. 0=None; 1=FDD; 2=TDD 0 Nullable: Yes
- DSUUUDSUUU; 3=TDD 1 - DSUUDDSUUD; 4=TDD 2- DSUDDDSUDD; 5=TDD Default:
3-DSUUUDDDDD; 6=TDD 4-DSUUDDDDDD; 7=TDD 5 - DSUDDDDDDD; 8=TDD
6 - DSUUUDSUUD.

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default: 25

HO_MARGIN Float Handover margin. Unit: dB. Nullable: Yes


Default: 0

ICIC_MODE Short Inter-cell interference coordination mode. 0=TD-FFR; 1=Hard FFR; 2=Soft Nullable: Yes
FFR; 3=Partial Soft FFR. Default: 0
ICIC_PRB_GROUP0 Text (255) List of PRB indexes allocated to ICIC group 0. Nullable: Yes
Default:

ICIC_PRB_GROUP1 Text (255) List of PRB indexes allocated to ICIC group 1. Nullable: Yes
Default:

ICIC_PRB_GROUP2 Text (255) List of PRB indexes allocated to ICIC group 2. Nullable: Yes
Default:
ICIC_SUPPORT Short Inter-cell interference coordination support. 0=None; 1=Static DL; 2=Static Nullable: Yes
UL. Default: 0

LAYER Short Index of the network layer assigned to the cells of the template. Nullable: Yes
Default: 0

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:
MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default:

MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes


Default:

MAX_POWER Float Maximum cell transmission power. Nullable: Yes


Default: 43
MAX_RANGE Integer Maximum coverage range. Nullable: Yes
Default:

MIN_RSRP Float Minimum LTE RSRP, NB-IoT NRSRP, or 5G NR SSS RSRP required for cover- Nullable: Yes
age. Default: -140

MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 179


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default: 0

N_RS_PORTS Short Number of CRS ports. 1; 2; 4. Nullable: Yes


Default:

N_RX_ANTENNAS Short Number of reception antenna ports. Nullable: Yes


Default: 1
N_TX_ANTENNAS Short Number of transmission antenna ports. Nullable: Yes
Default: 1

N_TX_PA Short Number of power amplifiers for the transmission antenna ports. Nullable: Yes
Default:

NAME Text (50) Name of the station template. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the transmitters of the station template. Unit: dB. Nullable: Yes
Default: 5

NUM_SECTORS Integer Number of sectors. Nullable: No


Default: 3

PBCH_POWER_OFFSET Float EPRE offset for LTE PBCH, NB-IoT NPBCH, or 5G NR PBCH with respect to Nullable: Yes
RS EPRE, NRS EPRE, or SSS EPRE, respectively. Unit: dB. Default: 0
PCI Short Physical cell ID or narrowband physical cell ID. Nullable: Yes
Default: 0

PCI_DOMAIN_NAME Text (50) Name of the PCI or NPCI allocation domain. Nullable: Yes
Default:

PDCCH_POWER_OFFSET Float EPRE offset for LTE PDCCH, NB-IoT NPDCCH, or 5G NR PDCCH with respect Nullable: Yes
to RS EPRE, NRS EPRE, or SSS EPRE, respectively. Unit: dB. Default: 0

PDCCH_SYMBOLS Short Number of OFDM symbols per subframe corresponding to the PDCCH. Nullable: Yes
Default: 1
PDSCH_POWER_OFFSET Float EPRE offset for LTE PDSCH, NB-IoT NPDSCH, or 5G NR PDSCH with respect Nullable: Yes
to RS EPRE, NRS EPRE, or SSS EPRE, respectively. Unit: dB. Default: 0

PMCH_POWER_OFFSET Float EPRE offset for LTE PMCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

PRACH_PREAMBLE_FORMAT Short PRACH or NPRACH preamble format. Nullable: Yes


Default:
PRACH_RSI_DOMAIN_NAME Text (50) Name of the allocation PRACH RSI allocation domain. Nullable: Yes
Default:

PRACH_RSI_REQUIRED Short Number of required PRACH RSIs. Nullable: Yes


Default: 1

PROPAG_MODEL Text (50) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:
PROPAG_MODEL2 Text (50) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

PSS_POWER_OFFSET Float EPRE offset for LTE PSS, NB-IoT NPSS, or 5G NR PSS with respect to RS EPRE, Nullable: Yes
NRS EPRE, or SSS EPRE, respectively. Unit: dB. Default: 3

PUCCH_PRB Float Average number of PRBs corresponding to the PUCCH. Nullable: Yes
Default: 2
RAT Short Radio access technology of the cells of the station template. 0=LTE; 1=NB- Nullable: No
IoT; 2=5G NR. Default: 0

REDT Float Remote electrical tilt of the broadcast antenna. Nullable: Yes
Default: 0

REUSE_DISTANCE Float Minimum reuse distance for resource allocation by the AFP. Nullable: Yes
Default:

180 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

RS_EPRE Float Energy per resource element of LTE RS, NB-IoT NRS, or 5G NR SSS. Nullable: Yes
Default: 20

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0

SCHEDULER Text (30) Scheduler used by the cells of the station template. Nullable: Yes
Default:
SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:

SS_POWER_OFFSET Float EPRE offset for LTE SSS or NB-IoT NSSS with respect to RS EPRE or NRS Nullable: Yes
EPRE, respectively. Unit: dB. Default: 0
SSB_NUMEROLOGY Short SS/PBCH block numerology. 1=0 (15 kHz); 2=1 (30 kHz); 3=2 (60 kHz Normal Nullable: Yes
CP); 4=2 (60 kHz Extended CP); 5=3 (120 kHz); 6=4 (240 kHz). Default: 1

SSB_OFDM_SYMBOLS Short SS/PBCH block OFDM symbols. 0={2,8}+14n [Lmax=4]; 1={2,8}+14n Nullable: Yes
[Lmax=8]; 2={4,8,16,20}+28n [Lmax=4]; 3={4,8,16,20}+28n [Lmax=8]; Default: 0
4={4,8,16,20}+28n [Lmax=64]; 5={8,12,16,20,32,36,40,44}+56n [Lmax=64].

SSB_PERIODICITY Short SS/PBCH block periodicity. 0=5ms; 1=10ms; 2=20ms; 3=40ms; 4=80ms; Nullable: Yes
5=160ms. Default: 0

TDD_SSF_CONFIG Short TDD special subframe configuration. 0; 1; 2; 3; 4; 5; 6; 7; 8; 9. Nullable: No


Default: 1
TILT Float Mechanical downtilt of the broadcast and beamforming antennas. Nullable: Yes
Default: 0

TMA_NAME Text (50) Name of the tower mounted amplifier equipment. Nullable: Yes
Default:

TRAFFIC_NUMEROLOGY Short Traffic numerology. 1=0 (15 kHz); 2=1 (30 kHz); 3=2 (60 kHz Normal CP); 4=2 Nullable: Yes
(60 kHz Extended CP); 5=3 (120 kHz); 6=4 (240 kHz). Default: 1

TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default: 0
TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0

UL_CELL_EDGE_NR Float Uplink noise rise at cell edge. Unit: dB. Nullable: Yes
Default: 0

UL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in uplink. 0=None; 1=Transmit Diversity; Nullable: Yes
2=SU-MIMO; 4=MU-MIMO. Default: 1
UL_EXTERNAL_NOISE_RISE Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
Default: 0

UL_FPC_CINR_MAX Float Uplink C/(I+N) target driven by noise rise limitation of neighbouring cells. Nullable: Yes
Unit: dB. Default: 20

UL_FPC_FACTOR Float Factor enabling reduction of transmission powers of cell-edge users. OFF; 0; Nullable: No
0.4;0.5;0.6;0.7;0.8;0.9;1. Default: 1
UL_FPC_NR_MAX Float Maximum uplink noise rise. Unit: dB. Nullable: Yes
Default: 6

UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes


Default: 100

UL_MAX_LOAD Float Maximum traffic load allowed on uplink. Unit: %. Nullable: Yes
Default: 100
UL_NOISE_RISE Float Uplink noise rise. Unit: dB. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 181


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

5.2.3 xgbearers Table

For bearers.

Field Type Description Attributes

BEARER_INDEX Integer Bearer index. Nullable: No


Default:

BEARER_RANK Short Bearer priority. 1=Lowest. Nullable: Yes


Default: 1

CODING_RATE Float Coding rate. Nullable: Yes


Default: 1
DIRECTION Short Whether the bearer is used in downlink, uplink, or both. Nullable: Yes
Default: 0

EQUIPMENT Text (50) Name of the radio equipment to which the radio bearer belongs. Nullable: No
Default:

MODULATION Short Modulation. 0=BPSK; 1=QPSK; 2=16QAM; 3=64QAM; 4=256QAM. Nullable: Yes
Default: 1
NAME Text (50) Name of the radio bearer. Nullable: No
Default:

SPECTRAL_EFFICIENCY Float Bearer spectral efficiency. Unit: bps/Hz. Nullable: Yes


Default: 0

5.2.4 xgbfmodels Table

For 3D beamforming models.

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the beamforming model. Nullable: Yes
Default:

D_H_ELEMENTS Float Horizontal inter-element spacing in multiples of wavelength. Nullable: No


Default: 0.5
D_V_ELEMENTS Float Vertical inter-element spacing in multiples of wavelength. Nullable: No
Default: 0.5

FMAX Float Highest operating frequency. Unit: MHz. Nullable: Yes


Default:

FMIN Float Lowest operating frequency. Unit: MHz. Nullable: Yes


Default:
N_H_ELEMENTS Short Number of co-polar or cross-polar elements in a row (N). Nullable: No
Default: 4

N_RX_PORTS Short Number of reception ports. Nullable: No


Default: 4

N_TX_PORTS Short Number of transmission ports. Nullable: No


Default: 4
N_V_ELEMENTS Short Number of co-polar or cross-polar elements in a column (M). Nullable: No
Default: 4

NAME Text (50) Name of the beamforming model. Nullable: No


Default:

POLARISATION Short Whether the elements are co-polar or cross-polar. 0=Co-polar; 1=Cross- Nullable: Yes
polar. Default: 0

182 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

5.2.5 xgbfpatterns Table

For 3D beamforming beam patterns.

Field Type Description Attributes

AZIMUT Float Direction of the beam in the horizontal plane. Automatically calculated from Nullable: No
the pattern. Default: 0

BEAM_INDEX Integer Index of the beam. Nullable: No


Default:

BEAM_TYPE Short Whether the beam is used for control channels or traffic channel. 0=Control Nullable: No
and Traffic; 1=Control; 2=Traffic. Default: 0
BF_MODEL Text (50) Name of the beamforming model to which the beam belongs. Nullable: No
Default:

GAIN Float Gain of the beam in boresight. Unit: dB. Nullable: No


Default: 0

N_H_ELEMENTS Short Number of horizontal elements used by the beam (n). Nullable: No
Default: 4
N_V_ELEMENTS Short Number of vertical elements used by the beam (m). Nullable: No
Default: 4

PATTERN Binary 2D or 3D pattern of the beam. Nullable: Yes


Default:

TILT Float Direction of the beam in the vertical plane. Automatically calculated from the Nullable: No
pattern. Default: 0

5.2.6 xgcagroupdefs Table

For the definitions of carrier aggregation groups.

Field Type Description Attributes

CA_GROUP_NAME Text (50) Name of the carrier aggregation group to which the cell belongs. Nullable: No
Default:
MEMBER_CELL_NAME Text (100) Name of carrier aggregation group member cell. Nullable: No
Default:

5.2.7 xgcagroups Table

For carrier aggregation group names and parameters.

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0

LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1
NAME Text (50) Name of the carrier aggregation group. Nullable: No
Default:

© 2018 Forsk. All Rights Reserved. 183


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

5.2.8 xgcarriers Table

For carriers.

Field Type Description Attributes

ARFCN Integer Absolute radio frequency channel number. Nullable: No


Default: 0

DL_FREQUENCY Double Downlink centre frequency of the carrier. Unit: MHz. Nullable: No
Default: 2120

DL_WIDTH Double Total downlink carrier width. Unit: MHz. Nullable: No


Default: 20
DUPLEXING_METHOD Short Duplexing method used by the carrier. 0=FDD; 1=TDD. Nullable: Yes
Default: 0

FBAND Text (50) Name of the frequency band to which the carrier belongs. Nullable: No
Default:

NAME Text (100) Name of the carrier. Nullable: No


Default:
UL_FREQUENCY Double Uplink centre frequency of the carrier. Unit: MHz. Nullable: No
Default: 2120

UL_WIDTH Double Total uplink carrier width. Unit: MHz. Nullable: No


Default: 20

5.2.9 xgcchgains Table

For control channel diversity gains.

Field Type Description Attributes

CHANNEL Text (50) Name of the logical channel to which the diversity gain applies. Nullable: No
Default:

DIV_GAIN Float Diversity gain on the selected channel. Unit: dB. Nullable: Yes
Default: 0
EQUIPMENT Text (50) Name of the radio equipment corresponding to the control channel diversity Nullable: No
gains. Default:

MOBILITY Text (50) Name of the mobility type corresponding to the control channel diversity Nullable: Yes
gains. Default:

N_RX_ANTENNAS Short Number of reception antenna ports. Nullable: Yes


Default: 1
N_TX_ANTENNAS Short Number of transmission antenna ports. Nullable: Yes
Default: 1

5.2.10 xgcells5gnr Table

For 5G NR cells.

184 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True

CARRIER Text (100) Name of the carrier used by the cell. Nullable: No
Default:
CELL_EDGE_MARGIN Float SSS RSRP difference defining the cell-edge area. Unit: dB. Nullable: Yes
Default: 0

CELL_ID Text (100) Name of the cell. Nullable: No


Default:

CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: Yes


Default: 0
CELL_SELECTION_TH Float Inter-layer cell selection threshold. Unit: dB. Nullable: Yes
Default: 0

CELL_TYPE Short Type of cell. 1=PCell; 2=SCell (DL); 4=SCell (UL). Nullable: Yes
Default: 1

CELLSIZE_RSI_MAPPING Text (50) Name of the cell size to PRACH RSI mapping. Nullable: Yes
Default:
CHANNEL_STATUS Short Carrier allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:

DL_BEAM_USAGE Memo Percentage of the downlink traffic load carried by each beam. Unit: Nullable: Yes
Default:
DL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in downlink. 0=None; 1=Transmit Diver- Nullable: Yes
sity; 2=SU-MIMO; 4=MU-MIMO. Default: 1
DL_EXTERNAL_NOISE_RISE Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
Default: 0

DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes


Default: 100

DL_MAX_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default: 100
DL_MU_SM_GAIN Float Average number of co-scheduled MU-MIMO users in downlink. Nullable: Yes
Default: 1

DL_NUM_USERS Float Average number of users connected in downlink. Nullable: Yes


Default: 1

DL_UL_RATIO Float Ratio of the downlink traffic with respect to the total traffic carried by the cell. Nullable: Yes
Default: 50
EQUIPMENT Text (50) Name of the radio equipment associated with the cell. Nullable: Yes
Default:

HO_MARGIN Float Handover margin. Unit: dB. Nullable: Yes


Default: 0

LAYER Short Index of the network layer. Nullable: No


Default:
MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default: 0

MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default: 0

MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes


Default:
MAX_POWER Float Maximum cell transmission power. Nullable: Yes
Default: 43

© 2018 Forsk. All Rights Reserved. 185


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

MIN_SSSRSRP Float Minimum SSS RSRP required for coverage. Nullable: Yes
Default: -140

PBCH_POWER_OFFSET Float EPRE offset for PBCH with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 0

PCI Short Physical cell ID. Nullable: Yes


Default: 0
PCI_DOMAIN_NAME Text (50) Name of the PCI allocation domain. Nullable: Yes
Default:

PDCCH_POWER_OFFSET Float EPRE offset for PDCCH with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 0

PDCCH_SYMBOLS Short Number of OFDM symbols per subframe corresponding to the PDCCH. 0; 1; Nullable: Yes
2; 3; 4. Default: 1
PDSCH_POWER_OFFSET Float EPRE offset for PDSCH with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 0

PRACH_PREAMBLE_FORMAT Short PRACH preamble format. 0=0 [14.531 km]; 1=1 [102.656 km]; 2=2 [22.891 Nullable: Yes
km]; 3=3 [14.531 km]; 4=A1 [1.406 km]; 5=A2 [2.813 km]; 6=A3 [4.219 km]; Default:
7=B1 [1.055 km]; 8=B2 [1.758 km]; 9=B3 [2.461 km]; 10=B4 [4.570 km]; 11=C0
[6.055 km]; 12=C2 [10 km]

PRACH_RB Text (50) List of PRB indexes used for PRACH transmission. Nullable: Yes
Default:
PRACH_RSI_DOMAIN_NAME Text (50) Name of the PRACH RSI allocation domain. Nullable: Yes
Default:

PRACH_RSI_LIST Text (50) List of allocated PRACH RSIs. Nullable: Yes


Default:

PRACH_RSI_REQUIRED Short Number of required PRACH RSIs. Nullable: Yes


Default: 1

PRACH_RSI_STATUS Short PRACH RSI allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default:
PRACH_SUBFRAMES Text (50) List of subframes used for PRACH transmission. Nullable: Yes
Default:

PSS_ID Short PSS ID. Nullable: Yes


Default: 0

PSS_ID_STATUS Short PSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0
PSS_POWER_OFFSET Float EPRE offset for PSS with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 3

REUSE_DISTANCE Float Minimum reuse distance for resource allocation by the AFP. Nullable: Yes
Default:

SCHEDULER Text (30) Scheduler used by the cell. Nullable: Yes


Default:
SSB_NUMEROLOGY Short SS/PBCH block numerology. 1=0 (15 kHz); 2=1 (30 kHz); 3=2 (60 kHz Normal Nullable: No
CP); 4=2 (60 kHz Extended CP); 5=3 (120 kHz); 6=4 (240 kHz). Default: 1

SSB_OFDM_SYMBOLS Short SS/PBCH block OFDM symbols. 0={2,8}+14n [Lmax=4]; 1={2,8}+14n Nullable: No
[Lmax=8]; 2={4,8,16,20}+28n [Lmax=4]; 3={4,8,16,20}+28n [Lmax=8]; Default: 0
4={4,8,16,20}+28n [Lmax=64]; 5={8,12,16,20,32,36,40,44}+56n [Lmax=64].

SSB_PERIODICITY Short SS/PBCH block periodicity. 0=5ms; 1=10ms; 2=20ms; 3=40ms; 4=80ms; Nullable: No
5=160ms. Default: 0

SSS_ID Short SSS ID. Nullable: Yes


Default: 0
SSS_ID_STATUS Short SSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

186 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

SSS_POWER Float SSS EPRE (dBm) Nullable: Yes


Default: 15

TRAFFIC_NUMEROLOGY Short Traffic numerology. 1=0 (15 kHz); 2=1 (30 kHz); 3=2 (60 kHz Normal CP); 4=2 Nullable: No
(60 kHz Extended CP); 5=3 (120 kHz); 6=4 (240 kHz). Default: 1

TX_CELL_ORDER Short Order of the cell within the sector. Nullable: Yes
Default:
TX_ID Text (100) Name of the transmitter to which the cell belongs. Nullable: No
Default:

UL_BEAM_USAGE Memo Percentage of the uplink traffic load carried by each beam. Unit: %. Nullable: Yes
Default:

UL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in uplink. 0=None; 1=Transmit Diversity; Nullable: Yes
2=SU-MIMO; 4=MU-MIMO. Default: 1
UL_EXTERNAL_NOISE_RISE Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
Default: 0

UL_FPC_FACTOR Float Factor enabling reduction of transmission powers of cell-edge users. OFF; 0; Nullable: No
0.4;0.5;0.6;0.7;0.8;0.9;1. Default: 1

UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes


Default: 100
UL_MAX_LOAD Float Maximum traffic load allowed on uplink. Unit: %. Nullable: Yes
Default: 100

UL_MU_SM_GAIN Float Average number of co-scheduled MU-MIMO users in uplink. Nullable: Yes
Default: 1

UL_NOISE_RISE Float Uplink noise rise. Unit: dB. Nullable: Yes


Default: 0

UL_NUM_USERS Float Average number of users connected in uplink. Nullable: Yes


Default: 1
UNIQUE_ID Text (50) Unique cell ID. Nullable: Yes
Default:

5.2.11 xgcellslte Table

For LTE cells.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True

CARRIER Text (100) Name of the carrier used by the cell. Nullable: No
Default:
CELL_EDGE_BOOST Float Ratio of the transmission power of cell-edge PRBs to cell-centre PRBs for Nullable: Yes
Soft FFR and Partial Soft FFR. Unit: dB. Default:

CELL_EDGE_MARGIN Float RSRP difference defining the cell-edge area. Unit: dB. Nullable: Yes
Default: 0

CELL_ID Text (100) Name of the cell. Nullable: No


Default:
CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: Yes
Default: 0

CELL_SELECTION_TH Float Inter-layer cell selection threshold. Unit: dB. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 187


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

CELL_TYPE Short Type of cell. 1=LTE; 2=LTE-A PCell; 4=LTE-A SCell (DL); 8=LTE-A SCell (UL). Nullable: Yes
Default: 1

CELLSIZE_RSI_MAPPING Text (50) Name of the cell size to PRACH RSI mapping. Nullable: Yes
Default:

CHANNEL_STATUS Short Carrier allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0
COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:

CYCLIC_PREFIX Short Cyclic prefix used by the cell. 0=Normal; 1=Extended. Nullable: Yes
Default: 0

DL_BEAM_USAGE Memo Percentage of the downlink traffic load carried by each beam. Unit: %. Nullable: Yes
Default:
DL_CELL_EDGE_TRAFFIC Float Percentage of the downlink traffic correspinding to cell-edge traffic. Unit: %. Nullable: Yes
Default: 0

DL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in downlink. 0=None; 1=Transmit Diver- Nullable: Yes
sity; 2=SU-MIMO; 4=MU-MIMO. Default: 1

DL_EXTERNAL_NOISE_RISE Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
Default: 0
DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes
Default: 100

DL_MAX_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default: 100

DL_MU_SM_GAIN Float Average number of co-scheduled MU-MIMO users in downlink. Nullable: Yes
Default: 1

DL_NUM_USERS Float Average number of users connected in downlink. Nullable: Yes


Default: 1
EQUIPMENT Text (50) Name of the radio equipment associated with the cell. Nullable: Yes
Default:

FRAME_CONFIG Short Frame configuration of the cell. 0=None; 1=FDD; 2=TDD 0 - DSUUUDSUUU; Nullable: Yes
3=TDD 1 - DSUUDDSUUD; 4=TDD 2- DSUDDDSUDD; 5=TDD 3-DSUUUDDDDD; Default:
6=TDD 4-DSUUDDDDDD; 7=TDD 5 - DSUDDDDDDD; 8=TDD 6 - DSUUUDSUUD.

HO_MARGIN Float Handover margin. Unit: dB. Nullable: Yes


Default: 0

ICIC_MODE Short Inter-cell interference coordination mode. 0=TD-FFR; 1=Hard FFR; 2=Soft Nullable: Yes
FFR; 3=Partial Soft FFR. Default: 0
ICIC_PRB_GROUP0 Text (255) List of PRB indexes allocated to ICIC group 0. Nullable: Yes
Default:

ICIC_PRB_GROUP1 Text (255) List of PRB indexes allocated to ICIC group 1. Nullable: Yes
Default:

ICIC_PRB_GROUP2 Text (255) List of PRB indexes allocated to ICIC group 2. Nullable: Yes
Default:
ICIC_SUPPORT Short Inter-cell interference coordination support. 0=None; 1=Static DL; 2=Static Nullable: Yes
UL. Default: 0

LAYER Short Index of the network layer. Nullable: No


Default:

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default: 0
MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default: 0

MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes


Default:

188 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

MAX_POWER Float Maximum cell transmission power. Nullable: Yes


Default: 43

MBSFN_SC_SPACING Short MBSFN subcarrier spacing. 0=15 kHz; 1=7.5 kHz. Nullable: Yes
Default: 0

MIN_RSRP Float Minimum RSRP required for coverage. Nullable: Yes


Default: -140
N_CRS_PORTS Short Number of CRS ports. 1; 2; 4. Nullable: Yes
Default:

PBCH_POWER_OFFSET Float EPRE offset for PBCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

PCI Short Physical cell ID. Nullable: Yes


Default: 0
PCI_DOMAIN_NAME Text (50) Name of the PCI allocation domain. Nullable: Yes
Default:

PDCCH_POWER_OFFSET Float EPRE offset for PDCCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

PDCCH_SYMBOLS Short Number of OFDM symbols per subframe corresponding to the PDCCH. 0; 1; Nullable: Yes
2; 3; 4. Default: 1
PDSCH_POWER_OFFSET Float EPRE offset for PDSCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

PMCH_POWER_OFFSET Float EPRE offset for PMCH with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

PRACH_PREAMBLE_FORMAT Short PRACH preamble format. 0=14.521 km; 1=77.290 km; 2=29.511 km; Nullable: Yes
3=107.269 km; 4=2.811 km. Default:

PRACH_RB Text (50) List of PRB indexes used for PRACH transmission. Nullable: Yes
Default:
PRACH_RSI_DOMAIN_NAME Text (50) Name of the PRACH RSI allocation domain. Nullable: Yes
Default:

PRACH_RSI_LIST Text (50) List of allocated PRACH RSIs. Nullable: Yes


Default:

PRACH_RSI_REQUIRED Short Number of required PRACH RSIs Nullable: Yes


Default: 1
PRACH_RSI_STATUS Short PRACH RSI allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

PRACH_SUBFRAMES Text (50) List of subframe indexes used for PRACH transmission. Nullable: Yes
Default:

PSS_ID Short PSS ID. Nullable: Yes


Default: 0
PSS_ID_STATUS Short PSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

PUCCH_PRB Float Average number of PRBs corresponding to the PUCCH. Nullable: Yes
Default: 2

REUSE_DISTANCE Float Minimum reuse distance for resource allocation by the AFP. Nullable: Yes
Default:
RS_EPRE Float Energy per resource element of reference signals. Nullable: Yes
Default: 20

SCHEDULER Text (30) Scheduler used by the cell. Nullable: Yes


Default:

SS_POWER_OFFSET Float EPRE offset for SS with respect to RS EPRE. Unit: dB. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 189


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

SSS_ID Short SSS ID. Nullable: Yes


Default: 0

SSS_ID_STATUS Short SSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

TDD_SSF_CONFIG Short TDD special subframe configuration. 0; 1; 2; 3; 4; 5; 6; 7; 8; 9. Nullable: No


Default: 1
TX_CELL_ORDER Short Order of the cell within the sector. Nullable: Yes
Default:

TX_ID Text (100) Name of the transmitter to which the cell belongs. Nullable: No
Default:

UL_BEAM_USAGE Memo Percentage of the uplink traffic load carried by each beam. Unit: %. Nullable: Yes
Default:
UL_CELL_EDGE_NR Float Uplink noise rise at cell edge. Unit: dB. Nullable: Yes
Default: 0

UL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in uplink. 0=None; 1=Transmit Diversity; Nullable: Yes
2=SU-MIMO; 4=MU-MIMO; 8=BF. Default: 1

UL_EXTERNAL_NOISE_RISE Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
Default: 0
UL_FPC_CINR_MAX Float Uplink C/(I+N) target driven by noise rise limitation of neighbouring cells. Nullable: Yes
Unit: dB. Default: 20

UL_FPC_FACTOR Float Factor enabling reduction of transmission powers of cell-edge users. OFF; 0; Nullable: No
0.4;0.5;0.6;0.7;0.8;0.9;1. Default: 1

UL_FPC_NR_MAX Float Maximum uplink noise rise. Unit: dB. Nullable: Yes
Default: 6

UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes


Default: 100
UL_MAX_LOAD Float Maximum traffic load allowed on uplink. Unit: %. Nullable: Yes
Default: 100

UL_MU_SM_GAIN Float Average number of co-scheduled MU-MIMO users in uplink. Nullable: Yes
Default: 1

UL_NOISE_RISE Float Uplink noise rise. Unit: dB. Nullable: Yes


Default: 0
UL_NUM_USERS Float Average number of users connected in uplink. Nullable: Yes
Default: 1

UNIQUE_ID Text (50) Unique cell ID. Nullable: Yes


Default:

5.2.12 xgcellsnbiot Table

For NB-IoT cells.

190 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True

AFP_NPCI_STRATEGY Short AFP inband NPCI allocation strategy. 0=None; 1=Same as LTE. Nullable: Yes
Default: 0
CARRIER Text (100) Name of the carrier used by the cell. Nullable: No
Default:

CELL_ID Text (100) Name of the cell. Nullable: No


Default:

CELL_INDIV_OFFSET Float Cell individual offset. Unit: dB. Nullable: Yes


Default: 0
CELL_SELECTION_TH Float Inter-layer cell selection threshold. Unit: dB. Nullable: Yes
Default: 0

CELL_TYPE Short Type of cell. 1=Standard; 2=Multicarrier anchor; 4=Multicarrier slave (DL); Nullable: Yes
8=Multicarrier slave (UL). Default: 1

CHANNEL_STATUS Short Carrier allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0
COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:

DL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in downlink. 0=None; 1=Transmit Diver- Nullable: Yes
sity; 2=SU-MIMO; 4=MU-MIMO. Default: 1

DL_EXTERNAL_NOISE_RISE Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
Default: 0
DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes
Default: 100
DL_MAX_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default: 100

EQUIPMENT Text (50) Name of the radio equipment associated with the cell. Nullable: Yes
Default:

HO_MARGIN Float Handover margin. Unit: dB. Nullable: Yes


Default: 0
LAYER Short Index of the network layer. Nullable: No
Default:

MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes


Default:

MAX_POWER Float Maximum cell transmission power. Nullable: Yes


Default: 43
MIN_NRSRP Float Minimum NRSRP required for coverage. Nullable: Yes
Default: -140

N_NRS_PORTS Short Number of NRS ports. 1;2; 4. Nullable: Yes


Default:

NPBCH_POWER_OFFSET Float EPRE offset for NPBCH with respect to NRS EPRE. Unit: dB. Nullable: Yes
Default: 0
NPCI Short Narrowband physical cell ID. Nullable: Yes
Default: 0

NPCI_DOMAIN_NAME Text (50) Name of the NPCI allocation domain. Nullable: Yes
Default:

NPDCCH_POWER_OFFSET Float EPRE offset for NPDCCH with respect to NRS EPRE. Unit: dB. Nullable: Yes
Default: 0
NPDSCH_POWER_OFFSET Float EPRE offset for NPDSCH with respect to NRS EPRE. Unit: dB. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 191


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

NPRACH_PREAMBLE_FORMA Short NPRACH preamble format. 0=10 km; 1=40 km. Nullable: Yes
T Default:

NPSS_ID Short NPSS ID. Nullable: Yes


Default: 0

NPSS_ID_STATUS Short NPSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0
NRS_EPRE Float Energy per resource element of narrowband reference signals. Nullable: Yes
Default: 20

NSS_POWER_OFFSET Float EPRE offset for NSS with respect to NRS EPRE. Unit: dB. Nullable: Yes
Default: 0

NSSS_ID Short NSSS ID. Nullable: Yes


Default: 0
NSSS_ID_STATUS Short NSSS ID allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

REUSE_DISTANCE Float Minimum reuse distance for resource allocation by the AFP. Nullable: Yes
Default:

TX_CELL_ORDER Short Order of the cell within the sector. Nullable: Yes
Default:
TX_ID Text (100) Name of the transmitter to which the cell belongs. Nullable: No
Default:

UL_DIVERSITY_SUPPORT Short Type of antenna diversity supported in uplink. 0=None; 1=Transmit Diversity; Nullable: Yes
2=SU-MIMO; 4=MU-MIMO. Default: 1

UL_EXTERNAL_NOISE_RISE Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
Default: 0

UL_FPC_CINR_MAX Float Uplink C/(I+N) target driven by noise rise limitation of neighbouring cells. Nullable: Yes
Unit: dB. Default: 20
UL_FPC_FACTOR Float Factor enabling reduction of transmission powers of cell-edge users. OFF; 0; Nullable: No
0.4;0.5;0.6;0.7;0.8;0.9;1. Default: 1

UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes


Default: 100

UL_MAX_LOAD Float Maximum traffic load allowed on uplink. Unit: %. Nullable: Yes
Default: 100
UL_NOISE_RISE Float Uplink noise rise. Unit: dB. Nullable: Yes
Default: 0

UNIQUE_ID Text (50) Unique cell ID. Nullable: Yes


Default:

5.2.13 xgcellsuids Table

For the list of all the cells of all radio access technologies.

Field Type Description Attributes

CELL_ID Text (100) Unique identifier of the cell. Nullable: No


Default:
RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT; 2=5G NR. Nullable: No
Default: 0

192 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

5.2.14 xgcompsetdefs Table

For CoMP set definitions.

Field Type Description Attributes

COMP_SET_NAME Text (50) Name of the CoMP set to which the cell belongs. Nullable: No
Default:

MEMBER_CELL_NAME Text (100) Name of the CoMP set member cell. Nullable: No
Default:

5.2.15 xgcompsets Table

For CoMP set names and parameters.

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0
COLLISION_PROBA_DL Memo Downlink resource unit collision probabilities vs. normalised CoMP set load. Nullable: Yes
Default:

COLLISION_PROBA_UL Memo Uplink resource unit collision probabilities vs. normalised CoMP set load. Nullable: Yes
Default:

DL_COMP_SCHEME Short Downlink CoMP scheme applicable to this CoMP set. Nullable: Yes
Default: 0
LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

NAME Text (50) Name of the CoMP set. Nullable: No


Default:

RX_SET_SIZE Short Maximum number of cells that can be simultaneously coordinated in uplink. Nullable: Yes
Default: 2

TX_SET_SIZE Short Maximum number of cells that can be simultaneously coordinated in down- Nullable: Yes
link. Default: 2
UL_COMP_SCHEME Short Uplink CoMP scheme applicable to this CoMP set. Nullable: Yes
Default: 0

5.2.16 xgequipments Table

For radio equipment.

Field Type Description Attributes

NAME Text (50) Name of the radio equipment. Nullable: No


Default:

5.2.17 xgfreqbands Table

For frequency bands.

© 2018 Forsk. All Rights Reserved. 193


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

NAME Text (50) Name of the frequency band. Nullable: No


Default:

REF_FREQUENCY Double Reference frequency of the band. Used for path loss calculations. Unit: MHz. Nullable: No
Default: 2110

5.2.18 xgiddomains Table

For PCI, NPCI, and PRACH RSI domains.

Field Type Description Attributes


CELL_PARAM Short Cell parameter for which the domain is defined. Nullable: No
Default: 1

DOMAIN_NAME Text (50) Name of the domain. Nullable: No


Default:

5.2.19 xgidgroups Table

For PCI, NPCI, and PRACH RSI groups.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the domain to which the group belongs. Nullable: No
Default:
EXCLUDED Text (255) List of cell parameter values not belonging to the group. Nullable: Yes
Default:

EXTRA Text (255) List of additional cell parameter values belonging to the group. Nullable: Yes
Default:

FIRST Integer First cell parameter value belonging to the group. Nullable: Yes
Default: 0

LAST Integer Last cell parameter value belonging to the group. Nullable: Yes
Default: 0
NAME Text (50) Name of the group. Nullable: No
Default:

STEP Integer Step between the first and last cell parameter values belonging to the group. Nullable: Yes
Default: 1

5.2.20 xgirfs Table

For interference reduction factors.

194 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

ACS Float Adjacent channel selectivity (ACS). Unit: dB. Nullable: Yes
Default: 27

CARRIER_WIDTH Integer Carrier width for which the ACS is defined. Unit: kHz. Nullable: No
Default:
EQUIPMENT Text (50) Radio equipment for which the ACS is defined. Nullable: No
Default:

IRF_INDEX Integer Index of the IRF. Nullable: No


Default:

5.2.21 xglayers Table

For network layers.

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer. Nullable: No


Default:
MAX_SPEED Float Maximum user speed supported by the layer. Unit: km/h. Nullable: Yes
Default: 300

NAME Text (50) Name of the network layer. Nullable: No


Default:

PRIORITY Short Layer priority. 0=Lowest. Nullable: No


Default: 0

5.2.22 xgmuggains Table

For multi-user diversity gains of proportional fair schedulers.

Field Type Description Attributes

BEARER_INDEX Integer Bearer index. Nullable: Yes


Default:
MAX_CINR Float C/(I+N) above which MUG will not be applied. Nullable: No
Default: 16.8

MOBILITY Text (50) Name of the mobility type corresponding to the multi-user diversity gain Nullable: No
graph. Default:

MUG_DL Memo Downlink multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:
MUG_UL Memo Uplink multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:

SCHEDULER_NAME Text (30) Scheduler corresponding to the multi-user diversity gain graph. Nullable: No
Default:

5.2.23 xgneighbours Table

For neighbour relations.

© 2018 Forsk. All Rights Reserved. 195


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
REASON Short Reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adjacent; Nullable: Yes
3=Symmetric; 4=Distance;5=Coverage; 6=Adjacent layer; 7=Handover; Default: 0
8=Existing.

RELATION_TYPE Short Type of the neighbour relation. 0=Intra-carrier; 1=Inter-carrier; 2=Inter-RAT Nullable: Yes
Default: 0

SOURCE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

TRANSMITTER Text (100) Name of the serving cell. Nullable: No


Default:

5.2.24 xgneighconstraints Table

For neighbour allocation constraints.

Field Type Description Attributes


NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the serving cell. Nullable: No


Default:

5.2.25 xgqigraphs Table

For bearer performance graphs.

Field Type Description Attributes

BEARER_INDEX Integer Bearer index. Nullable: No


Default: 0
MOBILITY Text (50) Name of the mobility type corresponding to the bearer quality graphs. Nullable: Yes
Default:

QI_CURVE Memo Quality indicator graph as function of C/I. Nullable: Yes


Default:

QI_NAME Text (50) Name of the quality indicator. Nullable: No


Default:
RX_EQUIP Text (50) Radio equipment corresponding to the quality indicator graph. Nullable: No
Default:

5.2.26 xgrepeaters Table

For repeaters donor-side parameters.

196 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

AMPLIFIER_GAIN Float Repeater amplifier gain. Unit: dB. Nullable: Yes


Default: 80

AZIMUT Float Azimuth of the donor-side antenna. Nullable: Yes


Default: 0
DONOR_CELLID Text (100) Name of the donor transmitter. Nullable: No
Default:

DONOR_LINK_LOSS Float Loss over the donor-repeater link. Unit: dB. Nullable: Yes
Default: 0

DONOR_LINK_TYPE Short Type of the donor-repeater link. 1=Off air; 2=Microwave; 3=Fibre. Nullable: No
Default: 1
DONOR_PROPAG_MODEL Text (50) Name of the propagation model used for the donor-repeater link. Nullable: Yes
Default:

DOWNTILT Float Downtilt of the donor-side antenna. Nullable: Yes


Default: 0

EQUIPMENT_NAME Text (50) Name of the repeater equipment. Passive repeaters do not have equipment Nullable: Yes
(no amplification). Default:
FEEDER_NAME Text (50) Name of the donor-side feeder. Nullable: Yes
Default:

FEEDERLENGTH Float Length of donor-side downlink feeder. Nullable: Yes


Default: 0

HEIGHT Float Height of the donor-side antenna. Nullable: Yes


Default: 25
REC_ANTENNA Text (50) Name of the donor-side antenna model. Nullable: Yes
Default:
REC_FEEDERLENGTH_UL Float Length of donor-side uplink feeder. Nullable: Yes
Default: 0

TOTAL_GAIN Float Total gain of the repeater. Unit: dB. Nullable: Yes
Default: 0

TX_ID Text (100) Name of the repeater. Nullable: No


Default:

5.2.27 xgrepetitions Table

For NB-IoT repetition gains.

Field Type Description Attributes


CONFIGURATION Short NB-IoT deployment configuration. 0=Any; 1=Standalone; 2=Guardband; Nullable: No
3=Inband. Default: 0

COVERAGE_LEVEL Float User-defined minimum coverage level. Unit = dBm. Nullable: No


Default: 0

EQUIPMENT Text (50) Name of the radio equipment Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 197


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

GAIN Memo Graph of gain values vs. bearer index. Nullable: Yes
Default:

MOBILITY Text (50) Name of the mobility type (UE speed). Empty= “All”. Nullable: Yes
Default:

REPETITIONS Integer Number of repetitions required to attain the coverage level. Nullable: Yes
Default: 1
SUBCARRIER_WIDTH Short NB-IoT subcarrier width. 0=Any; 1=3.75 kHz; 2=15 kHz. Nullable: No
Default: 0

5.2.28 xgschedulers Table

For schedulers.

Field Type Description Attributes

BEARER_SELECTION Short Bearer selection criterion. 0=Bearer Index; 1=Peak RLC Throughput; 2=Effec- Nullable: Yes
tive RLC Throughput. Default: 0

NAME Text (30) Name of the scheduler. Nullable: No


Default:
SCHEDULING_METHOD Short Scheduling method. 0=Proportional Fair; 1=Proportional Demand; 3=Max C/ Nullable: Yes
I; 4=Round Robin. Default: 0

TARGET_THROUGHPUT Short Target throughput. 0=Peak RLC Throughput; 1=Effective RLC Throughput; Nullable: Yes
2=Application Throughput. Default: 0

UL_BW_ALLOCATION Short Target for the uplink bandwidth allocation process. 0=Full bandwidth; Nullable: Yes
1=Maintain connection; 2=Best bearer. Default: 2

5.2.29 xgsecondaryantennas Table

For additional antennas.

Field Type Description Attributes

ANTENNA Text (50) Name of the secondary antenna model installed on a transmitter. Nullable: No
Default:
AZIMUT Float Azimuth of the secondary antenna. Nullable: No
Default:

PERCENT_POWER Float Percentage of power dedicated to the secondary antenna. Unit: %. Nullable: No
Default: 0

REDT Float Remote electrical tilt of the secondary antenna. Nullable: Yes
Default: 0
TILT Float Mechanical downtilt of the secondary antenna. Nullable: No
Default:

TX_ID Text (100) Name of the transmitter on which the secondary antenna is installed. Nullable: No
Default:

5.2.30 xgservices Table

For services.

198 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

BODY_LOSS Float Immediate environment loss. Unit: dB. Nullable: No


Default: 0

DL_DP Float Inter-packet arrival time on the downlink. Unit: ms. Nullable: Yes
Not used. Default: 0
DL_DPC Float Reading time between two packet calls on the downlink. Unit: ms. Nullable: Yes
Not used. Default: 0

DL_GBR Float LTE, 5G NR: Downlink guaranteed bit rate. Unit: kbps. Nullable: No
NB-IoT: Not used. Default: 0

DL_MAX_CODINGRATE Float Highest coding rate allowed for the service in downlink. Nullable: Yes
Default: 1
DL_MAX_MODULATION Short Highest modulation allowed for the service in downlink. 0=BPSK; 1=QPSK; Nullable: Yes
2=16QAM; 3=64QAM; 4=256QAM. Default: 2

DL_MBR Float LTE, 5G NR: Downlink maximum bit rate. Unit: kbps. Nullable: No
NB-IoT: Not used. Default: 0

DL_MIN_CODINGRATE Float Lowest coding rate allowed for the service in downlink. Nullable: Yes
Default: 0
DL_MIN_MODULATION Short Lowest modulation allowed for the service in downlink. 0=BPSK; 1=QPSK; Nullable: Yes
2=16QAM; 3=64QAM; 4=256QAM. Default: 1

DL_NPC Integer NB-IoT: Average number of messages per day on the downlink. Nullable: Yes
LTE, 5G NR: Not used. Default: 1

DL_SP Integer NB-IoT: Packet size distribution. 0=Average; 1=Small; 2=Large. Nullable: Yes
LTE, 5G NR: Not used. Default: 0
DL_SPC_MAX Float NB-IoT: Maximum packet size on the downlink. Unit: Bytes. Nullable: Yes
LTE, 5G NR: Not used. Default: 2000
DL_SPC_MIN Float NB-IoT: Minimum packet size on the downlink. Unit: Bytes. Nullable: Yes
LTE, 5G NR: Not used. Default: 200

NAME Text (50) Name of the service. Nullable: No


Default:

OFFSET Float LTE, 5G NR: Fixed overhead for higher layer encapsulation. Unit: kbps. Nullable: No
NB-IoT: Fixed overhead for higher layer encapsulation. Unit: Bytes. Default: 0
PRIORITY Short Service priority. 0=Lowest. Nullable: Yes
Default: 0

QCI Short LTE: QCI (QoS Class Identifier) of the service. 1; 2; 3; 4; 5; 6; 7; 8; 9. Nullable: Yes
Default:

RAT Short Radio access technology for which the service is defined. 0=LTE; 1=NB-IoT; Nullable: No
2=5G NR. Default:
SCALING_FACTOR Float LTE, 5G NR: Useful data rate after higher layer encapsulation. Unit: %. Nullable: No
NB-IoT: Variable overhead for higher layer encapsulation. Unit: %. Default: 95

SERVICE_INDEX Integer Index of the service. Nullable: No


Default:

UL_BANDWIDTH Integer LTE, 5G NR: Minimum number of PRBs required for the service. Nullable: Yes
NB-IoT: Supported subcarrier widths. 1=1 (3.75 kHz); 2=1 (15 kHz); 4=3 (15 Default: 1
kHz); 8=6 (15 kHz); 16=12 (15 kHz).

UL_DP Float Inter-packet arrival time on the uplink. Unit: ms. Nullable: Yes
Not used. Default: 0

UL_DPC Float Reading time between two packet calls in uplink. Unit: ms. Nullable: Yes
Not used. Default: 0
UL_GBR Float LTE, 5G NR: Uplink guaranteed bit rate. Unit: kbps. Nullable: No
NB-IoT: Not used. Default: 0

UL_MAX_CODINGRATE Float Highest coding rate allowed for the service in uplink. Nullable: Yes
Default: 1

© 2018 Forsk. All Rights Reserved. 199


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

UL_MAX_MODULATION Short Highest modulation allowed for the service in uplink. 0=BPSK; 1=QPSK; Nullable: Yes
2=16QAM; 3=64QAM; 4=256QAM. Default: 2

UL_MBR Float LTE, 5G NR: Uplink maximum bit rate. Unit: kbps. Nullable: No
NB-IoT: Not used. Default: 0

UL_MIN_CODINGRATE Float Lowest coding rate allowed for the service in uplink. Nullable: Yes
Default: 0
UL_MIN_MODULATION Short Lowest modulation allowed for the service in uplink. 0=BPSK; 1=QPSK; Nullable: Yes
2=16QAM; 3=64QAM; 4=256QAM. Default: 1

UL_NPC Integer NB-IoT: Average number of messages per day on the uplink. Nullable: Yes
LTE, 5G NR: Not used. Default: 1

UL_SP Integer Packet size on the uplink. Unit: byte. Nullable: Yes
Not used. Default: 1500
UL_SPC_MAX Float NB-IoT: Maximum packet size on the uplink. Unit: Bytes. Nullable: Yes
LTE, 5G NR: Not used. Default: 200

UL_SPC_MIN Float NB-IoT: Minimum packet size on the uplink. Unit: Bytes. Nullable: Yes
LTE, 5G NR: Not used. Default: 20

5.2.31 xgsfnclusterdefs Table

For SFN cluster definitions.

Field Type Description Attributes

MEMBER_CELL_NAME Text (100) Name of SFN cluster member cell. Nullable: No


Default:

SFN_CLUSTER_NAME Text (50) Name of the SFN cluster to which the cell belongs. Nullable: No
Default:

5.2.32 xgsfnclusters Table

For SFN cluster names and parameters.

Field Type Description Attributes

NAME Text (50) Name of the SFN cluster. Nullable: No


Default:

SFN_CLUSTER_ID Short SFN cluster ID. Nullable: No


Default: 0

SFN_COORDINATOR Text (100) Name of the SFN cluster coordinator cell. Nullable: Yes
Default:

5.2.33 xgtchgains Table

For traffic channel MIMO and diversity gains.

200 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

BEARER_INDEX Integer Bearer index. Nullable: Yes


Default: 1

DIV_GAIN Float Traffic channel diversity gain. Unit: dB. Nullable: Yes
Default: 0
EQUIPMENT Text (50) Name of the radio equipment corresponding to the gains. Nullable: No
Default:

MAX_BLER Float Maximum value of BLER for which the gains are applicable. Nullable: Yes
Default: 1

MAX_SUMIMO_GAIN Memo Maximum SU-MIMO gain graphs as function of C/I. Nullable: Yes
Default:
MOBILITY Text (50) Name of the mobility type corresponding to the gains. Nullable: Yes
Default:

MUMIMO_DIV_GAIN Float Traffic channel diversity gain applicable with MU-MIMO. Unit: dB. Nullable: Yes
Default: 0

MUMIMO_GAIN Memo MU-MIMO throughput gain graphs as function of the number of users. Nullable: Yes
Default:
N_RX_ANTENNAS Short Number of reception antenna ports. Nullable: Yes
Default: 1

N_TX_ANTENNAS Short Number of transmission antenna ports. Nullable: Yes


Default: 1

SUMIMO_DIV_GAIN Float Traffic channel diversity gain applicable with SU-MIMO. Unit: dB. Nullable: Yes
Default:

5.2.34 xgterminalbands Table

For frequency bands supported by terminals.

Field Type Description Attributes

CA_SUPPORT Short Carrier aggregation support. 0=No; 1=Yes. Nullable: No


Default: 1
FBAND_NAME Text (50) Name of the frequency band supported by the terminal. Nullable: No
Default:

LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0

NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8
TERMINAL Integer Name of the terminal corresponding to the supported frequency band. Nullable: No
Default:

5.2.35 xgterminals Table

For terminal types.

© 2018 Forsk. All Rights Reserved. 201


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

ANTENNA Text (50) Name of the antenna model of the terminal type. Nullable: Yes
Default:

DIVERSITY_SUPPORT Short Whether the terminal type supports MIMO or not. 0=None; 2=MIMO. Nullable: Yes
Default: 0
EQUIPMENT Text (50) Name of the radio equipment associated with the terminal type. Nullable: No
Default:

GAIN Float Terminal antenna gain. Unit: dB. Nullable: Yes


Default: 0

IC_MODE Short LTE: Further enhanced ICIC support. 0=Deactivated; 1=Activated. Nullable: Yes
Default: 0
LOSS Float Terminal antenna loss. Unit: dB. Nullable: Yes
Default: 0

MULTI_SERVER_SUPPORT Short Whether the terminal type can connect to multiple servers or not. 0=None; Nullable: Yes
1=Downlink CoMP; 2=Uplink CoMP; 4=Downlink CA; 8=Uplink CA. Default: 0

N_RX_ANTENNAS Short Number of reception antenna ports. Nullable: Yes


Default: 1
N_SCELLS_DL Short LTE, 5G NR: Maximum number of SCells in downlink. Nullable: Yes
NB-IoT: Maximum number of slave cells in downlink. Default: 0

N_SCELLS_UL Short LTE, 5G NR: Maximum number of SCells in uplink. Nullable: Yes
NB-IoT: Maximum number of slave cells in uplink. Default: 0

N_TX_ANTENNAS Short Number of transmission antenna ports. Nullable: Yes


Default: 1
NAME Text (50) Name of the terminal. Nullable: No
Default:
NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

PMAX Float Maximum transmission power of the terminal type. Nullable: Yes
Default: 23

PMIN Float Minimum transmission power of the terminal type. Nullable: Yes
Default: -40
RAT Short Radio access technology. 0 = LTE; 1 = NB-IoT; 2 = 5G NR Nullable: No
Default:

TERMINAL_INDEX Integer Index of the terminal type. Nullable: No


Default:

UE_CATEGORY Text (50) UE category of the terminal type. Nullable: Yes


Default:

5.2.36 xgthresholds Table

For bearer selection and various feature activation thresholds.

202 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

BEARER_THRESHOLDS_DL Memo Downlink bearer selection thresholds. Unit: dB. Nullable: Yes
Default:

BEARER_THRESHOLDS_UL Memo Uplink bearer selection thresholds. Unit: dB. Nullable: Yes
Default:
BF_THRESHOLD Float Beamforming activation threshold. Unit: dB. Nullable: Yes
Default:

MOBILITY Text (50) Mobility type corresponding to the bearer selection thresholds. Nullable: Yes
Default:

MUMIMO_THRESHOLD Float MU-MIMO activation threshold. Unit: dB. Nullable: Yes


Default:
RX_EQUIP Text (50) Radio equipment corresponding to the bearer selection thresholds. Nullable: No
Default:

SCELL_THRESHOLD Float SCell and slave cell activation threshold. Unit: dB. Nullable: Yes
Default:

SUMIMO_THRESHOLD Float SU-MIMO activation threshold. Unit: dB. Nullable: Yes


Default:

5.2.37 xgtransmitters Table

For transmitters.

Field Type Description Attributes


ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True

ANTENNA_NAME Text (50) Name of the broadcast antenna pattern used by the transmitter. Nullable: Yes
Default:
AZIMUT Float Mechanical azimuth of the broadcast and beamforming antennas. Nullable: Yes
Default: 0

BF_MODEL Text (50) Name of the beamforming antenna model. Nullable: Yes
Default:

BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes


Default:
CALC_RADIUS Integer Calculation radius of the main path loss matrices.Unit: m. Nullable: Yes
Default: 4000

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices.Unit: m. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Unit: m. Nullable: Yes
Default: 50
CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Unit: m. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DX Float X coordinate relative to the site location. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 203


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

DY Float Y coordinate relative to the site location. Nullable: Yes


Default: 0

FBAND Text (50) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder. Nullable: Yes


Default:
FEEDERLENGTH_DL Float Length of downlink feeder. Unit: m. Nullable: Yes
Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Unit: m. Nullable: Yes


Default: 0

HEIGHT Float Antenna height above the ground. Unit: m. Nullable: Yes
Default: 25
MAX_RANGE Integer Maximum service area coverage range of the transmitter. Nullable: Yes
Default:

MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes


Default: 0

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default: 0
N_RX_ANTENNAS Short Number of reception antenna ports. Nullable: Yes
Default: 1

N_TX_ANTENNAS Short Number of transmission antenna ports. Nullable: Yes


Default: 1

N_TX_PA Short Number of power amplifiers for the transmission antenna ports. Nullable: Yes
Default:

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default: 5
PROPAG_MODEL Text (50) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:

PROPAG_MODEL2 Text (50) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

REDT Float Remote electrical tilt of the broadcast antenna. Nullable: Yes
Default:
RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:
SITE_NAME Text (60) Name of the site on which the transmitter is located. Nullable: No
Default:

TILT Float Mechanical downtilt of the broadcast and beamforming antennas. Nullable: Yes
Default: 0

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

204 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

TX_ID Text (100) Name of the transmitter. Nullable: No


Default:

TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default: 0

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0
USE_ABS_XY Short Whether to use transmitter coordinates relative to site location or absolute Nullable: No
ones. 0=Relative; 1=Absolute. Default: 0

5.2.38 xgtxslists Table

For transmitters belonging to transmitter lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the transmitter list. Nullable: No


Default:

TX_NAME Text (100) Name of the transmitters belonging to the list. Nullable: No
Default:

5.2.39 xgtxslistsnames Table

For names of transmitter lists.

Field Type Description Attributes

NAME Text (50) Name of the transmitter list. Nullable: No


Default:

5.2.40 xguecategories Table

For UE categories.

Field Type Description Attributes

DL_HIGHEST_MODULATION Short Highest supported modulation in downlink. 0=BPSK; 1=QPSK; 2=16QAM; Nullable: Yes
3=64QAM; 4=256QAM. Default: 3

DL_TBS_MAX Float Maximum number of transport block bits per TTI in downlink. Nullable: Yes
Default:

MAX_BANDWIDTH Double Maximum bandwidth supported by the UE category. Unit: MHz. Nullable: Yes
Default:
MAX_RX_ANTENNAS Short Maximum number of reception antenna ports. Nullable: Yes
Default: 1

MAX_TX_ANTENNAS Short Maximum number of transmission antenna ports. Nullable: Yes


Default: 1

© 2018 Forsk. All Rights Reserved. 205


Atoll 3.4.0 Data Structure Reference Guide
Chapter 5: 5G NR LTE Data Structure

Field Type Description Attributes

NAME Text (50) Name of the UE category. Nullable: No


Default:

UE_CAT_FOR_DOWNGRADE Text (50) Name of the UE category for downgrade from LTE R10 to LTE R8. Nullable: Yes
Default:

UL_HIGHEST_MODULATION Short Highest supported modulation in uplink. 0=BPSK; 1=QPSK; 2=16QAM; Nullable: Yes
3=64QAM; 4=256QAM. Default: 3
UL_TBS_MAX Float Maximum number of transport block bits per TTI in uplink. Nullable: Yes
Default:

206 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6 3GPP Multi-RAT Data Structure


3GPP Multi-RAT Atoll documents can contain one, two, or all 3GPP technologies: GSM, UMTS, and LTE. Tables in
the 3GPP Multi-RAT template include the following categories of tables:
 "Tables Common to 3GPP Technologies" on page 207
These tables are shared and used by all the technologies. There structures (fields, keys, and relations with
other tables) are similar to the structures of these tables in single-technology documents.
The multi-RAT traffic model allows you to define services, terminals, and mobility types, user profiles, and
traffic environments for all three technologies. These tables have a multi-level definition: a technology-
independent level and a technology-specific level.
 "GSM-specific Tables" on page 213
 "UMTS-specific Tables" on page 219
 "LTE-specific Tables" on page 224
These tables are specific to technologies. Their structures are the same as in single-technology documents.

 Primary keys are listed in bold and italic characters.

6.1 Tables Common to 3GPP Technologies

6.1.1 Data Structure Changes from Atoll 3.3 to 3.4

6.1.1.1 Added Tables and Fields


feederequipments Table

Field Type Description Attributes

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

Sites Table

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

6.1.1.2 Deleted Tables and Fields


None.

© 2018 Forsk. All Rights Reserved. 207


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.1.2 Data Structure

6.1.2.1 antennas Table


For the table description, see "Antennas Table" on page 130.

6.1.2.2 btsequipments Table


For the table description, see "BTSEquipments Table" on page 130.

6.1.2.3 coordsys Table


For the table description, see "CoordSys Table" on page 131.

6.1.2.4 customfields Table


For the table description, see "CustomFields Table" on page 132.

6.1.2.5 environmentdefs Table


For the table description, see "T4GEnvironmentDefs Table" on page 153.

6.1.2.6 feederequipments Table


For the table description, see "FeederEquipments Table" on page 133.

6.1.2.7 internetchprotect Table


For the table description, see "InterNetChProtect Table" on page 134. This table contains the following additional
field in the 3GPP multi-RAT template:

Field Type Description Attributes

V_TECHNO Text (50) Name of the interfered technology. Nullable: No


Default:

6.1.2.8 mobility Table


Figure 6.1 on page 208, shows the multi-level definition of the multi-RAT mobility types model tables.

Figure 6.1: : 3GPP Mobility Types Model

208 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

MEAN_SPEED Float Average user speed corresponding to the mobility type. Unit: km/h. Nullable: Yes
Default: 0

NAME Text (50) Name of mobility type. Nullable: No


Default:

6.1.2.9 networks Table


The networks table contains one record for each technology in the document. In each record, only parameters
relevant for the row’s technology are used.

Field Type Description Attributes

AAS_CRITERION Short Radio parameter on which AAS activation is based. 0=RS C/N; 1=RS C/(I+N); Nullable: Yes
2=PDSCH C/(I+N). Default: 0

ADD_MRC_SOFTERSOFT Boolean Whether MRC gain should be applied to softer/soft handovers or not. Nullable: No
True=Yes; False=No. Default: False

AMS_SEL_CRITERION Short Radio parameter on which SU-MIMO activation is based. 0=RS C/N; 1=RS C/ Nullable: Yes
(I+N); 2=PDSCH or PUSCH C/(I+N). Default: 0
BS_SELECTION Short Radio parameter on which best server selection is based. 0=RS level; Nullable: Yes
1=RSRP. Default: 1

CELL_SELECTION Short Serving cell selection method. 2=Random; 3=Standard; 4=Traffic balancing. Nullable: Yes
Default: 3

COMPRESSED_DELTA_DL_QU Float Downlink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
AL Default: 1

COMPRESSED_DELTA_UL_QU Float Uplink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
AL Default: 1
COMPRESSED_ON_ECIO Boolean Whether compressed mode is active on Ec/Io threshold or not. True=Yes; Nullable: No
False=No. Default: True

COMPRESSED_ON_RSCP Boolean Whether compressed mode is active on RSCP threshold or not. True=Yes; Nullable: No
False=No. Default: False

COMPRESSED_THRESHOLD Float Ec/Io threshold for compressed mode activation. Unit: dB. Nullable: No
Default: -13
CQI_CPICH_BASED Boolean Whether CQI determination is based on CPICH quality or HS-PDSCH quality. Nullable: No
True=CPICH; False=HS-PDSCH. Default: True

DEFAULT_CP Short Default cyclic prefix. 0=Normal; 1=Extended. Nullable: Yes


Default: 0

DEFAULT_HOGAIN_UL Float Default uplink soft handover gain. Unit: dB. Nullable: No
Default: 0
DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes
Default: "Cost-Hata"

DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No


Default: 50

DMAX Float Maximum radius for a cell. Nullable: No


Default: -1
HSDPA_NTISNTOT Boolean Whether Nt includes the pilot signal for HS-SCCH, HS-PDSCH and CPICH for Nullable: No
CQI determination or not. True=Yes; False=No. Default: False

INTERFERERS_RX_THRESH Float Lowest received interference level. Unit: dB. Nullable: Yes
Default: -20

IOISNTOT Boolean Wether Io includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: True
MIMO_INT_PWR_COMB Short Power combining of interfering signals due to multiple antennas. 0=No; Nullable: Yes
1=Yes. Default: 1

© 2018 Forsk. All Rights Reserved. 209


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

MUMIMO_CRITERION Short Radio parameter on which SU-MIMO activation is based. 0=RS C/N; 1=RS C/ Nullable: Yes
(I+N); 2=PDSCH or PUSCH C/(I+N). Default: 0

NAME Text (50) Name of the network. Nullable: No


Default:

NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False
PDCCH_SYMBOLS Short Number of OFDM symbols per subframe corresponding to the PDCCH. 0; 1; Nullable: No
2; 3; 4. Default: 1

POWER_CONTROL_MARGIN Float Uplink power adjustment margin. Unit: dB. Nullable: Yes
Default: 1

POWERS_RELATIVE_TO_PILO Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
T values or as offsets to the pilot power. True=Relative; False=Absolute. Default: False
PTOT_RELATIVE_TO_PMAX Boolean Whether the total cell power is defined as absolute value or as offset to the Nullable: No
maximum power. True=Relative; False=Absolute. Default: False

PUCCH_AVG_NRB Float Average number of frequency blocks corresponding to the PUCCH. Nullable: No
Default: 2

RS_EPRE_DEFINITION Short RS EPRE calculation method. 0=Calculated (equal distribution); 1=User- Nullable: Yes
defined; 2=Calculated (with boost); 3=Calculated (without boost); 4=Inde- Default: 0
pendent.

RSCP_COMPRESSED_THRES Float RSCP threshold for compressed mode activation. Unit: dB. Nullable: No
HOLD Default: -100
RSCP_MIN Float Minimum received signal code power for coverage. Nullable: Yes
Default: -150

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:

SPREADING_WIDTH Float Spreading width. Unit: MHz. Nullable: Yes


Default: 1.2288
SSF_CONFIG Short TDD: Special subframe configuration. 0; 1; 2; 3; 4; 5; 6; 7; 8. Nullable: Yes
Default: 0

SYSTEM_ Text (50) Name of the system. Nullable: No


Default: ‘LTE’

TECHNOLOGY Text (10) Name of the technology. Nullable: No


Default: ‘OFDM’
THERMAL_NOISE Float Thermal noise. Nullable: Yes
Default: -121

UC_PWC_ON_PILOT Boolean Whether the uplink power control is based on pilot’s target or not. True=Yes; Nullable: No
False=No. Default: False

6.1.2.10 propagationmodels Table


For the table description, see "PropagationModels Table" on page 144.

6.1.2.11 receivers Table


For the table description, see "Receivers Table" on page 39.

210 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.1.2.12 repeaterequipments Table


For the table description, see "RepeaterEquipments Table" on page 145.

6.1.2.13 services Table


Figure 6.2 on page 211, shows the multi-level definition of the multi-RAT services model tables.

Figure 6.2: : 3GPP Services Model

Field Type Description Attributes

DL_ACTIVITY Float Activity factor for voice services on the downlink. Nullable: Yes
Default: 1

NAME Text (50) Name of the service. Nullable: No


Default:
REQ_AVERAGE_DL_RATE Float Average requested throughput on the downlink. Unit: kbps. Nullable: Yes
Default:

REQ_AVERAGE_UL_RATE Float Average requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default:

TECHNO_PRIORITY Text (50) List of supported technologies in the order of priority. Nullable: No
Default:
UL_ACTIVITY Float Activity factor for voice services on the uplink. Nullable: Yes
Default: 1

6.1.2.14 servicesusage Table


For the table description, see "T4GServicesUsage Table" on page 156.

6.1.2.15 sites Table

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:
ALTITUDE Float User-defined site altitude. Nullable: Yes
Default:

CDMA_EQUIPMENT Text (50) CDMA site equipment assigned to the site. Nullable: Yes
Default:

CHANNEL_ELEMENTS_DL Integer Number of available channel elements for downlink. Nullable: No


Default: 256
CHANNEL_ELEMENTS_UL Integer Number of available channel elements for uplink. Nullable: No
Default: 256
COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 211


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0

MAX_IUB_RATE_DL Float Maximum Iub backhaul rate for downlink. Unit: kbps. Nullable: No
Default: 12288
MAX_IUB_RATE_UL Float Maximum Iub backhaul rate for uplink. Unit: kbps. Nullable: No
Default: 12288

MAX_S1_RATE_DL Float Maximum S1 backhaul throughput for downlink. Unit: kbps. Nullable: Yes
Default: 950000

MAX_S1_RATE_UL Float Maximum S1 backhaul throughput for uplink. Unit: kbps. Nullable: Yes
Default: 950000
NAME Text (50) Name of the site. Nullable: No
Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50

SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

6.1.2.16 siteslists Table


For the table description, see "SitesLists Table" on page 147.

6.1.2.17 siteslistsnames Table


For the table description, see "SitesListsNames Table" on page 148.

6.1.2.18 smartantennasmodels Table


For the table description, see "SmartAntennasModels Table" on page 148.

6.1.2.19 terminals Table


Figure 6.3 on page 212, shows the multi-level definition of the multi-RAT terminals model tables.

Figure 6.3: : 3GPP Terminals Model

Field Type Description Attributes

NAME Text (50) Name of the terminal. Nullable: No


Default:

212 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.1.2.20 tmaequipments Table


For the table description, see "TMAEquipments Table" on page 158.

6.1.2.21 trafficenvs Table


For the table description, see "T4GTraficEnvironments Table" on page 157.

6.1.2.22 units Table


For the table description, see "Units Table" on page 53.

6.1.2.23 userprofiles Table


For the table description, see "T4GUserProfiles Table" on page 158.

6.2 GSM-specific Tables

6.2.1 Data Structure Changes from Atoll 3.2 to 3.3

6.2.1.1 Added Tables and Fields


gtransmitters Table

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

gtrgs Table

Field Type Description Attributes

MIN_MAL_LENGTH Integer Minimum MAL (mobile allocation list) length. Nullable: Yes
Default: 2

6.2.1.2 Deleted Tables and Fields


None.

© 2018 Forsk. All Rights Reserved. 213


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.2.2 Data Structure

6.2.2.1 gafpmodels Table


For the table description, see "AfpModels Table" on page 22.

6.2.2.2 gbsicdomains Table


For the table description, see "BSICDomains Table" on page 23.

6.2.2.3 gbsicgroups Table


For the table description, see "BSICGroups Table" on page 23.

6.2.2.4 gcelltypes Table


For the table description, see "CellTypes Table" on page 24.

6.2.2.5 gcodecequipments Table


For the table description, see "CodecEquipments Table" on page 24.

6.2.2.6 gcodecmodeadapts Table


For the table description, see "CodecModeAdaptations Table" on page 24.

6.2.2.7 gcodecmodes Table


For the table description, see "CodecModes Table" on page 25.

6.2.2.8 gcodecqualtables Table


For the table description, see "CodecQualityTables Table" on page 25.

6.2.2.9 gcodingschemes Table


For the table description, see "EGPRSCodingSchemes Table" on page 28.

6.2.2.10 gcsequipments Table


For the table description, see "EGPRSEquipments Table" on page 30.

6.2.2.11 gcsquality Table


For the table description, see "EGPRSQuality Table" on page 30.

214 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.2.2.12 gdimensmodel Table


For the table description, see "EGPRSDimensioningModel Table" on page 29.

6.2.2.13 gfreqdomains Table


For the table description, see "FrequencyDomains Table" on page 35.

6.2.2.14 gfreqgroups Table


For the table description, see "FrequencyGroups Table" on page 35.

6.2.2.15 gfrequencybands Table


For the table description, see "FrequencyBands Table" on page 34.

6.2.2.16 ghsndomains Table


For the table description, see "HSNDomains Table" on page 35.

6.2.2.17 ghsngroups Table


For the table description, see "HSNGroups Table" on page 35.

6.2.2.18 glayers Table


For the table description, see "Layers Table" on page 36.

6.2.2.19 glneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:
TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 215


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.2.2.20 glneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

6.2.2.21 gneighbours Table


For the table description, see "Neighbours Table" on page 36.

6.2.2.22 gneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 37.

6.2.2.23 gneighext Table


For the table description, see "NeighboursExt Table" on page 37.

6.2.2.24 gneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 37.

6.2.2.25 gqualityindicators Table


For the table description, see "QualityIndicators Table" on page 39.

6.2.2.26 grepeaters Table


For the table description, see "Repeaters Table" on page 40.

6.2.2.27 gsecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 41.

6.2.2.28 gseparationrules Table


For the table description, see "SeparationRules Table" on page 41.

6.2.2.29 gseparations Table


For the table description, see "Separations Table" on page 42.

216 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.2.2.30 gservicequality Table


For the table description, see "EGPRSServiceQuality Table" on page 31.

6.2.2.31 gservices Table


For the table description, see "EGPRSServices Table" on page 31. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

6.2.2.32 gterminals Table


For the table description, see "EGPRSTerminals Table" on page 32.

6.2.2.33 gtpltransmitters Table


For the table description, see "TplTransmitters Table" on page 43.

6.2.2.34 gtransmitters Table


For the table description, see "Transmitters Table" on page 45.

6.2.2.35 gtrgconfigs Table


For the table description, see "TRGConfigurations Table" on page 48.

6.2.2.36 gtrgs Table


For the table description, see "TRGs Table" on page 49.

6.2.2.37 gtrxequipments Table


For the table description, see "TRXEquipments Table" on page 51.

6.2.2.38 gtrxs Table


For the table description, see "TRXs Table" on page 51.

6.2.2.39 gtrxtypes Table


For the table description, see "TRXTypes Table" on page 52.

6.2.2.40 gtsconfignames Table


For the table description, see "TSConfigurationNames Table" on page 52.

© 2018 Forsk. All Rights Reserved. 217


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.2.2.41 gtsconfigs Table


For the table description, see "TSConfigurations Table" on page 52.

6.2.2.42 gtxslists Table


For the table description, see "TxsLists Table" on page 53.

6.2.2.43 gtxslistsnames Table


For the table description, see "TxsListsNames Table" on page 53.

6.2.2.44 guneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

6.2.2.45 guneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:
STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

218 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.3 UMTS-specific Tables

6.3.1 Data Structure Changes from 3.3 to 3.4

6.3.1.1 Added Tables and Fields


utransmitters Table

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:
USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

uterminalbands Table

Field Type Description Attributes

LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0

6.3.1.2 Deleted Tables and Fields


None.

6.3.2 Data Structure

6.3.2.1 ucells Table


For the table description, see "CDMACells Table" on page 59.

6.3.2.2 uceuse Table


For the table description, see "CDMAEquipmentsCEsUse Table" on page 62.

6.3.2.3 uequipments Table


For the table description, see "CDMAEquipments Table" on page 61.

6.3.2.4 ufrequencybands Table


For the table description, see "FrequencyBands Table" on page 65.

© 2018 Forsk. All Rights Reserved. 219


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.3.2.5 ugneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

6.3.2.6 ugneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

6.3.2.7 uhsdpabearers Table


For the table description, see "HSDPABearers Table" on page 66.

6.3.2.8 uhsdpabearerselect Table


For the table description, see "HSDPABearerSelectTables Table" on page 66.

6.3.2.9 uhsdpaqualtables Table


For the table description, see "HSDPAQualityTables Table" on page 66.

6.3.2.10 uhspamimoconfigs Table


For the table description, see "HSPAMIMOConfigs Table" on page 67.

6.3.2.11 uhsupabearers Table


For the table description, see "HSUPABearers Table" on page 67.

220 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.3.2.12 uhsupabearerselect Table


For the table description, see "HSUPABearerSelection Table" on page 68.

6.3.2.13 uhsupaqualtables Table


For the table description, see "HSUPAQualityTables Table" on page 68.

6.3.2.14 uhsuparessuse Table


For the table description, see "CdmaEqptsHSUPARssUse Table" on page 61.

6.3.2.15 uhsupauecategories Table


For the table description, see "HSUPAUECategories Table" on page 69.

6.3.2.16 uinterfreducfactors Table


For the table description, see "InterfReductionFactors Table" on page 69.

6.3.2.17 ulayers Table


For the table description, see "ulayers Table" on page 85.

6.3.2.18 ulneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 221


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.3.2.19 ulneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

6.3.2.20 umobility Table


For the table description, see "UMTSMobility Table" on page 86.

6.3.2.21 umugtables Table


For the table description, see "MUGTables Table" on page 70.

6.3.2.22 uneighbours Table


For the table description, see "Neighbours Table" on page 70.

6.3.2.23 uneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 70.

6.3.2.24 uneighext Table


For the table description, see "NeighboursExt Table" on page 71.

6.3.2.25 uneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 71.

6.3.2.26 upscdomains Table


For the table description, see "ScramblingCodesDomains Table" on page 76.

6.3.2.27 upscforbidpairs Table


For the table description, see "Separations Table" on page 77.

6.3.2.28 upscgroups Table


For the table description, see "ScramblingCodesGroups Table" on page 76.

222 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.3.2.29 uqualityindicators Table


For the table description, see "QualityIndicators Table" on page 73.

6.3.2.30 ur99bearers Table


For the table description, see "R99Bearers Table" on page 73.

6.3.2.31 urepeaters Table


For the table description, see "Repeaters Table" on page 75.

6.3.2.32 uschedulers Table


For the table description, see "Schedulers Table" on page 76.

6.3.2.33 usecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 77.

6.3.2.34 uservicequaltables Table


For the table description, see "ServiceQualityTables Table" on page 77.

6.3.2.35 uservices Table


For the table description, see "UMTSServices Table" on page 86. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

6.3.2.36 uservicesquality Table


For the table description, see "UMTSServicesQuality Table" on page 88.

6.3.2.37 uterminals Table


For the table description, see "UMTSTerminals Table" on page 89.

6.3.2.38 uterminalbands Table


For the table description, see "uterminalbands Table" on page 91.

6.3.2.39 utpltransmitters Table


For the table description, see "TplTransmitters Table" on page 79.

© 2018 Forsk. All Rights Reserved. 223


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.3.2.40 utransmitters Table


For the table description, see "Transmitters Table" on page 82.

6.3.2.41 utxslists Table


For the table description, see "TxsLists Table" on page 84.

6.3.2.42 utxslistsnames Table


For the table description, see "TxsListsNames Table" on page 85.

6.3.2.43 uuecategories Table


For the table description, see "UECategories Table" on page 85.

6.3.2.44 uuerxequipments Table


For the table description, see "UERxEquipments Table" on page 86.

6.4 LTE-specific Tables

6.4.1 Data Structure Changes from 3.3 to 3.4

6.4.1.1 Added Tables and Fields


lcagroups Table

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0
LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

lcompsets Table

Field Type Description Attributes


AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0

LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

224 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

lframeconfigs Table

Field Type Description Attributes

PRACH_RB Text (50) Comma-separated list of resource blocks numbers used for PRACH trans- Nullable: Yes
mission Default:
PRACH_SUBFRAMES Text (50) Comma-separated list of subframe numbers used for PRACH transmission Nullable: Yes
Default:

lrepetitions Table (New)

Field Type Description Attributes

CONFIGURATION Short NB-IoT deployment configuration. 0=Any; 1=Standalone; 2=Guardband; Nullable: No


3=Inband. Default: 0

COVERAGE_LEVEL Float User-defined minimum coverage level. Unit = dBm. Nullable: No


Default: 0

EQUIPMENT Text (50) Name of the reception equipment. Nullable: No


Default:
GAIN Memo Graph of gain values vs. bearer index. Nullable: Yes
Default:

MOBILITY Text (50) Name of the mobility type (UE speed). Empty= “All”. Nullable: Yes
Default:

REPETITIONS Integer Number of repetitions required to attain the coverage level. Nullable: Yes
Default: 1
SUBCARRIER_WIDTH Short NB-IoT subcarrier width. 0=Any; 1=3.75 kHz; 2=15 kHz. Nullable: No
Default: 0

lterminalbands Table

Field Type Description Attributes

CA_SUPPORT Short Whether the terminal supports carrier aggregation using the frequency band. Nullable: No
0=No; 1=Yes. Default: 1
LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0

lbearersrequiredci Table

Field Type Description Attributes


BEARERS_REQUIRED_COVERI Memo Uplink bearer selection thresholds. Nullable: Yes
_UL Default:

lcells Table

Field Type Description Attributes

AFP_NPCI_STRATEGY Short AFP inband NPCI allocation strategy. 0=None; 1=Identical as LTE. Nullable: Yes
Default: 0

CELLSIZE_RSI_MAPPING Text (50) Name of the cell size to PRACH RSI mapping. Nullable: Yes
Default:

RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT. Nullable: No
Default: 0

lmimoconfigs Table

Field Type Description Attributes

MUMIMO_GAIN Memo Graphs of MU-MIMO gains vs. the number of MU-MIMO users. Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 225


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

ltpltransmitters Table

Field Type Description Attributes

N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes


Default:
RAT Short Radio access technology of the station template. 0=LTE; 1=NB-IoT. Nullable: No
Default:

ltransmitters Table

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:
N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

6.4.1.2 Deleted Tables and Fields


None.

6.4.2 Data Structure

6.4.2.1 lbearerqualitycurves Table


For the table description, see "T4GBearerQualityCurves Table" on page 149.

6.4.2.2 lbearers Table


For the table description, see "T4GBearers Table" on page 149.

6.4.2.3 lbearersrequiredci Table


For the table description, see "T4GBearersRequiredCI Table" on page 149.

6.4.2.4 lcagroupdefs Table


For the table description, see "lcagroupdefs Table" on page 135.

6.4.2.5 lcagroups Table


For the table description, see "lcagroups Table" on page 135.

226 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.4.2.6 lcells Table


For the table description, see "T4GCells Table" on page 150.

6.4.2.7 lcchdivgains Table


For the table description, see "lcchdivgains Table" on page 135.

6.4.2.8 lcompsetdefs Table


For the table description, see "lcompsetdefs Table" on page 136.

6.4.2.9 lcompsets Table


For the table description, see "lcompsets Table" on page 136.

6.4.2.10 lequipments Table


For the table description, see "T4GEquipments Table" on page 153.

6.4.2.11 lframeconfigs Table


For the table description, see "lframeconfigs Table" on page 137.

6.4.2.12 lfrequencybands Table


For the table description, see "FrequencyBands Table" on page 134.

6.4.2.13 lgneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:
TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 227


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.4.2.14 lgneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

6.4.2.15 llayers Table


For the table description, see "llayers Table" on page 137.

6.4.2.16 lmbsfnareadefs Table


For the table description, see "lmbsfnareadefs Table" on page 138.

6.4.2.17 lmbsfnareas Table


For the table description, see "lmbsfnareas Table" on page 138.

6.4.2.18 lmimoconfigs Table


For the table description, see "T4GMimoConfigs Table" on page 153.

6.4.2.19 lmugtables Table


For the table description, see "MUGTables Table" on page 141.

6.4.2.20 lneighbours Table


For the table description, see "Neighbours Table" on page 141.

6.4.2.21 lneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 142.

6.4.2.22 lneighext Table


For the table description, see "NeighboursExt Table" on page 142.

6.4.2.23 lneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 142.

228 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.4.2.24 lpcidomains Table


For the table description, see "lpcidomains Table" on page 138.

6.4.2.25 lpcigroups Table


For the table description, see "lpcigroups Table" on page 138.

6.4.2.26 lprachdomains Table


For the table description, see "lprachdomains Table" on page 139.

6.4.2.27 lprachgroups Table


For the table description, see "lprachgroups Table" on page 139.

6.4.2.28 lqualityindicators Table


For the table description, see "QualityIndicators Table" on page 144.

6.4.2.29 lrelaylinks Table


For the table description, see "lrelayLinks Table" on page 139.

6.4.2.30 lrepetitions Table


For the table description, see "lrepetitions Table" on page 140.

6.4.2.31 lrepeaters Table


For the table description, see "Repeaters Table" on page 145.

6.4.2.32 lschedulers Table


For the table description, see "Schedulers Table" on page 146.

6.4.2.33 lsecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 146.

6.4.2.34 lservices Table


For the table description, see "T4GServices Table" on page 154. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

© 2018 Forsk. All Rights Reserved. 229


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

6.4.2.35 lsmartantennas Table


For the table description, see "SmartAntennas Table" on page 148.

6.4.2.36 lterminalbands Table


For the table description, see "lterminalbands Table" on page 140.

6.4.2.37 lterminals Table


For the table description, see "T4GTerminals Table" on page 156.

6.4.2.38 ltpltransmitters Table


For the table description, see "TplTransmitters Table" on page 158.

6.4.2.39 ltransmitters Table


For the table description, see "Transmitters Table" on page 162.

6.4.2.40 ltxslists Table


For the table description, see "TxsLists Table" on page 164.

6.4.2.41 ltxslistsnames Table


For the table description, see "TxsListsNames Table" on page 164.

6.4.2.42 luecategories Table


For the table description, see "T4GUECategories Table" on page 157.

6.4.2.43 luneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

230 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 6: 3GPP Multi-RAT Data Structure

6.4.2.44 luneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


 Default:

© 2018 Forsk. All Rights Reserved. 231


Atoll 3.4.0 Data Structure Reference Guide
Chapter 6: 3GPP Multi-RAT Data Structure

232 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

7 3GPP2 Multi-RAT Data Structure


3GPP2 Multi-RAT Atoll documents can contain one or both 3GPP2 technologies: CDMA2000 and LTE. Tables in the
3GPP2 Multi-RAT template include the following categories of tables:
 "Tables Common to 3GPP2 Technologies" on page 233
These tables are shared and used by all the technologies. There structures (fields, keys, and relations with
other tables) are similar to the structures of these tables in single-technology documents.
The multi-RAT traffic model allows you to define services, terminals, and mobility types, user profiles, and
traffic environments for all three technologies. These tables have a multi-level definition: a technology-
independent level and a technology-specific level.
 "CDMA2000-specific Tables" on page 239
 "LTE-specific Tables" on page 243
These tables are specific to technologies. There structures are the same as in single-technology documents.

 Primary keys are listed in bold and italic characters.

7.1 Tables Common to 3GPP2 Technologies

7.1.1 Data Structure Changes from Atoll 3.3 to 3.4

7.1.1.1 Added Tables and Fields


feederequipments Table

Field Type Description Attributes


LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes
Default:

Sites Table

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

© 2018 Forsk. All Rights Reserved. 233


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

7.1.1.2 Deleted Tables and Fields


networks Table
 SP_PERIODICITY

7.1.2 Data Structure

7.1.2.1 antennas Table


For the table description, see "Antennas Table" on page 130.

7.1.2.2 btsequipments Table


For the table description, see "BTSEquipments Table" on page 130.

7.1.2.3 coordsys Table


For the table description, see "CoordSys Table" on page 131.

7.1.2.4 customfields Table


For the table description, see "CustomFields Table" on page 132.

7.1.2.5 environmentdefs Table


For the table description, see "T4GEnvironmentDefs Table" on page 153.

7.1.2.6 feederequipments Table


For the table description, see "FeederEquipments Table" on page 133.

7.1.2.7 internetchprotect Table


For the table description, see "InterNetChProtect Table" on page 134. This table contains the following additional
field in the 3GPP2 multi-RAT template:

Field Type Description Attributes

V_TECHNO Text (50) Name of the interfered technology. Nullable: No


Default:

7.1.2.8 mobility Table


Figure 7.1 on page 235, shows the multi-level definition of the multi-RAT mobility types model tables.

234 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

Figure 7.1: : 3GPP2 Mobility Types Model

Field Type Description Attributes

NAME Text (50) Name of mobility type Null column allowed: No


Default value:

MEAN_SPEED Float Average speed (km/h) Null column allowed: No


Default value:

7.1.2.9 networks Table


The networks table contains one record for each technology in the document. In each record, only parameters
relevant for the row’s technology are used.

Field Type Description Attributes

AAS_CRITERION Short Radio parameter on which AAS activation is based. 0=RS C/N; 1=RS C/(I+N); Nullable: Yes
2=PDSCH C/(I+N). Default: 0
ADD_MRC_SOFTERSOFT Boolean Whether MRC gain should be applied to softer/soft handovers or not. Nullable: No
True=Yes; False=No. Default: False

AMS_SEL_CRITERION Short Radio parameter on which SU-MIMO activation is based. 0=RS C/N; 1=RS C/ Nullable: Yes
(I+N); 2=PDSCH or PUSCH C/(I+N). Default: 0

BS_SELECTION Short Radio parameter on which best server selection is based. 0=RS level; Nullable: Yes
1=RSRP. Default: 1
CELL_SELECTION Short Serving cell selection method. 2=Random; 3=Standard; 4=Traffic balancing. Nullable: Yes
Default: 3

DEFAULT_CP Short Default cyclic prefix. 0=Normal; 1=Extended. Nullable: Yes


Default: 0

DEFAULT_HOGAIN_UL Float Default uplink soft handover gain. Unit: dB. Nullable: No
Default: 0
DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes
Default: "Cost-Hata"

DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No


Default: 50

DMAX Float Maximum radius for a cell. Nullable: No


Default: -1
INTERFERERS_RX_THRESH Float Lowest received interference level. Unit: dB. Nullable: Yes
Default: -20

IOISNTOT Boolean Wether Io includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: True

MIMO_INT_PWR_COMB Short Power combining of interfering signals due to multiple antennas. 0=No; Nullable: Yes
1=Yes. Default: 1
MUMIMO_CRITERION Short Radio parameter on which SU-MIMO activation is based. 0=RS C/N; 1=RS C/ Nullable: Yes
(I+N); 2=PDSCH or PUSCH C/(I+N). Default: 0

NAME Text (50) Name of the network. Nullable: No


Default:

NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False

© 2018 Forsk. All Rights Reserved. 235


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

Field Type Description Attributes

PDCCH_SYMBOLS Short Number of OFDM symbols per subframe corresponding to the PDCCH. 0; 1; Nullable: No
2; 3; 4. Default: 1

POWER_CONTROL_MARGIN Float Uplink power adjustment margin. Unit: dB. Nullable: Yes
Default: 1

POWERS_RELATIVE_TO_PILO Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
T values or as offsets to the pilot power. True=Relative; False=Absolute. Default: False
PTOT_RELATIVE_TO_PMAX Boolean Whether the total cell power is defined as absolute value or as offset to the Nullable: No
maximum power. True=Relative; False=Absolute. Default: False

PUCCH_AVG_NRB Float Average number of frequency blocks corresponding to the PUCCH. Nullable: No
Default: 2

RS_EPRE_DEFINITION Short RS EPRE calculation method. 0=Calculated (equal distribution); 1=User- Nullable: Yes
defined; 2=Calculated (with boost); 3=Calculated (without boost); 4=Inde- Default: 0
pendent.

RSCP_MIN Float Minimum received signal code power for coverage. Nullable: Yes
Default: -150
SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:

SPREADING_WIDTH Float Spreading width. Unit: MHz. Nullable: Yes


Default: 1.2288
SSF_CONFIG Short TDD: Special subframe configuration. 0; 1; 2; 3; 4; 5; 6; 7; 8. Nullable: Yes
Default: 0

SYSTEM_ Text (50) Name of the system. Nullable: No


Default: ‘LTE’

TECHNOLOGY Text (10) Name of the technology. Nullable: No


Default: ‘OFDM’

THERMAL_NOISE Float Thermal noise. Nullable: Yes


Default: -121
UC_PWC_ON_PILOT Boolean Whether the uplink power control is based on pilot’s target or not. True=Yes; Nullable: No
False=No. Default: False

7.1.2.10 propagationmodels Table


For the table description, see "PropagationModels Table" on page 144.

7.1.2.11 receivers Table


For receiver parameters.

Field Type Description Attributes

ADJ_CHANNEL_PROT Float Adjacent channel interference reduction (ACIR = 1/(1/ACS + 1/ACLR)). Unit: Nullable: No
dB. Default: 18

ANTENNA Text (50) Antenna model of the default receiver. If not defined, an isotropic receiver is Nullable: Yes
used. Default:

HEIGHT Float Height of the default receiver. Nullable: No


Default: 1.5
LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0

NAME Text (50) Name of the default receiver. Nullable: No


Default:

236 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

7.1.2.12 repeaterequipments Table


For the table description, see "RepeaterEquipments Table" on page 145.

7.1.2.13 services Table


Figure 7.2 on page 237, shows the multi-level definition of the multi-RAT services model tables.

Figure 7.2: : 3GPP2 Services Model

Field Type Description Attributes

DL_ACTIVITY Float Activity factor for voice services on the downlink. Nullable: Yes
Default: 1

NAME Text (50) Name of the service. Nullable: No


Default:
REQ_AVERAGE_DL_RATE Float Average requested throughput on the downlink. Unit: kbps. Nullable: Yes
Default:

REQ_AVERAGE_UL_RATE Float Average requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default:

TECHNO_PRIORITY Text (50) List of supported technologies in the order of priority. Nullable: No
Default:
UL_ACTIVITY Float Activity factor for voice services on the uplink. Nullable: Yes
Default: 1

7.1.2.14 servicesusage Table


For the table description, see "T4GServicesUsage Table" on page 156.

7.1.2.15 sites Table

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:
ALTITUDE Float User-defined site altitude. Nullable: Yes
Default:

CDMA_EQUIPMENT Text (50) CDMA site equipment assigned to the site. Nullable: Yes
Default:

CHANNEL_ELEMENTS_DL Integer Number of available channel elements for downlink. Nullable: No


Default: 256
CHANNEL_ELEMENTS_UL Integer Number of available channel elements for uplink. Nullable: No
Default: 256

COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

EVDO_CES Integer Number of EVDO channel elements per carrier. Nullable: Yes
Default: 96

© 2018 Forsk. All Rights Reserved. 237


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

Field Type Description Attributes

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0

MAX_S1_RATE_DL Float Maximum S1 backhaul throughput for downlink. Unit: kbps. Nullable: Yes
Default: 950000
MAX_S1_RATE_UL Float Maximum S1 backhaul throughput for uplink. Unit: kbps. Nullable: Yes
Default: 950000

NAME Text (50) Name of the site. Nullable: No


Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50
SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

7.1.2.16 siteslists Table


For the table description, see "SitesLists Table" on page 147.

7.1.2.17 siteslistsnames Table


For the table description, see "SitesListsNames Table" on page 148.

7.1.2.18 smartantennasmodels Table


For the table description, see "SmartAntennasModels Table" on page 148.

7.1.2.19 terminals Table


Figure 7.3 on page 238, shows the multi-level definition of the multi-RAT terminals model tables.

Figure 7.3: : 3GPP2 Terminals Model

Field Type Description Attributes

NAME Text (50) Name of the terminal. Nullable: No


Default:

7.1.2.20 tmaequipments Table


For the table description, see "TMAEquipments Table" on page 158.

238 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

7.1.2.21 trafficenvs Table


For the table description, see "T4GTraficEnvironments Table" on page 157.

7.1.2.22 units Table


For the table description, see "Units Table" on page 164.

7.1.2.23 userprofiles Table


For the table description, see "T4GUserProfiles Table" on page 158.

7.2 CDMA2000-specific Tables

7.2.1 Data Structure Changes from 3.3 to 3.4

7.2.1.1 Added Tables and Fields


ctransmitters Table

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:
USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

7.2.1.2 Deleted Tables and Fields


None.

7.2.2 Data Structure

7.2.2.1 ccarrierstype Table


For the table description, see "CarriersType Table" on page 97.

7.2.2.2 ccells Table


For the table description, see "CDMACells Table" on page 97.

© 2018 Forsk. All Rights Reserved. 239


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

7.2.2.3 cceuse Table


For the table description, see "CDMAEquipmentsCEsUse Table" on page 99.

7.2.2.4 cdlbearerselect Table


For the table description, see "DLBearersSelection Table" on page 102.

7.2.2.5 cdldorabearers Table


For the table description, see "DLDORABearers Table" on page 102.

7.2.2.6 cdorabearers Table


For the table description, see "DORABearers Table" on page 103.

7.2.2.7 cdorabearersproba Table


For the table description, see "DORABearersProba Table" on page 103.

7.2.2.8 cdoratermt2pratios Table


For the table description, see "DORATerminalT2PRatios Table" on page 103.

7.2.2.9 cequipments Table


For the table description, see "CDMAEquipments Table" on page 99.

7.2.2.10 cfrequencybands Table


For the table description, see "FrequencyBands Table" on page 104.

7.2.2.11 cinterfreducfactors Table


For the table description, see "InterfReductionFactors Table" on page 104.

7.2.2.12 clneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

240 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

Field Type Description Attributes

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:

REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

7.2.2.13 clneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

7.2.2.14 cmobility Table


For the table description, see "UMTSMobility Table" on page 118.

7.2.2.15 cneighbours Table


For the table description, see "Neighbours Table" on page 105.

7.2.2.16 cneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 105.

7.2.2.17 cneighext Table


For the table description, see "NeighboursExt Table" on page 106.

7.2.2.18 cneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 105.

7.2.2.19 cpnodomains Table


For the table description, see "PnCodesDomains Table" on page 107.

© 2018 Forsk. All Rights Reserved. 241


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

7.2.2.20 cpnoforbidpairs Table


For the table description, see "Separations Table" on page 110.

7.2.2.21 cpnogroups Table


For the table description, see "PnCodesGroups Table" on page 107.

7.2.2.22 cqualityindicators Table


For the table description, see "QualityIndicators Table" on page 108.

7.2.2.23 crepeaters Table


For the table description, see "Repeaters Table" on page 109.

7.2.2.24 csecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 110.

7.2.2.25 cservicequaltables Table


For the table description, see "ServiceQualityTables Table" on page 111.

7.2.2.26 cservices Table


For the table description, see "UMTSServices Table" on page 119.

7.2.2.27 cservicesquality Table


For the table description, see "UMTSServicesQuality Table" on page 120.

7.2.2.28 cterminals Table


For the table description, see "UMTSTerminals Table" on page 121.

7.2.2.29 ctpltransmitters Table


For the table description, see "TplTransmitters Table" on page 112.

7.2.2.30 ctransmitters Table


For the table description, see "Transmitters Table" on page 115.

7.2.2.31 ctxslists Table


For the table description, see "TxsLists Table" on page 117.

242 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

7.2.2.32 ctxslistsnames Table


For the table description, see "TxsListsNames Table" on page 117.

7.2.2.33 cuerxequipments Table


For the table description, see "UERxEquipments Table" on page 117.

7.2.2.34 culbearerselect Table


For the table description, see "ULBearersSelection Table" on page 118.

7.3 LTE-specific Tables

7.3.1 Data Structure Changes from 3.3 to 3.4

7.3.1.1 Added Tables and Fields


lcagroups Table

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0

LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

lcompsets Table

Field Type Description Attributes

AGGREGATION_SET Short Aggregation set. 0=All Servers; 1=Secondary/Coordinated/Slave Cells Only. Nullable: No
Default: 0
LOAD_BAL_CRITERION Short Load balancing criterion. 0=Cell Capacities; 1=Cell Capacities and Bearer Nullable: No
Efficiencies. Default: 1

lframeconfigs Table

Field Type Description Attributes


PRACH_RB Text (50) Comma-separated list of resource blocks numbers used for PRACH trans- Nullable: Yes
mission Default:

PRACH_SUBFRAMES Text (50) Comma-separated list of subframe numbers used for PRACH transmission Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 243


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

lrepetitions Table (New)

Field Type Description Attributes

CONFIGURATION Short NB-IoT deployment configuration. 0=Any; 1=Standalone; 2=Guardband; Nullable: No


3=Inband. Default: 0
COVERAGE_LEVEL Float User-defined minimum coverage level. Unit = dBm. Nullable: No
Default: 0

EQUIPMENT Text (50) Name of the reception equipment. Nullable: No


Default:

GAIN Memo Graph of gain values vs. bearer index. Nullable: Yes
Default:
MOBILITY Text (50) Name of the mobility type (UE speed). Empty= “All”. Nullable: Yes
Default:

REPETITIONS Integer Number of repetitions required to attain the coverage level. Nullable: Yes
Default: 1

SUBCARRIER_WIDTH Short NB-IoT subcarrier width. 0=Any; 1=3.75 kHz; 2=15 kHz. Nullable: No
Default: 0

lterminalbands Table

Field Type Description Attributes

CA_SUPPORT Short Whether the terminal supports carrier aggregation using the frequency band. Nullable: No
0=No; 1=Yes. Default: 1
LOSSES Float Terminal loss per frequency band. Unit: dB. Nullable: No
Default: 0

lbearersrequiredci Table

Field Type Description Attributes

BEARERS_REQUIRED_COVERI Memo Uplink bearer selection thresholds. Nullable: Yes


_UL Default:

lcells Table

Field Type Description Attributes

AFP_NPCI_STRATEGY Short AFP inband NPCI allocation strategy. 0=None; 1=Identical as LTE. Nullable: Yes
Default: 0
CELLSIZE_RSI_MAPPING Text (50) Name of the cell size to PRACH RSI mapping. Nullable: Yes
Default:

RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT. Nullable: No
Default: 0

lmimoconfigs Table

Field Type Description Attributes

MUMIMO_GAIN Memo Graphs of MU-MIMO gains vs. the number of MU-MIMO users. Nullable: Yes
Default:

ltpltransmitters Table

Field Type Description Attributes

N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes


Default:

RAT Short Radio access technology of the station template. 0=LTE; 1=NB-IoT. Nullable: No
Default:

244 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

ltransmitters Table

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:
ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:

N_TX_PA Short Number of downlink power amplifiers. Nullable: Yes


Default:
USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

7.3.1.2 Deleted Tables and Fields


None.

7.3.2 Data Structure

7.3.2.1 lbearerqualitycurves Table


For the table description, see "T4GBearerQualityCurves Table" on page 149.

7.3.2.2 lbearers Table


For the table description, see "T4GBearers Table" on page 149.

7.3.2.3 lbearersrequiredci Table


For the table description, see "T4GBearersRequiredCI Table" on page 149.

7.3.2.4 lcagroupdefs Table


For the table description, see "lcagroupdefs Table" on page 135.

7.3.2.5 lcagroups Table


For the table description, see "lcagroups Table" on page 135.

7.3.2.6 lcells Table


For the table description, see "T4GCells Table" on page 150.

© 2018 Forsk. All Rights Reserved. 245


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

7.3.2.7 lcchdivgains Table


For the table description, see "lcchdivgains Table" on page 135.

7.3.2.8 lcneighbours Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (50) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

7.3.2.9 lcneighconstraints Table

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (50) Name of the neighbour cell. Nullable: No


Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0
TRANSMITTER Text (50) Name of the source cell. Nullable: No
Default:

7.3.2.10 lcompsetdefs Table


For the table description, see "lcompsetdefs Table" on page 136.

7.3.2.11 lcompsets Table


For the table description, see "lcompsets Table" on page 136.

7.3.2.12 lequipments Table


For the table description, see "T4GEquipments Table" on page 153.

7.3.2.13 lframeconfigs Table


For the table description, see "lframeconfigs Table" on page 137.

246 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

7.3.2.14 lfrequencybands Table


For the table description, see "FrequencyBands Table" on page 134.

7.3.2.15 llayers Table


For the table description, see "llayers Table" on page 137.

7.3.2.16 lmbsfnareadefs Table


For the table description, see "lmbsfnareadefs Table" on page 138.

7.3.2.17 lmbsfnareas Table


For the table description, see "lmbsfnareas Table" on page 138.

7.3.2.18 lmimoconfigs Table


For the table description, see "T4GMimoConfigs Table" on page 153.

7.3.2.19 lmugtables Table


For the table description, see "MUGTables Table" on page 141.

7.3.2.20 lneighbours Table


For the table description, see "Neighbours Table" on page 141.

7.3.2.21 lneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 142.

7.3.2.22 lneighext Table


For the table description, see "NeighboursExt Table" on page 142.

7.3.2.23 lneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 142.

7.3.2.24 lpcidomains Table


For the table description, see "lpcidomains Table" on page 138.

7.3.2.25 lpcigroups Table


For the table description, see "lpcigroups Table" on page 138.

© 2018 Forsk. All Rights Reserved. 247


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

7.3.2.26 lprachdomains Table


For the table description, see "lprachdomains Table" on page 139.

7.3.2.27 lprachgroups Table


For the table description, see "lprachgroups Table" on page 139.

7.3.2.28 lqualityindicators Table


For the table description, see "QualityIndicators Table" on page 144.

7.3.2.29 lrelaylinks Table


For the table description, see "lrelayLinks Table" on page 139.

7.3.2.30 lrepetitions Table


For the table description, see "lrepetitions Table" on page 140.

7.3.2.31 lrepeaters Table


For the table description, see "Repeaters Table" on page 145.

7.3.2.32 lschedulers Table


For the table description, see "Schedulers Table" on page 146.

7.3.2.33 lsecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 146.

7.3.2.34 lservices Table


For the table description, see "T4GServices Table" on page 154. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

7.3.2.35 lsmartantennas Table


For the table description, see "SmartAntennas Table" on page 148.

7.3.2.36 lterminalbands Table


For the table description, see "lterminalbands Table" on page 140.

248 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 7: 3GPP2 Multi-RAT Data Structure

7.3.2.37 lterminals Table


For the table description, see "T4GTerminals Table" on page 156.

7.3.2.38 ltpltransmitters Table


For the table description, see "TplTransmitters Table" on page 158.

7.3.2.39 ltransmitters Table


For the table description, see "Transmitters Table" on page 162.

7.3.2.40 ltxslists Table


For the table description, see "TxsLists Table" on page 164.

7.3.2.41 ltxslistsnames Table


For the table description, see "TxsListsNames Table" on page 164.

7.3.2.42 luecategories Table


For the table description, see "T4GUECategories Table" on page 157.

© 2018 Forsk. All Rights Reserved. 249


Atoll 3.4.0 Data Structure Reference Guide
Chapter 7: 3GPP2 Multi-RAT Data Structure

250 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

8 TD-SCDMA Data Structure


Atoll supports integrated network planning for TD-SCDMA networks. This section describes the TD-SCDMA data
structure used in Atoll. It lists all the tables and fields found in the TD-SCDMA template and the relationships
between them.

 Primary keys are listed in bold and italic characters.

8.1 Data Structure Changes from Atoll 3.3 to 3.4

8.1.1 Added Tables and Fields

FeederEquipments Table

Field Type Description Attributes

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

Sites Table

Field Type Description Attributes


ALIAS_ Text (60) Site alias. Nullable: Yes
Default:

Transmitters Table

Field Type Description Attributes


ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

8.1.2 Deleted Tables and Fields

None.

© 2018 Forsk. All Rights Reserved. 251


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

8.2 Data Structure

8.2.1 Antennas Table

For antennas.

Field Type Description Attributes

BEAMWIDTH Float The half-power beamwidth of the antenna model. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the antenna model. Nullable: Yes
Default:

CONSTRUCTOR Text (50) Name of the antenna manufacturer. Nullable: Yes


Default:

DIAGRAM Binary Antenna horizontal and vertical patterns. Nullable: Yes


Default:
ELECTRICAL_AZIMUTH Float The electrical azimuth of the antenna model. Nullable: Yes
Default:

ELECTRICAL_TILT Float The electrical tilt of the antenna model. Nullable: Yes
Default:

FMAX Double Maximum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:
FMIN Double Minimum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:

GAIN Float Antenna model gain compared to an isotropic radiator. Unit: dBi. Nullable: No
Default: 0

NAME Text (50) Name of the antenna model. Nullable: No


Default:

PHYSICAL_ANTENNA Text (50) Name of the physical antenna to which the antenna model belongs. Nullable: Yes
Default:

 The format of the binary field, DIAGRAM, is described in "RF 2D Antenna Pattern
Format" on page 355.

8.2.2 AntennasLists Table

For antennas belonging to antenna lists.

Field Type Description Attributes

ANTENNA_NAME Text (50) Names of the antenna models belonging to the list. Nullable: No
Default:
LIST_NAME Text (50) Name of the antenna list. Nullable: No
Default:

252 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

8.2.3 AntennasListsNames Table

For names of antenna lists.

Field Type Description Attributes

NAME Text (50) Name of the antenna list. Nullable: No


Default:

8.2.4 BTSEquipments Table

For NodeB equipment.

Field Type Description Attributes

CONFIG_DL_LOSSES Float Downlink losses due to transmitter components (duplexer, combiner, etc.). Nullable: Yes
Unit: dB. Default: 0

CONFIG_UL_LOSSES Float Uplink losses due to transmitter components (duplexer, combiner, etc.). Unit: Nullable: Yes
dB. Default: 0
NAME Text (50) Name of transmitter equipment. Nullable: No
Default:

NOISE_FIGURE Float Noise figure of transmitter equipment. Unit: dB. Nullable: Yes
Default: 0

RHO_FACTOR Short CDMA rho factor for self interference (not used in other technologies). Nullable: Yes
Default: 100

8.2.5 CDMACells Table

For cells.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True
CARRIER Integer Carrier number. Nullable: Yes
Default: 0

CARRIER_TYPE Short Type of carrier. 0=Standalone; 1=Master; 2=Slave. Nullable: Yes


Default: 0

CELL_ID Text (100) Name of the cell. Nullable: No


Default:
CELL_IDENTITY Integer Cell identity. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:

DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default: 0
DWPCH_POWER Float Power on the DwPTS timeslot. Nullable: Yes
Default: 36

DYN_EDCH_DL_POWER_ALLO Boolean E-DCH power allocation mode. True=Dynamic; False=Static. Nullable: No


C Default: False

DYN_HS_SCCH_POWER_ALL Boolean HS-SCCH power allocation mode. True=Dynamic; False=Static. Nullable: No


OC Default: True

© 2018 Forsk. All Rights Reserved. 253


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

DYN_HS_SICH_POWER_ALLO Boolean HS-SICH power allocation mode. True=Dynamic; False=Static. Nullable: No


C Default: True

DYN_HSDPA_POWER_ALLOC Boolean HSDPA power allocation mode. True=Dynamic; False=Static. Nullable: No


Default: True

EDCH_DL_POWER Float E-DCH transmission power. Equals maximum available power in dynamic Nullable: Yes
allocation. Default:
HS_SCCH_POWER Float HS-SCCH transmission power. Equals maximum available power in dynamic Nullable: Yes
allocation. Default:

HSDPA_MAX_CODES Short Maximum number of HS-PDSCH codes. Nullable: Yes


Default: 16

HSDPA_MAX_USERS Short Maximum number of simultaneous HSDPA users. Nullable: Yes


Default: 64
HSDPA_MIN_CODES Short Minimum number of HS-PDSCH codes. Nullable: Yes
Default: 0

HSDPA_PWR Float HSDPA transmission power. Nullable: Yes


Default:

HSDPA_SCHEDULER_ALGO Short Scheduling algorithm used for HSDPA users. 0=MAX C/I; 1=Round Robin; Nullable: Yes
2=Proportional Fair. Default: 2
HSPA_SUPPORT Short Supported HSPA features. 0=None; 1=HSDPA; 2=HSPA. Nullable: No
Default: 0

HSUPA_MAX_USERS Integer Maximum number of simultaneous HSUPA users. Nullable: Yes


Default: 15

LOCKED_SC Boolean Scrambling code allocation status. True=Locked; False=Modifiable. Nullable: No


Default: False

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:
MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default:

MAX_R99BEARER_DL_RATE Float Maximum downlink R99 throughput. Unit: kbps. Nullable: Yes
Default: 1000

MAX_R99BEARER_UL_RATE Float Maximum uplink R99 throughput. Unit: kbps. Nullable: Yes
Default: 1000
NUM_HS_SCCH Short Number of HS-SCCH channels. Nullable: Yes
Default: 5

NUM_HS_SICH Short Number of HS-SICH channels. Nullable: Yes


Default: 5

NUM_HSDPA_USERS Integer Number of served HSDPA users. Nullable: Yes


Default:
NUM_HSUPA_USERS Integer Number of served HSUPA users. Nullable: Yes
Default:

OTHERS_CCH_POWER Float Transmission power of other common channels for TS0 (S-CCPCH, FPACH, Nullable: Yes
PICH). Default: 0

PILOT_POWER Float Power of the pilot channel. Nullable: Yes


Default: 33
POWER_MAX Float Cell's maximum transmission power. Nullable: Yes
Default: 43

PWR_HEADROOM Float Power control headroom for DCH. Unit: dB. Nullable: Yes
Default: 0

REQ_DL_RUS Short Required number of resource units in downlink. Nullable: Yes


Default: 0

254 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

REQ_UL_RUS Short Required number of resource units in uplink. Nullable: Yes


Default: 0

REUSE_DIST Float Minimum reuse distance for scrambling codes. Nullable: Yes
Default:

RSCP_COMP Float P-CCPCH RSCP margin to trigger baton handover. Unit: dB. Nullable: Yes
Default: 5
RSCP_MIN Float Minimum received signal code power. Nullable: Yes
Default: -150

SC_DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: Yes
Default:

SCRAMBLING_CODE Integer Scrambling code. Nullable: Yes


Default:
TS_CONFIG Integer Timeslot configuration. 1=UDDDDD; 2=UUDDDD; 3=UUUDDD; 4=UUUUDD; Nullable: Yes
5=UUUUUD; 6=UpUDDDD; 7=UpUUDDD. Default: 3

TX_CELL_ORDER Short Order of the cell within a transmitter. Nullable: Yes


Default:

TX_ID Text (100) Name of the transmitter to which the cell belongs. Nullable: No
Default:
UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default: 0

8.2.6 CDMACellsTS Table

For timeslots.

Field Type Description Attributes


BLOCKED Boolean Whether a timeslot is blocked or not. True=Yes; False=No. Nullable: No
Default: False

CELL_ID Text (100) Name of the cell. Nullable: No


Default:

DL_ANGULAR_POWERS Binary Angular distribution of downlink transmitted powers. Nullable: Yes


Default:
HSDPA_MAX_CODES Short Maximum number of HS-PDSCH codes Nullable: Yes
Default:

HSDPA_MIN_CODES Short Minimum number of HS-PDSCH codes Nullable: Yes


Default:

HSDPA_PWR Float HSDPA transmission power. Nullable: Yes


Default:
HSUPA_UL_LOAD Float Uplink load factor due to HSUPA users. Nullable: Yes
Default:

MAX_DL_LOAD Float Maximum allowed downlink load. Unit: %. Nullable: Yes


Default: 75

MAX_UL_LOAD Float Maximum allowed uplink load. Unit: %. Nullable: Yes


Default: 50
OTHERS_CCH_POWER Float Transmission power of other common channels. Nullable: Yes
Default: -200

RU_OVERHEAD Short Overhead due to signalling channels. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 255


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

TIME_SLOT Short Time slot number. Nullable: No


Default:

TIME_SLOT_TYPE Short Timeslot type. 0=R99; 1=HSDPA; 2=R99 + HSDPA; 3=HSUPA; 4=R99 + Nullable: No
HSUPA; 5=HSPA; 6=R99 + HSPA. Default: 0

TOTAL_POWER Float Total downlink transmission power. Nullable: Yes


Default:
UL_LOAD Float Uplink load factor. Unit: %. Nullable: Yes
Default:

UL_REUSE_FACTOR Float Uplink (I intra + I extra)/ I intra. Unit: dB. Nullable: Yes
Default:

8.2.7 CDMAEquipments Table

For site equipment.

Field Type Description Attributes

MANUFACTURER Text (50) Name of the site equipment manufacturer. Nullable: Yes
Default:
MCJD_FACTOR Float Multi-cell joint detection factor for extra-cell uplink interference cancellation. Nullable: No
Default: 0

MUD_FACTOR Float MUD factor for uplink interference cancellation. Nullable: No


Default: 0

NAME Text (50) Name of the site equipment. Nullable: No


Default:

8.2.8 CDMAEquipmentsCEsUse Table

For channel elements consumption in site equipment.

Field Type Description Attributes

CHANNEL_ELTS_DL Integer Number of channel elements used for downlink. Nullable: No


Default: 1
CHANNEL_ELTS_UL Integer Number of channel elements used for uplink. Nullable: No
Default: 1

EQUIPMENT Text (50) Name of the site equipment. Nullable: No


Default:

SERVICE Text (50) Name of the R99 radio bearer. Nullable: No


Default:

8.2.9 CodesRelativityClusters Table

For scrambling code clusters.

256 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

CODES_LIST Text (255) List of codes belonging to the cluster. Nullable: No


Default:

NAME Text (50) Name of the cluster of scrambling codes. Nullable: No


Default:

8.2.10 CoordSys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

Field Type Description Attributes


CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default: 0

DATUM_CODE Double Identification code of the datum. Nullable: Yes


Default: 0

DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0
DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes
Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0
DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes
Default: 0
DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes
Default: 0

DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes


Default: 0

ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No


Default: 0
ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes
Default: 0

ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes


Default: 0

GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:
PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes


Default: 0

PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes


Default: 0
PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 257


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0
PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes


Default: 0

8.2.11 CustomFields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:
CHOICE_LIST Memo Choice list for text fields. Nullable: Yes
Default:

CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default: 0

COLUMN_NAME Text (50) Name of the custom field. Nullable: No


Default:

DEFAULT_VALUE Text (50) Default value for the field. Nullable: Yes
Default:
DISPLAY_TYPE Integer Whether the field is modifiable or read-only. 0=Modifiable; 1=Read-only. Nullable: Yes
Default: 0

GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:

TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.
 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.
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


 Table and field names are case sensitive.

258 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any 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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the
appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

8.2.12 FeederEquipments Table

For feeders.

Field Type Description Attributes

CONNECTOR_LOSSES_DL Float Feeder connector losses in downlink. Unit: dB. Nullable: Yes
Default: 0

CONNECTOR_LOSSES_UL Float Feeder connector losses in uplink. Unit: dB. Nullable: Yes
Default: 0
LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes
Default:

LOSS_PER_METER Float Feeder loss per meter. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the feeder. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 259


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

8.2.13 FrequencyBands Table

For frequency bands.

Field Type Description Attributes

BAND_WIDTH Double Carrier width. Unit: MHz. Nullable: Yes


Default: 1.6

FIRST_CARRIER Integer First carrier number in the frequency band. Nullable: Yes
Default: 0

FREQUENCY Double Downlink start frequency of the first carrier of the frequency band. Unit: MHz. Nullable: Yes
Default: 2010
LAST_CARRIER Integer Last carrier number in the frequency band. Nullable: Yes
Default: 0

NAME Text (50) Name of the frequency band. Nullable: No


Default:

8.2.14 HSDPABearers Table

For HSDPA bearers.

Field Type Description Attributes

BEARER_INDEX Short HSDPA bearer index. Nullable: No


Default: 1
HSPDSCH_NUM Short Number of HS-PDSCH channels used by the HSDPA bearer. Nullable: Yes
Default: 5

MODULATION Short Modulation used by the HSDPA bearer. 0=QPSK; 1=16QAM. Nullable: No
Default: 0

RLC_PEAK_THROUGHPUT Float Peak RLC throughput of the bearer. Unit: kbps. Nullable: Yes
Default: 0

TRANSPORT_BL_SIZE Integer Transport block size. Unit: bits. Nullable: Yes


Default: 0
TS_NUM Short Number of timeslots per subframe. Nullable: Yes
Default: 1

UE_CATEGORY Short HSDPA UE category corresponding to the HSDPA bearer. Nullable: Yes
Default: 1

8.2.15 HSDPABearerSelectTables Table

For HSDPA bearer selection graphs.

Field Type Description Attributes

BEARER_INDEX Short HSDPA bearer index. Nullable: Yes


Default: 0
HSPDSCH_ECNT_REQ Float Target HS-SCCH Ec/Nt for HSDPA. Unit: dB. Nullable: Yes
Default: 5

MOBILITY Text (50) Mobility type corresponding to the HSDPA bearer selection thresholds. Nullable: Yes
Default:

RX_EQUIP Text (50) Reception equipment corresponding to the HSDPA bearer selection thresh- Nullable: Yes
olds. Default: “Standard”

260 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

8.2.16 HSUPABearers

For HSUPA bearers.

Field Type Description Attributes

BEARER_INDEX Short HSUPA bearer index. Nullable: No


Default:

EPUCH_NUM Short Number of used E-PUCH codes. Nullable: Yes


Default:

MODULATION Short Modulation used by the HSUPA bearer. 0=QPSK; 1=16QAM. Nullable: No
Default: 0
RLC_PEAK_THROUGHPUT Float Peak RLC throughput of the bearer. Unit: kbps. Nullable: Yes
Default:

TRANSPORT_BL_SIZE Integer Transport block size. Unit: bits. Nullable: Yes


Default:

TS_NUM Short Number of timeslots per subframe. Nullable: Yes


Default: 1
UE_CATEGORY Short HSUPA UE category corresponding to the HSUPA bearer. Nullable: Yes
Default: 1

8.2.17 HSUPABearerSelection

For HSUPA bearer selection graphs.

Field Type Description Attributes

BEARER_INDEX Short HSUPA bearer index. Nullable: Yes


Default: 0

EARLY_TERM_TABLE Memo Early termination probability graphs as a function of the number of repeti- Nullable: Yes
tions. Default:

EPUCH_ECNT_REQ Float Required E-PUCH Ec/Nt. Unit: dB. Nullable: Yes


Default:
MAX_NUM_REP Integer Number of retransmissions to ensure error-free reception. Nullable: Yes
Default: 1

MOBILITY Text (50) Mobility type corresponding to the HSUPA bearer selection thresholds. Nullable: Yes
Default:

RX_EQUIP Text (50) Reception equipment corresponding to the HSUPA bearer selection thresh- Nullable: Yes
olds. Default:
UL_CRT_MARGIN Float Uplink control margin for E-PUCH. Unit: dB. Nullable: Yes
Default:

8.2.18 HSUPAUECategories

For HSUPA UE categories.

© 2018 Forsk. All Rights Reserved. 261


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

MAX_BLOCK_SIZE Integer Maximum transport block size. Nullable: Yes


Default:

MAX_EPUCH_CODES Short Maximum number of E-DPDCH codes for HSUPA. Nullable: Yes
Default:
MAX_EPUCH_TS Integer Smallest supported spreading factor. Nullable: Yes
Default:

MODULATION Short Highest modulation used by the HSUPA UE category. 0=QPSK; 1=16QAM. Nullable: No
Default: 0

UE_CATEGORY Short HSUPA UE category. Nullable: No


Default:
UE_CATEGORY_NAME Text (50) Name of the HSUPA UE category. Nullable: Yes
Default:

8.2.19 InterfReductionFactors Table

For interference reduction factors between carriers.

Field Type Description Attributes

CARRIER1 Integer Number of the first carrier in the inter-carrier IRF relation. Nullable: No
Default: 0

CARRIER2 Integer Number of the second carrier in the inter-carrier IRF relation. Nullable: No
Default: 0
FACTOR Double Interference reduction factor between two carrier numbers. Unit: dB. Nullable: No
Default: 200

8.2.20 InterNetChProtect Table

For inter-network interference reduction factor graphs.

Field Type Description Attributes

ICP Memo Inter-RAT interference reduction graph as a function of frequency difference Nullable: Yes
between channels. Default:

ITF_BW Double Channel width of the interferer cell. Unit: kHz. Nullable: No
Default: 0

ITF_TECHNO Text (50) Technology of the interfering cell. Nullable: No


Default:
V_BW Double Channel width of the interfered cell. Unit: kHz. Nullable: No
Default: 0

8.2.21 Neighbours Table

For intra-technology neighbour relations.

262 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

8.2.22 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

8.2.23 NeighboursConstraintsExt Table

For inter-technology neighbour allocation constraints.

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:
NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No
Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

8.2.24 NeighboursExt Table

For inter-technology neighbour relations.

© 2018 Forsk. All Rights Reserved. 263


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

8.2.25 Networks Table

For network-level parameters.

Field Type Description Attributes

DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes


Default: ‘Cost-Hata’
DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No
Default: 50

DMAX Float Maximum radius for a cell. Nullable: No


Default: -1

DWPTS_CHIPS_NUMBER Integer Number of chips of the DwPTS (TS dedicated to the pilot). Nullable: Yes
Default: 96

EBNT_QUALITY_TARGET Boolean Type of quality target. True=Eb/Nt; False=C/I. Nullable: No


Default: True
FRAME_TIME Short Duration of a frame. Unit: ms. Nullable: Yes
Default: 10

GUARD_PERIOD_CHIPS_NUM Float Number of chips in guard period. Nullable: Yes


BER Default: 16

HSDPA_NTISNTOT Boolean Whether Nt includes the pilot signal for HS-SCCH, HS-PDSCH and CPICH for Nullable: No
CQI determination or not. True=Yes; False=No. Default: False
INTERFERERS_RX_THRESH Float Lowest received interference level. Nullable: Yes
Default: -130

MIDAMBLE_CHIPS_NUMBER Float Number of chips in midamble. Nullable: Yes


Default: 144

NAME Text (50) Name of the network. Nullable: No


Default:
NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False

PILOT_PROCESSING_GAIN Float P-CCPCH processing gain. Unit: dB. Nullable: Yes


Default: 13.8

POWERS_RELATIVE_TO_PILO Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
T values or as offsets to the pilot power. True=Relative; False=Absolute. Default:
PTS_GUARD_PERIOD_CHIPS_ Integer Number of chips in the PTS guard period. Nullable: Yes
NUMBER Default: 96

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

264 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:

SPREADING_FACTOR_MAX Integer Maximum spreading factor. Nullable: Yes


Default: 16

SPREADING_FACTOR_MIN Integer Minimum spreading factor. Nullable: Yes


Default: 1
SPREADING_WIDTH Float Spreading width. Unit: MHz. Nullable: Yes
Default: 1.28

SUBFRAME_TIME Short Duration of a subframe. Unit: ms. Nullable: Yes


Default: 5

SYSTEM_ Text (50) Name of the system. Nullable: No


Default: ‘TD-SCDMA’
TECHNOLOGY Text (10) Name of the technology. Nullable: No
Default: ‘CDMA’

TS_DATA_CHIPS_NUMBER Float Number of data chips in a timeslot. Nullable: Yes


Default: 704

TS_NUMBER Integer Number of timeslots per subframe. Nullable: Yes


Default: 7
UPPTS_CHIPS_NUMBER Integer Number of chips in the UpPTS (uplink pilot timeslot). Nullable: Yes
Default: 160

8.2.26 PropagationModels Table

For propagation models.

Field Type Description Attributes


DATA Binary Propagation model parameter settings. Nullable: Yes
Default:

DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:

NAME Text (50) Name of the propagation model. Nullable: No


Default:
SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

TYPE Text (50) ProgID of the model. Nullable: No


Default:

8.2.27 QualityIndicators Table

For quality indicators (BER, BLER, etc.).

© 2018 Forsk. All Rights Reserved. 265


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

CS_QI Boolean Whether the quality indicator is used for circuit-switched services or not. Nullable: No
True=Yes; False=No. Default: True

MEAS_PARAM Short Measurement on which the quality indicator is based. 1=CPICH Ec/Io; Nullable: Yes
2=CPICH Ec/Nt; 3=DCH Eb/Nt; 4=HS-PDSCH Ec/Nt; 5=E-DPDCH Ec/Nt. Default: 1
NAME Text (20) Name of the quality indicator. Nullable: No
Default:

PS_QI Boolean Whether the quality indicator is used for packet-switched services or not. Nullable: No
True=Yes; False=No. Default: True

USE_INTERPOLATION Boolean Whether interpolation can be used for the quality indicator graph to find val- Nullable: No
ues between defined ones. True=Yes; False=No. Default: True

8.2.28 R99Bearers Table

For release 99 bearers.

Field Type Description Attributes

DL_NOMINAL_BIT_RATE Float Downlink nominal throughput of the R99 bearer. Unit: kbps. Nullable: Yes
Default: 9.6

DL_PG Float Downlink processing gain. Unit: dB. Nullable: Yes


Default: 0

NAME Text (50) Name of the R99 bearer. Nullable: No


Default:
PTCH_MAX Float Maximum allowed traffic channel power. Nullable: Yes
Default: 21

PTCH_MIN Float Minimum allowed traffic channel power. Nullable: Yes


Default: -20

TS_DL Short Number of downlink timeslots. Nullable: Yes


Default: 1

TS_UL Short Number of uplink timeslots. Nullable: Yes


Default: 1
TYPE Short Type of the R99 bearer. 0=None; 1=Interactive; 2=Conversational; 3=Back- Nullable: Yes
ground; 4=Streaming. Default: 0

UL_NOMINAL_BIT_RATE Float Uplink nominal throughput of the R99 bearer. Unit: kbps. Nullable: Yes
Default: 9.6

UL_PG Float Uplink processing gain. Unit: dB. Nullable: Yes


Default: 0

8.2.29 Receivers Table

For receiver parameters.

266 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

ADJ_CHANNEL_PROT Float Adjacent channel interference reduction (ACIR = 1/(1/ACS + 1/ACLR)). Unit: Nullable: No
dB. Default: 18

ANTENNA Text (50) Antenna model of the default receiver. If not defined, an isotropic receiver is Nullable: Yes
used. Default:
HEIGHT Float Height of the default receiver. Nullable: No
Default: 1.5

LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0

NAME Text (50) Name of the default receiver. Nullable: No


Default:

8.2.30 RepeaterEquipments Table

For repeater equipment.

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the repeater equipment. Nullable: Yes
Default:

MANUFACTURER Text (50) Name of the repeater equipment manufacturer. Nullable: Yes
Default:

MAX_AMPLIFIER_GAIN Float Maximum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 90
MAX_OUTPUT_DL Float Maximum downlink output power. Nullable: Yes
Default: 30

MAX_OUTPUT_UL Float Maximum uplink output power. Nullable: Yes


Default: 12

MIN_AMPLIFIER_GAIN Float Minimum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 50

NAME Text (50) Name of the repeater equipment. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the repeater equipment. Unit: dB. Nullable: Yes
Default: 5

STEP_AMPLIFIER_GAIN Float Step of amplifier gain. Unit: dB. Nullable: Yes


Default: 1

TIME_DELAY Float Processing delay of the repeater equipment. Unit: us. Nullable: Yes
Default: 5

8.2.31 Repeaters Table

For repeaters.

© 2018 Forsk. All Rights Reserved. 267


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

AMPLIFIER_GAIN Float Repeater amplifier gain. Unit: dB. Nullable: Yes


Default: 80

AZIMUT Float Azimuth of the donor side antenna. Nullable: Yes


Default: 0
DONOR_CELLID Text (100) Name of the donor transmitter. Nullable: No
Default:

DONOR_LINK_LOSS Float Loss over the donor-repeater link. Unit: dB. Nullable: Yes
Default: 0

DONOR_LINK_TYPE Short Type of the donor-repeater link. 1=Off air; 2=Microwave; 3=Fibre. Nullable: No
Default: 1
DONOR_PROPAG_MODEL Text (50) Name of the propagation model used for the donor-repeater link. Nullable: Yes
Default:

DOWNTILT Float Downtilt of the donor side antenna. Nullable: Yes


Default: 0

EQUIPMENT_NAME Text (50) Name of the repeater equipment. Passive repeaters do not have equipment Nullable: Yes
(no amplification). Default:
FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:

FEEDERLENGTH Float Length of donor side downlink feeder. Nullable: Yes


Default: 0

HEIGHT Float Height of the donor side antenna. Nullable: Yes


Default: 25
REC_ANTENNA Text (50) Name of the donor side antenna model. Nullable: Yes
Default:
REC_FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes
Default: 0

TOTAL_GAIN Float Total gain of the repeater. Unit: dB. Nullable: Yes
Default: 0

TX_ID Text (100) Name of the repeater. Nullable: No


Default:

 Repeater properties are saved in two tables: the donor-side parameters are in the
Repeaters table and the coverage-side parameters in the Transmitters table.

8.2.32 SACIGainCDF Table

For CDF graphs of smart antenna C/I gains.

Field Type Description Attributes

ANGULAR_SPREAD Short Value of the average angular spread. Unit: dB. Nullable: Yes
Default: 5
CIGAIN_CDF Memo CDF of C/I gain values. Nullable: Yes
Default:

SA_NAME Text (50) Name of the Smart antenna Nullable: No


Default:

268 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

8.2.33 ScramblingCodesDomains Table

For names of scrambling code domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: No


Default:

8.2.34 ScramblingCodesGroups Table

For scrambling code groups belonging to scrambling code domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: No


Default:

EXCLUDED Text (225) List of scrambling codes not belonging to the group. Nullable: Yes
Default:
EXTRA Text (225) List of additional scrambling codes belonging to the group. Nullable: Yes
Default:

FIRST Integer First scrambling code belonging to the group. Nullable: Yes
Default: 0

LAST Integer Last scrambling code belonging to the group. Nullable: Yes
Default: 0
NAME Text (50) Name of the scrambling code group. Nullable: No
Default:

STEP Integer Step between the first and last scrambling code belonging to the group. Nullable: Yes
Default: 1

8.2.35 SecondaryAntennas Table

For additional antennas.

Field Type Description Attributes

ANTENNA Text (50) Name of the secondary antenna model installed on a transmitter. Nullable: No
Default:

AZIMUT Float Azimuth of the secondary antenna. Nullable: No


Default: 0
PERCENT_POWER Float Percentage of power dedicated to the secondary antenna. Nullable: No
Default: 0

REDT Float Remote electrical tilt of the secondary antenna. Nullable: Yes
Default: 0

TILT Float Mechanical downtilt of the secondary antenna. Nullable: No


Default: 0
TX_ID Text (100) Name of the transmitter on which the secondary antenna is installed. Nullable: No
Default:

© 2018 Forsk. All Rights Reserved. 269


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

8.2.36 Separations Table

For scrambling code allocation constraints.

Field Type Description Attributes

TX_ID Text (100) Name of the first transmitter. Nullable: No


Default:

TX_ID_OTHER Text (100) Name of the second transmitter. Nullable: No


Default:

8.2.37 ServiceQualityTables Table

For release 99 performance graphs.

Field Type Description Attributes

DL_QI_TABLE Memo Downlink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:
MOBILITY Text (50) Mobility type corresponding to the quality indicator graph. Nullable: Yes
Default:

QI_NAME Text (50) Name of the quality indicator. Nullable: No


Default:

RX_EQUIP Text (50) Reception equipment corresponding to the quality indicator graph. Nullable: No
Default: ’Standard’
SERVICE Text (50) Name of the R99 radio bearer corresponding to the quality indicator graph. Nullable: No
Default:

UL_QI_TABLE Memo Uplink quality indicator graph as a function of the defined measurement Nullable: Yes
parameter. Default:

8.2.38 ServiceRUsUse Table

For resource unit consumptions per service.

Field Type Description Attributes

DIRECTION Short Whether the resource unit usage is defined for downlink or uplink. 1=DL; Nullable: No
2=UL. Default: 1

NB_SF1 Short Number of SF1 codes allocated for downlink. Nullable: Yes
Default: 0
NB_SF16 Short Number of SF16 codes allocated for downlink. Nullable: Yes
Default: 1

NB_SF2 Short Number of SF2 codes allocated for downlink. Nullable: Yes
Default: 0

NB_SF4 Short Number of SF4 codes allocated for downlink. Nullable: Yes
Default: 0
NB_SF8 Short Number of SF8 codes allocated for downlink. Nullable: Yes
Default: 0

SERVICE Text (50) Name of the service. Nullable: No


Default:

TS_RANK Short Rank for timeslot allocation in Monte Carlo simulations. Nullable: No
Default: 1

270 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

8.2.39 Sites Table

For sites.

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

ALTITUDE Float User-defined site altitude. Nullable: Yes


Default:

CDMA_EQUIPMENT Text (50) CDMA site equipment assigned to the site. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0
NAME Text (60) Name of the site. Nullable: No
Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50

SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

8.2.40 SitesLists Table

For sites belonging to site lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the site list. Nullable: No


Default:
SITE_NAME Text (60) Name of the sites belonging to the list. Nullable: No
Default:

8.2.41 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

8.2.42 SmartAntennas Table

For smart antenna equipment.

© 2018 Forsk. All Rights Reserved. 271


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

ADAPTIVE_PATTERN_DL Text (50) Downlink pattern used to model an adaptive smart antenna. Nullable: Yes
Default:

ADAPTIVE_PATTERN_UL Text (50) Uplink pattern used to model an adaptive smart antenna. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the smart antenna. Nullable: Yes
Default:

ELTS_NUMBER Integer Number of smart antenna elements. Nullable: Yes


Default: 4

GEOMETRY_TYPE Integer Smart antenna configuration. 1=ULA; 2=UCA. Nullable: Yes


Default: 1
GOB_PATTERN Text (50) Name of the downlink GOB. Nullable: Yes
Default:

GOB_PATTERN_UL Text (50) Name of the uplink GOB. Nullable: Yes


Default:

INTER_ELTS_DIST Integer Distance between smart antenna elements in percentage of the wavelength. Nullable: Yes
Default: 50
MODELLING_TYPE Short Type of the smart antenna model. Nullable: Yes
Default: 0

NAME Text (50) Name of the smart antenna. Nullable: No


Default:

PROBA_THRESHOLD Integer Probability of having more than used C/I gain. Nullable: Yes
Default: 50
SA_MODEL Text (50) Name of the smart antenna model used. Nullable: Yes
Default:

8.2.43 SmartAntennasModels Table

For smart antenna models.

Field Type Description Attributes

SA_DATA Binary Smart antenna model parameter settings. Nullable: Yes


Default:

SA_DESCRIPTION Text (50) Additional information about the smart antenna model. Nullable: Yes
Default:

SA_NAME Text (50) Name of the smart antenna model. Nullable: No


Default:
SA_SIGNATURE Text (50) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

SA_TYPE Text (50) ProgID of the model. Nullable: No


Default:

8.2.44 TMAEquipments Table

For tower-mounted amplifiers.

272 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

DL_LOSSES Float Downlink losses of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the tower mounted amplifier. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

UL_GAIN Float Uplink gain of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

8.2.45 TplTransmitters Table

For station templates.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default:
ANTDIVGAIN Float Antenna diversity gain. Unit: dB. Nullable: Yes
Default:

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: No
Default:

AZIMUT Float Azimuth of the main antenna. Nullable: Yes


Default:
BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes
Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default:

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CARRIERS Text (50) List of carriers used by the transmitters. Nullable: Yes
Default:

CDMA_EQUIPMENT Text (50) Name of the CDMA site equipment. Nullable: Yes
Default:
CELL_SIZE Float Hexagon radius. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default:
DWPCH_POWER Float Power on the DwPTS timeslot. Nullable: Yes
Default:

DYN_EDCH_DL_POWER_ALLO Boolean E-DCH power allocation mode. True=Dynamic; False=Static. Nullable: No


C Default:

DYN_HS_SCCH_POWER_ALL Boolean HS-SCCH power allocation mode. True=Dynamic; False=Static. Nullable: No


OC Default:

© 2018 Forsk. All Rights Reserved. 273


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

DYN_HS_SICH_POWER_ALLO Boolean HS-SICH power allocation mode. True=Dynamic; False=Static. Nullable: No


C Default:

DYN_HSDPA_POWER_ALLOC Boolean HSDPA power allocation mode. True=Dynamic; False=Static. Nullable: No


Default:

EDCH_DL_POWER Float E-DCH transmission power. Equals maximum available power in dynamic Nullable: Yes
allocation. Default:
FBAND Text (50) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder equipment. Nullable: Yes


Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default:
FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes
Default:

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default:

HS_SCCH_POWER Float HS-SCCH transmission power. Equals maximum available power in dynamic Nullable: Yes
allocation. Default:
HSDPA_MAX_CODES Short Maximum number of HS-PDSCH codes. Nullable: Yes
Default:

HSDPA_MAX_USERS Short Maximum number of simultaneous HSDPA users. Nullable: Yes


Default:

HSDPA_MIN_CODES Short Minimum number of HS-PDSCH codes. Nullable: Yes


Default:

HSDPA_PWR Float HSDPA transmission power. Nullable: Yes


Default:
HSDPA_SCHEDULER_ALGO Short Scheduling algorithm used for HSDPA users. 0=MAX C/I; 1=Round Robin; Nullable: Yes
2=Proportional Fair. Default:

HSPA_SUPPORT Short Supported HSPA features. 0=None; 1=HSDPA; 2=HSPA. Nullable: Yes
Default:

HSUPA_MAX_USERS Integer Maximum number of simultaneous HSUPA users. Nullable: Yes


Default:
MAX_EXT_NEIGHB_NUMBER Short Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Short Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default:

MAX_R99BEARER_DL_RATE Float Maximum downlink R99 throughput. Unit: kbps. Nullable: Yes
Default:
MAX_R99BEARER_UL_RATE Float Maximum uplink R99 throughput. Unit: kbps. Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default:

MIN_RANGE Integer Minimum coverage range. Nullable: Yes


Default:
MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes
Default:

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default:

N_FREQUENCY Boolean Whether the transmitter is in N-frequency mode or not. True=Yes; False=No. Nullable: No
Default:

274 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

NAME Text (50) Name of the station template. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default:

NUM_HS_SCCH Short Number of HS-SCCH channels. Nullable: Yes


Default:
NUM_HS_SICH Short Number of HS-SICH channels. Nullable: Yes
Default:

NUM_HSDPA_USERS Integer Number of served HSDPA users. Nullable: Yes


Default:

NUM_HSUPA_USERS Integer Number of served HSUPA users. Nullable: Yes


Default:
NUM_RX_ANTENNAS Short Number of reception antenna ports available at the transmitter. 1; 2; 4. Nullable: Yes
Default:

NUM_SECTORS Integer Number of sectors in the station template. Nullable: Yes


Default: 3

NUM_TX_ANTENNAS Short Number of transmission antenna ports available at the transmitter. Nullable: Yes
Default:
OTHERS_CCH_POWER Float Transmission power of other common channels for TS0 (S-CCPCH, FPACH, Nullable: Yes
PICH). Default:

PILOT_POWER Float Power of the pilot channel. Nullable: Yes


Default:

POWER_MAX Float Cell's maximum transmission power. Nullable: Yes


Default:

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:
PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

PWR_HEADROOM Float Power control headroom for DCH. Unit: dB. Nullable: Yes
Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default:
REQ_DL_RUS Integer Required number of resource units in downlink. Nullable: Yes
Default:

REQ_UL_RUS Integer Required number of resource units in uplink. Nullable: Yes


Default:

REUSE_DIST Float Minimum reuse distance for scrambling codes. Nullable: Yes
Default:
RSCP_MIN Float Minimum received signal code power. Nullable: Yes
Default:

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default:

SA_NAME Text (50) Name of the smart antenna. Nullable: Yes


Default:
SC_DOMAIN_NAME Text (50) Name of the scrambling code domain. Nullable: Yes
Default:

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:

© 2018 Forsk. All Rights Reserved. 275


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes


Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default:

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:
TS_CONFIG Float Timeslot configuration. 1=UDDDDD; 2=UUDDDD; 3=UUUDDD; 4=UUUUDD; Nullable: Yes
5=UUUUUD; 6=UpUDDDD; 7=UpUUDDD. Default:

TX_DIVERSITY_CFG Integer Transmit diversity configuration. 1=No diversity; 2=Open loop; 3=Closed Nullable: Yes
loop. Default:

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default:
UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default:

8.2.46 Transmitters Table

For transmitters.

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default: True
ANTDIVGAIN Float Antenna diversity gain. Unit: dB. Nullable: Yes
Default: 0

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: Yes
Default:

AZIMUT Float Azimuth of the main antenna. Nullable: Yes


Default: 0
BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes
Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default: 4000

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default: 50

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default: 2000
COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DX Float X coordinate relative to the site location. Nullable: Yes


Default: 0

276 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

DY Float X coordinate relative to the site location. Nullable: Yes


Default: 0

FBAND Text (50) Name of the frequency band used by the transmitter. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder. Nullable: Yes


Default:
FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes
Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default: 0

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default: 25
HEXAGON_GROUP Text (50) Group of hexagons used to create the transmitter. Nullable: Yes
Default:

MAX_RANGE Integer Maximum coverage range. Nullable: Yes


Default: 35000

MIN_RANGE Integer Minimum coverage range. Nullable: Yes


Default: 0
MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes
Default: 0

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default: 0

N_FREQUENCY Boolean Whether the transmitter is in N-frequency mode or not. True=Yes; False=No. Nullable: No
Default: False

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default: 5
NUM_RX_ANTENNAS Short Number of reception antenna ports available at the transmitter. 1; 2; 4. Nullable: No
Default: 1

NUM_TX_ANTENNAS Short Number of transmission antenna ports available at the transmitter. Nullable: No
Default: 1

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default: ’Default model’
PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default: 0

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0
SA_NAME Text (50) Name of the smart antenna. Nullable: Yes
Default:

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:
SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes
Default: 0

SITE_NAME Text (60) Name of the site on which the transmitter is located. Nullable: No
Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 277


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TX_DIVERSITY_CFG Short Transmit diversity configuration. 1=No diversity; 2=Open loop; 3=Closed Nullable: Yes
loop. Default: 0

TX_ID Text (100) Name of the transmitter. Nullable: No


Default:
TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

8.2.47 TxsLists Table

For transmitters belonging to transmitter lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the transmitter list. Nullable: No


Default:

TX_NAME Text (50) Name of the transmitters belonging to the list. Nullable: No
Default:

8.2.48 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

NAME Text (50) Name of the transmitter list. Nullable: No


Default:

8.2.49 UECategories Table

For HSDPA UE categories.

Field Type Description Attributes

MAX_BLOCK_SIZE Integer Maximum transport block size. Nullable: Yes


Default: 26000

MAX_HSPDSCH_NUM Short Maximum number of HS-PDSCH channels for HSDPA. Nullable: Yes
Default: 5

278 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

MAX_HSPDSCH_TS Short Maximum number of HS-PDSCH timeslots per TTI. Nullable: Yes
Default: 2

MODULATION Short Highest modulation used by the HSDPA UE category. 0=QPSK; 1=16QAM. Nullable: No
Default: 0

UE_CATEGORY Short HSDPA UE category. Nullable: No


Default:
UE_CATEGORY_NAME Text (50) Name of the HSDPA UE category. Nullable: Yes
Default:

8.2.50 UERxEquipments Table

For UE reception equipment.

Field Type Description Attributes

NAME Text (50) Name of reception equipment. Nullable: No


Default:

8.2.51 UMTSEnvironmentDefs Table

For traffic environment types.

Field Type Description Attributes

DENSITY Float Number of users per km2. Nullable: Yes


Default: 0
ENVIRONMENT Text (50) Name of the traffic environment. Nullable: No
Default:
MOBILITY Text (50) Mobility type corresponding to the traffic environment. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the traffic environment. Nullable: No
Default:

8.2.52 UMTSMobility Table

For mobility types.

Field Type Description Attributes

DWPCH_QUALITY Float Quality target for the DwPCH. Unit: dB. Nullable: Yes
Default: 2
DWPCH_RSCP Float Minimum DwPCH RSCP. Nullable: Yes
Default: -100

EDCH_DL_ECNT Float E-DCH Ec/Nt target for HSUPA downlink power (E-AGCH, E-HICH). Unit: dB. Nullable: Yes
Default: -12

HSSCCH_ECNT Float Target HS-SCCH Ec/Nt for HSDPA. Unit: dB. Nullable: Yes
Default: -12
HSSICH_ECNT Float Target HS-SICH Ec/Nt for HSDPA. Unit: dB. Nullable: Yes
Default: -12

© 2018 Forsk. All Rights Reserved. 279


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

MEAN_SPEED Float Average user speed corresponding to the mobility type. Unit: km/h. Nullable: Yes
Default: 0

NAME Text (50) Name of the mobility type. Nullable: No


Default:

RSCP_DROP Float P-CCPCH RSCP for cell dropping (baton handover). Nullable: Yes
Default: -95
RSCP_MIN Short Minimum received signal code power. Nullable: Yes
Default: -84

TADD Float Minimum Ec/Io for best server selection. Unit: dB. Nullable: Yes
Default: 7

UPPCH_RSCP Float Minimum UpPCH RSCP. Nullable: Yes


Default: -100

8.2.53 UMTSServices Table

For services.

Field Type Description Attributes


ADPCH_ACTIVITY Float Activity factor for HSDPA users. Nullable: Yes
Default: 0.1

BODY_LOSS Float Body loss. Unit: dB. Nullable: No


Default: 0

CARRIER_LIST Text (50) List of preferred or allowed carrier numbers. Nullable: Yes
Default:

CARRIER_SUPPORT Integer Type of carrier list. 0=Prefered carriers; 1=Allowed carriers. Nullable: Yes
Default: 0
DL_ACTIVITY Float Activity factor for circuit switched services on the downlink. Nullable: Yes
Default: 1

DL_DP Float Inter-packet arrival time on the downlink. Unit: ms. Nullable: Yes
Default: 0

DL_DPC Float Reading time between two packet calls on the downlink. Unit: ms. Nullable: Yes
Default: 0
DL_NPC Integer Number of packet calls during a session on the downlink. Nullable: Yes
Default: 1

DL_PACKET_EFFICIENCY Float Packet efficiency factor on the downlink. Nullable: Yes


Default:

DL_SP Integer Packet size on the downlink. Unit: Byte. Nullable: Yes
Default: 1500
DL_SPC_MAX Float Maximum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 2000

DL_SPC_MIN Float Minimum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 4

EDPCH_ACTIVITY Float Activity factor for HSUPA users. Nullable: Yes


Default: 0.1
NAME Text (50) Name of the service. Nullable: No
Default:

PRIORITY Integer Service priority. 0=Lowest. Nullable: Yes


Default: 0

280 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

R99BEARER Text (50) Name of the R99 bearer. Nullable: Yes


Default:

REQ_AVERAGE_DL_RATE Float Average requested throughput on the downlink. Unit: kbps. Nullable: Yes
Default:

REQ_AVERAGE_UL_RATE Float Average requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default:
REQ_MIN_DL_RATE Float Minimum requested throughput on the downlink. Unit: kbps. Nullable: Yes
Default: 0

REQ_MIN_UL_RATE Float Minimum requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default: 0

TH_OFFSET Float Fixed offset to map throughput to the application layer. Nullable: No
Default: 0
TH_SCALE_FACTOR Float Ratio between application throughput and RLC layer throughput. Nullable: No
Default: 95

TYPE Short Type of service. 0=Circuit (R99); 1=Packet (R99); 2=Packet (HSDPA); Nullable: No
3=Packet (HSPA). Default: 0

UL_ACTIVITY Float Activity factor for circuit-switched service on the uplink. Nullable: Yes
Default: 1
UL_DP Float Inter-packet arrival time on the uplink. Unit: ms. Nullable: Yes
Default: 0

UL_DPC Float Reading time between two packet calls in uplink. Unit: ms. Nullable: Yes
Default: 0

UL_NPC Integer Reading time between two packet calls on the uplink. Unit: ms. Nullable: Yes
Default: 1

UL_PACKET_EFFICIENCY Float Number of packet calls during a session on the uplink. Nullable: Yes
Default:
UL_SP Integer Packet size on the uplink. Unit: bytes. Nullable: Yes
Default: 1500

UL_SPC_MAX Float Maximum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 2000

UL_SPC_MIN Float Minimum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 4

8.2.54 UMTSServicesQuality Table

For release 99 service access thresholds.

Field Type Description Attributes


DL_TARGET_QUAL Float Downlink quality target. Unit: dB. Nullable: Yes
Default: 0

DL_TGT_QUAL_DIVCLOSED Float Downlink quality target for closed-loop diversity. Unit: dB. Nullable: Yes
Default: 0

DL_TGT_QUAL_DIVOPEN Float Downlink quality target for open-loop diversity. Unit: dB. Nullable: Yes
Default: 0
MOBILITY Text (50) Mobility type corresponding to the R99 bearer quality requirements. Nullable: No
Default:

RX_EQUIP Text (50) Name of the reception equipment corresponding to the R99 bearer quality Nullable: No
requirements. Default:

© 2018 Forsk. All Rights Reserved. 281


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

SERVICE Text (50) Name of the R99 bearer. Nullable: No


Default:

TCH_THRESHOLD_DL Short RSCP TCH target on downlink for a type of mobility. Nullable: Yes
Default: 0

TCH_THRESHOLD_UL Short RSCP TCH target on uplink for a type of mobility. Nullable: Yes
Default: 0
UL_TARGET_QUAL Float Uplink quality target. Unit: dB. Nullable: Yes
Default: 0

UL_TGT_QUAL_DIV2RX Float Uplink quality target for 2-port reception diversity. Unit: dB. Nullable: Yes
Default: 0

UL_TGT_QUAL_DIV4RX Float Uplink quality target for 4-port reception diversity. Unit: dB. Nullable: Yes
Default: 0

8.2.55 UMTSServicesUsage Table

For user profile parameters.

Field Type Description Attributes


CALL_DURATION Float Average duration of a call for circuit-switched services. Unit: s. Nullable: Yes
Default:

CALL_NUMBER Float Average number of calls per hour for circuit-switched services or average Nullable: Yes
number of sessions per hour for packet-switched services. Default: 0

DL_VOLUME Float Data volume transferred on the downlink during a session for packet- Nullable: Yes
switched services. Unit: kB. Default:

SERVICE Text (50) Name of the service corresponding to the user profile. Nullable: No
Default:
TERMINAL Text (50) Name of the terminal corresponding to the user profile. Nullable: No
Default:

UL_VOLUME Float Data volume transferred on the uplink during a session for packet-switched Nullable: Yes
services. Unit: kB. Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the user profile. Nullable: No
Default:

8.2.56 UMTSTerminals Table

For terminal types.

Field Type Description Attributes


CARRIER_NUMBER Short Number of carriers supported by the terminal. Nullable: Yes
Default: 1

GAIN Float Terminal antenna gain. Unit: dB. Nullable: Yes


Default: 0

HSPA_SUPPORT Short Supported HSPA features. 0=None; 1=HSDPA; 2=HSPA. Nullable: No


Default: 0
HSSICH_POWER Float Maximum power on HS-SICH channels. Nullable: Yes
Default: 21

HSUPA_UE_CATEGORY Short HSUPA UE category. Nullable: Yes


Default: 1

282 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

LOSS Float Terminal antenna loss. Unit: dB. Nullable: Yes


Default: 0

MUD_FACTOR Float Multi-user detection factor to model intra-cell interference reduction for Nullable: Yes
HSDPA terminals. Default: 0

NAME Text (50) Name of the terminal. Nullable: No


Default:
NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8

PMAX Float Maximum transmission power of the terminal. Nullable: Yes


Default: 21

PMIN Float Minimum transmission power of the terminal. Nullable: Yes


Default: -50
RHO_FACTOR Short CDMA rho factor for self interference. Nullable: No
Default: 100

RX_EQUIP Text (50) Name of the reception equipment associated with the terminal. Nullable: Yes
Default: ‘Standard’

UE_CATEGORY Float HSDPA UE category of the terminal. Nullable: Yes


Default: 1
UPPCH_POWER Float Power on the UpPTS timeslot. Nullable: Yes
Default: -50

8.2.57 UMTSTraficEnvironments Table

For traffic environment clutter weighting.

Field Type Description Attributes


CLUTTER_WEIGHTS Binary Clutter weighting for traffic environment maps. Nullable: Yes
Default: Yes

NAME Text (50) Name of the traffic environment. Nullable: No


Default:

8.2.58 UMTSUserProfiles Table

For names of user profiles.

Field Type Description Attributes

NAME Text (50) Name of the user profile. Nullable: No


Default:

8.2.59 Units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, and the
database internal coordinate system.

© 2018 Forsk. All Rights Reserved. 283


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

Field Type Description Attributes

COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes


Default: -1

GAIN_UNIT Integer Unit used for gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0
PROJECTION Integer Projection coordinate system of the document. Nullable: Yes
Default: -1

RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0

TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No


Default: 0

8.3 Relationships

Many-to-One Relationships (  1)

AntennasLists.ANTENNA_NAME Antennas.NAME

AntennasLists.LIST_NAME AntennasListsNames.NAME

CdmaCells.SC_DOMAIN_NAME ScramblingCodesDomains.DOMAIN_NAME

CdmaCells.TX_ID Transmitters.TX_ID

CdmaCellsTS.CELL_ID CdmaCells.CELL_ID

CdmaEquipmentsCEsUse.EQUIPMENT CdmaEquipments.NAME

CdmaEquipmentsCEsUse.SERVICE UMTSServices.NAME

HSDPABearers.UE_CATEGORY UECategories.UE_CATEGORY

HSDPABearerSelectTables.BEARER_INDEX HSDPABearers.BEARER_INDEX

HSDPABearerSelectTables.MOBILITY UMTSMobility.NAME

HSDPABearerSelectTables.RX_EQUIP UERxEquipments.NAME

HSUPABearers.UE_CATEGORY HSUPAUECategories.UE_CATEGORY

HSUPABearerSelection.BEARER_INDEX HSUPABearers.BEARER_INDEX

HSUPABearerSelection.MOBILITY UMTSMobility.NAME

HSUPABearerSelection.RX_EQUIP UERxEquipments.NAME

Neighbours.NEIGHBOUR CdmaCells.CELL_ID

Neighbours.TRANSMITTER CdmaCells.CELL_ID

NeighboursConstraints.NEIGHBOUR CdmaCells.CELL_ID

NeighboursConstraints.TRANSMITTER CdmaCells.CELL_ID

NeighboursConstraintsExt.TRANSMITTER CdmaCells.CELL_ID

NeighboursExt.TRANSMITTER CdmaCells.CELL_ID

Networks.DEFAULT_MODEL PropagationModels.NAME

Receivers.ANTENNA Antennas.NAME

Repeaters.DONOR_CELLID Transmitters.TX_ID

Repeaters.DONOR_PROPAG_MODEL PropagationModels.NAME

Repeaters.EQUIPMENT_NAME RepeaterEquipments.NAME

Repeaters.FEEDER_NAME FeederEquipments.NAME

Repeaters.REC_ANTENNA Antennas.NAME

Repeaters.TX_ID Transmitters.TX_ID

284 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 8: TD-SCDMA Data Structure

Many-to-One Relationships (  1)

SACIGainCDF.SA_NAME SmartAntennas.NAME

ScramblingCodesGroups.DOMAIN_NAME ScramblingCodesDomains.DOMAIN_NAME

SecondaryAntennas.ANTENNA Antennas.NAME

SecondaryAntennas.TX_ID Transmitters.TX_ID

Separations.TX_ID CdmaCells.CELL_ID

Separations.TX_ID_OTHER CdmaCells.CELL_ID

ServiceQualityTables.MOBILITY UMTSMobility.NAME

ServiceQualityTables.QI_NAME QualityIndicators.NAME

ServiceQualityTables.RX_EQUIP UERxEquipments.NAME

ServiceQualityTables.SERVICE R99Bearers.NAME

ServicesRUsUse.SERVICE R99Bearers.NAME

Sites.CDMA_EQUIPMENT CdmaEquipments.NAME

SmartAntennas.ADAPTIVE_PATTERN_DL AntennasListsNames.NAME

SmartAntennas.ADAPTIVE_PATTERN_UL AntennasListsNames.NAME

SmartAntennas.GOB_PATTERN AntennasListsNames.NAME

SmartAntennas.GOB_PATTERN_UL AntennasListsNames.NAME

Transmitters.ANTENNA_NAME Antennas.NAME

Transmitters.BTS_NAME BTSEquipments.NAME

Transmitters.FBAND FrequencyBands.NAME
Transmitters.FEEDER_NAME FeederEquipments.NAME

Transmitters.PROPAG_MODEL PropagationModels.NAME

Transmitters.PROPAG_MODEL2 PropagationModels.NAME
Transmitters.SA_NAME SmartAntennas.NAME

Transmitters.SITE_NAME Sites.NAME

Transmitters.TMA_NAME TMAEquipments.NAME
TxsLists.LIST_NAME TxsListsNames.NAME

TxsLists.TX_NAME Transmitters.TX_ID

UMTSEnvironmentDefs.ENVIRONMENT UMTSTraficEnvironments.NAME
UMTSEnvironmentDefs.MOBILITY UMTSMobility.NAME

UMTSEnvironmentDefs.USER_PROFILE UMTSUserProfiles.NAME

UMTSServices.R99BEARER R99Bearers.NAME

UMTSServicesQuality.MOBILITY UMTSMobility.NAME

UMTSServicesQuality.RX_EQUIP UERxEquipments.NAME

UMTSServicesQuality.SERVICE R99Bearers.NAME

UMTSServicesUsage.SERVICE UMTSServices.NAME

UMTSServicesUsage.TERMINAL UMTSTerminals.NAME

UMTSServicesUsage.USER_PROFILE UMTSUserProfiles.NAME
UMTSTerminals.HSUPA_UE_CATEGORY HSUPAUECategories.UE_CATEGORY

UMTSTerminals.RX_EQUIP UERxEquipments.NAME

UMTSTerminals.UE_CATEGORY UECategories.UE_CATEGORY

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

© 2018 Forsk. All Rights Reserved. 285


Atoll 3.4.0 Data Structure Reference Guide
Chapter 8: TD-SCDMA Data Structure

286 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

9 WiMAX, Wi-Fi, and LPWA Data Structures


Atoll supports WiMAX, Wi-Fi, and LPWA network planning. This section describes the WiMAX, Wi-Fi, and LPWA data
structures used in Atoll. It lists all the tables and fields found in the WiMAX, Wi-Fi, and LPWA templates and the
relationships between them.

 Primary keys are listed in bold and italic characters.

9.1 Data Structure Changes from Atoll 3.3 to 3.4

9.1.1 Added Tables and Fields

FeederEquipments Table

Field Type Description Attributes

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

Sites Table

Field Type Description Attributes


ALIAS_ Text (60) Site alias. Nullable: Yes
Default:

Transmitters Table

Field Type Description Attributes


ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:

USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

9.1.2 Deleted Tables and Fields

None.

© 2018 Forsk. All Rights Reserved. 287


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

9.2 Data Structure

9.2.1 Antennas Table

For antennas.

Field Type Description Attributes

BEAMWIDTH Float The half-power beamwidth of the antenna model. Nullable: Yes
Default:
COMMENT_ Text (255) Additional information about the antenna model. Nullable: Yes
Default:

CONSTRUCTOR Text (255) Name of the antenna manufacturer. Nullable: Yes


Default:

DIAGRAM Binary Antenna horizontal and vertical patterns. Nullable: Yes


Default:
ELECTRICAL_AZIMUTH Float The electrical azimuth of the antenna model. Nullable: Yes
Default:

ELECTRICAL_TILT Float The electrical tilt of the antenna model. Nullable: Yes
Default:

FMAX Double Maximum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:
FMIN Double Minimum operating frequency of the antenna. Unit: MHz. Nullable: Yes
Default:

GAIN Float Antenna model gain compared to an isotropic radiator. Unit: dBi. Nullable: No
Default: 0

NAME Text (50) Name of the antenna model. Nullable: No


Default:

PHYSICAL_ANTENNA Text (50) Name of the physical antenna to which the antenna model belongs. Nullable: Yes
Default:

 The format of the binary field, DIAGRAM, is described in "RF 2D Antenna Pattern
Format" on page 355.

9.2.2 BTSEquipments Table

For BTS equipment.

Field Type Description Attributes

CONFIG_DL_LOSSES Float Downlink losses due to transmitter components (duplexer, combiner, etc.). Nullable: Yes
Unit: dB. Default: 0

288 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

CONFIG_UL_LOSSES Float Uplink losses due to transmitter components (duplexer, combiner, etc.). Unit: Nullable: Yes
dB. Default: 0

NAME Text (50) Name of transmitter equipment. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of transmitter equipment. Unit: dB. Nullable: Yes
Default: 0
RHO_FACTOR Short CDMA rho factor for self interference (not used in other technologies). Nullable: Yes
Default: 100

9.2.3 CoordSys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

Field Type Description Attributes

CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default: 0

DATUM_CODE Double Identification code of the datum. Nullable: Yes


Default: 0
DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes
Default: 0

DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0
DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes
Default: 0

DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes


Default: 0

DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes


Default: 0
ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No
Default: 0

ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes


Default: 0

ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes


Default: 0
GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:

PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes


Default: 0

PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes


Default: 0
PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 289


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0

PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes
Default: 0

9.2.4 CustomFields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:

CHOICE_LIST Memo Choice list for text fields. Nullable: Yes


Default:

CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default: 0
COLUMN_NAME Text (50) Name of the custom field. Nullable: No
Default:

DEFAULT_VALUE Text (50) Default value for the field. Nullable: Yes
Default:

DISPLAY_TYPE Integer Whether the field is hypertext or regular and modifiable or read-only. Nullable: Yes
0=Regular and modifiable; 1=Regular and read-only; 2=Hypertext and mod- Default: 0
ifiable; 3=Hypertext and read-only

GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:

TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.
 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.

290 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

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


 Table and field names are case sensitive.
 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any 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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the
appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

9.2.5 FeederEquipments Table

For feeders.

Field Type Description Attributes

CONNECTOR_LOSSES_DL Float Feeder connector losses in downlink. Unit: dB. Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 291


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

CONNECTOR_LOSSES_UL Float Feeder connector losses in uplink. Unit: dB. Nullable: Yes
Default: 0

LOSS_PER_FB_M Memo Linear feeder losses per frequency. Nullable: Yes


Default:

LOSS_PER_METER Float Feeder loss per meter. Unit: dB. Nullable: Yes
Default: 0
NAME Text (50) Name of the feeder. Nullable: No
Default:

9.2.6 FrameConfigurations Table

For WiMAX and Wi-Fi frame configurations and LPWA channel configurations.

Field Type Description Attributes

CYCLIC_PREFIX Short WiMAX/Wi-Fi: Cyclic prefix ratio. NULL; 0=1/4; 1=1/8; 2=1/16; 3=1/32; Nullable: Yes
4=None. Default:
LPWA: Not applicable. Set to NULL.
N_FFT Short/ WiMAX/Wi-Fi (Short): Total number of subcarriers per channel. Nullable: Yes
Integer LWPA (Integer): Total bandwidth in Hz. Default: 256

NAME Text (50) Name of the frame configuration. Nullable: No


Default: "Default Frame"

PREAMBLE_N_USED Short/ WiMAX/Wi-Fi (Short): Number of subcarriers used for the preamble. Nullable: No
Integer LPWA (Integer): Not applicable. Set equal to the total bandwidth in Hz. Default:
SEGMENTATION Boolean WiMAX: Whether the first downlink PUSC zone is segmented or not. Nullable: No
True=Yes; False=No. Default: False
Wi-Fi/LPWA: Not applicable.

UL_SEGMENTATION Boolean WiMAX: Whether the first uplink PUSC zone is segmented or not. True=Yes; Nullable: No
False=No. Default: False
Wi-Fi/LPWA: Not applicable.

9.2.7 FrequencyBands Table

For frequency bands.

Field Type Description Attributes

ADJ_CHANNEL_PROT Float WiMAX/Wi-Fi: Adjacent channel interference reduction (ACIR = 1/(1/ACS + Nullable: No
1/ACLR)). Unit: dB. Default: 11
LPWA: Not applicable.

CHANNEL_WIDTH Double WiMAX/Wi-Fi: Channel width. Unit: MHz. Nullable: Yes


LPWA: Bandwidth. Unit: MHz Default: 1
DELTA_CN Integer WiMAX/Wi-Fi: Step between two adjacent channel numbers. Nullable: Yes
LPWA: Not applicable Default: 1

DL_FREQUENCY Double Downlink start frequency of the frequency band. Unit: MHz. Nullable: Yes
Default:

DUPLEXING_METHOD Short WiMAX/Wi-Fi: Duplexing method used in the frequency band. 0=FDD; 1=TDD. Nullable: No
LPWA: Not applicable. Must be set to 0. Default: 0
EXCLUDED_CHANNELS Text (255) WiMAX/Wi-Fi: List of channel numbers not part of the usable spectrum. Nullable: Yes
LPWA: Not applicable Default:

292 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

FIRST_CHANNEL Integer WiMAX/Wi-Fi: First channel number in the frequency band. Nullable: Yes
LPWA: Not applicable. Must be set to 0. Default: 0

GUARD_BAND Float WiMAX/Wi-Fi: Guard band between two adjacent channels. Unit: MHz. Nullable: Yes
LPWA: Not applicable Default: 0

LAST_CHANNEL Integer WiMAX/Wi-Fi: Last channel number in the frequency band. Nullable: Yes
LPWA: Not applicable. Must be set to 0. Default: 9
NAME Text (50) Name of the frequency band. Nullable: No
Default:

SAMPLING_FACTOR Float WiMAX: Ratio between the channel bandwidth and its sampling frequency. Nullable: No
Wi-Fi/LPWA: Not applicable. Must be set to 1. Default: 1

UL_FREQUENCY Double Uplink start frequency of the frequency band. Unit: MHz. Nullable: Yes
Default:

9.2.8 InterNetChProtect Table

For inter-network interference reduction factor graphs.

Field Type Description Attributes


ICP Memo Inter-RAT interference reduction graph as a function of frequency difference Nullable: Yes
between channels. Default:

ITF_BW Double Channel width of the interferer cell. Unit: kHz. Nullable: No
Default: 0

ITF_TECHNO Text (50) Technology of the interfering cell. Nullable: No


Default:

V_BW Double Channel width of the interfered cell. Unit: kHz. Nullable: No
Default: 0

9.2.9 MUGTables Table

For multi-user diversity gains.

Field Type Description Attributes

MAX_CINR Float C/(I+N) above which MUG will not be applied. Unit: dB. Nullable: No
Default: 16.8

MOBILITY Text (50) Mobility type corresponding to the MUG graph. Nullable: No
Default:

MUG_TABLE Memo Multi-user diversity gain graph as a function of number of users. Nullable: Yes
Default:
SCHEDULER_NAME Text (30) Scheduler corresponding to the multi-user diversity gain graph. Nullable: No
Default:

9.2.10 Neighbours Table

For intra-technology neighbour relations.

© 2018 Forsk. All Rights Reserved. 293


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

RELATION_TYPE Short Type of the neighbour relation. 0=Intra-carrier; 1=Inter-carrier. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

9.2.11 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

Field Type Description Attributes


IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

9.2.12 NeighboursConstraintsExt Table

For inter-technology neighbour allocation constraints.

Field Type Description Attributes


IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default:

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:

STATUS Integer Type of constraint on the neighbour relation. 0=Forced; 1=Forbidden. Nullable: Yes
Default: 0
TRANSMITTER Text (100) Name of the source cell. Nullable: No
Default:

9.2.13 NeighboursExt Table

For inter-technology neighbour relations.

294 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

IMPORTANCE Float Importance of the neighbour relation between cells. Nullable: Yes
Default: 1

NEIGHBOUR Text (100) Name of the neighbour cell. Nullable: No


Default:
REASON Integer Main reason of neighbour relation. 0=Exceptional pair; 1=Co-site; 2=Adja- Nullable: Yes
cent; 3=Symmetric; 4=Coverage; 5=Existing; 6=Distance; 7=Adjacent layer; Default:
8=Handover.

TRANSMITTER Text (100) Name of the source cell. Nullable: No


Default:

TYPE Text (50) Source of the neighbour relation (manual, imported, auto). Nullable: Yes
Default:

9.2.14 Networks Table

For network-level parameters.

Field Type Description Attributes

AMS_SEL_CRITERION Short WiMAX: Radio parameter on which AMS switching is based. 0=Preamble C/ Nullable: Yes
N; 1=Preamble C/(I+N). Default: 0
Wi-Fi/LPWA: Not applicable. Must be set to 0.

BS_SELECTION Short WiMAX: Radio parameter on which best server selection is based. 0=Pream- Nullable: Yes
ble C; 1=Preamble C/N. Default: 0
Wi-Fi/LPWA: Not applicable. Must be set to 0.
CELL_SELECTION Short Serving cell selection method. 2=Random; 3=Distributive. Nullable: Yes
Default: 2

CYCLIC_PREFIX Short WiMAX/Wi-Fi: Cyclic prefix ratio. 0=1/4; 1=1/8; 2=1/16; 3=1/32; 4=None. Nullable: No
LPWA: Not applicable. Set to 4. Default: 1

DEFAULT_MODEL Text (50) Default propagation model. Nullable: Yes


Default: "Cost-Hata"

DEFAULT_RESOLUTION Float Default calculation resolution. Nullable: No


Default: 50
DEFAULT_RTG Float WiMAX: Receive time guard (TDD only). Unit: ms. Nullable: No
Wi-Fi/LPWA: Not applicable. Must be set to 0. Default: 0

DEFAULT_TTG Float WiMAX: Transmit time guard (TDD only). Unit: ms. Nullable: No
Wi-Fi/LPWA: Not applicable. Must be set to 0. Default: 0

DL_RATIO_FORMAT Short WiMAX: Format of the DL:UL ratio parameter. 0=Percentage; 1=Fraction. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default: 0
DL_SYM_DURATIONS_NB Short WiMAX: Number of OFDM symbols in the downlink subframe. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default: 32

DL_UL_RATIO Float WiMAX: DL-UL subframe ratio (TDD only). Unit: %. Nullable: No
Wi-Fi/LPWA: Not applicable Default: 66.667

DMAX Float Maximum radius for a cell. Nullable: No


Default: -1
FIX_DL_OVERHEAD Short WiMAX: Downlink overhead expressed in symbol durations. Nullable: No
Wi-Fi/LPWA: Not applicable. Must be set to 0. Default: 1

FIX_UL_OVERHEAD Integer WiMAX: Uplink overhead expressed in symbol durations. Nullable: No


Wi-Fi/LPWA: Not applicable. Must be set to 0. Default: 0

© 2018 Forsk. All Rights Reserved. 295


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

FRAME_DURATION Short The length of the frame. 0=20 ms; 1=12.5 ms; 2=10 ms; 3=8 ms; 4=5 ms; 5=4 Nullable: No
ms; 6=2.5 ms; 7=2 ms; 8=1 s. Default: 4
Wi-Fi: Must be set to 0.
LPWA: Must be set to 8.

INTERFERERS_RX_THRESH Float Lowest received interference level. Unit: dB. Nullable: Yes
Default: -20
MIMO_INT_PWR_COMB Short Power combining of interfering signals due to multiple antennas. 0=No; Nullable: Yes
1=Yes. Default: 0

N_DATA Short WiMAX: Number of subcarriers per channel used for data transfer (N_USED Nullable: Yes
- pilot subcarriers). Default: 192
Wi-Fi/LPWA: Not applicable
N_FFT Short WiMAX: Total number of subcarriers per channel. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default: 256

N_SUBCHANNELS_CH Short WiMAX: Number of subchannels per channel. Nullable: Yes


Wi-Fi/LPWA: Not applicable Default: 16

N_USED Short WiMAX: Number of used subcarriers per channel (N_FFT - guard subcarriers Nullable: Yes
- DC subcarrier). Default: 200
Wi-Fi/LPWA: Not applicable

NAME Text (50) Name of the network. Nullable: No


Default:

POWER_CONTROL_MARGIN Float Uplink power control margin. Unit: dB. Nullable: Yes
Default: 1
PZ_SEL_CRITERION Short WiMAX: Permutation zone selection criterion. 0=Preamble C/N; 1=Preamble Nullable: Yes
C/(I+N). Default: 0
Wi-Fi/LPWA: Not applicable. Must be set to 0.

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:

SHARED_RESULTS_FOLDER Text (255) Shared path loss matrices storage folder. Nullable: Yes
Default:
SYSTEM_ Text (50) Name of the system. Nullable: No
Default: ‘IEEE 802.16e’

TECHNOLOGY Text (10) Name of the technology. Nullable: No


Default: ‘OFDM’

THERMAL_NOISE Float Thermal noise. Nullable: Yes


Default: -121
UL_SYM_DURATIONS_NB Short WiMAX: Number of OFDM symbols in the uplink subframe. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default: 15

VARIABLE_DL_OVERHEAD Float WiMAX: Variable downlink overhead expressed in percentage of the sub- Nullable: No
frame. Default: 0
Wi-Fi/LPWA: Not applicable. Must be set to 0.
VARIABLE_UL_OVERHEAD Float WiMAX: Variable uplink overhead expressed in percentage of the subframe. Nullable: No
Wi-Fi/LPWA: Not applicable. Must be set to 0. Default: 0

9.2.15 PermutationZones Table

For permutation zones.

296 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

AUTO_ACTIVATE Boolean WiMAX: Whether the permutation zone is used or not. True=Yes; False=No. Nullable: No
Wi-Fi/LPWA: Must be set to True for zones 0 and 8, False for others. Default: False

DIVERSITY_SUPPORT Short The type of antenna diversity supported by the permutation zone. 1=None; Nullable: Yes
2=AAS; 3=None+AAS; 4=STTD; 5=None+STTD; 6=AAS+STTD; Default: 1
7=None+AAS+STTD; 8=SU-MIMO; 9=None+SU-MIMO; 10=AAS+SU-MIMO;
11=None+AAS+SU-MIMO; 16=AMS; 17=None+AMS; 18=AAS+AMS;
19=None+AAS+AMS; 32=MU-MIMO; 33=None+MU-MIMO; 34=AAS+MU-
MIMO; 35=None+AAS+MU-MIMO.

FRAME_CONFIG Text (50) Name of the cell's frame configuration. Nullable: No


Default:
MAX_DISTANCE Float Maximum coverage limit of the permutation zone. Nullable: Yes
Default: 500000

MAX_SPEED Float Maximum user speed supported by the permutation zone. Unit: km/h. Nullable: Yes
Default: 150

N_DATA Short WiMAX/Wi-Fi: Number of subcarriers per channel used for data transfer Nullable: Yes
(N_USED - pilot subcarriers). Default: 192
LPWA: Width of one channel of a frequency band in Hz.

N_SUBCHANNELS_CH Short WiMAX/Wi-Fi: Number of subchannels per channel. Nullable: Yes


LPWA: Number of channels in the frequency band. Default: 16

N_USED Short WiMAX/Wi-Fi: Number of used subcarriers per channel (N_FFT - guard sub- Nullable: Yes
carriers - DC subcarrier). Default: 200
LPWA: Effective used bandwidth in Hz.

PRIORITY Short Permutation zone priority. 0=Lowest. Nullable: Yes


Default: 0

QUALITY_THRESHOLD Float Minimum signal quality required for coverage. Unit: dB. Nullable: Yes
Default: -5

SC_GROUPS_SEG0 Short WiMAX: Subchannel groups used by segment 0. Nullable: Yes


Wi-Fi/LPWA: Not applicable Default: 3
SC_GROUPS_SEG1 Short WiMAX: Subchannel groups used by segment 1. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default: 12

SC_GROUPS_SEG2 Short WiMAX: Subchannel groups used by segment 2. Nullable: Yes


Wi-Fi/LPWA: Not applicable Default: 48

SUBCHANNEL_ALLOC_MODE Short WiMAX: Subchannel allocation mode. 0=PUSC DL; 1=FUSC; 2=OFUSC; Nullable: Yes
3=AMC; 4=TUSC 1; 5=TUSC 2; 6=PUSC UL; 7=OPUSC. Default: 0
Wi-Fi/LPWA: Not applicable

SUBFRAME Short Whether the permutation zone belongs to the downlink or uplink subframe. Nullable: No
0=DL; 1=UL. Default: 0

ULSC_GROUPS_SEG0 Text (255) WiMAX: Uplink subchannels belonging to segment 0 of the cell. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default:
ULSC_GROUPS_SEG1 Text (255) WiMAX: Uplink subchannels belonging to segment 1 of the cell. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default:

ULSC_GROUPS_SEG2 Text (255) WiMAX: Uplink subchannels belonging to segment 2 of the cell. Nullable: Yes
Wi-Fi/LPWA: Not applicable Default:

ZONE_ID Short Permutation zone identifier. 0 to 7 for DL; 8 to 10 for UL. Nullable: No
Default: 0

9.2.16 PropagationModels Table

For propagation models.

© 2018 Forsk. All Rights Reserved. 297


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

DATA Binary Propagation model parameter settings. Nullable: Yes


Default:

DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:
NAME Text (50) Name of the propagation model. Nullable: No
Default:

SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

TYPE Text (50) ProgID of the model. Nullable: No


Default:

9.2.17 QualityIndicators Table

For quality indicators (BER, BLER, etc.).

Field Type Description Attributes

CS_QI Boolean Whether the quality indicator is used for circuit-switched services or not. Nullable: No
True=Yes; False=No. Default: True

MEAS_PARAM Short Measurement on which the quality indicator is based. 1=C; 2=CIR. Nullable: Yes
Default: 0

NAME Text (50) Name of the quality indicator. Nullable: No


Default:
PS_QI Boolean Whether the quality indicator is used for packet-switched services or not. Nullable: No
True=Yes; False=No. Default: True

USE_INTERPOLATION Boolean Whether interpolation can be used for the quality indicator graph to find val- Nullable: No
ues between defined ones. True=Yes; False=No. Default: True

9.2.18 Receivers Table

For receiver parameters.

Field Type Description Attributes

ANTENNA Text (50) Antenna model of the default receiver. If not defined, an isotropic receiver is Nullable: Yes
used. Default:

HEIGHT Float Height of the default receiver. Nullable: No


Default: 1.5
LOSS Float Receiver equipment uplink and downlink losses. Unit: dB. Nullable: No
Default: 0.

NAME Text (50) Name of the default receiver. Nullable: No


Default:

9.2.19 RepeaterEquipments Table

For repeater equipment.

298 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the repeater equipment. Nullable: Yes
Default:

MANUFACTURER Text (50) Name of the repeater equipment manufacturer. Nullable: Yes
Default:
MAX_AMPLIFIER_GAIN Float Maximum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 90

MAX_OUTPUT_DL Float Maximum downlink output power. Nullable: Yes


Default: 30

MAX_OUTPUT_UL Float Maximum uplink output power. Nullable: Yes


Default: 12
MIN_AMPLIFIER_GAIN Float Minimum gain of the amplifier. Unit: dB. Nullable: Yes
Default: 50

NAME Text (50) Name of the repeater equipment. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the repeater equipment. Unit: dB. Nullable: Yes
Default: 5
STEP_AMPLIFIER_GAIN Float Step of amplifier gain. Unit: dB. Nullable: Yes
Default: 1

TIME_DELAY Float Processing delay of the repeater equipment. Unit: us. Nullable: Yes
Default: 5

9.2.20 Repeaters Table

For repeaters.

Field Type Description Attributes

AMPLIFIER_GAIN Float Repeater amplifier gain. Unit: dB. Nullable: Yes


Default: 80

AZIMUT Float Azimuth of the donor side antenna. Nullable: Yes


Default: 0
DONOR_CELLID Text (100) Name of the donor transmitter. Nullable: No
Default:

DONOR_LINK_LOSS Float Loss over the donor-repeater link. Unit: dB. Nullable: Yes
Default: 0

DONOR_LINK_TYPE Short Type of the donor-repeater link. 1=Off air; 2=Microwave; 3=Fibre. Nullable: No
Default: 1
DONOR_PROPAG_MODEL Text (50) Name of the propagation model used for the donor-repeater link. Nullable: Yes
Default:

DOWNTILT Float Downtilt of the donor side antenna. Nullable: Yes


Default: 0

EQUIPMENT_NAME Text (50) Name of the repeater equipment. Passive repeaters do not have equipment Nullable: Yes
(no amplification). Default:
FEEDER_NAME Text (50) Name of the donor side feeder. Nullable: Yes
Default:

FEEDERLENGTH Float Length of donor side downlink feeder. Nullable: Yes


Default: 0

HEIGHT Float Height of the donor side antenna. Nullable: Yes


Default: 25

© 2018 Forsk. All Rights Reserved. 299


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

REC_ANTENNA Text (50) Name of the donor side antenna model. Nullable: Yes
Default:

REC_FEEDERLENGTH_UL Float Length of donor side uplink feeder. Nullable: Yes


Default: 0

TOTAL_GAIN Float Total gain of the repeater. Unit: dB. Nullable: Yes
Default: 0
TX_ID Text (50) Name of the repeater. Nullable: No
Default:

 Repeater properties are saved in two tables: the donor-side parameters are in the
Repeaters table and the coverage-side parameters in the Transmitters table.

9.2.21 Schedulers Table

For schedulers.

Field Type Description Attributes


BEARER_SELECTION Short Bearer selection criterion. 0=Bearer Index; 1=Peak RLC Throughput; 2=Effec- Nullable: Yes
tive RLC Throughput. Default: 0

NAME Text (30) Name of the scheduler. Nullable: No


Default:

QOS_BIAS_FACTOR Float Bias factor used by the biased scheduling method. Nullable: No
Default: 0

SCHEDULING_METHOD Short Scheduling method. 0=Proportional Fair; 1=Proportional Demand; 2=Biased Nullable: Yes
(QoS Class); 3=Max Aggregate Throughput. Default: 0
TARGET_THROUGHPUT_DAT Short Target throughput when scheduling data services. 0=Peak MAC Throughput; Nullable: Yes
A 1=Effective MAC Throughput; 2=Application Throughput. Default: 0

TARGET_THROUGHPUT_VOIC Short Target throughput when scheduling voice services. 0=Peak MAC Through- Nullable: Yes
E put; 1=Effective MAC Throughput; 2=Application Throughput. Default: 0

UL_BW_ALLOCATION Short Target for the uplink bandwidth allocation process. 0=Full Bandwidth; Nullable: Yes
1=Maintain Connection; 2=Best Bearer. Default: 2

9.2.22 SecondaryAntennas Table

For additional antennas.

Field Type Description Attributes


ANTENNA Text (50) Name of the secondary antenna model installed on a transmitter. Nullable: No
Default:

AZIMUT Float Azimuth of the secondary antenna. Nullable: No


Default: 0

300 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

PERCENT_POWER Float Percentage of power dedicated to the secondary antenna. Unit: %. Nullable: No
Default: 0

REDT Float Remote electrical tilt of the secondary antenna. Nullable: Yes
Default: 0

TILT Float Mechanical downtilt of the secondary antenna. Nullable: No


Default: 0
TX_ID Text (100) Name of the transmitter on which the secondary antenna is installed. Nullable: No
Default:

9.2.23 Sites Table

For sites.

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

ALTITUDE Float User-defined site altitude. Nullable: Yes


Default:
COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0

MAX_BH_RATE_DL Float Maximum downlink backhaul throughput. Unit: kbps. Nullable: Yes
Default: 950000
MAX_BH_RATE_UL Float Maximum downlink backhaul throughput. Unit: kbps. Nullable: Yes
Default: 950000

NAME Text (50) Name of the site. Nullable: No


Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50
SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default: 0

9.2.24 SitesLists Table

For sites belonging to site lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the site list. Nullable: No


Default:

SITE_NAME Text (50) Name of the sites belonging to the list. Nullable: No
Default:

© 2018 Forsk. All Rights Reserved. 301


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

9.2.25 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

9.2.26 SmartAntennas Table

For smart antenna equipment.

Field Type Description Attributes

BROADCAST_ANTENNA Text (50) Broadcast (main) antenna model of the smart antenna. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the smart antenna. Nullable: Yes
Default:
NAME Text (50) Name of the smart antenna. Nullable: No
Default:

SA_MODEL Text (50) Name of the smart antenna model used. Nullable: Yes
Default:

9.2.27 SmartAntennasModels Table

For smart antenna models.

Field Type Description Attributes

SA_DATA Binary Smart antenna model parameter settings. Nullable: Yes


Default:

SA_DESCRIPTION Text (50) Additional information about the smart antenna model. Nullable: Yes
Default:
SA_NAME Text (50) Name of the smart antenna model. Nullable: No
Default:

SA_SIGNATURE Text (50) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

SA_TYPE Text (50) ProgID of the model. Nullable: No


Default:

9.2.28 TMAEquipments Table

For tower-mounted amplifiers.

302 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

DL_LOSSES Float Downlink losses of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the tower mounted amplifier. Nullable: No


Default:
NOISE_FIGURE Float Noise figure of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

UL_GAIN Float Uplink gain of the tower mounted amplifier. Unit: dB. Nullable: Yes
Default: 0

9.2.29 TplTransmitters Table

For station templates.

Field Type Description Attributes

ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No


Default:
AMS_THRESHOLD Float Adaptive MIMO switching threshold. Unit: dB. Nullable: Yes
Default:

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: No
Default:

AZIMUT Float Azimuth of the main antenna. Nullable: Yes


Default:
BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes
Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default:

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:

CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default:

CHANNEL_LIST Text(255) List of channels used by the transmitters. Nullable: Yes


Default:
COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:

DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes


Default:

DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default:
FBAND Text (50) Name of the frequency band used by the cell. Nullable: No
Default:

FEEDER_NAME Text (50) Name of the feeder equipment. Nullable: Yes


Default:

FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes


Default:

© 2018 Forsk. All Rights Reserved. 303


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default:

FRAME_CONFIG Text (50) Name of the cell's frame configuration. Nullable: Yes
Default:

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default:
IDLE_PILOT_POWER_OFFSET Float Pilot power with respect to the preamble power during the empty part of the Nullable: Yes
frame. Unit: dB. Default:

LAYER_LIST Text (255) List of layers. Nullable: Yes


Default: 0

MAX_DL_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default:
MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default:

MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes


Default:
MAX_UL_LOAD Float Maximum traffic load allowed on the uplink. Unit: %. Nullable: Yes
Default:

MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default:

MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default:

MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes


Default:
MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes
Default:

NAME Text (50) Name of the station template. Nullable: No


Default:

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default:
NOISE_RISE_UL Float Uplink noise rise. Unit: dB. Nullable: Yes
Default:

NOISE_RISE_UL_SEG Float Uplink noise rise for the segmented permutation zone. Unit: dB. Nullable: Yes
Default:

NUM_SECTORS Integer Number of sectors in the station template. Nullable: No


Default:
PI_DOMAIN_NAME Text (50) Name of the preamble index domain. Nullable: Yes
Default:

PI_LIST Text(255) List of preamble indexes used by transmitters. Nullable: Yes


Default:

PI_REUSE_MIN_DIST Float The minimum reuse distance for resource allocation by the AFP. Nullable: Yes
Default:
PILOT_POWER_OFFSET Float Offset with respect to the preamble power for determining the pilot power Nullable: Yes
during the loaded part of the frame. Unit: dB. Default:

POWER Float Transmission power. Nullable: Yes


Default:

PREAMBLE_QUALITY_THRES Float Minimum required preamble C/N for coverage. Unit: dB. Nullable: Yes
Default:

304 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

PROPAG_MODEL Text (255) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:

PROPAG_MODEL2 Text (255) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default:
RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default:

SA_NAME Text (50) Name of the smart antenna. Nullable: Yes


Default:

SCHEDULER Text (30) Scheduler used by the cell. Nullable: Yes


Default:
SEGMENTATION_USAGE Float Percentage of the downlink traffic located on the cell-edge. Unit: %. Nullable: Yes
Default:

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:
SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes
Default: 0

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default:

TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TRAFFIC_POWER_OFFSET Float Offset with respect to the preamble power for determining the traffic power. Nullable: Yes
Unit: dB. Default:
TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default:

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default:

UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes


Default:
UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default:

WEQUIPMENT Text (50) Name of the reception equipment associated with the cell. Nullable: Yes
Default:

9.2.30 Transmitters Table

For transmitters.

© 2018 Forsk. All Rights Reserved. 305


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

ABS_X Double Absolute transmitter coordinate on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute transmitter coordinate on the Y axis (latitude). Nullable: Yes
Default:
ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No
Default: True

ANTENNA_NAME Text (50) Name of the main antenna model installed on the transmitter. Nullable: Yes
Default:

AZIMUT Float Azimuth of the main antenna. Nullable: Yes


Default: 0
BTS_NAME Text (50) Name of the transmitter equipment. Nullable: Yes
Default:

CALC_RADIUS Integer Calculation radius of the main path loss matrices. Nullable: Yes
Default: 4000

CALC_RADIUS2 Integer Calculation radius of the extended path loss matrices. Nullable: Yes
Default:
CALC_RESOLUTION Integer Calculation resolution of the main path loss matrices. Nullable: Yes
Default: 50

CALC_RESOLUTION2 Integer Calculation resolution of the extended path loss matrices. Nullable: Yes
Default:

CELL_SIZE Float Hexagon radius. Nullable: Yes


Default: 2000
COMMENT_ Text (255) Additional information about the transmitters. Nullable: Yes
Default:
DX Float X coordinate relative to the site location. Nullable: Yes
Default: 0

DY Float X coordinate relative to the site location. Nullable: Yes


Default: 0

FEEDER_NAME Text (50) Name of the feeder. Nullable: Yes


Default:
FEEDERLENGTH_DL Float Length of downlink feeder. Nullable: Yes
Default: 0

FEEDERLENGTH_UL Float Length of uplink feeder. Nullable: Yes


Default: 0

HEIGHT Float Antenna height above the ground. Nullable: Yes


Default: 25
HEXAGON_GROUP Text (50) Group of hexagons used to create the transmitter. Nullable: Yes
Default:

MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default: 1

MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default: 1
MISCDLL Float Miscellaneous downlink losses. Unit: dB. Nullable: Yes
Default: 0

MISCULL Float Miscellaneous uplink losses. Unit: dB. Nullable: Yes


Default: 0

NOISE_FIGURE Float Noise figure of the transmitter. Unit: dB. Nullable: Yes
Default: 5
PROPAG_MODEL Text (50) Name of the propagation model used to calculate the main path loss matri- Nullable: Yes
ces. Default:

306 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

PROPAG_MODEL2 Text (50) Name of the propagation model used to calculate the extended path loss Nullable: Yes
matrices. Default:

REDT Float Remote electrical tilt of the main antenna. Nullable: Yes
Default: 0

RXLOSSES Float Losses on the uplink due to equipment. Unit: dB. Nullable: Yes
Default: 0
SA_NAME Text (50) Name of the smart antenna. Nullable: Yes
Default:

SHAREDMAST Text (50) Shared mast name for antenna sharing between transmitters. Nullable: Yes
Default:

SHAREDPATTERN Text (50) Shared antenna pattern name for antenna model sharing between transmit- Nullable: Yes
ters. Default:
SIDE_TILT Float Mechanical side-tilt of the main antenna. Nullable: Yes
Default: 0

SITE_NAME Text (60) Name of the site on which the transmitter is located. Nullable: No
Default:

TILT Float Mechanical downtilt of the main antenna. Nullable: Yes


Default: 0
TMA_NAME Text (50) Name of the tower mounted amplifier. Nullable: Yes
Default:

TX_ID Text (100) Name of the transmitter. Nullable: No


Default:

TX_TYPE Short Type of transmitter. 0=Intra-network (server and interferer); 1=Inter-network Nullable: Yes
(interferer only). Default: 0

TXLOSSES Float Losses on the downlink due to equipment. Unit: dB. Nullable: Yes
Default: 0
USE_ABS_XY Short Whether to use the absolute transmitter coordinates (ABS_X, ABS_Y) or Nullable: No
transmitter location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

9.2.31 TxsLists Table

For transmitters belonging to transmitter lists.

Field Type Description Attributes

LIST_NAME Text (50) Name of the transmitter list. Nullable: No


Default:

TX_NAME Text (100) Name of the transmitters belonging to the list. Nullable: No
Default:

9.2.32 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

NAME Text (50) Name of the transmitter list. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 307


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

9.2.33 Units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, and the
database internal coordinate system.

Field Type Description Attributes

COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes


Default: -1

GAIN_UNIT Integer Unit used for gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0

PROJECTION Integer Projection coordinate system of the document. Nullable: Yes


Default: -1
RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0

TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No


Default: 0

9.2.34 WBearerQualityCurves Table

For bearer performance graphs.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: No


Default: 0
MOBILITY Text (50) Mobility type corresponding to the bearer quality graphs. Nullable: Yes
Default:

QI_CURVE Memo Quality indicator graph as function of C/I. Nullable: Yes


Default:

QI_NAME Text (50) Name of the quality indicator. Nullable: No


Default:

RX_EQUIP Text (50) Reception equipment corresponding to the quality indicator graph. Nullable: No
Default:

9.2.35 WBearers Table

For bearers.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: No


Default: 1

CODING_RATE Float Coding rate. Nullable: Yes


Default: 1

MODULATION Short Modulation. 0=BPSK; 1=QPSK; 2=16QAM; 3=64QAM. Nullable: No


Default: 1
NAME Text (50) Name of the radio bearer. Nullable: No
Default:

SPECTRAL_EFFICIENCY Float Bearer spectral efficiency. Unit: bps/Hz. Nullable: Yes


Default: 0

308 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

9.2.36 WBearersRequiredCI Table

For bearer selection thresholds.

Field Type Description Attributes

BEARERS_REQUIRED_COVERI Memo Required quality for selecting a bearer. Nullable: Yes


Default:

MOBILITY Text (50) Mobility type corresponding to the bearer selection thresholds. Nullable: Yes
Default:

RX_EQUIP Text (50) Reception equipment corresponding to the bearer selection thresholds. Nullable: No
Default:

9.2.37 WCCHDivGains Table

For control channel diversity gains.

Field Type Description Attributes

EQUIPMENT Text (50) Name of the reception equipment corresponding to the control channel diver- Nullable: No
sity gains. Default:

MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default: 1

MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default: 1
MOBILITY Text (50) Mobility type corresponding to the control channel diversity gains. Nullable: Yes
Default:

PREAMBLE_DIV_GAIN Float Preamble diversity gain. Unit: dB. Nullable: Yes


Default: 0

9.2.38 WCells Table

For cells.

Field Type Description Attributes

AAS_RESULTS Binary Angular distributions of interference. Nullable: Yes


Default:

AAS_USAGE Float Percentage of downlink traffic load carried by the smart antenna. Unit: %. Nullable: Yes
Default: 50
ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No
Default: True

AMS_THRESHOLD Float Adaptive MIMO switching threshold. Unit: dB. Nullable: Yes
Default:

BSID Text (50) Base station identity. Nullable: Yes


Default:
CELL_ID Text (100) Name of the cell. Nullable: No
Default:

CELL_PERMBASE Short Cell PermBase (zone permbase of the first downlink PUSC zone). Nullable: Yes
Default: 0

CHANNEL Integer Channel number. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 309


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

CHANNEL_STATUS Short Channel allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0

COMMENT_ Text (255) Additional information about the cell. Nullable: Yes
Default:

DL_LOAD Float Downlink traffic load. Unit: %. Nullable: Yes


Default: 1
DL_ZONE_PB Integer Downlink zone permbase. Nullable: Yes
Default:

DL_ZONE_PB_STATUS Short Downlink zone permbase allocation status. 0=Not allocated; 1=Allocated; Nullable: Yes
2=Locked. Default: 0

DOWNLINK_EXTERNAL_NOIS Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
E_RISE Default: 0
FBAND Text (50) Name of the frequency band used by the cell. Nullable: No
Default:

FRAME_CONFIG Text (50) WiMAX/Wi-Fi: Name of the cell's frame configuration. Nullable: Yes
LPWA: Name of the cell's channel configuration. Default:

IDLE_PILOT_POWER_OFFSET Float Pilot power with respect to the preamble power during the empty part of the Nullable: Yes
frame. Unit: dB. Default: 10
LOCKED_SEGMENT Short Allocation status of the segment for automatic allocation. 0=Unlocked; Nullable: Yes
1=Locked. Default: 0

MAX_DL_LOAD Float Maximum traffic load allowed on downlink. Unit: %. Nullable: Yes
Default: 100

MAX_EXT_NEIGHB_NUMBER Integer Maximum number of inter-technology neighbours for the cell. Nullable: Yes
Default:

MAX_NEIGHB_NUMBER Integer Maximum number of intra-technology neighbours for the cell. Nullable: Yes
Default:
MAX_NUMBER_OF_USERS Integer Maximum number of served users. Nullable: Yes
Default:

MAX_UL_LOAD Float Maximum traffic load allowed on the uplink. Unit: %. Nullable: Yes
Default: 100

NOISE_RISE_UL Float Uplink noise rise. Unit: dB. Nullable: Yes


Default: 0
NOISE_RISE_UL_SEG Float Uplink noise rise for the segmented permutation zone. Unit: dB. Nullable: Yes
Default: 0

NUM_DL_USERS Float Number of users connected on the downlink. Nullable: Yes


Default: 1

NUM_UL_USERS Float Number of users connected on the uplink. Nullable: Yes


Default: 1
PI_DOMAIN_NAME Text (50) Name of the preamble index domain. Nullable: Yes
Default:

PI_REUSE_MIN_DIST Float The minimum reuse distance for resource allocation by the AFP. Nullable: Yes
Default:

PI_STATUS Short Preamble index allocation status. 0=Not allocated; 1=Allocated; 2=Locked. Nullable: Yes
Default: 0
PILOT_POWER_OFFSET Float Offset with respect to the preamble power for determining the pilot power Nullable: Yes
during the loaded part of the frame. Unit: dB. Default: 0

POWER Float WiMAX: Preamble power. Nullable: Yes


Wi-Fi/LPWA: Transmission power. Default: 43

PREAMBLE_INDEX Integer Preamble index of the cell. Nullable: Yes


Default: 0

310 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

PREAMBLE_QUALITY_THRES Float Minimum required preamble C/N for coverage. Unit: dB. Nullable: Yes
Default: -4

RANK Short Index of the network layer. Nullable: Yes


Default:

SCHEDULER Text (30) Scheduler used by the cell. Nullable: Yes


Default:
SEGMENT Short Cell segment. 0; 1; 2. Nullable: Yes
Default: 0

SEGMENTATION_USAGE Float Percentage of the downlink traffic located on the cell-edge. Unit: %. Nullable: Yes
Default: 50

TRAFFIC_POWER_OFFSET Float Offset with respect to the preamble power for determining the traffic power. Nullable: Yes
Unit: dB. Default: 3
TX_CELL_ORDER Short Order of the cell within a transmitter. Nullable: Yes
Default:

TX_ID Text (100) Name of the transmitter to which the cell belongs. Nullable: No
Default:

UL_LOAD Float Uplink traffic load. Unit: %. Nullable: Yes


Default: 1
UL_MU_SM_GAIN Float Average number of co-scheduled MU-MIMO users. Nullable: Yes
Default: 2

UL_ZONE_PB Integer Uplink zone permbase. Nullable: Yes


Default:

UL_ZONE_PB_STATUS Short Uplink zone permbase allocation status. 0=Not allocated; 1=Allocated; Nullable: Yes
2=Locked. Default: 0

UPLINK_EXTERNAL_NOISE_RI Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
SE Default: 0
WEQUIPMENT Text (50) Name of the reception equipment associated with the cell. Nullable: Yes
Default:

9.2.39 WEnvironmentDefs Table

For traffic environment types.

Field Type Description Attributes

DENSITY Float Number of users per km2. Nullable: Yes


Default: 0

ENVIRONMENT Text (50) Name of the traffic environment. Nullable: No


Default:
MOBILITY Text (50) Mobility type corresponding to the traffic environment. Nullable: No
Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the traffic environment. Nullable: No
Default:

9.2.40 WEquipments Table

For reception equipment.

© 2018 Forsk. All Rights Reserved. 311


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

NAME Text (50) Name of the reception equipment. Nullable: No


Default:

9.2.41 WLayers Table

For network layers.

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer. Nullable: No


Default: 0
MAX_SPEED Float Maximum user speed supported by the layer. Unit: km/h. Nullable: Yes
Default: 300

NAME Text (50) Name of the network layer. Nullable: No


Default:

PRIORITY Short Layer priority. 0=Lowest. Nullable: No


Default: 0

9.2.42 WMimoConfigs Table

For MIMO gain graphs.

Field Type Description Attributes

BEARER_INDEX Short Bearer index. Nullable: Yes


Default: 1

MAX_BLER Float Maximum value of BLER for which the gains are applicable. Nullable: Yes
Default: 1

MAX_MIMO_GAIN Memo Maximum MIMO gain graphs as function of C/(I+N). Nullable: Yes
Default:

MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default: 1
MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default: 1

MOBILITY Text (50) Mobility type corresponding to the MIMO gain graph. Nullable: Yes
Default:

MUMIMO_DIV_GAIN Float Diversity gain applicable with MU-MIMO. Unit: dB. Nullable: Yes
Default: 0
STTD_GAIN Float Traffic diversity gain. Unit: dB. Nullable: Yes
Default: 0

SUBCHANNEL_ALLOC_MODE Short Subchannel allocation mode. 0=PUSC DL; 1=FUSC; 2=OFUSC; 3=AMC; Nullable: Yes
4=TUSC 1; 5=TUSC 2; 6=PUSC UL; 7=OPUSC. Default: 8

SUMIMO_DIV_GAIN Float Traffic diversity gain applicable with SU-MIMO. Unit: dB. Nullable: Yes
Default: 0
WEQUIPMENT Text (50) Reception equipment corresponding to the MIMO gain graph. Nullable: No
Default:

312 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

9.2.43 WMobility Table

For mobility types.

Field Type Description Attributes

MEAN_SPEED Float Average user speed corresponding to the mobility type. Unit: km/h. Nullable: Yes
Default: 0

NAME Text (50) Name of the mobility type. Nullable: No


Default:

9.2.44 WPIDomains Table

For preamble index domains.

Field Type Description Attributes

DOMAIN_NAME Text (50) Name of the preamble index domain. Nullable: No


Default:

9.2.45 WPIGroups Table

For preamble index groups.

Field Type Description Attributes


DOMAIN_NAME Text (50) Name of the preamble index domain. Nullable:
Default:

EXCLUDED Text (225) List of preamble indexes not belonging to the group. Nullable: Yes
Default:

EXTRA Text (225) List of additional preamble indexes belonging to the group. Nullable: Yes
Default:

FIRST Integer First preamble index belonging to the group. Nullable: Yes
Default: 0
LAST Integer Last preamble index belonging to the group. Nullable: Yes
Default: 0

NAME Text (50) Name of the preamble index group. Nullable: No


Default:

STEP Integer Step between the first and last preamble index belonging to the group. Nullable: Yes
Default: 1

9.2.46 WServices Table

For services.

© 2018 Forsk. All Rights Reserved. 313


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

BODY_LOSS Float Body loss. Unit: dB. Nullable: No


Default: 0

DL_ACTIVITY Float Activity factor for voice services on the downlink. Nullable: Yes
Default: 1
DL_DP Float Inter-packet arrival time on the downlink. Unit: ms. Nullable: Yes
Default: 0

DL_DPC Float Reading time between two packet calls on the downlink. Unit: ms. Nullable: Yes
Default: 0

DL_HIGHEST_BEARER Float The highest bearer that can be used by the service in downlink. Nullable: Yes
Default: 8
DL_LOWEST_BEARER Short The lowest bearer that can be used by the service in downlink. Nullable: Yes
Default: 1

DL_MAXIMUM_LATENCY Float Maximum latency in downlink. Unit: ms. Nullable: Yes


Default: 0

DL_MRTR Float Downlink guaranteed bit rate. Unit: kbps. Nullable: No


Default: 0
DL_MSTR Float Downlink maximum bit rate. Unit: kbps. Nullable: No
Default: 0

DL_NPC Integer Number of packet calls during a session on the downlink. Nullable: Yes
Default: 1

DL_SP Integer Packet size on the downlink. Unit: Byte. Nullable: Yes
Default: 1500
DL_SPC_MAX Float Maximum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 2000
DL_SPC_MIN Float Minimum packet call size on the downlink. Unit: kB. Nullable: Yes
Default: 4

MAXIMUM_BLOCKING_PROB Integer Maximum probability of blocking (or delay). Nullable: Yes


A Default: 0

MIN_SC_UL Integer Minimum number of required subchannels for the service. Nullable: Yes
Default: 1
NAME Text (50) Name of the service. Nullable: No
Default:

PRIORITY Short Service priority. 0=Lowest. Nullable: Yes


Default: 0

QOS_CLASS Short WiMAX: QoS class. 0=UGS; 1=rtPS; 2=ErtPS; 3=nrtPS; 4=Best Effort. Nullable: Yes
Wi-Fi/LPWA: Not applicable. Must be set to 1. Default: 0
REQ_AVERAGE_DL_RATE Float Average requested throughput on the downlink. Unit: kbps. Nullable: Yes
Default:

REQ_AVERAGE_UL_RATE Float Average requested throughput on the uplink. Unit: kbps. Nullable: Yes
Default:

SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the service. Nullable: No
Default: “-1”
TH_OFFSET Float Fixed offset to map throughput to the application layer. Nullable: No
Default: 0

TH_SCALE_FACTOR Float Ratio between application throughput and MAC layer throughput. Nullable: No
Default: 95

TYPE Short Type of service. 0=Voice; 1=Data. Nullable: Yes


Default: 0
UL_ACTIVITY Float Activity factor for voice services on the uplink. Nullable: Yes
Default: 1

314 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

UL_DP Float Inter-packet arrival time on the uplink. Unit: ms. Nullable: Yes
Default: 0

UL_DPC Float Reading time between two packet calls in uplink. Unit: ms. Nullable: Yes
Default: 0

UL_HIGHEST_BEARER Float Highest bearer allowed to be used for the service in uplink. Nullable: Yes
Default: 4
UL_LOWEST_BEARER Short Lowest bearer allowed to be used for the service in uplink. Nullable: Yes
Default: 1

UL_MAXIMUM_LATENCY Float Maximum latency in uplink. Unit: ms. Nullable: Yes


Default: 0

UL_MRTR Float Uplink guaranteed bit rate. Unit: kbps. Nullable: No


Default: 0
UL_MSTR Float Uplink maximum bit rate. Unit: kbps. Nullable: No
Default: 0

UL_NPC Integer Reading time between two packet calls on the uplink. Unit: ms. Nullable: Yes
Default: 1

UL_SP Integer Packet size on the uplink. Unit: Byte. Nullable: Yes
Default: 1500
UL_SPC_MAX Float Maximum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 2000

UL_SPC_MIN Float Minimum packet call size on the uplink. Unit: kB. Nullable: Yes
Default: 4

9.2.47 WServicesUsage Table

For user profile parameters.

Field Type Description Attributes

CALL_DURATION Float Average duration of a call for circuit-switched services. Unit: s. Nullable: Yes
Default:

CALL_NUMBER Float Average number of calls per hour for circuit-switched services or average Nullable: Yes
number of sessions per hour for packet-switched services. Default: 0
DL_VOLUME Float Data volume transferred on the downlink during a session for packet- Nullable: Yes
switched services. Unit: kB. Default:

SERVICE Text (50) Name of the service corresponding to the user profile. Nullable: No
Default:

TERMINAL Text (50) Name of the terminal corresponding to the user profile. Nullable: No
Default:
UL_VOLUME Float Data volume transferred on the uplink during a session for data services. Unit: Nullable: Yes
kB. Default:

USER_PROFILE Text (50) Name of the user profile corresponding to the user profile. Nullable: No
Default:

9.2.48 WTerminals Table

For terminal types.

© 2018 Forsk. All Rights Reserved. 315


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

ANTENNA Text (50) Name of the antenna model of the terminal. Nullable: Yes
Default:

DIVERSITY_SUPPORT Short The type of antenna diversity supported by the terminal. 0=None; 1=AAS; Nullable: Yes
2=MIMO; 3=AAS+MIMO. Default: 1
GAIN Float Terminal antenna gain. Unit: dB. Nullable: Yes
Default: 0

LOSS Float Terminal antenna loss. Unit: dB. Nullable: Yes


Default: 0

MIMO_RX_ANTENNAS Short Number of reception antennas used for MIMO. Nullable: Yes
Default: 1
MIMO_TX_ANTENNAS Short Number of transmission antennas used for MIMO. Nullable: Yes
Default: 1

NAME Text (50) Name of the terminal. Nullable: No


Default:

NOISE_FACTOR Float Noise figure of the terminal. Unit: dB. Nullable: Yes
Default: 8
PMAX Float Maximum transmission power of the terminal. Nullable: Yes
Default: 23

PMIN Float Minimum transmission power of the terminal. Nullable: Yes


Default: -22

RX_EQUIP Text (50) Name of the reception equipment associated with the terminal. Nullable: Yes
Default:
SUPPORTED_LAYER_LIST Text (50) List of network layer indexes supported by the terminal. Nullable: No
Default: “-1”

9.2.49 WTraficEnvironments Table

For traffic environment clutter weighting.

Field Type Description Attributes

CLUTTER_WEIGHTS Binary Clutter weighting for traffic environment maps. Nullable: Yes
Default:

NAME Text (50) Name of the traffic environment. Nullable: No


Default:

9.2.50 WUserProfiles Table

For names of user profiles.

Field Type Description Attributes

NAME Text (50) Name of the user profile. Nullable: No


Default:

316 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

9.3 Relationships

Many-to-One Relationships (  1)

MUGTables.MOBILITY WMobility.NAME

MUGTables.SCHEDULER_NAME Schedulers.NAME
Neighbours.NEIGHBOUR WCells.CELL_ID

Neighbours.TRANSMITTER WCells.CELL_ID

NeighboursConstraints.NEIGHBOUR WCells.CELL_ID
NeighboursConstraints.TRANSMITTER WCells.CELL_ID

NeighboursConstraintsExt.TRANSMITTER WCells.CELL_ID

NeighboursExt.TRANSMITTER WCells.CELL_ID
Networks.DEFAULT_MODEL PropagationModels.NAME

PermutationZones.FRAME_CONFIG FrameConfigurations.NAME

Receivers.ANTENNA Antennas.NAME

Repeaters.DONOR_CELLID Transmitters.TX_ID
Repeaters.DONOR_PROPAG_MODEL PropagationModels.NAME

Repeaters.EQUIPMENT_NAME RepeaterEquipments.NAME

Repeaters.FEEDER_NAME FeederEquipments.NAME

Repeaters.REC_ANTENNA Antennas.NAME

Repeaters.TX_ID Transmitters.TX_ID

SecondaryAntennas.ANTENNA Antennas.NAME

SecondaryAntennas.TX_ID Transmitters.TX_ID

SitesLists.LIST_NAME SitesListsNames.NAME

SitesLists.SITE_NAME Sites.NAME

SmartAntennas.SA_MODEL SmartAntennasModels.SA_NAME

Transmitters.ANTENNA_NAME Antennas.NAME

Transmitters.BTS_NAME BTSEquipments.NAME

Transmitters.FEEDER_NAME FeederEquipments.NAME

Transmitters.PROPAG_MODEL PropagationModels.NAME

Transmitters.PROPAG_MODEL2 PropagationModels.NAME

Transmitters.SA_NAME SmartAntennas.NAME

Transmitters.SITE_NAME Sites.NAME

Transmitters.TMA_NAME TMAEquipments.NAME

TxsLists.LIST_NAME TxsListsNames.NAME

TxsLists.TX_NAME Transmitters.TX_ID

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

WBearerQualityCurves.BEARER_INDEX WBearers.BEARER_INDEX

WBearerQualityCurves.MOBILITY WMobility.NAME

WBearerQualityCurves.QI_NAME QualityIndicators.NAME

WBearerQualityCurves.RX_EQUIP WEquipments.NAME

WBearersRequiredCI.MOBILITY WMobility.NAME

WBearersRequiredCI.RX_EQUIP WEquipments.NAME

WCCHDivGains.EQUIPMENT WEquipments.NAME

WCCHDivGains.MOBILITY WMobility.NAME

© 2018 Forsk. All Rights Reserved. 317


Atoll 3.4.0 Data Structure Reference Guide
Chapter 9: WiMAX, Wi-Fi, and LPWA Data Structures

Many-to-One Relationships (  1)

WCells.FBAND FrequencyBands.NAME

WCells.FRAME_CONFIG FrameConfigurations.NAME

WCells.PI_DOMAIN_NAME WPIDomains.DOMAIN_NAME

WCells.RANK WLayers.LAYER_INDEX

WCells.SCHEDULER Schedulers.NAME

WCells.TX_ID Transmitters.TX_ID

WCells.WEQUIPMENT WEquipments.NAME

WEnvironmentDefs.ENVIRONMENT WTraficEnvironments.NAME

WEnvironmentDefs.MOBILITY WMobility.NAME

WEnvironmentDefs.USER_PROFILE WUserProfiles.NAME

WMimoConfigs.BEARER_INDEX WBearers.BEARER_INDEX

WMimoConfigs.MOBILITY WMobility.NAME

WMimoConfigs.WEQUIPMENT WEquipments.NAME

WPIGroups.DOMAIN_NAME WPIDomains.DOMAIN_NAME

WServices.DL_HIGHEST_BEARER WBearers.BEARER_INDEX

WServices.DL_LOWEST_BEARER WBearers.BEARER_INDEX

WServices.UL_HIGHEST_BEARER WBearers.BEARER_INDEX

WServices.UL_LOWEST_BEARER WBearers.BEARER_INDEX

WServicesUsage.SERVICE WServices.NAME
WServicesUsage.TERMINAL WTerminals.NAME

WServicesUsage.USER_PROFILE WUserProfiles.NAME

WTerminals.ANTENNA Antennas.NAME
WTerminals.RX_EQUIP WEquipments.NAME

318 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

10 Microwave Links Data Structure


Atoll Microwave enables planning and optimisation of large backhaul networks according to ITU recommendations,
industry standards, and operator-specific design guidelines. This section describes the Microwave Radio Links and
Backhaul data structures used in Atoll. It lists all the tables and fields found in the Backhaul template and the
relationships between them.

 Primary keys are listed in bold and italic characters.

10.1 Data Structure Changes from Atoll 3.3 to 3.4

10.1.1 Added Tables and Fields

MWAntennas Table

Field Type Description Attributes

BEAMWIDTH_H Float Half-power beamwidth of the horizontal pattern. Nullable: Yes


Default:

BEAMWIDTH_V Float Half-power beamwidth of the horizontal pattern. Nullable: Yes


Default:

MWHubs Table

Field Type Description Attributes

ABS_X Double Absolute coordinate of the hub on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute coordinate of the hub on the Y axis (latitude). Nullable: Yes
Default:
SHARED_RADIO Short Whether the hub uses a shared radio or not. 0=False; 1=True. Nullable: Yes
Default: 1

USE_ABS_XY Short Whether to use the absolute hub coordinates (ABS_X, ABS_Y) or hub location Nullable: No
relative to site coordinates (DX, DY). 0=Relative; 1=Absolute. Default: 0

© 2018 Forsk. All Rights Reserved. 319


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

MWLinks Table

Field Type Description Attributes

ABS_X_A Double Absolute X coordinate (longitude) of the link extremity at site A. Nullable: Yes
Default:
ABS_X_B Double Absolute X coordinate (longitude) of the link extremity at site B. Nullable: Yes
Default:

ABS_Y_A Double Absolute Y coordinate (latitude) of the link extremity at site A. Nullable: Yes
Default:

ABS_Y_B Double Absolute Y coordinate (latitude) of the link extremity at site B. Nullable: Yes
Default:
USE_ABS_XY_A Short Whether to use the absolute hub coordinates (ABS_X, ABS_Y) or link extrem- Nullable: No
ity locations relative to site A coordinates (DX, DY). 0=Relative; 1=Absolute. Default: 0

USE_ABS_XY_B Short Whether to use the absolute hub coordinates (ABS_X, ABS_Y) or link extrem- Nullable: No
ity locations relative to site B coordinates (DX, DY). 0=Relative; 1=Absolute. Default: 0

MWMultiHops Table

Field Type Description Attributes

EPO_IP_CLASS Text (50) IP Objective Class of the multihop links. Nullable: Yes
Default:

MWOTLinks Table

Field Type Description Attributes

EPO_IP_CLASS Text (50) IP Objective Class of the other type link. Nullable: Yes
Default:

MWRepeaters Table

Field Type Description Attributes


ABS_X Double Absolute coordinate of the repeater on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute coordinate of the repeater on the Y axis (latitude). Nullable: Yes
Default:

COMMENT_ Text (255) Whether the hub uses a shared radio or not. 0=False; 1=True. Nullable: Yes
Default:
USE_ABS_XY Short Whether to use the absolute repeater coordinates (ABS_X, ABS_Y) or Nullable: No
repeater location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

MWTplHubs Table

Field Type Description Attributes

SHARED_RADIO Short Whether the hub uses a shared radio or not. 0=False; 1=True. Nullable: Yes
Default: 1

Sites Table

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

320 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

10.1.2 Deleted Tables and Fields

None.

10.2 Data Structure

10.2.1 BHNodes Table

Field Type Description Attributes

ACTIVE Boolean Flag to set in the node is in service or not Nullable: No


Default: True

COMMENT_ Text(255) Comment Nullable: Yes


Default:
NAME Text(50) Name of the node Nullable: No
Default:

SITE Text(50) Relative to an existing site (cannot not be null) Nullable: No


Default:

SUBNET Text(50) Name of a subnet (kind of user field, can be null) Nullable: Yes
Default:
TRAFFIC_ETHDL Float Downlink data rate required by this node for packet traffic Nullable: Yes
Default: 0

TRAFFIC_ETHUL Float Uplink data rate required by this node for packet traffic (Ethernet) Nullable: Yes
Default: 0

TRAFFIC_TDM Float Data rate required by this node for circuit traffic (TDM) Nullable: Yes
Default: 0

10.2.2 BHSegments Table

Field Type Description Attributes

COMMENT_ Text(255) Comment Nullable: Yes


Default:

DEST_NODE Text(80) Destination of the segment. Relative to an existing node (cannot be null) Nullable: No
Default:
SOURCE_NODE Text(50) Source of traffic demand on the segment. Relative to an existing node (can- Nullable: No
not be null) Default:

TOPO_FLAG Integer Flag : 0 if "standard", 1 if it belongs to a ring topology Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 321


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

10.2.3 BHSegmentsMedia Table

Field Type Description Attributes

ACTIVE Boolean Flag to set in the medium is in service or not Nullable: No


Default: True
BANDWIDTH_ETH Float Ethernet bandwidth of the backhaul medium. Unit: Mbps. Nullable: Yes
Default: 0

BANDWIDTH_TDM Float TDM bandwidth of the backhaul medium. Unit: Mbps. Nullable: Yes
Default: 0

COMMENT_ Text(255) Comment Nullable: Yes


Default:
DEST_NODE Text(255) Destination of the segment. Relative to an existing node (cannot be null) Nullable: No
Default:

MWLINK Text(120) Medium. Relative to an existing microwave link (can be null) Nullable:
Default:

NUM Integer Short number used to differentiate each medium, whatever MW table is in use Nullable: No
(generated by Atoll) Default: 0
OTHER_TLINK Text(120) Medium. Relative to an existing non-microwave link (can be null) Nullable: Yes
Default:

SOURCE_NODE Text(255) Source of the segment. Relative to an existing node (cannot be null) Nullable: No
Default:

10.2.4 CoordSys Table

For the projection coordinate system and the database’s internal coordinate system (this is the display coordinate
system used when creating a database).

Field Type Description Attributes

CODE Integer Identification code of the coordinate system. User-defined coordinate sys- Nullable: No
tems use codes above 32768. Default: 0

DATUM_CODE Double Identification code of the datum. Nullable: Yes


Default: 0
DATUM_ROTX Double X-axis rotation. Unit: arc-seconds. Nullable: Yes
Default: 0

DATUM_ROTY Double Y-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0

DATUM_ROTZ Double Z-axis rotation. Unit: arc-seconds. Nullable: Yes


Default: 0
DATUM_SCALE Double Datum scale. Unit: parts per million (ppm). Nullable: Yes
Default: 0

DATUM_SHIFTX Double X-axis shift. Unit: m. Nullable: Yes


Default: 0

DATUM_SHIFTY Double Y-axis shift. Unit: m. Nullable: Yes


Default: 0
DATUM_SHIFTZ Double Z-axis shift. Unit: m. Nullable: Yes
Default: 0

ELLIPS_CODE Integer Identification code of the ellipsoid. Nullable: No


Default: 0

ELLIPS_RMAJOR Double Radius of the major axis. Unit: m. Nullable: Yes


Default: 0

322 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

ELLIPS_RMINOR Double Radius of the minor axis. Unit: m. Nullable: Yes


Default: 0

GEO_UNIT Integer Unit of the coordinate system. -1=Undefined; 0=Metre; 1=Kilometre; 2=Foot; Nullable: Yes
3=Link; 4=Chain; 5=Yard; 6=Nautical mile; 7=Mile; 100=Radian; 101=Degree; Default: -1
102=Grad.

NAME Text (50) Name of the coordinate system. Nullable: No


Default:

PROJ_ANGLE Double Angle of projection. Unit: Decimal degrees. Nullable: Yes


Default: 0
PROJ_FALSE_EASTING Double False easting of the projection. Unit: m. Nullable: Yes
Default: 0

PROJ_FALSE_NORTHING Double False northing of the projection. Unit: m. Nullable: Yes


Default: 0

PROJ_FIRST_PARALLEL Double First parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0
PROJ_LATITUDE_ORIGIN Double Latitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_LONGITUDE_ORIGIN Double Longitude of origin of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_METHOD Short Projection method. UTM, Undefined, NoProjection, Lambert1SP, Nullable: Yes
Lambert2SP, Mercator, CassiniSoldner, TransMercator, TransMercatorSO, Default: 0
ObliqueStereographic, NewZealandMapGrid, HotineOM, LabordeOM, Swis-
sObliqueCylindical.

PROJ_SCALE_FACTOR Double Projection scaling. Nullable: Yes


Default: 0

PROJ_SECOND_PARALLEL Double Second parallel of the projection. Unit: Decimal degrees. Nullable: Yes
Default: 0

PROJ_ZONE_NUMBER Integer UTM projection zone number. Nullable: Yes


Default: 0

10.2.5 CustomFields Table

For defining user-defined fields added to tables, default values for any field (including user-defined fields), and
choice lists, captions, and group names for user-defined fields.

Field Type Description Attributes

CAPTION Text (50) Legend of the custom field displayed in the user interface. Nullable: Yes
Default:
CHOICE_LIST Memo Choice list for text fields. Nullable: Yes
Default:

CHOICE_TYPE Integer Whether the field accepts values other than the defined choice list or not. Nullable: Yes
0=Yes; 1=No. Default: 0

COLUMN_NAME Text (50) Name of the custom field. Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 323


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

DEFAULT_VALUE Text (50) Default value for the field. Nullable: Yes
Default:

DISPLAY_TYPE Integer Whether the field is hypertext or regular and modifiable or read-only. Nullable: Yes
0=Regular and modifiable; 1=Regular and read-only; 2=Hypertext and mod- Default: 0
ifiable; 3=Hypertext and read-only
GROUP_NAME Text (255) Name of the group to which the field belongs. Nullable: Yes
Default:

TABLE_NAME Text (50) Name of the table to which the custom field is added. Nullable: No
Default:

These are some general recommendations that you should follow when handling databases.

General
 In order to use Atoll with Oracle, you must create Oracle users and schema with names in uppercase.
 Create backups of the database before upgrading.
 It is recommended to define a rule for making backups of the database at regular intervals.
 Do not skip a major Atoll version. For example, if you are currently using Atoll 3.2.x, you should first upgrade
the database to Atoll 3.3.x before upgrading to Atoll 3.4.0.
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


 Table and field names are case sensitive.
 Table and field names should be not more than 20 characters long.
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.
 Table and field names should only use alphanumeric characters (A-Z, a-z, 0-9) and underscores (_).
 Table and field names must not start with a numeric character (0-9).
 Table and field names must not contain an SQL or RDBMS-specific keyword, such as ORDER, DATE, etc.
 Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks
(!), colons (:), semi-colons (;), interrogation marks (?), parentheses (()), brackets ({}), square brackets ([]), etc.
 Boolean fields, system or user-defined, should always have default values assigned.
 The CustomFields table enables you to define default values, choice lists, and read/write access for any field
in any 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.
 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.
 When setting up your database for the first time, try to anticipate user requirements in terms of custom fields
in 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.
 To improve performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmitters’ names.
 To improve performance, unless absolutely necessary, do not add user-defined fields of Text type. Rather, use
numeric field types, which allow sorting and other functions. If you must add Text fields, allocate them the

324 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

appropriate size that would suffice. For example, a 255-character long Text type field would, for the most part,
occupy disk space for no purpose.
 To improve performance, you should avoid adding custom fields to the neighbour management tables.

10.2.6 MWAntennas Table

For microwave antennas.

Field Type Description Attributes

BEAMWIDTH_H Float Half-power beamwidth of the horizontal pattern. Nullable: Yes


Default:
BEAMWIDTH_V Float Half-power beamwidth of the horizontal pattern. Nullable: Yes
Default:

COMMENT_ Text (255) Additional information about the antenna model. Nullable: Yes
Default:

DIAMETER Float Diameter of the antenna. Nullable: Yes


Default: 5
FREQ_BAND Text (50) Frequency band of the antenna. Nullable: No
Default:

GAIN Float Antenna gain. Unit: dBi. Nullable: Yes


Default: 10

MANUFACTURER Text (50) Manufacturer of the antenna. Nullable: Yes


Default:
NAME Text (50) Name of the antenna model. Nullable: No
Default:

PATTERN Binary Antenna horizontal and vertical patterns. Nullable: Yes


Default:

RADOME_LOSS Float Radome loss. Unit: dB. Nullable: Yes


Default: 0

 The format of the binary field, PATTERN, is described in "Microwave 2D Antenna


Pattern Format" on page 358.

10.2.7 MWBands Table

For microwave frequency bands.

Field Type Description Attributes

COMMENT_ Text (255) Comments Nullable: Yes


Default:

FMAX Double Maximum frequency Nullable: Yes


Default: 200
FMIN Double Minimum frequency Nullable: Yes
Default: 100

NAME Text (50) Name of the frequency band Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 325


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

10.2.8 MWBranchingConfigs Table

For microwave branching configurations.

Field Type Description Attributes

FREQ_DIVERSITY Boolean Flag to check if this configuration supports frequency diversity Nullable: No
Default: False

HSB Boolean Flag to check if this configuration supports hot standby Nullable: No
Default: False

LOS_MIMO Boolean Flag to define if this configuration supports LOS MIMO antennas Nullable: No
Default: False
NAME Text (50) Branching configuration name Nullable: No
Default:

NUM_RX_ANTENNAS Short Number of receiving antennas (for MIMO) Nullable: Yes


Default: 1

NUM_TX_ANTENNAS Short Number of transmitting antennas (for MIMO) Nullable: Yes


Default: 1
SPACE_DIVERSITY Boolean Flag to check if this configuration supports space diversity Nullable: No
Default: False

SYSTEM_CONFIG_M Short Maximum number of standby channels which can be branched Nullable: Yes
Default: 0

SYSTEM_CONFIG_N Short Maximum number of main channels which can be branched Nullable: Yes
Default: 1
XPIC Boolean Flag to check if this configuration supports cross polar cancellation Nullable: No
Default: False

10.2.9 MWCapacities Table

For microwave data rates.

Field Type Description Attributes

AIR_LINK_RATE Float Data rate Nullable: Yes


Default: 0

CAPA_TECHNO Short Capacity configuration: Nullable: No


0 = Full packet; 1 = Hybrid; 2 = TDM only Default: 0

NAME Text (50) Capacity name Nullable: No


Default:
PACKET_SIZE Integer IP packet size. Unit: Bytes. Nullable: Yes
Default: 1500

TDM_RATE Float Value of rate reserved for TDM in Mbps Nullable: Yes
Default:

10.2.10 MWCompatibilities Table

For compatibility mapping between equipment and antennas.

326 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

ANTENNA Text (50) Name of the antenna Nullable: No


Default:

CAPA_TECHNO Short Capacity configuration: Nullable: No


0 = Full packet; 1 = Hybrid; 2 = TDM only Default: 0
COMMENT_ Text (255) Comments Nullable: Yes
Default:

EQUIPMENT Text (50) Name of the equipment Nullable: No


Default:

10.2.11 MWCompatibilitiesGuides Table

For compatibility mapping between wave guides and antennas.

Field Type Description Attributes

ANTENNA Text (50) Name of the antenna Nullable: No


Default:
COMMENT_ Text (255) Comments Nullable: Yes
Default:

GUIDE Text (50) Name of the wave guide Nullable: No


Default:

10.2.12 MWDefaultsCurves Table

For default graphs of transmission and reception masks, etc.

Field Type Description Attributes

BANDWIDTH Float Channel bandwidth Nullable: Yes


Default: 0

CURVE_TYPE Short The type of curve Nullable: Yes


Choice list: 0=TX_MASK; 1=RX_MASK; 2=TtoI; Default: 0
FREQ_BAND Text (50) Frequency band Nullable: No
Default:

INTERFERED Text (50) Nullable: Yes


Default:

MANUFACTURER Text (50) Manufacturer Nullable: Yes


Default:
MODULATION Text (20) Modulation used Nullable: Yes
Default:

NAME Text (50) Name of the curve Nullable: No


Default:

RATE Float Rate (Mbps) Nullable: Yes


Default: 1
VALUES_ Memo Curve values Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 327


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

10.2.13 MWDesignRules Table

For microwave link design rules.

Field Type Description Attributes

COMMENT_ Text (255) Additional information about the design rules. Nullable: Yes
Default:

IDISTMAX Double Maximum distance to look for potential interferer with this band. Nullable: Yes
Default:

LGMAX Double Minimum length of a link that can be created with this band. Nullable: Yes
Default:
LGMIN Double Maximum length of a link that can be created with this band. Nullable: Yes
Default:

NAME Text (50) Name of a frequency band. Nullable: No


Default:

10.2.14 MWEPO Table

For quality and availability performance objectives.

Field Type Description Attributes

A Double Parameter used to calculate the EPO required: Nullable: No


EPO = A * L+B Default: 0
B Double Parameter used to calculate the EPO required: Nullable: No
EPO = A * L+B Default: 0

COMMENT_ Text (255) Comments Nullable: Yes


Default:

EPO_PARAM Text (5) Performance objective parameter (SESR, BBER, or ESR) Nullable: No
Default:

EPO_TYPE Text (1) Performance objective type (yAvailability or Quality) Nullable: No


Default:
LINK_CLASS Text (50) EPO Link class Nullable: No
Default:

MAXIMUM_LENGTH Double Maximum length of link related to an objective (km) Nullable: Yes
Default: 0

MINIMUM_LENGTH Double Maximum length of link related to an objective (km) Nullable: Yes
Default: 0
NAME Text (50) EPO name Nullable: No
Default:

RATE_MAX Float Maximum bit rate (Mbps) Nullable: Yes


Default:

RATE_MIN Float Minimum bit rate (Mbps) Nullable: Yes


Default:
REC_UIT Float ITU Recommendations Nullable: Yes
Default: 1

10.2.15 MWEPOLinkClass Table

For EPO link classes.

328 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

COMMENT_ Text (255) Comments Nullable: Yes


Default:

LINK_CLASS Text (5) Type of EPO link class Nullable: No


Default:
LINK_SUBCLASS Text (5) Type of EPO link subclass Nullable: Yes
Default:

LMAX Float Maximum length of the link for the EPO class Nullable: Yes
Default:

LMIN Float Minimum length of the link for the EPO class Nullable: Yes
Default:
NAME Text (50) Name of the EPO class Nullable: No
Default:

10.2.16 MWEquipments Table

For microwave radios.

Field Type Description Attributes

ACM_MODE Integer Optimisation mode: 0=None; 1=Max system gain; 2=Max throughput gain; Nullable: No
Default: 0

ACM_STEP_DOWN Memo Transition level from a higher modulation state to a lower one. Nullable: Yes
Default:
ACM_STEP_UP Memo Transition level from a higher modulation state to a higher one. Nullable: Yes
Default:

ATPC_MAX Float Maximum ATPC level. Nullable: Yes


Default:

ATPC_STEP Float ATPC step. Nullable: Yes


Default:

ATPC_TRIGGER_POINT_DBM Memo Desired input level when ATPC is enabled on a remote transmitter. Nullable: Yes
Default:
BW_KHZ Integer Channel spacing. Unit: kHz. Nullable: Yes
Default: 7000

CAPACITY Text (50) Equipment capacity Nullable: No


Default: 1

CI_MIN_BER3 Float Minimum C/I for BER = 1e-3 Nullable: Yes


Default:
CI_MIN_BER6 Float Minimum C/I for BER = 1e-6 Nullable: Yes
Default:

DFM Memo Dispersive fade margin curve Nullable: Yes


Default:

DISCRETE_POWERS Text (255) Discrete list of allowed power values. Nullable: Yes
Default:
EMISSION_DESIGNATOR Text (20) Normalized designator Nullable: Yes
Default:

FAMILY Text (50) Family name Nullable: No


Default:

FREQ_BAND Text (50) Frequency band of the equipment Nullable: No


Default:

© 2018 Forsk. All Rights Reserved. 329


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

HSB_DELAY Float Hot Standby commutation delay time Nullable: Yes


Default: 0

IFM Float Margin against interference Nullable: Yes


Default: 1

KN Float Kn parameter Nullable: Yes


Default: 0
LOW_POWER Float Low power. Nullable: Yes
Default:

MAX_POWER Float Maximum power. Nullable: Yes


Default: 30

MIN_PHASE_SIG_DEPTH Memo Minimum signature depth Nullable: Yes


Default: '1e-6 30 1e-3 30'
MIN_PHASE_SIG_WIDTH Memo Minimum signature width Nullable: Yes
Default: '1e-6 10 1e-3 10'

MIN_POWER Float Minimum power. Nullable: Yes


Default:

MODULATION Text (20) Modulation type Nullable: No


Default: “16-QAM”
MTBF Float Mean Time Before Failure Nullable: Yes
Default: 1000000

NAME Text (50) Name of the equipment Nullable: No


Default:

NF Float Noise Figure of the equipment Nullable: Yes


Default: 5

NON_MIN_PHASE_SIG_DEPT Memo Non minimum signature depth Nullable: Yes


H Default: '1e-6 30 1e-3 30'
NON_MIN_PHASE_SIG_WIDT Memo Non minimum signature width Nullable: Yes
H Default: '1e-6 10 1e-3 10'

RX_LOSS_PHYS Float Physical receiver loss Nullable: Yes


Default: 0

RX_OVERFLOW Memo Curve which defines the thresholds max value for any value of BER Nullable: Yes
Default: '1e-6 -25 1e-3 -20'
RX_PORT_1 Float Receiving loss on port number 1 Nullable: Yes
Default: 0

RX_PORT_2 Float Receiving loss on port number 2 Nullable: Yes


Default: 0

RX_PORT_3 Float Receiving loss on port number 3 Nullable: Yes


Default: 0
RX_PORT_4 Float Receiving loss on port number 4 Nullable: Yes
Default: 0

RX_PORT_5 Float Receiving loss on port number 5 Nullable: Yes


Default: 0

RX_PORT_6 Float Receiving loss on port number 16 Nullable: Yes


Default: 0
RX_PORT_7 Float Receiving loss on port number 7 Nullable: Yes
Default: 0

RX_PORT_8 Float Receiving loss on port number 8 Nullable: Yes


Default: 0

RX_PORT_9 Float Receiving loss on port number 9 Nullable: Yes


Default: 0

330 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

RX_PORT_10 Float Receiving loss on port number 10 Nullable: Yes


Default: 0

RX_SELECTIVITY Memo Receiver filter selectivity Nullable: Yes


Default:

RX_SENSITIVITY Memo BER - Sensitivity tables Nullable: Yes


Default: “1e-6 -82 1e-3 -90”
STD_POWER Float Standard power. Nullable: Yes
Default:

TI_CURVE Memo T/I curve Nullable: Yes


Default:

TX_LOSS_PHYS Float Physical transmitter loss Nullable: Yes


Default: 0
TX_MASK Memo Transmitter spectrum mask Nullable: Yes
Default:

TX_PORT_1 Float Transmission loss on port number 1 Nullable: Yes


Default: 0

TX_PORT_2 Float Transmission loss on port number 2 Nullable: Yes


Default: 0
TX_PORT_3 Float Transmission loss on port number 3 Nullable: Yes
Default: 0

TX_PORT_4 Float Transmission loss on port number 4 Nullable: Yes


Default: 0

TX_PORT_5 Float Transmission loss on port number 5 Nullable: Yes


Default: 0

TX_PORT_6 Float Transmission loss on port number 6 Nullable: Yes


Default: 0
TX_PORT_7 Float Transmission loss on port number 7 Nullable: Yes
Default: 0

TX_PORT_8 Float Transmission loss on port number 8 Nullable: Yes


Default: 0

TX_PORT_9 Float Transmission loss on port number 9 Nullable: Yes


Default: 0
TX_PORT_10 Float Transmission loss on port number 10 Nullable: Yes
Default: 0

WITH_EQUALIZER Boolean Used to calculate Kn Nullable: No


Default: False

XPIF Float Crosspolar Interference Factor Nullable: Yes


Default: 20

10.2.17 MWFamilies Table

For microwave radio families.

© 2018 Forsk. All Rights Reserved. 331


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

COMMENT_ Text (255) Comments Nullable: Yes


Default:

MANUFACTURER Text (50) Manufacturer name Nullable: Yes


Default:
NAME Text (50) Family name Nullable: No
Default:

STANDARDS Short Method used to control the transmit power levels when ACM is used. 0=ANSI; Nullable: Yes
1=ETSI. Default: 1

10.2.18 MWFamilyBrConfigs Table

For branching configurations supported by microwave radio families.

Field Type Description Attributes

BRANCHING_CONFIG Text (50) Branching configuration name Nullable: No


Default:
FAMILY Text (50) Family name Nullable: No
Default:

FREQ_BAND Text (50) Frequency band Nullable: No


Default:

RX_BRLOSS Float Main channel reception loss Nullable: Yes


Default: 0
RX_STANDBY_LOSS Float Standby channel reception loss Nullable: Yes
Default: 0

TX_BRLOSS Float Transmission loss Nullable: Yes


Default: 0

10.2.19 MWFrequencies Table

For microwave frequencies.

Field Type Description Attributes

CHANNEL_ID Integer ID of the channel Nullable: No


Default: 1

CHANNEL_RADICAL Text (20) Radical of the channel. Sub-band prefix and suffix will be appended Nullable: Yes
Default:
FREQ_L Double Value of the frequency (MHz) in the lower half-band Nullable: Yes
Default:

FREQ_U Double Value of the frequency (MHz) in the upper half-band Nullable: Yes
Default:

SUBBAND Text (50) Name of a existing sub-band to which these frequencies are related Nullable: No
Default:

10.2.20 MWFrontages Table

For types of facades.

332 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

LOSSES Float Propagation loss due to the surface. Unit: dB. Nullable: Yes
Default: 0

NAME Text (50) Name of the type of facade or frontage. Nullable: No


Default:

10.2.21 MWGuides Table

For microwave wave guides.

Field Type Description Attributes


FREQ_BAND Text (50) Frequency band of the guide Nullable: No
Default:

GUIDE_TYPE Integer Type of guide: 0=Cable; 1=Elliptic; 2=Rectangular; 3=Circular; 4=Other; Nullable: Yes
Default: 0

LOSS_PER_METER Float Linear loss Nullable: Yes


Default: 7
MANUFACTURER Text (50) Guide manufacturer Nullable: Yes
Default:

NAME Text (50) Name of the guide Nullable: No


Default:

10.2.22 MWHubs Table

For microwave link hubs.

Field Type Description Attributes

ABS_X Double Absolute coordinate of the hub on the X axis (longitude). Nullable: Yes
Default:

ABS_Y Double Absolute coordinate of the hub on the Y axis (latitude). Nullable: Yes
Default:
ACTIVE Boolean Activity status. True=Active; False=Inactive. Nullable: No
Default: True

ANTENNA Text (50) Name of the (shared) Antenna Nullable: Yes


Default:

AZIMUTH Float Azimuth of the Antenna Nullable: Yes


Default: 0
CALC_RADIUS Integer Calculation radius of the path loss matrices. Nullable: Yes
Default: 4000

CALC_RESOLUTION Integer Calculation resolution of the path loss matrices. Nullable: Yes
Default: 20

COMMENT_ Text (255) Comments Nullable: Yes


Default:
DOWNTILT Float Tilt of the Antenna Nullable: Yes
Default: 0

DX Float X coordinate relative to the site location. Nullable: Yes


Default: 0

© 2018 Forsk. All Rights Reserved. 333


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

DY Float Y coordinate relative to the site location. Nullable: Yes


Default: 0

EQUIPMENT Text (50) Name of the equipment used by the hub. Nullable: Yes
Default:

FREQ_BAND Text (50) Name of the frequency band Nullable: No


Default:
HEIGHT Float Height of the Antenna Nullable: Yes
Default: 30

LINKS_TPL Text (50) Name of the link template. Nullable: Yes


Default:

NAME Text (50) Name of the Hub Nullable: No


Default:
PMP_TYPE Short Type of the PMP: TDMA or FDMA or OFDMA Nullable: Yes
Default: 0

PROPAG_MODEL Text (50) Name of the propagation model used to calculate the path loss matrices. Nullable: Yes
Default:

RXLOSSES Float Reception losses due to equipment. Unit: dB. Nullable: Yes
Default: 0
SHARED_RADIO Short Whether the hub uses a shared radio or not. 0=False; 1=True. Nullable: Yes
Default: 1

SITE Text (60) Name of the site Nullable: No


Default:

TXLOSSES Float Transmission losses due to equipment. Unit: dB. Nullable: Yes
Default: 0

USE_ABS_XY Short Whether to use the absolute hub coordinates (ABS_X, ABS_Y) or hub location Nullable: No
relative to site coordinates (DX, DY). 0=Relative; 1=Absolute. Default: 0

10.2.23 MWIrfs Table

For interference reduction factors per microwave equipment pairs.

Field Type Description Attributes

INTERFERED Text (50) Interfered equipment Nullable: No


Default:

INTERFERER Text (50) Interferer equipment Nullable: No


Default:

IRF Memo List of interference filtering protections Nullable: Yes


Default:

 The IRF field represents a list of pairs of values. Each pair consists of:
float deltaF: spacing in frequency
float protection: protection applied to this frequency

10.2.24 MWLinks Table

For microwave links.

334 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

ABS_X_A Double Absolute X coordinate (longitude) of the link extremity at site A. Nullable: Yes
Default:

ABS_X_B Double Absolute X coordinate (longitude) of the link extremity at site B. Nullable: Yes
Default:
ABS_Y_A Double Absolute Y coordinate (latitude) of the link extremity at site A. Nullable: Yes
Default:

ABS_Y_B Double Absolute Y coordinate (latitude) of the link extremity at site B. Nullable: Yes
Default:

ACTIVE Boolean Link active or not Nullable: No


Default: True
ACTIVE_MODULATIONS_A Text (255) List of modulations used at A Nullable: Yes
Default:

ACTIVE_MODULATIONS_B Text (255) List of modulations used at B Nullable: Yes


Default:

ANTENNA_A Text (50) Main antenna at site A Nullable: Yes


Default:
ANTENNA_B Text (50) Main antenna at site B Nullable: Yes
Default:

ANTENNA2_A Text (50) Secondary antenna at site A Nullable: Yes


Default:

ANTENNA2_B Text (50) Secondary antenna at site B Nullable: Yes


Default:
ATMOS_PRESSURE Float Atmospheric pressure in mbar Nullable: Yes
Default:
ATPC_A Float ATPC at site A Nullable: Yes
Default: 0

ATPC_B Float ATPC at site B Nullable: Yes


Default: 0

AZIMUTH_A Float Azimuth at site A Nullable: Yes


Default: 0
AZIMUTH_B Float Azimuth at site B Nullable: Yes
Default: 0

BER Double Bit Error Rate Nullable: Yes


Default: 1e-3

BER2 Double Second Bit Error Ratio (i.e. 1e-6) Nullable: Yes
Default: 1e-6
BRANCHING_CONFIG_A Text (50) Branching configuration at A Nullable: Yes
Default:

BRANCHING_CONFIG_B Text (50) Branching configuration at B Nullable: Yes


Default:

C_FACTOR Float Vigants-Barnett method: C factor Nullable: Yes


Default: 1
CHANNELS_A Text (50) Channels used at site A Nullable: Yes
Default:

CHANNELS_B Text (50) Channels used at site B Nullable: Yes


Default:

CLIMATE_ZONE Short Rain Climate Zone Nullable: Yes


Default: 4
COMMENT_ Text (255) Comments Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 335


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

DELTA_POW_A Float Gain or loss to maximum transmitter power at A Nullable: Yes


Default: 0

DELTA_POW_B Float Gain or loss to maximum transmitter power at B Nullable: Yes


Default: 0

DOWNTILT_A Float Downtilt at site A Nullable: Yes


Default: 0
DOWNTILT_B Float Downtilt at site B Nullable: Yes
Default: 0

DX_A Float X coordinate relative to the site A position Nullable: Yes


Default: 0

DX_B Float X coordinate relative to the site B position Nullable: Yes


Default: 0
DY_A Float Y coordinate relative to the site A position Nullable: Yes
Default: 0

DY_B Float Y coordinate relative to the site B position Nullable: Yes


Default: 0

ENVTYPE Integer Type of environment Nullable: Yes


Default: 0
EPO_CLASS Text (50) EPO Class for the link Nullable: Yes
Default:

EPO_IP_CLASS Text (50) Name of IP objectives class. Nullable: Yes


Default:

EQUIPMENT_A Text (50) Equipment at site A Nullable: Yes


Default:

EQUIPMENT_B Text (50) Equipment at site B Nullable: Yes


Default:
FREQ_A Double Frequency at site A Nullable: Yes
Default: -1

FREQ_B Double Frequency at site B Nullable: Yes


Default: -1

FREQ_BAND Text (50) Frequency band of the link Nullable: No


Default:
FREQ_SUBBAND Text (50) Frequency subband of the link (site A) Nullable: Yes
Default:

FREQ_SUBBAND_B Text (50) Frequency subband of the link (site B) Nullable: Yes
Default:

GEOCLIM_FACTOR Double Nullable: Yes


Default:
GUIDE_LG1 Float Length of GUIDE1 Nullable: Yes
Default: 0

GUIDE_LG2 Float Length of GUIDE2 Nullable: Yes


Default: 0

GUIDE_LG3 Float Length of GUIDE3 Nullable: Yes


Default: 0
GUIDE_LG4 Float Length of GUIDE4 Nullable: Yes
Default: 0

GUIDE_USE1 Integer Use of Guide 1 on site A Nullable: Yes


Default: 0

GUIDE_USE2 Integer Use of Guide 2 on site B Nullable: Yes


Default: 1

336 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

GUIDE_USE3 Integer Use of Guide 1 on site B Nullable: Yes


Default: 0

GUIDE_USE4 Integer Use of Guide 2 on site A Nullable: Yes


Default: 1

GUIDE1 Text (50) Waveguide when A transmitting Nullable: Yes


Default:
GUIDE2 Text (50) Waveguide when B receiving Nullable: Yes
Default:

GUIDE3 Text (50) Waveguide when B transmitting Nullable: Yes


Default:

GUIDE4 Text (50) Waveguide when A receiving Nullable: Yes


Default:
HEIGHT_A Float Height at site A Nullable: Yes
Default: 0

HEIGHT_B Float Height at site B Nullable: Yes


Default: 0

KQ_FACTOR Float KQ reliability method: KQ Factor Nullable: Yes


Default:
LOCATION_617 Short Location or zone according to the ITU-R P.617. 0=Maritime zones; 1=Equa- Nullable: Yes
torial climate; 3=Intertropical continental climate; 4=Intertropical maritime Default:
climate; 5=Desert climate; 6=Temperate continental climate; 7=Temperate
maritime climate, terrestrial zones.

LOCATION_841 Short Location or zone according to the ITU-R P.841. 0=Global. 1=North eastern Nullable: No
Europe; 2=Mediterranian Europe; 3=Northern Europe; 4=Alpine Europe; Default:
5=Poland; 6=Russia; 7=Congo; 8=Canada (prairies and north); 9=Canada
(coasts and lakes); 10=Canada (centre and mountains); 11=Indonesia;
12=Japan.

MTTR Float Minimum Time To Repair Nullable: Yes


Default: 0
NAME Text (120) Name of the microwave link Nullable: No
Default:

PARITY_A Integer Parity of site A Nullable: Yes


Default: 0

PARITY_B Integer Parity of site B Nullable: Yes


Default: 0
PL Float Nullable: Yes
Default: 10

POLARIZATION_A Text (1) Polarization at site A Nullable: Yes


Default: ‘V’

POLARIZATION_B Text (1) Polarization at site B Nullable: Yes


Default: ‘V’
POWER_FLAG_A Short Type of power: Nullable: Yes
0 = Relative to Max; 1 = Relative to Std; 2 = Relative to Low; 3 = Absolute Default: 0

POWER_FLAG_B Short Type of power: Nullable: Yes


0 = Relative to Max; 1 = Relative to Std; 2 = Relative to Low; 3 = Absolute Default: 0

PROFILE Binary Link profile Nullable: Yes


Default:
PROPAG_IMODEL Text (50) Propagation model used for interference calculation Nullable: Yes
Default:

PROPAG_MODEL Text (50) Propagation model Nullable: Yes


Default:

R001 Float Rain intensity exceeded for 0.01% of time (mm/hr) Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 337


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

RADOME_ON_A Boolean Radome used on the first antenna at A Nullable: No


Default: False

RADOME_ON_B Boolean Radome used on the first antenna at B Nullable: No


Default: False

RADOME2_ON_A Boolean Radome used on the second antenna at A Nullable: No


Default: False
RADOME2_ON_B Boolean Radome used on the second antenna at B Nullable: No
Default: False

RAIN_HEIGHT Float Nullable: Yes


Default:

RAIN_ZONE Short Rain zone Nullable: Yes


Default: 4
REFRACTIVITY Float Nullable: Yes
Default:

REFRACTIVITY_KE Float N-units /km Nullable: Yes


Default:

REPEATER1 Text (60) First repeater (P) Nullable: Yes


Default:
REPEATER2 Text (60) Second repeater (Q) Nullable: Yes
Default:

RXLOSS_ATT_A Float Reception losses due to attenuators at A Nullable: Yes


Default: 0

RXLOSS_ATT_B Float Reception losses due to attenuators at B Nullable: Yes


Default: 0

SEPARATION_A Float Diversity separation at site A Nullable: Yes


Default: 0
SEPARATION_B Float Diversity separation at site B Nullable: Yes
Default: 0

SHIELDING_FACTOR_A Float Additional loss due to a natural or artificial obstacle in the vicinity of the Nullable: Yes
antenna A Default: 0

SHIELDING_FACTOR_B Float Additional loss due to a natural or artificial obstacle in the vicinity of the Nullable: Yes
antenna B Default: 0
SITE_A Text (60) Site of departure (A) Nullable: No
Default:

SITE_B Text (60) Site of arrival (B) Nullable: No


Default:

TEMPERATURE Float Temperature Nullable: Yes


Default:
TERRAIN_TYPE Integer Terrain type (Vigants) Nullable: Yes
Default: 0

TX_POWER_A Float Absolute tuned power, not relative to equipment maximum power Nullable:
Default: 0

TX_POWER_B Float Absolute tuned power, not relative to equipment maximum power Nullable:
Default: 0
TXLOSS_ATT_A Float Transmission losses due to attenuators at A Nullable: Yes
Default: 0

TXLOSS_ATT_B Float Transmission losses due to attenuators at B Nullable: Yes


Default: 0

TXLOSS_BRANCHING_A Float Transmission losses due to connectors and branching at A Nullable: Yes
Default: 0

338 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

TXLOSS_BRANCHING_B Float Transmission losses due to connectors and branching at B Nullable: Yes
Default: 0

USE_ABS_XY_A Short Whether to use the absolute hub coordinates (ABS_X, ABS_Y) or link extrem- Nullable: No
ity locations relative to site A coordinates (DX, DY). 0=Relative; 1=Absolute. Default: 0

USE_ABS_XY_B Short Whether to use the absolute hub coordinates (ABS_X, ABS_Y) or link extrem- Nullable: No
ity locations relative to site B coordinates (DX, DY). 0=Relative; 1=Absolute. Default: 0

VAPOR Float Vapour density (g/cu. m) Nullable: Yes


Default:

10.2.25 MWLinkTypes Table

For types of microwave link trunks.

Field Type Description Attributes

BER_SES Double BERses Nullable: Yes


Default: 0

BLOCK_SIZE Integer Size of transmitted blocks (number of bits per block) Nullable: Yes
Default: 2000
NAME Text (50) Name of the link type Nullable: No
Default:

RATE Float Maximum bit rate (Mbps) Nullable: Yes


Default: 2

SUP_RATE Float Supported bit rate (Mbps) Nullable: Yes


Default: 2

TYPE Short Trunk type: 0=PDH; 1=SDH; 2=IP; Nullable: Yes


Default: 0

10.2.26 MWManufacturers Table

For microwave equipment manufacturers.

Field Type Description Attributes

COMMENT_ Text (255) Comments Nullable: Yes


Default:

NAME Text (50) Name of the manufacturer Nullable: No


Default:

10.2.27 MWMediumTypes Table

For medium types.

© 2018 Forsk. All Rights Reserved. 339


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

AIR_LINK_RATE Float Value of rate in Mbps Nullable: Yes


Default: 100

CAPA_TECHNO Short Capacity configuration: Nullable: Yes


0 = Full packet, 1 = Hybrid, 2 = TDM only Default: 0
NAME Text (20) Name of the medium Nullable: No
Default:

TDM_RATE Float Value of rate reserved for TDM in Mbps Nullable: Yes
Default: 50

10.2.28 MWModulations Table

For modulations.

Field Type Description Attributes

EB_N0 Memo Eb/No graph Nullable: Yes


Default:
FULL_NAME Text (255) Comments Nullable: Yes
Default:

NAME Text (20) Modulation Nullable: No


Default:

NSTATES Integer Number of modulation states Nullable: Yes


Default: 16

10.2.29 MWMultiHops Table

For multihop links.

Field Type Description Attributes

COMMENT_ Text (255) Comments Nullable: Yes


Default:
EPO_CLASS Text (50) Name of the EPO class Nullable: Yes
Default:

EPO_IP_CLASS Text (50) IP Objective Class of the multihop links. Nullable: Yes
Default:

NAME Text (50) Name of the multihop link Nullable: No


Default:

10.2.30 MWMultiHopsLinks Table

For microwave links belonging to multihops.

340 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

IDENT Short Nullable: No


Default: 100

LINK Text (140) Name of the link belonging to the multihop Nullable: No
Default:
MULTI_HOP Text (60) Name of the multihop link Nullable: No
Default:

OTLINK Text (140) Nullable: Yes


Default: 50

10.2.31 MWOperatingModes Table

Field Type Description Attributes

FULL_NAME Text (50) String describing the mode: displayed in the GUI wherever there is room for Nullable: No
long strings (e.g. “Adaptive Coding Modulation”) Default: “Mode”

MODE_ID Integer Number used for managing relationships between related tables Nullable: No
Default:
OPERATION_FLAG Short XOR of supported mode (00 = fix, 01 = with ACM) Nullable: Yes
Default: 0

SHORT_NAME Text (10) String describing the mode: used for distinguishing active modulations in a Nullable: No
link Default: “Mode”

10.2.32 MWOTLinks Table

Field Type Description Attributes


ACTIVE Boolean Flag to filter links Nullable: No
Default: True

COMMENT_ Text (255) Comment Nullable: Yes


Default:

EPO_CLASS Text (50) Nullable: Yes


Default:
EPO_IP_CLASS Text (50) IP Objective Class of the other type link. Nullable: Yes
Default:

MEDIUM_TYPE Text (20) Nullable: No


Default:

NAME Text (120) Nullable: No


Default:
SITE_A Text (60) Nullable: No
Default:

SITE_B Text (60) Nullable: No


Default:

10.2.33 MWPMP Table

For microwave links and hubs belonging to a point-to-multipoint group.

© 2018 Forsk. All Rights Reserved. 341


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

HUB Text (80) Name of the hub Nullable: No


Default:

LINK Text (140) Name of the link Nullable: No


Default:

10.2.34 MWPorts Table

For microwave ports.

Field Type Description Attributes


CHANNEL Short Channel Number Nullable: No
Default: 0

LINK Text (140) Name of the link Nullable: No


Default:

POLARIZATION Text (1) Signal polarization of this channel Nullable: No


Default: ‘H’
RX_ATTENUATION Float Rx attenuation loss for this channel Nullable: Yes
Default: 1

RX_PORT Short Number of the port on the RX equipment where the channel is connected Nullable: Yes
Default: 1

STATUS Short Status of the microwave port (0 = main,1 = standby, or 2 = diversity) Nullable: No
Default: 0
TX_ATTENUATION Float Tx attenuation loss for this channel Nullable: Yes
Default: 0

TX_PORT Short Number of the port on the TX equipment where the channel is connected Nullable: Yes
Default: 1

WAY Short Way of the link AB or BA Nullable: No


Default: 0

10.2.35 MWRepeaters Table

For microwave repeaters.

Field Type Description Attributes

ABS_X Double Absolute coordinate of the repeater on the X axis (longitude). Nullable: Yes
Default:
ABS_Y Double Absolute coordinate of the repeater on the Y axis (latitude). Nullable: Yes
Default:

ANTENNA Text (50) Repeater antenna Nullable: Yes


Default:

ANTENNA_2 Text (50) Used if type is Back to Back Antenna (from the antenna table) (point to B) Nullable: Yes
Default:
AZIMUTH_A Float Azimuth of the repeater in the direction of A Nullable: Yes
Default: 0

AZIMUTH_B Float Azimuth of the repeater in the direction of B Nullable: Yes


Default: 0

342 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

COMMENT_ Text (255) Whether the hub uses a shared radio or not. 0=False; 1=True. Nullable: Yes
Default:

DX Float X coordinate relative to site position Nullable: Yes


Default: 0

DY Float Y coordinate relative to site position Nullable: Yes


Default: 0
FREQ_BAND Text (50) Frequency band of the repeater Nullable: No
Default:

FRONTAGE Text (50) Name of the type of facade or frontage. Nullable: Yes
Default:

GUIDE Text (50) Used if type is Back to Back Antenna (from the guide table) Nullable: Yes
Default:
HEIGHT Float Height of the repeater Nullable: Yes
Default: 30

HEIGHT_2 Float Height (pointed to B) Nullable: Yes


Default: 30

LG_GUIDE Float Guide length Nullable: Yes


Default: 0
NAME Text (60) Name of the repeater Nullable: No
Default:

REPEATER_TYPE Short Type of the repeater (Reflector or Back-to-back antennas) Nullable: Yes
Default: 0 (Reflector)

REVERSE_POLAR Boolean If true, tx polarization from P to B is not the same as from A to P (and resp, Nullable: No
B->P is different to P->A) Default: False

SITE Text (60) Name of the repeater’s site Nullable: No


Default:
SURFACE Float Repeater surface area (sq. m) Nullable: Yes
Default: 5

TILT_A Float Tilt of the repeater antenna in the direction of A Nullable: Yes
Default:

TILT_B Float Tilt of the repeater antenna in the direction of B Nullable: Yes
Default:
USE_ABS_XY Short Whether to use the absolute repeater coordinates (ABS_X, ABS_Y) or Nullable: No
repeater location relative to site coordinates (DX, DY). 0=Relative; 1=Abso- Default: 0
lute.

10.2.36 MWSubbands Table

For microwave frequency subbands.

Field Type Description Attributes


EXCLUDE_L Text (250) Excluded channels in the lower half-band Nullable: Yes
Default:

EXCLUDE_U Text (250) Excluded channels in the upper half-band Nullable: Yes
Default:

F0 Double Central frequency Nullable: Yes


Default: 4700
FREQ_BAND Text (50) Frequency band Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 343


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

KL Double Lower half-band shift Nullable: Yes


Default: -310

KU Double Upper half-band shift Nullable: Yes


Default: 2

N_MAX Integer Last channel number Nullable: Yes


Default: 10
N_MIN Integer First channel number Nullable: Yes
Default: 1

NAME Text (50) Name of the sub-band Nullable: No


Default:

PREFIX_L Text (5) Prefix for formatting channel in lower sub-band Nullable: Yes
Default:
PREFIX_U Text (5) Prefix for formatting channel in upper sub-band Nullable: Yes
Default:

REC_UIT Text (255) ITU Recommendations Nullable: Yes


Default:

STEP Integer Step size between first and last channel number Nullable: Yes
Default: 1
SUFFIX_L Text (5) Suffix for formatting channel in lower sub-band Nullable: Yes
Default:

SUFFIX_U Text (5) Suffix for formatting channel in upper sub-band Nullable: Yes
Default:

XS Double Inter-channel space Nullable: Yes


Default: 28

10.2.37 MWTplHubs Table

For microwave link hub templates.

Field Type Description Attributes

ANTENNA Text (50) Name of the transmission antenna installed on the hub. Nullable: Yes
Default:
AZIMUTH Float Azimuth of the transmission antenna. Nullable: Yes
Default: 0

CALC_RADIUS Integer Calculation radius of the path loss matrices. Nullable: Yes
Default: 4000

CALC_RESOLUTION Integer Calculation resolution of the path loss matrices. Nullable: Yes
Default: 20
COMMENT_ Text (255) Additional information about the hub. Nullable: Yes
Default:

EQUIPMENT Text (50) Name of the equipment used by the hub. Nullable: Yes
Default:

FREQ_BAND Text (50) Name of the frequency band used by the hub. Nullable: No
Default:
HEIGHT Float Transmission antenna height above the ground. Nullable: Yes
Default: 30

LINKS_TPL Text (50) Name of the link template. Nullable: Yes


Default:

344 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

NAME Text (50) Name of the hub template. Nullable: No


Default:

PMP_TYPE Short Type of the PMP. 0=TDA; 1=FDA. Nullable: Yes


Default: 0

PROPAG_MODEL Text (50) Name of the propagation model used to calculate the path loss matrices. Nullable: Yes
Default:
RXLOSSES Float Reception losses due to equipment. Unit: dB. Nullable: Yes
Default: 0

SHARED_RADIO Short Whether the hub uses a shared radio or not. 0=False; 1=True. Nullable: Yes
Default: 1

TXLOSSES Float Transmission losses due to equipment. Unit: dB. Nullable: Yes
Default: 0

10.2.38 MWTplLinks Table

For microwave link templates.

Field Type Description Attributes


ACTIVE_MODULATIONS_A Text (255) List of modulations among family ones available for that link (null = All) Nullable: Yes
Default:

ACTIVE_MODULATIONS_B Text (255) List of modulations among family ones available for that link (null = All) Nullable: Yes
Default:

ANTENNA_A Text (50) Main antenna at site A Nullable: Yes


Default:

ANTENNA_B Text (50) Main antenna at site B Nullable: Yes


Default:
ANTENNA2_A Text (50) Diversity antenna on site A (antenna used for B >> A, when A is receiver) Nullable: Yes
Default:

ANTENNA2_B Text (50) Diversity antenna on site B (antenna used for A >> B, when B is receiver) Nullable: Yes
Default:

ATMOS_PRESSURE Float Atmospheric pressure in mbar Nullable: Yes


Default:
BER Double Bit Error Rate Nullable: Yes
Default: 1e-3

BER2 Double Second Bit Error Ratio (i.e. 1e-6) Nullable: Yes
Default: 1e-6

BRANCHING_CONFIG_A Text (50) Branching configuration at A Nullable: Yes


Default:
BRANCHING_CONFIG_B Text (50) Branching configuration at B Nullable: Yes
Default:

C_FACTOR Float Vigants-Barnett method: C factor Nullable: Yes


Default: 1

CLIMATE_ZONE Short Rain Climate Zone Nullable: Yes


Default: 4
ENVTYPE Integer Type of environment Nullable: Yes
Default: 0

EPO_CLASS Text (50) EPO Class for the link Nullable: Yes
Default:

© 2018 Forsk. All Rights Reserved. 345


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

EPO_IP_CLASS Text (50) Name of IP objectives class. Nullable: Yes


Default:

EQUIPMENT_A Text (50) Equipment at site A Nullable: Yes


Default:

EQUIPMENT_B Text (50) Equipment at site B Nullable: Yes


Default:
FREQ_BAND Text (50) Frequency band of the link Nullable: No
Default:

FREQ_SUBBAND Text (50) Type of channelisation within the selected frequency band for A >> B Nullable: Yes
Default:

FREQ_SUBBAND_B Text (50) Type of channelisation within the selected frequency band for B >> A Nullable: Yes
Default:
GEOCLIM_FACTOR Double Geoclimatic factor used for Rec ITU-530 Nullable: Yes
Default:

GUIDE_LG1 Float Length of GUIDE1 Nullable: Yes


Default: 0

GUIDE_LG2 Float Length of GUIDE2 Nullable: Yes


Default: 0
GUIDE_LG3 Float Length of GUIDE3 Nullable: Yes
Default: 0

GUIDE_LG4 Float Length of GUIDE4 Nullable: Yes


Default: 0

GUIDE_USE1 Integer Use of Guide 1 on site A Nullable: Yes


Default: 0

GUIDE_USE2 Integer Use of Guide 2 on site B Nullable: Yes


Default: 1
GUIDE_USE3 Integer Use of Guide 1 on site B Nullable: Yes
Default: 0

GUIDE_USE4 Integer Use of Guide 2 on site A Nullable: Yes


Default: 1

GUIDE1 Text (50) Waveguide when A transmitting Nullable: Yes


Default:
GUIDE2 Text (50) Waveguide when B receiving Nullable: Yes
Default:

GUIDE3 Text (50) Waveguide when B transmitting Nullable: Yes


Default:

GUIDE4 Text (50) Waveguide when A receiving Nullable: Yes


Default:
HEIGHT_A Float Height at site A Nullable: Yes
Default: 0

HEIGHT_B Float Height at site B Nullable: Yes


Default: 0

KQ_FACTOR Float KQ reliability method: KQ Factor Nullable: Yes


Default:
LOCATION_617 Short Location or zone according to the ITU-R P.617. 0=Maritime zones; 1=Equa- Nullable: Yes
torial climate; 3=Intertropical continental climate; 4=Intertropical maritime Default:
climate; 5=Desert climate; 6=Temperate continental climate; 7=Temperate
maritime climate, terrestrial zones.

LOCATION_841 Short Location or zone according to the ITU-R P.841. 0=Global. 1=North eastern Nullable: No
Europe; 2=Mediterranian Europe; 3=Northern Europe; 4=Alpine Europe; Default:
5=Poland; 6=Russia; 7=Congo; 8=Canada (prairies and north); 9=Canada
(coasts and lakes); 10=Canada (centre and mountains); 11=Indonesia;
12=Japan.

346 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

MTTR Float Minimum Time To Repair Nullable: Yes


Default: 0

NAME Text (120) Name of the microwave link template Nullable: No


Default:

PL Float Nullable: Yes


Default: 10
POLARIZATION_A Text (1) Polarisation of the descending link 'siteA - site B' (the site A and site B are Nullable: Yes
respectively transmitter and receiver) Default: ‘V’

POLARIZATION_B Text (1) Polarisation of the ascending link 'siteA-site B' (the site A and site B are Nullable: Yes
respectively receiver and transmitter) Default: ‘V’

POWER_FLAG_A Short Type of power: Nullable: Yes


0 = Relative to Max; 1 = Relative to Std; 2 = Relative to Low; 3 = Absolute Default: 0
POWER_FLAG_B Short Type of power: Nullable: Yes
0 = Relative to Max; 1 = Relative to Std; 2 = Relative to Low; 3 = Absolute Default: 0

PROPAG_IMODEL Text (50) Propagation model used for interference calculation Nullable: Yes
Default:

PROPAG_MODEL Text (50) Propagation model Nullable: Yes


Default:
R001 Float Rain intensity exceeded for 0.01% of time (mm/hr) Nullable: Yes
Default:

RAIN_HEIGHT Float Nullable: Yes


Default:

RAIN_ZONE Short Rain zone Nullable: Yes


Default: 4

REFRACTIVITY Float Nullable: Yes


Default:
REFRACTIVITY_KE Float N-units /km Nullable: Yes
Default:

RXLOSS_ATT_A Float Reception losses due to attenuators at A Nullable: Yes


Default: 0

RXLOSS_ATT_B Float Reception losses due to attenuators at B Nullable: Yes


Default: 0
SEPARATION_A Float Distance between antenna and diversity antenna (siteA receiver) Nullable: Yes
Default: 0

SEPARATION_B Float Distance between antenna and diversity antenna (siteB receiver) Nullable: Yes
Default: 0

TEMPERATURE Float Temperature Nullable: Yes


Default:
TERRAIN_TYPE Integer Terrain type (Vigants) Nullable: Yes
Default: 0

TX_POWER_A Float Absolute tuned power, not relative to equipment maximum power Nullable: Yes
Default: 0

TX_POWER_B Float Absolute tuned power, not relative to equipment maximum power Nullable: Yes
Default: 0
TXLOSS_ATT_A Float Transmission losses due to attenuators at A Nullable: Yes
Default: 0

© 2018 Forsk. All Rights Reserved. 347


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

TXLOSS_ATT_B Float Transmission losses due to attenuators at B Nullable: Yes


Default: 0

TXLOSS_BRANCHING_A Float Transmission losses due to connectors and branching at A Nullable: Yes
Default: 0

TXLOSS_BRANCHING_B Float Transmission losses due to connectors and branching at B Nullable: Yes
Default: 0
VAPOR Float Vapour density (g/cu. m) Nullable: Yes
Default:

10.2.39 Networks Table

For network-level parameters.

Field Type Description Attributes

NAME Text (50) Name of the network. Nullable: No


Default:

SHARED_PROFILES_FOLDER Text (255) Shared link profile storage folder. Nullable: Yes
Default:
SYSTEM_ Text (50) Name of the system. Nullable: No
Default: ‘MW’

TECHNOLOGY Text (10) Name of the technology. Nullable: No


Default: ‘FWA’

10.2.40 PropagationModels Table

For propagation models.

Field Type Description Attributes

DATA Binary Propagation model parameter settings. Nullable: Yes


Default:

DESCRIPTION Text (255) Additional information about the propagation model. Nullable: Yes
Default:
NAME Text (50) Name of the propagation model. Nullable: No
Default:

SIGNATURE Text (40) Unique global ID of the most recent modification to model parameters. Nullable: No
Default:

TYPE Text (50) ProgID of the model. Nullable: No


Default:

10.2.41 Sites Table

For sites.

348 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

ALIAS_ Text (60) Site alias. Nullable: Yes


Default:

ALTITUDE Float User-defined site altitude. Nullable: Yes


Default:
COMMENT_ Text (255) Additional information about the site. Nullable: Yes
Default:

LATITUDE Double Y coordinate or latitude. Nullable: No


Default: 0

LONGITUDE Double X coordinate or longitude. Nullable: No


Default: 0
NAME Text (60) Name of the site. Nullable: No
Default:

PYLON_HEIGHT Float Height of the pylon. Nullable: Yes


Default: 50

SUPPORT_INFO Text (50) Type of support (pylon, tower, etc.) used at the site. Nullable: Yes
Default:

10.2.42 SitesLists Table

For sites belonging to site lists.

Field Type Description Attributes


LIST_NAME Text (50) Name of the site list. Nullable: No
Default:

SITE_NAME Text (60) Name of the sites belonging to the list. Nullable: No
Default:

10.2.43 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

NAME Text (50) Name of the site list. Nullable: No


Default:

10.2.44 Units Table

For the reception and transmission units, the projection coordinate system specified in the ATL document, and the
database internal coordinate system.

© 2018 Forsk. All Rights Reserved. 349


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Field Type Description Attributes

COORD_SYSTEM Integer Display coordinate system of the document. Nullable: Yes


Default: -1

GAIN_UNIT Integer Unit used for gains. 0=dBd; 1=dBi. Nullable: Yes
Default: 0
PROJECTION Integer Projection coordinate system of the document. Nullable: Yes
Default: -1

RECEPTION_UNIT Integer Signal level reception unit. 0=dBm; 1=dbµV; 2=dbµV/m; 3=V/m. Nullable: No
Default: 0

TRANSMISSION_UNIT Integer Transmission power unit. 0=dBm; 1=W; 2=kW. Nullable: No


Default: 0

10.3 Relationships

Many-to-One Relationships (  1)

BHNodes.SITE Sites.NAME

BHSegments.DEST_NODE BHNodes.NAME

BHSegments.SOURCE_NODE BHNodes.NAME

BHSegmentsMedia.DEST_NODE BHNodes.NAME

BHSegmentsMedia.MWLINK MWLinks.NAME

BHSegmentsMedia.OTHER_TLINK MWOTLinks.NAME

BHSegmentsMedia.SOURCE_NODE BHNodes.NAME

MWAntennas.FREQ_BAND MWBands.NAME

MWAntennas.MANUFACTURER MWManufacturers.NAME

MWCompatibilities.ANTENNA MWAntennas.NAME

MWCompatibilities.EQUIPMENT MWEquipments.NAME

MWCompatibilitiesGuides.ANTENNA MWAntennas.NAME

MWCompatibilitiesGuides.GUIDE MWGuides.NAME

MWDefaultsCurves.FREQ_BAND MWBands.NAME

MWDefaultsCurves.INTERFERED MWEquipments.NAME

MWDefaultsCurves.MANUFACTURER MWManufacturers.NAME

MWDefaultsCurves.MODULATION MWModulations.NAME

MWDesignRules.NAME MWBands.NAME

MWEPO.LINK_CLASS MWEPOLinkClass.NAME

MWEquipments.ACM_MODE MWOperatingModes.MODE_ID

MWEquipments.CAPACITY MWCapacities.NAME

MWEquipments.FAMILY MWFamilies.NAME

MWEquipments.FREQ_BAND MWBands.NAME

MWEquipments.MODULATION MWModulations.NAME

MWFamilies.MANUFACTURER MWManufacturers.NAME

MWFamilyBrConfigs.BRANCHING_CONFIG MWBranchingConfigs.NAME

MWFamilyBrConfigs.FAMILY MWFamilies.NAME

MWFamilyBrConfigs.FREQ_BAND MWBands.NAME

MWFrequencies.SUBBAND MWSubbands.NAME

350 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 10: Microwave Links Data Structure

Many-to-One Relationships (  1)

MWGuides.FREQ_BAND MWBands.NAME

MWGuides.MANUFACTURER MWManufacturers.NAME

MWHubs.ANTENNA MWAntennas.NAME

MWHubs.EQUIPMENT MWEquipments.NAME

MWHubs.FREQ_BAND MWBands.NAME

MWHubs.LINKS_TPL MWTplLinks.NAME

MWHubs.PROPAG_MODEL PropagationModels.NAME

MWHubs.RX_ANTENNA MWAntennas.NAME

MWHubs.SITE Sites.NAME

MWIrfs.INTERFERED MWEquipments.NAME

MWIrfs.INTERFERER MWEquipments.NAME

MWLinks.ANTENNA_A MWAntennas.NAME

MWLinks.ANTENNA_B MWAntennas.NAME

MWLinks.ANTENNA2_A MWAntennas.NAME

MWLinks.ANTENNA2_B MWAntennas.NAME

MWLinks.BRANCHING_CONFIG_A MWBranchingConfigs.NAME

MWLinks.BRANCHING_CONFIG_B MWBranchingConfigs.NAME

MWLinks.EPO_CLASS MWEPOLinkClass.NAME

MWLinks.EPO_IP_CLASS MWEPOLinkClass.NAME
MWLinks.EQUIPMENT_A MWEquipments.NAME

MWLinks.EQUIPMENT_B MWEquipments.NAME

MWLinks.FREQ_BAND MWBands.NAME
MWLinks.FREQ_SUBBAND MWSubbands.NAME

MWLinks.FREQ_SUBBAND_B MWSubbands.NAME

MWLinks.GUIDE1 MWGuides.NAME
MWLinks.GUIDE2 MWGuides.NAME

MWLinks.GUIDE3 MWGuides.NAME

MWLinks.GUIDE4 MWGuides.NAME
MWLinks.PROPAG_IMODEL PropagationModels.NAME

MWLinks.PROPAG_MODEL PropagationModels.NAME

MWLinks.REPEATER1 MWRepeaters.NAME

MWLinks.REPEATER2 MWRepeaters.NAME

MWLinks.SITE_A Sites.NAME

MWLinks.SITE_B Sites.NAME

MWMultiHops.EPO_CLASS MWEPOLinkClass.NAME

MWMultiHopsLinks.LINK MWLinks.NAME

MWMultiHopsLinks.MULTI_HOP MWMultiHops.NAME
MWMultiHopsLinks.OTLINK MWOTLinks.NAME

MWOTLinks.EPO_CLASS MWEPOLinkClass.NAME

MWOTLinks.MEDIUM_TYPE MWMediumTypes.NAME

MWOTLinks.SITE_A Sites.NAME

MWOTLinks.SITE_B Sites.NAME

MWPmp.HUB MWHubs.NAME

MWPmp.LINK MWLinks.NAME

© 2018 Forsk. All Rights Reserved. 351


Atoll 3.4.0 Data Structure Reference Guide
Chapter 10: Microwave Links Data Structure

Many-to-One Relationships (  1)

MWPorts.LINK MWLinks.NAME

MWRepeaters.ANTENNA MWAntennas.NAME

MWRepeaters.ANTENNA_2 MWAntennas.NAME

MWRepeaters.FREQ_BAND MWBands.NAME

MWRepeaters.FRONTAGE MWFrontages.NAME

MWRepeaters.GUIDE MWGuides.NAME

MWRepeaters.SITE Sites.NAME

MWSubbands.FREQ_BAND MWBands.NAME

MWTplHubs.ANTENNA MWAntennas.NAME

MWTplHubs.EQUIPMENT MWEquipments.NAME

MWTplHubs.FREQ_BAND MWBands.NAME

MWTplHubs.LINKS_TPL MWTplLinks.NAME

MWTplHubs.PROPAG_MODEL PropagationModels.NAME

MWTplHubs.RX_ANTENNA MWAntennas.NAME

MWTplLinks.ANTENNA_A MWAntennas.NAME

MWTplLinks.ANTENNA_B MWAntennas.NAME

MWTplLinks.ANTENNA2_A MWAntennas.NAME

MWTplLinks.ANTENNA2_B MWAntennas.NAME

MWTplLinks.BRANCHING_CONFIG_A MWBranchingConfigs.NAME
MWTplLinks.BRANCHING_CONFIG_B MWBranchingConfigs.NAME

MWTplLinks.EPO_CLASS MWEPOLinkClass.NAME

MWTplLinks.EPO_IP_CLASS MWEPOLinkClass.NAME
MWTplLinks.EQUIPMENT_A MWEquipments.NAME

MWTplLinks.EQUIPMENT_B MWEquipments.NAME

MWTplLinks.FREQ_BAND MWBands.NAME
MWTplLinks.FREQ_SUBBAND MWSubbands.NAME

MWTplLinks.FREQ_SUBBAND_B MWSubbands.NAME

MWTplLinks.GUIDE1 MWGuides.NAME
MWTplLinks.GUIDE2 MWGuides.NAME

MWTplLinks.GUIDE3 MWGuides.NAME

MWTplLinks.GUIDE4 MWGuides.NAME

MWTplLinks.PROPAG_IMODEL PropagationModels.NAME

MWTplLinks.PROPAG_MODEL PropagationModels.NAME

SitesLists.LIST_NAME SitesListsNames.NAME

SitesLists.SITE_NAME Sites.NAME

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

352 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 11: Radio Data Formats

11 Radio Data Formats


Radio network data in Atoll contains the following information, depending on the technology used in the network:
 Site: The geographic location of transmitters (sectors, installed antennas, other equipment). A site can have
one or more transmitters.
 Antenna: The radiation patterns and gains for antennas installed at transmitters.
 Transmitter: A group of radio devices installed at a site with there transmission/reception characteristics
(antennas, feeders, TMAs, other equipment). A transmitter can have one or more cells or subcells.
 Cell: An RF carrier available at a transmitter in UMTS, CDMA2000, TD-SCDMA, LTE, WiMAX, and Wi-Fi
networks. A cell 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 transmitter in GSM networks. A transceiver (TRX) can carry one ARFCN which
can correspond to the BCCH (7 traffic timeslots) or TCH (8 traffic timeslots).
 Subcell: A subcell is a group of TRXs with the same radio characteristics. A subcell is fully defined by the
"transmitter-TRX type" pair.
 Base station: This is the generic name for a cell site ("site-transmitter-cell" or "site-transmitter-subcells").
Technology-specific names can be BTS, Node-B, eNode-B, etc.
 RF repeater: An RF repeater receives, amplifies, and retransmits RF carriers both in downlink and uplink. The
repeater receives signals from a donor transmitter which it retransmits using a coverage-side antenna with
amplification.
 Remote antenna: Transmitter antennas located at a remote location with respect to the transmitter’s site.
 Microwave link: A point-to-point link using microwave frequencies used for backhaul in radio access networks
or for fixed wireless access.
 PMP microwave link: A group of microwave links originating from a common node to serve more than one
location.
 Passive microwave repeater: A passive microwave repeater receives and retransmits microwave signals
without amplification. Passive repeaters do not have power sources of their own. Active repeaters, on the
other hand, amplify the received signal. Reflectors are examples of passive repeaters.

11.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:
 An index.xml file which contains the mapping between the data tables in Atoll and the XML file created for
each table.
 One XML file per data table which contains the data table format (schema) and the data.
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.

© 2018 Forsk. All Rights Reserved. 353


Atoll 3.4.0 Data Structure Reference Guide
Chapter 11: Radio Data Formats

11.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:

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

11.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-00AA00C14882'
xmlns:dt='uuid:C2F41010-65B3-11d1-A29F-00AA00C14882'
xmlns:rs='urn:schemas-microsoft-com:rowset'
xmlns:z='#RowsetSchema'>

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

<s:Schema id=‘RowsetSchema’>
<!-Schema is defined here, 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>.

354 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 11: Radio Data Formats

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-00AA00C14882'
xmlns:dt='uuid:C2F41010-65B3-11d1-A29F-00AA00C14882'
xmlns:rs='urn:schemas-microsoft-com:rowset'
xmlns:z='#RowsetSchema'>
<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'
rs:fixedlength='true'/>
</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'
rs:fixedlength='true'/>
</s:AttributeType>
<s:AttributeType name='ALTITUDE' rs:number='4' rs:nullable='true'
rs:maydefer='true' rs:writeunknown='true' rs:basetable='Sites'
rs:basecolumn='ALTITUDE'>
<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:basecolumn='COMMENT_'>
<s:datatype dt:type='string' dt:maxLength='255'/>
</s:AttributeType>
<s:extends type='rs:rowbase'/>
</s:ElementType>
</s:Schema>
<rs:data>
<rs:insert>
<z:row NAME='Site0' LONGITUDE='8301' LATITUDE='-9756'/>
</rs:insert>
</rs:data>
</xml>

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

© 2018 Forsk. All Rights Reserved. 355


Atoll 3.4.0 Data Structure Reference Guide
Chapter 11: Radio Data Formats

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 357.
The format of 2D antenna patterns containing co-polar diagrams only can be understood from Figure 11.1 on
page 356.

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 11.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.
 Co-polar Horizontal Diagram: 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.
 Co-polar Vertical Diagram: 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
11.2 on page 356.

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 11.2: : 2D RF Antenna Pattern Format Containing Co-polar and Cross-polar Diagrams

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.
 Co-polar Horizontal Diagram: 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.

356 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 11: Radio Data Formats

 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.
 Co-polar Vertical Diagram: 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....
 Pattern Descriptor 3: 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.
 Cross-polar Horizontal Diagram: 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....
 Pattern Descriptor 4: 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.
 Cross-polar Vertical Diagram: 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.

11.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°.

© 2018 Forsk. All Rights Reserved. 357


Atoll 3.4.0 Data Structure Reference Guide
Chapter 11: Radio Data Formats

 Attenuation: The attenuation in dB.

11.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 357.
The format of 2D antenna patterns can be understood from Figure 11.3 on page 358.

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 11.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.
 Co-polar H-V Diagram: 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.
 Fourth entry: The number of angle-attenuation pairs in the second co-polar diagram. For example, 360.
 Co-polar H-H Diagram: 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....
 Pattern Descriptor 3: Space-separated list of parameters.
 First and second entries: Third diagram type = 1 1, for cross-polar H-V diagram ("EL VH" in Atoll).

358 © 2018 Forsk. All Rights Reserved.


Atoll 3.4.0 Data Structure Reference Guide
AT340_DSR_E2 Chapter 11: Radio Data Formats

 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.
 Cross-polar H-V Diagram: 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....
 Pattern Descriptor 4: 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.
 Cross-polar H-H Diagram: 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....
 Pattern Descriptor 5: 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.
 Co-polar V-V Diagram: 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....
 Pattern Descriptor 6: 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.
 Co-polar V-H Diagram: 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....
 Pattern Descriptor 7: 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.
 Cross-polar V-V Diagram: 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....
 Pattern Descriptor 8: 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.
 Cross-polar V-H Diagram: 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....

© 2018 Forsk. All Rights Reserved. 359


Head Office US Office China Office
7 rue des Briquetiers 200 South Wacker Drive – Suite 3100 Suite 302, 3/F, West Tower, Jiadu Commercial Building,
31700 Blagnac, France Chicago, IL 60606, USA No. 66 Jianzhong Road, Tianhe Hi-Tech Industrial Zone,
Tel: +33 562 747 210 Tel: +1 312 674 4800 Guangzhou, 510665, P. R. of China
Fax: +33 562 747 211 Fax: +1 312 674 4847 Tel: +86 20 8553 8938 Fax: +86 20 8553 8285

AT340_DSR_E2 www.forsk.com November 2018

You might also like