0% found this document useful (0 votes)
209 views464 pages

Atoll 3.5.0 Data Structure Reference Guide

Atoll 3.5

Uploaded by

dungbt81
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
209 views464 pages

Atoll 3.5.0 Data Structure Reference Guide

Atoll 3.5

Uploaded by

dungbt81
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 464

Wireless Network Engineering Software

Data Structure Reference Guide

Version 3.5.0

AT350_DSR_E0
Atoll 3.5.0 Data Structure Reference Guide
Release: AT350_DSR_E0 (March 2022)
© Copyright 1997-2022 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 license agreement. The software may only be used or copied under the terms and
conditions of the license 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 software shall be used by a human user in interactive mode, or in autonomous batch mode via scripts as described in the software
documentation. Licensee shall not drive or activate the software through a robot or through an external application that is not part of the
software.
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.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

Table of Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4 GSM GPRS EDGE Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.1 Data Structure Changes from Atoll 3.4 to 3.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
4.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
4.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.2.1 AfpModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
4.2.2 Antennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
4.2.3 BSICDomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
4.2.4 BSICGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
4.2.5 BTSEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
4.2.6 CellTypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
4.2.7 CodecEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
4.2.8 CodecModeAdaptations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
4.2.9 CodecModes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
4.2.10 CodecQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
4.2.11 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
4.2.12 CustomFields Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
4.2.13 EGPRSCodingSchemes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
4.2.14 EGPRSDimensioningModel Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
4.2.15 EGPRSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
4.2.16 EGPRSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
4.2.17 EGPRSMobility Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
4.2.18 EGPRSQuality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
4.2.19 EGPRSServiceQuality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
4.2.20 EGPRSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
4.2.21 EGPRSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
4.2.22 EGPRSTerminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
4.2.23 EGPRSTrafficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
4.2.24 EGPRSUserProfiles Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
4.2.25 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
4.2.26 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
4.2.27 FrequencyDomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
4.2.28 FrequencyGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
4.2.29 HSNDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
4.2.30 HSNGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
4.2.31 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
4.2.32 Layers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
4.2.33 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
4.2.34 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
4.2.35 NeighboursConstraintsExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
4.2.36 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
4.2.37 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
4.2.38 PropagationModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
4.2.39 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
4.2.40 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44

© 2022 Forsk. All Rights Reserved. 3


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

4.2.41 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44


4.2.42 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.2.43 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
4.2.44 SeparationRules Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
4.2.45 Separations Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
4.2.46 Sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
4.2.47 SitesLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
4.2.48 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4.2.49 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4.2.50 TplTransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4.2.51 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
4.2.52 TRGConfigurations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
4.2.53 TRGs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
4.2.54 TRXEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.2.55 TRXs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.2.56 TRXTypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2.57 TSConfigurationNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2.58 TSConfigurations Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2.59 TxsLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.60 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.61 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

5 UMTS HSPA Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63


5.1 Data Structure Changes from Atoll 3.4 to 3.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.2.1 Antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
5.2.2 BTSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
5.2.3 CDMACells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
5.2.4 CdmaEqptsHSUPARssUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
5.2.5 CDMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
5.2.6 CDMAEquipmentsCEsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
5.2.7 CoordSys Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
5.2.8 CustomFields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
5.2.9 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
5.2.10 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
5.2.11 HSDPABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
5.2.12 HSDPABearerSelectTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
5.2.13 HSDPAQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.2.14 HSPAMIMOConfigs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.2.15 HSUPABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.2.16 HSUPABearerSelection Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.2.17 HSUPAQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.2.18 HSUPAUECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.2.19 InterfReductionFactors Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.2.20 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.2.21 MUGTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.2.22 Neighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.2.23 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
5.2.24 NeighboursConstraintsExt Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
5.2.25 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
5.2.26 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
5.2.27 PropagationModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
5.2.28 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

4 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

5.2.29 R99Bearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78


5.2.30 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
5.2.31 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
5.2.32 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
5.2.33 Schedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
5.2.34 ScramblingCodesDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
5.2.35 ScramblingCodesGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
5.2.36 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
5.2.37 Separations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
5.2.38 ServiceQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
5.2.39 Sites Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
5.2.40 SitesLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
5.2.41 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
5.2.42 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
5.2.43 TplTransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
5.2.44 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
5.2.45 TxsLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
5.2.46 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
5.2.47 UECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
5.2.48 ulayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
5.2.49 UERxEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
5.2.50 UMTSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
5.2.51 UMTSMobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
5.2.52 UMTSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
5.2.53 UMTSServicesQuality Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
5.2.54 UMTSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
5.2.55 UMTSTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
5.2.56 UMTSTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
5.2.57 UMTSUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
5.2.58 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
5.2.59 uterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
5.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

6 CDMA2000 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99


6.1 Data Structure Changes from Atoll 3.4 to 3.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
6.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
6.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
6.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
6.2.1 Antennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
6.2.2 BTSEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.2.3 CarriersType Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
6.2.4 CDMACells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
6.2.5 CDMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.2.6 CDMAEquipmentsCEsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
6.2.7 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
6.2.8 CustomFields Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
6.2.9 DLBearersSelection Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
6.2.10 DLDORABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
6.2.11 DORABearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
6.2.12 DORABearersProba Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
6.2.13 DORATerminalT2PRatios Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
6.2.14 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
6.2.15 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
6.2.16 InterfReductionFactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
6.2.17 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
6.2.18 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

© 2022 Forsk. All Rights Reserved. 5


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

6.2.19 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109


6.2.20 NeighboursConstraintsExt Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
6.2.21 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
6.2.22 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
6.2.23 PnCodesDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
6.2.24 PnCodesGroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
6.2.25 PropagationModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
6.2.26 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
6.2.27 Receivers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
6.2.28 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
6.2.29 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
6.2.30 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6.2.31 Separations Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6.2.32 ServiceQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6.2.33 Sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
6.2.34 SitesLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
6.2.35 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
6.2.36 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
6.2.37 TplTransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
6.2.38 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
6.2.39 TxsLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
6.2.40 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
6.2.41 UERxEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
6.2.42 ULBearersSelection Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
6.2.43 UMTSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
6.2.44 UMTSMobility Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
6.2.45 UMTSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
6.2.46 UMTSServicesQuality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
6.2.47 UMTSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
6.2.48 UMTSTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
6.2.49 UMTSTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.2.50 UMTSUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.2.51 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

7 LTE Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131


7.1 Data Structure Changes from Atoll 3.4 to 3.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.2.1 Antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
7.2.2 BTSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
7.2.3 CoordSys Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
7.2.4 CustomFields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
7.2.5 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
7.2.6 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
7.2.7 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
7.2.8 lcagroupdefs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
7.2.9 lcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
7.2.10 lcchdivgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
7.2.11 lcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
7.2.12 lcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
7.2.13 lframeconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
7.2.14 llayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
7.2.15 lmbsfnareadefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
7.2.16 lmbsfnareas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

6 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

7.2.17 lpcidomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139


7.2.18 lpcigroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
7.2.19 lprachdomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
7.2.20 lprachgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
7.2.21 lrelayLinks Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
7.2.22 lrepetitions Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
7.2.23 lterminalbands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
7.2.24 MUGTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
7.2.25 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
7.2.26 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
7.2.27 NeighboursConstraintsExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
7.2.28 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
7.2.29 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
7.2.30 PropagationModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
7.2.31 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
7.2.32 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
7.2.33 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
7.2.34 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
7.2.35 Schedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
7.2.36 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
7.2.37 Sites Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
7.2.38 SitesLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
7.2.39 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
7.2.40 SmartAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
7.2.41 SmartAntennasModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
7.2.42 T4GBearerQualityCurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
7.2.43 T4GBearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
7.2.44 T4GBearersRequiredCI Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
7.2.45 T4GCells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
7.2.46 T4GEnvironmentDefs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
7.2.47 T4GEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
7.2.48 T4GMimoConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
7.2.49 T4GMobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
7.2.50 T4GServices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
7.2.51 T4GServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
7.2.52 T4GTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
7.2.53 T4GTraficEnvironments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
7.2.54 T4GUECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
7.2.55 T4GUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
7.2.56 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
7.2.57 TplTransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
7.2.58 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
7.2.59 TxsLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
7.2.60 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
7.2.61 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
7.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

8 5G Multi-RAT Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169


8.1 Data Tables Common to All Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
8.1.1 antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
8.1.2 btsequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
8.1.3 coordsys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
8.1.4 customfields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
8.1.5 environmentdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
8.1.6 feederequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
8.1.7 internetchprotect Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

© 2022 Forsk. All Rights Reserved. 7


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

8.1.8 mobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174


8.1.9 networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
8.1.10 propagationmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
8.1.11 receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
8.1.12 repeaterequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
8.1.13 services Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
8.1.14 servicesusage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
8.1.15 sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
8.1.16 siteslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
8.1.17 siteslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
8.1.18 terminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
8.1.19 tmaequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
8.1.20 trafficenvs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
8.1.21 units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
8.1.22 userprofiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
8.2 5G NR, LTE, NB-IoT, Wi-Fi Data Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
8.2.1 Data Structure Changes from Atoll 3.4 to 3.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
8.2.1.1 Added Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
8.2.1.2 Deleted Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
8.2.2 xgbeamsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
8.2.3 xgbeamsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
8.2.4 xgbearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
8.2.5 xgbfmodels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
8.2.6 xgbfpatterns Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
8.2.7 xgcagroupdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
8.2.8 xgcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
8.2.9 xgcarriers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
8.2.10 xgcchgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
8.2.11 xgcells5gnr Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
8.2.12 xgcellslte Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
8.2.13 xgcellsnbiot Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
8.2.14 xgcellsuids Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
8.2.15 xgcellswifi Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
8.2.16 xgcneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
8.2.17 xgcneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
8.2.18 xgcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
8.2.19 xgcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
8.2.20 xgequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
8.2.21 xgfreqbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
8.2.22 xggneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
8.2.23 xggneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
8.2.24 xgiddomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
8.2.25 xgidgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
8.2.26 xgirfs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
8.2.27 xglayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
8.2.28 xglayerthresholds Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
8.2.29 xgmuggains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
8.2.30 xgneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
8.2.31 xgneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
8.2.32 xgqigraphs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
8.2.33 xgrelaylinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
8.2.34 xgrepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
8.2.35 xgrepetitions Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
8.2.36 xgschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
8.2.37 xgsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
8.2.38 xgservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
8.2.39 xgsfnclusterdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

8 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

8.2.40 xgsfnclusters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208


8.2.41 xgtchgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
8.2.42 xgterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
8.2.43 xgterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
8.2.44 xgthresholds Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
8.2.45 xgtpltransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
8.2.46 xgtransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
8.2.47 xgtxslists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
8.2.48 xgtxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
8.2.49 xguecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
8.2.50 xguneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
8.2.51 xguneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
8.3 UMTS Data Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
8.3.1 ucells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
8.3.2 uceuse Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
8.3.3 uequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
8.3.4 ufrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
8.3.5 ugneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
8.3.6 ugneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
8.3.7 uhsdpabearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
8.3.8 uhsdpabearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
8.3.9 uhsdpaqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.10 uhspamimoconfigs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.11 uhsupabearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.12 uhsupabearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.13 uhsupaqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.14 uhsuparessuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.15 uhsupauecategories Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.16 uinterfreducfactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.17 ulayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
8.3.18 umobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.19 umugtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.20 uneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.21 uneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.22 upscdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.23 upscforbidpairs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.24 upscgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.25 uqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.26 ur99bearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
8.3.27 urepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.28 uschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.29 usecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.30 uservicequaltables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.31 uservices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.32 uservicesquality Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.33 uterminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.34 uterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
8.3.35 utpltransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
8.3.36 utransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
8.3.37 utxslists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
8.3.38 utxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
8.3.39 uuecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
8.3.40 uuerxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
8.3.41 uxgneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
8.3.42 uxgneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
8.4 GSM Data Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

© 2022 Forsk. All Rights Reserved. 9


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

8.4.1 gafpmodels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224


8.4.2 gbsicdomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
8.4.3 gbsicgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
8.4.4 gcelltypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
8.4.5 gcodecequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
8.4.6 gcodecmodeadapts Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.7 gcodecmodes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.8 gcodecqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.9 gcodingschemes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.10 gcsequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.11 gcsquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.12 gdimensmodel Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.13 gfreqdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.14 gfreqgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
8.4.15 gfrequencybands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.16 ghsndomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.17 ghsngroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.18 glayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.19 gneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.20 gneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.21 gqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.22 grepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.23 gsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
8.4.24 gseparationrules Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.25 gseparations Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.26 gservicequality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.27 gservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.28 gterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.29 gtpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.30 gtransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.31 gtrgconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
8.4.32 gtrgs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.33 gtrxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.34 gtrxs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.35 gtrxtypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.36 gtsconfignames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.37 gtsconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.38 gtxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.39 gtxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
8.4.40 guneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
8.4.41 guneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
8.4.42 gxgneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
8.4.43 gxgneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
8.5 CDMA Data Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
8.5.1 ccarrierstype Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
8.5.2 ccells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
8.5.3 cceuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
8.5.4 cdlbearerselect Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
8.5.5 cdldorabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
8.5.6 cdorabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
8.5.7 cdorabearersproba Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
8.5.8 cdoratermt2pratios Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
8.5.9 cequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
8.5.10 cfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
8.5.11 cinterfreducfactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
8.5.12 cmobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

10 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

8.5.13 cneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231


8.5.14 cneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
8.5.15 cpnodomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.16 cpnoforbidpairs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.17 cpnogroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.18 cqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.19 crepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.20 csecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.21 cservicequaltables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.22 cservices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.23 cservicesquality Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
8.5.24 cterminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.25 ctpltransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.26 ctransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.27 ctxslists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.28 ctxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.29 cuerxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.30 culbearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.31 cxgneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
8.5.32 cxgneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
8.6 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

9 In-Building Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243


9.1 Data Tables Common to All Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
9.1.1 antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
9.1.2 btsequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
9.1.3 coordsys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
9.1.4 customfields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
9.1.5 environmentdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
9.1.6 feederequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
9.1.7 internetchprotect Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
9.1.8 mobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
9.1.9 networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
9.1.10 propagationmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
9.1.11 receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
9.1.12 repeaterequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
9.1.13 services Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
9.1.14 servicesusage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
9.1.15 sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
9.1.16 siteslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
9.1.17 siteslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
9.1.18 terminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
9.1.19 tmaequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
9.1.20 trafficenvs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
9.1.21 units Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
9.1.22 userprofiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
9.2 5G NR, LTE, NB-IoT, Wi-Fi Data Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
9.2.1 Data Structure Changes from Atoll 3.4 to 3.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
9.2.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
9.2.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258
9.2.2 xgbeamsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
9.2.3 xgbeamsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
9.2.4 xgbearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
9.2.5 xgbfmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
9.2.6 xgbfpatterns Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
9.2.7 xgcagroupdefs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
9.2.8 xgcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

© 2022 Forsk. All Rights Reserved. 11


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

9.2.9 xgcarriers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262


9.2.10 xgcchgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
9.2.11 xgcells5gnr Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
9.2.12 xgcellslte Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
9.2.13 xgcellsnbiot Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
9.2.14 xgcellsuids Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
9.2.15 xgcellswifi Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
9.2.16 xgcneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
9.2.17 xgcneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
9.2.18 xgcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
9.2.19 xgcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
9.2.20 xgequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
9.2.21 xgfreqbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
9.2.22 xggneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
9.2.23 xggneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
9.2.24 xgiddomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
9.2.25 xgidgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
9.2.26 xgirfs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
9.2.27 xglayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
9.2.28 xglayerthresholds Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
9.2.29 xgmuggains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
9.2.30 xgneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
9.2.31 xgneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
9.2.32 xgqigraphs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
9.2.33 xgrelaylinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
9.2.34 xgrepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
9.2.35 xgrepetitions Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
9.2.36 xgschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
9.2.37 xgsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
9.2.38 xgservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
9.2.39 xgsfnclusterdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
9.2.40 xgsfnclusters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
9.2.41 xgtchgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
9.2.42 xgterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
9.2.43 xgterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
9.2.44 xgthresholds Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
9.2.45 xgtpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
9.2.46 xgtransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
9.2.47 xgtxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
9.2.48 xgtxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
9.2.49 xguecategories Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
9.2.50 xguneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.2.51 xguneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.3 UMTS Data Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.3.1 ucells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.3.2 uceuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
9.3.3 uequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.3.4 ufrequencybands Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.3.5 ugneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.3.6 ugneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.3.7 uhsdpabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.3.8 uhsdpabearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
9.3.9 uhsdpaqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.3.10 uhspamimoconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.3.11 uhsupabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.3.12 uhsupabearerselect Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294

12 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

9.3.13 uhsupaqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294


9.3.14 uhsuparessuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.3.15 uhsupauecategories Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.3.16 uinterfreducfactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.3.17 ulayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
9.3.18 umobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.19 umugtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.20 uneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.21 uneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.22 upscdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.23 upscforbidpairs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.24 upscgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.25 uqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.26 ur99bearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
9.3.27 urepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.28 uschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.29 usecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.30 uservicequaltables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.31 uservices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.32 uservicesquality Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.33 uterminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.34 uterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
9.3.35 utpltransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.3.36 utransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.3.37 utxslists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.3.38 utxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.3.39 uuecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.3.40 uuerxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.3.41 uxgneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
9.3.42 uxgneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.4 GSM Data Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.4.1 gafpmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.4.2 gbsicdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.4.3 gbsicgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.4.4 gcelltypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.4.5 gcodecequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
9.4.6 gcodecmodeadapts Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.7 gcodecmodes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.8 gcodecqualtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.9 gcodingschemes Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.10 gcsequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.11 gcsquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.12 gdimensmodel Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.13 gfreqdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.14 gfreqgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9.4.15 gfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.16 ghsndomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.17 ghsngroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.18 glayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.19 gneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.20 gneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.21 gqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.22 grepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.23 gsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
9.4.24 gseparationrules Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.4.25 gseparations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

© 2022 Forsk. All Rights Reserved. 13


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

9.4.26 gservicequality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301


9.4.27 gservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.4.28 gterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.4.29 gtpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.4.30 gtransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.4.31 gtrgconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
9.4.32 gtrgs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.33 gtrxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.34 gtrxs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.35 gtrxtypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.36 gtsconfignames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.37 gtsconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.38 gtxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.39 gtxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.4.40 guneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
9.4.41 guneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
9.4.42 gxgneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
9.4.43 gxgneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
9.5 In-Building Data Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
9.5.1 ibbuildings Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
9.5.2 ibcomponents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
9.5.3 ibconnections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
9.5.4 ibequipment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
9.5.5 ibequipmentports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
9.5.6 ibfloors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
9.5.7 ibgtransmitters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
9.5.8 ibintralosses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
9.5.9 ibports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
9.5.10 ibutransmitters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
9.5.11 ibxgtransmitters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
9.6 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

10 3GPP Multi-RAT Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317


10.1 Tables Common to 3GPP Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
10.1.1 Data Structure Changes from Atoll 3.4 to 3.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
10.1.1.1 Added Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
10.1.1.2 Deleted Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
10.1.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
10.1.2.1 antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
10.1.2.2 btsequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.3 coordsys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.4 customfields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.5 environmentdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.6 feederequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.7 internetchprotect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.8 mobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.9 networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
10.1.2.10 propagationmodels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
10.1.2.11 receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
10.1.2.12 repeaterequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
10.1.2.13 services Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
10.1.2.14 servicesusage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10.1.2.15 sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10.1.2.16 siteslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
10.1.2.17 siteslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
10.1.2.18 smartantennasmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
10.1.2.19 terminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
10.1.2.20 tmaequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
10.1.2.21 trafficenvs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
10.1.2.22 units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
10.1.2.23 userprofiles Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
10.2 GSM-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

14 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

10.2.1 Data Structure Changes from Atoll 3.2 to 3.3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323


10.2.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
10.2.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
10.2.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
10.2.2.1 gafpmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
10.2.2.2 gbsicdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
10.2.2.3 gbsicgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
10.2.2.4 gcelltypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
10.2.2.5 gcodecequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.6 gcodecmodeadapts Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.7 gcodecmodes Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.8 gcodecqualtables Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.9 gcodingschemes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.10 gcsequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.11 gcsquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.12 gdimensmodel Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.13 gfreqdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.14 gfreqgroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.15 gfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.16 ghsndomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
10.2.2.17 ghsngroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
10.2.2.18 glayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
10.2.2.19 glneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
10.2.2.20 glneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
10.2.2.21 gneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
10.2.2.22 gneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
10.2.2.23 gneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
10.2.2.24 gneighextconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.25 gqualityindicators Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.26 grepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.27 gsecondaryantennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.28 gseparationrules Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.29 gseparations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.30 gservicequality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.31 gservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.32 gterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.33 gtpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.34 gtransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
10.2.2.35 gtrgconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.36 gtrgs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.37 gtrxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.38 gtrxs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.39 gtrxtypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.40 gtsconfignames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.41 gtsconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.42 gtxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.43 gtxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.44 guneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
10.2.2.45 guneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
10.3 UMTS-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
10.3.1 Data Structure Changes from 3.3 to 3.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
10.3.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
10.3.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
10.3.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
10.3.2.1 ucells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
10.3.2.2 uceuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
10.3.2.3 uequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
10.3.2.4 ufrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
10.3.2.5 ugneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
10.3.2.6 ugneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
10.3.2.7 uhsdpabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
10.3.2.8 uhsdpabearerselect Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
10.3.2.9 uhsdpaqualtables Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
10.3.2.10 uhspamimoconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.11 uhsupabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.12 uhsupabearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.13 uhsupaqualtables Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.14 uhsuparessuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.15 uhsupauecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.16 uinterfreducfactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.17 ulayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
10.3.2.18 ulneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330

© 2022 Forsk. All Rights Reserved. 15


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

10.3.2.19 ulneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331


10.3.2.20 umobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.21 umugtables Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.22 uneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.23 uneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.24 uneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.25 uneighextconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.26 upscdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.27 upscforbidpairs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.28 upscgroups Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
10.3.2.29 uqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.30 ur99bearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.31 urepeaters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.32 uschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.33 usecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.34 uservicequaltables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.35 uservices Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.36 uservicesquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.37 uterminals Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.38 uterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.39 utpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
10.3.2.40 utransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.3.2.41 utxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.3.2.42 utxslistsnames Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.3.2.43 uuecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.3.2.44 uuerxequipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4 LTE-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4.1 Data Structure Changes from 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4.1.1 Added Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4.1.2 Deleted Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4.2.1 lbearerqualitycurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4.2.2 lbearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
10.4.2.3 lbearersrequiredci Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.4 lcagroupdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.5 lcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.6 lcells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.7 lcchdivgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.8 lcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.9 lcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.10 lequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.11 lframeconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.12 lfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.13 lgneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
10.4.2.14 lgneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.15 llayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.16 lmbsfnareadefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.17 lmbsfnareas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.18 lmimoconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.19 lmugtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.20 lneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.21 lneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
10.4.2.22 lneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.23 lneighextconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.24 lpcidomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.25 lpcigroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.26 lprachdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.27 lprachgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.28 lqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.29 lrelaylinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.30 lrepetitions Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.31 lrepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.32 lschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.33 lsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
10.4.2.34 lservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
10.4.2.35 lsmartantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
10.4.2.36 lterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
10.4.2.37 lterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
10.4.2.38 ltpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
10.4.2.39 ltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
10.4.2.40 ltxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
10.4.2.41 ltxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

16 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

10.4.2.42 luecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337


10.4.2.43 luneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337
10.4.2.44 luneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338

11 3GPP2 Multi-RAT Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339


11.1 Tables Common to 3GPP2 Technologies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
11.1.1 Data Structure Changes from Atoll 3.4 to 3.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
11.1.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339
11.1.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339
11.1.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
11.1.2.1 antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339
11.1.2.2 btsequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.3 coordsys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.4 customfields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.5 environmentdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.6 feederequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.7 internetchprotect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.8 mobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.9 networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
11.1.2.10 propagationmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342
11.1.2.11 receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342
11.1.2.12 repeaterequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342
11.1.2.13 services Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342
11.1.2.14 servicesusage Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343
11.1.2.15 sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343
11.1.2.16 siteslists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.1.2.17 siteslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.1.2.18 smartantennasmodels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.1.2.19 terminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.1.2.20 tmaequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.1.2.21 trafficenvs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.1.2.22 units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.1.2.23 userprofiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
11.2 CDMA2000-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
11.2.1 Data Structure Changes from 3.3 to 3.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
11.2.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2 Data Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
11.2.2.1 ccarrierstype Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2.2 ccells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2.3 cceuse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2.4 cdlbearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2.5 cdldorabearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2.6 cdorabearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2.7 cdorabearersproba Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
11.2.2.8 cdoratermt2pratios Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
11.2.2.9 cequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
11.2.2.10 cfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
11.2.2.11 cinterfreducfactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
11.2.2.12 clneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
11.2.2.13 clneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
11.2.2.14 cmobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
11.2.2.15 cneighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.16 cneighconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.17 cneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.18 cneighextconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.19 cpnodomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.20 cpnoforbidpairs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.21 cpnogroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.22 cqualityindicators Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.23 crepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.24 csecondaryantennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.25 cservicequaltables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.26 cservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
11.2.2.27 cservicesquality Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
11.2.2.28 cterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
11.2.2.29 ctpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
11.2.2.30 ctransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
11.2.2.31 ctxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
11.2.2.32 ctxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
11.2.2.33 cuerxequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348

© 2022 Forsk. All Rights Reserved. 17


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

11.2.2.34 culbearerselect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348


11.3 LTE-specific Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
11.3.1 Data Structure Changes from 3.3 to 3.4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
11.3.1.1 Added Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
11.3.1.2 Deleted Tables and Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
11.3.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.1 lbearerqualitycurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.2 lbearers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.3 lbearersrequiredci Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.4 lcagroupdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.5 lcagroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.6 lcells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.7 lcchdivgains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.8 lcneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
11.3.2.9 lcneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.10 lcompsetdefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.11 lcompsets Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.12 lequipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.13 lframeconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.14 lfrequencybands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.15 llayers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.16 lmbsfnareadefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.17 lmbsfnareas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.18 lmimoconfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
11.3.2.19 lmugtables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.20 lneighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.21 lneighconstraints Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.22 lneighext Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.23 lneighextconstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.24 lpcidomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.25 lpcigroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.26 lprachdomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.27 lprachgroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.28 lqualityindicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.29 lrelaylinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.30 lrepetitions Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
11.3.2.31 lrepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.32 lschedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.33 lsecondaryantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.34 lservices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.35 lsmartantennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.36 lterminalbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.37 lterminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.38 ltpltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.39 ltransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.40 ltxslists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.41 ltxslistsnames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
11.3.2.42 luecategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

12 TD-SCDMA Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355


12.1 Data Structure Changes from Atoll 3.4 to 3.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
12.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
12.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
12.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
12.2.1 Antennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
12.2.2 AntennasLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
12.2.3 AntennasListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
12.2.4 BTSEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
12.2.5 CDMACells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
12.2.6 CDMACellsTS Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
12.2.7 CDMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
12.2.8 CDMAEquipmentsCEsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
12.2.9 CodesRelativityClusters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
12.2.10 CoordSys Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
12.2.11 CustomFields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
12.2.12 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
12.2.13 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

18 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

12.2.14 HSDPABearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364


12.2.15 HSDPABearerSelectTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
12.2.16 HSUPABearers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
12.2.17 HSUPABearerSelection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
12.2.18 HSUPAUECategories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
12.2.19 InterfReductionFactors Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
12.2.20 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
12.2.21 Neighbours Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
12.2.22 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
12.2.23 NeighboursConstraintsExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
12.2.24 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
12.2.25 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
12.2.26 PropagationModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
12.2.27 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
12.2.28 R99Bearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
12.2.29 Receivers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
12.2.30 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
12.2.31 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
12.2.32 SACIGainCDF Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
12.2.33 ScramblingCodesDomains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
12.2.34 ScramblingCodesGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
12.2.35 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
12.2.36 Separations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
12.2.37 ServiceQualityTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
12.2.38 ServiceRUsUse Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
12.2.39 Sites Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
12.2.40 SitesLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
12.2.41 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
12.2.42 SmartAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
12.2.43 SmartAntennasModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
12.2.44 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
12.2.45 TplTransmitters Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
12.2.46 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
12.2.47 TxsLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
12.2.48 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
12.2.49 UECategories Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
12.2.50 UERxEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
12.2.51 UMTSEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
12.2.52 UMTSMobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
12.2.53 UMTSServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
12.2.54 UMTSServicesQuality Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
12.2.55 UMTSServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
12.2.56 UMTSTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
12.2.57 UMTSTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
12.2.58 UMTSUserProfiles Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
12.2.59 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
12.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

13 WiMAX, Wi-Fi, and LPWA Data Structures . . . . . . . . . . . . . . . . . . . . . . . . .391


13.1 Data Structure Changes from Atoll 3.4 to 3.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
13.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
13.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
13.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
13.2.1 Antennas Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
13.2.2 BTSEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
13.2.3 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

© 2022 Forsk. All Rights Reserved. 19


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

13.2.4 CustomFields Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394


13.2.5 FeederEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
13.2.6 FrameConfigurations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
13.2.7 FrequencyBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
13.2.8 InterNetChProtect Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
13.2.9 MUGTables Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
13.2.10 Neighbours Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
13.2.11 NeighboursConstraints Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
13.2.12 NeighboursConstraintsExt Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
13.2.13 NeighboursExt Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
13.2.14 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
13.2.15 PermutationZones Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
13.2.16 PropagationModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
13.2.17 QualityIndicators Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
13.2.18 Receivers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
13.2.19 RepeaterEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
13.2.20 Repeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
13.2.21 Schedulers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
13.2.22 SecondaryAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
13.2.23 Sites Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
13.2.24 SitesLists Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
13.2.25 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
13.2.26 SmartAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
13.2.27 SmartAntennasModels Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
13.2.28 TMAEquipments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
13.2.29 TplTransmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
13.2.30 Transmitters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
13.2.31 TxsLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
13.2.32 TxsListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
13.2.33 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
13.2.34 WBearerQualityCurves Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
13.2.35 WBearers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
13.2.36 WBearersRequiredCI Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
13.2.37 WCCHDivGains Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
13.2.38 WCells Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
13.2.39 WEnvironmentDefs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
13.2.40 WEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
13.2.41 WLayers Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
13.2.42 WMimoConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
13.2.43 WMobility Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
13.2.44 WPIDomains Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
13.2.45 WPIGroups Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
13.2.46 WServices Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
13.2.47 WServicesUsage Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418
13.2.48 WTerminals Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
13.2.49 WTraficEnvironments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
13.2.50 WUserProfiles Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
13.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

14 Microwave Links Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423


14.1 Data Structure Changes from Atoll 3.4 to 3.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
14.1.1 Added Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
14.1.2 Deleted Tables and Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
14.2 Data Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
14.2.1 BHNodes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
14.2.2 BHSegments Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424

20 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter :

14.2.3 BHSegmentsMedia Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424


14.2.4 CoordSys Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425
14.2.5 CustomFields Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
14.2.6 MWAntennas Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
14.2.7 MWBands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
14.2.8 MWBranchingConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
14.2.9 MWCapacities Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
14.2.10 MWCompatibilities Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
14.2.11 MWCompatibilitiesGuides Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
14.2.12 MWDefaultsCurves Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
14.2.13 MWDesignRules Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
14.2.14 MWEPO Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
14.2.15 MWEPOLinkClass Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
14.2.16 MWEquipments Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
14.2.17 MWFamilies Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
14.2.18 MWFamilyBrConfigs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
14.2.19 MWFrequencies Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
14.2.20 MWFrontages Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
14.2.21 MWGuides Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
14.2.22 MWHubs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
14.2.23 MWIrfs Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
14.2.24 MWLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
14.2.25 MWLinkTypes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
14.2.26 MWManufacturers Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
14.2.27 MWMediumTypes Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
14.2.28 MWModulations Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
14.2.29 MWMultiHops Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
14.2.30 MWMultiHopsLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
14.2.31 MWOperatingModes Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
14.2.32 MWOTLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
14.2.33 MWPMP Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
14.2.34 MWPorts Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
14.2.35 MWRepeaters Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
14.2.36 MWSubbands Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
14.2.37 MWTplHubs Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
14.2.38 MWTplLinks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
14.2.39 Networks Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
14.2.40 PropagationModels Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
14.2.41 Sites Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
14.2.42 SitesLists Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
14.2.43 SitesListsNames Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
14.2.44 Units Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
14.3 Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

15 Radio Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .457


15.1 XML Import/Export Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
15.1.1 Index.xml File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
15.1.2 XML File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
15.2 RF 2D Antenna Pattern Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
15.3 Import Format of 3D Antenna Pattern Text Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
15.4 Microwave 2D Antenna Pattern Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

© 2022 Forsk. All Rights Reserved. 21


Atoll 3.5.0 Data Structure Reference Guide
Chapter :

22 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 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 Microwave is a state-of-the-art point-to-point and point-to-multipoint backhaul planning and optimisation
software. It allows designing large microwave link networks, according to ITU recommendations, industry
standards, and operator guidelines.
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. The Online Help system provides information and guidance for using Atoll as well as

© 2022 Forsk. All Rights Reserved. 23


Atoll 3.5.0 Data Structure Reference Guide
Introduction

context-sensitive help about elements of the user interface. It contains the same material as the Atoll 3.5.0 User
Manual.
You can open the Online Help in Atoll from the Help menu or you can get context-sensitive help about any dialog
box by pressing F1 or clicking ’?’.
You can browse the online help from the Contents view, the Index view, or you can use the built-in Search feature.
You can click the Feedback button at the bottom of each page to send comments and suggestions to Forsk to help
us improve our documentation. Do not use the Documentation Feedback form for help using the product or for
technical support.
You can also download Atoll documentation from the Forsk web site at:
http://downloads.forsk.com/

About Atoll Documentation

PDF manuals are available to customers with a valid maintenance contract and can be downloaded from the Forsk
web site at:
http://downloads.forsk.com/
To read PDF manuals, download Adobe Reader from the Adobe web site at:
http://get.adobe.com/reader/

Contacting Technical Support

Forsk provides global technical support for its products and services. To contact the Forsk support team, visit the
Forsk web site at:
http://downloads.forsk.com
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: [email protected]
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
 Fax: +86 20 8553 8285
 Email: [email protected]
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: [email protected]
Opening Hours: Monday to Friday 9.00 am to 6.00 pm (GMT +1:00)

24 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Introduction

© 2022 Forsk. All Rights Reserved. 25


Atoll 3.5.0 Data Structure Reference Guide
Introduction

26 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

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

q Primary keys are listed in bold and italic characters.

4.1 Data Structure Changes from Atoll 3.4 to 3.5

4.1.1 Added Tables and Fields

None.

4.1.2 Deleted Tables and Fields

None.

4.2 Data Structure

4.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:

© 2022 Forsk. All Rights Reserved. 27


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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

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:

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

4.2.3 BSICDomains Table

For names of BSIC domains.

Field Type Description Attributes

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


Default:

28 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

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

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

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

4.2.6 CellTypes Table

For cell types.

Field Type Description Attributes

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


Default:

© 2022 Forsk. All Rights Reserved. 29


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

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

4.2.8 CodecModeAdaptations Table

For codec mode selection.

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:

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

30 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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


Default:

SELECTION_PRIORITY Short Codec mode selection priority. Nullable: No


Default: 0

4.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:
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:

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

© 2022 Forsk. All Rights Reserved. 31


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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.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:

32 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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

© 2022 Forsk. All Rights Reserved. 33


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

 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.13 EGPRSCodingSchemes Table

For GPRS, EGPRS, and EGPRS2 coding schemes.

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’

4.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_- Integer Maximum number of TRXs to add for packet-switched services. Nullable: Yes
FOR_PACKET 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_BLOCK- Boolean Whether the dimensioning model takes the blocking probability into account Nullable: No
ING_PROBA_KPI 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_THROUGH- Boolean Whether the dimensioning model takes the minimum throughput into Nullable: No
PUT_MIN_KPI account or not. True=Yes; False=No. Default: True
QUEUING_MODEL Text (50) Queuing model. Erlang B; Erlang C. Nullable: Yes
Default: ’Erlang B’

34 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

4.2.15 EGPRSEnvironmentDefs 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.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

4.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:

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

© 2022 Forsk. All Rights Reserved. 35


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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:

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:

4.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’

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

36 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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

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

4.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:

4.2.22 EGPRSTerminals Table

For terminal types.

© 2022 Forsk. All Rights Reserved. 37


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: 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:

4.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:

38 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

4.2.24 EGPRSUserProfiles Table

For names of user profiles.

Field Type Description Attributes

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


Default:

4.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:

4.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:

© 2022 Forsk. All Rights Reserved. 39


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

4.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:

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

4.2.29 HSNDomains Table

For names of HSN domains.

Field Type Description Attributes

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


Default:

4.2.30 HSNGroups Table

For HSN groups belonging to HSN domains.

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:

40 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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

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

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

4.2.33 Neighbours Table

For intra-technology neighbour relations.

© 2022 Forsk. All Rights Reserved. 41


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: 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:

4.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:

4.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:

4.2.36 NeighboursExt Table

For inter-technology neighbour relations.

42 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: 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:

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

4.2.38 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:

© 2022 Forsk. All Rights Reserved. 43


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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

4.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:

4.2.41 RepeaterEquipments Table

For repeater equipment.

44 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: 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

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

© 2022 Forsk. All Rights Reserved. 45


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: 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
q 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).

4.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:

4.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’

46 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

4.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:

4.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:

4.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:

© 2022 Forsk. All Rights Reserved. 47


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

4.2.48 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

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


Default:

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

4.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:

48 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: 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_RESE- Integer Cell reselection offset for GPRS/EDGE transmitter using PBCCH. Nullable: Yes
LECT_OFFSET Default:

© 2022 Forsk. All Rights Reserved. 49


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: 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_- Float Reception threshold value for GPRS/EDGE cells using PBCCH. Nullable: Yes
THRESHOLD 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:

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

50 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: 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:

© 2022 Forsk. All Rights Reserved. 51


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: 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_RESE- Integer Cell reselection offset for GPRS/EDGE transmitter using PBCCH. Nullable: Yes
LECT_OFFSET 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_- Float Reception threshold value for GPRS/EDGE cells using PBCCH. Nullable: Yes
THRESHOLD 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:

52 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: 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.

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

© 2022 Forsk. All Rights Reserved. 53


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: 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_TAR- Float The percentage of traffic that is considered to overflow from the subcell. Nullable: Yes
GET 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

4.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’

54 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: 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_OVER- Float Effective traffic overflow. Nullable: Yes


FLOW 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:

© 2022 Forsk. All Rights Reserved. 55


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

TRAFFIC_LOAD Float Traffic load of the subcell. Nullable: No


Default: 1

TRAFFIC_OVERFLOW_TAR- Float The percentage of traffic that is considered to overflow from the subcell. Nullable: Yes
GET 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

4.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:

4.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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_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

56 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: 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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0
UPLINK_NOISE_RISE Float Uplink noise rise. Unit: dB. Nullable: Yes
Default: 0

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

4.2.57 TSConfigurationNames Table

For names of timeslot configurations.

Field Type Description Attributes

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


Default:

4.2.58 TSConfigurations Table

For timeslot configurations.

© 2022 Forsk. All Rights Reserved. 57


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: 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

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, 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

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

58 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

Field Type Description Attributes

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)

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

NeighboursConstraints.NEIGHBOUR Transmitters.TX_ID

NeighboursConstraints.TRANSMITTER Transmitters.TX_ID

NeighboursConstraintsExt.TRANSMITTER Transmitters.TX_ID

© 2022 Forsk. All Rights Reserved. 59


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

Many-to-One Relationships ( ∞ 1)

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

TRXs.TRX_TYPE TRXTypes.NAME

TRXs.TX_ID Transmitters.TX_ID

TSConfigurations.NAME TSConfigurationNames.NAME

60 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 4: GSM GPRS EDGE Data Structure

Many-to-One Relationships ( ∞ 1)

TxsLists.LIST_NAME TxsListsNames.NAME

TxsLists.TX_NAME Transmitters.TX_ID

Units.COORD_SYSTEM CoordSys.CODE

Units.PROJECTION CoordSys.CODE

© 2022 Forsk. All Rights Reserved. 61


Atoll 3.5.0 Data Structure Reference Guide
Chapter 4: GSM GPRS EDGE Data Structure

62 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

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

q Primary keys are listed in bold and italic characters.

5.1 Data Structure Changes from Atoll 3.4 to 3.5

5.1.1 Added Tables and Fields

None.

5.1.2 Deleted Tables and Fields

None.

5.2 Data Structure

5.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:

© 2022 Forsk. All Rights Reserved. 63


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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:

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

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

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

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

64 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0

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


LOC 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:
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

© 2022 Forsk. All Rights Reserved. 65


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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:
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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0

5.2.4 CdmaEqptsHSUPARssUse Table

For HSUPA resource consumption in site equipment.

66 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

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

5.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_- Boolean Whether compressed mode is active or not. True=Yes; False=No. Nullable: No
MODE 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

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

5.2.6 CDMAEquipmentsCEsUse Table

For channel elements consumption in site equipment.

© 2022 Forsk. All Rights Reserved. 67


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

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:

5.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).

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

68 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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.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.

© 2022 Forsk. All Rights Reserved. 69


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

 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.5.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.

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

70 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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

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

5.2.12 HSDPABearerSelectTables Table

For HSDPA bearer selection graphs.

© 2022 Forsk. All Rights Reserved. 71


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

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:

5.2.13 HSDPAQualityTables Table

For HSDPA bearer performance graphs.

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:

5.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:

72 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

5.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:
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:

5.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:

5.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:

© 2022 Forsk. All Rights Reserved. 73


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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:

5.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:

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

74 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

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

5.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:

5.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:

© 2022 Forsk. All Rights Reserved. 75


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

5.2.23 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:

5.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:

5.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:

76 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

5.2.26 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

COM- Float Downlink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_DL_QUAL Default: 1

COM- Float Uplink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_UL_QUAL 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_PI- Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
LOT 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_- Float RSCP threshold for compressed mode activation. Unit: dB. Nullable: No
THRESHOLD 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

© 2022 Forsk. All Rights Reserved. 77


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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


Default: ‘UMTS’

TECHNOLOGY Text (10) Name of the technology. Nullable: No


Default: ‘CDMA’

5.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:

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

5.2.29 R99Bearers Table

For release 99 bearers.

Field Type Description Attributes

ACTIVE_SPREADING_FAC- Integer Downlink spreading factor for active users. Nullable: Yes
TOR_DL Default: 256
DL_NOMINAL_BIT_RATE Float Downlink nominal throughput of the R99 bearer. Unit: kbps. Nullable: Yes
Default: 9.6

78 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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_FAC- Integer Downlink spreading factor for inactive users. Nullable: Yes
TOR_DL Default: 256
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
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

5.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:

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

© 2022 Forsk. All Rights Reserved. 79


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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

5.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:

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

80 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

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

5.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:

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

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

© 2022 Forsk. All Rights Reserved. 81


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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:

5.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:

5.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:

5.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:

82 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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:

5.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:

5.2.41 SitesListsNames Table

For names of site lists.

Field Type Description Attributes


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

5.2.42 TMAEquipments Table

For tower-mounted amplifiers.

© 2022 Forsk. All Rights Reserved. 83


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA 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

5.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:

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:

84 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

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:

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:

© 2022 Forsk. All Rights Reserved. 85


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: 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: 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:

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:

86 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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:

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:

© 2022 Forsk. All Rights Reserved. 87


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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

UPLINK_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default:

5.2.44 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

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

88 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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

© 2022 Forsk. All Rights Reserved. 89


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

5.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:

5.2.46 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

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


Default:

5.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:

5.2.48 ulayers Table

For heterogeneous network (HetNet) deployment layers.

90 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

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.49 UERxEquipments Table

For names of UE reception equipment.

Field Type Description Attributes

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


Default:

5.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:

5.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:

© 2022 Forsk. All Rights Reserved. 91


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

5.2.52 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

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”

92 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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

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

© 2022 Forsk. All Rights Reserved. 93


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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

5.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:

5.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_- Boolean Whether compressed mode is active or not. True=Yes; False=No. Nullable: No
MODE 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:

94 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Field Type Description Attributes

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

5.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:

5.2.57 UMTSUserProfiles Table

For names of user profiles.

Field Type Description Attributes

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


Default:

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

© 2022 Forsk. All Rights Reserved. 95


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA 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

5.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:

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

96 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 5: UMTS HSPA Data Structure

Many-to-One Relationships ( ∞ 1)

HSPAMIMOConfigs.HSDPA_BEARER_INDEX HSDPABearers.BEARER_INDEX

HSPAMIMOConfigs.MOBILITY UMTSMobility.NAME

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

© 2022 Forsk. All Rights Reserved. 97


Atoll 3.5.0 Data Structure Reference Guide
Chapter 5: UMTS HSPA Data Structure

Many-to-One Relationships ( ∞ 1)

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

uterminalbands.FBAND_NAME FrequencyBands.NAME
uterminalbands.TERMINAL_NAME UMTSTerminals.NAME

98 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

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

q Primary keys are listed in bold and italic characters.

6.1 Data Structure Changes from Atoll 3.4 to 3.5

6.1.1 Added Tables and Fields

None.

6.1.2 Deleted Tables and Fields

None.

6.2 Data Structure

6.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:

© 2022 Forsk. All Rights Reserved. 99


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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:

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

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

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

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

100 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

6.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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_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

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:

© 2022 Forsk. All Rights Reserved. 101


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0

6.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:

102 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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

6.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:

6.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).

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

© 2022 Forsk. All Rights Reserved. 103


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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

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

104 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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

© 2022 Forsk. All Rights Reserved. 105


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

6.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"

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

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

6.2.12 DORABearersProba Table

For uplink EV-DO Rev. A bearer probabilities.

106 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

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:

6.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:

6.2.14 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:

6.2.15 FrequencyBands Table

For frequency bands.

© 2022 Forsk. All Rights Reserved. 107


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

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:

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

6.2.17 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

6.2.18 Neighbours Table

For intra-technology neighbour relations.

108 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

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:

6.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:

6.2.20 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 (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.21 NeighboursExt Table

For inter-technology neighbour relations.

© 2022 Forsk. All Rights Reserved. 109


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

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.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:
NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False

POWERS_RELATIVE_TO_PI- Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
LOT 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’

110 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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

6.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:

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

6.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:

© 2022 Forsk. All Rights Reserved. 111


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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:

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

6.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:

6.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:

112 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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

6.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:

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

© 2022 Forsk. All Rights Reserved. 113


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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:

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

6.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:

6.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:

6.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:

114 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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:

6.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:

6.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:

© 2022 Forsk. All Rights Reserved. 115


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

6.2.35 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

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


Default:

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

6.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:
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:

116 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_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:
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:

© 2022 Forsk. All Rights Reserved. 117


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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
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:

118 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default:

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

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

© 2022 Forsk. All Rights Reserved. 119


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 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:

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:
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:

120 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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.

6.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:

6.2.40 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

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


Default:

6.2.41 UERxEquipments Table

For UE reception equipment.

Field Type Description Attributes

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


Default:

6.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:

© 2022 Forsk. All Rights Reserved. 121


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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"

6.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:

6.2.44 UMTSMobility Table

For mobility types.

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

6.2.45 UMTSServices Table

For services.

122 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

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

© 2022 Forsk. All Rights Reserved. 123


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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

6.2.46 UMTSServicesQuality Table

For 1xRTT service access thresholds.

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:

124 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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:

6.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:

6.2.48 UMTSTerminals Table

For terminal types.

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

© 2022 Forsk. All Rights Reserved. 125


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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

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

126 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Field Type Description Attributes

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

6.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:

6.2.50 UMTSUserProfiles Table

For names of user profiles.

Field Type Description Attributes

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


Default:

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

© 2022 Forsk. All Rights Reserved. 127


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

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

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

128 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 6: CDMA2000 Data Structure

Many-to-One Relationships ( ∞ 1)

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

© 2022 Forsk. All Rights Reserved. 129


Atoll 3.5.0 Data Structure Reference Guide
Chapter 6: CDMA2000 Data Structure

130 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

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

q Primary keys are listed in bold and italic characters.

7.1 Data Structure Changes from Atoll 3.4 to 3.5

7.1.1 Added Tables and Fields

None.

7.1.2 Deleted Tables and Fields

None.

7.2 Data Structure

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

© 2022 Forsk. All Rights Reserved. 131


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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:

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

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

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

132 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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

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

© 2022 Forsk. All Rights Reserved. 133


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

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.
 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.5.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.

134 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

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

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

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

© 2022 Forsk. All Rights Reserved. 135


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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:

7.2.7 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

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

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

136 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Field Type Description Attributes

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:

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

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

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

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

© 2022 Forsk. All Rights Reserved. 137


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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

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

138 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

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

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

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

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

© 2022 Forsk. All Rights Reserved. 139


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

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

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

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

140 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

7.2.21 lrelayLinks Table

For donor-side propagation parameters of relay nodes.

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

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

7.2.23 lterminalbands Table

For frequency bands supported by terminals.

© 2022 Forsk. All Rights Reserved. 141


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: 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:

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

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

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 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

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

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

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

© 2022 Forsk. All Rights Reserved. 143


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

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

144 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

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

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

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

© 2022 Forsk. All Rights Reserved. 145


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

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

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

146 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: 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:

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

7.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_- Short Target throughput when scheduling data services. 0=Peak RLC Throughput; Nullable: Yes
DATA 1=Effective RLC Throughput; 2=Application Throughput. Default: 0

TARGET_THROUGH- Short Target throughput when scheduling voice services. 0=Peak RLC Throughput; Nullable: Yes
PUT_VOICE 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

7.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. Unit: %. Nullable: No
Default: 0

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

© 2022 Forsk. All Rights Reserved. 147


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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:

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

7.2.38 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:

7.2.39 SitesListsNames Table

For names of site lists.

148 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Field Type Description Attributes

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


Default:

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

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

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

© 2022 Forsk. All Rights Reserved. 149


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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:

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

7.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_COVER- Memo Uplink bearer selection thresholds. Nullable: Yes
I_UL 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) Reception equipment corresponding to the bearer selection thresholds. Nullable: No
Default:

SCELL_THRESHOLD Float SCell activation threshold. Unit: dB. Nullable: Yes


Default:

7.2.45 T4GCells Table

For cells.

150 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

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.

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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_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

© 2022 Forsk. All Rights Reserved. 151


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: 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: 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
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

152 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Field Type Description Attributes

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

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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0

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

© 2022 Forsk. All Rights Reserved. 153


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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:

7.2.47 T4GEquipments Table

For reception equipment.

Field Type Description Attributes

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


Default:

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

7.2.49 T4GMobility Table

For mobility types.

154 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE 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:

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

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:

© 2022 Forsk. All Rights Reserved. 155


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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

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

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

156 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Field Type Description Attributes

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:

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

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:

© 2022 Forsk. All Rights Reserved. 157


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

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

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

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:

7.2.55 T4GUserProfiles Table

For names of user profiles.

Field Type Description Attributes

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


Default:

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

158 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Field Type Description Attributes

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

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

© 2022 Forsk. All Rights Reserved. 159


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

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.

160 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Field Type Description Attributes

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:
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:

© 2022 Forsk. All Rights Reserved. 161


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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:
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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default:

162 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

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

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:

© 2022 Forsk. All Rights Reserved. 163


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Field Type Description Attributes

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.

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

164 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

7.2.60 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

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


Default:

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

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

© 2022 Forsk. All Rights Reserved. 165


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

Many-to-One Relationships ( ∞ 1)

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

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

166 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 7: LTE Data Structure

Many-to-One Relationships ( ∞ 1)

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

© 2022 Forsk. All Rights Reserved. 167


Atoll 3.5.0 Data Structure Reference Guide
Chapter 7: LTE Data Structure

168 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8 5G Multi-RAT Data Structure


5G Multi-RAT Atoll documents can contain 5G NR, LTE, NB-IoT, and Wi-Fi technologies in combination with GSM and
UMTS, or CDMA2000. Tables in the 5G Multi-RAT template include the following categories of tables:
 "Data Tables Common to All Technologies" on page 169: These tables are shared and used by all the
technologies.
 "5G NR, LTE, NB-IoT, Wi-Fi Data Tables" on page 180: These tables are shared and used by 5G NR, LTE, NB-IoT,
and Wi-Fi.
 "UMTS Data Tables" on page 218: These tables are shared and used by UMTS.
 "GSM Data Tables" on page 224: These tables are shared and used by GSM.
 "CDMA Data Tables" on page 230: These tables are shared and used by CDMA2000.

q Primary keys are listed in bold and italic characters.

8.1 Data Tables Common to All Technologies

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

© 2022 Forsk. All Rights Reserved. 169


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:

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

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

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

170 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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.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:

© 2022 Forsk. All Rights Reserved. 171


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT 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.5.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

172 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT 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.

8.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:

8.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:

8.1.7 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:

© 2022 Forsk. All Rights Reserved. 173


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

V_TECHNO Text (50) Name of the interfered technology. Nullable: No


Default:

8.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:

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

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

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: 2
COM- Float Downlink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_DL_QUAL Default: 1

COM- Float Uplink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_UL_QUAL 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: 100
DMAX Float Maximum radius for a cell. Nullable: No
Default: -1

174 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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 Whether Io includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: True
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:

NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False
POWER_CONTROL_MARGIN Float Uplink power adjustment margin. Unit: dB. Nullable: Yes
Default: 1

POWERS_RELATIVE_TO_PI- Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
LOT 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_- Float RSCP threshold for compressed mode activation. Unit: dB. Nullable: No
THRESHOLD 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

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”

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

8.1.10 propagationmodels Table

For propagation models.

© 2022 Forsk. All Rights Reserved. 175


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT 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 Nullable: No
Default:

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


Default:

8.1.11 receivers Table

For receiver parameters.

Field Type Description Attributes

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

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:

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

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


Default:

176 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

8.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:

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:

© 2022 Forsk. All Rights Reserved. 177


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

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

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
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:

8.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:

178 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.1.17 siteslistsnames Table

For names of site lists.

Field Type Description Attributes

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


Default:

8.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”

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

8.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:

© 2022 Forsk. All Rights Reserved. 179


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

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

BSIC_FORMAT Integer GSM 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

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:

8.1.22 userprofiles Table

For names of user profiles.

Field Type Description Attributes

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


Default:

8.2 5G NR, LTE, NB-IoT, Wi-Fi Data Tables

8.2.1 Data Structure Changes from Atoll 3.4 to 3.5

8.2.1.1 Added Tables and Fields


xgbeamsetdefs Table (New)

Field Type Description Attributes

BEAM_INDEX Integer Index of the beam effectively used by the beam set. Nullable: No
Default:
BEAM_SET_NAME Text (50) Name of the beam set to which the used beam index belongs. Nullable: No
Default:

SWEEP_ORDER Short The order in which broadcast beams are transmitted, or the SS/PBCH index Nullable: Yes
corresponding to the broadcast beam transmission. Min: 0; Max: 63. Default: 0

180 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

xgbeamsets Table (New)

Field Type Description Attributes

BEAMWIDTH Float Horizontal half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:
BF_MODEL Text (50) Name of the beamforming model to which the beam set belongs. Nullable: No
Default:

CONFIGURATION Text (50) Configuration of the beam set. Examples: 120deg + 2 SSB beams, 90deg + Nullable: Yes
4 SSB beams, etc. Default:

N_RX_PORTS Short The number of reception antenna ports effectively used by the beam set. Nullable: No
Default: 4
N_TX_PORTS Short The number of transmission antenna ports effectively used by the beam set. Nullable: No
Default: 4

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


Default:

SCENARIO Text (50) Name of the scenario to which the beam set belongs. Examples: Macro, high- Nullable: Yes
rise, hot spot, etc. Default:
TILT Float Electrical tilt of the beam set. Used by the ACP for beam set selection. Nullable: Yes
Default:

V_BEAMWIDTH Float Vertical half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:

xgbfmodels Table

Field Type Description Attributes

BF_METHOD Short Whether the 3D beamforming model uses switched beam or adaptive beam- Nullable: Yes
forming. 0=NULL=Switched Beam; 1=Adaptive. Default: 0

BF_RANGE Short Whether the adaptive beamforming model create beams automatically Nullable: Yes
based on the logical element pattern’s horizontal and vertical beamwidths or Default: 0
within a user-defined range of azimuth and tilt values. 0=NULL=Automatic;
1=User-defined.

ELEMENT_PATTERN Text (50) Name of the antenna pattern corresponding to the logical element of the Nullable: Yes
beamforming model. Default:
MAX_AZIMUTH Float Highest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MIN_AZIMUTH Float Lowest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MAX_TILT Float Highest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0
MIN_TILT Float Lowest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0

xgbfpatterns Table

Field Type Description Attributes

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

PCG Float The value of the user-defined power combining gain. Nullable: Yes
Default:

PCG_STATUS Short Whether the power combining gain is to be applied or not, calculated auto- Nullable: Yes
matically or user defined. NULL=0=None; 1=Automatic; 2=User-defined. Default: 0
V_BEAMWIDTH Float Vertical half-power beamwidth of the beam pattern. Nullable: Yes
Default:

© 2022 Forsk. All Rights Reserved. 181


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

xgcells5gnr Table

Field Type Description Attributes

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:
BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

CSIRS_POWER_OFFSET Float EPRE offset for CSI-RS with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 0

PAIRED_CELL_NAME Text (100) Name of the LTE cell paired with the 5G NR cell for spectrum sharing. Nullable: Yes
Default:
SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

SSB_FREQ_OFFSET Integer Number of subcarriers between the first SS/PBCH subcarrier and the refer- Nullable: Yes
ence point A. Default: 0

SSB_TRAFFIC_MUX Short Whether the cell can transmit PDCCH and PDSCH in slots carrying SS/PBCH Nullable: Yes
or not. 0=Off; 1=NULL= On. Default: 1
UL_FPC_CINR_MAX Float Uplink C/(I+N) target driven by noise rise limitation of neighbouring cells. Nullable: Yes
Unit: dB. Default: 20

xgcellslte Table

Field Type Description Attributes


BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

PA_OFFSET Float EPRE offset of type A OFDM symbols ( symbols that do not contain LTE CRS) Nullable: Yes
with respect to the RS EPRE. Unit: dB. 3GPP values: -6; -4.77; -3; -1.77; 0; 1; 2; 3. Default: 0

PB_OFFSET Float EPRE offset of type B OFDM symbols ( symbols that contain LTE CRS) with Nullable: Yes
respect to the RS EPRE. Unit: dB. 3GPP values: 0; 1; 2; 3. Default: 0
RS_BOOST Short Whether or not the RS EPRE must be boosted based on the number of CRS Nullable: Yes
ports. 0=No; 1=Yes. Default: 0

xgcellsuids Table

Field Type Description Attributes


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

xgcellswifi Table (New)

Field Type Description Attributes

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


Default: True

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1
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:

182 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: No


Default: 1
COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: Yes
Default: -140

CYCLIC_PREFIX Short Cyclic prefix used by the cell. 0=Short; 1=Long; 2=Extended. Nullable: Yes
Default: 0

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:

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 per carrier. Nullable: Yes
Default: 43
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:

TX_CELL_ORDER Short Order of the cell within the sector. Nullable: Yes
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

© 2022 Forsk. All Rights Reserved. 183


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:

xglayerthresholds Table (New)

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer for which the threshold is defined. Nullable: No
Default:
MOBILITY Text (50) Name of the mobility type corresponding to the control channel diversity Nullable: No
gains. Default:

RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT; 2=5G NR; 3=Wi-Fi. Nullable: No
Default:

THRESHOLD Float Coverage threshold defined for the combination of RAT, mobility type, and Nullable: No
layer. Default: -300

THRESHOLD_INDEX Integer Record index. Nullable: No


Default:

xgtpltransmitters Table

Field Type Description Attributes

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:
BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: Yes


Default: 1

COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: No


Default: -140
SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

8.2.1.2 Deleted Tables and Fields


xgcells5gnr Table
 TX_ID

xgcellslte Table
 TX_ID

xgcellsnbiot Table
 TX_ID

184 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.2.2 xgbeamsetdefs Table

Field Type Description Attributes

BEAM_INDEX Integer Index of the beam effectively used by the beam set. Nullable: No
Default:
BEAM_SET_NAME Text (50) Name of the beam set to which the used beam index belongs. Nullable: No
Default:

SWEEP_ORDER Short The order in which broadcast beams are transmitted, or the SS/PBCH index Nullable: Yes
corresponding to the broadcast beam transmission. Min: 0; Max: 63. Default: 0

8.2.3 xgbeamsets Table

Field Type Description Attributes

BEAMWIDTH Float Horizontal half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:

BF_MODEL Text (50) Name of the beamforming model to which the beam set belongs. Nullable: No
Default:
CONFIGURATION Text (50) Configuration of the beam set. Examples: 120deg + 2 SSB beams, 90deg + Nullable: Yes
4 SSB beams, etc. Default:

N_RX_PORTS Short The number of reception antenna ports effectively used by the beam set. Nullable: No
Default: 4

N_TX_PORTS Short The number of transmission antenna ports effectively used by the beam set. Nullable: No
Default: 4
NAME Text (50) Name of the beam set. Nullable: No
Default:

SCENARIO Text (50) Name of the scenario to which the beam set belongs. Examples: Macro, high- Nullable: Yes
rise, hot spot, etc. Default:

TILT Float Electrical tilt of the beam set. Used by the ACP for beam set selection. Nullable: Yes
Default:

V_BEAMWIDTH Float Vertical half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:

8.2.4 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:

© 2022 Forsk. All Rights Reserved. 185


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

8.2.5 xgbfmodels Table

For 3D beamforming models.

Field Type Description Attributes


BF_METHOD Short Whether the 3D beamforming model uses switched beam or adaptive beam- Nullable: Yes
forming. 0=NULL=Switched Beam; 1=Adaptive. Default: 0

BF_RANGE Short Whether the adaptive beamforming model create beams automatically Nullable: Yes
based on the logical element pattern’s horizontal and vertical beamwidths or Default: 0
within a user-defined range of azimuth and tilt values. 0=NULL=Automatic;
1=User-defined.

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

ELEMENT_PATTERN Text (50) Name of the antenna pattern corresponding to the logical element of the Nullable: Yes
beamforming model. Default:

FMAX Float Highest operating frequency. Unit: MHz. Nullable: Yes


Default:
FMIN Float Lowest operating frequency. Unit: MHz. Nullable: Yes
Default:

MAX_AZIMUTH Float Highest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MIN_AZIMUTH Float Lowest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0
MAX_TILT Float Highest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MIN_TILT Float Lowest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0

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

186 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.2.6 xgbfpatterns Table

For 3D beamforming beam patterns.

Field Type Description Attributes

ACTIVE Boolean Whether the beam is active (used in calculations) or not. Nullable: No
Default: True

AZIMUT Float Direction of the beam in the horizontal plane. Nullable: No


Default:

BEAM_INDEX Integer Index of the beam. Nullable: No


Default:
BEAM_TYPE Short The type of channels for which the beam can be used. 1=Broadcast; Nullable: No
2=Refinement; 4=Service. Default: 7

BEAMWIDTH Float Horizontal half-power beamwidth of the beam pattern. Nullable: Yes
Default:

BF_MODEL Text (50) Name of the beamforming model to which the beam belongs. Nullable: No
Default:
COMMENT_ Text (255) Additional information about the beam pattern. Nullable: Yes
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:

PCG Float The value of the user-defined power combining gain. Nullable: Yes
Default:

PCG_STATUS Short Whether the power combining gain is to be applied or not, calculated auto- Nullable: Yes
matically or user defined. NULL=0=None; 1=Automatic; 2=User-defined. Default: 0
TILT Float Direction of the beam in the vertical plane. Nullable: No
Default:

V_BEAMWIDTH Float Vertical half-power beamwidth of the beam pattern. Nullable: Yes
Default:

8.2.7 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:

8.2.8 xgcagroups Table

For carrier aggregation group names and parameters.

© 2022 Forsk. All Rights Reserved. 187


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

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:

8.2.9 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

8.2.10 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

188 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.2.11 xgcells5gnr Table

For 5G NR cells.

Field Type Description Attributes

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


Default: True

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1
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:

CSIRS_POWER_OFFSET Float EPRE offset for CSI-RS with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 0
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

© 2022 Forsk. All Rights Reserved. 189


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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 per carrier. Nullable: Yes
Default: 43

MIN_SSSRSRP Float Minimum SSS RSRP required for coverage. Nullable: Yes
Default: -140
PAIRED_CELL_NAME Text (100) Name of the LTE cell paired with the 5G NR cell for spectrum sharing. Nullable: Yes
Default:

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:
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; 1=1; 2=2; 3=3; 4=A1; 5=A2; 6=A3; 7=B1; 8=B2; Nullable: Yes
9=B3; 10=B4; 11=C0; 12=C2 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:
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:

190 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

SSB_FREQ_OFFSET Integer Number of subcarriers between the first SS/PBCH subcarrier and the refer- Nullable: Yes
ence point A. Default: 0

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
SSS_POWER Float SSS EPRE (dBm) Nullable: Yes
Default: 15

SSB_TRAFFIC_MUX Short Whether the cell can transmit PDCCH and PDSCH in slots carrying SS/PBCH Nullable: Yes
or not. 0=Off; 1=NULL= On. Default: 1

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:

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_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_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:

8.2.12 xgcellslte Table

For LTE cells.

© 2022 Forsk. All Rights Reserved. 191


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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


Default: True

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:
BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

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

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 corresponding 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

192 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:
MAX_POWER Float Maximum cell transmission power per carrier and per CRS port. 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:
PA_OFFSET Float EPRE offset of type A OFDM symbols ( symbols that do not contain LTE CRS) Nullable: Yes
with respect to the RS EPRE. Unit: dB. 3GPP values: -6; -4.77; -3; -1.77; 0; 1; 2; 3. Default: 0

PB_OFFSET Float EPRE offset of type B OFDM symbols ( symbols that contain LTE CRS) with Nullable: Yes
respect to the RS EPRE. Unit: dB. 3GPP values: 0; 1; 2; 3. Default: 0

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:

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=0; 1=1; 2=2; 3=3; 4=4. Nullable: Yes
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:

© 2022 Forsk. All Rights Reserved. 193


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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_BOOST Short Whether or not the RS EPRE must be boosted based on the number of CRS Nullable: Yes
ports. 0=No; 1=Yes. Default: 0
RS_EPRE Float Energy per resource element of reference signals corresponding to antenna Nullable: Yes
elements mapped to one CRS port. 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

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:
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

194 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:

8.2.13 xgcellsnbiot Table

For NB-IoT cells.

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:

© 2022 Forsk. All Rights Reserved. 195


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

MAX_POWER Float Maximum cell transmission power per carrier and per NRS port. 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:

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

NPRACH_PREAMBLE_FOR- Short NPRACH preamble format. 0=0; 1=1. Nullable: Yes


MAT 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 correspond- Nullable: Yes
ing to antenna elements mapped to one NRS port. 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:

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:

196 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.2.14 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; 3=Wi-Fi. Nullable: No
Default: 0

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

8.2.15 xgcellswifi Table

Field Type Description Attributes

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


Default: True
BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

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:

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:

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: No


Default: 1
COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: Yes
Default: -140

CYCLIC_PREFIX Short Cyclic prefix used by the cell. 0=Short; 1=Long; 2=Extended. Nullable: Yes
Default: 0

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

© 2022 Forsk. All Rights Reserved. 197


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:

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 per carrier. Nullable: Yes
Default: 43

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:
TX_CELL_ORDER Short Order of the cell within the sector. Nullable: Yes
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_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:

8.2.16 xgcneighbours 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.

198 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:

8.2.17 xgcneighconstraints 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:

8.2.18 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:

8.2.19 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:

© 2022 Forsk. All Rights Reserved. 199


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

8.2.20 xgequipments Table

For radio equipment.

Field Type Description Attributes


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

8.2.21 xgfreqbands Table

For frequency bands.

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

8.2.22 xggneighbours 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:

200 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.2.23 xggneighconstraints 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:

8.2.24 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:

8.2.25 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

8.2.26 xgirfs Table

For interference reduction factors.

© 2022 Forsk. All Rights Reserved. 201


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT 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:

8.2.27 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

8.2.28 xglayerthresholds Table

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer for which the threshold is defined. Nullable: No
Default:

MOBILITY Text (50) Name of the mobility type corresponding to the control channel diversity Nullable: No
gains. Default:
RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT; 2=5G NR; 3=Wi-Fi. Nullable: No
Default:

THRESHOLD Float Coverage threshold defined for the combination of RAT, mobility type, and Nullable: No
layer. Default: -300

THRESHOLD_INDEX Integer Record index. Nullable: No


Default:

8.2.29 xgmuggains Table

For multi-user diversity gains of proportional fair schedulers.

202 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

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:

8.2.30 xgneighbours Table

For 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 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:
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:

8.2.31 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:

© 2022 Forsk. All Rights Reserved. 203


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.2.32 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:

8.2.33 xgrelaylinks 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

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

8.2.34 xgrepeaters Table

For repeaters donor-side parameters.

204 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT 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:

8.2.35 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:
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:

© 2022 Forsk. All Rights Reserved. 205


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

8.2.36 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: 1

8.2.37 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:

8.2.38 xgservices Table

For services.

206 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT 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; 3=Wi-Fi. 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

© 2022 Forsk. All Rights Reserved. 207


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT 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

8.2.39 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:

8.2.40 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:

8.2.41 xgtchgains Table

For traffic channel MIMO and diversity gains.

208 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT 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:

8.2.42 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:

8.2.43 xgterminals Table

For terminal types.

© 2022 Forsk. All Rights Reserved. 209


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT 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; 3=Wi-Fi. 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:

8.2.44 xgthresholds Table

For bearer selection and various feature activation thresholds.

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:

210 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT 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) 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:

8.2.45 xgtpltransmitters 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

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_MODEL Text (50) Name of the beamforming antenna model. Nullable: Yes
Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1
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).

© 2022 Forsk. All Rights Reserved. 211


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: Yes


Default: 1

COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: No


Default: -140
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

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:

212 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

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:

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:

© 2022 Forsk. All Rights Reserved. 213


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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; 3=Wi-Fi. 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:

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:

SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

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

214 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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

8.2.46 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

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:

© 2022 Forsk. All Rights Reserved. 215


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:
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

216 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.2.47 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:

8.2.48 xgtxslistsnames Table

For names of transmitter lists.

Field Type Description Attributes

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


Default:

8.2.49 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

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:

© 2022 Forsk. All Rights Reserved. 217


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.2.50 xguneighbours 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:

8.2.51 xguneighconstraints 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:

8.3 UMTS Data Tables


For the list of changes made to the data structure in this version, see "Data Structure Changes from Atoll 3.4 to 3.5"
on page 63.

8.3.1 ucells Table

For the table description, see "CDMACells Table" on page 64.

8.3.2 uceuse Table

For the table description, see "CDMAEquipmentsCEsUse Table" on page 67.

218 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.3.3 uequipments Table

For the table description, see "CDMAEquipments Table" on page 67.

8.3.4 ufrequencybands Table

For the table description, see "FrequencyBands Table" on page 71.

8.3.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:

8.3.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:

8.3.7 uhsdpabearers Table

For the table description, see "HSDPABearers Table" on page 71.

8.3.8 uhsdpabearerselect Table

For the table description, see "HSDPABearerSelectTables Table" on page 71.

© 2022 Forsk. All Rights Reserved. 219


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.3.9 uhsdpaqualtables Table

For the table description, see "HSDPAQualityTables Table" on page 72.

8.3.10 uhspamimoconfigs Table

For the table description, see "HSPAMIMOConfigs Table" on page 72.

8.3.11 uhsupabearers Table

For the table description, see "HSUPABearers Table" on page 73.

8.3.12 uhsupabearerselect Table

For the table description, see "HSUPABearerSelection Table" on page 73.

8.3.13 uhsupaqualtables Table

For the table description, see "HSUPAQualityTables Table" on page 73.

8.3.14 uhsuparessuse Table

For the table description, see "CdmaEqptsHSUPARssUse Table" on page 66.

8.3.15 uhsupauecategories Table

For the table description, see "HSUPAUECategories Table" on page 74.

8.3.16 uinterfreducfactors Table

For the table description, see "InterfReductionFactors Table" on page 74.

8.3.17 ulayers Table

For the table description, see "ulayers Table" on page 90.

220 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.3.18 umobility Table

For the table description, see "UMTSMobility Table" on page 91.

8.3.19 umugtables Table

For the table description, see "MUGTables Table" on page 75.

8.3.20 uneighbours Table

For the table description, see "Neighbours Table" on page 75.

8.3.21 uneighconstraints Table

For the table description, see "NeighboursConstraints Table" on page 76.

8.3.22 upscdomains Table

For the table description, see "ScramblingCodesDomains Table" on page 81.

8.3.23 upscforbidpairs Table

For the table description, see "Separations Table" on page 82.

8.3.24 upscgroups Table

For the table description, see "ScramblingCodesGroups Table" on page 81.

8.3.25 uqualityindicators Table

For the table description, see "QualityIndicators Table" on page 78.

8.3.26 ur99bearers Table

For the table description, see "R99Bearers Table" on page 78.

© 2022 Forsk. All Rights Reserved. 221


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.3.27 urepeaters Table

For the table description, see "Repeaters Table" on page 80.

8.3.28 uschedulers Table

For the table description, see "Schedulers Table" on page 81.

8.3.29 usecondaryantennas Table

For the table description, see "SecondaryAntennas Table" on page 81.

8.3.30 uservicequaltables Table

For the table description, see "ServiceQualityTables Table" on page 82.

8.3.31 uservices Table

For the table description, see "UMTSServices Table" on page 92. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

8.3.32 uservicesquality Table

For the table description, see "UMTSServicesQuality Table" on page 93.

8.3.33 uterminals Table

For the table description, see "UMTSTerminals Table" on page 94.

8.3.34 uterminalbands Table

For the table description, see "uterminalbands Table" on page 96.

222 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.3.35 utpltransmitters Table

For the table description, see "TplTransmitters Table" on page 84.

8.3.36 utransmitters Table

For the table description, see "Transmitters Table" on page 88.

8.3.37 utxslists Table

For the table description, see "TxsLists Table" on page 90.

8.3.38 utxslistsnames Table

For the table description, see "TxsListsNames Table" on page 90.

8.3.39 uuecategories Table

For the table description, see "UECategories Table" on page 90.

8.3.40 uuerxequipments Table

For the table description, see "UERxEquipments Table" on page 91.

8.3.41 uxgneighbours 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:

© 2022 Forsk. All Rights Reserved. 223


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.3.42 uxgneighconstraints 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:

8.4 GSM Data Tables


For the list of changes made to the data structure in this version, see "Data Structure Changes from Atoll 3.4 to 3.5"
on page 27.

8.4.1 gafpmodels Table

For the table description, see "AfpModels Table" on page 27.

8.4.2 gbsicdomains Table

For the table description, see "BSICDomains Table" on page 28.

8.4.3 gbsicgroups Table

For the table description, see "BSICGroups Table" on page 29.

8.4.4 gcelltypes Table

For the table description, see "CellTypes Table" on page 29.

8.4.5 gcodecequipments Table

For the table description, see "CodecEquipments Table" on page 30.

224 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.4.6 gcodecmodeadapts Table

For the table description, see "CodecModeAdaptations Table" on page 30.

8.4.7 gcodecmodes Table

For the table description, see "CodecModes Table" on page 30.

8.4.8 gcodecqualtables Table

For the table description, see "CodecQualityTables Table" on page 31.

8.4.9 gcodingschemes Table

For the table description, see "EGPRSCodingSchemes Table" on page 34.

8.4.10 gcsequipments Table

For the table description, see "EGPRSEquipments Table" on page 35.

8.4.11 gcsquality Table

For the table description, see "EGPRSQuality Table" on page 35.

8.4.12 gdimensmodel Table

For the table description, see "EGPRSDimensioningModel Table" on page 34.

8.4.13 gfreqdomains Table

For the table description, see "FrequencyDomains Table" on page 40.

8.4.14 gfreqgroups Table

For the table description, see "FrequencyGroups Table" on page 40.

© 2022 Forsk. All Rights Reserved. 225


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.4.15 gfrequencybands Table

For the table description, see "FrequencyBands Table" on page 39.

8.4.16 ghsndomains Table

For the table description, see "HSNDomains Table" on page 40.

8.4.17 ghsngroups Table

For the table description, see "HSNGroups Table" on page 40.

8.4.18 glayers Table

For the table description, see "Layers Table" on page 41.

8.4.19 gneighbours Table

For the table description, see "Neighbours Table" on page 41.

8.4.20 gneighconstraints Table

For the table description, see "NeighboursConstraints Table" on page 42.

8.4.21 gqualityindicators Table

For the table description, see "QualityIndicators Table" on page 44.

8.4.22 grepeaters Table

For the table description, see "Repeaters Table" on page 45.

8.4.23 gsecondaryantennas Table

For the table description, see "SecondaryAntennas Table" on page 46.

226 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.4.24 gseparationrules Table

For the table description, see "SeparationRules Table" on page 46.

8.4.25 gseparations Table

For the table description, see "Separations Table" on page 47.

8.4.26 gservicequality Table

For the table description, see "EGPRSServiceQuality Table" on page 36.

8.4.27 gservices Table

For the table description, see "EGPRSServices Table" on page 36. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

8.4.28 gterminals Table

For the table description, see "EGPRSTerminals Table" on page 37.

8.4.29 gtpltransmitters Table

For the table description, see "TplTransmitters Table" on page 48.

8.4.30 gtransmitters Table

For the table description, see "Transmitters Table" on page 50.

8.4.31 gtrgconfigs Table

For the table description, see "TRGConfigurations Table" on page 53.

© 2022 Forsk. All Rights Reserved. 227


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.4.32 gtrgs Table

For the table description, see "TRGs Table" on page 54.

8.4.33 gtrxequipments Table

For the table description, see "TRXEquipments Table" on page 56.

8.4.34 gtrxs Table

For the table description, see "TRXs Table" on page 56.

8.4.35 gtrxtypes Table

For the table description, see "TRXTypes Table" on page 57.

8.4.36 gtsconfignames Table

For the table description, see "TSConfigurationNames Table" on page 57.

8.4.37 gtsconfigs Table

For the table description, see "TSConfigurations Table" on page 57.

8.4.38 gtxslists Table

For the table description, see "TxsLists Table" on page 58.

8.4.39 gtxslistsnames Table

For the table description, see "TxsListsNames Table" on page 58.

228 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.4.40 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:

8.4.41 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:

8.4.42 gxgneighbours 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:

© 2022 Forsk. All Rights Reserved. 229


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.4.43 gxgneighconstraints 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:

8.5 CDMA Data Tables


For the list of changes made to the data structure in this version, see "Data Structure Changes from Atoll 3.4 to 3.5"
on page 99.

8.5.1 ccarrierstype Table

For the table description, see "CarriersType Table" on page 100.

8.5.2 ccells Table

For the table description, see "CDMACells Table" on page 101.

8.5.3 cceuse Table

For the table description, see "CDMAEquipmentsCEsUse Table" on page 103.

8.5.4 cdlbearerselect Table

For the table description, see "DLBearersSelection Table" on page 106.

8.5.5 cdldorabearers Table

For the table description, see "DLDORABearers Table" on page 106.

230 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.5.6 cdorabearers Table

For the table description, see "DORABearers Table" on page 106.

8.5.7 cdorabearersproba Table

For the table description, see "DORABearersProba Table" on page 106.

8.5.8 cdoratermt2pratios Table

For the table description, see "DORATerminalT2PRatios Table" on page 107.

8.5.9 cequipments Table

For the table description, see "CDMAEquipments Table" on page 102.

8.5.10 cfrequencybands Table

For the table description, see "FrequencyBands Table" on page 107.

8.5.11 cinterfreducfactors Table

For the table description, see "InterfReductionFactors Table" on page 108.

8.5.12 cmobility Table

For the table description, see "UMTSMobility Table" on page 122.

8.5.13 cneighbours Table

For the table description, see "Neighbours Table" on page 108.

8.5.14 cneighconstraints Table

For the table description, see "NeighboursConstraints Table" on page 109.

© 2022 Forsk. All Rights Reserved. 231


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

8.5.15 cpnodomains Table

For the table description, see "PnCodesDomains Table" on page 111.

8.5.16 cpnoforbidpairs Table

For the table description, see "Separations Table" on page 114.

8.5.17 cpnogroups Table

For the table description, see "PnCodesGroups Table" on page 111.

8.5.18 cqualityindicators Table

For the table description, see "QualityIndicators Table" on page 112.

8.5.19 crepeaters Table

For the table description, see "Repeaters Table" on page 113.

8.5.20 csecondaryantennas Table

For the table description, see "SecondaryAntennas Table" on page 114.

8.5.21 cservicequaltables Table

For the table description, see "ServiceQualityTables Table" on page 114.

8.5.22 cservices Table

For the table description, see "UMTSServices Table" on page 122.

8.5.23 cservicesquality Table

For the table description, see "UMTSServicesQuality Table" on page 124.

232 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

8.5.24 cterminals Table

For the table description, see "UMTSTerminals Table" on page 125.

8.5.25 ctpltransmitters Table

For the table description, see "TplTransmitters Table" on page 116.

8.5.26 ctransmitters Table

For the table description, see "Transmitters Table" on page 119.

8.5.27 ctxslists Table

For the table description, see "TxsLists Table" on page 121.

8.5.28 ctxslistsnames Table

For the table description, see "TxsListsNames Table" on page 121.

8.5.29 cuerxequipments Table

For the table description, see "UERxEquipments Table" on page 121.

8.5.30 culbearerselect Table

For the table description, see "ULBearersSelection Table" on page 121.

8.5.31 cxgneighbours 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.

© 2022 Forsk. All Rights Reserved. 233


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Field Type Description Attributes

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:

8.5.32 cxgneighconstraints 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:

8.6 Relationships

Many-to-One Relationships ( ∞ 1)

environmentdefs.ENVIRONMENT trafficenvs.NAME

environmentdefs.MOBILITY mobility.NAME

environmentdefs.USER_PROFILE userprofiles.NAME
gbsicgroups.DOMAIN_NAME gbsicdomains.NAME

gcodecequipments.IDEAL_QI_NAME gqualityindicators.NAME

gcodecmodeadapts.CODEC_EQT gcodecequipments.NAME

gcodecmodeadapts.CODEC_MODE gcodecmodes.NAME

gcodecmodeadapts.FREQUENCY_BAND gfrequencybands.NAME

gcodecmodeadapts.MOBILITY mobility.NAME

gcodecqualtables.CODEC_EQT gcodecequipments.NAME

gcodecqualtables.CODEC_MODE gcodecmodes.NAME

gcodecqualtables.FREQUENCY_BAND gfrequencybands.NAME
gcodecqualtables.MOBILITY mobility.NAME

gcodecqualtables.QI_NAME gqualityindicators.NAME

gcsquality.CS_NAME gcodingschemes.NAME
gcsquality.EQUIPMENT gcsequipments.NAME

gcsquality.FREQUENCY_BAND gfrequencybands.NAME

gcsquality.MOBILITY mobility.NAME

gfreqdomains.FREQUENCY_BAND_NAME gfrequencybands.NAME

gfreqgroups.DOMAIN_NAME gfreqdomains.NAME

ghsngroups.DOMAIN_NAME ghsndomains.NAME

gneighbours.NEIGHBOUR gtransmitters.TX_ID

234 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Many-to-One Relationships ( ∞ 1)

gneighbours.TRANSMITTER gtransmitters.TX_ID

gneighconstraints.NEIGHBOUR gtransmitters.TX_ID

gneighconstraints.TRANSMITTER gtransmitters.TX_ID

grepeaters.DONOR_CELLID gtransmitters.TX_ID

grepeaters.DONOR_PROPAG_MODEL propagationmodels.NAME

grepeaters.EQUIPMENT_NAME repeaterequipments.NAME

grepeaters.FEEDER_NAME feederequipments.NAME

grepeaters.REC_ANTENNA antennas.NAME

grepeaters.TX_ID gtransmitters.TX_ID

gsecondaryantennas.ANTENNA antennas.NAME

gsecondaryantennas.TX_ID gtransmitters.TX_ID

gseparations.TX_ID gtransmitters.TX_ID

gseparations.TX_ID_OTHER gtransmitters.TX_ID

gservicequality.DIMENSIONING_MODEL gdimensmodel.NAME

gservices.NAME services.NAME

gterminals.CODEC_EQUIPMENT gcodecequipments.NAME

gterminals.EGPRS_EQUIPMENT gcsequipments.NAME

gterminals.NAME terminals.NAME

gterminals.PRIMARY_BAND gfrequencybands.NAME
gterminals.SECONDARY_BAND gfrequencybands.NAME

gtpltransmitters.ANTENNA_NAME antennas.NAME

gtpltransmitters.BSIC_DOMAIN gbsicdomains.NAME
gtpltransmitters.BTS_NAME btsequipments.NAME

gtpltransmitters.CELL_TYPE gcelltypes.NAME

gtpltransmitters.CODEC_EQUIPMENT gcodecequipments.NAME
gtpltransmitters.EGPRS_EQUIPMENT gcsequipments.NAME

gtpltransmitters.FEEDER_NAME feederequipments.NAME

gtpltransmitters.LAYER glayers.NAME
gtpltransmitters.PROPAG_MODEL propagationmodels.NAME

gtpltransmitters.PROPAG_MODEL2 propagationmodels.NAME

gtpltransmitters.TMA_NAME tmaequipments.NAME

gtransmitters.ANTENNA_NAME antennas.NAME

gtransmitters.BSIC_DOMAIN gbsicdomains.NAME

gtransmitters.BTS_NAME btsequipments.NAME

gtransmitters.CELL_TYPE gcelltypes.NAME

gtransmitters.CODEC_EQUIPMENT gcodecequipments.NAME

gtransmitters.EGPRS_EQUIPMENT gcsequipments.NAME
gtransmitters.FBAND gfrequencybands.NAME

gtransmitters.FEEDER_NAME feederequipments.NAME

gtransmitters.LAYER glayers.NAME

gtransmitters.PROPAG_MODEL propagationmodels.NAME

gtransmitters.PROPAG_MODEL2 propagationmodels.NAME

gtransmitters.SITE_NAME sites.NAME

gtransmitters.TMA_NAME tmaequipments.NAME

© 2022 Forsk. All Rights Reserved. 235


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Many-to-One Relationships ( ∞ 1)

gtrgconfigs.CELL_TYPE gcelltypes.NAME

gtrgconfigs.DEF_TRX_EQUIPMENT gtrxequipments.NAME

gtrgconfigs.FREQUENCY_DOMAIN gfreqdomains.NAME

gtrgconfigs.HSN_DOMAIN ghsndomains.NAME

gtrgconfigs.TRX_TYPE gtrxtypes.NAME

gtrgconfigs.TS_CONFIGURATION_NAME gtsconfignames.NAME

gtrgs.DEF_TRX_EQUIPMENT gtrxequipments.NAME

gtrgs.FREQUENCY_DOMAIN gfreqdomains.NAME

gtrgs.HSN_DOMAIN ghsndomains.NAME

gtrgs.TRX_TYPE gtrxtypes.NAME

gtrgs.TS_CONFIGURATION_NAME gtsconfignames.NAME

gtrgs.TX_ID gtransmitters.TX_ID

gtrxs.TRX_EQUIPMENT gtrxequipments.NAME

gtrxs.TRX_TYPE gtrxtypes.NAME

gtrxs.TX_ID gtransmitters.TX_ID

gtsconfigs.NAME gtsconfignames.NAME

gtxslists.LIST_NAME gtxslistsnames.NAME

gtxslists.TX_NAME gtransmitters.TX_ID

networks.DEFAULT_MODEL propagationmodels.NAME
receivers.ANTENNA antennas.NAME

servicesusage.SERVICE services.NAME

servicesusage.TERMINAL terminals.NAME
servicesusage.USER_PROFILE userprofiles.NAME

sites.CDMA_EQUIPMENT uequipments.NAME

siteslists.LIST_NAME siteslistsnames.NAME
siteslists.SITE_NAME sites.NAME

ucells.HSDPA_SCHEDULER uschedulers.NAME

ucells.LAYER ulayers.LAYER_INDEX
ucells.SC_DOMAIN_NAME upscdomains.DOMAIN_NAME

ucells.TX_ID utransmitters.TX_ID

uceuse.EQUIPMENT uequipments.NAME

uceuse.SERVICE ur99bearers.NAME

uequipments.SCHEDULER_ALGO uschedulers.NAME

uhsdpabearerselect.MOBILITY mobility.NAME

uhsdpabearerselect.RX_EQUIP uuerxequipments.NAME

uhsdpaqualtables.BEARER_INDEX uhsdpabearers.BEARER_INDEX

uhsdpaqualtables.MOBILITY mobility.NAME
uhsdpaqualtables.QI_NAME uqualityindicators.NAME

uhsdpaqualtables.RX_EQUIP uuerxequipments.NAME

uhspamimoconfigs.HSDPA_BEARER_INDEX uhsdpabearers.BEARER_INDEX

uhspamimoconfigs.MOBILITY mobility.NAME

uhspamimoconfigs.RX_EQUIP uuerxequipments.NAME

uhsupabearerselect.BEARER_INDEX uhsupabearers.BEARER_INDEX

uhsupabearerselect.MOBILITY mobility.NAME

236 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Many-to-One Relationships ( ∞ 1)

uhsupabearerselect.RX_EQUIP uuerxequipments.NAME

uhsupaqualtables.BEARER_INDEX uhsupabearers.BEARER_INDEX

uhsupaqualtables.MOBILITY mobility.NAME

uhsupaqualtables.QI_NAME uqualityindicators.NAME

uhsupaqualtables.RX_EQUIP uuerxequipments.NAME

uhsuparessuse.BEARER_INDEX uhsupabearers.BEARER_INDEX

uhsuparessuse.EQUIPMENT uequipments.NAME

umobility.NAME mobility.NAME

umugtables.SCHEDULER_NAME uschedulers.NAME

uneighbours.NEIGHBOUR ucells.CELL_ID

uneighbours.TRANSMITTER ucells.CELL_ID

uneighconstraints.NEIGHBOUR ucells.CELL_ID

uneighconstraints.TRANSMITTER ucells.CELL_ID

units.COORD_SYSTEM coordsys.CODE

units.PROJECTION coordsys.CODE

upscforbidpairs.TX_ID ucells.CELL_ID

upscforbidpairs.TX_ID_OTHER ucells.CELL_ID

upscgroups.DOMAIN_NAME upscdomains.DOMAIN_NAME

urepeaters.DONOR_CELLID utransmitters.TX_ID
urepeaters.DONOR_PROPAG_MODEL propagationmodels.NAME

urepeaters.EQUIPMENT_NAME repeaterequipments.NAME

urepeaters.FEEDER_NAME feederequipments.NAME
urepeaters.REC_ANTENNA antennas.NAME

urepeaters.TX_ID utransmitters.TX_ID

usecondaryantennas.ANTENNA antennas.NAME
usecondaryantennas.TX_ID utransmitters.TX_ID

uservicequaltables.MOBILITY mobility.NAME

uservicequaltables.QI_NAME uqualityindicators.NAME
uservicequaltables.RX_EQUIP uuerxequipments.NAME

uservicequaltables.SERVICE ur99bearers.NAME

uservices.NAME services.NAME

uservices.R99BEARER ur99bearers.NAME

uservicesquality.MOBILITY mobility.NAME

uservicesquality.RX_EQUIP uuerxequipments.NAME

uservicesquality.SERVICE ur99bearers.NAME

uterminalbands.FBAND_NAME ufrequencybands.NAME

uterminalbands.TERMINAL_NAME uterminals.NAME
uterminals.HSUPA_UE_CATEGORY uhsupauecategories.UE_CATEGORY

uterminals.NAME terminals.NAME

uterminals.RX_EQUIP uuerxequipments.NAME

uterminals.UE_CATEGORY uuecategories.UE_CATEGORY

utpltransmitters.ANTENNA_NAME antennas.NAME

utpltransmitters.BTS_NAME btsequipments.NAME

utpltransmitters.CDMA_EQUIPMENT uequipments.NAME

© 2022 Forsk. All Rights Reserved. 237


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Many-to-One Relationships ( ∞ 1)

utpltransmitters.FBAND ufrequencybands.NAME

utpltransmitters.FEEDER_NAME feederequipments.NAME

utpltransmitters.HSDPA_SCHEDULER uschedulers.NAME

utpltransmitters.PROPAG_MODEL propagationmodels.NAME

utpltransmitters.PROPAG_MODEL2 propagationmodels.NAME

utpltransmitters.SC_DOMAIN_NAME upscdomains.DOMAIN_NAME

utpltransmitters.TMA_NAME tmaequipments.NAME

utransmitters.ANTENNA_NAME antennas.NAME

utransmitters.BTS_NAME btsequipments.NAME

utransmitters.FBAND ufrequencybands.NAME

utransmitters.FEEDER_NAME feederequipments.NAME

utransmitters.PROPAG_MODEL propagationmodels.NAME

utransmitters.PROPAG_MODEL2 propagationmodels.NAME

utransmitters.SITE_NAME sites.NAME

utransmitters.TMA_NAME tmaequipments.NAME

utxslists.LIST_NAME utxslistsnames.NAME

utxslists.TX_NAME utransmitters.TX_ID

uxgneighbours.NEIGHBOUR xgcellsuids.CELL_ID

uxgneighbours.TRANSMITTER ucells.CELL_ID
uxgneighconstraints.NEIGHBOUR xgcellsuids.CELL_ID

uxgneighconstraints.TRANSMITTER ucells.CELL_ID

xgbeamsetdefs.BEAM_SET_NAME xgbeamsets.NAME
xgbeamsets.BF_MODEL xgbfmodels.NAME

xgbearers.EQUIPMENT xgequipments.NAME

xgbfmodels.ELEMENT_PATTERN antennas.NAME
xgbfpatterns.BF_MODEL xgbfmodels.NAME

xgcagroupdefs.CA_GROUP_NAME xgcagroups.NAME

xgcagroupdefs.MEMBER_CELL_NAME xgcellsuids.CELL_ID
xgcarriers.FBAND xgfreqbands.NAME

xgcchgains.EQUIPMENT xgequipments.NAME

xgcchgains.MOBILITY mobility.NAME

xgcells5gnr.BEAM_SET xgbeamsets.NAME

xgcells5gnr.CARRIER xgcarriers.NAME

xgcells5gnr.CELL_ID xgcellsuids.CELL_ID

xgcells5gnr.EQUIPMENT xgequipments.NAME

xgcells5gnr.LAYER xglayers.LAYER_INDEX

xgcells5gnr.PAIRED_CELL_NAME xgcellslte.CELL_ID
xgcells5gnr.PCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcells5gnr.PRACH_RSI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcells5gnr.SCHEDULER xgschedulers.NAME

xgcellslte.BEAM_SET xgbeamsets.NAME

xgcellslte.CARRIER xgcarriers.NAME

xgcellslte.CELL_ID xgcellsuids.CELL_ID

xgcellslte.EQUIPMENT xgequipments.NAME

238 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Many-to-One Relationships ( ∞ 1)

xgcellslte.LAYER xglayers.LAYER_INDEX

xgcellslte.PCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcellslte.PRACH_RSI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcellslte.SCHEDULER xgschedulers.NAME

xgcellsnbiot.CARRIER xgcarriers.NAME

xgcellsnbiot.CELL_ID xgcellsuids.CELL_ID

xgcellsnbiot.EQUIPMENT xgequipments.NAME

xgcellsnbiot.LAYER xglayers.LAYER_INDEX

xgcellsnbiot.NPCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcellsuids.TX_ID xgtransmitters.TX_ID

xgcellswifi.BEAM_SET xgbeamsets.NAME

xgcellswifi.CARRIER xgcarriers.NAME

xgcellswifi.CELL_ID xgcellsuids.CELL_ID

xgcellswifi.EQUIPMENT xgequipments.NAME

xgcellswifi.LAYER xglayers.LAYER_INDEX

xgcellswifi.SCHEDULER xgschedulers.NAME

xgcompsetdefs.COMP_SET_NAME xgcompsets.NAME

xgcompsetdefs.MEMBER_CELL_NAME xgcellsuids.CELL_ID

xgidgroups.DOMAIN_NAME xgiddomains.DOMAIN_NAME
xgirfs.EQUIPMENT xgequipments.NAME

xglayerthresholds.LAYER_INDEX xglayers.LAYER_INDEX

xglayerthresholds.MOBILITY mobility.NAME
xgmuggains.BEARER_INDEX xgbearers.BEARER_INDEX

xgmuggains.MOBILITY mobility.NAME

xgmuggains.SCHEDULER_NAME xgschedulers.NAME
xgneighbours.NEIGHBOUR xgcellsuids.CELL_ID

xgneighbours.TRANSMITTER xgcellsuids.CELL_ID

xgneighconstraints.NEIGHBOUR xgcellsuids.CELL_ID
xgneighconstraints.TRANSMITTER xgcellsuids.CELL_ID

xgqigraphs.BEARER_INDEX xgbearers.BEARER_INDEX

xgqigraphs.MOBILITY mobility.NAME

xgqigraphs.RX_EQUIP xgequipments.NAME

xgrelaylinks.ANTENNA antennas.NAME

xgrelaylinks.DONOR_CELL_ID xgcellsuids.CELL_ID

xgrelaylinks.FEEDER_NAME feederequipments.NAME

xgrelaylinks.PROPAG_MODEL propagationmodels.NAME

xgrelaylinks.RELAY_SITE_NAME sites.NAME
xgrepeaters.DONOR_CELLID xgtransmitters.TX_ID

xgrepeaters.DONOR_PROPAG_MODEL propagationmodels.NAME

xgrepeaters.EQUIPMENT_NAME repeaterequipments.NAME

xgrepeaters.FEEDER_NAME feederequipments.NAME

xgrepeaters.REC_ANTENNA antennas.NAME

xgrepeaters.TX_ID xgtransmitters.TX_ID

xgrepetitions.EQUIPMENT xgequipments.NAME

© 2022 Forsk. All Rights Reserved. 239


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

Many-to-One Relationships ( ∞ 1)

xgrepetitions.MOBILITY mobility.NAME

xgsecondaryantennas.ANTENNA antennas.NAME

xgsecondaryantennas.TX_ID xgtransmitters.TX_ID

xgservices.NAME services.NAME

xgsfnclusterdefs.MEMBER_CELL_NAME xgcellsuids.CELL_ID

xgsfnclusterdefs.SFN_CLUSTER_NAME xgsfnclusters.NAME

xgsfnclusters.SFN_COORDINATOR xgcellsuids.CELL_ID

xgtchgains.BEARER_INDEX xgbearers.BEARER_INDEX

xgtchgains.EQUIPMENT xgequipments.NAME

xgtchgains.MOBILITY mobility.NAME

xgterminalbands.FBAND_NAME xgfreqbands.NAME

xgterminalbands.TERMINAL xgterminals.TERMINAL_INDEX

xgterminals.ANTENNA antennas.NAME

xgterminals.EQUIPMENT xgequipments.NAME

xgterminals.NAME terminals.NAME

xgterminals.UE_CATEGORY xguecategories.NAME

xgthresholds.MOBILITY mobility.NAME

xgthresholds.RX_EQUIP xgequipments.NAME

xgtpltransmitters.ANTENNA_NAME antennas.NAME
xgtpltransmitters.BEAM_SET xgbeamsets.NAME

xgtpltransmitters.BF_MODEL xgbfmodels.NAME

xgtpltransmitters.BTS_NAME btsequipments.NAME
xgtpltransmitters.CARRIER xgcarriers.NAME

xgtpltransmitters.EQUIPMENT xgequipments.NAME

xgtpltransmitters.FEEDER_NAME feederequipments.NAME
xgtpltransmitters.PCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgtpltransmitters.PRACH_RSI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgtpltransmitters.PROPAG_MODEL propagationmodels.NAME
xgtpltransmitters.PROPAG_MODEL2 propagationmodels.NAME

xgtpltransmitters.SCHEDULER xgschedulers.NAME

xgtpltransmitters.TMA_NAME tmaequipments.NAME

xgtransmitters.ANTENNA_NAME antennas.NAME

xgtransmitters.BF_MODEL xgbfmodels.NAME

xgtransmitters.BTS_NAME btsequipments.NAME

xgtransmitters.FBAND xgfreqbands.NAME

xgtransmitters.FEEDER_NAME feederequipments.NAME

xgtransmitters.PROPAG_MODEL propagationmodels.NAME
xgtransmitters.PROPAG_MODEL2 propagationmodels.NAME

xgtransmitters.SITE_NAME sites.NAME

xgtransmitters.TMA_NAME tmaequipments.NAME

xgtxslists.LIST_NAME xgtxslistsnames.NAME

xgtxslists.TX_NAME xgtransmitters.TX_ID

xguneighbours.NEIGHBOUR ucells.CELL_ID

xguneighbours.TRANSMITTER xgcellsuids.CELL_ID

240 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 8: 5G Multi-RAT Data Structure

Many-to-One Relationships ( ∞ 1)

xguneighconstraints.NEIGHBOUR ucells.CELL_ID

xguneighconstraints.TRANSMITTER xgcellsuids.CELL_ID

© 2022 Forsk. All Rights Reserved. 241


Atoll 3.5.0 Data Structure Reference Guide
Chapter 8: 5G Multi-RAT Data Structure

242 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9 In-Building Data Structure


Atoll In-Building documents can contain 5G NR, LTE, NB-IoT, and Wi-Fi technologies in combination with GSM and
UMTS.. Tables in the In-Building template include the following categories of tables:
 "Data Tables Common to All Technologies" on page 243: These tables are shared and used by all the
technologies.
 "5G NR, LTE, NB-IoT, Wi-Fi Data Tables" on page 254: These tables are shared and used by 5G NR, LTE, NB-IoT,
and Wi-Fi.
 "UMTS Data Tables" on page 292: These tables are shared and used by UMTS.
 "GSM Data Tables" on page 298: These tables are shared and used by GSM.
 "In-Building Data Tables" on page 304: These tables are shared and used for in-building.

q Primary keys are listed in bold and italic characters.

9.1 Data Tables Common to All Technologies

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

© 2022 Forsk. All Rights Reserved. 243


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:

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

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

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

244 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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.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:

© 2022 Forsk. All Rights Reserved. 245


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building 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.5.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

246 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building 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.

9.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:

9.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:

9.1.7 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:

© 2022 Forsk. All Rights Reserved. 247


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

V_TECHNO Text (50) Name of the interfered technology. Nullable: No


Default:

9.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:

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

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

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: 2
COM- Float Downlink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_DL_QUAL Default: 1

COM- Float Uplink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_UL_QUAL 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: 100
DMAX Float Maximum radius for a cell. Nullable: No
Default: -1

248 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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 Whether Io includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: True
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:

NTISNTOT Boolean Whether Nt includes the pilot signal or not. True=Yes; False=No. Nullable: No
Default: False
POWER_CONTROL_MARGIN Float Uplink power adjustment margin. Unit: dB. Nullable: Yes
Default: 1

POWERS_RELATIVE_TO_PI- Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
LOT 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_- Float RSCP threshold for compressed mode activation. Unit: dB. Nullable: No
THRESHOLD 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

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”

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

9.1.10 propagationmodels Table

For propagation models.

© 2022 Forsk. All Rights Reserved. 249


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building 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 Nullable: No
Default:

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


Default:

9.1.11 receivers Table

For receiver parameters.

Field Type Description Attributes

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

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:

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

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


Default:

250 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

9.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:

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:

© 2022 Forsk. All Rights Reserved. 251


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

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

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
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:

9.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:

252 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.1.17 siteslistsnames Table

For names of site lists.

Field Type Description Attributes

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


Default:

9.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”

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

9.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:

© 2022 Forsk. All Rights Reserved. 253


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

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

BSIC_FORMAT Integer GSM 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

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:

9.1.22 userprofiles Table

For names of user profiles.

Field Type Description Attributes

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


Default:

9.2 5G NR, LTE, NB-IoT, Wi-Fi Data Tables

9.2.1 Data Structure Changes from Atoll 3.4 to 3.5

9.2.1.1 Added Tables and Fields


xgbeamsetdefs Table (New)

Field Type Description Attributes

BEAM_INDEX Integer Index of the beam effectively used by the beam set. Nullable: No
Default:
BEAM_SET_NAME Text (50) Name of the beam set to which the used beam index belongs. Nullable: No
Default:

SWEEP_ORDER Short The order in which broadcast beams are transmitted, or the SS/PBCH index Nullable: Yes
corresponding to the broadcast beam transmission. Min: 0; Max: 63. Default: 0

254 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

xgbeamsets Table (New)

Field Type Description Attributes

BEAMWIDTH Float Horizontal half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:
BF_MODEL Text (50) Name of the beamforming model to which the beam set belongs. Nullable: No
Default:

CONFIGURATION Text (50) Configuration of the beam set. Examples: 120deg + 2 SSB beams, 90deg + Nullable: Yes
4 SSB beams, etc. Default:

N_RX_PORTS Short The number of reception antenna ports effectively used by the beam set. Nullable: No
Default: 4
N_TX_PORTS Short The number of transmission antenna ports effectively used by the beam set. Nullable: No
Default: 4

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


Default:

SCENARIO Text (50) Name of the scenario to which the beam set belongs. Examples: Macro, high- Nullable: Yes
rise, hot spot, etc. Default:
TILT Float Electrical tilt of the beam set. Used by the ACP for beam set selection. Nullable: Yes
Default:

V_BEAMWIDTH Float Vertical half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:

xgbfmodels Table

Field Type Description Attributes

BF_METHOD Short Whether the 3D beamforming model uses switched beam or adaptive beam- Nullable: Yes
forming. 0=NULL=Switched Beam; 1=Adaptive. Default: 0

BF_RANGE Short Whether the adaptive beamforming model create beams automatically Nullable: Yes
based on the logical element pattern’s horizontal and vertical beamwidths or Default: 0
within a user-defined range of azimuth and tilt values. 0=NULL=Automatic;
1=User-defined.

ELEMENT_PATTERN Text (50) Name of the antenna pattern corresponding to the logical element of the Nullable: Yes
beamforming model. Default:
MAX_AZIMUTH Float Highest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MIN_AZIMUTH Float Lowest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MAX_TILT Float Highest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0
MIN_TILT Float Lowest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0

xgbfpatterns Table

Field Type Description Attributes

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

PCG Float The value of the user-defined power combining gain. Nullable: Yes
Default:

PCG_STATUS Short Whether the power combining gain is to be applied or not, calculated auto- Nullable: Yes
matically or user defined. NULL=0=None; 1=Automatic; 2=User-defined. Default: 0
V_BEAMWIDTH Float Vertical half-power beamwidth of the beam pattern. Nullable: Yes
Default:

© 2022 Forsk. All Rights Reserved. 255


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

xgcells5gnr Table

Field Type Description Attributes

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:
BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

CSIRS_POWER_OFFSET Float EPRE offset for CSI-RS with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 0

PAIRED_CELL_NAME Text (100) Name of the LTE cell paired with the 5G NR cell for spectrum sharing. Nullable: Yes
Default:
SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

SSB_FREQ_OFFSET Integer Number of subcarriers between the first SS/PBCH subcarrier and the refer- Nullable: Yes
ence point A. Default: 0

SSB_TRAFFIC_MUX Short Whether the cell can transmit PDCCH and PDSCH in slots carrying SS/PBCH Nullable: Yes
or not. 0=Off; 1=NULL= On. Default: 1
UL_FPC_CINR_MAX Float Uplink C/(I+N) target driven by noise rise limitation of neighbouring cells. Nullable: Yes
Unit: dB. Default: 20

xgcellslte Table

Field Type Description Attributes


BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

PA_OFFSET Float EPRE offset of type A OFDM symbols ( symbols that do not contain LTE CRS) Nullable: Yes
with respect to the RS EPRE. Unit: dB. 3GPP values: -6; -4.77; -3; -1.77; 0; 1; 2; 3. Default: 0

PB_OFFSET Float EPRE offset of type B OFDM symbols ( symbols that contain LTE CRS) with Nullable: Yes
respect to the RS EPRE. Unit: dB. 3GPP values: 0; 1; 2; 3. Default: 0
RS_BOOST Short Whether or not the RS EPRE must be boosted based on the number of CRS Nullable: Yes
ports. 0=No; 1=Yes. Default: 0

xgcellsuids Table

Field Type Description Attributes


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

xgcellswifi Table (New)

Field Type Description Attributes

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


Default: True

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1
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:

256 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: No


Default: 1
COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: Yes
Default: -140

CYCLIC_PREFIX Short Cyclic prefix used by the cell. 0=Short; 1=Long; 2=Extended. Nullable: Yes
Default: 0

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:

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 per carrier. Nullable: Yes
Default: 43
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:

TX_CELL_ORDER Short Order of the cell within the sector. Nullable: Yes
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

© 2022 Forsk. All Rights Reserved. 257


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:

xglayerthresholds Table (New)

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer for which the threshold is defined. Nullable: No
Default:
MOBILITY Text (50) Name of the mobility type corresponding to the control channel diversity Nullable: No
gains. Default:

RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT; 2=5G NR; 3=Wi-Fi. Nullable: No
Default:

THRESHOLD Float Coverage threshold defined for the combination of RAT, mobility type, and Nullable: No
layer. Default: -300

THRESHOLD_INDEX Integer Record index. Nullable: No


Default:

xgtpltransmitters Table

Field Type Description Attributes

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:
BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: Yes


Default: 1

COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: No


Default: -140
SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

9.2.1.2 Deleted Tables and Fields


xgcells5gnr Table
 TX_ID

xgcellslte Table
 TX_ID

xgcellsnbiot Table
 TX_ID

258 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.2.2 xgbeamsetdefs Table

Field Type Description Attributes

BEAM_INDEX Integer Index of the beam effectively used by the beam set. Nullable: No
Default:
BEAM_SET_NAME Text (50) Name of the beam set to which the used beam index belongs. Nullable: No
Default:

SWEEP_ORDER Short The order in which broadcast beams are transmitted, or the SS/PBCH index Nullable: Yes
corresponding to the broadcast beam transmission. Min: 0; Max: 63. Default: 0

9.2.3 xgbeamsets Table

Field Type Description Attributes

BEAMWIDTH Float Horizontal half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:

BF_MODEL Text (50) Name of the beamforming model to which the beam set belongs. Nullable: No
Default:
CONFIGURATION Text (50) Configuration of the beam set. Examples: 120deg + 2 SSB beams, 90deg + Nullable: Yes
4 SSB beams, etc. Default:

N_RX_PORTS Short The number of reception antenna ports effectively used by the beam set. Nullable: No
Default: 4

N_TX_PORTS Short The number of transmission antenna ports effectively used by the beam set. Nullable: No
Default: 4
NAME Text (50) Name of the beam set. Nullable: No
Default:

SCENARIO Text (50) Name of the scenario to which the beam set belongs. Examples: Macro, high- Nullable: Yes
rise, hot spot, etc. Default:

TILT Float Electrical tilt of the beam set. Used by the ACP for beam set selection. Nullable: Yes
Default:

V_BEAMWIDTH Float Vertical half-power beamwidth of the broadcast beams of the beam set. Nullable: Yes
Used by the ACP for beam set selection. Default:

9.2.4 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:

© 2022 Forsk. All Rights Reserved. 259


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

9.2.5 xgbfmodels Table

For 3D beamforming models.

Field Type Description Attributes


BF_METHOD Short Whether the 3D beamforming model uses switched beam or adaptive beam- Nullable: Yes
forming. 0=NULL=Switched Beam; 1=Adaptive. Default: 0

BF_RANGE Short Whether the adaptive beamforming model create beams automatically Nullable: Yes
based on the logical element pattern’s horizontal and vertical beamwidths or Default: 0
within a user-defined range of azimuth and tilt values. 0=NULL=Automatic;
1=User-defined.

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

ELEMENT_PATTERN Text (50) Name of the antenna pattern corresponding to the logical element of the Nullable: Yes
beamforming model. Default:

FMAX Float Highest operating frequency. Unit: MHz. Nullable: Yes


Default:
FMIN Float Lowest operating frequency. Unit: MHz. Nullable: Yes
Default:

MAX_AZIMUTH Float Highest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MIN_AZIMUTH Float Lowest azimuth angle to target in adaptive beamforming. Nullable: Yes
Default: 0
MAX_TILT Float Highest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0

MIN_TILT Float Lowest elevation angle to target in adaptive beamforming. Nullable: Yes
Default: 0

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

260 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.2.6 xgbfpatterns Table

For 3D beamforming beam patterns.

Field Type Description Attributes

ACTIVE Boolean Whether the beam is active (used in calculations) or not. Nullable: No
Default: True

AZIMUT Float Direction of the beam in the horizontal plane. Nullable: No


Default:

BEAM_INDEX Integer Index of the beam. Nullable: No


Default:
BEAM_TYPE Short The type of channels for which the beam can be used. 1=Broadcast; Nullable: No
2=Refinement; 4=Service. Default: 7

BEAMWIDTH Float Horizontal half-power beamwidth of the beam pattern. Nullable: Yes
Default:

BF_MODEL Text (50) Name of the beamforming model to which the beam belongs. Nullable: No
Default:
COMMENT_ Text (255) Additional information about the beam pattern. Nullable: Yes
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:

PCG Float The value of the user-defined power combining gain. Nullable: Yes
Default:

PCG_STATUS Short Whether the power combining gain is to be applied or not, calculated auto- Nullable: Yes
matically or user defined. NULL=0=None; 1=Automatic; 2=User-defined. Default: 0
TILT Float Direction of the beam in the vertical plane. Nullable: No
Default:

V_BEAMWIDTH Float Vertical half-power beamwidth of the beam pattern. Nullable: Yes
Default:

9.2.7 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:

9.2.8 xgcagroups Table

For carrier aggregation group names and parameters.

© 2022 Forsk. All Rights Reserved. 261


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

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:

9.2.9 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

9.2.10 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

262 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.2.11 xgcells5gnr Table

For 5G NR cells.

Field Type Description Attributes

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


Default: True

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1
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:

CSIRS_POWER_OFFSET Float EPRE offset for CSI-RS with respect to SSS EPRE. Unit: dB. Nullable: Yes
Default: 0
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

© 2022 Forsk. All Rights Reserved. 263


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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 per carrier. Nullable: Yes
Default: 43

MIN_SSSRSRP Float Minimum SSS RSRP required for coverage. Nullable: Yes
Default: -140
PAIRED_CELL_NAME Text (100) Name of the LTE cell paired with the 5G NR cell for spectrum sharing. Nullable: Yes
Default:

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:
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; 1=1; 2=2; 3=3; 4=A1; 5=A2; 6=A3; 7=B1; 8=B2; Nullable: Yes
9=B3; 10=B4; 11=C0; 12=C2 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:
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:

264 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

SSB_FREQ_OFFSET Integer Number of subcarriers between the first SS/PBCH subcarrier and the refer- Nullable: Yes
ence point A. Default: 0

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
SSS_POWER Float SSS EPRE (dBm) Nullable: Yes
Default: 15

SSB_TRAFFIC_MUX Short Whether the cell can transmit PDCCH and PDSCH in slots carrying SS/PBCH Nullable: Yes
or not. 0=Off; 1=NULL= On. Default: 1

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:

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_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_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:

9.2.12 xgcellslte Table

For LTE cells.

© 2022 Forsk. All Rights Reserved. 265


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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


Default: True

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:
BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

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

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 corresponding 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

266 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:
MAX_POWER Float Maximum cell transmission power per carrier and per CRS port. 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:
PA_OFFSET Float EPRE offset of type A OFDM symbols ( symbols that do not contain LTE CRS) Nullable: Yes
with respect to the RS EPRE. Unit: dB. 3GPP values: -6; -4.77; -3; -1.77; 0; 1; 2; 3. Default: 0

PB_OFFSET Float EPRE offset of type B OFDM symbols ( symbols that contain LTE CRS) with Nullable: Yes
respect to the RS EPRE. Unit: dB. 3GPP values: 0; 1; 2; 3. Default: 0

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:

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=0; 1=1; 2=2; 3=3; 4=4. Nullable: Yes
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:

© 2022 Forsk. All Rights Reserved. 267


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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_BOOST Short Whether or not the RS EPRE must be boosted based on the number of CRS Nullable: Yes
ports. 0=No; 1=Yes. Default: 0
RS_EPRE Float Energy per resource element of reference signals corresponding to antenna Nullable: Yes
elements mapped to one CRS port. 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

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:
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

268 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:

9.2.13 xgcellsnbiot Table

For NB-IoT cells.

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:

© 2022 Forsk. All Rights Reserved. 269


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:

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

NPRACH_PREAMBLE_FOR- Short NPRACH preamble format. 0=10 km; 1=40 km. Nullable: Yes
MAT 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:

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:

270 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.2.14 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

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

9.2.15 xgcellswifi Table

Field Type Description Attributes

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


Default: True
BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1

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:

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:

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: No


Default: 1
COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: Yes
Default: -140

CYCLIC_PREFIX Short Cyclic prefix used by the cell. 0=Short; 1=Long; 2=Extended. Nullable: Yes
Default: 0

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

© 2022 Forsk. All Rights Reserved. 271


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:

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 per carrier. Nullable: Yes
Default: 43

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:
TX_CELL_ORDER Short Order of the cell within the sector. Nullable: Yes
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_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:

9.2.16 xgcneighbours 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.

272 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:

9.2.17 xgcneighconstraints 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:

9.2.18 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:

9.2.19 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:

© 2022 Forsk. All Rights Reserved. 273


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

9.2.20 xgequipments Table

For radio equipment.

Field Type Description Attributes


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

9.2.21 xgfreqbands Table

For frequency bands.

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

9.2.22 xggneighbours 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:

274 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.2.23 xggneighconstraints 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:

9.2.24 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:

9.2.25 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

9.2.26 xgirfs Table

For interference reduction factors.

© 2022 Forsk. All Rights Reserved. 275


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building 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:

9.2.27 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

9.2.28 xglayerthresholds Table

Field Type Description Attributes

LAYER_INDEX Short Index of the network layer for which the threshold is defined. Nullable: No
Default:

MOBILITY Text (50) Name of the mobility type corresponding to the control channel diversity Nullable: No
gains. Default:
RAT Short Radio access technology of the cell. 0=LTE; 1=NB-IoT; 2=5G NR; 3=Wi-Fi. Nullable: No
Default:

THRESHOLD Float Coverage threshold defined for the combination of RAT, mobility type, and Nullable: No
layer. Default: -300

THRESHOLD_INDEX Integer Record index. Nullable: No


Default:

9.2.29 xgmuggains Table

For multi-user diversity gains of proportional fair schedulers.

276 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

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:

9.2.30 xgneighbours Table

For 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 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:
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:

9.2.31 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:

© 2022 Forsk. All Rights Reserved. 277


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.2.32 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:

9.2.33 xgrelaylinks 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

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

9.2.34 xgrepeaters Table

For repeaters donor-side parameters.

278 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building 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:

9.2.35 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:
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:

© 2022 Forsk. All Rights Reserved. 279


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

9.2.36 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: 1

9.2.37 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:

9.2.38 xgservices Table

For services.

280 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building 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

© 2022 Forsk. All Rights Reserved. 281


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building 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

9.2.39 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:

9.2.40 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:

9.2.41 xgtchgains Table

For traffic channel MIMO and diversity gains.

282 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building 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:

9.2.42 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:

9.2.43 xgterminals Table

For terminal types.

© 2022 Forsk. All Rights Reserved. 283


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building 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:

9.2.44 xgthresholds Table

For bearer selection and various feature activation thresholds.

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:

284 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building 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) 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:

9.2.45 xgtpltransmitters 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

BEAM_SET Text (50) Name of the beam set of the transmitter’s beamforming model used by the Nullable: Yes
cell. Default:

BF_MODEL Text (50) Name of the beamforming antenna model. Nullable: Yes
Default:

BF_SUPPORT Short Whether the cell supports beamforming or not. 0=Inactive; 1=NULL=Active. Nullable: Yes
Default: 1
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).

© 2022 Forsk. All Rights Reserved. 285


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

CONFIGURATION Short Configuration of Wi-Fi used by the cell. Nullable: Yes


Default: 1

COVERAGE_THRESHOLD Float Minimum received power required for coverage. Nullable: No


Default: -140
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

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:

286 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

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:

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:

© 2022 Forsk. All Rights Reserved. 287


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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; 3=Wi-Fi. 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:

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:

SPECTRUM_SHARING Short Whether DSS is enabled for a 5G NR cell or not. NULL=0=Disabled; 1=Ena- Nullable: Yes
bled. Default: 0

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

288 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

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

9.2.46 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

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:

© 2022 Forsk. All Rights Reserved. 289


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

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:
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

290 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.2.47 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:

9.2.48 xgtxslistsnames Table

For names of transmitter lists.

Field Type Description Attributes

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


Default:

9.2.49 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

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:

© 2022 Forsk. All Rights Reserved. 291


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.2.50 xguneighbours 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:

9.2.51 xguneighconstraints 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:

9.3 UMTS Data Tables


For the list of changes made to the data structure in this version, see "Data Structure Changes from Atoll 3.4 to 3.5"
on page 63.

9.3.1 ucells Table

For the table description, see "CDMACells Table" on page 64.

9.3.2 uceuse Table

For the table description, see "CDMAEquipmentsCEsUse Table" on page 67.

292 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.3.3 uequipments Table

For the table description, see "CDMAEquipments Table" on page 67.

9.3.4 ufrequencybands Table

For the table description, see "FrequencyBands Table" on page 71.

9.3.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:

9.3.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:

9.3.7 uhsdpabearers Table

For the table description, see "HSDPABearers Table" on page 71.

9.3.8 uhsdpabearerselect Table

For the table description, see "HSDPABearerSelectTables Table" on page 71.

© 2022 Forsk. All Rights Reserved. 293


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.3.9 uhsdpaqualtables Table

For the table description, see "HSDPAQualityTables Table" on page 72.

9.3.10 uhspamimoconfigs Table

For the table description, see "HSPAMIMOConfigs Table" on page 72.

9.3.11 uhsupabearers Table

For the table description, see "HSUPABearers Table" on page 73.

9.3.12 uhsupabearerselect Table

For the table description, see "HSUPABearerSelection Table" on page 73.

9.3.13 uhsupaqualtables Table

For the table description, see "HSUPAQualityTables Table" on page 73.

9.3.14 uhsuparessuse Table

For the table description, see "CdmaEqptsHSUPARssUse Table" on page 66.

9.3.15 uhsupauecategories Table

For the table description, see "HSUPAUECategories Table" on page 74.

9.3.16 uinterfreducfactors Table

For the table description, see "InterfReductionFactors Table" on page 74.

9.3.17 ulayers Table

For the table description, see "ulayers Table" on page 90.

294 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.3.18 umobility Table

For the table description, see "UMTSMobility Table" on page 91.

9.3.19 umugtables Table

For the table description, see "MUGTables Table" on page 75.

9.3.20 uneighbours Table

For the table description, see "Neighbours Table" on page 75.

9.3.21 uneighconstraints Table

For the table description, see "NeighboursConstraints Table" on page 76.

9.3.22 upscdomains Table

For the table description, see "ScramblingCodesDomains Table" on page 81.

9.3.23 upscforbidpairs Table

For the table description, see "Separations Table" on page 82.

9.3.24 upscgroups Table

For the table description, see "ScramblingCodesGroups Table" on page 81.

9.3.25 uqualityindicators Table

For the table description, see "QualityIndicators Table" on page 78.

9.3.26 ur99bearers Table

For the table description, see "R99Bearers Table" on page 78.

© 2022 Forsk. All Rights Reserved. 295


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.3.27 urepeaters Table

For the table description, see "Repeaters Table" on page 80.

9.3.28 uschedulers Table

For the table description, see "Schedulers Table" on page 81.

9.3.29 usecondaryantennas Table

For the table description, see "SecondaryAntennas Table" on page 81.

9.3.30 uservicequaltables Table

For the table description, see "ServiceQualityTables Table" on page 82.

9.3.31 uservices Table

For the table description, see "UMTSServices Table" on page 92. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

9.3.32 uservicesquality Table

For the table description, see "UMTSServicesQuality Table" on page 93.

9.3.33 uterminals Table

For the table description, see "UMTSTerminals Table" on page 94.

9.3.34 uterminalbands Table

For the table description, see "uterminalbands Table" on page 96.

296 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.3.35 utpltransmitters Table

For the table description, see "TplTransmitters Table" on page 84.

9.3.36 utransmitters Table

For the table description, see "Transmitters Table" on page 88.

9.3.37 utxslists Table

For the table description, see "TxsLists Table" on page 90.

9.3.38 utxslistsnames Table

For the table description, see "TxsListsNames Table" on page 90.

9.3.39 uuecategories Table

For the table description, see "UECategories Table" on page 90.

9.3.40 uuerxequipments Table

For the table description, see "UERxEquipments Table" on page 91.

9.3.41 uxgneighbours 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:

© 2022 Forsk. All Rights Reserved. 297


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.3.42 uxgneighconstraints 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:

9.4 GSM Data Tables


For the list of changes made to the data structure in this version, see "Data Structure Changes from Atoll 3.4 to 3.5"
on page 27.

9.4.1 gafpmodels Table

For the table description, see "AfpModels Table" on page 27.

9.4.2 gbsicdomains Table

For the table description, see "BSICDomains Table" on page 28.

9.4.3 gbsicgroups Table

For the table description, see "BSICGroups Table" on page 29.

9.4.4 gcelltypes Table

For the table description, see "CellTypes Table" on page 29.

9.4.5 gcodecequipments Table

For the table description, see "CodecEquipments Table" on page 30.

298 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.4.6 gcodecmodeadapts Table

For the table description, see "CodecModeAdaptations Table" on page 30.

9.4.7 gcodecmodes Table

For the table description, see "CodecModes Table" on page 30.

9.4.8 gcodecqualtables Table

For the table description, see "CodecQualityTables Table" on page 31.

9.4.9 gcodingschemes Table

For the table description, see "EGPRSCodingSchemes Table" on page 34.

9.4.10 gcsequipments Table

For the table description, see "EGPRSEquipments Table" on page 35.

9.4.11 gcsquality Table

For the table description, see "EGPRSQuality Table" on page 35.

9.4.12 gdimensmodel Table

For the table description, see "EGPRSDimensioningModel Table" on page 34.

9.4.13 gfreqdomains Table

For the table description, see "FrequencyDomains Table" on page 40.

9.4.14 gfreqgroups Table

For the table description, see "FrequencyGroups Table" on page 40.

© 2022 Forsk. All Rights Reserved. 299


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.4.15 gfrequencybands Table

For the table description, see "FrequencyBands Table" on page 39.

9.4.16 ghsndomains Table

For the table description, see "HSNDomains Table" on page 40.

9.4.17 ghsngroups Table

For the table description, see "HSNGroups Table" on page 40.

9.4.18 glayers Table

For the table description, see "Layers Table" on page 41.

9.4.19 gneighbours Table

For the table description, see "Neighbours Table" on page 41.

9.4.20 gneighconstraints Table

For the table description, see "NeighboursConstraints Table" on page 42.

9.4.21 gqualityindicators Table

For the table description, see "QualityIndicators Table" on page 44.

9.4.22 grepeaters Table

For the table description, see "Repeaters Table" on page 45.

9.4.23 gsecondaryantennas Table

For the table description, see "SecondaryAntennas Table" on page 46.

300 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.4.24 gseparationrules Table

For the table description, see "SeparationRules Table" on page 46.

9.4.25 gseparations Table

For the table description, see "Separations Table" on page 47.

9.4.26 gservicequality Table

For the table description, see "EGPRSServiceQuality Table" on page 36.

9.4.27 gservices Table

For the table description, see "EGPRSServices Table" on page 36. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

9.4.28 gterminals Table

For the table description, see "EGPRSTerminals Table" on page 37.

9.4.29 gtpltransmitters Table

For the table description, see "TplTransmitters Table" on page 48.

9.4.30 gtransmitters Table

For the table description, see "Transmitters Table" on page 50.

9.4.31 gtrgconfigs Table

For the table description, see "TRGConfigurations Table" on page 53.

© 2022 Forsk. All Rights Reserved. 301


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.4.32 gtrgs Table

For the table description, see "TRGs Table" on page 54.

9.4.33 gtrxequipments Table

For the table description, see "TRXEquipments Table" on page 56.

9.4.34 gtrxs Table

For the table description, see "TRXs Table" on page 56.

9.4.35 gtrxtypes Table

For the table description, see "TRXTypes Table" on page 57.

9.4.36 gtsconfignames Table

For the table description, see "TSConfigurationNames Table" on page 57.

9.4.37 gtsconfigs Table

For the table description, see "TSConfigurations Table" on page 57.

9.4.38 gtxslists Table

For the table description, see "TxsLists Table" on page 58.

9.4.39 gtxslistsnames Table

For the table description, see "TxsListsNames Table" on page 58.

302 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.4.40 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:

9.4.41 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:

9.4.42 gxgneighbours 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:

© 2022 Forsk. All Rights Reserved. 303


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

9.4.43 gxgneighconstraints 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:

9.5 In-Building Data Tables

9.5.1 ibbuildings Table

For buildings.

Field Type Description Attributes


ALIAS_ Text (15) Building alias. Nullable: Yes
Default:

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

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


Default:

9.5.2 ibcomponents

For in-building installed network components.

Field Type Description Attributes

AZIMUTH Float Azimuth of the installed antenna. Nullable: Yes


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

DIRECTION Double Direction of the ports for drawing. Nullable: Yes


Default:

EQUIPMENT_NAME Text (50) Name of the equipment model. Nullable: Yes


Default:
FLOOR_NAME Text (50) Name of the floor to which the component belongs. Nullable: Yes
Default:

IB_POSITIONS Binary Vector of points for several Z values (cables only). Nullable: Yes
Default:

304 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

IB_X Double X coordinate of the component location. Nullable: Yes


Default:

IB_Y Double Y coordinate of the component location. Nullable: Yes


Default:

IB_Z Double Z coordinate of the component location. Nullable: Yes


Default:
LENGTH Double Cable length. Nullable: Yes
Default: 0

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


Default:

OPERATOR Text (50) SouName of the operator to which the component belongs. Nullable: Yes
Default:
SHARED_SOURCE Text (50) Whether the source component is shared and with which other component. Nullable: Yes
Default:

TILT Float Downtilt of the antenna. Nullable: Yes


Default: 0

9.5.3 ibconnections

For in-building connections.

Field Type Description Attributes

ADAPTATOR_NAME Text (50) Name of the equipment model. Nullable: Yes


Default:

COMMENT_ Text (255) Additional information about the connection. Nullable: Yes
Default:
IN_PORT_KEY Text (50) Name of the input port. Nullable: No
Default:

OUT_PORT_KEY Text (50) Name of the output port. Nullable: No


Default:

9.5.4 ibequipment

For in-building equipment catalogues.

Field Type Description Attributes

ATTENUATION_RANGE Integer Attenuation range. Nullable: Yes


Default: 0
ATTENUATION_STEP Float Attenuation step. Nullable: Yes
Default: 0

CABLE_CATEGORY Byte Category of cable. 0=Bulk; 1=Assembly. Nullable: Yes


Default: 0

CABLE_TYPE Byte Type of cable. 0=Radio; 1=Optical; 2=Ethernet. Nullable: Yes


Default: 0
DESCRIPTION Text (255) Description of the equipment model. Nullable: Yes
Default:

FMAX Float Maximum operating frequency of the equipment model. Nullable: Yes
Default:

© 2022 Forsk. All Rights Reserved. 305


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

FMIN Float Minimum operating frequency of the equipment model. Nullable: Yes
Default:

INSERTION_LOSS Float Insertion loss. Nullable: Yes


Default: 0

LENGTH Float Assembled cable length. Nullable: Yes


Default:
MANUFACTURER Text (50) Name of the equipment manufacturer. Nullable: Yes
Default:

MAX_OUTPUT_POWER Memo Maximum output power of the equipment for various frequencies. Nullable: Yes
Default:

MODEL_TYPE Text (50) Type of the equipment model: Source, Antenna, Splitter, Cable, etc. Nullable: Yes
Default:
NAME Text (50) Name of the equipment model. Nullable: No
Default:

9.5.5 ibequipmentports

For in-building equipment port details.

Field Type Description Attributes

CABLE_TYPE Byte Type of cable. 0=Radio; 1=Optical; 2=Ethernet. Nullable: Yes


Default: 0

CONNECTOR_TYPE Text (50) Type of connector. 0=Radio; 1=Optical; 2=Ethernet. Nullable: Yes
Default:

EQUIPMENT_NAME Text (50) Name of the equipment model to which the port belongs. Nullable: No
Default:
GENDER Byte Gender of the port. 0=Male; 1=Female. Nullable: Yes
Default: 0

INOUT_TYPE Short Type of port. 0=Input port; 1=Output port. Nullable: Yes
Default:

LOSSES_DL Memo Downlink losses for different frequencies. Nullable: Yes


Default:
LOSSES_UL Memo Uplink losses for different frequencies. Nullable: Yes
Default:

NAME Text (50) Name of the port. Nullable: Yes


Default:

PORT_KEY Text (50) Name of the port. Nullable: No


Default:

9.5.6 ibfloors

For floors.

Field Type Description Attributes


ALIAS_ Text (15) Alias of the floor. Nullable: Yes
Default:

BUILDING Text (50) Name of the building to which the floor belongs. Nullable: Yes
Default:

306 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Field Type Description Attributes

CABLETRAYS Binary Cable trays on the floor. Nullable: Yes


Default:

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

ENVIRONMENTS Binary Environments of the floor. Nullable: Yes


Default:
HEIGHT Double Height of the floor. Nullable: Yes
Default:

NAME Text (50) Minimum operating frequency of the equipment model. Nullable: No
Default:

OPENINGS Binary Openings (doors, windows, etc.) on the floor. Nullable: Yes
Default:
PILLARS Binary Pillars on the floor. Nullable: Yes
Default:

PLAN Binary Floor plan. Nullable: Yes


Default:

SURFACES Binary Horizontal and inclined surfaces on the floor. Nullable: Yes
Default:
WALLS Binary Walls on the floor. Nullable: Yes
Default:

WALLS_HEIGHT Double Height of the walls. Nullable: Yes


Default: 3

9.5.7 ibgtransmitters

For in-building GSM transmitters.

Field Type Description Attributes

COMPONENT_NAME Text (50) Name of the GSM source. Nullable: No


Default:

TX_ID Text (100) Name of the GSM transmitter attached to the source. Nullable: No
Default:

9.5.8 ibintralosses

For in-building equipment internal losses.

Field Type Description Attributes

GAIN_DL Memo Downlink gains for different frequencies. Nullable: Yes


Default:
GAIN_UL Memo Uplink gains for different frequencies. Nullable: Yes
Default:

LOSSES_DL Memo Downlink losses for different frequencies. Nullable: Yes


Default:

© 2022 Forsk. All Rights Reserved. 307


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Field Type Description Attributes

LOSSES_UL Memo Uplink losses for different frequencies. Nullable: Yes


Default:

PORT1_KEY Text (50) Name of the first port. Nullable: No


Default:

PORT2_KEY Text (50) Name of the second port. Nullable: No


Default:

9.5.9 ibports

For connected ports of installed in-building components.

Field Type Description Attributes


COMPONENT_NAME Text (50) Name of the installed component to which the port belongs. Nullable: No
Default:

CONNECTOR_NAME Text (50) Name of the connector. Nullable: Yes


Default:

EQUIP_PORT_KEY Text (50) Name of the equipment port. Nullable: Yes


Default:
PORT_KEY Text (50) Name of the port. Nullable: No
Default:

TERMINATION_LOAD_NAME Text (50) Name of the termination load. Nullable: Yes


Default:

9.5.10 ibutransmitters

For in-building UMTS transmitters.

Field Type Description Attributes

COMPONENT_NAME Text (50) Name of the UMTS source. Nullable: No


Default:

TX_ID Text (100) Name of the UMTS transmitter attached to the source. Nullable: No
Default:

9.5.11 ibxgtransmitters

For in-building 4G/5G transmitters.

Field Type Description Attributes

COMPONENT_NAME Text (50) Name of the 4G/5G source. Nullable: No


Default:

TX_ID Text (100) Name of the 4G/5G transmitter attached to the source. Nullable: No
Default:

308 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

9.6 Relationships

Many-to-One Relationships ( ∞ 1)

environmentdefs.ENVIRONMENT trafficenvs.NAME

environmentdefs.MOBILITY mobility.NAME
environmentdefs.USER_PROFILE userprofiles.NAME

gbsicgroups.DOMAIN_NAME gbsicdomains.NAME

gcodecequipments.IDEAL_QI_NAME gqualityindicators.NAME
gcodecmodeadapts.CODEC_EQT gcodecequipments.NAME

gcodecmodeadapts.CODEC_MODE gcodecmodes.NAME

gcodecmodeadapts.FREQUENCY_BAND gfrequencybands.NAME
gcodecmodeadapts.MOBILITY mobility.NAME

gcodecqualtables.CODEC_EQT gcodecequipments.NAME

gcodecqualtables.CODEC_MODE gcodecmodes.NAME

gcodecqualtables.FREQUENCY_BAND gfrequencybands.NAME
gcodecqualtables.MOBILITY mobility.NAME

gcodecqualtables.QI_NAME gqualityindicators.NAME

gcsquality.CS_NAME gcodingschemes.NAME

gcsquality.EQUIPMENT gcsequipments.NAME

gcsquality.FREQUENCY_BAND gfrequencybands.NAME

gcsquality.MOBILITY mobility.NAME

gfreqdomains.FREQUENCY_BAND_NAME gfrequencybands.NAME

gfreqgroups.DOMAIN_NAME gfreqdomains.NAME

ghsngroups.DOMAIN_NAME ghsndomains.NAME

gneighbours.NEIGHBOUR gtransmitters.TX_ID

gneighbours.TRANSMITTER gtransmitters.TX_ID

gneighconstraints.NEIGHBOUR gtransmitters.TX_ID

gneighconstraints.TRANSMITTER gtransmitters.TX_ID

grepeaters.DONOR_CELLID gtransmitters.TX_ID

grepeaters.DONOR_PROPAG_MODEL propagationmodels.NAME

grepeaters.EQUIPMENT_NAME repeaterequipments.NAME

grepeaters.FEEDER_NAME feederequipments.NAME

grepeaters.REC_ANTENNA antennas.NAME

grepeaters.TX_ID gtransmitters.TX_ID

gsecondaryantennas.ANTENNA antennas.NAME

gsecondaryantennas.TX_ID gtransmitters.TX_ID

gseparations.TX_ID gtransmitters.TX_ID

gseparations.TX_ID_OTHER gtransmitters.TX_ID

gservicequality.DIMENSIONING_MODEL gdimensmodel.NAME

gservices.NAME services.NAME

gterminals.CODEC_EQUIPMENT gcodecequipments.NAME

gterminals.EGPRS_EQUIPMENT gcsequipments.NAME

gterminals.NAME terminals.NAME

gterminals.PRIMARY_BAND gfrequencybands.NAME

gterminals.SECONDARY_BAND gfrequencybands.NAME

© 2022 Forsk. All Rights Reserved. 309


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Many-to-One Relationships ( ∞ 1)

gtpltransmitters.ANTENNA_NAME antennas.NAME

gtpltransmitters.BSIC_DOMAIN gbsicdomains.NAME

gtpltransmitters.BTS_NAME btsequipments.NAME

gtpltransmitters.CELL_TYPE gcelltypes.NAME

gtpltransmitters.CODEC_EQUIPMENT gcodecequipments.NAME

gtpltransmitters.EGPRS_EQUIPMENT gcsequipments.NAME

gtpltransmitters.FEEDER_NAME feederequipments.NAME

gtpltransmitters.LAYER glayers.NAME

gtpltransmitters.PROPAG_MODEL propagationmodels.NAME

gtpltransmitters.PROPAG_MODEL2 propagationmodels.NAME

gtpltransmitters.TMA_NAME tmaequipments.NAME

gtransmitters.ANTENNA_NAME antennas.NAME

gtransmitters.BSIC_DOMAIN gbsicdomains.NAME

gtransmitters.BTS_NAME btsequipments.NAME

gtransmitters.CELL_TYPE gcelltypes.NAME

gtransmitters.CODEC_EQUIPMENT gcodecequipments.NAME

gtransmitters.EGPRS_EQUIPMENT gcsequipments.NAME

gtransmitters.FBAND gfrequencybands.NAME

gtransmitters.FEEDER_NAME feederequipments.NAME
gtransmitters.LAYER glayers.NAME

gtransmitters.PROPAG_MODEL propagationmodels.NAME

gtransmitters.PROPAG_MODEL2 propagationmodels.NAME
gtransmitters.SITE_NAME sites.NAME

gtransmitters.TMA_NAME tmaequipments.NAME

gtrgconfigs.CELL_TYPE gcelltypes.NAME
gtrgconfigs.DEF_TRX_EQUIPMENT gtrxequipments.NAME

gtrgconfigs.FREQUENCY_DOMAIN gfreqdomains.NAME

gtrgconfigs.HSN_DOMAIN ghsndomains.NAME
gtrgconfigs.TRX_TYPE gtrxtypes.NAME

gtrgconfigs.TS_CONFIGURATION_NAME gtsconfignames.NAME

gtrgs.DEF_TRX_EQUIPMENT gtrxequipments.NAME

gtrgs.FREQUENCY_DOMAIN gfreqdomains.NAME

gtrgs.HSN_DOMAIN ghsndomains.NAME

gtrgs.TRX_TYPE gtrxtypes.NAME

gtrgs.TS_CONFIGURATION_NAME gtsconfignames.NAME

gtrgs.TX_ID gtransmitters.TX_ID

gtrxs.TRX_EQUIPMENT gtrxequipments.NAME
gtrxs.TRX_TYPE gtrxtypes.NAME

gtrxs.TX_ID gtransmitters.TX_ID

gtsconfigs.NAME gtsconfignames.NAME

gtxslists.LIST_NAME gtxslistsnames.NAME

gtxslists.TX_NAME gtransmitters.TX_ID

ibcomponents.EQUIPMENT_NAME ibequipment.NAME

ibcomponents.FLOOR_NAME ibfloors.NAME

310 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Many-to-One Relationships ( ∞ 1)

ibconnections.ADAPTATOR_NAME ibequipment.NAME

ibconnections.IN_PORT_KEY ibports.PORT_KEY

ibconnections.OUT_PORT_KEY ibports.PORT_KEY

ibequipmentports.EQUIPMENT_NAME ibequipment.NAME

ibfloors.BUILDING ibbuildings.NAME

ibgtransmitters.COMPONENT_NAME ibcomponents.NAME

ibgtransmitters.TX_ID gtransmitters.TX_ID

ibintralosses.PORT1_KEY ibequipmentports.PORT_KEY

ibintralosses.PORT2_KEY ibequipmentports.PORT_KEY

ibports.COMPONENT_NAME ibcomponents.NAME

ibports.CONNECTOR_NAME ibequipment.NAME

ibports.EQUIP_PORT_KEY ibequipmentports.PORT_KEY

ibports.TERMINATION_LOAD_NAME ibequipment.NAME

ibutransmitters.COMPONENT_NAME ibcomponents.NAME

ibutransmitters.TX_ID utransmitters.TX_ID

ibxgtransmitters.COMPONENT_NAME ibcomponents.NAME

ibxgtransmitters.TX_ID xgtransmitters.TX_ID

networks.DEFAULT_MODEL propagationmodels.NAME

receivers.ANTENNA antennas.NAME
servicesusage.SERVICE services.NAME

servicesusage.TERMINAL terminals.NAME

servicesusage.USER_PROFILE userprofiles.NAME
sites.CDMA_EQUIPMENT uequipments.NAME

siteslists.LIST_NAME siteslistsnames.NAME

siteslists.SITE_NAME sites.NAME
ucells.HSDPA_SCHEDULER uschedulers.NAME

ucells.LAYER ulayers.LAYER_INDEX

ucells.SC_DOMAIN_NAME upscdomains.DOMAIN_NAME
ucells.TX_ID utransmitters.TX_ID

uceuse.EQUIPMENT uequipments.NAME

uceuse.SERVICE ur99bearers.NAME

uequipments.SCHEDULER_ALGO uschedulers.NAME

uhsdpabearerselect.MOBILITY mobility.NAME

uhsdpabearerselect.RX_EQUIP uuerxequipments.NAME

uhsdpaqualtables.BEARER_INDEX uhsdpabearers.BEARER_INDEX

uhsdpaqualtables.MOBILITY mobility.NAME

uhsdpaqualtables.QI_NAME uqualityindicators.NAME
uhsdpaqualtables.RX_EQUIP uuerxequipments.NAME

uhspamimoconfigs.HSDPA_BEARER_INDEX uhsdpabearers.BEARER_INDEX

uhspamimoconfigs.MOBILITY mobility.NAME

uhspamimoconfigs.RX_EQUIP uuerxequipments.NAME

uhsupabearerselect.BEARER_INDEX uhsupabearers.BEARER_INDEX

uhsupabearerselect.MOBILITY mobility.NAME

uhsupabearerselect.RX_EQUIP uuerxequipments.NAME

© 2022 Forsk. All Rights Reserved. 311


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Many-to-One Relationships ( ∞ 1)

uhsupaqualtables.BEARER_INDEX uhsupabearers.BEARER_INDEX

uhsupaqualtables.MOBILITY mobility.NAME

uhsupaqualtables.QI_NAME uqualityindicators.NAME

uhsupaqualtables.RX_EQUIP uuerxequipments.NAME

uhsuparessuse.BEARER_INDEX uhsupabearers.BEARER_INDEX

uhsuparessuse.EQUIPMENT uequipments.NAME

umobility.NAME mobility.NAME

umugtables.SCHEDULER_NAME uschedulers.NAME

uneighbours.NEIGHBOUR ucells.CELL_ID

uneighbours.TRANSMITTER ucells.CELL_ID

uneighconstraints.NEIGHBOUR ucells.CELL_ID

uneighconstraints.TRANSMITTER ucells.CELL_ID

units.COORD_SYSTEM coordsys.CODE

units.PROJECTION coordsys.CODE

upscforbidpairs.TX_ID ucells.CELL_ID

upscforbidpairs.TX_ID_OTHER ucells.CELL_ID

upscgroups.DOMAIN_NAME upscdomains.DOMAIN_NAME

urepeaters.DONOR_CELLID utransmitters.TX_ID

urepeaters.DONOR_PROPAG_MODEL propagationmodels.NAME
urepeaters.EQUIPMENT_NAME repeaterequipments.NAME

urepeaters.FEEDER_NAME feederequipments.NAME

urepeaters.REC_ANTENNA antennas.NAME
urepeaters.TX_ID utransmitters.TX_ID

usecondaryantennas.ANTENNA antennas.NAME

usecondaryantennas.TX_ID utransmitters.TX_ID
uservicequaltables.MOBILITY mobility.NAME

uservicequaltables.QI_NAME uqualityindicators.NAME

uservicequaltables.RX_EQUIP uuerxequipments.NAME
uservicequaltables.SERVICE ur99bearers.NAME

uservices.NAME services.NAME

uservices.R99BEARER ur99bearers.NAME

uservicesquality.MOBILITY mobility.NAME

uservicesquality.RX_EQUIP uuerxequipments.NAME

uservicesquality.SERVICE ur99bearers.NAME

uterminalbands.FBAND_NAME ufrequencybands.NAME

uterminalbands.TERMINAL_NAME uterminals.NAME

uterminals.HSUPA_UE_CATEGORY uhsupauecategories.UE_CATEGORY
uterminals.NAME terminals.NAME

uterminals.RX_EQUIP uuerxequipments.NAME

uterminals.UE_CATEGORY uuecategories.UE_CATEGORY

utpltransmitters.ANTENNA_NAME antennas.NAME

utpltransmitters.BTS_NAME btsequipments.NAME

utpltransmitters.CDMA_EQUIPMENT uequipments.NAME

utpltransmitters.FBAND ufrequencybands.NAME

312 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Many-to-One Relationships ( ∞ 1)

utpltransmitters.FEEDER_NAME feederequipments.NAME

utpltransmitters.HSDPA_SCHEDULER uschedulers.NAME

utpltransmitters.PROPAG_MODEL propagationmodels.NAME

utpltransmitters.PROPAG_MODEL2 propagationmodels.NAME

utpltransmitters.SC_DOMAIN_NAME upscdomains.DOMAIN_NAME

utpltransmitters.TMA_NAME tmaequipments.NAME

utransmitters.ANTENNA_NAME antennas.NAME

utransmitters.BTS_NAME btsequipments.NAME

utransmitters.FBAND ufrequencybands.NAME

utransmitters.FEEDER_NAME feederequipments.NAME

utransmitters.PROPAG_MODEL propagationmodels.NAME

utransmitters.PROPAG_MODEL2 propagationmodels.NAME

utransmitters.SITE_NAME sites.NAME

utransmitters.TMA_NAME tmaequipments.NAME

utxslists.LIST_NAME utxslistsnames.NAME

utxslists.TX_NAME utransmitters.TX_ID

uxgneighbours.NEIGHBOUR xgcellsuids.CELL_ID

uxgneighbours.TRANSMITTER ucells.CELL_ID

uxgneighconstraints.NEIGHBOUR xgcellsuids.CELL_ID
uxgneighconstraints.TRANSMITTER ucells.CELL_ID

xgbeamsetdefs.BEAM_SET_NAME xgbeamsets.NAME

xgbeamsets.BF_MODEL xgbfmodels.NAME
xgbearers.EQUIPMENT xgequipments.NAME

xgbfmodels.ELEMENT_PATTERN antennas.NAME

xgbfpatterns.BF_MODEL xgbfmodels.NAME
xgcagroupdefs.CA_GROUP_NAME xgcagroups.NAME

xgcagroupdefs.MEMBER_CELL_NAME xgcellsuids.CELL_ID

xgcarriers.FBAND xgfreqbands.NAME
xgcchgains.EQUIPMENT xgequipments.NAME

xgcchgains.MOBILITY mobility.NAME

xgcells5gnr.BEAM_SET xgbeamsets.NAME

xgcells5gnr.CARRIER xgcarriers.NAME

xgcells5gnr.CELL_ID xgcellsuids.CELL_ID

xgcells5gnr.EQUIPMENT xgequipments.NAME

xgcells5gnr.LAYER xglayers.LAYER_INDEX

xgcells5gnr.PAIRED_CELL_NAME xgcellslte.CELL_ID

xgcells5gnr.PCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME
xgcells5gnr.PRACH_RSI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcells5gnr.SCHEDULER xgschedulers.NAME

xgcellslte.BEAM_SET xgbeamsets.NAME

xgcellslte.CARRIER xgcarriers.NAME

xgcellslte.CELL_ID xgcellsuids.CELL_ID

xgcellslte.EQUIPMENT xgequipments.NAME

xgcellslte.LAYER xglayers.LAYER_INDEX

© 2022 Forsk. All Rights Reserved. 313


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Many-to-One Relationships ( ∞ 1)

xgcellslte.PCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcellslte.PRACH_RSI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcellslte.SCHEDULER xgschedulers.NAME

xgcellsnbiot.CARRIER xgcarriers.NAME

xgcellsnbiot.CELL_ID xgcellsuids.CELL_ID

xgcellsnbiot.EQUIPMENT xgequipments.NAME

xgcellsnbiot.LAYER xglayers.LAYER_INDEX

xgcellsnbiot.NPCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgcellsuids.TX_ID xgtransmitters.TX_ID

xgcellswifi.BEAM_SET xgbeamsets.NAME

xgcellswifi.CARRIER xgcarriers.NAME

xgcellswifi.CELL_ID xgcellsuids.CELL_ID

xgcellswifi.EQUIPMENT xgequipments.NAME

xgcellswifi.LAYER xglayers.LAYER_INDEX

xgcellswifi.SCHEDULER xgschedulers.NAME

xgcompsetdefs.COMP_SET_NAME xgcompsets.NAME

xgcompsetdefs.MEMBER_CELL_NAME xgcellsuids.CELL_ID

xgidgroups.DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgirfs.EQUIPMENT xgequipments.NAME
xglayerthresholds.LAYER_INDEX xglayers.LAYER_INDEX

xglayerthresholds.MOBILITY mobility.NAME

xgmuggains.BEARER_INDEX xgbearers.BEARER_INDEX
xgmuggains.MOBILITY mobility.NAME

xgmuggains.SCHEDULER_NAME xgschedulers.NAME

xgneighbours.NEIGHBOUR xgcellsuids.CELL_ID
xgneighbours.TRANSMITTER xgcellsuids.CELL_ID

xgneighconstraints.NEIGHBOUR xgcellsuids.CELL_ID

xgneighconstraints.TRANSMITTER xgcellsuids.CELL_ID
xgqigraphs.BEARER_INDEX xgbearers.BEARER_INDEX

xgqigraphs.MOBILITY mobility.NAME

xgqigraphs.RX_EQUIP xgequipments.NAME

xgrelaylinks.ANTENNA antennas.NAME

xgrelaylinks.DONOR_CELL_ID xgcellsuids.CELL_ID

xgrelaylinks.FEEDER_NAME feederequipments.NAME

xgrelaylinks.PROPAG_MODEL propagationmodels.NAME

xgrelaylinks.RELAY_SITE_NAME sites.NAME

xgrepeaters.DONOR_CELLID xgtransmitters.TX_ID
xgrepeaters.DONOR_PROPAG_MODEL propagationmodels.NAME

xgrepeaters.EQUIPMENT_NAME repeaterequipments.NAME

xgrepeaters.FEEDER_NAME feederequipments.NAME

xgrepeaters.REC_ANTENNA antennas.NAME

xgrepeaters.TX_ID xgtransmitters.TX_ID

xgrepetitions.EQUIPMENT xgequipments.NAME

xgrepetitions.MOBILITY mobility.NAME

314 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 9: In-Building Data Structure

Many-to-One Relationships ( ∞ 1)

xgsecondaryantennas.ANTENNA antennas.NAME

xgsecondaryantennas.TX_ID xgtransmitters.TX_ID

xgservices.NAME services.NAME

xgsfnclusterdefs.MEMBER_CELL_NAME xgcellsuids.CELL_ID

xgsfnclusterdefs.SFN_CLUSTER_NAME xgsfnclusters.NAME

xgsfnclusters.SFN_COORDINATOR xgcellsuids.CELL_ID

xgtchgains.BEARER_INDEX xgbearers.BEARER_INDEX

xgtchgains.EQUIPMENT xgequipments.NAME

xgtchgains.MOBILITY mobility.NAME

xgterminalbands.FBAND_NAME xgfreqbands.NAME

xgterminalbands.TERMINAL xgterminals.TERMINAL_INDEX

xgterminals.ANTENNA antennas.NAME

xgterminals.EQUIPMENT xgequipments.NAME

xgterminals.NAME terminals.NAME

xgterminals.UE_CATEGORY xguecategories.NAME

xgthresholds.MOBILITY mobility.NAME

xgthresholds.RX_EQUIP xgequipments.NAME

xgtpltransmitters.ANTENNA_NAME antennas.NAME

xgtpltransmitters.BEAM_SET xgbeamsets.NAME
xgtpltransmitters.BF_MODEL xgbfmodels.NAME

xgtpltransmitters.BTS_NAME btsequipments.NAME

xgtpltransmitters.CARRIER xgcarriers.NAME
xgtpltransmitters.EQUIPMENT xgequipments.NAME

xgtpltransmitters.FEEDER_NAME feederequipments.NAME

xgtpltransmitters.PCI_DOMAIN_NAME xgiddomains.DOMAIN_NAME
xgtpltransmitters.PRACH_RSI_DOMAIN_NAME xgiddomains.DOMAIN_NAME

xgtpltransmitters.PROPAG_MODEL propagationmodels.NAME

xgtpltransmitters.PROPAG_MODEL2 propagationmodels.NAME
xgtpltransmitters.SCHEDULER xgschedulers.NAME

xgtpltransmitters.TMA_NAME tmaequipments.NAME

xgtransmitters.ANTENNA_NAME antennas.NAME

xgtransmitters.BF_MODEL xgbfmodels.NAME

xgtransmitters.BTS_NAME btsequipments.NAME

xgtransmitters.FBAND xgfreqbands.NAME

xgtransmitters.FEEDER_NAME feederequipments.NAME

xgtransmitters.PROPAG_MODEL propagationmodels.NAME

xgtransmitters.PROPAG_MODEL2 propagationmodels.NAME
xgtransmitters.SITE_NAME sites.NAME

xgtransmitters.TMA_NAME tmaequipments.NAME

xgtxslists.LIST_NAME xgtxslistsnames.NAME

xgtxslists.TX_NAME xgtransmitters.TX_ID

xguneighbours.NEIGHBOUR ucells.CELL_ID

xguneighbours.TRANSMITTER xgcellsuids.CELL_ID

© 2022 Forsk. All Rights Reserved. 315


Atoll 3.5.0 Data Structure Reference Guide
Chapter 9: In-Building Data Structure

Many-to-One Relationships ( ∞ 1)

xguneighconstraints.NEIGHBOUR ucells.CELL_ID

xguneighconstraints.TRANSMITTER xgcellsuids.CELL_ID

316 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10 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 317
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 323
 "UMTS-specific Tables" on page 328
 "LTE-specific Tables" on page 333
These tables are specific to technologies. Their structures are the same as in single-technology documents.

q Primary keys are listed in bold and italic characters.

10.1 Tables Common to 3GPP Technologies

10.1.1 Data Structure Changes from Atoll 3.4 to 3.5

10.1.1.1 Added Tables and Fields


None.

10.1.1.2 Deleted Tables and Fields


None.

10.1.2 Data Structure

10.1.2.1 antennas Table


For the table description, see "Antennas Table" on page 131.

© 2022 Forsk. All Rights Reserved. 317


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

10.1.2.2 btsequipments Table


For the table description, see "BTSEquipments Table" on page 132.

10.1.2.3 coordsys Table


For the table description, see "CoordSys Table" on page 132.

10.1.2.4 customfields Table


For the table description, see "CustomFields Table" on page 133.

10.1.2.5 environmentdefs Table


For the table description, see "T4GEnvironmentDefs Table" on page 153.

10.1.2.6 feederequipments Table


For the table description, see "FeederEquipments Table" on page 135.

10.1.2.7 internetchprotect Table


For the table description, see "InterNetChProtect Table" on page 136. 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:

10.1.2.8 mobility Table


Figure 10.1 on page 318, shows the multi-level definition of the multi-RAT mobility types model tables.

Figure 10.1: : 3GPP Mobility Types Model

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:

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

318 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

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
COM- Float Downlink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_DL_QUAL Default: 1

COM- Float Uplink Eb/Nt target overhead due to compressed mode. Unit: dB. Nullable: No
PRESSED_DELTA_UL_QUAL 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 Whether 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

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

© 2022 Forsk. All Rights Reserved. 319


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

POWERS_RELATIVE_TO_PI- Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
LOT 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_- Float RSCP threshold for compressed mode activation. Unit: dB. Nullable: No
THRESHOLD 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

10.1.2.10 propagationmodels Table


For the table description, see "PropagationModels Table" on page 145.

10.1.2.11 receivers Table


For the table description, see "Receivers Table" on page 44.

10.1.2.12 repeaterequipments Table


For the table description, see "RepeaterEquipments Table" on page 146.

10.1.2.13 services Table


Figure 10.2 on page 321, shows the multi-level definition of the multi-RAT services model tables.

320 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

Figure 10.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

10.1.2.14 servicesusage Table


For the table description, see "T4GServicesUsage Table" on page 156.

10.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:

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

© 2022 Forsk. All Rights Reserved. 321


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

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:

10.1.2.16 siteslists Table


For the table description, see "SitesLists Table" on page 148.

10.1.2.17 siteslistsnames Table


For the table description, see "SitesListsNames Table" on page 148.

10.1.2.18 smartantennasmodels Table


For the table description, see "SmartAntennasModels Table" on page 149.

10.1.2.19 terminals Table


Figure 10.3 on page 322, shows the multi-level definition of the multi-RAT terminals model tables.

Figure 10.3: : 3GPP Terminals Model

Field Type Description Attributes

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


Default:

10.1.2.20 tmaequipments Table


For the table description, see "TMAEquipments Table" on page 158.

322 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10.1.2.21 trafficenvs Table


For the table description, see "T4GTraficEnvironments Table" on page 158.

10.1.2.22 units Table


For the table description, see "Units Table" on page 58.

10.1.2.23 userprofiles Table


For the table description, see "T4GUserProfiles Table" on page 158.

10.2 GSM-specific Tables

10.2.1 Data Structure Changes from Atoll 3.2 to 3.3

10.2.1.1 Added Tables and Fields


None.

10.2.1.2 Deleted Tables and Fields


None.

10.2.2 Data Structure

10.2.2.1 gafpmodels Table


For the table description, see "AfpModels Table" on page 27.

10.2.2.2 gbsicdomains Table


For the table description, see "BSICDomains Table" on page 28.

10.2.2.3 gbsicgroups Table


For the table description, see "BSICGroups Table" on page 29.

10.2.2.4 gcelltypes Table


For the table description, see "CellTypes Table" on page 29.

© 2022 Forsk. All Rights Reserved. 323


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

10.2.2.5 gcodecequipments Table


For the table description, see "CodecEquipments Table" on page 30.

10.2.2.6 gcodecmodeadapts Table


For the table description, see "CodecModeAdaptations Table" on page 30.

10.2.2.7 gcodecmodes Table


For the table description, see "CodecModes Table" on page 30.

10.2.2.8 gcodecqualtables Table


For the table description, see "CodecQualityTables Table" on page 31.

10.2.2.9 gcodingschemes Table


For the table description, see "EGPRSCodingSchemes Table" on page 34.

10.2.2.10 gcsequipments Table


For the table description, see "EGPRSEquipments Table" on page 35.

10.2.2.11 gcsquality Table


For the table description, see "EGPRSQuality Table" on page 35.

10.2.2.12 gdimensmodel Table


For the table description, see "EGPRSDimensioningModel Table" on page 34.

10.2.2.13 gfreqdomains Table


For the table description, see "FrequencyDomains Table" on page 40.

10.2.2.14 gfreqgroups Table


For the table description, see "FrequencyGroups Table" on page 40.

10.2.2.15 gfrequencybands Table


For the table description, see "FrequencyBands Table" on page 39.

10.2.2.16 ghsndomains Table


For the table description, see "HSNDomains Table" on page 40.

324 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10.2.2.17 ghsngroups Table


For the table description, see "HSNGroups Table" on page 40.

10.2.2.18 glayers Table


For the table description, see "Layers Table" on page 41.

10.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:

10.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:

10.2.2.21 gneighbours Table


For the table description, see "Neighbours Table" on page 41.

10.2.2.22 gneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 42.

10.2.2.23 gneighext Table


For the table description, see "NeighboursExt Table" on page 42.

© 2022 Forsk. All Rights Reserved. 325


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

10.2.2.24 gneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 42.

10.2.2.25 gqualityindicators Table


For the table description, see "QualityIndicators Table" on page 44.

10.2.2.26 grepeaters Table


For the table description, see "Repeaters Table" on page 45.

10.2.2.27 gsecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 46.

10.2.2.28 gseparationrules Table


For the table description, see "SeparationRules Table" on page 46.

10.2.2.29 gseparations Table


For the table description, see "Separations Table" on page 47.

10.2.2.30 gservicequality Table


For the table description, see "EGPRSServiceQuality Table" on page 36.

10.2.2.31 gservices Table


For the table description, see "EGPRSServices Table" on page 36. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

10.2.2.32 gterminals Table


For the table description, see "EGPRSTerminals Table" on page 37.

10.2.2.33 gtpltransmitters Table


For the table description, see "TplTransmitters Table" on page 48.

10.2.2.34 gtransmitters Table


For the table description, see "Transmitters Table" on page 50.

326 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10.2.2.35 gtrgconfigs Table


For the table description, see "TRGConfigurations Table" on page 53.

10.2.2.36 gtrgs Table


For the table description, see "TRGs Table" on page 54.

10.2.2.37 gtrxequipments Table


For the table description, see "TRXEquipments Table" on page 56.

10.2.2.38 gtrxs Table


For the table description, see "TRXs Table" on page 56.

10.2.2.39 gtrxtypes Table


For the table description, see "TRXTypes Table" on page 57.

10.2.2.40 gtsconfignames Table


For the table description, see "TSConfigurationNames Table" on page 57.

10.2.2.41 gtsconfigs Table


For the table description, see "TSConfigurations Table" on page 57.

10.2.2.42 gtxslists Table


For the table description, see "TxsLists Table" on page 58.

10.2.2.43 gtxslistsnames Table


For the table description, see "TxsListsNames Table" on page 58.

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

© 2022 Forsk. All Rights Reserved. 327


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

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:

10.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:

10.3 UMTS-specific Tables

10.3.1 Data Structure Changes from 3.3 to 3.4

10.3.1.1 Added Tables and Fields


None.

10.3.1.2 Deleted Tables and Fields


None.

10.3.2 Data Structure

10.3.2.1 ucells Table


For the table description, see "CDMACells Table" on page 64.

10.3.2.2 uceuse Table


For the table description, see "CDMAEquipmentsCEsUse Table" on page 67.

328 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10.3.2.3 uequipments Table


For the table description, see "CDMAEquipments Table" on page 67.

10.3.2.4 ufrequencybands Table


For the table description, see "FrequencyBands Table" on page 71.

10.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:

10.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:

10.3.2.7 uhsdpabearers Table


For the table description, see "HSDPABearers Table" on page 71.

10.3.2.8 uhsdpabearerselect Table


For the table description, see "HSDPABearerSelectTables Table" on page 71.

10.3.2.9 uhsdpaqualtables Table


For the table description, see "HSDPAQualityTables Table" on page 72.

© 2022 Forsk. All Rights Reserved. 329


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

10.3.2.10 uhspamimoconfigs Table


For the table description, see "HSPAMIMOConfigs Table" on page 72.

10.3.2.11 uhsupabearers Table


For the table description, see "HSUPABearers Table" on page 73.

10.3.2.12 uhsupabearerselect Table


For the table description, see "HSUPABearerSelection Table" on page 73.

10.3.2.13 uhsupaqualtables Table


For the table description, see "HSUPAQualityTables Table" on page 73.

10.3.2.14 uhsuparessuse Table


For the table description, see "CdmaEqptsHSUPARssUse Table" on page 66.

10.3.2.15 uhsupauecategories Table


For the table description, see "HSUPAUECategories Table" on page 74.

10.3.2.16 uinterfreducfactors Table


For the table description, see "InterfReductionFactors Table" on page 74.

10.3.2.17 ulayers Table


For the table description, see "ulayers Table" on page 90.

10.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:

330 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10.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:

10.3.2.20 umobility Table


For the table description, see "UMTSMobility Table" on page 91.

10.3.2.21 umugtables Table


For the table description, see "MUGTables Table" on page 75.

10.3.2.22 uneighbours Table


For the table description, see "Neighbours Table" on page 75.

10.3.2.23 uneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 76.

10.3.2.24 uneighext Table


For the table description, see "NeighboursExt Table" on page 76.

10.3.2.25 uneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 76.

10.3.2.26 upscdomains Table


For the table description, see "ScramblingCodesDomains Table" on page 81.

10.3.2.27 upscforbidpairs Table


For the table description, see "Separations Table" on page 82.

10.3.2.28 upscgroups Table


For the table description, see "ScramblingCodesGroups Table" on page 81.

© 2022 Forsk. All Rights Reserved. 331


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

10.3.2.29 uqualityindicators Table


For the table description, see "QualityIndicators Table" on page 78.

10.3.2.30 ur99bearers Table


For the table description, see "R99Bearers Table" on page 78.

10.3.2.31 urepeaters Table


For the table description, see "Repeaters Table" on page 80.

10.3.2.32 uschedulers Table


For the table description, see "Schedulers Table" on page 81.

10.3.2.33 usecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 81.

10.3.2.34 uservicequaltables Table


For the table description, see "ServiceQualityTables Table" on page 82.

10.3.2.35 uservices Table


For the table description, see "UMTSServices Table" on page 92. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

10.3.2.36 uservicesquality Table


For the table description, see "UMTSServicesQuality Table" on page 93.

10.3.2.37 uterminals Table


For the table description, see "UMTSTerminals Table" on page 94.

10.3.2.38 uterminalbands Table


For the table description, see "uterminalbands Table" on page 96.

10.3.2.39 utpltransmitters Table


For the table description, see "TplTransmitters Table" on page 84.

332 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10.3.2.40 utransmitters Table


For the table description, see "Transmitters Table" on page 88.

10.3.2.41 utxslists Table


For the table description, see "TxsLists Table" on page 90.

10.3.2.42 utxslistsnames Table


For the table description, see "TxsListsNames Table" on page 90.

10.3.2.43 uuecategories Table


For the table description, see "UECategories Table" on page 90.

10.3.2.44 uuerxequipments Table


For the table description, see "UERxEquipments Table" on page 91.

10.4 LTE-specific Tables

10.4.1 Data Structure Changes from 3.3 to 3.4

10.4.1.1 Added Tables and Fields


None.

10.4.1.2 Deleted Tables and Fields


None.

10.4.2 Data Structure

10.4.2.1 lbearerqualitycurves Table


For the table description, see "T4GBearerQualityCurves Table" on page 149.

10.4.2.2 lbearers Table


For the table description, see "T4GBearers Table" on page 150.

© 2022 Forsk. All Rights Reserved. 333


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

10.4.2.3 lbearersrequiredci Table


For the table description, see "T4GBearersRequiredCI Table" on page 150.

10.4.2.4 lcagroupdefs Table


For the table description, see "lcagroupdefs Table" on page 136.

10.4.2.5 lcagroups Table


For the table description, see "lcagroups Table" on page 136.

10.4.2.6 lcells Table


For the table description, see "T4GCells Table" on page 150.

10.4.2.7 lcchdivgains Table


For the table description, see "lcchdivgains Table" on page 137.

10.4.2.8 lcompsetdefs Table


For the table description, see "lcompsetdefs Table" on page 137.

10.4.2.9 lcompsets Table


For the table description, see "lcompsets Table" on page 137.

10.4.2.10 lequipments Table


For the table description, see "T4GEquipments Table" on page 154.

10.4.2.11 lframeconfigs Table


For the table description, see "lframeconfigs Table" on page 138.

10.4.2.12 lfrequencybands Table


For the table description, see "FrequencyBands Table" on page 135.

10.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:

334 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

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:

10.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:

10.4.2.15 llayers Table


For the table description, see "llayers Table" on page 139.

10.4.2.16 lmbsfnareadefs Table


For the table description, see "lmbsfnareadefs Table" on page 139.

10.4.2.17 lmbsfnareas Table


For the table description, see "lmbsfnareas Table" on page 139.

10.4.2.18 lmimoconfigs Table


For the table description, see "T4GMimoConfigs Table" on page 154.

10.4.2.19 lmugtables Table


For the table description, see "MUGTables Table" on page 142.

10.4.2.20 lneighbours Table


For the table description, see "Neighbours Table" on page 142.

10.4.2.21 lneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 143.

© 2022 Forsk. All Rights Reserved. 335


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

10.4.2.22 lneighext Table


For the table description, see "NeighboursExt Table" on page 143.

10.4.2.23 lneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 143.

10.4.2.24 lpcidomains Table


For the table description, see "lpcidomains Table" on page 139.

10.4.2.25 lpcigroups Table


For the table description, see "lpcigroups Table" on page 140.

10.4.2.26 lprachdomains Table


For the table description, see "lprachdomains Table" on page 140.

10.4.2.27 lprachgroups Table


For the table description, see "lprachgroups Table" on page 140.

10.4.2.28 lqualityindicators Table


For the table description, see "QualityIndicators Table" on page 145.

10.4.2.29 lrelaylinks Table


For the table description, see "lrelayLinks Table" on page 141.

10.4.2.30 lrepetitions Table


For the table description, see "lrepetitions Table" on page 141.

10.4.2.31 lrepeaters Table


For the table description, see "Repeaters Table" on page 146.

10.4.2.32 lschedulers Table


For the table description, see "Schedulers Table" on page 147.

10.4.2.33 lsecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 147.

336 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 10: 3GPP Multi-RAT Data Structure

10.4.2.34 lservices Table


For the table description, see "T4GServices Table" on page 155. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

10.4.2.35 lsmartantennas Table


For the table description, see "SmartAntennas Table" on page 149.

10.4.2.36 lterminalbands Table


For the table description, see "lterminalbands Table" on page 141.

10.4.2.37 lterminals Table


For the table description, see "T4GTerminals Table" on page 157.

10.4.2.38 ltpltransmitters Table


For the table description, see "TplTransmitters Table" on page 159.

10.4.2.39 ltransmitters Table


For the table description, see "Transmitters Table" on page 163.

10.4.2.40 ltxslists Table


For the table description, see "TxsLists Table" on page 164.

10.4.2.41 ltxslistsnames Table


For the table description, see "TxsListsNames Table" on page 165.

10.4.2.42 luecategories Table


For the table description, see "T4GUECategories Table" on page 158.

10.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:

© 2022 Forsk. All Rights Reserved. 337


Atoll 3.5.0 Data Structure Reference Guide
Chapter 10: 3GPP Multi-RAT Data Structure

Field Type Description Attributes

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:

10.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:

338 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

11 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 339
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 345
 "LTE-specific Tables" on page 348
These tables are specific to technologies. There structures are the same as in single-technology documents.

q Primary keys are listed in bold and italic characters.

11.1 Tables Common to 3GPP2 Technologies

11.1.1 Data Structure Changes from Atoll 3.4 to 3.5

11.1.1.1 Added Tables and Fields


None.

11.1.1.2 Deleted Tables and Fields


None.

11.1.2 Data Structure

11.1.2.1 antennas Table


For the table description, see "Antennas Table" on page 131.

© 2022 Forsk. All Rights Reserved. 339


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

11.1.2.2 btsequipments Table


For the table description, see "BTSEquipments Table" on page 132.

11.1.2.3 coordsys Table


For the table description, see "CoordSys Table" on page 132.

11.1.2.4 customfields Table


For the table description, see "CustomFields Table" on page 133.

11.1.2.5 environmentdefs Table


For the table description, see "T4GEnvironmentDefs Table" on page 153.

11.1.2.6 feederequipments Table


For the table description, see "FeederEquipments Table" on page 135.

11.1.2.7 internetchprotect Table


For the table description, see "InterNetChProtect Table" on page 136. 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:

11.1.2.8 mobility Table


Figure 11.1 on page 340, shows the multi-level definition of the multi-RAT mobility types model tables.

Figure 11.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:

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

340 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

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

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_PI- Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
LOT 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:

© 2022 Forsk. All Rights Reserved. 341


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

Field Type Description Attributes

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

11.1.2.10 propagationmodels Table


For the table description, see "PropagationModels Table" on page 145.

11.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:

11.1.2.12 repeaterequipments Table


For the table description, see "RepeaterEquipments Table" on page 146.

11.1.2.13 services Table


Figure 11.2 on page 342, shows the multi-level definition of the multi-RAT services model tables.

Figure 11.2: : 3GPP2 Services Model

342 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

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

11.1.2.14 servicesusage Table


For the table description, see "T4GServicesUsage Table" on page 156.

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

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:

© 2022 Forsk. All Rights Reserved. 343


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

11.1.2.16 siteslists Table


For the table description, see "SitesLists Table" on page 148.

11.1.2.17 siteslistsnames Table


For the table description, see "SitesListsNames Table" on page 148.

11.1.2.18 smartantennasmodels Table


For the table description, see "SmartAntennasModels Table" on page 149.

11.1.2.19 terminals Table


Figure 11.3 on page 344, shows the multi-level definition of the multi-RAT terminals model tables.

Figure 11.3: : 3GPP2 Terminals Model

Field Type Description Attributes

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


Default:

11.1.2.20 tmaequipments Table


For the table description, see "TMAEquipments Table" on page 158.

11.1.2.21 trafficenvs Table


For the table description, see "T4GTraficEnvironments Table" on page 158.

11.1.2.22 units Table


For the table description, see "Units Table" on page 165.

11.1.2.23 userprofiles Table


For the table description, see "T4GUserProfiles Table" on page 158.

344 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

11.2 CDMA2000-specific Tables

11.2.1 Data Structure Changes from 3.3 to 3.4

11.2.1.1 Added Tables and Fields


None.

11.2.1.2 Deleted Tables and Fields


None.

11.2.2 Data Structure

11.2.2.1 ccarrierstype Table


For the table description, see "CarriersType Table" on page 100.

11.2.2.2 ccells Table


For the table description, see "CDMACells Table" on page 101.

11.2.2.3 cceuse Table


For the table description, see "CDMAEquipmentsCEsUse Table" on page 103.

11.2.2.4 cdlbearerselect Table


For the table description, see "DLBearersSelection Table" on page 106.

11.2.2.5 cdldorabearers Table


For the table description, see "DLDORABearers Table" on page 106.

11.2.2.6 cdorabearers Table


For the table description, see "DORABearers Table" on page 106.

11.2.2.7 cdorabearersproba Table


For the table description, see "DORABearersProba Table" on page 106.

© 2022 Forsk. All Rights Reserved. 345


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

11.2.2.8 cdoratermt2pratios Table


For the table description, see "DORATerminalT2PRatios Table" on page 107.

11.2.2.9 cequipments Table


For the table description, see "CDMAEquipments Table" on page 102.

11.2.2.10 cfrequencybands Table


For the table description, see "FrequencyBands Table" on page 107.

11.2.2.11 cinterfreducfactors Table


For the table description, see "InterfReductionFactors Table" on page 108.

11.2.2.12 clneighbours 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:

11.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:

11.2.2.14 cmobility Table


For the table description, see "UMTSMobility Table" on page 122.

346 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

11.2.2.15 cneighbours Table


For the table description, see "Neighbours Table" on page 108.

11.2.2.16 cneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 109.

11.2.2.17 cneighext Table


For the table description, see "NeighboursExt Table" on page 109.

11.2.2.18 cneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 109.

11.2.2.19 cpnodomains Table


For the table description, see "PnCodesDomains Table" on page 111.

11.2.2.20 cpnoforbidpairs Table


For the table description, see "Separations Table" on page 114.

11.2.2.21 cpnogroups Table


For the table description, see "PnCodesGroups Table" on page 111.

11.2.2.22 cqualityindicators Table


For the table description, see "QualityIndicators Table" on page 112.

11.2.2.23 crepeaters Table


For the table description, see "Repeaters Table" on page 113.

11.2.2.24 csecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 114.

11.2.2.25 cservicequaltables Table


For the table description, see "ServiceQualityTables Table" on page 114.

11.2.2.26 cservices Table


For the table description, see "UMTSServices Table" on page 122.

© 2022 Forsk. All Rights Reserved. 347


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

11.2.2.27 cservicesquality Table


For the table description, see "UMTSServicesQuality Table" on page 124.

11.2.2.28 cterminals Table


For the table description, see "UMTSTerminals Table" on page 125.

11.2.2.29 ctpltransmitters Table


For the table description, see "TplTransmitters Table" on page 116.

11.2.2.30 ctransmitters Table


For the table description, see "Transmitters Table" on page 119.

11.2.2.31 ctxslists Table


For the table description, see "TxsLists Table" on page 121.

11.2.2.32 ctxslistsnames Table


For the table description, see "TxsListsNames Table" on page 121.

11.2.2.33 cuerxequipments Table


For the table description, see "UERxEquipments Table" on page 121.

11.2.2.34 culbearerselect Table


For the table description, see "ULBearersSelection Table" on page 121.

11.3 LTE-specific Tables

11.3.1 Data Structure Changes from 3.3 to 3.4

11.3.1.1 Added Tables and Fields


None.

11.3.1.2 Deleted Tables and Fields


None.

348 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

11.3.2 Data Structure

11.3.2.1 lbearerqualitycurves Table


For the table description, see "T4GBearerQualityCurves Table" on page 149.

11.3.2.2 lbearers Table


For the table description, see "T4GBearers Table" on page 150.

11.3.2.3 lbearersrequiredci Table


For the table description, see "T4GBearersRequiredCI Table" on page 150.

11.3.2.4 lcagroupdefs Table


For the table description, see "lcagroupdefs Table" on page 136.

11.3.2.5 lcagroups Table


For the table description, see "lcagroups Table" on page 136.

11.3.2.6 lcells Table


For the table description, see "T4GCells Table" on page 150.

11.3.2.7 lcchdivgains Table


For the table description, see "lcchdivgains Table" on page 137.

11.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:

© 2022 Forsk. All Rights Reserved. 349


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

11.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:

11.3.2.10 lcompsetdefs Table


For the table description, see "lcompsetdefs Table" on page 137.

11.3.2.11 lcompsets Table


For the table description, see "lcompsets Table" on page 137.

11.3.2.12 lequipments Table


For the table description, see "T4GEquipments Table" on page 154.

11.3.2.13 lframeconfigs Table


For the table description, see "lframeconfigs Table" on page 138.

11.3.2.14 lfrequencybands Table


For the table description, see "FrequencyBands Table" on page 135.

11.3.2.15 llayers Table


For the table description, see "llayers Table" on page 139.

11.3.2.16 lmbsfnareadefs Table


For the table description, see "lmbsfnareadefs Table" on page 139.

11.3.2.17 lmbsfnareas Table


For the table description, see "lmbsfnareas Table" on page 139.

11.3.2.18 lmimoconfigs Table


For the table description, see "T4GMimoConfigs Table" on page 154.

350 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

11.3.2.19 lmugtables Table


For the table description, see "MUGTables Table" on page 142.

11.3.2.20 lneighbours Table


For the table description, see "Neighbours Table" on page 142.

11.3.2.21 lneighconstraints Table


For the table description, see "NeighboursConstraints Table" on page 143.

11.3.2.22 lneighext Table


For the table description, see "NeighboursExt Table" on page 143.

11.3.2.23 lneighextconstraints Table


For the table description, see "NeighboursConstraintsExt Table" on page 143.

11.3.2.24 lpcidomains Table


For the table description, see "lpcidomains Table" on page 139.

11.3.2.25 lpcigroups Table


For the table description, see "lpcigroups Table" on page 140.

11.3.2.26 lprachdomains Table


For the table description, see "lprachdomains Table" on page 140.

11.3.2.27 lprachgroups Table


For the table description, see "lprachgroups Table" on page 140.

11.3.2.28 lqualityindicators Table


For the table description, see "QualityIndicators Table" on page 145.

11.3.2.29 lrelaylinks Table


For the table description, see "lrelayLinks Table" on page 141.

11.3.2.30 lrepetitions Table


For the table description, see "lrepetitions Table" on page 141.

© 2022 Forsk. All Rights Reserved. 351


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

11.3.2.31 lrepeaters Table


For the table description, see "Repeaters Table" on page 146.

11.3.2.32 lschedulers Table


For the table description, see "Schedulers Table" on page 147.

11.3.2.33 lsecondaryantennas Table


For the table description, see "SecondaryAntennas Table" on page 147.

11.3.2.34 lservices Table


For the table description, see "T4GServices Table" on page 155. The table does not contain the following fields:
 DL_ACTIVITY
 REQ_AVERAGE_DL_RATE
 REQ_AVERAGE_UL_RATE
 UL_ACTIVITY

11.3.2.35 lsmartantennas Table


For the table description, see "SmartAntennas Table" on page 149.

11.3.2.36 lterminalbands Table


For the table description, see "lterminalbands Table" on page 141.

11.3.2.37 lterminals Table


For the table description, see "T4GTerminals Table" on page 157.

11.3.2.38 ltpltransmitters Table


For the table description, see "TplTransmitters Table" on page 159.

11.3.2.39 ltransmitters Table


For the table description, see "Transmitters Table" on page 163.

11.3.2.40 ltxslists Table


For the table description, see "TxsLists Table" on page 164.

11.3.2.41 ltxslistsnames Table


For the table description, see "TxsListsNames Table" on page 165.

352 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 11: 3GPP2 Multi-RAT Data Structure

11.3.2.42 luecategories Table


For the table description, see "T4GUECategories Table" on page 158.

© 2022 Forsk. All Rights Reserved. 353


Atoll 3.5.0 Data Structure Reference Guide
Chapter 11: 3GPP2 Multi-RAT Data Structure

354 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

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

q Primary keys are listed in bold and italic characters.

12.1 Data Structure Changes from Atoll 3.4 to 3.5

12.1.1 Added Tables and Fields

None.

12.1.2 Deleted Tables and Fields

None.

12.2 Data Structure

12.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:

© 2022 Forsk. All Rights Reserved. 355


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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:

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

12.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:

12.2.3 AntennasListsNames Table

For names of antenna lists.

Field Type Description Attributes

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


Default:

12.2.4 BTSEquipments Table

For NodeB equipment.

356 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA 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

12.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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0
DWPCH_POWER Float Power on the DwPTS timeslot. Nullable: Yes
Default: 36

DYN_EDCH_DL_POWER_AL- Boolean E-DCH power allocation mode. True=Dynamic; False=Static. Nullable: No


LOC Default: False

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


LOC Default: True
DYN_HS_SICH_POWER_AL- Boolean HS-SICH power allocation mode. True=Dynamic; False=Static. Nullable: No
LOC 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

© 2022 Forsk. All Rights Reserved. 357


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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
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:

358 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0

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

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:

© 2022 Forsk. All Rights Reserved. 359


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

12.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:

12.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:

12.2.9 CodesRelativityClusters Table

For scrambling code clusters.

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:

12.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).

360 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA 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, Lam- Nullable: Yes
bert2SP, 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

© 2022 Forsk. All Rights Reserved. 361


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

12.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.5.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

362 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA 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.

12.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:

12.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:

© 2022 Forsk. All Rights Reserved. 363


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

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

12.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”

12.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:

364 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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

12.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:

12.2.18 HSUPAUECategories

For HSUPA UE categories.

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:

12.2.19 InterfReductionFactors Table

For interference reduction factors between carriers.

© 2022 Forsk. All Rights Reserved. 365


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

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

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

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

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:

12.2.22 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

366 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: 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:
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:

12.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:

12.2.24 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:

12.2.25 Networks Table

For network-level parameters.

© 2022 Forsk. All Rights Reserved. 367


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

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_PI- Boolean Whether the transmission powers of other channels are defined as absolute Nullable: No
LOT values or as offsets to the pilot power. True=Relative; False=Absolute. Default:

PTS_GUARD_PERIOD_- Integer Number of chips in the PTS guard period. Nullable: Yes
CHIPS_NUMBER Default: 96
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_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

368 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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

12.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:

12.2.27 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

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

© 2022 Forsk. All Rights Reserved. 369


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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

12.2.29 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:

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

370 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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

12.2.31 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:

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

© 2022 Forsk. All Rights Reserved. 371


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

12.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:

12.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:

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

12.2.35 SecondaryAntennas Table

For additional antennas.

372 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA 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. 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:

12.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:

12.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:

12.2.38 ServiceRUsUse Table

For resource unit consumptions per service.

© 2022 Forsk. All Rights Reserved. 373


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

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

12.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:

12.2.40 SitesLists Table

For sites belonging to site lists.

374 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA 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:

12.2.41 SitesListsNames Table

For names of site lists.

Field Type Description Attributes


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

12.2.42 SmartAntennas Table

For smart antenna equipment.

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:

12.2.43 SmartAntennasModels Table

For smart antenna models.

© 2022 Forsk. All Rights Reserved. 375


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

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:

12.2.44 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

12.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:

376 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default:
DWPCH_POWER Float Power on the DwPTS timeslot. Nullable: Yes
Default:

DYN_EDCH_DL_POWER_AL- Boolean E-DCH power allocation mode. True=Dynamic; False=Static. Nullable: No


LOC Default:

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


LOC Default:
DYN_HS_SICH_POWER_AL- Boolean HS-SICH power allocation mode. True=Dynamic; False=Static. Nullable: No
LOC 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:

© 2022 Forsk. All Rights Reserved. 377


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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:
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:

378 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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:
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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default:

12.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:

© 2022 Forsk. All Rights Reserved. 379


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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

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’

380 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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

12.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:

12.2.48 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes

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


Default:

© 2022 Forsk. All Rights Reserved. 381


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

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

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:

12.2.50 UERxEquipments Table

For UE reception equipment.

Field Type Description Attributes

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


Default:

12.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:

12.2.52 UMTSMobility Table

For mobility types.

382 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

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

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

© 2022 Forsk. All Rights Reserved. 383


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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

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

12.2.54 UMTSServicesQuality Table

For release 99 service access thresholds.

384 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

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:
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

12.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:

12.2.56 UMTSTerminals Table

For terminal types.

© 2022 Forsk. All Rights Reserved. 385


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

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

12.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:

12.2.58 UMTSUserProfiles Table

For names of user profiles.

386 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Field Type Description Attributes

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


Default:

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

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

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

© 2022 Forsk. All Rights Reserved. 387


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

Many-to-One Relationships ( ∞ 1)

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

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

388 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 12: TD-SCDMA Data Structure

Many-to-One Relationships ( ∞ 1)

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

© 2022 Forsk. All Rights Reserved. 389


Atoll 3.5.0 Data Structure Reference Guide
Chapter 12: TD-SCDMA Data Structure

390 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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

q Primary keys are listed in bold and italic characters.

13.1 Data Structure Changes from Atoll 3.4 to 3.5

13.1.1 Added Tables and Fields

None.

13.1.2 Deleted Tables and Fields

None.

13.2 Data Structure

13.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:

© 2022 Forsk. All Rights Reserved. 391


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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:

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

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

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

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

392 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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

© 2022 Forsk. All Rights Reserved. 393


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

13.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.5.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

394 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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.

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

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:

13.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:

© 2022 Forsk. All Rights Reserved. 395


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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.

13.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:

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:

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

396 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

13.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:

13.2.10 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 (100) Name of the source cell. Nullable: No


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

13.2.11 NeighboursConstraints Table

For intra-technology neighbour allocation constraints.

© 2022 Forsk. All Rights Reserved. 397


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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:

13.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:

13.2.13 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:

13.2.14 Networks Table

For network-level parameters.

398 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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

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

© 2022 Forsk. All Rights Reserved. 399


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

13.2.15 PermutationZones Table

For permutation zones.

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

400 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

13.2.16 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:

13.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:

© 2022 Forsk. All Rights Reserved. 401


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

13.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:

13.2.19 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

402 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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

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:

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

13.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:

© 2022 Forsk. All Rights Reserved. 403


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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_- Short Target throughput when scheduling data services. 0=Peak MAC Throughput; Nullable: Yes
DATA 1=Effective MAC Throughput; 2=Application Throughput. Default: 0
TARGET_THROUGH- Short Target throughput when scheduling voice services. 0=Peak MAC Through- Nullable: Yes
PUT_VOICE 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

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

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:

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

404 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

13.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:

13.2.25 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

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


Default:

13.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:

13.2.27 SmartAntennasModels Table

For smart antenna models.

© 2022 Forsk. All Rights Reserved. 405


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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:

13.2.28 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

13.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:

406 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_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:

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:

© 2022 Forsk. All Rights Reserved. 407


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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:
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:

408 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

UPLINK_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default:

WEQUIPMENT Text (50) Name of the reception equipment associated with the cell. Nullable: Yes
Default:

13.2.30 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
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:

© 2022 Forsk. All Rights Reserved. 409


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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

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

13.2.31 TxsLists Table

For transmitters belonging to transmitter lists.

410 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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:

13.2.32 TxsListsNames Table

For names of transmitter lists.

Field Type Description Attributes


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

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

13.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:

© 2022 Forsk. All Rights Reserved. 411


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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

13.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:

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

13.2.38 WCells Table

For cells.

412 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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
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_EXTER- Float Inter-RAT downlink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_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

© 2022 Forsk. All Rights Reserved. 413


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

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_EXTER- Float Inter-RAT uplink noise rise. Unit: dB. Nullable: Yes
NAL_NOISE_RISE Default: 0

WEQUIPMENT Text (50) Name of the reception equipment associated with the cell. Nullable: Yes
Default:

13.2.39 WEnvironmentDefs Table

For traffic environment types.

414 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

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:

13.2.40 WEquipments Table

For reception equipment.

Field Type Description Attributes

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


Default:

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

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

© 2022 Forsk. All Rights Reserved. 415


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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:

13.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:

13.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:

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

416 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

13.2.46 WServices Table

For services.

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_BLOCK- Integer Maximum probability of blocking (or delay). Nullable: Yes


ING_PROBA 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:

© 2022 Forsk. All Rights Reserved. 417


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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

13.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:

418 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Field Type Description Attributes

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:

13.2.48 WTerminals Table

For terminal types.

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”

13.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:

© 2022 Forsk. All Rights Reserved. 419


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

13.2.50 WUserProfiles Table

For names of user profiles.

Field Type Description Attributes

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


Default:

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

420 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

Many-to-One Relationships ( ∞ 1)

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

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

© 2022 Forsk. All Rights Reserved. 421


Atoll 3.5.0 Data Structure Reference Guide
Chapter 13: WiMAX, Wi-Fi, and LPWA Data Structures

422 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

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

q Primary keys are listed in bold and italic characters.

14.1 Data Structure Changes from Atoll 3.4 to 3.5

14.1.1 Added Tables and Fields

MWBranchingConfigs Table

Field Type Description Attributes

INDEPENDANT_MIMO_FLOW Boolean Whether the MIMO transmissions are independent or not. 0=False; 1=True. Nullable: No
Default: True
SHARED_MIMO_POWER Boolean MIMO power to be shared between all transmitter antennas or not. 0=False; Nullable: No
1=True. Default: False

MWGuides Table

Field Type Description Attributes


INSERTION_LOSSES Float Insertion losses. Unit: dB. Nullable: Yes
Default: 0

14.1.2 Deleted Tables and Fields

None.

© 2022 Forsk. All Rights Reserved. 423


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

14.2 Data Structure

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

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

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

424 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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:

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

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

© 2022 Forsk. All Rights Reserved. 425


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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, Lam- Nullable: Yes
bert2SP, 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

14.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:
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.

426 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

 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.5.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.

14.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 vertical pattern. Nullable: Yes


Default:

© 2022 Forsk. All Rights Reserved. 427


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

q
The format of the binary field, PATTERN, is described in "Microwave 2D Antenna
Pattern Format" on page 461.

14.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:

14.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:

428 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

INDEPENDANT_MIMO_FLOW Boolean Whether the MIMO transmissions are independent or not. 0=False; 1=True. Nullable: No
Default: True

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
SHARED_MIMO_POWER Boolean MIMO power to be shared between all transmitter antennas or not. 0=False; Nullable: No
1=True. Default: False

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

14.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:

14.2.10 MWCompatibilities Table

For compatibility mapping between equipment and antennas.

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:

© 2022 Forsk. All Rights Reserved. 429


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

14.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:

14.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:

14.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:

430 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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:

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

14.2.15 MWEPOLinkClass Table

For EPO link classes.

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:

© 2022 Forsk. All Rights Reserved. 431


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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:

14.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:

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:

432 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

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:

© 2022 Forsk. All Rights Reserved. 433


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

14.2.17 MWFamil ies Table

For microwave radio families.

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

434 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

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

14.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:

14.2.20 MWFrontages Table

For types of facades.

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:

14.2.21 MWGuides Table

For microwave wave guides.

© 2022 Forsk. All Rights Reserved. 435


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

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
INSERTION_LOSSES Float Insertion losses. Unit: dB. 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:

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

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:

436 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

14.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:

q 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

14.2.24 MWLinks Table

For microwave links.

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:

© 2022 Forsk. All Rights Reserved. 437


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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:

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

438 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

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:

© 2022 Forsk. All Rights Reserved. 439


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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:

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

440 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

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:

© 2022 Forsk. All Rights Reserved. 441


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

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

14.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:

14.2.27 MWMediumTypes Table

For medium types.

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

14.2.28 MWModulations Table

For modulations.

442 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

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

14.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:

14.2.30 MWMultiHopsLinks Table

For microwave links belonging to multihops.

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

14.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:

© 2022 Forsk. All Rights Reserved. 443


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

OPERATION_FLAG Short XOR of supported mode (00 = fix, 01 = with ACM) Nullable: Yes
Default: 0

SHORT_NAME Text (30) String describing the mode: used for distinguishing active modulations in a Nullable: No
link Default: “Mode”

14.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:

14.2.33 MWPMP Table

For microwave links and hubs belonging to a point-to-multipoint group.

Field Type Description Attributes

HUB Text (80) Name of the hub Nullable: No


Default:
LINK Text (140) Name of the link Nullable: No
Default:

14.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:

444 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

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

© 2022 Forsk. All Rights Reserved. 445


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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.

14.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:

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:

446 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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

14.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:
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

14.2.38 MWTplLinks Table

For microwave link templates.

© 2022 Forsk. All Rights Reserved. 447


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

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:
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

448 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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.

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:

© 2022 Forsk. All Rights Reserved. 449


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Field Type Description Attributes

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
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:

14.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’

450 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

14.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:

14.2.41 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 (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:

14.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:

© 2022 Forsk. All Rights Reserved. 451


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

14.2.43 SitesListsNames Table

For names of site lists.

Field Type Description Attributes

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


Default:

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

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

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

452 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Many-to-One Relationships ( ∞ 1)

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

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

© 2022 Forsk. All Rights Reserved. 453


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

Many-to-One Relationships ( ∞ 1)

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

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

454 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 14: Microwave Links Data Structure

Many-to-One Relationships ( ∞ 1)

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

© 2022 Forsk. All Rights Reserved. 455


Atoll 3.5.0 Data Structure Reference Guide
Chapter 14: Microwave Links Data Structure

456 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 15: Radio Data Formats

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

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

q Compatibility of XML files between versions of Atoll is not guaranteed.


In particular, Atoll 3.4.1 introduced an improved encapsulation method for
databases that is causes XML incompatibility with previous versions.

The following sections describe the structures of the XML files created at export.

© 2022 Forsk. All Rights Reserved. 457


Atoll 3.5.0 Data Structure Reference Guide
Chapter 15: Radio Data Formats

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

No closing tag </XML_Table> is required.

15.1.2 XML File Format

Atoll creates an XML file per exported data table with the following structure:
 The first line is a standard XML declaration: <?xml version="1.0" encoding="UTF-8"?>
 The XML root tag is <recordset>, which contains two sections, one for storing the description of the table
structure, and the second for the data itself:
 The description of the table structure follows the root tag and is enclosed between <fields> and
</fields>.
Between these tags, each table field description is handled by a <field ... /> tag whose attributes are
set to the field parameter values. No closing </field> tag is required.
 After the data structure description, the data are enclosed between <records> and </records>.
Between these tags, each record is handled by a <record ... /> tag whose attributes are set to the
record field values.
The following example shows a Sites.xml file containing a Sites table with one site:

458 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 15: Radio Data Formats

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

<recordset>

<fields>
<field name="NAME" type="202" length="60" nullable="1"/>
<field name="LONGITUDE" type="5" length="8" nullable="0"/>
<field name="LATITUDE" type="5" length="8" nullable="0"/>
<field name="ALTITUDE" type="4" length="4" nullable="1"/>
<field name="COMMENT_" type="202" length="255" nullable="1"/>
<field name="PYLON_HEIGHT" type="4" length="4" nullable="1"/>
<field name="SUPPORT_INFO" type="202" length="50" nullable="1"/>
<field name="ALIAS_" type="202" length="60" nullable="1"/>
<field name="CHANNEL_ELEMENTS_UL" type="3" length="4" nullable="1"/>
<field name="CHANNEL_ELEMENTS_DL" type="3" length="4" nullable="1"/>
<field name="MAX_IUB_RATE_UL" type="4" length="4" nullable="1"/>
<field name="MAX_IUB_RATE_DL" type="4" length="4" nullable="1"/>
<field name="CDMA_EQUIPMENT" type="202" length="50" nullable="1"/>
<field name="EVDO_CES" type="3" length="4" nullable="1"/>
<field name="BH_CAPACITY_DL" type="4" length="4" nullable="1"/>
<field name="BH_CAPACITY_UL" type="4" length="4" nullable="1"/>
</fields>

<records>
<record NAME="Site0" LONGITUDE="21332.029999999998836" LATITUDE="-
15841.930000000000291" PYLON_HEIGHT="50" CHANNEL_ELEMENTS_UL="256"
CHANNEL_ELEMENTS_DL="256" MAX_IUB_RATE_UL="12288" MAX_IUB_RATE_DL="12288"
EVDO_CES="96" BH_CAPACITY_DL="950000" BH_CAPACITY_UL="950000"/>
</records>

</recordset>

15.2 RF 2D Antenna Pattern Format


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

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

© 2022 Forsk. All Rights Reserved. 459


Atoll 3.5.0 Data Structure Reference Guide
Chapter 15: Radio Data Formats

 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
15.2 on page 460.

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 15.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.
 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....

460 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 15: Radio Data Formats

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.

15.3 Import Format of 3D Antenna Pattern Text Files


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

15.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 461.
The format of 2D antenna patterns can be understood from Figure 15.3 on page 462.

© 2022 Forsk. All Rights Reserved. 461


Atoll 3.5.0 Data Structure Reference Guide
Chapter 15: Radio Data Formats

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 15.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).
 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.

462 © 2022 Forsk. All Rights Reserved.


Atoll 3.5.0 Data Structure Reference Guide
AT350_DSR_E0 Chapter 15: Radio Data Formats

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

© 2022 Forsk. All Rights Reserved. 463


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

AT350_DSR_E0 www.forsk.com March 2022

You might also like