Atoll 3.2.0 Administrator Manual

Version3.2.
0
AdministratorManual
AT320_AM_E2
www.forsk.com
Experts in radio planning and optimization software
Forskisanindependentcompanyprovidingradioplanningandoptimisationsoftwaresolutionstothewirelessindustry
since1987.
In1997,ForskreleasedthefirstversionofAtoll,itsflagshipradioplanningsoftware.Sincethen,Atollhasevolvedto
become a comprehensive radio planning and optimisation platform and, with more than 5000 installed licenses
worldwide,hasreachedtheleadingpositionontheglobalmarket.
AtollcombinesengineeringandautomationfunctionsthatenableoperatorstosmoothlyandgraduallyimplementSON
processeswithintheirorganisation.
Today,Forskisaglobalsupplierwithover300customersin100countriesandstrategicpartnershipswithmajorplayersintheindustry.
ForskdistributesandsupportsAtolldirectlyfromofficesandtechnicalsupportcentresinFrance,USA,andChinaaswellasthroughaworldwidenetworkof
distributorsandpartners.
Forsk at your side
SincethefirstreleaseofAtoll,Forskhasbeenknownforitscapabilitytodelivertailoredandturnkeyradioplanningandoptimisationenvironmentsbasedon
Atoll.
To help operators streamline their radio planning and optimisation processes, Forsk provides a complete range of implementation services, including
integrationwithexistingITinfrastructure,automation,aswellasdatamigration,installation,andtrainingservices.
HeadOffice
7ruedesBriquetiers
31700Blagnac,France
Email:sales@forsk.com
Tel:+33562747210
Fax:+33562747211
USOffice
200SouthWackerDriveSuite3100
Chicago,IL60606,USA
Email:sales_us@forsk.com
Tel:+13126744800
Fax:+13126744847
ChinaOffice
Suite302,3/F,WestTower,JiaduCommercialBuilding,
No.66JianzhongRoad,TianheHiTechIndustrialZone,
Guangzhou,510665,P.R.ofChina
Email:enquiries@forsk.com.cn
Tel:+862085538938 Fax:+862085538285
4
Atoll 3.2.0 Administrator Manual Forsk 2013
Atoll3.2.0AdministratorManual
Release:AT320_AM_E2
19972013Forsk.AllRightsReserved.
Publishedby:
Forsk
7ruedesBriquetiers
31700Blagnac,France
Tel:+33562747210
Fax:+33562747211
Thesoftwaredescribedinthisdocumentisprovidedunderalicenceagreement.Thesoftwaremayonlybeusedorcopiedunderthetermsandconditionsofthe
licenceagreement.Nopartofthecontentsofthisdocumentmaybereproducedortransmittedinanyformorbyanymeanswithoutwrittenpermissionfromthe
publisher.
Theproductorbrandnamesmentionedinthisdocumentaretrademarksorregisteredtrademarksoftheirrespectiveregisteringparties.
Thepublisherhastakencareinthepreparationofthisdocument,butmakesnoexpressedorimpliedwarrantyofanykindandassumesnoresponsibilityforerrors
oromissions.Noliabilityisassumedforincidentalorconsequentialdamagesinconnectionwithorarisingoutoftheuseoftheinformationcontainedherein.
AT320_AM_E2 TableofContents
5
TableofContents
1 GettingStarted.....................................................25
1.1 SupportedTechnologies ................................................................................. 25
1.2 SupportedOperatingSystems............................................................................ 25
1.3 SupportedDatabaseManagementSystems ................................................................. 26
1.4 SupportedInstallationConfigurations...................................................................... 26
1.5 RecommendedHardwareandSoftware .................................................................... 26
1.5.1 UserWorkstations.................................................................................... 26
1.5.2 DatabaseServers..................................................................................... 27
1.5.3 ApplicationServers ................................................................................... 27
1.5.4 FloatingLicenceServers ............................................................................... 27
1.5.5 FileServers.......................................................................................... 27
1.6 RecommendedComputerNetworkArchitecture............................................................. 28
2 InstallingAtollandComponents ......................................29
2.1 InstallingAtollUsingtheSetupWizard..................................................................... 29
2.2 InstallingAtollC++DevelopmentKit ....................................................................... 32
2.3 SetupCommandLineParameters......................................................................... 33
2.4 InstallingandUninstallingAddins......................................................................... 34
2.5 InstallingandUninstallingMacros ......................................................................... 35
2.6 AtollCommandLineParameters.......................................................................... 36
2.7 TroubleshootingandOtherInformation.................................................................... 36
3 SettingUpDistributedCalculationServer ...............................39
3.1 SettingUpServers ...................................................................................... 39
3.2 SettingUpAtolltoAccesstheServers...................................................................... 40
3.3 DistributedCalculationProcess........................................................................... 40
4 ManagingLicences..................................................43
4.1 WorkingwithFloatingLicences........................................................................... 43
4.1.1 HASPLicenceManagerandDeviceDriver ................................................................. 43
4.1.2 nhsrv.iniFile......................................................................................... 44
4.1.3 nethasp.iniFile ....................................................................................... 45
4.2 UsingtheAtollLicenceManager.......................................................................... 45
4.2.1 LicenceManagerInterface............................................................................. 46
4.2.2 UpdatingLicenceKeys ................................................................................. 47
5 ManagingDatabases ................................................49
5.1 AtollDatabaseTemplates................................................................................ 49
5.2 CustomisingAtollDatabaseStructures..................................................................... 50
5.3 AtollManagementConsole .............................................................................. 52
5.4 CreatingNewDatabases................................................................................. 53
5.4.1 CreatingaNewDatabaseUsingtheAtollManagementConsole .............................................. 53
5.4.2 CreatingaNewDatabaseUsingAtoll(AllSupportedRDBMs) ................................................. 55
5.5 UpgradingExistingDatabases ............................................................................ 55
5.6 WorkingWithaMultilevelDatabases ..................................................................... 59
5.6.1 CreatingProjectDatabases ............................................................................. 60
5.6.2 ArchivingProjectDatabasestoMasterDatabases.......................................................... 62
5.6.3 RefreshingProjectDatabasesfromMasterDatabases....................................................... 63
5.7 SettingDatabaseAccessPrivileges ........................................................................ 63
5.8 ManagingDataModificationsHistory ...................................................................... 64
5.8.1 SettingUpDataModificationsHistoryManagement ........................................................ 64
5.8.2 Enabling/DisablingDataModificationsHistoryManagement ................................................. 65
5.8.3 UpdatingAfterDataStructureUpgrade................................................................... 65
5.8.4 PurgingOldDataModificationRecords ................................................................... 66
5.8.4.1 PurgingOldDataModificationRecordsofaTable ........................................................ 66
5.8.4.2 PurgingOldDataModificationRecordsofaDatabase..................................................... 67
6
TableofContents Forsk2013
5.9 Appendices ............................................................................................68
5.9.1 Appendix1:AdvancedCustomisation ....................................................................68
5.9.2 Appendix2:SettingUpDatabasesforCoplanning..........................................................70
6 MultiuserEnvironments............................................ 73
6.1 SettingUpMultiuserEnvironments .......................................................................73
6.2 ComponentsofMultiuserEnvironments...................................................................73
6.2.1 MasterAtollDocument ................................................................................74
6.2.2 MasterDatabase......................................................................................74
6.2.3 SharedGeographicData ...............................................................................74
6.2.4 SharedPathLossMatrices ..............................................................................75
6.2.5 UserAtollDocuments..................................................................................75
6.3 ManagingUserAccountsandAccessRightsinOracle.........................................................75
6.3.1 DefiningDatabaseandInterfaceAccessRights .............................................................76
6.3.2 CreatingandEditingUserAccounts ......................................................................78
6.3.3 ResettingUserDatabasePermissions.....................................................................78
6.4 Appendices ............................................................................................79
6.4.1 Appendix1:CheckingDataIntegrity......................................................................79
6.4.2 Appendix2:DatabaseRegionalisation....................................................................80
6.4.3 Appendix3:CalculatingPathLossMatrices ................................................................80
6.4.4 Appendix4:PathLossMatricesFromDifferentSources .....................................................81
7 CoordinateSystemsandUnits....................................... 85
7.1 CoordinateSystems .....................................................................................85
7.1.1 DefinitionofaCoordinateSystem .......................................................................85
7.1.2 TypesofCoordinateSystemsinAtoll.....................................................................86
7.1.3 CoordinateSystemsFileFormat.........................................................................87
7.1.4 CreatingaCoordinateSysteminAtoll ....................................................................90
7.2 Units .................................................................................................91
7.3 BSICFormat ...........................................................................................92
8 GeographicData .................................................. 93
8.1 DigitalTerrainModel(DTM) ..............................................................................93
8.2 ClutterClasses .........................................................................................94
8.3 ClutterHeights.........................................................................................95
8.4 TrafficData ............................................................................................95
8.5 VectorData............................................................................................96
8.6 PopulationData........................................................................................96
8.7 Images................................................................................................96
8.8 WebMapServices(WMS)Data...........................................................................97
8.9 CustomData...........................................................................................97
8.10 GeographicDataFileFormats.............................................................................97
8.10.1 BILFormat ...........................................................................................97
8.10.1.1 HDRHeaderFile.....................................................................................97
8.10.2 TIFFFormat..........................................................................................99
8.10.2.1 TFWHeaderFile ....................................................................................99
8.10.3 BMPFormat .........................................................................................99
8.10.3.1 BMPFileStructure................................................................................. 100
8.10.3.2 BMPRasterDataEncoding .......................................................................... 101
8.10.3.3 RasterDataCompression........................................................................... 102
8.10.3.4 BPW/BMWHeaderFile............................................................................. 102
8.10.4 PNGFormat........................................................................................ 102
8.10.4.1 PGWHeaderFile.................................................................................. 103
8.10.5 JPEGFormat ....................................................................................... 103
8.10.5.1 JGWHeaderFile .................................................................................. 103
8.10.6 DXFFormat........................................................................................ 103
8.10.7 SHPFormat........................................................................................ 103
8.10.8 MIFFormat ........................................................................................ 104
8.10.9 TABFormat........................................................................................ 104
8.10.10 ECWFormat ....................................................................................... 105
8.10.11 ErdasImagineFormat................................................................................ 105
8.10.12 PlanetEV/VerticalMapperGeographicDataFormat...................................................... 105
8.10.13 ArcViewGridFormat ................................................................................ 105
8.10.14 OtherFileFormats .................................................................................. 106
8.10.15 GenericRasterHeaderFile ........................................................................... 106
7
8.10.16 PlanetFormats ...................................................................................... 107
8.10.16.1 DTMFiles ......................................................................................... 107
8.10.16.2 ClutterClassFiles .................................................................................. 107
8.10.16.3 VectorFiles ....................................................................................... 108
8.10.16.4 ImageFiles........................................................................................ 109
8.10.16.5 TextDataFiles ..................................................................................... 109
8.10.16.6 MNUFormat...................................................................................... 109
9 RadioDataFormats ................................................111
9.1 XMLImport/ExportFormat ............................................................................. 111
9.1.1 Index.xmlFileFormat ................................................................................ 111
9.1.2 XMLFileFormat..................................................................................... 112
9.2 RF2DAntennaPatternFormat .......................................................................... 113
9.3 ImportFormatof3DAntennaPatternTextFiles............................................................ 115
9.4 Microwave2DAntennaPatternFormat ................................................................... 115
9.5 MicrowaveNSMAAntennaFileFormats................................................................... 116
9.5.1 WG16.89.003Format................................................................................ 116
9.5.2 WG16.99.050Format................................................................................ 118
9.6 MicrowaveNSMARadioFileFormats..................................................................... 122
9.6.1 WG21.99.051Format................................................................................ 122
9.7 PathLossMatrixFileFormat ............................................................................ 125
9.7.1 Pathloss.dbfFileFormat .............................................................................. 125
9.7.2 Pathloss.dbfFileContents ............................................................................. 127
9.7.3 LOSFileFormat...................................................................................... 128
9.8 PathLossTuningFileFormat............................................................................ 129
9.8.1 Pathloss.dbfFileFormat .............................................................................. 129
9.8.2 Pathloss.dbfFileContents ............................................................................. 129
9.8.3 PTSFileFormat...................................................................................... 129
9.9 InterferenceMatrixFileFormats ......................................................................... 129
9.9.1 CLCFormat(OneValueperLine) ....................................................................... 130
9.9.1.1 CLCFileFormat .................................................................................... 130
9.9.1.2 DCTFileFormat.................................................................................... 131
9.9.2 IM0Format(OneHistogramperLine) ................................................................... 132
9.9.3 IM1Format(OneValueperLine,TXNameRepeated)...................................................... 133
9.9.4 IM2Format(CoandAdjacentchannelProbabilities)...................................................... 134
10 AdministrationandUsageRecommendations..........................137
10.1 GeographicData...................................................................................... 137
10.2 PathLossMatrices..................................................................................... 138
10.3 Databases............................................................................................ 139
10.4 CalculationServer..................................................................................... 139
10.5 AtollAdministrationFiles............................................................................... 140
10.6 ProcessMemory...................................................................................... 141
10.7 Printing .............................................................................................. 141
10.8 CoveragePredictionCalculations......................................................................... 141
10.9 CWMeasurementsandDriveTestData................................................................... 142
10.10 AntennaPatternsandImport............................................................................ 142
10.11 TrafficMaps .......................................................................................... 142
10.12 AtollAPI ............................................................................................. 142
10.13 PerformanceandMemory.............................................................................. 143
11 ConfigurationFiles.................................................147
11.1 ContentsofUserConfigurationFiles ...................................................................... 148
11.1.1 GeographicDataSet ................................................................................. 148
11.1.2 Zones .............................................................................................. 151
11.1.3 MapCentreandZoomLevel ........................................................................... 152
11.1.4 FolderConfiguration................................................................................. 152
11.1.5 CoveragePredictions ................................................................................. 159
11.1.6 AutomaticNeighbourAllocationParameters............................................................. 161
11.1.7 AutomaticFrequencyPlanningParameters .............................................................. 163
11.1.8 AutomaticScramblingCodeAllocationParameters ........................................................ 164
11.1.9 AutomaticPNOffsetAllocationParameters.............................................................. 165
11.1.10 AutomaticOFDMResourceAllocationParameters ........................................................ 167
11.1.11 MicrowaveRadioLinksParameters..................................................................... 167
11.1.12 Macros ............................................................................................ 171
8
11.2 ContentsofAdditionalConfigurationFiles ................................................................ 171
11.2.1 PrintSetupConfiguration............................................................................. 171
11.2.2 TableImport/ExportConfiguration..................................................................... 173
11.2.3 CoveragePredictionReportConfiguration............................................................... 173
11.2.4 CWMeasurementImportConfiguration................................................................ 174
11.2.5 DriveTestDataImportConfiguration................................................................... 174
11.3 ContentsoftheCustomPredictionsFile.................................................................. 175
12 InitialisationFiles ................................................. 177
12.1 AtollInitialisationFile ................................................................................. 177
12.1.1 GeneralOptions .................................................................................... 177
12.1.1.1 ModifyingtheDefaultFormatsofSiteandTransmitterNames............................................ 177
12.1.1.2 DisablingAutomaticRenamingofTransmittersandCells ................................................. 178
12.1.1.3 SettingtheTIFFColourConvention ................................................................... 178
12.1.1.4 CreatinganEventViewerLogFile.................................................................... 178
12.1.1.5 DisplayingInsufficientPermissionMessagesintheEventViewer.......................................... 179
12.1.1.6 IncreasingtheMaximumPrintingResolution........................................................... 179
12.1.1.7 DuplicatingLinkedPathLossMatricesonSaveAs ....................................................... 179
12.1.1.8 RestrictingtheListofPredictionsforCreatingSectorTrafficMaps......................................... 180
12.1.1.9 DisplayingPathLossCalculationDetailsintheEventViewer.............................................. 180
12.1.1.10 MappingAtollCoordinateSystemswithMapInfo/ESRIVectorFiles ........................................ 180
12.1.1.11 ExportingCoveragePredictionPolygonsinTextFormat .................................................. 181
12.1.1.12 DefiningWebMapServicesServers .................................................................. 181
12.1.1.13 ImprovingPointAnalysisPerformance................................................................ 181
12.1.1.14 LoadingVectorFilesDynamically..................................................................... 182
12.1.1.15 ExcludingVectorsfromImportedKML/KMZFiles ....................................................... 182
12.1.1.16 SettingthePrecisionfortheAntennaPatternVerificationatImport ....................................... 182
12.1.1.17 OpeningExportedXLSFilesAutomaticallyinMSExcel ................................................... 182
12.1.1.18 DisallowingCreationofNewDocumentsfromTemplates ................................................ 182
12.1.1.19 BlockingAccesstoMacrosandAddins................................................................ 182
12.1.1.20 DisablingSavingandOpeningZIPFiles................................................................ 183
12.1.1.21 EnablingNotificationforDonorTransmitterParameterModifications ...................................... 183
12.1.1.22 SettingtheDisplayPrecisionofFloatingPointValues .................................................... 183
12.1.1.23 ChangingthePathtoLinkedGeoDataFiles ............................................................ 183
12.1.1.24 Exporting/ImportingVectorDatawithaDisplayConfigurationFile......................................... 183
12.1.1.25 UsingOnlyVisibleGeoDatainPredictionReports....................................................... 184
12.1.1.26 ExportingBMP,TIF,andPNGFileswithaTABReferenceFile.............................................. 184
12.1.1.27 CoPlanning:LinkingtheSitesFolder.................................................................. 184
12.1.1.28 DisablingNormalisationofMIF/TABVectorFiles........................................................ 184
12.1.1.29 AddingtheDuplicateSitetotheOriginalSitesSiteList .................................................. 184
12.1.1.30 UsingOnlyVisibleClutterClassesinInterferencePredictionReports....................................... 185
12.1.1.31 Displaying%ofCoveredClutterClassesw.r.t.theFocusZoneinReports................................... 185
12.1.1.32 Displaying%ofCoveredTrafficClassesw.r.t.theFocusZoneinReports................................... 185
12.1.1.33 SynchronisingPrivateandSharedPathLossMatrices .................................................... 185
12.1.1.34 SelectingtheLogo2CheckBoxbyDefaultinPrintSetup................................................. 185
12.1.1.35 FilteringPredictionsbyTechnologyWhenReadingtheXMLStudiesFile.................................... 186
12.1.1.36 EnablingEventViewerMessagesforMapInfoFileImport/Export .......................................... 186
12.1.1.37 SettingCoveragePredictionReportResolutionForPopulationMaps ....................................... 186
12.1.1.38 SettingCoveragePredictionReportPrecision .......................................................... 186
12.1.1.39 ChangingHotSpotReferenceSurfaceinPredictionReports .............................................. 187
12.1.1.40 ExportingOnlyVisibleValueIntervalLayersofCoveragePredictions....................................... 187
12.1.1.41 AvoidingOverlappingPixelsinBestServerCoveragePrediction........................................... 187
12.1.1.42 SettingtheMinimumATLFileSizeRequiringCompression ............................................... 187
12.1.1.43 Loading,Activating,andSettingAddinsasVisible ...................................................... 187
12.1.1.44 DefiningOnlineMapURLs .......................................................................... 188
12.1.2 GUIOptions ........................................................................................ 188
12.1.2.1 DefiningtheParametersfortheDefaultSitesSymbol.................................................... 188
12.1.2.2 UsingaUniqueSymbolforRemoteAntennas .......................................................... 189
12.1.2.3 KeepingTransmitterSymbolsFromChangingonSearch ................................................. 189
12.1.2.4 DisplayingFilledSymbolsforInactiveTransmittersontheMap ........................................... 189
12.1.2.5 RefreshingtheDisplayAutomaticallyWhenaNewStationisDropped...................................... 189
12.1.2.6 HidingInformationDisplayedintheStatusBar ......................................................... 189
12.1.2.7 DisplayingDateandTimeintheEventViewer .......................................................... 189
12.1.2.8 SettingtheMaximumNumberofLinesinCoveragePredictionToolTips .................................... 190
12.1.2.9 ChangingtheDisplayforDownlinkSmartAntennaResults ............................................... 190
12.1.2.10 DisplayingCoveragePredictionCommentsintheLegendWindow......................................... 190
9
12.1.2.11 DisplayingLeadingZerosintheCELL_IDENTITYField..................................................... 190
12.1.2.12 MakingtheAntennaAdditionalElectricalDowntiltAccessible ............................................. 190
12.1.2.13 IncreasingtheWidthoftheClutterDescriptionPaneintheStatusBar ...................................... 191
12.1.2.14 ChangingtheDefaultCacheLocationfortheLoadedMapTiles ............................................ 191
12.1.2.15 HidingtheTechnologyNameintheAtollTitleBar ....................................................... 191
12.1.3 DistributedCalculationServerOptions .................................................................. 191
12.1.3.1 DetectingandListingDistributedCalculationServers..................................................... 191
12.1.3.2 SettingtheDistributedCalculationServerPriority ....................................................... 191
12.1.3.3 ModifyingtheDefaultDetectionTimeOut............................................................. 192
12.1.4 LicenceManagementOptions ......................................................................... 192
12.1.4.1 SettinganAlarmfortheLicenceEndDate .............................................................. 192
12.1.4.2 BlockingAccesstoTechnologyModules ............................................................... 192
12.1.4.3 BlockingAccesstoACPandAFPModules .............................................................. 192
12.1.4.4 ChangingtheNetHASPLicenceManagerIdleTimeSetting................................................ 193
12.1.5 DatabaseOptions.................................................................................... 193
12.1.5.1 CheckingDataIntegrityAfterDatabaseUpgradeandDataRefresh......................................... 193
12.1.5.2 AutomaticallyRunningaDatabaseIntegrityCheckatOpenorRefresh...................................... 193
12.1.5.3 AutomaticallyRunningGSMSubcellAuditatOpenorRefresh............................................. 193
12.1.5.4 ModifyingtheDefaultDatabaseConnectionTimeout .................................................... 194
12.1.5.5 MakingAtollCaseSensitiveforDatabaseImportFromPlanet ............................................. 194
12.1.5.6 SettingtheSignforKClutterWhenImportingDataFromPlanetEV......................................... 194
12.1.5.7 Enabling/DisablingPasswordPromptatArchive ......................................................... 194
12.1.5.8 ArchivingDatatoDatabasesUsingTransactions ......................................................... 195
12.1.5.9 KeepingSeparateWorkandMasterPathLossDirectories................................................. 195
12.1.5.10 EnablingPartialRefreshfromRecentlyUpgradedDatabases .............................................. 195
12.1.5.11 SettingtheTypeofDatabaseBeingUsed............................................................... 195
12.1.6 CommonCalculationOptions .......................................................................... 196
12.1.6.1 SettingtheAntennaPatternsModellingMethod........................................................ 196
12.1.6.2 DisablingAutomaticLockingofCoveragePredictions..................................................... 196
12.1.6.3 EnablingShadowingMargininCalculations ............................................................. 196
12.1.6.4 SettingaDefaultValuefortheCellEdgeCoverageProbability............................................. 197
12.1.6.5 EnablingIndoorCoverageinCalculations............................................................... 197
12.1.6.6 ModifyingtheResolutionfortheLOSAreaCalculationAroundaSite ....................................... 197
12.1.6.7 EmbeddingPathLossesinNewDocuments............................................................. 197
12.1.6.8 StoppingCalculationsonError ....................................................................... 197
12.1.6.9 WarningAboutPredictionValidityWhenDisplayOptionsareModified ..................................... 198
12.1.6.10 ReadingExactAltitudesFromtheDTM ................................................................ 198
12.1.6.11 SettingaCommonDisplayResolutionForAllCoveragePredictions......................................... 198
12.1.6.12 SettingthePrioritiesforGUIandCalculations........................................................... 198
12.1.6.13 SettingtheNumberofParallelProcessorsandThreads ................................................... 199
12.1.6.14 DisablingParallelCalculationofMonteCarloSimulations................................................. 199
12.1.6.15 PerformingCalculationsinReadOnlyDocuments ....................................................... 199
12.1.6.16 IdentifyingTransmitter,Repeater,andRemoteAntennaCoverageAreas.................................... 200
12.1.6.17 ChangingtheRoundingMethodUsedforProfileExtraction............................................... 200
12.1.6.18 EstimatingRequiredandUsedMemorySizeforUMTSSimulations......................................... 200
12.1.6.19 DisablingCalculationsOverNoDataValuesforDTMandClutterClasses..................................... 200
12.1.6.20 CoPlanning:CalculatingPredictionsintheCurrentDocumentOnly......................................... 200
12.1.6.21 CoPlanning:CalculatingPredictionsinSerialorinParallel ................................................ 201
12.1.6.22 ForcingNeighbourSymmetryOnlyInsideFocusZone .................................................... 201
12.1.6.23 UsingPoissonDistributioninMonteCarloSimulations ................................................... 201
12.1.6.24 CalculatingEIRPfromMaxPowerinSignalLevelPredictions .............................................. 201
12.1.6.25 ExcludingFilteredTransmittersfromtheListofNeighbours............................................... 201
12.1.6.26 ChangingtheWeightingFactoroftheEffectiveIntertransmitterDistance ................................... 202
12.1.6.27 EnablingandDisablingPersitePathLossMatrixCalculations.............................................. 202
12.1.7 GSMGPRSEDGEOptions ............................................................................. 202
12.1.7.1 ConsideringOverlappingZonesforIMCalculationBasedonTraffic......................................... 202
12.1.7.2 SettingtheDefaultBSICFormat ...................................................................... 202
12.1.7.3 SelectingtheInterferenceMatricesUsedDuringtheAFP................................................. 202
12.1.7.4 DefiningtheMaximumNumberofTransmittersforReuseDistance ........................................ 203
12.1.7.5 CheckingDatabaseConsistencyAutomatically .......................................................... 203
12.1.7.6 DisablingtheMaximumRangeParameter .............................................................. 203
12.1.7.7 EnablingtheSupportforMultibandTransmitters....................................................... 203
12.1.7.8 SettingtheBestServerCalculationMethodinSamePriorityHCSLayers ..................................... 204
12.1.7.9 HidingAdvancedAFPParameters ..................................................................... 204
12.1.7.10 HidingViolationsBetweenLowImportanceNeighboursinAFPResults ...................................... 204
12.1.7.11 HidingViolationsBetweenNonSynchronisedMALsMAIOsinAFPResults ................................... 204
12.1.7.12 MakingRedundantFieldsintheTransmittersTableReadonly ............................................. 205
10
12.1.7.13 SettingtheTransmissionDiversityGain............................................................... 205
12.1.7.14 AddingGroupedHCSServersOptioninCalculations ..................................................... 205
12.1.7.15 DeactivatingFrequencyBandFilteringinIMCalculation ................................................. 205
12.1.7.16 StartingTRXIndexesat1 ........................................................................... 205
12.1.7.17 HidingtheTRXIndex ............................................................................... 205
12.1.7.18 ExtendingtheAllowedValueRangeforC/IandReceptionThresholds ...................................... 206
12.1.7.19 AutomaticallyCorrectingOutofrangeSubcellValues................................................... 206
12.1.8 UMTSHSPA,CDMA2000,andTDSCDMAOptions........................................................ 206
12.1.8.1 SuppressingCellNameCarrierSuffixes................................................................ 206
12.1.8.2 DisablingMacrodiversity(SHO)GainsinCalculations ................................................... 206
12.1.8.3 CalculatingandDisplayingPeakorInstantaneousHSDPAThroughput...................................... 207
12.1.8.4 SettingthePowertoUseforIntracellInterferenceinHSDPA ............................................. 207
12.1.8.5 EnablingCoveragePredictionsofConnectionProbabilities ............................................... 207
12.1.8.6 SettingtheCalculationMethodforHSPDSCHCQI ...................................................... 208
12.1.8.7 EnablingOrthogonalityFactorinPilotEC/NTCalculationinHSDPA......................................... 208
12.1.8.8 SettingtheMaximumNumberofRejectionsforMobiles ................................................. 208
12.1.8.9 SettingtheMaximumNumberofRejectionsforHSDPAMobiles........................................... 208
12.1.8.10 DefininganOffsetWithRespecttoTheThermalNoise................................................... 208
12.1.8.11 SettingPrecisionoftheRasterisationProcess .......................................................... 209
12.1.8.12 DefiningtheNumberofIterationsBeforeDowngrading.................................................. 210
12.1.8.13 AdjustingtheWorkingoftheProportionalFairScheduler................................................ 210
12.1.8.14 DisplayingEc/I0ofRejectedMobilesinSimulationResults ............................................... 210
12.1.8.15 SwitchingBacktotheOldBestServerDeterminationMethod ............................................ 210
12.1.8.16 DisplayingAutomaticAllocationCostValues........................................................... 210
12.1.8.17 SelectingSCandPNOffsetAllocationStrategiesAvailableintheGUI ....................................... 211
12.1.8.18 DefiningaFixedIntervalBetweenScramblingCodes .................................................... 211
12.1.8.19 CompressedMode:RestrictingIntercarrierandIntertechnologyNeighbourAllocation....................... 211
12.1.8.20 SettingtheMaximumASSizeforSCInterferencePrediction .............................................. 211
12.1.8.21 DisplayingUplinkTotalLossesinCoveragebySignalLevel ................................................ 211
12.1.8.22 SettingtheMaximumULReuseFactorforHSUPAUsersNoiseRiseEstimation.............................. 212
12.1.9 LTE,WiMAX,andWiFiOptions........................................................................ 212
12.1.9.1 BlockingAccesstoIEEEParametersinWiMAX.......................................................... 212
12.1.9.2 UsingOnlyBearersCommonBetweentheTerminalsandCellsEquipment................................. 212
12.1.9.3 EnablingDisplayofSignalsperSubcarrierPointAnalysisinLTE............................................ 213
12.1.9.4 IncludingCyclicPrefixEnergyinLTESignalLevelCalculation.............................................. 213
12.1.9.5 ExcludingCyclicPrefixEnergyinWiMAXandWiFiSignalLevelCalculation.................................. 213
12.1.9.6 IgnoringInterNeighbourPreambleIndexCollisioninWiMAX ............................................. 213
12.1.9.7 IgnoringInterNeighbourPhysicalCellIDCollisioninLTE................................................. 213
12.1.9.8 RenamingOPUSCZonetoPUSCULinWiMAX.......................................................... 214
12.1.9.9 DeactivatingUniformDistributionofResources ........................................................ 214
12.1.9.10 TakingSecondOrderNeighboursintoAccountintheAFP................................................ 214
12.1.9.11 SettingPDCCHto100%LoadedinLTEInterferenceCalculations ........................................... 214
12.1.9.12 CalculatingEIRPfromRSEPREinLTESignalLevelPredictions............................................. 214
12.1.9.13 AveragingtheUplinkNoiseRiseindB................................................................. 214
12.1.9.14 DeactivatingServiceMaxThroughputDemandDowngradinginLTE........................................ 215
12.1.9.15 DisplayingPixelswithZeroThroughputinCoveragePredictions ........................................... 215
12.1.10 3GPPMultiRATOptions ............................................................................. 215
12.1.10.1 BSIC,SC,andPCIAllocationWithIntertechnologyNeighbourConstraints .................................. 215
12.1.11 MicrowaveRadioLinksOptions ....................................................................... 215
12.1.11.1 ExcludingNearfieldInterferencefromCalculations..................................................... 215
12.1.11.2 ExcludingStandbyChannelsfromInterferenceCalculations .............................................. 215
12.1.11.3 UpdatingA>>BandB>>AProfilesinRealtime.......................................................... 215
12.1.11.4 DisablingShieldingFactoronWantedSignalatReceiver ................................................. 216
12.1.11.5 HidingtheRec.ITURP.5305Method................................................................ 216
12.1.11.6 UsingOldMinC/IValues ........................................................................... 216
12.1.11.7 SolvingAlignmentIssueinGeneratedReports.......................................................... 216
12.1.11.8 DefiningDefaultConfigurationFilesforLinkBudgetsReports............................................. 216
12.1.11.9 DefiningaDefaultTemplateforMicrowaveLinksCustomReports ......................................... 217
12.1.12 MeasurementOptions ............................................................................... 217
12.1.12.1 DisplayingAdditionalInformationinDriveTestData .................................................... 217
12.1.12.2 SettingtheNumberofTransmittersperDriveTestDataPath............................................. 217
12.1.12.3 RecalculatingDistancesofPointsFromThereServingCellsatImport....................................... 217
12.1.12.4 DefiningtheBCCHandBSICColumnsforFMTImport.................................................... 218
12.1.12.5 ImportingDriveTestDatawithScramblingCodesasIntegers............................................. 218
12.1.12.6 ImportingDriveTestDataforActiveandFilteredTransmittersOnly........................................ 218
12.1.13 ACPOptions........................................................................................ 218
12.1.13.1 SpecifyingtheLocationoftheAcp.iniFile.............................................................. 218
11
12.2 ACPInitialisationFile................................................................................... 219
12.2.1 ManagingPreferences................................................................................ 219
12.2.2 GUIOptions ........................................................................................ 219
12.2.2.1 DefaultValuesontheOptimisationTab................................................................ 219
12.2.2.2 DisplayingAdvancedCostOptions .................................................................... 220
12.2.2.3 AutomaticallyCreatingCustomZonesontheOptimisationTab............................................ 221
12.2.2.4 DefaultValuesontheObjectivesTab .................................................................. 221
12.2.2.5 DefaultValuesontheReconfigurationTab............................................................. 227
12.2.2.6 DefaultValuesontheSitesTaboftheReconfigurationTab................................................ 229
12.2.2.7 DefaultValuesontheTransmittersTaboftheReconfigurationTab......................................... 229
12.2.2.8 DefaultValuesonthePatternstaboftheAntennaTab................................................... 230
12.2.2.9 DefaultValuesforEMFExposure ..................................................................... 230
12.2.2.10 ControllingAntennaPatternSmoothing................................................................ 231
12.2.2.11 DefaultValuesontheAntennasTab................................................................... 231
12.2.2.12 DefiningtheAntennaMaskingModel ................................................................. 232
12.2.2.13 DefiningMultiStoreyOptions........................................................................ 232
12.2.2.14 DefiningReconfigurationValuesinCustomAtollFields................................................... 232
12.2.2.14.1 DefiningReconfigurationValuesforTransmittersandRepeatersUsingCustomAtollFields ................... 232
12.2.2.14.2 DefiningReconfigurationValuesforSecondaryAntennasUsingCustomAtollFields ......................... 233
12.2.2.14.3 DefiningReconfigurationValuesforCellsUsingCustomAtollFields ....................................... 234
12.2.2.14.4 DefiningReconfigurationValuesforSitesUsingCustomAtollFields ....................................... 234
12.2.2.14.5 DefiningReconfigurationValuesforAntennasUsingCustomAtollFields ................................... 235
12.2.2.15 DefiningSiteClassOptions........................................................................... 236
12.2.2.15.1 DefiningAutomaticSiteClasses ..................................................................... 236
12.2.2.15.2 AutomaticAssignmentofSiteClassesintheACP....................................................... 237
12.2.2.16 DefiningtheAppearanceoftheOptimisationDialogue................................................... 238
12.2.2.16.1 DefiningtheColoursintheQualityAnalysisMaps...................................................... 238
12.2.2.16.2 OtherComponentsoftheOptimisationDialogue...................................................... 238
12.2.2.17 DefiningtheAppearanceofPredictions ................................................................ 239
12.2.2.18 DefiningNewPredictions............................................................................ 239
12.2.2.19 DefiningtheFunctionalityoftheCommitTab ........................................................... 240
12.2.2.20 DefiningtheAppearanceoftheOverlayWindow........................................................ 240
12.2.2.21 DefiningtheAppearanceoftheGraphTab............................................................. 240
12.2.2.22 DefiningtheDefaultFont............................................................................ 240
12.2.2.23 ExportingOptimisationResultsinXML................................................................. 240
12.2.2.24 ChangingtheColourLegendfortheOptimisationGraph.................................................. 241
12.2.3 ACPCoreEngineOptions.............................................................................. 242
12.2.3.1 LogFileSettings ................................................................................... 242
12.2.3.2 CalculationThreadPoolSettings...................................................................... 242
12.2.3.3 NumberofThreadsUsedforPropagationModelCalculations ............................................. 242
12.2.3.4 MemoryManagementSettings....................................................................... 242
12.2.3.5 SignalLevelandMacroDiversityGainCalculationOptions ................................................ 243
12.2.3.5.1 SignalLevel ...................................................................................... 243
12.2.3.6 AutomaticCandidatePositioningOptions.............................................................. 243
12.2.3.7 BalancingSpeed,MemoryUse,andAccuracyinCalculations .............................................. 243
12.2.3.8 AccessingRasterData............................................................................... 244
12.2.3.9 AccessingPathLossMatrices......................................................................... 244
12.2.3.10 FilteringClutterClassLayers ......................................................................... 245
12.2.3.11 PreambleSegmentation(WiMAX) .................................................................... 245
12.2.3.12 FixedRatioBetweenPilotPowerandMaxPower(UMTS) ................................................. 245
12.2.3.13 EnablingMultitechnologyOptimisationIncludingWiMAX................................................ 245
12.2.4 EMFExposureCoreOptions........................................................................... 245
12.2.5 OtherOptions....................................................................................... 246
12.2.5.1 ValidityofCoveragePredictions...................................................................... 246
13 GSMGPRSEDGEDataStructure......................................249
13.1 ChangesinDataStructureFrom3.1to3.2 ................................................................. 251
13.1.1 AddedTablesandFields .............................................................................. 251
13.1.2 DeletedTablesandFields............................................................................. 253
13.2 AfpModelsTable...................................................................................... 253
13.3 AntennasTable....................................................................................... 253
13.4 BSICDomainsTable.................................................................................... 254
13.5 BSICGroupsTable ..................................................................................... 254
13.6 BTSEquipmentsTable.................................................................................. 254
13.7 CellTypesTable ....................................................................................... 254
13.8 ChannelModelsTable.................................................................................. 255
12
13.9 CodecEquipmentsTable............................................................................... 255
13.10 CodecModeAdaptationsTable.......................................................................... 255
13.11 CodecModesTable.................................................................................... 255
13.12 CodecQualityTablesTable .............................................................................. 256
13.13 CoordSysTable....................................................................................... 256
13.14 CustomFieldsTable................................................................................... 257
13.15 EGPRSCodingSchemesTable............................................................................ 258
13.16 EGPRSDimensioningModelTable ........................................................................ 258
13.17 EGPRSEnvironmentDefsTable .......................................................................... 258
13.18 EGPRSEquipmentsTable............................................................................... 259
13.19 EGPRSMobilityTable.................................................................................. 259
13.20 EGPRSQualityTable................................................................................... 259
13.21 EGPRSServiceQualityTable ............................................................................. 259
13.22 EGPRSServicesTable.................................................................................. 260
13.23 EGPRSServicesUsageTable............................................................................. 260
13.24 EGPRSTerminalsTable................................................................................. 261
13.25 EGPRSTrafficEnvironmentsTable ........................................................................ 261
13.26 EGPRSUserProfilesTable ............................................................................... 262
13.27 FeederEquipmentsTable............................................................................... 262
13.28 FrequencyBandsTable................................................................................. 262
13.29 FrequencyDomainsTable.............................................................................. 262
13.30 FrequencyGroupsTable................................................................................ 263
13.31 HSNDomainsTable.................................................................................... 263
13.32 HSNGroupsTable ..................................................................................... 263
13.33 InterNetChProtectTable............................................................................... 264
13.34 LayersTable......................................................................................... 264
13.35 NeighboursTable ..................................................................................... 264
13.36 NeighboursConstraintsTable........................................................................... 264
13.37 NeighboursConstraintsExtTable......................................................................... 265
13.38 NeighboursExtTable.................................................................................. 265
13.39 NetworksTable ...................................................................................... 265
13.40 PropagationModelsTable .............................................................................. 266
13.41 QualityIndicatorsTable................................................................................ 266
13.42 ReceiversTable....................................................................................... 266
13.43 RepeaterEquipmentsTable............................................................................. 267
13.44 RepeatersTable...................................................................................... 267
13.45 SecondaryAntennasTable.............................................................................. 268
13.46 SeparationRulesTable ................................................................................. 268
13.47 SeparationsTable..................................................................................... 268
13.48 SitesTable........................................................................................... 269
13.49 SitesListsTable ....................................................................................... 269
13.50 SitesListsNamesTable................................................................................. 269
13.51 TMAEquipmentsTable ................................................................................ 269
13.52 TplTransmittersTable................................................................................. 270
13.53 TransmittersTable .................................................................................... 272
13.54 TRGConfigurationsTable............................................................................... 274
13.55 TRGsTable .......................................................................................... 275
13.56 TRXEquipmentsTable................................................................................. 277
13.57 TRXsTable........................................................................................... 277
13.58 TRXTypesTable ...................................................................................... 278
13.59 TSConfigurationNamesTable........................................................................... 278
13.60 TSConfigurationsTable................................................................................ 278
13.61 TxsListsTable........................................................................................ 278
13.62 TxsListsNamesTable .................................................................................. 279
13.63 UnitsTable.......................................................................................... 279
14 UMTSHSPADataStructure......................................... 281
14.1 ChangesinDataStructureFrom3.1to3.2................................................................ 284
14.1.1 AddedTablesandFields.............................................................................. 284
14.1.2 DeletedTablesandFields ............................................................................ 285
14.2 AntennasTable....................................................................................... 286
14.3 BTSEquipmentsTable ................................................................................. 286
14.4 CDMACellsTable ..................................................................................... 287
14.5 CdmaEqptsHSUPARssUseTable......................................................................... 288
14.6 CDMAEquipmentsTable............................................................................... 289
14.7 CDMAEquipmentsCEsUseTable ......................................................................... 289
13
14.8 CoordSysTable ....................................................................................... 290
14.9 CustomFieldsTable .................................................................................... 291
14.10 FeederEquipmentsTable ............................................................................... 291
14.11 FrequencyBandsTable ................................................................................. 291
14.12 HSDPABearersTable................................................................................... 292
14.13 HSDPABearerSelectTablesTable......................................................................... 292
14.14 HSDPAQualityTablesTable .............................................................................. 292
14.15 HSPAMIMOConfigsTable............................................................................... 293
14.16 HSUPABearersTable ................................................................................... 293
14.17 HSUPABearerSelectionTable ............................................................................ 293
14.18 HSUPAQualityTablesTable .............................................................................. 294
14.19 HSUPAUECategoriesTable.............................................................................. 294
14.20 InterfReductionFactorsTable............................................................................ 295
14.21 InterNetChProtectTable................................................................................ 295
14.22 MUGTablesTable ..................................................................................... 295
14.23 NeighboursTable...................................................................................... 295
14.24 NeighboursConstraintsTable ............................................................................ 296
14.26 NeighboursExtTable ................................................................................... 296
14.27 NetworksTable....................................................................................... 296
14.28 PropagationModelsTable............................................................................... 297
14.29 QualityIndicatorsTable................................................................................. 298
14.30 R99BearersTable...................................................................................... 298
14.31 ReceiversTable....................................................................................... 298
14.32 RepeaterEquipmentsTable ............................................................................. 299
14.33 RepeatersTable....................................................................................... 299
14.34 ScramblingCodesDomainsTable ......................................................................... 300
14.35 ScramblingCodesGroupsTable........................................................................... 300
14.36 SchedulersTable...................................................................................... 301
14.37 SecondaryAntennasTable .............................................................................. 301
14.38 SeparationsTable ..................................................................................... 301
14.39 ServiceQualityTablesTable.............................................................................. 301
14.40 SitesTable ........................................................................................... 302
14.41 SitesListsTable........................................................................................ 302
14.42 SitesListsNamesTable.................................................................................. 302
14.43 TMAEquipmentsTable................................................................................. 302
14.44 TplTransmittersTable .................................................................................. 303
14.45 TransmittersTable..................................................................................... 306
14.46 TxsListsTable ......................................................................................... 307
14.47 TxsListsNamesTable................................................................................... 307
14.48 UECategoriesTable .................................................................................... 308
14.49 UERxEquipmentsTable ................................................................................. 308
14.50 UMTSEnvironmentDefsTable ........................................................................... 308
14.51 UMTSMobilityTable................................................................................... 308
14.52 UMTSServicesTable ................................................................................... 309
14.53 UMTSServicesQualityTable............................................................................. 310
14.54 UMTSServicesUsageTable.............................................................................. 311
14.55 UMTSTerminalsTable .................................................................................. 311
14.56 UMTSTraficEnvironmentsTable.......................................................................... 312
14.57 UMTSUserProfilesTable ................................................................................ 312
14.58 UnitsTable ........................................................................................... 312
15 CDMA2000DataStructure..........................................313
15.2 AntennasTable....................................................................................... 317
15.4 CarriersTypeTable..................................................................................... 318
15.5 CDMACellsTable...................................................................................... 318
15.6 CDMAEquipmentsTable ................................................................................ 319
15.7 CDMAEquipmentsCEsUseTable.......................................................................... 320
15.8 CoordSysTable ....................................................................................... 320
15.10 DLBearersSelectionTable ............................................................................... 322
15.11 DLDORABearersTable.................................................................................. 322
14
15.12 DORABearersTable................................................................................... 322
15.13 DORABearersProbaTable.............................................................................. 322
15.14 DORATerminalT2PRatiosTable.......................................................................... 323
15.17 InterfReductionFactorsTable........................................................................... 324
15.23 NetworksTable ...................................................................................... 325
15.24 PnCodesDomainsTable ................................................................................ 326
15.25 PnCodesGroupsTable................................................................................. 326
15.28 ReceiversTable....................................................................................... 327
15.30 RepeatersTable...................................................................................... 328
15.32 SeparationsTable..................................................................................... 329
15.33 ServiceQualityTablesTable............................................................................. 329
15.34 SitesTable........................................................................................... 330
15.40 TxsListsTable........................................................................................ 335
15.42 UERxEquipmentsTable................................................................................ 335
15.43 ULBearersSelectionTable.............................................................................. 335
15.44 UMTSEnvironmentDefsTable........................................................................... 336
15.45 UMTSMobilityTable .................................................................................. 336
15.46 UMTSServicesTable................................................................................... 336
15.48 UMTSServicesUsageTable ............................................................................. 338
15.49 UMTSTerminalsTable................................................................................. 338
15.50 UMTSTraficEnvironmentsTable ......................................................................... 340
15.51 UMTSUserProfilesTable............................................................................... 340
15.52 UnitsTable.......................................................................................... 340
16 LTEDataStructure ................................................ 341
16.2 AntennasTable....................................................................................... 346
16.4 CoordSysTable....................................................................................... 347
16.9 lcchdivgainsTable .................................................................................... 350
16.10 lframeconfigsTable................................................................................... 350
16.11 llayersTable......................................................................................... 351
16.12 lpcidomainsTable .................................................................................... 351
16.13 lpcigroupsTable ...................................................................................... 351
16.14 MUGTablesTable..................................................................................... 351
16.19 NetworksTable ...................................................................................... 353
15
16.22 ReceiversTable....................................................................................... 354
16.24 RepeatersTable....................................................................................... 355
16.25 SchedulersTable...................................................................................... 356
16.27 SitesTable ........................................................................................... 357
16.30 SmartAntennasTable.................................................................................. 357
16.31 SmartAntennasModelsTable ............................................................................ 358
16.32 T4GBearerQualityCurvesTable .......................................................................... 358
16.33 T4GBearersTable ..................................................................................... 358
16.34 T4GBearersRequiredCITable............................................................................ 358
16.35 T4GCellsTable........................................................................................ 359
16.36 T4GEnvironmentDefsTable............................................................................. 361
16.37 T4GEquipmentsTable .................................................................................. 361
16.38 T4GMimoConfigsTable................................................................................. 361
16.39 T4GMobilityTable ..................................................................................... 362
16.40 T4GServicesTable..................................................................................... 362
16.41 T4GServicesUsageTable ................................................................................ 363
16.42 T4GTerminalsTable.................................................................................... 364
16.43 T4GTraficEnvironmentsTable ........................................................................... 364
16.44 T4GUECategoriesTable................................................................................. 364
16.45 T4GUserProfilesTable.................................................................................. 365
16.48 TransmittersTable..................................................................................... 368
16.49 TxsListsTable ......................................................................................... 369
16.50 TxsListsNamesTable................................................................................... 370
16.51 UnitsTable ........................................................................................... 370
17 3GPPMultiRATDataStructure......................................371
17.1 TablesCommontoAllTechnologies...................................................................... 371
17.1.1 ChangesinDataStructureFrom3.1to3.2............................................................... 371
17.1.1.1 AddedTablesandFields............................................................................. 371
17.1.1.2 DeletedTablesandFields............................................................................ 371
17.1.2 antennasTable ...................................................................................... 372
17.1.3 btsequipmentsTable ................................................................................. 372
17.1.4 coordsysTable...................................................................................... 372
17.1.5 customfieldsTable ................................................................................... 372
17.1.6 environmentdefsTable............................................................................... 372
17.1.7 feederequipmentsTable .............................................................................. 372
17.1.8 internetchprotectTable............................................................................... 372
17.1.9 mobilityTable....................................................................................... 372
17.1.10 networksTable...................................................................................... 373
17.1.11 propagationmodelsTable............................................................................. 374
17.1.12 receiversTable...................................................................................... 374
17.1.13 repeaterequipmentsTable............................................................................ 374
17.1.14 servicesTable ....................................................................................... 374
17.1.15 servicesusageTable.................................................................................. 375
17.1.16 sitesTable .......................................................................................... 375
17.1.17 siteslistsTable....................................................................................... 376
17.1.18 siteslistsnamesTable ................................................................................. 376
17.1.19 smartantennasmodelsTable........................................................................... 376
17.1.20 terminalsTable...................................................................................... 376
17.1.21 tmaequipmentsTable................................................................................ 377
17.1.22 trafficenvsTable..................................................................................... 377
17.1.23 unitsTable ......................................................................................... 377
17.1.24 userprofilesTable.................................................................................... 377
17.2 GSMspecificTables ................................................................................... 377
17.2.2 gafpmodelsTable.................................................................................... 378
17.2.3 gbsicdomainsTable.................................................................................. 378
17.2.4 gbsicgroupsTable.................................................................................... 378
17.2.5 gcelltypesTable..................................................................................... 378
16
17.2.6 gcodecequipmentsTable ............................................................................. 378
17.2.7 gcodecmodeadaptsTable ............................................................................ 378
17.2.8 gcodecmodesTable................................................................................. 378
17.2.9 gcodecqualtablesTable.............................................................................. 378
17.2.10 gcodingschemesTable............................................................................... 378
17.2.11 gcsequipmentsTable................................................................................ 378
17.2.12 gcsqualityTable .................................................................................... 379
17.2.13 gdimensmodelTable ................................................................................ 379
17.2.14 gfreqdomainsTable................................................................................. 379
17.2.15 gfreqgroupsTable................................................................................... 379
17.2.16 gfrequencybandsTable .............................................................................. 379
17.2.17 ghsndomainsTable.................................................................................. 379
17.2.18 ghsngroupsTable................................................................................... 379
17.2.19 glayersTable....................................................................................... 379
17.2.20 glneighboursTable .................................................................................. 379
17.2.21 glneighconstraintsTable ............................................................................. 379
17.2.22 gneighboursTable .................................................................................. 380
17.2.23 gneighconstraintsTable .............................................................................. 380
17.2.24 gneighextTable..................................................................................... 380
17.2.25 gneighextconstraintsTable........................................................................... 380
17.2.26 gqualityindicatorsTable.............................................................................. 380
17.2.27 grepeatersTable.................................................................................... 380
17.2.28 gsecondaryantennasTable ........................................................................... 380
17.2.29 gseparationrulesTable............................................................................... 380
17.2.30 gseparationsTable.................................................................................. 380
17.2.31 gservicequalityTable................................................................................ 380
17.2.32 gservicesTable..................................................................................... 380
17.2.33 gterminalsTable.................................................................................... 380
17.2.34 gtpltransmittersTable............................................................................... 381
17.2.35 gtransmittersTable.................................................................................. 381
17.2.36 gtrgconfigsTable.................................................................................... 381
17.2.37 gtrgsTable......................................................................................... 381
17.2.38 gtrxequipmentsTable................................................................................ 381
17.2.39 gtrxsTable ......................................................................................... 381
17.2.40 gtrxtypesTable..................................................................................... 381
17.2.41 gtsconfignamesTable................................................................................ 381
17.2.42 gtsconfigsTable .................................................................................... 381
17.2.43 gtxslistsTable...................................................................................... 381
17.2.44 gtxslistsnamesTable................................................................................. 381
17.2.45 guneighboursTable ................................................................................. 381
17.2.46 guneighconstraintsTable............................................................................. 382
17.3 UMTSspecificTables.................................................................................. 382
17.3.1.1 AddedTablesandFields ............................................................................ 382
17.3.1.2 DeletedTablesandFields ........................................................................... 383
17.3.2 ucellsTable........................................................................................ 384
17.3.3 uceuseTable....................................................................................... 384
17.3.4 uequipmentsTable.................................................................................. 384
17.3.5 ufrequencybandsTable.............................................................................. 384
17.3.6 ugneighbours ...................................................................................... 384
17.3.7 ugneighconstraints .................................................................................. 384
17.3.8 uhsdpabearersTable ................................................................................ 384
17.3.9 uhsdpabearerselectTable............................................................................ 385
17.3.10 uhsdpaqualtablesTable .............................................................................. 385
17.3.11 uhspamimoconfigsTable ............................................................................. 385
17.3.12 uhsupabearersTable ................................................................................ 385
17.3.13 uhsupabearerselectTable............................................................................ 385
17.3.14 uhsupaqualtablesTable .............................................................................. 385
17.3.15 uhsuparessuseTable ................................................................................ 385
17.3.16 uhsupauecategoriesTable ............................................................................ 385
17.3.17 uinterfreducfactorsTable ............................................................................ 385
17.3.18 ulneighbours....................................................................................... 385
17.3.19 ulneighconstraints .................................................................................. 385
17.3.20 umobilityTable ..................................................................................... 386
17.3.21 umugtablesTable................................................................................... 386
17.3.22 uneighboursTable .................................................................................. 386
17.3.23 uneighconstraintsTable.............................................................................. 386
17
17.3.24 uneighextTable..................................................................................... 386
17.3.25 uneighextconstraintsTable ............................................................................ 386
17.3.26 upscdomainsTable................................................................................... 386
17.3.27 upscforbidpairsTable................................................................................. 386
17.3.28 upscgroupsTable .................................................................................... 386
17.3.29 uqualityindicatorsTable .............................................................................. 386
17.3.30 ur99bearersTable ................................................................................... 386
17.3.31 urepeatersTable .................................................................................... 386
17.3.32 uschedulersTable ................................................................................... 387
17.3.33 usecondaryantennasTable............................................................................ 387
17.3.34 uservicequaltablesTable .............................................................................. 387
17.3.35 uservicesTable ...................................................................................... 387
17.3.36 uservicesqualityTable................................................................................ 387
17.3.37 uterminalsTable..................................................................................... 387
17.3.38 utpltransmittersTable ................................................................................ 387
17.3.39 utransmittersTable.................................................................................. 387
17.3.40 utxslistsTable ....................................................................................... 387
17.3.41 utxslistsnamesTable................................................................................. 387
17.3.42 uuecategoriesTable.................................................................................. 387
17.3.43 uuerxequipmentsTable............................................................................... 387
17.4 LTEspecificTables..................................................................................... 387
17.4.2 lbearerqualitycurvesTable............................................................................ 390
17.4.3 lbearersTable....................................................................................... 390
17.4.4 lbearersrequiredciTable.............................................................................. 390
17.4.5 lcellsTable.......................................................................................... 390
17.4.6 lcchdivgainsTable ................................................................................... 390
17.4.7 lequipmentsTable................................................................................... 390
17.4.8 lframeconfigsTable.................................................................................. 390
17.4.9 lfrequencybandsTable................................................................................ 390
17.4.10 lgneighboursTable................................................................................... 391
17.4.11 lgneighconstraintsTable.............................................................................. 391
17.4.12 llayersTable........................................................................................ 391
17.4.13 lmimoconfigsTable.................................................................................. 391
17.4.14 lmugtablesTable .................................................................................... 391
17.4.15 lneighboursTable.................................................................................... 391
17.4.16 lneighconstraintsTable............................................................................... 391
17.4.17 lneighextTable ...................................................................................... 391
17.4.18 lneighextconstraintsTable ............................................................................ 391
17.4.19 lpcidomainsTable ................................................................................... 392
17.4.20 lpcigroupsTable ..................................................................................... 392
17.4.21 lqualityindicatorsTable............................................................................... 392
17.4.22 lrepeatersTable..................................................................................... 392
17.4.23 lschedulersTable.................................................................................... 392
17.4.24 lsecondaryantennasTable............................................................................. 392
17.4.25 lservicesTable ...................................................................................... 392
17.4.26 lsmartantennasTable ................................................................................ 392
17.4.27 lterminalsTable..................................................................................... 392
17.4.28 ltpltransmittersTable ................................................................................ 392
17.4.29 ltransmittersTable................................................................................... 392
17.4.30 ltxslistsTable ....................................................................................... 392
17.4.31 ltxslistsnamesTable .................................................................................. 392
17.4.32 luecategoriesTable .................................................................................. 392
17.4.33 luneighboursTable................................................................................... 393
17.4.34 luneighconstraintsTable .............................................................................. 393
18 3GPP2MultiRATDataStructure.....................................395
18.1 TablesCommontoAllTechnologies...................................................................... 395
18.1.1 antennasTable ...................................................................................... 395
18.1.2 btsequipmentsTable ................................................................................. 395
18.1.3 coordsysTable...................................................................................... 395
18.1.4 customfieldsTable ................................................................................... 395
18.1.5 environmentdefsTable............................................................................... 395
18.1.6 feederequipmentsTable .............................................................................. 395
18.1.7 internetchprotectTable............................................................................... 395
18
18.1.8 mobilityTable...................................................................................... 395
18.1.9 networksTable..................................................................................... 396
18.1.10 propagationmodelsTable ............................................................................ 397
18.1.11 receiversTable..................................................................................... 397
18.1.12 repeaterequipmentsTable ........................................................................... 397
18.1.13 servicesTable...................................................................................... 397
18.1.14 servicesusageTable................................................................................. 398
18.1.15 sitesTable......................................................................................... 398
18.1.16 siteslistsTable ...................................................................................... 399
18.1.17 siteslistsnamesTable................................................................................ 399
18.1.18 smartantennasmodelsTable.......................................................................... 399
18.1.19 terminalsTable ..................................................................................... 399
18.1.20 tmaequipmentsTable ............................................................................... 400
18.1.21 trafficenvsTable.................................................................................... 400
18.1.22 unitsTable......................................................................................... 400
18.1.23 userprofilesTable ................................................................................... 400
18.2 CDMA2000specificTables ............................................................................. 400
18.2.1 ccarrierstypeTable .................................................................................. 400
18.2.2 ccellsTable ........................................................................................ 401
18.2.3 cceuseTable....................................................................................... 401
18.2.4 cdlbearerselectTable ................................................................................ 401
18.2.5 cdldorabearersTable................................................................................ 401
18.2.6 cdorabearersTable.................................................................................. 401
18.2.7 cdorabearersprobaTable............................................................................. 401
18.2.8 cdoratermt2pratiosTable ............................................................................ 401
18.2.9 cequipmentsTable .................................................................................. 401
18.2.10 cfrequencybandsTable .............................................................................. 401
18.2.11 cinterfreducfactorsTable............................................................................. 401
18.2.12 clneighboursTable.................................................................................. 401
18.2.13 clneighconstraintsTable ............................................................................. 402
18.2.14 cmobilityTable..................................................................................... 402
18.2.15 cneighboursTable................................................................................... 402
18.2.16 cneighconstraintsTable .............................................................................. 402
18.2.17 cneighextTable..................................................................................... 402
18.2.18 cneighextconstraintsTable ........................................................................... 402
18.2.19 cpnodomainsTable.................................................................................. 402
18.2.20 cpnoforbidpairsTable................................................................................ 402
18.2.21 cpnogroupsTable................................................................................... 402
18.2.22 cqualityindicatorsTable .............................................................................. 402
18.2.23 crepeatersTable .................................................................................... 402
18.2.24 csecondaryantennasTable............................................................................ 402
18.2.25 cservicequaltablesTable ............................................................................. 403
18.2.26 cservicesTable ..................................................................................... 403
18.2.27 cservicesqualityTable................................................................................ 403
18.2.28 cterminalsTable.................................................................................... 403
18.2.29 ctpltransmittersTable ............................................................................... 403
18.2.30 ctransmittersTable.................................................................................. 403
18.2.31 ctxslistsTable ...................................................................................... 403
18.2.32 ctxslistsnamesTable................................................................................. 403
18.2.33 cuerxequipmentsTable.............................................................................. 403
18.2.34 culbearerselectTable ................................................................................ 403
18.3 LTEspecificTables .................................................................................... 403
18.3.1 lbearerqualitycurvesTable............................................................................ 403
18.3.2 lbearersTable...................................................................................... 403
18.3.3 lbearersrequiredciTable ............................................................................. 403
18.3.4 lcellsTable......................................................................................... 404
18.3.5 lcchdivgainsTable................................................................................... 404
18.3.6 lcneighboursTable.................................................................................. 404
18.3.7 lcneighconstraintsTable ............................................................................. 404
18.3.8 lequipmentsTable .................................................................................. 404
18.3.9 lframeconfigsTable ................................................................................. 404
18.3.10 lfrequencybandsTable ............................................................................... 404
18.3.11 llayersTable ....................................................................................... 404
18.3.12 lmimoconfigsTable.................................................................................. 404
18.3.13 lmugtablesTable.................................................................................... 405
18.3.14 lneighboursTable ................................................................................... 405
18.3.15 lneighconstraintsTable .............................................................................. 405
19
18.3.16 lneighextTable ...................................................................................... 405
18.3.17 lneighextconstraintsTable ............................................................................ 405
18.3.18 lpcidomainsTable ................................................................................... 405
18.3.19 lpcigroupsTable ..................................................................................... 405
18.3.20 lqualityindicatorsTable............................................................................... 405
18.3.21 lrepeatersTable..................................................................................... 405
18.3.22 lschedulersTable.................................................................................... 405
18.3.23 lsecondaryantennasTable............................................................................. 405
18.3.24 lservicesTable ...................................................................................... 405
18.3.25 lsmartantennasTable ................................................................................ 405
18.3.26 lterminalsTable..................................................................................... 405
18.3.27 ltpltransmittersTable ................................................................................ 406
18.3.28 ltransmittersTable................................................................................... 406
18.3.29 ltxslistsTable ....................................................................................... 406
18.3.30 ltxslistsnamesTable .................................................................................. 406
18.3.31 luecategoriesTable .................................................................................. 406
19 TDSCDMADataStructure ..........................................407
19.2 AntennasTable....................................................................................... 410
19.3 AntennasListsTable.................................................................................... 411
19.4 AntennasListsNamesTable.............................................................................. 411
19.6 CDMACellsTable...................................................................................... 412
19.7 CDMACellsTSTable.................................................................................... 413
19.8 CDMAEquipmentsTable ................................................................................ 414
19.9 CDMAEquipmentsCEsUseTable.......................................................................... 414
19.10 CodesRelativityClustersTable ........................................................................... 415
19.11 CoordSysTable ....................................................................................... 415
19.13 FeederEquipmentsTable ............................................................................... 416
19.14 FrequencyBandsTable ................................................................................. 417
19.15 HSDPABearersTable................................................................................... 417
19.16 HSDPABearerSelectTablesTable......................................................................... 417
19.17 HSUPABearers........................................................................................ 417
19.18 HSUPABearerSelection................................................................................. 418
19.19 HSUPAUECategories................................................................................... 418
19.20 InterfReductionFactorsTable............................................................................ 419
19.21 InterNetChProtectTable................................................................................ 419
19.22 NeighboursTable...................................................................................... 419
19.23 NeighboursConstraintsTable ............................................................................ 419
19.25 NeighboursExtTable ................................................................................... 420
19.26 NetworksTable....................................................................................... 420
19.28 QualityIndicatorsTable................................................................................. 422
19.29 R99BearersTable...................................................................................... 422
19.30 ReceiversTable....................................................................................... 422
19.32 RepeatersTable....................................................................................... 423
19.33 SACIGainCDFTable.................................................................................... 424
19.34 ScramblingCodesDomainsTable ......................................................................... 424
19.35 ScramblingCodesGroupsTable........................................................................... 424
19.37 SeparationsTable ..................................................................................... 425
19.38 ServiceQualityTablesTable.............................................................................. 425
19.39 ServiceRUsUseTable................................................................................... 425
19.40 SitesTable ........................................................................................... 426
19.44 SmartAntennasModelsTable ............................................................................ 427
20
19.48 TxsListsTable........................................................................................ 432
19.50 UECategoriesTable................................................................................... 432
19.51 UERxEquipmentsTable................................................................................ 433
19.52 UMTSEnvironmentDefsTable........................................................................... 433
19.53 UMTSMobilityTable .................................................................................. 433
19.54 UMTSServicesTable................................................................................... 434
19.56 UMTSServicesUsageTable ............................................................................. 435
19.57 UMTSTerminalsTable................................................................................. 436
19.58 UMTSTraficEnvironmentsTable ......................................................................... 437
19.59 UMTSUserProfilesTable............................................................................... 437
19.60 UnitsTable.......................................................................................... 437
20 WiMAXandWiFiDataStructure.................................... 439
20.2 AntennasTable....................................................................................... 443
20.4 CoordSysTable....................................................................................... 444
20.7 FrameConfigurationsTable............................................................................. 446
20.10 MUGTablesTable..................................................................................... 447
20.15 NetworksTable ...................................................................................... 448
20.16 PermutationZonesTable ............................................................................... 450
20.19 ReceiversTable....................................................................................... 451
20.21 RepeatersTable...................................................................................... 452
20.22 SchedulersTable ..................................................................................... 453
20.24 SitesTable........................................................................................... 453
20.28 SmartAntennasModelsTable........................................................................... 454
20.32 TxsListsTable........................................................................................ 459
20.34 UnitsTable.......................................................................................... 459
20.35 WBearerQualityCurvesTable........................................................................... 459
20.36 WBearersTable...................................................................................... 460
20.37 WBearersRequiredCITable ............................................................................. 460
20.38 WCCHDivGainsTable .................................................................................. 460
20.39 WCellsTable ......................................................................................... 461
20.40 WEnvironmentDefsTable.............................................................................. 462
20.41 WEquipmentsTable................................................................................... 463
20.42 WLayersTable ....................................................................................... 463
20.43 WMimoConfigsTable ................................................................................. 463
20.44 WMobilityTable...................................................................................... 464
20.45 WPIDomainsTable.................................................................................... 464
20.46 WPIGroupsTable..................................................................................... 464
20.47 WServicesTable ...................................................................................... 464
20.48 WServicesUsageTable................................................................................. 466
21
20.49 WTerminalsTable..................................................................................... 466
20.50 WTraficEnvironmentsTable ............................................................................. 467
20.51 WUserProfilesTable................................................................................... 467
21 MicrowaveLinksDataStructure .....................................469
21.2 CoordSysTable ....................................................................................... 472
21.4 MWAntennasTable.................................................................................... 473
21.5 MWBandsTable....................................................................................... 474
21.6 MWBranchingConfigsTable ............................................................................. 474
21.7 MWCapacitiesTable................................................................................... 475
21.8 MWCompatibilitiesTable ............................................................................... 475
21.9 MWCompatibilitiesGuidesTable......................................................................... 475
21.10 MWDefaultsCurvesTable ............................................................................... 476
21.11 MWEPOTable........................................................................................ 476
21.12 MWEPOLinkClassTable................................................................................. 477
21.13 MWEquipmentsTable.................................................................................. 477
21.14 MWFamiliesTable..................................................................................... 479
21.15 MWFamilyBandsTable................................................................................. 479
21.16 MWFamilyBrConfigsTable.............................................................................. 479
21.17 MWFamilyChSpacingsTable............................................................................. 480
21.18 MWFamilyModulationsTable ........................................................................... 480
21.19 MWFrequenciesTable ................................................................................. 480
21.20 MWGuidesTable ...................................................................................... 481
21.21 MWHubsTable ....................................................................................... 481
21.22 MWIrfsTable......................................................................................... 481
21.23 MWLinksTable ....................................................................................... 482
21.24 MWLinkTypesTable ................................................................................... 485
21.25 MWManufacturersTable............................................................................... 486
21.26 MWMediumTypesTable................................................................................ 486
21.27 MWModulationsTable ................................................................................. 486
21.28 MWMultiHopsTable ................................................................................... 486
21.29 MWMultiHopsLinksTable............................................................................... 487
21.30 MWOperatingModesTable ............................................................................. 487
21.31 MWOTLinksTable..................................................................................... 487
21.32 MWPMPTable........................................................................................ 487
21.33 MWPortsTable....................................................................................... 488
21.34 MWRepeatersTable................................................................................... 488
21.35 MWSubbandsTable ................................................................................... 489
21.36 MWTplLinksTable ..................................................................................... 489
21.37 NetworksTable....................................................................................... 492
21.39 SitesTable ........................................................................................... 493
21.42 UnitsTable ........................................................................................... 493
22
Part1
Inthispart,thefollowingareexplained:
"GettingStarted"onpage 25
"InstallingAtollandComponents"onpage 29
"Setting Up Distributed Calculation Server" on
page 39
"ManagingLicences"onpage 43
"ManagingDatabases"onpage 49
"MultiuserEnvironments"onpage 73
GettingStarted
Thispartoftheadministratormanualprovidestheinformation
toinstallandsetupAtollanditscomponents,andto
managedatabasesandmultiuserenvironments.
AT320_AM_E2 Chapter1:GettingStarted
25
1 GettingStarted
Atoll is an open, scalable, and flexible multitechnology network design and optimisation platform that supports wireless
operatorsthroughoutthenetworklifecycle,frominitialdesigntodensificationandoptimisation.Atollsupportsawiderange
ofimplementation scenarios,fromstandalonetoenterprisewideserverbased configurationsusingdistributedandmulti
threadedcomputing.
Thismanualexplainshowtoinstall,configure,anddeployAtollandhowtosetupbackenddatabasesandmanageusersin
amultiuserenvironment.Databasestructuresofthedifferenttechnologymodulesarealsoprovidedforreference.
Inthischapter,thefollowingareexplained:
"SupportedTechnologies"onpage 25
"SupportedOperatingSystems"onpage 25
"SupportedDatabaseManagementSystems"onpage 26
"SupportedInstallationConfigurations"onpage 26
"RecommendedHardwareandSoftware"onpage 26
"RecommendedComputerNetworkArchitecture"onpage 28.
1.1 SupportedTechnologies
Atoll supports the following radio technologies: GSM GPRS EDGE, UMTS HSPA, CDMA2000 1xRTT EVDO, LTE, TDSCDMA,
WiMAX, and WiFi. It also supports 3GPP MultiRAT (combined GSM, UMTS, and LTE), and 3GPP2 MultiRAT (combined
CDMA2000andLTE).AtollMicrowavesupportsdetaileddesignandanalysisofmicrowavelinknetworks.
1.2 SupportedOperatingSystems
AtollsupportsthefollowingversionsofMicrosoftWindowsoperatingsystems.AtollalsosupportsVMWareESXi4.xand5.1
virtualisationplatforms.
SupportedOperatingSystemsforAtoll32bit
MicrosoftWindowsXPProSP3(32bitand64bit)
MicrosoftWindowsVistaSP2(32bitand64bit)
MicrosoftWindows7(32bitand64bit)
MicrosoftWindows8ProandEnterprise(32bitand64bit)
MicrosoftWindowsServer2003
MicrosoftWindowsServer2008(32bitand64bit)
MicrosoftWindowsServer2008R2SP1
SupportedOperatingSystemsforAtoll64bit
MicrosoftWindows7(64bit)
MicrosoftWindows8ProandEnterprise(64bit)
MicrosoftWindowsServer2008SP2(64bit)
MicrosoftWindowsServer2008R2SP1
Among other Microsoft Windows components, Atoll 64bit uses Microsoft Access
DatabaseEngine64bit.MicrosoftAccessDatabaseEngine64bitisincludedinMicrosoft
Office 64bit, and is also available as a free redistributable Microsoft Windows
componentfromForskssupportwebsite.
If the computer on which you wish to install and run Atoll 64bit already has
MicrosoftOfficeinstalled,youmustupgradeittoMicrosoftOffice64bit(version
2010SP1ornewer).
IfyoudonothaveMicrosoftOfficeinstalled,youcandownloadandinstallthe
Microsoft Access Database Engine 64bit redistributable (version 2010 SP1)
neededbyAtoll64bitfromForskssupportwebsite.
Note:InstallingMicrosoftOffice64bitortheMicrosoftAccessDatabaseEngine64bit
requires uninstalling any 32bit Microsoft Office components that may be installed on
thecomputer.
26
Chapter1:GettingStarted Forsk2013
1.3 SupportedDatabaseManagementSystems
Inamultiuserenvironment,databasesallowseveraluserstosharedatawithouttheriskofdatainconsistency.Inamultiuser
environment,userdocumentsareconnectedtoacentraldatabase,inwhichusersstoretheirworkonacommonproject.
AtollsupportsthefollowingRDBMS:
Oracle(Oracleclientversion10.0.2.3orlatershouldbeused)
MicrosoftSQLServer
MicrosoftAccess
AnydatabasethatacceptsUDLfilesandsupportstheODBCinterface
Thephysicallocationofdatabasesvariesaccordingtothetypeofthedatabase.Thefollowingtableshowswherethedatabase
mustbeinstalled:
1.4 SupportedInstallationConfigurations
Dependingonyourrequirements,Atollcanbeinstalledina:
Standaloneconfiguration:
Atollinstalledoneachindividualusercomputerwithafixedlicencekeypluggedineachcomputer.
Workstationbasedmultiuserconfiguration:
Atoll installed on each individual user computer on a network with a floating licence management server that
allocateslicencetokenstoAtollsessionsrunbyusersontheircomputers.
Serverbasedmultiuserconfiguration:
Atollinstalledonserversconnectedtousercomputersandafloatinglicencemanagementserveronanetwork.The
floating licence management server allocates licence tokens to Atoll sessions run by the users on the servers. The
serverscanbeCitrixbased,whereusersrunAtollsessionsontheserversthroughtheCitrixinterface.
1.5 RecommendedHardwareandSoftware
Thissectionprovidesguidelinesfordimensioningclientcomputersandserversonyournetworkforoptimumperformance
withAtoll.Thissectionliststherecommendedhardwareandsoftwarefor:
"UserWorkstations"onpage 26
"DatabaseServers"onpage 27
"ApplicationServers"onpage 27
"FloatingLicenceServers"onpage 27
"FileServers"onpage 27.
1.5.1 UserWorkstations
Thefollowingtableliststherequiredandrecommendedhardwareandsoftwareforuserworkstations(clients)intendedfor
runningwithAtoll.
Database Server Clientcomputer
MicrosoftAccess No
Yes
a
a. ItispossibletoworkwithanAtolldocumentconnectedtoaMicrosoftAccessdatabaseevenifMicrosoftAccessisnot
installedonthecomputer.
MicrosoftSQLserver Yes No
Oracle Yes Yes(Oracleclient)
Processor Corei7
RAM 8 GBormore
Storage
512 GB
a
(SSDrecommended)
a. Dependsonthesizeofthelocallystoredgeographicdataandpathlossmatrices,ifany.
Operatingsystem
WindowsXPProfessionalSP3(Atoll32bitonly)
WindowsVistaSP2(Atoll32bitonly)
Windows7/Windows8ProandEnterprise
Otherrequirements
Fixedlicence:1USBportrequiredtopluginthefixedlicencekey
Floatinglicence:nethasp.inifileintheAtollinstallationfolder
AT320_AM_E2 Chapter1:GettingStarted
27
IfyouareworkingwithanOracledatabase,youmustinstallOracleclientontheusercomputersaswell.TheOracleclient
versionmustcorrespondtotheOracledatabaseinstalledonthedatabaseserver.
1.5.2 DatabaseServers
The following table lists the required and recommended hardware and software for an Oracle database server. The same
configurationcanbeconsideredvalidforotherdatabasesystemsaswell.
1.5.3 ApplicationServers
ApplicationserversareintendedforinstallingandrunningAtoll,defininguserrights,etc.UserscanworkwithAtollinstalled
ontheseserversthroughthinclientssuchasRemoteDesktoporCitrix.
ThefollowingtableliststherequiredandrecommendedhardwareandsoftwareforCitrixserversintendedforrunningwith
Atoll.
TherecommendedbandwidthbetweenCitrixserversandCitrixclientsforsatisfactoryperformanceis300 Kbpsperuser.
1.5.4 FloatingLicenceServers
Thefloatinglicencemanagementserver:
Mustbeaccessibletoalltheusercomputers/CitrixserversonthenetworkinordertoprovidelicencetokensforAtoll
sessions.
Musthaveasteadyandreliablenetworkconnectionwithusercomputers/Citrixservers.
Must have the HASP licence manager installed and running. For more information, see "Working with Floating
Licences"onpage 43.
Musthavethefloatinglicencekeypluggedin.
CanbeoneoftheCitrixservers.
1.5.5 FileServers
Fileserverscanstoregeographicdata,pathlossmatrices,Atollconfigurationandinitialisationfiles,anduserprojects.The
requiredharddiskspacehastobedeterminedfromthefilesizesofthesedata.
Therecommendedbandwidthbetweentheusercomputers/Citrixserversandthefileserversis30 Mbpsperuserperforming
calculations.ThisbandwidthisneededduringcalculationsfordataexchangebetweenAtollsessionsandthefileservers.
Geographicdataandsharedpathlossmatricesshouldbestoredonfileserverssothatthecalculationprocessesaccessing
thesedatadonotaffectAtollsusageandunnecessarilyslowdowntheGUI.
Processor XeonE3/E5familyorequivalent
RAM 8 GBormore
Storage
2x146 GB(RAID1)ormore
a
a. Tablespaceofaround100 MBper10000transmitters.
Operatingsystem
MicrosoftWindows(MicrosoftSQLServer)
Windows/UNIX/Linux/Solaris(Oracle)
Connectivity GigabitEthernetorbetter
RDBMS
Oracle10gor11g
MicrosoftSQLServer2005
Processor 1quadcorefor2to3users
RAM 4 GBperuser(minimum8GB)
Storage 2x146 GB(RAID1)
Connectivity GigabitEthernetorbetter
Operatingsystem
WindowsServer2003
WindowsServer2008SP2(64bit)
WindowsServer2008R2SP1
WindowsServer2012
Thinclientconfiguration
RemoteDesktop
CitrixXenApp6.0orlater
Virtualisation VMWareESXi4.x,5.1
28
Chapter1:GettingStarted Forsk2013
1.6 RecommendedComputerNetworkArchitecture
The following network architecture recommendations are based on benchmark tests carried out on the network of an
averagesizeoperator,witharound40to60Atolllicences.Theresultsshowtherequirementsintermsofnetwork,hardware,
andsoftware.Basedonthesefollowing,youcansetupyournetworkenvironmentforanynumberofusers.
Thebenchmarktestswerebasedonthefollowingscenario:
Numberofendusers:40
EachuserworkingonanAtolldocumentwith:
Totalnumberofsites: 1660sites(around5000cells)
Numberofsitesinthecalculationarea: 300sites(900cells)
Persectorpathlosscalculationradius: 20km(i.e.,matricesof40kmx40kmeach)
Pathlosscalculationresolution: 50m
InordertosimulatetheaverageactivityofAtollusers,eachuserisassumedtocarryouta"RoutineOperation"5timesduring
a threehour working period. The "Routine Operation" consists in modifying parameters for 40 cells in 30 minutes,
recalculatingpathlossmatricesforthese40cells,andcalculatingabestservercoverageprediction.
Althoughabestservercoveragepredictiondoesnotrequirealotofcomputerresourcesforcalculations,itrequiresAtollto
load allthepathlossmatrices in memory.Whenthepathlossmatrices arestoredon a file server, as recommended, this
operation creates a considerable data transfer activity over the network. The benchmark tests have been based on this
simulateddatatransferactivity.
ComputerNetworkArchitecture
AcentralisednetworkarchitectureisthemostwidelyusednetworkarchitecturebyAtollusers.Thefigurebelowshowsthe
recommendedarchitecturealongwithaperusernetworkbandwidthrequirementbetweennetworkcomponents.
CitrixXenAppisusedtocentralisedataandbalanceuserloadsbetweenservers.Anetworkbasedonsuchanarchitecturewith
CitrixserversmustprovidehighspeedconnectionsbetweentheCitrixserversandthefileservers.
TherequirednumberofCitrixserversdependsonthenumberofusers.Ontheaverage,oneprocessorper2to3usersis
recommended.Thus,therequirednumberofCitrixserversdependsonthenumberofprocessorsandendusers.
ComputerNetworkDimensioning
YoushouldsetupyournetworkaccordingtothenumberofAtollusers,whichisrelatedtothesizeoftheplanningproject.A
countrywideprojectwouldhavelargernetworkdimensionsthanaprojectthatcoversacity.
Figure 1.1:RecommendedNetworkArchitectureandBandwidthRequirements
Link
RecommendedBandwidth
From To
Enduser Citrixserver 300 kbpsperuser
Citrixserver Fileserver 30 Mbpsperuserperformingcalculations
AT320_AM_E2 Chapter2:InstallingAtollandComponents
29
2 InstallingAtollandComponents
ThefollowingsectionsdescribetheinstallationproceduresforAtollanditsfollowingcomponents:
DriverforFixedLicenceKeys
DistributedCalculationServer
AtollManagementConsole
Addinsandmacros
YouneedadministratorrightsforinstallingAtollanditscomponents.
2.1 InstallingAtollUsingtheSetupWizard
ToinstallAtoll:
Ifyouworkwithfixedlicences,youmustunplugthekeybeforetheinstallationandwaitfortheinstallationtofinish
beforepluggingitbackin.
Disable UAC (User Account Control) for the following versions of Microsoft Windows. If you are installing Atoll on
otherversionsofMicrosoftWindows,proceedtostep 1.
MicrosoftWindowsVista
MicrosoftWindows7
MicrosoftWindows8
MicrosoftWindowsServer2008R2
TodisableUAC:
a. GotoControlPanel >UserAccounts.
b. SelectChangeUserAccountControlsettings.TheUserAccountControlSettingsdialogueappears.
c. ChooseNevernotify.
d. ClickOK.
IfyouareinstallingAtoll64bit,makesurethattheMicrosoftAccessDatabaseEngine64bitisalreadyinstalledonthe
computer.MicrosoftAccessDatabaseEngine64bitisincludedinMicrosoftOffice64bit,andisalsoavailableasafree
redistributableMicrosoftWindowscomponentfromForskssupportwebsite.
If the computer on which you wish to install and run Atoll 64bit already has Microsoft Office installed, you must
upgradeittoMicrosoftOffice64bit(version2010SP1ornewer).ThiswillautomaticallyinstalltheMicrosoftAccess
DatabaseEngine64bit.
IfyoudonothaveMicrosoftOfficeinstalled,youcandownloadandinstalltheMicrosoftAccessDatabaseEngine64
bitredistributable(version2010SP1)neededbyAtoll64bitfromForskssupportwebsite.
1. RuntheAtollsetup.
Thesetupprogramusesawizardinterface,withastepwisedescriptionoftheinstallation.Youcan:
ClickNexttoproceedtothenextstep,
ClickBacktogobackandmodifypreviouslysetoptions,or
ClickCanceltocanceltheinstallation.
2. ClickNext.TheSelectDestinationLocationdialogueappears.
3. Selectthedestinationfolderfortheinstallation:
IfyouareinstallingAtoll32bit,thedefaultinstallationfolderis:
C:\ProgramFiles\Forsk\Atollinthe32bitversionsofMicrosoftWindows,or
C:\ProgramFiles(x86)\Forsk\Atollinthe64bitversionsofMicrosoftWindows
IfyouareinstallingAtoll64bit,thedefaultinstallationfolderis:
C:\ProgramFiles\Forsk\Atollinthe64bitversionsofMicrosoftWindows
YoucanselectadifferentlocationbyclickingBrowse.
InstallingMicrosoftOffice64bitortheMicrosoftAccessDatabaseEngine64bitrequires
uninstalling any 32bit Microsoft Office components that may be installed on the
computer.
30
Chapter2:InstallingAtollandComponents Forsk2013
4. ClickNext.TheSelectComponentsdialogueappears.
5. Selectthecomponentstoinstall.
Fullinstallation:Atollandallitscomponentswillbeinstalled.
Compactinstallation:OnlyAtollwillbeinstalled.
Custominstallation:Atollandtheselectedcomponentswillbeinstalled.
6. ClickNext.
If you selected the Distributed Calculation Server component for installation, the Logon Information dialogue
appears.
Ifyoudidnotselectthiscomponent,theSelectStartMenuFolderdialogueappears.Inwhichcase,proceedtostep 7.
a. EntertheDomainname,Username,andPassword.
Thisinformationwillbeusedtorunthedistributedcalculationserviceonthecomputer,andallowotherusersof
thedomaintoaccessthisservice.
b. ClickNext.TheSelectStartMenuFolderdialogueappears
7. SelecttheStartMenufolderforAtoll.
ThedefaultStartMenufolderforAtollisAtoll.YoucanselectadifferentfolderbyclickingBrowse.
Figure 2.1:SelectDestinationLocationDialogueforAtoll
Figure 2.2:SelectComponentsDialogue
Figure 2.3:SelectComponentsDialogue
31
8. ClickNext.TheReadytoInstalldialogueappears.
9. Reviewtheinstallationparameters.
10. ClickInstall.Atollanditsselectedcomponentsareinstalledonthecomputer.
IfyouworkwithfixedlicencesandyouinstalledtheDriverforFixedLicenceKeys,restartthecomputer.Restarting
thecomputerisnecessaryforthedrivertowork.
Ifyouworkwithfixedlicences,pluginthefixedlicencekey.
OntheversionsofMicrosoftWindowsthatsupportUAC(disabledbeforetheinstallation),runAtollonceusingan
administratoraccountandwithUACdisabledwhentheinstallationiscomplete.
Figure 2.4:SelectStartMenuFolderDialogue
Figure 2.5:ReadytoInstallDialogue
If the following files do not already exist in the installation folder, empty ones are
createdbythesetup:
[Atollinstallationfolder]\Atoll.ini
[Atollinstallationfolder]\coordsystems\Favourites.cs
[Atollinstallationfolder]\CWMeasurementsImport.ini
[Atollinstallationfolder]\DriveTestDataImport.ini
ThesefilesarenotremovedwhenAtollisuninstalled.
IfyouhaveinstalledAtollonaCitrixserver,youmustpublishittomakeitaccessible
tousers.
TorestrictaccesstotheAtollinstallationfolder,youcanassignread/writeaccessrights
tothisfoldertoadministratorsandreadonlyrightstoendusers.
32
2.2 InstallingAtollC++DevelopmentKit
ToinstalltheAtollC++developmentkit:
VisualC++mustbeinstalledbeforeinstallingtheAtollC++developmentkit.
Atollshouldbeinstalledfortestingtheaddins.
DisableUAC(UserAccountControl)forthefollowingversionsofMicrosoftWindows.IfyouareinstallingAtollC++
developmentkitonotherversionsofMicrosoftWindows,proceedtostep 1.
MicrosoftWindowsVista
MicrosoftWindows7
MicrosoftWindows8
TodisableUAC:
a. GotoControlPanel >UserAccounts.
b. SelectChangeUserAccountControlsettings.TheUserAccountControlSettingsdialogueappears.
c. ChooseNevernotify.
d. ClickOK.
1. RuntheAtollC++developmentkitsetup.
Thesetupprogramusesawizardinterface,withastepwisedescriptionoftheinstallation.Youcan,
ClickNexttoproceedtothenextstep,
ClickBacktogobackandmodifypreviouslysetoptions,or
ClickCanceltocanceltheinstallation.
2. ClickNext.TheSelectDestinationLocationdialogueappears.
3. Selectthedestinationfolderfortheinstallation.
IfyouareinstallingtheAtollC++developmentkitwithAtoll32bit,thedefaultinstallationfolderis:
C:\ProgramFiles\Forsk\Atollinthe32bitversionsofMicrosoftWindows,or
C:\ProgramFiles(x86)\Forsk\Atollinthe64bitversionsofMicrosoftWindows
IfyouareinstallingtheAtollC++developmentkitwithAtoll64bit,thedefaultinstallationfolderis:
C:\ProgramFiles\Forsk\Atollinthe64bitversionsofMicrosoftWindows
YoucanselectadifferentlocationbyclickingBrowse.
4. ClickNext.TheReadytoInstalldialogueappears.
5. Reviewtheinstallationparameters.
Figure 2.6:SelectDestinationLocationDialogue
33
6. ClickInstall.AtollC++DevelopmentKitisinstalledonthecomputer.
2.3 SetupCommandLineParameters
YoucanalsoinstallAtollanditscomponentsfromthecommandline.TheAtollsetupprogramacceptsoptionalcommandline
parameters, which can be useful to administrators, and to other programs calling the setup program. For example, when
automatingtheinstallationthroughbatchfiles.
ThefollowingcommandlineparametersareacceptedbytheAtollsetupprogram.
/SILENT,/VERYSILENT
Instructsthesetuptobesilentorverysilent.Whenthesetupissilentthewizardwindowisnotdisplayedbut the
installation progress window is. When a setup is very silent the installation progress window is not displayed.
Everything else is normal. So, for example, error messages during installation are displayed, and also the startup
prompt.
Ifthesetupissilentanditrequirestorestartthecomputer,butthe/NORESTARToptionisnotused(seebelow),itwill
displayaRebootnow?messagebox.Ifitisverysilentitwillrebootwithoutasking.
/NOCANCEL
Prevents the user from cancelling the installation by disabling the Cancel button and ignoring clicks on the Close
button.Usefulalongwith/SILENTor/VERYSILENT.
/NORESTART
Instructsthesetupnottorestartthecomputerevenifnecessary.
/SAVEINF="filename"
Instructsthesetuptosaveinstallationsettingstothespecifiedfile.Usequotesifthefilenamecontainsspaces.
/LOADINF="filename"
Instructsthesetuptoloadthesettingsfromthespecifiedfileafterhavingcheckedthecommandline.Thisfilecanbe
preparedusingthe/SAVEINFcommandasexplainedabove.Usequotesifthefilenamecontainsspaces.
/DIR="x:\foldername"
OverridesthedefaultinstallationfolderdisplayedontheSelectDestinationLocationwizardpage.Usequotesifthe
foldernamecontainsspaces.
/GROUP="foldername"
OverridesthedefaultstartmenufoldernamedisplayedontheSelectStartMenuFolderwizardpage.Usequotesif
thefoldernamecontainsspaces.
/LOG="filename"
Causesthesetuptocreatealogfilelistingfileinstallationandactionstakenduringtheinstallationprocess.Thiscan
behelpfulfortroubleshooting.Forexample,ifyoususpectafileisnotbeinginstalledasitshouldbe,thelogfilewill
tell you if the file was actually skipped and why. Use quotes if the filename contains spaces. If the file cannot be
created,thesetupwillabortwithanerrormessage.
/SVRACCOUNT="domainname\username"
Thedomainnameandusernameforinstallingthedistributedcalculationserver.
/SVRPASSWD=password
Figure 2.7:ReadytoInstallDialogue
34
Passwordforinstallingthedistributedcalculationserver.
/TYPE=typename
Overridesthedefaultsetuptype.Thesetuptypenamesare:
Fullinstallation:full
Compactinstallation:compact
Custominstallation:custom
Forfullandcompactsetuptypes,the/COMPONENTSparametersareignored.
/COMPONENTS="commaseparatedlistofcomponentnames"
Overrides the default component settings. Using this command line parameter causes the setup to automatically
selectacustominstallationtype.Onlythespecifiedcomponentswillbeselected.Componentnamesare:
Atoll:Atoll
ExporttoGoogleEarthaddin:"Addins\GoogleEarth"
BestSignalExportaddin:"Addins\SignalsExport"
Driverforfixedlicencekeys:RainbowDongle
Distributedcalculationserver:Atoll_Server
AtollManagementConsole:AMC
Example:ToinstallAtoll,thedistributedcalculationserver,andthedriverforfixedlicencekeys:
/COMPONENTS="Atoll,Atoll_Server,RainbowDongle"
2.4 InstallingandUninstallingAddins
AddinsarecompiledDLLfileswhichcanbeplacedinanyfolderandactivatedbyregisteringthemintheWindowsregistry.
Addins developed by Forsk have dedicated setup programs, which place the addins DLLs in appropriate locations and
registerthem.Thesetupproceduresinthesecasesaredescribedintheaddinsdocumentation.
ToinstallanaddinbyregisteringitsDLL:
1. CloseAtoll.
2. RightclicktheDLLfileinWindowsExplorer.Thecontextmenuappears.
3. SelectRegister.TheDLLisregistered.
YoucanalsoregistertheDLLfromthecommandpromptusingregsrv32.exe.Onceanaddinisinstalled,Atollloadsit
inthelistofavailableaddins.ItispossibletoaccessandworkwithaddinsandmacroswhenthereisnoATLfileopen
inAtoll.
ToactivateordeactivateaninstalledaddininAtoll:
1. InAtoll,selectTools >AddinsandMacros.TheAddinsandMacrosdialogueappears(seeFigure 2.8onpage 35).
2. Selecttheaddinscheckboxtoactivateit,orclearthecheckboxtodeactivateit.
InstalledaddinsareautomaticallyloadedbyAtollandappearintheAddinsandMacros
dialogue (Figure 2.8 on page 35). If you wish that a certain addin not be loaded, and
hencebeunavailableforactivationinthisdialogue,youcandosobyaddinganoptionin
theAtoll.inifile.Formoreinformation,see"Loading,Activating,andSettingAddinsas
Visible"onpage 187.
35
AddinsinstalledbytheAtollsetupareuninstalledwhenAtollisuninstalled.Touninstallanyotheraddinbyunregisteringits
DLL:
1. CloseAtoll.
2. RightclicktheDLLfileinWindowsExplorer.Thecontextmenuappears.
3. SelectUnregister.TheDLLisunregistered.
YoucanalsounregistertheDLLfromthecommandpromptusingregsrv32.exe/u.
2.5 InstallingandUninstallingMacros
AtollcanloadandexecutemacroswritteninVBScript.
ToloadamacroinAtoll:
2. ClickAdd.TheOpendialogueappears.
3. Selectthemacrofileyouwishtoload.
4. ClickOpen.ThemacroisaddedtoAtoll.
Lists of macros available in Atoll can be stored in user configuration files. Macros listed in the user configuration files are
addedtoAtollwhentheuserconfigurationfilesareloaded.Formoreinformation,referto"ContentsofUserConfiguration
Files"onpage 148.
ToremoveamacrofromAtoll:
2. Inthelistofavailablemacros,selectthemacroyouwishtoremove.
3. ClickDelete.
OthercommandsavailableintheAddinsandMacrosdialogueare:
Edit:Edittheselectedmacrointhedefaulttexteditor.
Run:Executetheselectedmacro.
Icon:Assignanicontotheselectedmacro.IconsassignedtomacrosappearintheMacrostoolbar.
Refresh:Toreloadtheselectedmacrofile.
Figure 2.8:AddinsandMacrosDialogue
Todisablethemacrotimeout,setitto0.
Ifyouleavethetimeoutempty,thedefaultvalue(24days)isused.
36
2.6 AtollCommandLineParameters
Atollsupportsthefollowingoptionalcommandlineparameters:
log"logfilename"
Instructs Atoll to create a log file containing all the messages listed in the Events tab. This can be helpful for
troubleshooting."logfilename"isthefullpathandfilenameofthelogfileinsidequotes.
Ini"inifilename"
InstructsAtolltoloadthespecifiedinitialisationfilewhenrun.Thiscanbeusedtooverridethedefaultloadingofthe
Atoll.inifilelocatedintheAtollinstallationfolder."inifilename"isthefullpathandfilenameoftheinitialisationfile
insidequotes.
Cfg"cfgfilename"
InstructsAtolltoloadthespecifieduserconfigurationfilewhenrun.Thiscanbeusedtooverridethedefaultloading
of the Atoll.cfg file located in the Atoll installation folder. "cfgfilename" is the full path and file name of the user
configurationfileinsidequotes.
Providerprovidername
InstructsAtolltousethementionedprovidernametoaccessthedatabaseserver:
DataSourceserver
InstructsAtolltoaccessthementioneddatabaseserverusingthegivenprovider.
UserIdusername
InstructsAtolltoaccessthementionedOracledatabaseserverusingthementionedusername.
Passwordpassword
InstructsAtolltoaccessthementionedOracledatabaseserverusingthementionedpassword.
Projectprojectaccount
InstructsAtolltoaccessthementionedOracledatabaseserverusingthementionedprojectaccount.
2.7 TroubleshootingandOtherInformation
Readandfollowcarefullytheinstructionsin"InstallingAtollUsingtheSetupWizard"onpage 29forasmoothinstallation.
Ifproblemsoccurandyouareunabletoresolvethemwiththehelpofthefollowinginformation,contactForskscustomer
support.
MicrosoftWindowsUpdates
ItisrecommendedtoinstallnewWindowsupdates.However,itisalsorecommendedtogothroughthedescription
ofeachupdatepatchtoseewhetheritmighthaveanegativeeffectonyoursystemornetwork.Payspecialattention
toupdatesandpatchesrelatedtonetworking.
ItisalsorecommendedtokeeptheWindowsupdatesuninstallfolders,named"$NtUninstall...",undertheWindows
folder,incaseyouhavetouninstallacertainpatch.Someoftheupdatepatchesmightrequireuninstallfoldersof
olderpatchestobeavailablefortheirowninstallation.
At ol l . exe [ - l og "l ogf i l ename" ] [ - I ni " i ni f i l ename"] [ - Cf g " cf gf i l ename" ]
[ - Pr ovi der pr ovi der name - User I d user name - Passwor d passwor d
- Dat aSour ce ser ver - Pr oj ect pr oj ect account ]
Provider Atollversion providername
MicrosoftAccess
32bit
64bit
Microsoft.Jet.OLEDB.4.0
Microsoft.ACE.OLEDB.12.0
SQLServer 32/64bit SQLOLEDB
Oracle(Oracledriver) 32/64bit OraOLEDB.Oracle
ThekeywordsProvider,Password,UserId,DataSource,andProjectarecasesensitive.
37
Fixedlicencekeys
Fixedlicencekeyscannotbeusedwith"Server"typeoperatingsystems.Therefore,youshouldnotinstallthedriver
forfixedlicencekeyson:
Thecurrentversionofthedriverforfixedlicencekeys(SentinelSuperProdriver)installedwithAtollisthe7.6.3.
IfAtollisunabletoaccessthefixedlicencekey,evenafteracleaninstallation,tryreinstallingtheSentinelSuperPro
drivermanually.Thedriverssetupprogram(SPI763.exe)iscopiedbythesetuptotheSentinelsubfolderintheAtoll
installationfolderifyouselectedtheDriverforFixedLicenceKeyscomponentduringtheinstallation.Youcanalso
downloadthedriverfromhttp://www.safenetinc.com.
Restartthecomputerwhenaskedbythesetup.Restartingthecomputerisnecessaryforthedriverforfixedlicence
keystowork.
Ifyougetaprotectionkeyerrormessage,verifythatthefixedlicencekeyiscorrectlypluggedinandthatthelicence
hasnotexpired.
Incasethefixedorthefloatinglicencekeybecomesunavailable,Atollwillasktheuserscurrentlyaccessingthekey
tosavetheiropendocumentsbeforeAtollcloses.Ifthekeybecomesavailableagain,Atollwilllettheuserscontinue
working.
Donotchangethecomputersdate.
Citrix
IfyouhaveinstalledAtollonaCitrixXenAppserver,youmustpublishittomakeitavailabletotheusers.
Atollversionandbuild
You can get information about Atoll (version, build, type of licence and remaining time before expiration, etc.) by
selectingHelp >AboutAtollinthemainmenuinAtoll.
Atollfileversionandtechnology
ATLfilepropertiesstoretheAtollversionandbuildnumberinwhichthefilewaslastsaved,andthetechnologiescontained
inthefile.ToaccesstheATLfileproperties:
1. RightclicktheATLfileintheWindowsExplorer.Thecontextmenuappears.
2. SelectPropertiesfromthecontextmenu.Thefilepropertiesdialogueappears.
3. InWindowsXP,clicktheSummarytabandthentheAdvancedbutton.
InWindowsVista,7and8,clicktheDetailstab.
TheAtollversionandbuildnumberinwhichtheATLfilewaslastsavedarestoredintheRevisionnumberproperty.
ThetechnologiesofthedocumentarelistedintheCategoryproperty.
Supportwebsite
YoucandownloadthelatestversionsofAtollfromtheForskssupportwebsitebylogginginwiththeusernameand
passwordprovidedtoyoubyForsk.
TheAtollUserManualandotherdocumentsareavailableontheinstallationCD.Moredocumentsareavailablefor
downloadontheForskssupportwebsite.
Thesupportwebsitealsooffersyou:
Sampleaddins,macros,andscripts
Samplegeographicdata,
Listoffixedissuesintheversionsavailablefordownload,
Listofknownissues,andpossibleworkarounds,
Scheduleforupcomingversions,
Listofholidays.
Forfullcontactdetailsforcustomersupport,seepage 3.
Acknowledgement
AtollusesInnoSetupforinstallation.Formoreinformation,seehttp://www.jrsoftware.org/isinfo.php.
UninstallingAtollanditscomponents
ItisrecommendedtouninstallAtollanditscomponentsthroughtheControlPanel.
TouninstallAtoll:
38
InWindowsXPorWindowsServer2003:
a. GotoControlPanel >AddorRemovePrograms.
b. IntheInstall/Uninstalltab,selectAtollfromthelistofinstalledprograms.
c. ClicktheRemovebutton.
InWindowsVista,Windows7and8,orWindowsServer2008and2012:
a. GotoControlPanel >ProgramsandFeatures.
b. IntheUninstallorchangeaprogramwindow,rightclickAtoll.Thecontextmenuappears.
c. SelectUninstall.
AT320_AM_E2 Chapter3:SettingUpDistributedCalculationServer
39
3 SettingUpDistributedCalculationServer
Distributedcalculationenablesyoutodistributethecalculationofpathlossmatricesovermanycomputersinanetwork.The
distributedcalculationserviceisanoptionalservicethatcanbeinstalledatthesametimeasAtoll.Formoreinformationon
installation,see"InstallingAtollandComponents"onpage 29.
Acomputeronwhichthedistributedcalculationserviceisinstalledandrunningiscalledadistributedcalculationserver.This
computer,thedistributedcalculationserver,isvisibletoalltheothercomputersonthenetworkthroughAtoll.Youcanset
upasmanydistributedcalculationserversasrequired.
Thedistributedcalculationservicedoesnothaveauserinterface,andhencehaslowermemoryrequirementsthanAtoll.The
distributed calculation server uses the standard Atoll API to exchange data with the path loss calculator and Atoll. The
distributedcalculationservicesupportsdualprocessorconfigurationsanduptofourthreads.
AnyversionofAtollcanworkwiththedistributedcalculationserviceofthesameorlaterversion.Consequently,anyversion
ofthedistributedcalculationservicecanworkwiththesameorpreviousversionsofAtoll(versionsstillmaintainedbyForsk).
FordistributedcalculationserveroptionsavailablethroughtheAtoll.inifile,see"DistributedCalculationServerOptions"on
page 191.
3.1 SettingUpServers
When installed, the distributed calculation service automatically starts and remains available as long as the computer is
turnedon.Theservicedoesnotrequireanyactiveusersessiononthecomputer,i.e.,theservicekeepsrunningevenwhen
thereisnouserloggedon.Theservicesexecutable(AtollSvr.exe)isinstalledintheAtollinstallationfolder.
The Atoll distributed calculation service is listed as Atoll Server in the Services management console under Control
Panel >AdministrativeTools.
Duringcalculations,thedistributedcalculationserversrequireaccesstogeographicdataforcalculatingthepathlossmatrices.
Thedistributedcalculationservicemustberunwithauseraccountthathassufficientprivilegestoaccesstherequireddata.
Tomodifytheuseraccountthroughwhichthedistributedcalculationserviceisrunonacomputer:
1. Logontothecomputerwithauseraccountwithadministratorrights.
2. GotoControlPanel >AdministrativeTools >Services.
3. Inthelistofservices,rightclicktheAtollServerservice.Thecontextmenuappears.
4. SelectProperties.TheAtollServerPropertiesdialogueappears.
5. OntheLogOntab,entertheusernameandpasswordfortheuseraccountthroughwhichyouwishtorunthisservice.
6. ClickOK.
Figure 3.1:AtollServerProperties
40
Chapter3:SettingUpDistributedCalculationServer Forsk2013
RunningMoreThanOneInstanceoftheService
Bydefault,asingleinstanceofthedistributedcalculationserviceisrun.Youcan,however,runupto9additionaldistributed
calculationservices(atotalof10includingthefirstone)manually.
Tomanuallyrunadditionaldistributedcalculationservices,doubleclicktheAtollSvr.exefilelocatedintheAtollinstallation
folder.Foreachnewinstanceoftheservice,acommandpromptwindowopens.Tostopanadditional,manuallyrunservice,
closethecommandpromptwindowcorrespondingtoit.
StoppingandStartingtheDistributedCalculationServer
Tostopthedistributedcalculationservice:
2. GotoControlPanel >AdministrativeTools >Services.
3. Inthelistofservices,rightclicktheAtollServerservice,andselectStoporStartfromthecontextmenu.
UninstallingtheDistributedCalculationServer
Touninstallthedistributedcalculationservice:
2. Stopthedistributedcalculationservice:
a. GotoControlPanel >AdministrativeTools >Services.
b. Inthelistofservices,rightclicktheAtollServerservice,andselectStopfromthecontextmenu.
3. Unregistertheservice:
a. SelectStart >Run.TheRundialogueappears.
b. Type "<Atoll Installation Path>\AtollSvr.exe /UnregServer". <Atoll Installation Path> is the path to the Atoll
installationfolder.
c. ClickRun.
Thiswillremovethedistributedcalculationservicefromthecomputer.
3.2 SettingUpAtolltoAccesstheServers
ToactivatedistributedcalculationsinAtoll:
1. SelectTools >DistributedCalculationsfromthemainmenu.TheDistributedCalculationsdialogueappears.
2. SelecttheActivatedistributedcalculationcheckbox.
a. Tousealltheavailabledistributedcalculationservers,clickAll.
b. Touseselecteddistributedcalculationserversonly,clickDetect.
Atoll searches for the available distributed calculation servers on the network. The available distributed
calculationserversarelistedintheeditbox.
c. Removethedistributedcalculationserversthatyoudonotwishtoinclude.
3. ClickOK.Theselecteddistributedcalculationserversarenowavailableforpathlosscalculations.
3.3 DistributedCalculationProcess
Oncedistributedcalculationshavebeensetuponthecalculationserverandontheusersides,thepathlosscalculationsrun
bytheuseraredistributedovertheavailablecalculationservers.Thecalculationprocessisasfollows:
1. Atolluserrunspathlosscalculations.
2. Atollsendstheneedednetworkdatatotheavailablecalculationservers.
3. EitherAtollsendstheneededgeographicdatatothecalculationserversortheserversaccessthegeographicdataon
afileserver.
Atollcandetectatotalof10instancesofthedistributedcalculationservice.Ifyourun
morethan9additionaldistributedcalculationservices,theywillnotbedetectedbyAtoll
andcancausetheoperatingsystemtostopresponding.
AT320_AM_E2 Chapter3:SettingUpDistributedCalculationServer
41
4. Distributedcalculationserverscalculatethepathlossmatricesonebyone.
Distributed calculation servers that have spare threads start the calculations using these threads. If no thread is
available,therequestisplacedinaqueuetowaitforathreadtobecomeavailable.
5. For each calculated path loss matrix, a confirmation is sent to the Atoll session. Any error or warning messages
generatedarepassedbacktotheAtollsessionanddisplayedintheEventViewer.
If an error occurs on any of the distributed calculation servers, Atoll transfers the calculations back to the local
computer.However,toavoidmemorysaturation,Atollusesonethreadonthelocalcomputerandcalculatesthepath
lossmatricesonebyone.Itdoesnotattemptcreatingmorethanonethread.
6. Inordertoreducetheamountofdataflowinthenetwork,distributedcalculationserverssendtheresultsdirectlyto
thestoragelocation(whichcanalsobeonafileserver,notnecessarilyontheuserscomputerthatrequestedthe
calculations).
7. Atollusercanthenrequestthepathlossmatricesfromthefileserveriftheyareneededforcoveragepredictions.
42
Chapter3:SettingUpDistributedCalculationServer Forsk2013
AT320_AM_E2 Chapter4:ManagingLicences
43
4 ManagingLicences
Atollcanbeusedon:
ComputerswithfixedlicencekeyspluggedintoUSBslotsonthecomputersthemselves,or
ComputersconnectedtoalicenceserverwithafloatinglicencekeypluggedintoaUSBportontheserver.
ThedriverforfixedlicencekeyscanbeinstalledatthesametimeasAtoll.Formoreinformation,see"InstallingAtolland
Components"onpage 29.
ThesoftwareformanagingfloatinglicencekeysmustbeinstalledonaserveraccessibletothecomputersonwhichAtollis
goingtobeused.Formoreinformation,see"WorkingwithFloatingLicences"onpage 43.
ForinformationontheAtolllicencemanagementutility,see"UsingtheAtollLicenceManager"onpage 45.
4.1 WorkingwithFloatingLicences
AfloatinglicencekeycanbeusedwhenusersworkwithAtolloncomputersonanetwork.Inafloatinglicenceenvironment,
licencekeysarenotpluggedintoeachindividualuserscomputer,butasharedlicencekeywithmultipletokensisavailable
tousersthroughaserver.
A floating licence server is a computer, accessible to other computers on a network, on which the floating licence
managementsoftwarehasbeeninstalledandafloatinglicencekeypluggedin.Thefloatinglicenceservercanbeoneofthe
computersonwhichAtollisinstalled.
ThefloatinglicencemanagementsoftwareandthefloatinglicencekeycontrolthenumberofpotentialAtollusers.Afloating
licencesystemhasadefinedmaximumnumberoftokensavailable.ThisisthemaximumnumberofcomputersonwhichAtoll
canberunsimultaneously.EachcomputerthatrunsAtolltakesonetokenfromthefloatinglicencekey,evenifmorethan
oneAtollsessionisrunonthesamecomputer.ThetokenisreleasedandmadeavailableforotheruserswhenalltheAtoll
sessionsonthecomputerareclosed.
If a computer is connected to a floating licence server and also has a fixed licence key plugged in, the fixed licence key is
accessedfirst.
Atoll uses a 3rdparty floating licence management system called HASP from Aladdin. The floating licence management
systemincludes:
HASPfloatinglicencekey:Hardwarekeyprogrammedwiththenumbersoftokensavailableforeachmodule.
HASPlicencemanager:InterfacebetweenAtollandthefloatinglicencekey.
HASPdevicedriver:InterfacebetweentheHASPlicencemanagerandfloatinglicencekey.
HASPmonitor:Enablesyoutocheckthenumberofusedandavailabletokens.
nhsrv.inifile:Installedonthefloatinglicenceservertoenablecomputerstousetokens.
nethasp.inifile:Installedonthecomputerstofacilitateaccesstothefloatinglicenceserver.
nhsrv.iniandnethasp.inifilesareusediftheyexist.Defaultsettingsareusedotherwise.
4.1.1 HASPLicenceManagerandDeviceDriver
TheHASPlicencemanagercontrolstheallocationandretrievaloflicencetokensavailableonafloatinglicencekey.Itusesthe
HASPdevicedriverforcommunicatingwiththefloatinglicencekey.
TheHASPlicencemanagercanbeinstalledonacomputerrunningWindows2000orlater.AUSBportmustbeavailableon
theserverforplugginginthefloatinglicencekey.
YoucandownloadtheHASPlicencemanager,theHASPdevicedriver,andtheHASP
monitor from http://www3.safenetinc.com/support/hasp/hasp4/enduser.aspx.
Newerversionscanbeavailablefordownloadatthewebsitethanthoseprovidedon
theAtollinstallationdisk.
When downloading setup files from the Aladdin website, remember to download
setupfilesforHASP4,notHASPHL.
Thecorrect(recommended)versionofthedevicedriversetuptodownloadistheone
thatworkswith"HASP4APIv8.xorEnvelope12.x".
HASPhardwarekeyissupportedbyWindows2000ServerandWindowsServer2003
withHASPLicenceManager8.20orabove.
44
Chapter4:ManagingLicences Forsk2013
InstallationandStartup
TheHASPlicencemanager,theHASPdevicedriver,andthefloatinglicencekeymustbeinstalledontheserver.
ThefollowingoptionsshouldbeselectedwheninstallingtheHASPlicencemanager:
Choose"Service"asthetypeofinstallation.
Thismeansthatthelicencemanagerwillrunasaservice,andwillbeaccessibleevenifthereisnouserloggedon.You
canchoosetoinstallitasanapplication,butinthatcaseyouwillhavetorunthelicencemanagermanuallyeverytime
youlogontotheserverandyouwillhavetostayloggedonforthelicenceservertobeavailabletotheAtollusers.
Acceptautomaticdriverinstallation.
ThiswillinstalltheHASPdevicedriverrequiredbytheHASPlicencemanager.
Oncethedevicedriverissuccessfullyinstalled,pluginthefloatinglicencekey.
Onceinstalled,starttheHASPlicencemanager.
If youselected "Service" as thetype of installation, the licence manager will start in service mode. An icon willbe
availableinthetaskbar.Youcanaccessthenetworkcommunicationprotocolsbydoubleclickingthisicon.
TheHASPlicencemanagerwindowdisplaysalistofsupportedprotocolswhichcanbemodifiedthroughtheLoadand
Removemenus.Closingthiswindowdoesnotstopthelicencemanager.Theiconremainsavailableinthetaskbaras
longastheserviceisrunning.
TostoptheHASPlicencemanager:
a. GotoControlPanel >AdministrativeTools >Services.
b. Inthelistofservices,rightclicktheHASPLoaderservice,andselectStopfromthecontextmenu.
You can also copy (from the installation CD) or create the nhsrv.ini file on the floating licence server (in the HASP
licencemanagerinstallationfolder).TheHASPlicencemanagersettingsinthisfilecanbemodifiedaccordingtothe
yourrequirements.Formoreinformationonthecontentsofthenhsrv.inifile,see"nhsrv.iniFile"onpage 44.
HASPMonitor(Optional)
YoucaninstalltheHASPmonitoronthefloatinglicenceserver,orononeorseveralothercomputers,tomonitorthetoken
allocationandretrievalactivity.TheHASPmonitordisplaysthelistofcomputersusingtokensavailableonthefloatinglicence
key.
4.1.2 nhsrv.iniFile
Thenhsrv.inifilecanbeusedtodefinealistofcomputersallowedtorequesttokensfromthefloatinglicenceserver.
FileLocation
Ifused,thenhsrv.inifilemustbelocatedinafolderlistedinthesystempathvariable,suchastheWindowsfolder(usually
C:\Windows).
Donotplugthefloatinglicencekeyintheserverbeforeinstallingthedevicedrivers.
WaitfortheHASPlicencemanagersetuptoindicatewhentopluginthekey.
Ifthefloatinglicenceserverisprotectedbyafirewall,port475mustbeopenwhen
usingtheUDPorTCPprotocols.
Once the HASP licence manager has been installed, the floating licence key must
alwaysremainpluggedin.
In case the fixed or the floating licence key becomes unavailable, Atoll will ask the
userscurrentlyaccessingthekeytosavetheiropendocumentsbeforeAtollcloses.If
thekeybecomesavailableagain,Atollwilllettheuserscontinueworking.
Thefloatinglicencekeycanbecomeunavailableandakeyprotectionerrormessage
appearsinAtollifthelicencemanagementserverisheavilyloaded.Checkifthereis
anyapplicationrunningontheserverthatmightbecausingtheproblem.Ifthisisthe
case,removeanysuchapplicationfrommemory.Ifthisisnotpossible,trychanging
thelatencyassociatedtotheHASPlicencemanagerinaccessingthekey.
TorestrictaccesstotheHASPlicencemanagerinstallationfolder,youcanassignread/
writeaccessrightstothisfoldertoadministratorsandreadonlyrightstoendusers.
45
FileContents
Thefollowingisasampleofthenhsrv.inifilethatshowshowtosetalistofcomputersallowedaccesstothefloatinglicence
server.CompletesyntaxcanbefoundontheHASPinstallationCDorontheAladdinwebsite.
4.1.3 nethasp.iniFile
Thenethasp.inifileenablesAtolltolocatethefloatinglicenceserverquickly.Withoutthenethasp.inifile,findingthefloating
licenceserveronthenetworkcantakealongtime.
FileLocation
Thenethasp.inifileshouldbelocatedintheAtollinstallationfolder(recommended).If,forsomereason,itisnotpossibleto
storethefileintheAtollinstallationfolder,itcanbestoredin(intheorderinwhichitissearchedforbyAtoll):
TheWindowsfolder(usuallyC:\Windows)
Afolderlistedinthesystempathvariable
Anethasp.inifilelocatedintheAtollinstallationfolderhaspriorityoveranynethasp.inifilelocatedintheWindowsfolder,
whichinturnhaspriorityoveranynethasp.inifilelocatedinafolderlistedinthesystempathvariable.
Storingthenethasp.inifileintheWindowsfolderinsteadoftheAtollinstallationfoldercanbeusefulifyouhavemorethan
oneversionofAtollinstalled,andyouwishtoaccessthesamefloatinglicenceserver.Thisavoidsmakingacopyofthefilein
eachAtollinstallationfolder.
FileContents
Thefollowingisasampleofthenethasp.inifilewiththeminimumrequiredinformation.Completesyntaxcanbefoundon
theHASPinstallationCDorontheAladdinwebsite.
4.2 UsingtheAtollLicenceManager
AtollLicenceManagerenablesyoutomonitor,troubleshoot,andupdatelicencekeys.Youmustnotusethelicencemanager
without full instructions and details from Forsk customer support. Modifying parameters in the licence manager without
properinputfromForskcustomersupportcandamageyourfixedorfloatinglicencesandblockaccessofAtolluserstothe
licences.
[ NHS_SERVER]
; NHS_I P_LI MI T = [ , , , . . . ]
; Speci f i es t he I P addr esses of comput er s ser ved by t he l i cence manager
; Exampl e: 10. 1. 1. 1, 10. 1. 1. *
; For use, r emove t he semi - col on bef or e NHS_I P_LI MI T
[ NH_COMMON]
NH_I PX = Di sabl ed ; Use the IPX protocol - Enabled or Disabled
NH_NETBI OS = Di sabl ed ; Use the NETBIOS protocol - Enabled or Disabled
NH_TCPI P = Enabl ed ; Use the TCP/IP protocol - Enabled or Disabled
[ NH_TCPI P]
NH_SERVER_ADDR = 3CT000J ; (
a
) IP address of the floating licence server
a. Itisrecommendedtoentertheservernamewithinthedomain.
Forexample,forservername.domainname.com,enterservernameonly.
Onlyoneservernameissupportedinthenethasp.inifile.
NH_TCPI P_METHOD = UDP ; (
b
) Send TCP or UDP packets
b. ForHASPLicenceManager8.20andlater,AladdinrecommendsUDPasthedefaultTCP/IPmethod.
NH_USE_BROADCAST = Di sabl ed ; Use TCP/IP broadcast - Enabled or Disabled
RemovetheNH_SESSIONandNH_SEND_RCVentriesfromthenethasp.inifileifthese
exist.
Thesefieldsdefinethetimeoutdelaysdependingtothenetwork.Theycanbeuseful
inslownetworksandshouldbesetonlyifrequired.
46
4.2.1 LicenceManagerInterface
ToopentheAtolllicencemanager:
1. CloseAtoll.
2. GototheAtollinstallationfolder.
3. RunLic.exe.Thelicencemanageropens(seeFigure 4.1onpage 46).
4. UnderAvailablelicences,selectalicencekeyinordertodisplaytheinformationrelatedtoit.
UnderSelectedkeythefollowinginformationisavailablefortheselectedkey:
Number: Unique key number given by the key provider. This number must be communicated to Forsk, when
requested,forreprogrammingthelicencekey.
Type:Thetypeofkey,FixedlicenceorFloatinglicence.
Reference:UniquefloatinglicencekeyreferenceprovidedbyForsk.ThisnumbermustbecommunicatedtoForsk,
whenrequested,forreprogrammingthelicencekey.Thisreferenceisalsoprintedonthestickeronthekey.
Location(server):Nameofthefloatinglicencemanagementserveronwhichthefloatinglicencekeyisplugged.
UnderModulesandlicences,alltheAtollmodulesavailableontheselectedkeyarelistedalongwiththenumbers
oflicencetokensofeach.
UnderNumberoflicences,theModifybuttonsarereservedforForskuseonly.
UnderDatesanddurations,thefollowingdatesanddurationsareavailable:
Licencestart
Licenceend
Durationofvalidity
Timebomb
Figure 4.1:AtollLicenceManager
TheClearallbuttonisreservedforForskuseonly.
47
ApurchasedAtolllicencecorrespondstoaparticularAtollversion.Thereisnotimelimitonusingthisversion.
However,yearlymaintenancemustbepurchasedinordertoaccessnewerversionswithupdatesandbugfixes.
Whenyoupurchasemaintenance,Forskreprogramsyourlicencekeystoallowaccesstonewversions.
TheTimebombdateistheenddateformaintenance.Whenthetimebombdatepasses,thelicencekeystops
working. You can then choose to either purchase maintenance for the next year, and benefit from the new
featuresandbugfixes,orhavethelicencekeyreprogrammedwithoutmaintenanceforthenextyear,inwhich
caseuserscancontinueworkingwiththeexistingversion.
Atoll can inform you about the approaching time bomb date 30 days in advance. This alert can be configured
throughtheAtoll.inifile.
UnderProfilesignature,thePID(profilesignatureorID)istheencrypteddescriptionoftheuserrightsavailable
onthekey.EachkeyhasauniquePID.
UnderCurrentprofilesummary,alloftheaboveinformationissummarised.
4.2.2 UpdatingLicenceKeys
AtolllicencemanagerenablesadministratorstoupdatelicencekeysbyloadingnewkeyprogrammingdatafromALICfiles
providedbyForsk.Toupdatealicencekey,youmusthavetheALICfilesentbyForsk.
Toupdatealicencekey:
1. CloseallAtollsessions.
Atollreadslicenceinformationfromthekeyatthestartofeachsession.Thisinformationiskeptinmemoryaslong
asasessionisrunning.Ifalicencekeyisupdatedwhileasessionisstillrunning,therunningsessionwillnotreadthe
updatedlicenceinformationfromthekeyandwillexpireaccordingtotheoldlicenceinformation.
2. GototheAtollinstallationfolder.
3. RunLic.exe.Thelicencemanageropens(seeFigure 4.1onpage 46).
4. UnderAvailablelicences,selectthekeytoupdate.Ifthekeydoesnotappearintheavailablelicenceslist,checkthat
itispluggedintoyourcomputer.
5. UnderKeyprogramming,clickLoad.TheOpendialogueappears.
6. SelecttheALICfileprovidedbyForsk.
7. ClickOpen.Thekeyisupdated.
AtollAtollAtollAtollAtoll
Do not attempt to modify the Time bomb settings on the fixed licence key. Contact
Forskscustomersupport.
Donotchangethecomputersdate.
Do not attempt to reprogram a licence key without full information and support from
Forskcustomersupport.
48
AT320_AM_E2 Chapter5:ManagingDatabases
49
5 ManagingDatabases
In Atoll, you can work with standalone documents, i.e., documents without any backend database, or with documents
connectedtodatabases.Standalonedocumentsaremoreportable,howeverabackenddatabaseisrequiredwhenworking
inamultiuserenvironment.Inmultiuserenvironments,severalusersworkonthesameprojectandacentraldatastorage
isnecessaryforkeepingthedatamodificationsmadebyateamofradioplanningandoptimisationengineers.
Atollenablesyoucreatedatabases,upgradethemtonewerversions,archiveandrefreshdatawithdatabases,manageand
resolvedataconflicts,andcreateandworkwithmultileveldatabases.
Adatabaseservercanstoreoneormoredatabases.Forexample,aGSM,aUMTS,andamicrowavelinksdatabasecanbe
storedonthesamedatabaseserverusingthesameRDBMS(Oracle,forexample).
Inthischapter,thefollowingareexplained:
"AtollDatabaseTemplates"onpage 49
"CustomisingAtollDatabaseStructures"onpage 50
"AtollManagementConsole"onpage 52
"CreatingNewDatabases"onpage 53
"UpgradingExistingDatabases"onpage 55
"WorkingWithaMultilevelDatabases"onpage 59
"SettingDatabaseAccessPrivileges"onpage 63
"ManagingDataModificationsHistory"onpage 64
5.1 AtollDatabaseTemplates
AllthetechnologymodulesavailableinAtoll(GSM,UMTS,LTE,CDMA2000,TDSCDMA,WiMAX,WiFi,andMicrowaveRadio
Links)arebasedondatabasetemplates.ThesetemplatesareusedforcreatingAtolldocumentswiththeappropriatedata
structurerequiredforplanningforanytechnology.Databases(usingRDBMS)canthenbecreatedfromanyAtolldocument.
ThesedatabasesarehencealsobasedonthedatastructuredefinedbytheAtolldatabasetemplates.
Ineachnewmajorrelease,databasetemplatesundergomodificationsrequiredtosupportnewfeatures.Thesemodifications
areappliedtoexistingAtolldocumentsanddatabasesbyAtollandtheAtollManagementConsole,respectively.Itisalso
possible to upgrade an existing database manually, but due to the complex nature of the upgrade process, it is highly
recommendedtousetheAtollManagementConsoleforupgradingexistingdatabases.
EachdatabasetemplateisanMSAccessMDBfilelocatedinthetemplatesfolderintheAtollinstallationfolder.Forthelistof
tablesandfields,andtheirrelationships,ineachdatabasetemplate,see:
"GSMGPRSEDGEDataStructure"onpage 249
"UMTSHSPADataStructure"onpage 281
"LTEDataStructure"onpage 341
"3GPPMultiRATDataStructure"onpage 371
"CDMA2000DataStructure"onpage 313
"TDSCDMADataStructure"onpage 407
"WiMAXandWiFiDataStructure"onpage 439
"MicrowaveLinksDataStructure"onpage 469.
DonotskipamajorversionofAtoll.Forexample,ifyouarecurrentlyusingAtoll3.0.x,you
should first upgrade the database to Atoll 3.1.x before upgrading to Atoll 3.2.x.
Upgradingyourdatabasewillbesimplerifyoudonotskipamajorversion.Ifyouskipor
haveskippedanintermediatemajorversion,youmustupgradeyourdatabasetwicein
ordertomakeitcompatiblewiththenewversion.
DatabasetemplatefilesmustnotbemodifiedwithoutconsultingForskcustomersupport.
The relationships in the database schema figures are represented by arrows. These
unidirectionalarrowsshouldbereadas: =
Inthetables,primarykeysarelistedinboldanditaliccharacters.
Inthedatabaseschemafigures,primarykeysareinboldandunderlinedcharacters,
andrequiredfieldsareinboldcharacters.
n or 1
50
Chapter5:ManagingDatabases Forsk2013
ThefollowingtableliststhetypesoffieldsusedinAtolldatabasetemplates,theirsizes,andtheequivalentfieldtypesand
sizesindifferentRDBMS:
1.Lengthsforthesefieldsarespecifiedinparenthesesinthedatabasestructuretables.
2.CLOB:Characterlargeobject
3.BLOB:Binarylargeobject
For more information on the Atoll Management Console and upgrading databases, see "Atoll Management Console" on
page 52and"UpgradingExistingDatabases"onpage 55,respectively.
5.2 CustomisingAtollDatabaseStructures
Atolldatabasestructurescanbecustomisedby:
Addingcustomfieldstodatatables,
Settinguserdefineddefaultvaluesforfields,and
Settinguserdefinedchoicelistsfortextfields.
Custom fields, as well as userdefined default values and choice lists for standard and custom fields, are stored in the
CustomFieldstable.
AddingCustomFieldstoDataTables
Customfieldscanbeaddedtodatatablesatdifferentstageskeepinginmindthat:
Custom fields added directly to the Atoll database templates (MDB files), using Microsoft Access 2003, will be
available in all new Atoll documents created from that template. A new database created by exporting such a
documentwillalsocontainthesecustomfields.
Customfieldsadded toan Atolldocumentthrough the Atolluser interface will notbe automatically added tothe
correspondingAtolldatabasetemplate.However,anewdatabasecreatedbyexportingsuchadocumentwillcontain
thesecustomfields.FormoreinformationonaddingcustomfieldstoAtolldocumentsthroughtheuserinterface,see
theUserManual.
CustomfieldsaddedtoanAtolldatabasewillbeavailableinallnewAtolldocumentscreatedfromthatdatabase.
Toaddacustomfieldtoadatatable:
1. Addthecustomfieldtothedefinitionofthedatatablebydefiningitsname,type,andsize.
2. AddacorrespondingrecordintheCustomFieldstableandentervaluesforeachofthefollowingfields:
Atoll OracleEquivalent
MicrosoftSQLServer
Equivalent
Microsoft
Access
Equivalent
FieldType Length FieldType Length FieldType Length
Float 4 FLOAT 32 real 4 Single
Double 8 FLOAT 64 float 8 Double
Integer 4 NUMBER 11 int 4 LongInteger
Short 2 NUMBER 6 tinyint 1 Integer
Boolean 2 NUMBER 1 bit 1 Yes/No
Text
Variable
1
VARCHAR2
Variable
1
varchar
Variable
1
Text
1
Memo Variable VARCHAR2 2000 varchar 4000 Memo
Binary Variable
CLOB
2
>2000
image 16 OLEObject
BLOB
3
Variable
If you export the contents of an Atoll document, already connected to a database, to
anotherRDBMS(forexample,ifyouexportadocumentconnectedtoanOracledatabase
to SQL Server), some field types will be converted according to the above table. This
conversiondoesnothaveanyimpactonthedocumentinAtoll.
Field
UserInterface
Caption
Description
TABLE_NAME Databasenameofthedatatablethatcontainsthefield
COLUMN_NAME Name Databasenameofthefield
51
SettingUserdefinedDefaultValuesforFields
YoucansetyourowndefaultvaluesforstandardaswellascustomfieldsusingtheCustomFieldstable.Userdefineddefault
valuesenteredintheCustomFieldstablehaveprecedenceoverthepredefineddefaultvalues.
Toenterauserdefineddefaultvalueforanyfield,addanewrecordintheCustomFieldstableandentervaluesforeachof
thefollowingfields:
SettingUserdefinedChoiceListsforTextFields
YoucansetyourownchoicelistsforstandardaswellascustomtextfieldsusingtheCustomFieldstable.Userdefinedchoice
listsenteredintheCustomFieldstablehaveprecedenceoverthepredefinedchoicelists.
Toenterauserdefinedchoicelistforanytextfield,addanewrecordintheCustomFieldstableandentervaluesforeachof
thefollowingfields:
Forexample,youcanreplacethedefaultchoicelistavailablefortheSUPPORT_INFOfieldintheSitestablewithadifferent
listofoptionscorrespondingtothedifferenttypesoftowersandpylonsthatmayexistinyournetwork.
DEFAULT_VALUE Defaultvalue Userdefineddefaultvalue(optional)
CHOICE_LIST Choicelist Userdefinedchoicelistfortextfields(optional)
CAPTION Legend
Captionofthefieldasitwillappearintheuserinterface(optionalbut
recommended)
GROUP_NAME Group Groupofthefield(optional)
CHOICE_TYPE Restricted
1:Customfieldonlyacceptsvalueslistedinthechoicelist
0:Customfieldacceptsvaluesotherthatthoselistedinthechoicelist
DISPLAY_TYPE Readonly
1:Customfieldisreadonlyintheuserinterface
0:Customfieldismodifiableintheuserinterface
Customfieldsareforinformationonlyandarenottakenintoaccountinanycalculation.
You can find these fields on the Other Properties tab of an object types Properties
dialogue.
Field
UserInterface
Caption
Description
TABLE_NAME Databasenameofthedatatablethatcontainsthefield
COLUMN_NAME Name Databasenameofthefield
DEFAULT_VALUE Defaultvalue Userdefineddefaultvalue
For floating point default values, make sure that all the users have the same decimal
symbol.
Field
UserInterface
Caption
Description
TABLE_NAME Databasenameofthedatatablethatcontainsthetextfield
COLUMN_NAME Name Databasenameofthetextfield
CHOICE_LIST Choicelist Choicelistitems,oneperline
You can enter one of the choice list items in the DEFAULT_VALUE in order to set a
defaultvalueforthetextfield.
Forcustomtextfields,youcansettheCHOICE_TYPEto1ifyouwantthecustomtext
field to only accept values listed in the choice list. By default, CHOICE_TYPE is
consideredtobe0meaningthatusersareallowedtoentervaluesotherthanthose
definedinthechoicelist.
Field
UserInterface
Caption
Description
52
5.3 AtollManagementConsole
TheAtollManagementConsoleprovidesthedatabaseadministratorthepossibilityofgloballymanagingthedatabasewith
theeasytousestepbystepprocedureswhichusewizardinterfaces.TheAtollManagementConsoleletsyou:
Createdatabases(see"CreatingNewDatabases"onpage 53)
Upgradedatabasestructuresfromonemajorversiontothenext(see"UpgradingExistingDatabases"onpage 55)
Workwithmultileveldatabases(see"WorkingWithaMultilevelDatabases"onpage 59)
Managedatamodificationshistoryindatabases(see"ManagingDataModificationsHistory"onpage 64)
Manageuseraccountsandaccessrights(see"ManagingUserAccountsandAccessRightsinOracle"onpage 75)
TheAtollManagementConsolesupports:
Oracle
MicrosoftSQLServer
TheAtollManagementConsolecanbeinstalledwithAtoll.Formoreinformation,see"InstallingAtollandComponents"on
page 29. You can run the Atoll Management Console from the Windows Start menu program group or by doubleclicking
AMC.msc in the management subfolder of the Atoll installation folder. The Atoll Management Console runs using the
MicrosoftManagementConsoleenvironment.
WhentheAtollManagementConsoleisrunforthefirsttime,youmustregisteryourdatabaseserverinordertohavethe
databasesinstalledontheservertobeavailableintheAtollManagementConsole.
Toregisteradatabaseserver:
1. IntheAtollManagementConsolewindow,intheleftpane,rightclicktheDatabaseitemundertheAdministration
Atoll.Thecontextmenuappears.
2. SelectRegisteraNewServer.TheDataLinkPropertiesdialogueappears.
3. ClicktheProvidertab.OntheProvidertab,selecttheproviderforyourdatabaseserverdependingonwhetheritis
OracleorSQLServer.
4. ClickNext.OntheConnectiontab,entertheservername,andtheusernameandpasswordrequiredtoaccessthe
databaseserver.
YoucanchecktoseeiftheenteredinformationiscorrectbyclickingtheTestConnectionbutton.
5. ClickOK.TheselecteddatabaseserverisregisteredandavailableintheAtollManagementConsole(seeFigure 5.2
onpage 52).YounowhaveaccesstothefeaturesofferedbytheAtollManagementConsole.
Figure 5.1:DataLinkPropertiesdialogueProviderTab
Figure 5.2:AtollManagementConsole
53
The tree in the left pane lists the registered database servers. Registered database servers can be connected ( ) or
disconnected( ).
Therightpaneliststhedatabasesavailableontheconnecteddatabaseservercurrentlyselectedintheleftpane.Thecurrent
usercanbetheownerofoneofthelisteddatabases.Theusernameoftheownerofadatabaseappearsinparenthesesin
thetitlebar.OneOracleusercancreateandownonedatabase.Foreachnewdatabase,youmustcreateanewuserowner
ofthedatabase.
ThefollowingdetailsareavailablefordatabasescreatedorupgradedusingtheAtollManagementConsole:
WhetherthedatabasecorrespondstothecurrentAtollversion( )orapreviousversion( ),notyetupgradedto
thecurrentversion.
Thetypeofthedatabase:masterorproject.
Amasterdatabasecanhaveoneormoreprojectdatabasescreatedfromandconnectedtoit.Formoreinformation
onmasterandprojectdatabases,see"WorkingWithaMultilevelDatabases"onpage 59.
Thetechnologyofthenetworkmodelledbythedatabase.
Thepathofthesharedpathlossfolder.
Toviewdetailsofadatabase:
1. Intherightpane,rightclickthedatabaseinthelist.Thecontextmenuappears.
2. SelectProperties.ThedatabasePropertiesdialogueappears.
3. ThePropertiesdialoguecontainstwotabs:
Generaltab:TheGeneraltabdisplaystheName,Description,Owner,Type,andVersionofthedatabase.
Statisticstab:TheStatisticstabdisplaysthenumberofrecordsineachtableofthedatabase.
5.4 CreatingNewDatabases
NewdatabasescanbecreatedusingtheAtollManagementConsoleorbydirectlyexportingadocumenttoadatabasefrom
Atoll.Inthissection,thefollowingareexplained:
"CreatingaNewDatabaseUsingtheAtollManagementConsole"onpage 53
"CreatingaNewDatabaseUsingAtoll(AllSupportedRDBMs)"onpage 55
5.4.1 CreatingaNewDatabaseUsingtheAtollManagement
Console
YoucancreatenewdatabasesusingtheAtollManagementConsole.
Tocreateanewdatabase:
1. In the Atoll Management Console window, in the left pane, rightclick the database server on which you want to
createanewdatabase.Thecontextmenuappears.
2. SelectNew >Database.TheNewDatabaseWizarddialogueappears.
Youmusthaveadministratorrightstothedatabaseandtotheserverforcreatingnew
databases.
Figure 5.3:NewDatabaseWizard
54
3. ClickNext.TheSpecifythedatabaseownerpageappears.
4. SelectUsethecurrentconnectionifyouwanttocreateanewdatabaseusingthecurrentuser,orselectCreateanew
userandenteraNameandPasswordtocreateanewuserthatwillbeownerofthenewdatabase.
5. ClickNext.TheNamethedatabaseandspecifyanetworktypepageappears.
6. Enter a Name for the new database and select the Network type. The Network type can be one of the database
templatesinstalledwithAtoll.
7. ClickNext.TheSpecifyunitsandcoordinatesystemspageappears.
8. SelectaTransmissionpowerunitandaReceptionthresholdunit.
9. UnderCoordinatesystems,selectaCartographicprojectionsystemandtheSystemtobeusedinthedatabase.
10. ClickNext.TheReadytocreatedatabasepageappears.Thispageprovidesasummaryoftheselectedparameters.
11. ClickExecute.TheAtollManagementConsolecreatesthenewdatabasewiththedefinedparametersontheselected
databaseserver.
AdatabasecreatedusingtheAtollManagementConsolecontainsanATOLL_ADMINtablewiththefollowingstructure:
If your password must contain special characters, for example, !, ?, etc., type the
passwordinsidedoublequotationmarks:"mypassword!"insteadofmypassword!
AtollandtheAtollManagementConsolemusthavethesameversion.Thismeansthat
theAtollManagementConsolecancreatedatabasesbasedonthedatabasetemplates
installedwithAtollofthesameversion.
Field Type Description
NAME Text(50) Thenameofthedatabase
DESCRIPTION
Text
(255)
Descriptionofthedatabase
ATOLL_VERSION Text(10) ThecurrentversionofAtoll
ATOLL_BUILD Integer CurrentbuildofAtoll
ATOLL_DBTYPE Text(10) TypeofAtolldatabase(i.e.,MasterorProject)
Figure 5.3:NewDatabaseWizard
55
Amongotheruses,theATOLL_ADMINtableisusedtospeedupthedatabaseupgradetothenextversion.Thistablestores
thedatarequiredbytheAtollManagementConsolefordatabaseupgrade.
DatabasescreatedwithAtoll,insteadoftheAtollManagementConsole,anddatabasesthathaveneverbeenupgradedusing
the Atoll Management Console contain a smaller ATOLL_ADMIN table, with just the NAME, ATOLL_VERSION, and
ATOLL_BUILDfields.UpgradingsuchdatabasesusingtheAtollManagementConsolecantakealongtimebecausetheAtoll
ManagementConsolemustsearchforthedatarequiredfortheupgradeinthewholedatabase.
Formoreinformationonupgradingdatabases,see"UpgradingExistingDatabases"onpage 55.
AllthetablesinadatabasecreatedusingtheAtollManagementConsole(excepttheCOORDSYSandUNITStables)containa
nonmodifiable,integerDB_RECORD_IDfield.ThisfieldisusedtostoretheIDofeveryrecordinthetable.Itisnotaddedto
MicrosoftAccessdatabases.
5.4.2 CreatingaNewDatabaseUsingAtoll(AllSupportedRDBMs)
YoucancreatenewdatabasesinallsupportedRDBMSusingAtoll.
Tocreateanewdatabase:
1. RunAtoll.
2. CreateanewAtolldocumentoropenanexistingone.Thenewdatabasewillbecreatedfromthisdocument.
3. SelectDocument >Database >Export.TheExporttoaDatabasedialogueappears.
4. IntheExporttoaDatabasedialogue,selectthedatabasetypeintheSaveastypelist.
5. Dependingontheselecteddatabasetype,entertheusernameandpasswordofthedatabaseowner.
6. ClickSave.Atollaskswhetheryouwanttoconnectthedocumenttothenewdatabase.
7. ClickYesorNo.Atollcreatesanewdatabasebasedonthedocument.
AdatabasecreatedusingAtollcontainsanATOLL_ADMINtablewiththefollowingstructure:
5.5 UpgradingExistingDatabases
Ineachnewmajorrelease,datastructurechangesmustbemadeinthedatabaseinordertosupportthenewfeaturesadded
in the version. The data structures of standalone Atoll documents, i.e., documents not connected to any database are
upgradedwhentheyareopenedinthenewAtollversion.YoucanupgradedatabasesusingtheAtollManagementConsole.
ATOLL_TEMPLATE Text(50) Atolldatabasetemplateusedtocreatethedatabase
DBSCHEMA Memo Animageoftheschemaoftheoriginaldatabase
By setting an option in the Atoll.ini file, you can instruct Atoll to always use a defined
databasetype(MSAccess,SQLServer,orOracle).Inthiscase,theExporttoaDatabase
dialoguewillbe skipped andthedatabasespecificauthenticationdialoguewillappear
immediately.Formoreinformation,see"SettingtheTypeofDatabaseBeingUsed"on
page 195.
NAME Text(50) Thenameofthedatabase
ATOLL_VERSION Text(10) ThecurrentversionofAtoll
ATOLL_BUILD Integer CurrentbuildofAtoll
Before creating the database, make sure that you have defined the coordinate
systemsandunitsinthesourcedocument.
Before creating the database, make sure that you have added any required custom
fields.Customfieldsofthesourcedocumentarecreatedinthenewdatabase.
If you want to add a custom field to the data structure after you have created the
database, you will have to add it directly in the database and not through Atoll.
Customfieldsaddedtoadatabaseareavailabletousersconnectedtothedatabase
whentheycreateanewAtolldocumentfromthedatabaseorrefreshanexistingone.
YoucanusetheODBCinterfacetoaccessalldatabasesthatacceptUDLfilesandthe
ODBCinterface.
56
DonotskipamajorAtollversion.Forexample,ifyouarecurrentlyusingAtoll2.7.x,youshouldfirstupgradethedatabaseto
Atoll2.8.xbeforeupgradingtoAtoll3.1.x.Upgradingyourdatabasewillbesimplerifyoudonotskipamajorversion.Ifyou
skiporhaveskippedanintermediatemajorversion,youmustupgradeyourdatabasetwiceinordertomakeitcompatible
withthenewversion.
ToupgradeadatabaseusingtheAtollManagementConsole:
1. IntheAtollManagementConsolewindow,intherightpane,rightclickthedatabasethatyouwanttoupgrade.The
contextmenuappears.
2. SelectUpgradeDatabase.TheDatabaseUpdateWizarddialogueappears.
TheDatabaseUpgradeWizarddisplaysthecurrentdatabaseversionandtheversiontowhichthedatabasewillbe
upgraded.
3. ClickNext.TheNamethedatabasepageappears.
4. EnteraNameanddescriptionforthedatabase.
5. ClickNext.
The Database Upgrade Wizard reads the database to determine the Atoll database template using which it was
created. If there is more than one template corresponding to the network, select the template to be used for the
upgradeandclickNext.
TheAtollManagementConsoleupgradesthedatabase.
ObsoletefieldsinthedatastructureareautomaticallydeletedfromthedatabasebytheAtollManagementConsoleduring
theupgrade.
Oncethedatabasehasbeenupgradedtothenewversion,
1. InstallthenewAtollversionsfortheendusers,and
2. AskalltheenduserstofullyrefreshdataintheirAtolldocumentsfromthedatabase.
Ifyouareupgradingadatabasewhichwasneithercreatednoralreadyupgraded(atleast
once) using the Atoll Management Console, see "Upgrading Databases for the First
Time"onpage 57first.
The Microwave Radio Links template now supports Radio Series. Similar microwave
radios belong to the same radio series. In order to organise the microwave radios
(microwaveequipment)inradioseriesbeforethedatabaseupgrade:
1. In Atoll 2.8.x, add a custom field named FAMILY of type Text (50) to the
MWEquipmentstable.
2. Entertheradioseriesnamesinthisfieldforeachradio,i.e.,grouptheradiosof
thesameseriesunderthesameradioseriesnameintheFAMILYfield.
Withoutthismanualorganisationofthemicrowaveradiosintoradioseries,thedatabase
upgradewillcreateoneradioseriesforeachmicrowaveradio.
If some of the tables in a database have been replaced by views, the Database
UpgradeWizardaskstoselecttheviewstoupgrade.Selecttheviewsthatyouwant
theAtollManagementConsoletoupgradeandclickExecute.
If,forexample,thedefinitionofaviewisgivenbythecondition:
SelectField1,Field2fromTable1where(Condition1);
The wizardfirstupgradestheschemaofTable1andthenupgradesthedefinitionof
theview.Theupgradeddefinitionwilltakethenewlyaddedfieldsintoaccount.
Whenyouupgradea3GPPMultiRATdatabase,theAtollManagementConsoleadds
any missing tables to the database. For example, a database created by exporting a
3GPP MultiRAT document containing only GSM contains only GSM tables. When
upgraded, the Atoll Management Console will add the UMTS and LTE tables to the
databaseaswell.
IfyouusetheAtollManagementConsoleshistorymanagementtool,youmustrepair
the upgraded database in order to continue using this tool. For more information, see
"ManagingDataModificationsHistory"onpage 64.
57
WhenusersopentheirexistingdocumentsinthenewAtollversion,theyareaskedwhethertheywanttoupgradethe
documentsdatastructurestothenewversionortodisconnectthedocumentsfromthedatabase.Onselectingthe
upgradeoption,Atollupgradesthedocumentdatastructurestomakethemcompatiblewiththenewversion.
It is possible to upgrade an existing database manually (not recommended) by adding and deleting tables and fields as
requiredbythenewversion. Forinformation on manually upgrading a database, see"Upgrading Databases Manually"on
page 58.
UpgradingDatabasesfortheFirstTime
If you want to upgrade a database which was neither created nor already upgraded (at least once) using the Atoll
ManagementConsole,youmustfirstupgradethedatabasetothesameversionasthecurrentversionofthedatabase.This
isrequiredsothattheAtollManagementconsoleaddstherequiredinformationtothedatabasetomakeitupgradableto
newerversions.
Toupgradethedatabase:
1. BeforeinstallingthenewversionofAtoll,installtheAtollManagementConsole(ifnotalreadyinstalled)compatible
withtheexistingversionofAtoll.
2. Upgrade the database (as described in "Upgrading Existing Databases" on page 55) using the Atoll Management
ConsoletotheexistingversionofAtoll.
TheAtollManagementConsoleaddsadditionalfieldstotheATOLL_ADMINtableandDB_RECORD_IDfieldsinallthe
tables,asdescribedin"CreatingaNewDatabaseUsingtheAtollManagementConsole"onpage 53.OncetheAtoll
ManagementConsolehasperformedthenecessarymodifications,youcanupgradethedatabasetothenewAtoll
version.
3. InstallthenewversionofAtollandtheAtollManagementConsole.
4. Upgradethedatabase(asdescribedin"UpgradingExistingDatabases"onpage 55),usingthenewversionoftheAtoll
ManagementConsole,tothenewversionofAtoll.
WhenanewversionoftheAtollManagementConsoleisinstalled,thesetupoverwritestheWindowsregistrykeythatstores
theinformationabouttheAdmin.dllfile,andtheexistingversionoftheAtollManagementConsolecannolongerbeused.
IfyouhavealreadyinstalledthenewversionoftheAtollManagementConsole,youwillhavetoregistertheoldAdmin.dll
again,upgradethedatabasetotheexistingversion,registerthenewAdmin.dll,andupgradethedatabasetothenewversion
usingthenewAtollManagementConsole.
NotesonDocumentDataStructureUpgrade
The data structure of an Atoll document not connected to any database is
automaticallyupgradedtothenewAtollversionwhenthedocumentisopenedand
savedinthenewversion.
Oncesaved,itisnotpossibletoopenthedocumentinanearlierAtollversion.
ThedatastructureofanAtolldocumentconnectedtoadatabasenotyetupgraded
tothenewversioncanbeupgradedby:
EitheropeningthedocumentinthenewAtollversion,disconnectingitfromthe
database,andsavingitinthenewversion,or
Upgrading the database to the new version and then opening and saving the
documentinthenewAtollversion.
Oncedisconnectedfromitsdatabase,itisnotpossibletoreconnectthedocument
toanydatabase.
Obsoletefieldsinthedatastructureofadocumentnotconnectedtoanydatabase
areautomaticallydeletedbyAtollwhenthedocumentissavedinthenewversion.
If the database has been upgraded to the new version but an Atoll document
connected to the database has not yet been upgraded, it is possible to open the
document in the previous Atoll version as readonly. It is also not possible to
interact with the upgraded database (archive, refresh, etc., are not allowed). To
make the document writeaccessible in the previous Atoll version, it must be
disconnectedfromtheupgradeddatabase.
For the Atoll Management Console to be able to recognise obsolete or deleted fields
fromdatabasetables,itisimperativethattheATOLL_ADMINtableexistinthedatabase.
This means that when upgrading a database for the first time using the Atoll
Management Console, the database administrator will have to remove the obsolete
fields manually. Once the Atoll Management Console has been used to upgrade a
database,itwillbeabletorecogniseobsoleteordeletedfieldsinthefollowingupgrades.
58
UpgradingDatabasesManually
Duetothecomplexnatureofthedatabaseupgradeprocess,itishighlyrecommendedtousetheAtollManagementConsole
forupgradingexistingdatabases.Youshouldonlyproceedwithamanualupgradeofyourdatabase,asdescribedbelow,if
andonlyifanautomaticupgradeusingtheAtollManagementConsoleisnotpossible.
The following procedure is not recommended for customised Atoll databases and only suits very simple databases.
Parametersandsettings(triggers,views,userprivileges,customfields,etc.)definedinadvanceddatabaseconfigurationsare
lostfollowingthemanualdatabaseupgrade.
1. InthepreviousversionofAtoll,createanewdocumentfromthedatabase.
2. InthenewversionofAtoll,openthedocumentcreatedinstep 1.Atollupgradesthedocumentdatastructuretomake
itcompatiblewiththenewversion.
3. Using the upgraded document, create a new database as explained in "Creating a New Database Using Atoll (All
SupportedRDBMs)"onpage 55.
AddingaTechnologyinaMultiRATDatabase
AmultiRATAtolldocumentcanbebasedononeortworadiotechnologiesoutofamaximumofthree(GSM,UMTS,andLTE).
Providedsuchadocumenthasalreadybeenexportedtoadatabase,youcanaddatechnologytothecorrespondingdatabase
throughtheAtollManagementConsole.
1. StarttheAtollManagementConsole.
2. WhentheAtollManagementConsoleopens,rightclickonDatabaseintheleftpane.Thecontextmenuappears.
3. SelectRegisteraNewServer.TheDataLinkPropertiesdialogueisdisplayed.
4. OntheProvidertab,selectanOLEDBproviderandclickNext.
5. OntheConnectiontab,specifyadatabaseintheSelectorenteradatabasenamefield.
6. ClicktheTestConnectionbutton.Iftheconnectionissuccessful,clickOKtoclosetheDataLinkPropertiesdialogue.
7. Upgradethedatabaseifnecessary,asexplainedin"UpgradingExistingDatabases"onpage 55.
8. Intherightpane,rightclickthedatabaseyouwanttoupgradewithanadditionaltechnologyandselectMultiRAT:
View/AddTechnologies.TheTechnologiesintheMultiRATDatabasedialogueisdisplayed.
9. SelectthetechnologyyouwanttoaddandclickOK.
If you are upgrading your database using a script based on the data structure
modificationslistedinPart3oftheAdministratorManual,youmust:
AddtheATOLL_ADMINtabletothedatabase.Formoreinformationonthistable,
see"CreatingaNewDatabaseUsingtheAtollManagementConsole"onpage 53.
ForLTEdatabases,renamethesmartantennamodelsandequipmentasfollows:
Delete existing smart antenna equipment ("Optimum Beamforming Smart
Antenna")fromtheSmartAntennastable.
Delete existing smart antenna model ("Optimum Beamformer") from the
SmartAntennasModelstable.
Createanewsmartantennaequipment("ConventionalBeamformingSmart
Antenna")intheSmartAntennastable.Setthesmartantennamodelforthis
equipmentto"ConventionalBeamformer."
Figure 5.4:TechnologiesintheMultiRATDatabase
59
ThenexttimeyouopenthenetworkstableinyourmultiRATdatabase,youwillseeanewrowcorrespondingtothe
technologyyouadded:GPRS(forGSM),UMTS,orLTE.Bydefault,thenetworkstablecontainsarowcalledMT(for
multitechnology)andanadditionalrowforeachtechnologyalreadypresentinthedatabase.
5.6 WorkingWithaMultilevelDatabases
AtollManagementConsoleallowsyoutosetupandworkwithmultileveldatabasesusingOracle.Inthisoptionaldatabase
architecture, the master database is not directly accessible to endusers. Groups of endusers work with their respective
projectdatabaseswhichareinturnconnectedtothemasterdatabase.Theendusersarchivedatatoandrefreshdatafrom
theirrespectiveprojectdatabases,andthedatabaseadministratormanagestheconnectionsanddataexchangebetweenthe
projectdatabasesandthemasterdatabase.
Forexample,youcanhaveacountrywidemasterdatabaseandmorethanoneregionalprojectdatabases.Enduserscanhere
workwiththeirlocalregionsprojectdatabase,andwouldnothavetounnecessarilyloadcountrywidedata.
Project databases are intermediate databases created from a common master database. A project database contains the
originalmasterdatabase,thatremainshiddenfromtheendusers,andancopyofthemasterdatabaseaccessibletotheend
users.Whenausermodifiesarecord,onlyitsaccessiblecopyismodifiedintheprojectdatabase.Theoriginalvalueinthe
master database remains unchanged until the database administrator archives all the modifications from the project
databasestothemasterdatabase.
YoucannotdeselectatechnologyalreadypresentinamultiRATdatabase.
Figure 5.5:"networks"TableinaMultiRATDatabase
Figure 5.6:WorkingWithaSingleLevelDatabase
60
Projectdatabasescanbeusedtoimproveperformanceandensuredatasecurityandreliability.Insteadallowingalltheend
users to work directly with the master database, one or many project databases can be created with copies of the entire
masterdatabaseorapartofthemasterdatabasecorrespondingtoagivenphysicallocationorregion.
Creating and working with project databases restricts the number of users who have access to the master database. This
reduces the risk of conflicts in the database as only the database administrator can archive modifications from project
databasestothemasterdatabase.
Forexample,ifacountrywidenetworkdatabaseisaccessibletoallendusers:
Theprobabilityofhumanerrorincreaseswiththenumberofuserswhocanmodifydata.
Theprobabilityofconflictsincreaseswiththenumberofusersaccessingthedatabase.
Theperformanceisreducedbecausetheentirenetworkisloadedeverytimeauseraccessesthedatabase.
Forroutinecitywideplanning,anenduserdoesnotrequiretheentirecountrysdatabasetobeloaded.
Projectdatabasescanbecreatedusingfiltersonsites,thusallowinguserstoworkwithregionaldatabases.Apossiblescenario
isdepictedinthefigurebelow:
MultileveldatabasescanbesetupusingtheAtollManagementConsole.Inthissection,thefollowingareexplained:
"CreatingProjectDatabases"onpage 60
"ArchivingProjectDatabasestoMasterDatabases"onpage 62
"RefreshingProjectDatabasesfromMasterDatabases"onpage 63
5.6.1 CreatingProjectDatabases
YoucancreateprojectdatabasesusingtheAtollManagementConsole.
Figure 5.7:WorkingWithProjectDatabases
Figure 5.8:MultipleProjectDatabasesFromaSingleMasterDatabase
61
Tocreateaprojectdatabasefromanexistingmasterdatabase:
1. IntheAtollManagementConsolewindow,intherightpane,rightclickthemasterdatabasefromwhichyouwantto
createaprojectdatabase.Thecontextmenuappears.
2. SelectCreateaProjectDatabase.TheProjectDatabaseCreationWizarddialogueappears.
3. ClickNext.TheSpecifytheserverandtheowneroftheprojectdatabasepageappears.
4. SelecttheDestinationserverfortheprojectdatabase.
5. UnderOwner,selectCurrentuserifyouwanttocreatethenewprojectdatabaseusingthecurrentuser,orselect
CreateanewuserandenteraUsernameandPasswordtocreateanewuserthatwillbeownerofthenewproject
database.
6. ClickNext.TheNamethedatabasepageappears.
7. EnteraNameandDescriptionforthenewprojectdatabase.
8. ClickNext.TheSpecifythesitestoincludeintheprojectdatabasepageappears.
9. Onthispage,choosefromoneofthefollowingoptions:
Includeallthesitesofthemasterdatabase
Selectthisoptionifyouwanttocreateaprojectdatabasethatcontainsallthedataofthemasterdatabase.
Includeasitelistcontainedinthemasterdatabase
Selectthisoptionifyouwanttocreateaprojectdatabasecontainingthenetworkdatacorrespondingtothesites
includedinasitelistofthemasterdatabase,andselectasitelist.Thisoptionisonlyavailablewhenatleastone
sitelistexistsinthemasterdatabase.
SelectthesitestoincludeusinganSQLcondition
that verify an SQL condition (for example, sites that have a common parameter or flag), and enter the SQL
condition.
Includethesitescontainedwithinapolygoncontainedinafile
thatarelocatedinsideapolygon,andselectthefilecontainingthepolygontouse.
10. Click Next. The Atoll Management Console creates the new project database with the defined parameters on the
selecteddatabaseserver.
TheprojectdatabasewillhavethetypePROJECTlistedintheAtollManagementConsolewindow.
Forcreatingaprojectdatabase,youmusthaveenoughrightstobeabletocreatenew
tablesinthemasterdatabaseschema.
SomeversionsofOracleletyoucreateanewuserthroughthisdialoguebutthenewuser
is not assigned DBA rights, which makes the new user unable to create the project
database.Therefore,itisrecommendedtocreatethenewuserwithDBArightsdirectly
inthedatabasebeforecreatetheprojectdatabaseusingtheAtollManagementConsole
usingthenewuseraccount.
Figure 5.9:NewProjectDatabaseWizard
62
A project database created using the Atoll Management Console contains an ATOLL_ADMIN_PRJ table, in addition to the
ATOLL_ADMINtable,withthefollowingstructure:
YoucanviewthedetailsstoredintheATOLL_ADMIN_PRJtableintheprojectdatabaseproperties.Toviewtheabovedetails
ofaprojectdatabase:
1. Intherightpane,rightclicktheprojectdatabaseinthelist.Thecontextmenuappears.
2. SelectProperties.ThedatabasePropertiesdialogueappears.
3. ThePropertiesdialoguecontainsthreetabs:
Generaltab:TheGeneraltabdisplaystheName,Description,Owner,Type,andVersionofthedatabase.
ProjectDatabasetab:UnderSourcemasterdatabase,theProjectDatabasetabdisplaystheConnectionsettings
toandtheOwnerofthemasterdatabase.UnderSiteselection,thistabdisplaysthesitefilteringMethodand
Settingsusedforcreatingtheprojectdatabase.
Statisticstab:TheStatisticstabdisplaysthenumberofrecordsineachtableoftheprojectdatabase.
Theprojectdatabasecontainsacopyofalltheoriginaltablesofthemasterdatabase.Thenamesoftheoriginaltablesare
prefixedwith"O_".Forexample,theANTENNAStableofthemasterdatabaseisstoredintheprojectdatabaseunderthe
name O_ANTENNAS. The COORDSYS and UNITS are not copied to the project database because their contents cannot be
differentfromthoseofthemasterdatabase.
Allthetablesinaprojectdatabasecontainanonmodifiable,integerO_RECORD_IDfieldandaBooleanO_CHANGEDfield.
TheO_RECORD_IDfieldisusedtolocaterecordsinthemasterdatabase.Modifiedrecordsarearchivedinmasterdatabase
usingtheO_RECORD_IDoftheprojectdatabaseandDB_RECORD_IDofthemasterdatabase.TheO_CHANGEDfieldissetto
TRUEforrecordsmodifiedintheprojectdatabase.
5.6.2 ArchivingProjectDatabasestoMasterDatabases
ChangesmadeintheprojectdatabasescanbearchivedtothemasterdatabaseusingtheAtollManagementConsole.The
Archivedialogueletsyouselectchangesyouwanttoarchive.
Toarchivethechangesfromaprojectdatabasetoitsmasterdatabase:
1. IntheAtollManagementConsolewindow,intherightpane,rightclicktheprojectdatabasefromwhichyouwantto
archivechangestoitsmasterdatabase.Thecontextmenuappears.
2. SelectArchive.Ifpendingchangesexist,theArchivedialogueappears.TheArchivedialogueliststherecordsofthe
projectdatabaseforwhichtheO_CHANGEDfieldisTRUE.
3. IntheArchivedialogue,youcandothefollowing:
NAME Text(50) Thenameoftheprojectdatabase
MASTER_CONNECTION
Text
(255)
Connectionparameterstothemasterdatabase
MASTER_DBSCHEMA Text(50) Thenameoftheoriginalschemaofthemasterdatabase
SEL_METHOD Short
Dataextractionmethodusedtoselectthesitestoincludeintheproject
database
SEL_PARAM
Text
(255)
Siteselectionmethodparameters(theSQLcondition,ifany)
SEL_PGON Memo Siteselectionpolygon(ifused)
Figure 5.9:NewProjectDatabaseWizard
63
SelectasitelistinFilterbysitelisttofilterthependingchangesbyasitelist.
ClickArchiveAlltoarchiveallthechangestothemasterdatabase.
SelectthecheckboxestotheleftofthechangesthatyouwanttoarchiveandclickArchiveSel.toarchiveonlythe
selectedchanges.
ClickUndoAlltooverwriteallthechangesintheprojectdatabasewithdatafromthemasterdatabase.
SelectthecheckboxestotheleftofthechangesthatyouwanttoundoandclickUndoSel.tooverwriteonlythe
selectedchangesintheprojectdatabasewithdatafromthemasterdatabase.
SelecttheCheckconflictscheckboxtoseewhetherconflictsoccurredduringthearchive.
Aconflictoccurswhentheprojectdatabasecontainsadifferentoriginalvalueofafieldthanthecurrentvalueof
the field in the master database. This can occur if the master database has been updated with changes from
anothersourceandtheprojectdatabasehasnotyetbeenrefreshedwithdatafromthemasterdatabase.
UnderErrors,AtollManagementConsoledisplayserrorsthatoccurredduringarchive.
4. Oncearchiveiscomplete,clickClose.
5.6.3 RefreshingProjectDatabasesfromMasterDatabases
ProjectdatabasescanberefreshedwithdatafromthemasterdatabaseusingtheAtollManagementConsole.
Torefreshaprojectdatabasewithdatafromitsmasterdatabase:
1. IntheAtollManagementConsolewindow,intherightpane,rightclicktheprojectdatabasethatyouwanttorefresh
withdatafromitsmasterdatabase.Thecontextmenuappears.
2. SelectRefresh.Ifpendingchangesexist,theRefreshaProjectDatabasedialogueappears.
3. IntheRefreshaProjectDatabasedialogue,youcan:
Select Refreshunmodifieddataonly to keepanychangesin the project database and onlyupdate unmodified
recordsfromthemasterdatabase.Duringtherefresh,theAtollManagementConsolewillreloadrecordsfrom
themasterdatabaseforwhichtheO_CHANGEDfieldisFALSEintheprojectdatabase.
SelectCancelyourchangesandreloadalldatafromthemasterdatabasetooverwritemodifiedandunmodified
recordsintheprojectdatabasewithdatafromthemasterdatabase.
1. ClickOK.Theprojectdatabaseisrefreshedwithdatafromthemasterdatabase.
5.7 SettingDatabaseAccessPrivileges
Youcanassigndifferentlevelsofprivilegestodifferentusersforaccessing(reading/writing)tablesandviewsofadatabase.
YoucangrantuserprivilegesforDatabase,Table,Column,andRowlevelskeepingthefollowinginmind:
DatabaseLevel:
UserstryingtocreateanewAtolldocumentfromadatabaseareprovidedalistofavailabledatabasestoselectfrom.
Thelistcanbelimitedtoafewdatabasesbasedontheuserconnectionproperties(login).
TableLevel:
Figure 5.10:ArchivingChangesinMasterDatabases
64
Forconsistencyreasons,allthetablesavailableinanAtolldatabasemustbereadablebyalltheuserswhohaveaccess
tothedatabase.However,writeaccess(INSERT,DELETE,UPDATE)canbegrantedonalimitednumberoftables.
ColumnLevel:
Similartotablelevel,allthecolumnsofallthetablesinanAtolldatabasemustbereadableandselectablebyallthe
users who have access to the database. Different write permissions can be granted for columns of the tables. For
example,customfieldscanbeassignedreadandwritepermissionswithoutrestrictions.
RowLevel:
RowlevelpermissionscanbesetbydefiningcustomviewsonAtolltables.Accesstotheseviewscanbebasedonuser
connection properties (log in), on external table references, or on the geographic locations of sites (e.g., through
polygons,orwhenusingthespatialfeaturesofdatabases).
AllofthesepermissionscanbesetasregularSELECT,INSERT,UPDATE,andDELETEprivilegesondatabaseobjects.Triggers
canalsobeusedtopreventusersmakingcertainactionsonthedatabase.
Different permissions for different users can be granted directly or through database roles. Database roles enable you to
definepermissiontemplates,whichcanthenbeassignedtoexistingornewusersofthedatabase.
YoucanusetheAtollManagementConsolefordefininguseraccessrightstodatabasetablesandelementsintheAtollGUI.
Formoreinformationonmanaginguseraccessrights,see"ManagingUserAccountsandAccessRightsinOracle"onpage 75.
5.8 ManagingDataModificationsHistory
TheAtollManagementConsoleallowsyoutokeepandmanagethehistoryofmodificationsmadeinthenetworkdataby
differentusers.ThehistorymanagementtoolkeepstrackofallthemodificationsmadeinthefollowingAtolltables:
Youcan,however,enableordisablehistorymanagementfortableasrequired(see"Enabling/DisablingDataModifications
HistoryManagement"onpage 65formoreinformation).Ifyouwant,youcanalsopurgeolddatamodificationshistory(see
"PurgingOldDataModificationRecords"onpage 66formoreinformation).
The history management tool is available for Oracle databases. The following section describes how to set up the history
managementtoolusingtheAtollManagementConsole.
5.8.1 SettingUpDataModificationsHistoryManagement
Whenyousetuphistorymanagementforanydatabase,theAtollManagementConsoleaddsnewtablestothedatabase
structure.Foreachtrackedtable,itaddsacorrespondinghistorytablethathasthesamenameasthetrackedtablewiththe
suffix "_H". Each history table has the same structure as the corresponding tracked table, but with the following four
additionalfields.ThesefieldsenabletheAtollManagementConsoletostorethemodificationsmadebyuserstoeachtracked
table:
Technology TrackedTables
GSMGPRSEDGE
Sites,Transmitters,TRGs,TRXs,Repeaters,SecondaryAntennas,Neighbours,
NeighboursExt
UMTSHSPA
Sites,Transmitters,CDMACells,Repeaters,SecondaryAntennas,Neighbours,
NeighboursExt
LTE
Sites,Transmitters,T4GCells,Repeaters,SecondaryAntennas,Neighbours,
NeighboursExt
3GPPMultiRAT
sites,ltransmitters,utransmitters,gtransmitters,lcells,ucells,gtrgs,gtrxs,
lrepeaters,urepeaters,grepeaters,lsecondaryantennas,usecondaryantennas,
gsecondaryantennas,lneighbours,uneighbours,gneighbours,guneighbours,
ugneighbours,glneighbours,lgneighbours,ulneighbours,luneighbours
CDMA20001xRTT1xEVDO
Sites,Transmitters,CDMACells,Repeaters,SecondaryAntennas,Neighbours,
NeighboursExt
WiMAX
Sites,Transmitters,WCells,Repeaters,SecondaryAntennas,Neighbours,
NeighboursExt
MicrowaveRadioLinks
Sites,MWLinks,MWHubs,MWPMP,MWMultiHops,MWMultiHopsLinks,
MWRepeaters
HISTORY_ID Integer AuniqueIDofthemodificationhistoryrecord
MODIFIED_BY Text(50) Theuserwhomadethemodification
MODIFIED_DATE Date Thedatewhenthemodificationwasmade
65
Theabovefieldsarealsoaddedtoallthetrackedtablesinordertostoreinformationaboutthelatestmodification.Therefore,
openinganytrackedtable,youcanseewhenarecordwaslastmodified,bywhom,andthetypeofmodification.
Tosetupdatamodificationshistorymanagementforadatabase:
1. IntheAtollManagementConsolewindow,intherightpane,rightclickthedatabaseforwhichyouwanttosetup
datamodificationshistorymanagement.Thecontextmenuappears.
2. SelectManageDataModificationsHistory.TheDataModificationsHistoryManagementdialogueappears.
3. ClickYeswhenaskedwhetheryouwanttomakeyourdatabasecompatiblewiththedatamodificationshistorytool.
TheAtollManagementConsoleupdatesthedatabasestructuretomakeitcompatiblewiththedatamodifications
historytool.Datamodificationshistoryisenabledforthedatabase.
Once finished, it opens the Data Modifications History Management dialogue (see Figure 5.11 on page 66). This
dialoguelistsallthetablesforwhichthedatamodificationshistorymanagementhasbeenenabled,thetotalnumbers
ofrecordsinthesetables,andthestatusofthehistorymanagement.
Allthemodificationsmadeinthetableslistedin"ManagingDataModificationsHistory"onpage 64arestoredinthehistory
tablesaddedtothedatabase.
Ifyouwant,youcandisablethedatamodificationshistorymanagementforanytable.Formoreinformation,see"Enabling/
DisablingDataModificationsHistoryManagement"onpage 65.
5.8.2 Enabling/DisablingDataModificationsHistoryManagement
You can enable or disable data modifications history management for any table. You can enable or disable history
managementforeachindividualtable.Whenhistorymanagementisenabledforatable,theMODIFIED_BY,MODIFIED_DATE,
andHISTORY_STATUSfieldsareupdatedwitheachmodification,andacopyofeachmodificationisstoredinthehistorytable
corresponding to the table. When history management is disabled for a table, the MODIFIED_BY, MODIFIED_DATE, and
HISTORY_STATUS fields are still updated with each modification, but the history of modifications is not stored in the
correspondinghistorytable.
Toenabledatamodificationshistorymanagementforatable:
1. IntheAtollManagementConsolewindow,intherightpane,rightclickthedatabaseforwhichyouwanttoenable
3. In the Data Modifications History Management dialogue, rightclick the table for which you want to enable data
modificationshistorymanagement.Thecontextmenuappears.
4. SelectEnableinthecontextmenu.
Datamodificationshistorymanagementisnowenabledforthistable.TheStatusintheDataModificationsHistory
ManagementdialogueissettoOKforthistable.
Todisabledatamodificationshistorymanagementforatable:
1. IntheAtollManagementConsolewindow,intherightpane,rightclickthedatabaseforwhichyouwanttodisable
3. In the Data Modifications History Management dialogue, rightclick the table for which you want to enable data
modificationshistorymanagement.Thecontextmenuappears.
4. SelectDisableinthecontextmenu.
History management is now disabled for this table. The Status in the Data Modifications History Management
dialogueissettoDeactivatedforthistable.
5.8.3 UpdatingAfterDataStructureUpgrade
Whenyoumodifythestructureofatrackeddatabasetable(forwhichdatamodificationshistorymanagementisenabled),
eitherautomaticallyupgradingyourdatabaseusingtheAtollManagementConsole,ormanuallybyaddingorremovingfields,
orbymodifyingafieldtype,thecorrespondingdatamodificationshistorymanagementtablebecomesinvalidandhastobe
updatedtomatchthenewstructureofthetrackedtable.
The Status column of the Data Modifications History Management dialogue shows an error for the tracked table whose
historymanagementtabledoesnotmatchitsstructure.
HISTORY_STATUS Text(10) Statusofthemodificationhistoryrecord
66
Toupdatethedatamodificationshistorymanagementtables:
1. In the Atoll Management Console window, in the right pane, rightclick the database whose tables you want to
update.Thecontextmenuappears.
3. IntheDataModificationsHistoryManagementdialogue,rightclickthetablethatyouwanttoupdate.Thecontext
menuappears.
4. SelectInstall/Repairinthecontextmenu.
TheAtollManagementConsolerepairsthedatastructureofthehistorymanagementtabletomatchthestructureof
thecorrespondingtrackedtable.
5.8.4 PurgingOldDataModificationRecords
Historymanagementtablesstorethelistsofallthemodificationsmadebyalltheusers.Thesetablescanthereforequickly
becomeverylargeandrequirealotofdiskspace.Youcanpurgeolddatamodificationshistory(records)fromthesetablesin
ordertogaindiskspace.
Inthissection,thefollowingisexplained:
"PurgingOldDataModificationRecordsofaTable"onpage 66
"PurgingOldDataModificationRecordsofaDatabase"onpage 67.
5.8.4.1 PurgingOldDataModificationRecordsofaTable
Topurgeolddatamodificationrecordsfromahistorymanagementtable:
1. IntheAtollManagementConsolewindow,intherightpane,rightclickthedatabaseinwhichyouwanttopurgeold
datamodificationshistory.Thecontextmenuappears.
2. In the context menu, select Manage Data Modifications History. The Data Modifications History Management
dialogueappears(seeFigure 5.11onpage 66).
3. IntheDataModificationsHistoryManagementdialogue,rightclickthetableforwhichyouwanttopurgeolddata
modificationshistory.Thecontextmenuappears.
4. Inthecontextmenu,selectPurge.Thetablerecordpurgedialogueappears(seeFigure 5.12onpage 66).
Figure 5.11:DataModificationsHistoryManagementDialogue
Figure 5.12:TableRecordPurgeDialogue
67
5. UnderPurgedatamodificationsrecordedbefore,movetheslidertoselectfromwhichdateonwardsyouwantto
keepthedatamodificationhistoryrecords.
Allthedatamodificationhistoryrecordsbeforethisdatewillbedeleted.Numberofrecordsshowsthenumberof
recordsthatwillbeleftafterthepurge.Datasizeshowsthesizeoftherecordsthatwillbeleftafterthepurge.
6. UnderOptions,selecttheKeepcreationanddeletionrecordscheckboxifyouwanttokeeptherecordsrelatedto
creationanddeletion.
7. ClickPurge.Allthehistoryrecordsbeforetheselecteddatearedeletedfromthehistorymanagementtable.
IfyouselectedtheKeepcreationanddeletionrecordscheckbox,creationanddeletionrecordsbeforetheselected
datearenotdeleted.
5.8.4.2 PurgingOldDataModificationRecordsofaDatabase
Topurgeolddatamodificationrecordsfromallthehistorymanagementtablesofadatabase:
1. IntheAtollManagementConsolewindow,intherightpane,rightclickthedatabaseinwhichyouwanttopurgeold
datamodificationshistory.Thecontextmenuappears.
2. In the context menu, select Manage Data Modifications History. The Data Modifications History Management
3. In the Data Modifications History Management dialogue, click the Scheduler button. The database record purge
4. UnderConditions,selecttherecordstopurge:
None:SelectNoneifyoudonotwanttopurgeanyrecord.
KeeponlyrecordsofNlastmonths:SelectKeeponlyrecordsofNlastmonthsandenterthenumberofmonths
priortowhichrecordsofdatamodificationswillbepurged.
Keepcreationanddeletionrecords:SelecttheKeepcreationanddeletionrecordscheckboxifyouwanttokeep
allthecreationanddeletionrecords,independentoftheaboveoptions.
5. Ifyouwishtopurgerecordsnow,clicktheRunnowbutton.
6. Ifyouwishtoscheduleregularpurges,underScheduling,definethepurgefrequency:
a. Period:Selectthefrequencyofthescheduledregularpurges.
b. Day:Selectthedayoftheweek(MondaytoSunday),month(1to28),oryear(1to365),dependingonthepurge
periodicitydefinedinPeriod,onwhichthescheduledpurgeswillrun.
c. Time:Enterthetime,i.e.,thehour(0to23)andminutes(0to59)atwhichscheduledpurgeswillrun.
Scheduled regular purges will delete all the data modification records according to the criteria defined under
Conditions.
Figure 5.13:DatabaseRecordPurgeDialogue
68
7. SettheOff/OnslidertoOntoturnonthescheduledpurges.
SettingtheOff/OnslidertoOffletsyoususpendthescheduledpurgesandkeeptheschedulesettings.
8. ClicktheUpdatebuttontostorethescheduleparameters.
ThecurrentpurgestatusisshownunderStatus.Statusinformationincludes:
Lastexecution:Timeofexecutionofthelastpurge.
Result:Whetherthelastpurgewassuccessfulornot.
Nextexecution:Timeofexecutionofthenextscheduledpurge.
YoucanclicktheViewlogsunderStatustoviewthehistoryofpastpurges(seeFigure 5.13onpage 67).
9. ClicktheClosebutton.
ScheduledregularpurgesareprogrammedasascheduledjobinOracleusingtheDBMS_SCHEDULER.create_jobfunction.The
followingSQLstringgeneratesscheduledjob:
Here:
5.9 Appendices
ThefirstappendixshowshowtouseSQLforOracledatabasecustomisationandthesecondappendixshowshowtosetup
databasesforcoplanningtakingtheexampleofGSMandUMTSMSAccessdatabases.
5.9.1 Appendix1:AdvancedCustomisation
YoucanuseSQLinordertomanageaccesstoandsharetheSitestable(example1),ortorestricttheconnectiontoasetof
transmittersfor someusers(example 2). Toimplement the following twoexamples, you mustlog on as the owner ofthe
tablesthroughSQLPlus8.
Example1:ManagingSiteSharing
Assumptions:
Connectionstring=AtollDB
GSMProjectaccount=AtollADMINGSM,password=ADMINGSM
UMTSProjectaccount=AtollADMINUMTS,password=ADMINUMTS
CommonProjectaccount=AtollADMIN,password=ADMIN
TosharetheSitestable:
" BEGI N DBMS_SCHEDULER. cr eat e_j ob ( "
" j ob_name => ' AHMS_%s' , "
" j ob_t ype => ' %s' , "
" j ob_act i on => ' %s' , "
" st ar t _dat e => SYSTI MESTAMP, "
" r epeat _i nt er val => ' %s' , "
" end_dat e => NULL, "
" enabl ed => %s, "
" comment s => ' %s' ) ; END; "
Parameter Description
job_name AHMS_<schema_name>
job_type PLSQL_BLOCK
job_action ActualPLSQLcodeforthepurge
start_date SYSTIMESTAMP
repeat_interval
Frequencyofthescheduledpurge
Forexample,onceamonth,onthe15th,at1:30am:"freq=month;monthday=15;byhour=1;byminute=30"
end_date NULL
enabled TRUEorFALSE,basedontheuserinput
comments Customcharacterstringwithcodesforeasyidentificationoftheschedulertype
69
1. CreatetheAtollADMIN.SITEStableandcopyallsitesfromAtollADMINGSM.SITEStoAtollADMIN.SITES.
2. ReplacetheAtollADMINGSM.SITEStablebyanAtollADMINGSM.SITESview.
3. FollowthesameprocedureforUMTS(AtollADMIN.SITESalreadycreated).
4. Commit.
Example2:ManagingUsersbyPostalCode
Torestrictaccesstotransmittersforsomeusersbypostalcode:
1. AddaPOSTCODEfieldtotheSITEStable.
2. RenametheSITEStabletobeabletohideitbyaview.
3. CreateaPOSTCODETABLEtabletolinkusersandpostcodes(oneusercanbelinkedtoseveralpostcodes).
Youcanfillthistableusingthisinstruction.
4. CreateaviewownedbythisuserhidingtheactualSITEStablethroughthesecommands.
"withcheckoption"isveryimportantasitspecifiesthatinsertandupdateoperationsperformedthroughtheview
mustresultinrowsthattheviewquerycanselect.
SQL > connect At ol l ADMI N/ ADMI N@At ol l DB;
SQL > cr eat e t abl e At ol l ADMI N. SI TES as sel ect * f r omAt ol l ADMI NGSM. SI TES;
SQL > cr eat e uni que i ndex At ol l ADMI N_SI TES on At ol l ADMI N. SI TES( NAME) ;
SQL > connect At ol l ADMI NGSM/ ADMI NGSM@At ol l DB;
SQL > dr op t abl e At ol l ADMI NGSM. SI TES;
SQL > gr ant del et e on At ol l ADMI N. SI TES t o At ol l ADMI NGSM wi t h gr ant opt i on;
SQL > gr ant i nser t on At ol l ADMI N. SI TES t o At ol l ADMI NGSM wi t h gr ant opt i on;
SQL > gr ant sel ect on At ol l ADMI N. SI TES t o At ol l ADMI NGSM wi t h gr ant opt i on;
SQL > gr ant updat e on At ol l ADMI N. SI TES t o At ol l ADMI NGSM wi t h gr ant opt i on;
SQL > cr eat e vi ew At ol l ADMI NGSM. SI TES as sel ect * f r omAt ol l ADMI N. SI TES;
SQL > connect At ol l ADMI NUMTS/ ADMI NUMTS@At ol l DB;
SQL > dr op t abl e At ol l ADMI NUMTS. SI TES;
SQL > gr ant del et e on At ol l ADMI N. SI TES t o At ol l ADMI NUMTS wi t h gr ant opt i on;
SQL > gr ant i nser t on At ol l ADMI N. SI TES t o At ol l ADMI NUMTS wi t h gr ant opt i on;
SQL > gr ant sel ect on At ol l ADMI N. SI TES t o At ol l ADMI NUMTS wi t h gr ant opt i on;
SQL > gr ant updat e on At ol l ADMI N. SI TES t o At ol l ADMI NUMTS wi t h gr ant opt i on;
SQL > cr eat e vi ew At ol l ADMI NUMTS. SI TES as sel ect * f r omAt ol l ADMI N. SI TES;
SQL > commi t ;
SQL > al t er t abl e SI TES add ( POSTCODE number ) ;
SQL > r ename SI TES t o PRI VATE_SI TES;
SQL > cr eat e t abl e POSTCODETABLE ( USERNAME var char 2( 30) , POSTCODE number ) ;
SQL > i nser t i nt o POSTCODETABLE val ues ( USER1 , 75) ;
SQL > cr eat e vi ew SI TES as
sel ect * f r omPRI VATE_SI TES
wher e POSTCODE i n
( sel ect POSTCODE f r omPOSTCODETABLE wher e USERNAME =USER)
wi t h check opt i on;
70
5. Hidethe TRANSMITTERStable,sothatAtollcanonlyselecttransmitterswhoseassociatedsitesarepresentinthe
SITESview.
6. Commit.
5.9.2 Appendix2:SettingUpDatabasesforCoplanning
TwocoplanningapproachesarepossibleinAtoll:
CoplanningGSM,UMTS,andLTEusingaunifiedmultitechnologydatastructure,i.e.,workingwitha3GPPMultiRAT
document.
Coplanninganytworadiotechnologies(GSM,UMTS,LTE,CDMA2000,TDSCDMA,andWiMAX),withtwoseparate
datastructures,bylinkingAtolldocuments.
Intermsofdatabase,whilethefirstapproachprovidesanintegratedmultitechnologycoplanningenvironment,thesecond
requiressettingupsharingoftheSitestablebetweenthedatabasesofthetwotechnologiesbeingcoplanned.TheSitestable
must be shared between the databases of the two technologies being coplanned so that the sites where sectors of both
technologiesareinstalledarelistedonlyonceinacommonSitestable.Inotherwords,theSitestablesinthedatabasesofthe
twotechnologiesmustbeviewsofacommonSitestable.
ThissectiondescribestablesharingbetweenGSMandUMTS,althoughthesamedescriptioncanbeappliedtoanytworadio
technologymodulesofAtoll
Youcancreateviewstosharetablesthathavethesamestructureinthedatabasesofthetwotechnologiesbeingcoplanned,
i.e.,theSitesandAntennastables.Inthefollowing,weassumethattheSitestablesoftheGSMandUMTSdocumentscontain
thesamedataandthattwousers,namedGSMUserandUMTSUserinthisexample,existinthedatabases.
TosetupasharedSitestableforaGSMUMTScoplanningprojectinOracleorSQLServer:
1. MakebackupsoftheGSMandUMTSdocuments.
2. OpentheGSMdocumentinAtoll.
3. DeleteallthetransmittersfromtheTransmitterstableandallthesitesfromtheSitestable.
4. ExporttheGSMdocumenttothedatabasebyenteringtheusernameandpasswordforGSMUser.
5. LoginasGSMUsertothedatabase.
6. DeletetheSitestable.
7. OpentheUMTSdocumentinAtoll.
8. ExporttheUMTSdocumenttothedatabasebyenteringtheusernameandpasswordforUMTSUser.
9. LoginasUMTSUsertothedatabase.
10. RightclicktheSitestableandselectCreateaViewfromthecontextmenu.TheCreateViewdialogueappears.
a. EnterSitesastheviewname.
b. EnterGSMUserasthenameoftheschemawhichwillcontaintheview.
c. SelectTableasobjecttype.
d. EnterUMTSUserasthenameoftheschemayouwanttouse.
e. SelectSitesastheobjectusedtomodeltheview.
11. ClickCreate.TheviewoftheSitestablefromUMTSUseriscreatedinGSMUser.TheGSMUserSitestableisnowthe
sameasUMTSUserSitestable.
12. SetupuserprivilegesfortheSitesviewinGSMUsertoalloweachusertoImport,Update,Delete,andSelect.
SQL > r ename TRANSMI TTERS t o PRI VATE_TRANSMI TTERS;
SQL > cr eat e vi ew TRANSMI TTERS as
sel ect * f r omPRI VATE_TRANSMI TTERS
wher e SI TE_NAME i n ( sel ect NAME f r omSI TES) ;
SQL > commi t ;
Theerrormessage"ORA01402:viewWITHCHECKOPTIONclauseviolation"appearsif
youtrytoarchivearecordthatdoesnotmatchtheproject.
71
TosetupasharedSitestableforaGSMUMTScoplanningprojectinMicrosoftAccess:
1. MakebackupsoftheGSMandUMTSdocuments.
2. OpentheGSMdocumentinAtoll.
3. DeleteallthetransmittersfromtheTransmitterstableandallthesitesfromtheSitestable.
4. ExporttheGSMdocumenttoaMicrosoftAccessdatabase(GSM.mdb).
5. OpenGSM.mdbinMicrosoftAccess.
6. DeletetheSitestable.
7. OpentheUMTSdocumentinAtoll
8. ExporttheUMTSdocumenttoaMicrosoftAccessdatabase(UMTS.mdb).
9. OpenGSM.mdbinMicrosoftAccess.
10. InMicrosoftAccess2003andearlier,selectFile >GetExternalData >LinkTables.InMicrosoftAccess2007andlater,
selectExternalData >AccessDatabase.
11. InMicrosoftAccess2003andearlier,theLinkdialogueappears.SelectUMTS.mdb.InMicrosoftAccess2007andlater,
theGetExternalDataAccessDatabasedialogueappears,specifyUMTS.mdbasdatasourceandselectLinktodata
sourcebycreatingalinkedtable.
12. ClickOK.TheLinkTablesdialogueappears.
13. SelecttheSitestable.
14. ClickOK.MicrosoftAccesscreatesaSitestableinGSM.mdbwhichislinkedtotheSitestableinUMTS.mdb.Thetables
containthesamedata.
OncethelinkedSitestablehasbeencreatedintheGSMdatabase,youhavetodefinetherelationsofthistablewiththeother
tablesinthedatabase.Figure 13.1onpage 249showstherelationsoftheSitestablewithothertablesinaGSMdatabase.
EnsuringDatabaseConsistencyBetweenLinkedDocuments
WhenusersworkwithtwoAtolldocumentsanddatabasesatthesametime,itisimportanttohaveaprotectionmechanism
againstdatabaseinconsistencies.Ifauserarchivesthechangesmadeinonedocumentbutforgetstoarchivethechanges
madeintheother,thiscancreateinconsistenciesbetweenthetwonetworks.
Toensuredatabaseconsistency,youcansaveorarchivethelinkeddocumentsatthesametime,i.e.,whenausersavesor
archivesonedocument,Atollautomaticallysavesorarchivestheother.Thiscanbedoneusingamacrotriggeredbythesave
orarchiveoperation.
TheUMTSSitestablehasmorefieldsthantheGSMSitestable.Therefore,youshould
replacetheGSMSitestablewiththeUMTSone.
WhenyouupgradeonebyonethedatabasesthatsharetheSitestable,anytriggers
thatyoumighthavesetontheSitestableofthedatabasethatisupgradedfirstmight
beoverwrittenbythetriggerssetontheSitestableofthedatabaseupgradedlast.In
order to avoid the triggers being overwritten, you can rename the triggers on the
Sites table of the database upgraded first (by adding, for example, the database
technologyasprefixtothetriggernames)beforeupgradingtheotherdatabase(s).
72
AT320_AM_E2 Chapter6:MultiuserEnvironments
73
6 MultiuserEnvironments
AmultiuserenvironmentiswheremorethanoneuserworksimultaneouslyonanAtollproject,sharingdataoveranetwork.
Inlarge,structuredmultiuserenvironments,groupsofuserscanworkonspecificpartsofacommon,largescaleproject.For
example,differentusergroupscanworkondifferentregionsofacountrywidenetwork.Inthischapter,thefollowingare
explained:
"SettingUpMultiuserEnvironments"onpage 73
"ComponentsofMultiuserEnvironments"onpage 73
"ManagingUserAccountsandAccessRightsinOracle"onpage 75
6.1 SettingUpMultiuserEnvironments
The general process of setting up a multiuser environment is described below. Each component is described in detail in
"ComponentsofMultiuserEnvironments"onpage 73.
1. CreatethemasterAtolldocumentwiththerequirednetworkdataandgeographicdata.Formoreinformation,see
"MasterAtollDocument"onpage 74and"SharedGeographicData"onpage 74.
2. ExportthemasterAtolldocumenttoanewdatabaseandkeepthedocumentconnectedtothenewdatabase.For
moreinformation,see"MasterDatabase"onpage 74.
3. Create the private path loss matrices folder for the master Atoll document and calculate the private path loss
matrices.Formoreinformation,see"SharedPathLossMatrices"onpage 75.
4. Create user Atoll documents from the master database. For more information, see "User Atoll Documents" on
page 75.
5. IntheuserAtolldocuments,addtherequiredgeographicdataandsetthemasterAtolldocumentsprivatepathloss
matricesfolderasthesharedpathlossmatricesfolderoftheuserdocuments.
6.2 ComponentsofMultiuserEnvironments
Figure 6.1onpage 73showsthecomponentsofamultiuserenvironment.
TheAtolladministratorshouldregularlyupdatethesharedpathlossmatrices.
As the users work on the network and archive changes in the database, the Atoll
administrator should regularly run data integrity checks on the master Atoll
document after loading modified data from the master database. For more
information,see"Appendix1:CheckingDataIntegrity"onpage 79.
Figure 6.1:ComponentsofMultiuserEnvironments
74
Chapter6:MultiuserEnvironments Forsk2013
Inthissection,thefollowingareexplained:
"MasterAtollDocument"onpage 74
"MasterDatabase"onpage 74
"SharedGeographicData"onpage 74
"SharedPathLossMatrices"onpage 75
"UserAtollDocuments"onpage 75
6.2.1 MasterAtollDocument
It is the source Atoll document that contains the entire projects network data. It is created and maintained by the Atoll
administrator.Thisdocumentisinitiallyusedtocreatetheradionetworkdatabasewithwhichalltheenduserswork.The
masterAtolldocumentallowstheadministratortogloballymanageallthedatasharedbytheendusers.
The master Atoll document is also used for calculating path loss matrices for the transmitters of the entire network and
keepingthepathlossmatricesuptodatewiththeusermodificationstotheradionetworkdata.Thedocumentalsocontains
therequiredgeographicdataforpathlosscalculations.Geographicdataareusuallylocatedonfileserversandlinkedtothe
document,notembeddedintheATLfile.Theprivatepathlossmatricesofthisdocumentareusedassharedpathlossmatrices
by the endusers. The shared path loss matrices folder is usually located on a file server accessible to all the users on the
network.
Forexceptionallylargenetworks,youcanalsoworkwithmorethanonemasterAtolldocument(forexample,onemaster
documentperregion).However,themultiuserenvironmentsetupremainsthesame.MasterAtolldocumentsshouldnot
haveredundantradionetworkdata(samesites,forexample),andshouldideallycoverdifferentgeographicalregions.For
moreinformationonregionalisation,see"Appendix2:DatabaseRegionalisation"onpage 80.
6.2.2 MasterDatabase
The master database stores the radio network data shared by all the endusers. It can be created by exporting the radio
networkdatainthemasterAtolldocumenttoadatabasefromAtoll(formoreinformation,see"CreatingaNewDatabase
Using Atoll (All Supported RDBMs)" on page 55). An empty database can also be created using the Atoll Management
Console,andpopulatedwithdatalateron(formoreinformation,see"CreatingaNewDatabaseUsingtheAtollManagement
Console"onpage 53).
Onlyradionetworkdataarestoredinthedatabase,i.e.,sites,transmitters,antennas,etc.Parametersrelatedtogeographic
datafiles,theirpaths,folderconfigurations,predictiondefinitions,zones,trafficmaps,measurementscanbestoredinuser
configurationfiles(see"ConfigurationFiles"onpage 147fordetails).
Forlargenetworks,youcansubdividethenetworksmasterdatabaseintoregions.Formoreinformationonregionalisation,
see "Appendix 2: Database Regionalisation" on page 80. For more information on database management, see "Managing
Databases" on page 49. The recommended database server configuration is provided in "Recommended Hardware and
Software"onpage 26.
6.2.3 SharedGeographicData
Geographicdatafilesareusuallystoredonafileserveraccessibletoandsharedbyalltheusersworkingonthesamenetwork.
Userconfigurationfiles(CFGorGEO)areusedtostoretheparametersrelatedtogeographicdata.Formoreinformation,see
"ConfigurationFiles"onpage 147.
Theadministratorcansetupdifferentuserconfigurationfiles(CFG)forseparateusergroups.Userconfigurationfilescanbe
created so that only the geographic data required by a user are loaded. It is possible to load a user configuration file
automaticallywhenrunningAtoll.Userconfigurationfilescanbesharedandexchangedbetweenusersworkingonthesame
project.Formoreinformation,see"AtollCommandLineParameters"onpage 36.
Geographicdatafilesareusuallylargefiles,anditisrecommendedthatthesebestoredexternallyandnotembeddedinAtoll
documents.Therecommendedfileserverconfigurationisprovidedin"RecommendedHardwareandSoftware"onpage 26.
IfyouwishtoaddcustomfieldsintheAtolldocument,youshouldfirstaddthefieldin
thedatabase,andthenupdateyourAtolldocumentfromthedatabase.Customfields
addedinanAtolldocumentconnectedtoaMicrosoftAccessdatabaseareautomatically
addedtothedatabase.However,thisisnotthecasewithotherRDBMS,suchasOracle.
The same database server can be used to store one or more master databases
corresponding to different technologies. For example, a GSM database and a UMTS
databasecanbestoredonthesamedatabaseserverusingthesameRDBMS(Oracle,for
example).
75
6.2.4 SharedPathLossMatrices
Sharedpathlossmatricesareusuallystoredonafileserveraccessibletoandsharedbyalltheusersworkingonthesame
project.ThesepathlossesarecalculatedusingthemasterAtolldocumentbytheAtolladministrator.Theprivatepathloss
matricesofthemasterAtolldocumentareusedassharedpathlossmatricesbytheendusers.
TheAtolladministratoristheownerofthesharedpathlossmatrices,andmusthaveread/writeaccesstothesharedpath
lossmatricesfolder.Endusersshouldhavereadonlyaccesstothisfolder.
It is the administrators duty to regularly update the master Atoll document with the modifications made to the master
databasebytheendusers,andtocalculatethesharedpathlossmatricesusingthemasterAtolldocumentonaroutinebasis.
Thistaskcanbecarriedoutusingamacro.Formoreinformation,see"Appendix3:CalculatingPathLossMatrices"onpage 80.
Sharedpathlossmatricesareavailableforuseincalculationstoalltheendusers.However,endusersarenotallowedto
modifythesharedpathlossmatrices.
6.2.5 UserAtollDocuments
UserAtolldocumentsarecreatedfromthemasterdatabase.Thesecancontaintheentireprojectnetworkdataoronlyapart
ofit.UserdocumentsaretheworkingdocumentsoftheAtollendusersconnectedtothemasterdatabase,thegeographic
data,andthesharedpathlossmatricesfolder.
YoushouldloaddatafromthemasterdatabaseineachuserAtolldocumentandsaveitbeforesettingthesharedpathloss
matricesfolderforthedocument.ForanymodificationsmadebyendusersintheirAtolldocumentsthatrendersomeshared
pathlossesinvalid,Atollcalculatestheinvalidpathlossmatriceslocallyfortheendusersandstoresthemintheirprivatepath
loss matrices location. Shared path loss matrices are only used in calculations if valid private path loss matrices are not
available.Therefore,inordertousesharedpathlossmatrices,youmustdeletethecorrespondingprivatepathlossmatrices.
Ifusersaregoingtoworkonregionsofanetwork,theregionalisationshouldbesetupbeforecreatingtheuserdocuments.
Formoreinformationonregionalisation,see"Appendix2:DatabaseRegionalisation"onpage 80.
6.3 ManagingUserAccountsandAccessRightsinOracle
TheAtollManagementConsoleenablesyoutocreateanddeletedatabaseuseraccounts,edituseraccountinformation,and
defineuseraccessrightstodifferentcomponentsofaprojectsuchasdatabasetables,andradiodataandparametersinAtoll.
InordertobeabletomanageuseraccountsandaccessrightsusingtheAtollManagementConsole,youfirsthavetomake
thedatabasecompatiblewiththeusermanagementtool.Thisisdoneautomaticallywhentheusermanagementtoolisrun
onadatabaseforthefirsttime.ThedatabasehastobeofthesameversionastheAtollManagementConsolebeingusedto
manageuseraccountsandaccessrights.
Tomakeyourdatabasecompatiblewiththeusermanagementtool:
1. IntheAtollManagementConsolewindow,rightclickthedatabasewhoseuseraccountsyouwishtomanage.
2. SelectManageUsers.TheUserManagementdialogueappears(seeFigure 6.2onpage 76).
3. ClickYeswhenaskedwhetheryouwanttomakeyourdatabasecompatiblewiththeusermanagementtool.
TheAtollManagementConsoleaddsaGUIUserRightstableinthedatabasewiththefollowingstructure:
If users modify geographic data locally, for example edit clutter or traffic in their
respectiveprojects,theyshouldstorethesemodifiedgeographicdatalocallysothatthe
modificationsdonotimpactotherusers.
Thesharedpathlossmatricesmustbeunlockedinorderforuserstobeabletoworkwith
them.YoucancheckwhetherpathlossmatricesareunlockedinthePropagationtabof
theTransmittersfolderspropertiesdialogue.
IfyouwishtoaddcustomfieldsintheAtolldocument,youshouldfirstaddthefieldin
thedatabase,andthenupdateyourAtolldocumentfromthedatabase.Customfields
addedinanAtolldocumentconnectedtoaMicrosoftAccessdatabaseareautomatically
addedtothedatabase.However,thisisnotthecasewithotherRDBMS,suchasOracle.
ATOLL_USER Text(50) Nameoftheuseraccount
76
EachusersinterfaceaccessrightsarestoredinauniquerecordintheGUIUserRightstable.ThecontentsoftheRIGHTSfield
havethefollowingsyntax:
RADIOPARAMS;CALCPARAMS;PROPAGMODELS;PASSWORD
Thesyntaxisexplainedindetailin"DefiningDatabaseandInterfaceAccessRights"onpage 76.
If interface access rights are not defined for a database, i.e., the GUIUserRights table does not exist, all the users have
unrestrictedaccesstotheAtollinterface.
Ifinterfaceaccessrightsaredefinedforadatabase,andausercreatesadocumentfromthedatabaseoropensadocument
connectedtothedatabase,Atollretrievestheinterfaceaccessrightsfortheuserwhenheentershisusernameandpassword
toaccessthedatabase.
Ifthedatabaseisnotreachable,theuserisnotlistedintheGUIUserRightstable,orifthepasswordisnotcorrect,theusers
interface access rights are set to readonly by default (for more information, see "Defining Database and Interface Access
Rights"onpage 76).IftheuserislistedintheGUIUserRightstable,hisinterfaceaccessrightsarereadandappliedtotheAtoll
interface(tablegridsandpropertiesdialogues).AmessageisdisplayedintheEventViewerwindowtoinformtheuserofhis
interfaceaccessrights.Itispossibletoremoveinterfaceaccessrestrictionsbydisconnectingthedocumentfromthedatabase.
However,adisconnecteddocumentcannotbereconnectedtothedatabase.
TheGUIUserRightstableisalsostoredintheAtolldocument,andisupdatedwhenthedocumentissaved.Hence,userscan
workontheirdocumentswithoutactuallybeingconnectedtothedatabase,andstillhavetheirusualinterfaceaccessrights
appliedinthedocument.
Whendatabaseconnectionpropertiesaremodifiedforadocument,forexample,whenadifferentuserentershisusername
andpasswordintheconnectionproperties,Atollreadsandappliestheinterfaceaccessrightsdefinedforthenewuser.
6.3.1 DefiningDatabaseandInterfaceAccessRights
Foranyexistinguseraccount,youcansetthedatabaseandAtollinterfaceaccessrightsusingtheAtollManagementConsole.
TomanagedatabaseandAtollinterfaceaccessrightsforanexistinguseraccount:
1. IntheAtollManagementConsolewindow,rightclickthedatabasewhoseuseraccountsyouwishtomanage.
3. UnderAtollprojects,selecttheprojectforwhichyouwanttomanageuseraccounts.
RIGHTS Memo Semicolonseparatedsetofinterfaceaccessrights
Atolldoesnotaskfortheusernameandpasswordwhenadocumentisopenedusingthe
API.Theinterfaceaccessrightsstoredinthedocumentareused.
Figure 6.2:UserAccountandAccessRightsManagementDialogue
77
4. UnderListofusers,selecttheuseraccountwhosedatabaseandinterfaceaccessrightsyouwanttoset.
Userswhohavedatabaseaccessrightsintheselecteddatabasearemarkedwiththegreenicon( ).Userswhodo
nothaveanydatabaseaccessrightsintheselecteddatabase(Category=NoAccess)aremarkedwiththeredicon
( ).Locked(deactivated)useraccountsaremarkedwithayellowlockicon( ).Formoreinformationonlocked
useraccounts,see"CreatingandEditingUserAccounts"onpage 78.
YoucanusetheFilterlisttodisplay:
Allusers:Userswithaccess( ),withoutaccess( ),orlocked( )
Userswithaccess( )
Administrators:Userswithadministratorrightsamongtheuserswithaccess
Standardusers:Userswithstandardrightsamongtheuserwithaccess
Readonlyusers:Userswithreadonlyaccessrightsamongtheuserswithaccess
5. UnderDatabaserights,youcanselectadatabaseaccessRightscategory:
Noaccess:Userwithoutreadandwriteaccesstothedatabase.Thedatabaseisnotvisibletotheseusersandthey
arenotallowedtocreateAtolldocumentsbasedonthisdatabase.
Readonly:UsersallowedtocreateAtolldocumentsfromthedatabasebutwithoutwritepermissionstoanytable
ofthedatabase,i.e.,userscannotarchivechangesmadeintheAtolldocumenttothedatabase.
Standard:Userswithreadandwriteaccesstosometablesofthedatabase.Thesetablesincluderadionetwork
datatablesincludingsites,transmitters,cells,subcells,repeaters,remoteantennas,secondaryantennas,intra
andintertechnologyneighboursandexceptionalpairs,siteandtransmitterlists,microwavepointtopoint,point
tomultipoint,andmultihoplinks,microwaverepeaters,microwavehubs.
Administrator:Userswithreadandwriteaccesstoallthetablesofthedatabase.
DatabaseaccessrightsarestoredintheuseraccountpropertiesinOracle.IfyouareworkingwithanRDBMSother
thanOracle,youwillnotbeabletosetdatabaseaccessrights.Youcan,however,stillsetinterfaceaccessrightsas
explainedbelow.
6. UnderInterfacerights,youcanselectinterfaceaccessrightsfor:
Accesstoradiodata:
Full:(RADIOPARAMS=ALL)Userswithreadandwriteaccesstoallthetablesandpropertiesdialogues.
Standard: (RADIOPARAMS = STD) Users with read and write access to radio network data tables and
properties dialogues including sites, transmitters, cells, subcells, repeaters, remote antennas, secondary
antennas,intraandintertechnologyneighboursandexceptionalpairs,siteandtransmitterlists,microwave
pointtopoint,pointtomultipoint,andmultihoplinks,microwaverepeaters,microwavehubs.
Readonly:(RADIOPARAMS=NONE)Userswithreadonlyaccesstotablesandpropertiesdialogues,i.e.,users
arenotallowedtomodifyradionetworkdataandparameters.
Accesstocalculationsettings:
All: (CALCPARAMS = ALL) Users with read and write access to all coverage predictions, their calculation
settings, and to microwave calculation settings (Models, Objectives, and Clutter Categories tabs of the
PropertiesdialogueoftheMicrowaveRadioLinksfolder).
Standard:(CALCPARAMS=STD)Userswithaccesstocustomisedcoveragepredictionsonly,andallowedto
modifycoverageconditionsanddisplaysettings.Theseusersdonothaveaccesstothemicrowavecalculation
settingsmentionedabove.
Customisedonly:(CALCPARAMS=NONE)Userswithaccesstocustomisedcoveragepredictionsonly,butnot
allowedtomodifycoverageconditionsanddisplaysettings.Theseusersdonothaveaccesstothemicrowave
calculationsettingsmentionedabove.
Accesstopropagationmodels:
Full:(PROPAGMODELS=ALL)Userswithreadandwriteaccesstoallpropagationmodelsandtheirproperties.
Readonly:(PROPAGMODELS=NONE)Userswithreadonlyaccesstothepropertiesofallthepropagation
models.Addinganddeletingpropagationmodelsisalsonotallowed.
Passwordconfirmation:
Yes: (PASSWORD = STD) Atoll will ask users for password when opening a document connected to this
databaseorcreatinganewdocumentfromthisdatabase.
No:(PASSWORD=NONE)Atollwillnotaskusersforpasswordwhenopeningadocumentconnectedtothis
databaseorcreatinganewdocumentfromthisdatabase.
Database access rights and access rights to radio data in Atoll can be set
independently.Forexample,ausercanhavefullaccessrightsintheinterfacebutnot
beallowedtoarchivechangestothedatabase.
However,accessrightsintheinterfaceshouldonlybegrantediftheuserhasatleast
readonlyaccesstothedatabase.
78
7. ClickOK.Thedatabaseandinterfaceaccessrightsoftheselecteduseraresavedinthedatabase.
6.3.2 CreatingandEditingUserAccounts
YoucancreateandedituseraccountsusingtheAtollManagementConsole.
Tomanageuseraccounts:
1. IntheAtollManagementConsolewindow,rightclickthedatabasewhoseuseraccountsyouwanttomanage.
3. Tocreateanewuseraccount:
a. UnderUsers,clickCreate.TheCreate/EditUserdialogueappears(Figure 6.3onpage 78).
b. UnderIdentification,enteraUsername(inblockletters)andPassword,andselectaTablespaceforthenewuser
account.
c. UnderAdvanced,selectUseoperatingsystemauthenticationifyouwanttouseOSauthenticationprefixwiththe
username,andUnlimitedtablespaceprivilegeifyouwanttoassignthissystemprivilegetotheuser.
d. ClickOK.Thenewuseraccountiscreated.
4. Toeditauseraccount:
a. UnderListofusers,selecttheuseraccountwhoseinformationyouwanttoedit.
b. UnderUsers,clickEdit.TheCreate/EditUserdialogueappears(Figure 6.3onpage 78).
c. UnderIdentification,modifytheusersPasswordorassignedTablespace.
d. UnderAdvanced,selectUseoperatingsystemauthenticationifyouwanttouseOSauthenticationprefixwiththe
username,andUnlimitedtablespaceprivilegeifyouwanttoassignthissystemprivilegetotheuser.
e. ClickOK.Themodifieduseraccountinformationissaved.
5. Todeactivate(lock)auseraccount:
a. UnderListofusers,selecttheuseraccountyouwanttodeactivate.
b. UnderUsers,clickEdit.TheCreate/EditUserdialogueappears(Figure 6.3onpage 78).
c. UnderAdvanced,selectAccountlockedcheckbox.
d. ClickOK.Theuseraccountisdeactivatedandcannolongerbeused.
6. Todeleteauseraccount:
a. UnderListofusers,selecttheuseraccountyouwanttodelete.
b. UnderUsers,clickDelete.Theuseraccountisdeleted.
6.3.3 ResettingUserDatabasePermissions
Thepermissionsresetfeatureenablesyoutorebuilduserdatabasepermissionswhilekeepingexistingroleassignments.
YoucanresetuserpermissionsfromtheAtollManagementConsole.
Figure 6.3:CreatingorEditingaUserAccount
79
ThisfeatureisparticularlyusefulafteramajorAtollupgradeoraftertableswereaddedasaresultofaprojectcustomization,
andforallunforeseenreasonswhichcanrequirefixinguserdatabasepermissions.
Thepermissionsresetprocessdoesnotremoveanyobjectprivilegeswhichassignedpriortorebuildingthedatabase.Itjust
looksfornewobjectsandassignspermissionsbasedonexistinguserprofiles("Administrator","Standard"or"Readonly").
Toresetuserpermissions:
1. OpenthedatabaseforwhichyouwanttoresetuserpermissionsintheAtollManagementConsolewindow.
2. UnderDatabaserights,clickontheResetbutton.
3. Acknowledgethemessageinformingyouabouttherebuildingprocessduration.
6.4 Appendices
Thefollowingappendicesprovideadditionalinformationon:
"Appendix1:CheckingDataIntegrity"onpage 79
"Appendix2:DatabaseRegionalisation"onpage 80
"Appendix3:CalculatingPathLossMatrices"onpage 80
"Appendix4:PathLossMatricesFromDifferentSources"onpage 81
6.4.1 Appendix1:CheckingDataIntegrity
Atollincludesdataconsistencyandintegritycheckingtoolsthatallowyoutocheckdataconsistencybetweenthedifferent
Atolltables(Sites,Transmitters,etc.).ItisrecommendedthattheAtolladministratorrunsdataintegritychecksregularlyon
themasterAtolldocumentafteritisupdatedwithdatamodificationsinthemasterdatabase.
Toperformdataintegritycheck:
InAtoll,selectDocument >DataAudit >IntegrityCheck.
Atoll searches for records with integrity problems which can occur with objects that have foreign keys. Integrity
problemsoccurwhenrecordsreferrecordsthatdonotexist.Forexample,transmitterslocatedonsitesthatdonot
existintheSitestable,transmittersreferringtoanantennathatdoesnotexistintheAntennastable,etc.).Records
withintegrityproblemscanbedeletedwhenfound.
Toperformundefinedrecordcheck:
InAtoll,selectDocument >DataAudit >UndefinedRecordCheck.
Atoll searches for undefined records such as sites without transmitters, transmitters without subcells, TRXs, and
neighboursinGSM,transmitterswithoutcells,andcellswithoutneighboursinUMTS,CDMA2000,TDSCDMA,LTE,
WiMAX,andWiFi.AtolllistsalltheundefinedrecordsfoundintheEventViewer.
Toperformduplicaterecordcheck:
InAtoll,selectDocument >DataAudit >DuplicateRecordCheck.
Atollsearchesforrecordsthathavethesameidentifier.Forexample,siteswiththesamename,transmitterswiththe
samename,etc.AtolllistsalltheduplicaterecordsintheEventViewer.
Toperformmicrowavedatacheck:
1. InAtoll,selectDocument >DataAudit >MicrowaveLinkDataCheck.TheMicrowaveDataCheckdialogueappears.
2. IntheMicrowaveDataCheckdialogue,selectthedatatocheck.
3. SelectListallthecheckstolistallthechecksintheEventViewer.
4. ClickOK.
Atollsearchesthemicrowavelinkstablesforproblemsrelatedtotheselectedchecks.Atollliststheproblemsfound
intheEventViewer.
Thedurationofthedatabaserebuildingprocessdependsonthenumberofusersandon
thedatabaseprocessingspeed.
If you fix any problems in the Atoll document, you must archive the changes in the
databaseinordertofixtheproblemsforalltheusersworkingwiththatdatabase.
80
6.4.2 Appendix2:DatabaseRegionalisation
Youcansubdividethenetworkintoregionsinthefollowingways:
Staticregionalisationusingmultileveldatabases
Staticregionalisationcanbebasedonsitelists,SQLfilters,orgeographiczonesintheformoffilteringpolygons.Static
regionalisationiscarriedoutbycreatingprojectdatabasesfromthemasterdatabase,i.e.,multileveldatabasesas
explainedin"WorkingWithaMultilevelDatabases"onpage 59.
Static regionalisation requires manual synchronisation between the master database and the regional project
databasesusingtheAtollManagementConsole.Inamultileveldatabaseenvironment,endusersworkwithproject
databases,refreshingandarchivingdataastheycontinuetoworkontheirrespectiveregionsofthenetwork.Data
archive and refresh between the project databases and the master database are performed by the administrator
alone.
Advantage:Highperformance.
Disadvantage:ManualSynchronisationbetweenthemasterandtheprojectdatabases.
DynamicregionalisationusingOracleSpatialorOracleLocator
DynamicregionalisationcanbebasedonOracleSpatial,whichdoesnotcreateseparateregionaldatabasesfromthe
master database, but rather lets the different users work with the master database directly while managing their
accessprivilegesaccordingtotheiruserconnectionproperties.InanAtollmultiuserenvironment,youcancreate
suchregionalisationwithoutinstallingOracleSpatial.YoucanimplementthissolutionusingOracleLocator,whichis
providedinthestandardOracleinstallation.
Specific documents explaining how to set up this regionalisation, using Oracle, in any Atoll master database are
available on demand from Forsk. These documents provide scripts for creating different types of users, e.g., the
administrator,advanceduser,readonlyuser,etc.,andgiveexamplesofhowtosetupregionsinthenetworkandhow
toassignuserrightstoeachregion.
Advantage:Oncesetup,doesnotrequireadministratorintervention.
Disadvantage:Slowperformance(archivingdatainthedatabasetakesalongtime).
6.4.3 Appendix3:CalculatingPathLossMatrices
YoucancalculateonlytheinvalidpathlossmatricesorallthepathlossmatricesinAtollorusingamacro.
Tocalculateinvalidpathlossmatricesonly:
1. RightclicktheTransmittersfolder.Thecontextmenuappears.
2. SelectCalculations >CalculatePathLossMatrices.
Atollcalculatespathlossmatricesforallactivetransmittersinthefolderorsubfolder.Onlyinvalidandnonexistent
matricesarecalculated.
Tocalculateallthepathlossmatrices(validandinvalid):
1. RightclicktheTransmittersfolder.Thecontextmenuappears.
2. SelectCalculations >ForcePathLossMatrixCalculation.
Atollcalculatesallthepathlossmatricesforallactivetransmittersinthefolderorsubfolder.
Youcanwriteascriptormacrotoupdatepathlossmatricesautomaticallyatregularintervals.Thescriptormacroshould:
1. StartAtoll(Start).
2. OpenthemasterAtolldocument(Open).
3. Refreshthecontentsofthedocumentwithdatafromthedatabase(Refresh).
4. Calculatepathlossmatrices(Calculate).
5. SavethemasterAtolldocument(Save).
6. CloseAtoll(Exit).
ApathlossupdatemacroisavailablefromForskondemand.
Youshouldonlycalculatethesharedpathlossmatriceswhentheyarenotbeingaccessed
byusers.
81
6.4.4 Appendix4:PathLossMatricesFromDifferentSources
Atoll calculates path loss matrices and creates path loss matrix storage files using the propagation models assigned to
transmitters.Atollcanalsoworkwithpathlossmatricescalculatedbyothertools.Tousepathlossmatricesfromdifferent
sources,makesurethatthepathlossmatricesare:
AvailableinaformatcompatiblewithAtoll.Fileformatsaredescribedin"PathLossMatrixFileFormat"onpage 125.
StoredatthelocationsetintheAtolldocument.
Valid.Ifthepathlossmatricesarenotvalid,Atollwillautomaticallycalculatethemthenexttimetheyareused.
The shared path loss matrices architecture can contain path loss matrices from different sources. The Pathloss.dbf file
providesthemeanstomanageseveralsourcesofpathlossmatrices.Thisfilestores,amongotherinformation,thevalidity
statusandthelocation(path)ofthepathlossmatrixfilesforeachtransmitter.
LetusassumethatusersofgroupAwishtoworkwiththepathlossmatricesgeneratedbyAtollonly,andusersofgroupB
wish to work with path loss matrices generated by a different tool for a part of the network and with path loss matrices
generatedbyAtollwherethematricesfromtheothertoolarenotavailable.
Let us assume that the shared path loss matrices folder where Atoll stores the generated path loss matrices files is
C:\Path_Loss_Internal,andthefolderwheretheothertoolstoresitspathlossmatricesisC:\Path_Loss_External.
ThePathloss.dbffileinthePath_Loss_InternalfolderwillstorethepathtotheLOSfilesforeachtransmitterinthenetwork.
ThisfoldercanbesetasthesharedpathlossmatricesfolderintheATLfilesofgroupAusers.
TosetupthesharedpathlossmatricesfolderforgroupBusers,youmustcreateanewfolderwithaPathloss.dbffileinit.
ThisfoldercanbecalledC:\Path_Loss_Mixed.ThePathloss.dbffileinthisfoldercanbeacopyofthePathloss.dbffileinthe
Path_Loss_InternalfolderwiththepathstotheLOSfilesmodified.Forexample,ifthepathlossmatricesgeneratedbythe
other tool include Transmitter_1, the Pathloss.dbf file in the Path_Loss_Mixed folder will have all the same entries as
Pathloss.dbffileinthePath_Loss_InternalfolderexceptforthepathfortheTransmitter_1pathlossmatricesfile.Figure 6.4
onpage 81explainsthisconcept.
Once the Pathloss.dbf filein the Path_Loss_Mixedfolder isupdated with the correctpathscorresponding tothedifferent
transmitters,thePath_Loss_MixedfoldercanbesetasthesharedpathlossmatricesfolderintheATLfilesofgroupBusers.
IfagroupBuserchangessomeparameterswhichmakesomepathlossmatricesinvalid,Atollwillrecalculatetheprivatepath
lossmatriceswiththepropagationmodelsassignedtothetransmitters.Theexternalpathlossmatrixwillnolongerbeused.
YoushouldalsomakeregularbackupsofthemasterAtolldocument.Theabovemacro
couldalsocreateabackupATLfileofthemasterAtolldocumentonaregularbasis.This
filecanbeoverwrittendaily,wheneverpathlossesarecalculated.
Pathlossmatricescalculatedbyothertoolsshouldincludeantennapatternattenuation
(i.e.,shouldbemasked)inordertobeconsistentwiththepathlossmatricescalculated
byAtoll.
Figure 6.4:PathLossArchitectureforMultipleSourcePathLossMatrices
82
Part2
"Administration and Usage Recommendations"
onpage 137
"ConfigurationFiles"onpage 147
"InitialisationFiles"onpage 177
Reference
Thispartoftheadministratormanualprovidesrecommendationsand
informationonAtollconfigurationandinitialisationfiles.
AT320_AM_E2 Chapter7:CoordinateSystemsandUnits
85
7 CoordinateSystemsandUnits
7.1 CoordinateSystems
A map or a geospatial database is a flat representation of data collected over a curved surface. Projection is a means of
producingallorpartofaspheroidonaflatsurface,whichcannotbedonewithoutdistortion.Itisuptothecartographerto
choosethecharacteristic(distance,direction,scale,area,orshape)thathewantstoproduceaccuratelyonaflatsurfaceat
the expense of the other characteristics, or to make a compromise on several characteristics. The projected zones are
referencedusingcartographiccoordinates(metre,yard,etc.).Twoprojectionmethodsarewidelyused:
TheLambertConformalConicMethod:Aportionoftheearthisprojectedonaconeconceptuallysecantatoneor
twostandardparallels.Thisprojectionmethodisusefulforrepresentingcountriesorregionsthathaveapredominant
eastwestexpanse.
The Universal Transverse Mercator (UTM) Method: A portion of the earth is projected on a cylinder tangent to a
meridian(whichistransverseorcrosswisetotheequator).Thisprojectionmethodisusefulformappinglargeareas
thatareorientednorthsouth.
A geographic system is not a projection, but a representation of a location on the surface of the earth in geographic
coordinates(degreeminutesecond,gradient)withthelatitudeandlongitudewithrespecttoameridian(e.g.,ParisforNTF
systemandGreenwichforED50system).Locationsinageographicsystemcanbeconvertedintootherprojections.
7.1.1 DefinitionofaCoordinateSystem
Ageographiccoordinatesystemisalatitudeandlongitudecoordinatesystem.Thelatitudeandlongitudearerelatedtoan
ellipsoid,ageodeticdatum,andaprimemeridian.Thegeodeticdatumprovidesthepositionandorientationoftheellipsoid
relativetotheearth.
Cartographic coordinate systems are obtained by transforming each (latitude, longitude) value into an (easting, northing)
value.Aprojectioncoordinatesystemisobtainedbytransformingeach(latitude,longitude)valueintoan(easting,northing)
value. Projection coordinate systems are geographic coordinate systems that provide longitude and latitude, and the
transformationmethodcharacterisedbyasetofparameters.Differentmethodsmightrequiredifferentsetsofparameters.
Forexample,theparametersrequiredforTransverseMercatorcoordinatesystemsare:
Thelongitudeofthenaturalorigin(centralmeridian)
Thelatitudeofthenaturalorigin
TheFalseEastingvalue
TheFalseNorthingvalue
Ascalingfactoratthenaturalorigin(centralmeridian)
Basicdefinitionsarepresentedbelow.
GeographicCoordinateSystem
The geographic coordinate system is a datum and a meridian. Atoll enables you to choose the most suitable geographic
coordinatesystemforyourgeographicdata.
Datum
ThedatumconsistsoftheellipsoidanditspositionrelativetotheWGS84ellipsoid.Inadditiontotheellipsoid,translation,
rotation,anddistortionparametersdefinethedatum.
Meridian
ThestandardmeridianisGreenwich,butsomegeographiccoordinatesystemsarebasedonothermeridians.Thesemeridians
aredefinedbythelongitudewithrespecttoGreenwich.
References:
1. Snyder,John.P.,MapProjectionsUsedbytheUSGeologicalSurvey,2ndEdition,
UnitedStatesGovernmentPrintingOffice,Washington,D.C.,313pages,1982.
2. http://www.colorado.edu/geography/gcraft/notes/gps/gps_f.html
3. http://www.epsg.org/Geodetic.html
4. http://geodesie.ign.fr/contenu/fichiers/documentation/pedagogiques/
transfo.pdf(French)
86
Chapter7:CoordinateSystemsandUnits Forsk2013
Ellipsoid
Theellipsoidisthepatternusedtomodeltheearth.Itisdefinedbyitsgeometricparameters.
Projection
Theprojectionisthetransformationappliedtoprojecttheellipsoidoftheearthontoaplane.Therearedifferentprojection
methodsthatusespecificsetsofparameters.
ProjectionCoordinateSystem
The projection coordinate system is the result of the application of a projection to a geographic coordinate system. It
associatesageographiccoordinatesystemandaprojection.Atollenablesyoutochoosetheprojectioncoordinatesystem
matchingyourgeographicdata.
7.1.2 TypesofCoordinateSystemsinAtoll
Dependingontheworkingenvironment,therecanbeeithertwoorfourcoordinatesystemsusedinAtoll.Ifyouareworking
withstandalonedocuments,i.e.,documentsnotconnectedtodatabases,therearetwocoordinatesystemsusedinAtoll:
Projectioncoordinatesystem
Displaycoordinatesystem
Ifyouareworkinginamultiuserenvironment,Atollusesfourcoordinatesystems:
ProjectioncoordinatesystemfortheAtolldocument
DisplaycoordinatesystemfortheAtolldocument
Internalprojectioncoordinatesystemforthedatabase
Internaldisplaycoordinatesystemforthedatabase
ProjectionCoordinateSystem
Theprojectioncoordinatesystemisthecoordinatesystemoftheavailablerastergeographicdatafiles.Youshouldsetthe
projectioncoordinatesystemofyourAtolldocumentsothatitcorrespondstothecoordinatesystemoftheavailableraster
geographicdata.YoucansettheprojectioncoordinatesystemofyourdocumentintheOptionsdialog.
AlltherastergeographicdatafilesthatyouwanttoimportanduseinanAtolldocumentmusthavethesamecoordinate
system.Youcannotworkwithrastergeographicdatafileswithdifferentcoordinatesystemsinthesamedocument.
Theprojectioncoordinatesystemisusedtokeepthecoordinatesofsites(radionetworkdata)consistentwiththegeographic
data.
Whenyouimportarastergeographicdatafile,Atollreadsthegeoreferencinginformationfromthefile(orfromitsheader
file,dependingonthegeographicdatafileformat),i.e.,itsNorthwestpixel,todeterminethecoordinatesofeachpixel.Atoll
doesnotuseanycoordinatesystemduringtheimportprocess.However,thegeoreferencinginformationofgeographicdata
filesareconsideredtobeprovidedintheprojectioncoordinatesystemofthedocument.
DisplayCoordinateSystem
Thedisplaycoordinatesystemisthecoordinatesystemusedforthedisplay,e.g.,indialogs,intheMapwindowrulers,inthe
status bar,etc.The coordinates ofeachpixel ofgeographic dataareconverted tothe displaycoordinate systemfromthe
projectioncoordinatesystemfordisplay.Thedisplaycoordinatesystemisalsousedforsites(radionetworkdata).Youcan
setthedisplaycoordinatesystemofyourdocumentintheOptionsdialog.
Ifyouimportsitesdata,thecoordinatesystemofthesitesmustcorrespondtothedisplaycoordinatesystemofyourAtoll
document.
Ifyouchangethedisplaycoordinatesysteminadocumentwhichisnotconnectedtoadatabase,thecoordinatesofallthe
sitesareconvertedtothenewdisplaysystem.
If you import vector geographic data (e.g., traffic, measurements, etc.) with different
coordinatesystems,itispossibletoconvertthecoordinatesystemsofthesedatainto
theprojectioncoordinatesystemofyourAtolldocument.
Ifthecoordinatesystemsofallyourgeographicdatafilesandsites(radionetworkdata)
arethesame,youdonothavetodefinetheprojectionanddisplaycoordinatesystems
separately.Bydefault,thetwocoordinatesystemsarethesame.
87
InternalCoordinateSystems
Theinternalcoordinatesystemsaretheprojectionandthedisplaycoordinatesystemsstoredinadatabase.Theprojection
and display coordinate systems set by the administrator in the central Atoll project are stored in the database when the
database is created, and cannot be modified by users. Only the administrator can modify the internal coordinate systems
manuallybyeditingtheentriesintheCoordSysandtheUnitstables.AllAtolldocumentsopenedfromadatabasewillhave
theinternalcoordinatesystemsofthedatabaseastheirdefaultprojectionanddisplaycoordinatesystems.
WhenexportinganAtollprojecttoadatabase,thecurrentlychosendisplaycoordinatesystembecomestheinternaldisplay
coordinatesystemforthedatabase,andthecurrentlychosenprojectioncoordinatesystembecomestheinternalprojection
coordinatesystemforthedatabase.
AlthoughAtollstoresboththecoordinatesystemsinthedatabase,i.e.,theprojectionandthedisplaycoordinatesystems,
theonlyrelevantcoordinatesystemforthedatabaseistheinternaldisplaycoordinatesystembecausethiscoordinatesystem
istheoneusedforthecoordinatesofsites(radionetworkdata).
Usersworkingondocumentsconnectedtoadatabasecanmodifythecoordinatesystemsintheirdocumentslocally,andsave
thesechangesintheirdocuments,buttheycannotmodifythecoordinatesystemsstoredinthedatabase.
Ifyouchangethedisplaycoordinatesysteminadocumentwhichisnotconnectedtoadatabase,thecoordinatesofallthe
sitesareconvertedtothenewdisplaysystem.
Ifyouchangethedisplaycoordinatesysteminadocumentwhichisconnectedtoadatabase,thecoordinatesofallthesites
are converted to the new coordinate system in the Atoll document locally but not in the database because the internal
coordinatesystemscannotbechanged.
Atollusestheinternalcoordinatessystemsinordertokeepthesitecoordinatesconsistentinthedatabasewhichisusually
accessedbyalargenumberofusersinamultiuserenvironment.
7.1.3 CoordinateSystemsFileFormat
TheCoordsystemsfolderlocatedintheAtollinstallationdirectorycontainsallthecoordinatesystems,bothgeographicand
cartographic, offered in the tool. Coordinate systems are grouped by regions. A catalogue per region and a "Favourites"
catalogueareavailableinAtoll.TheFavouritescatalogueisinitiallyemptyandcanbefilledbytheuserbyaddingcoordinate
systems to it. Each catalogue is described by an ASCII text file with .cs extension. In a .cs file, each coordinate system is
describedinoneline.Thelinesyntaxfordescribingacoordinatesystemis:
Examples:
Youshouldkeepthefollowingpointsinmindwheneditingorcreating.csfiles:
The identification code enables Atoll to differentiate coordinates systems. In case you create a new coordinate
system,itscodemustbeanintegervaluehigherthan32767.
When describing a new datum, you must enter the ellipsoid code and parameters instead of the datum code in
brackets.Therecanbe3to7parametersdefinedinthefollowingorder:Dx,Dy,Dz,Rx,Ry,Rz,S.Thesyntaxoftheline
inthe.csfilewillbe:
Therecanbeuptosevenprojectionparameters.Theseparametersmustbeorderedaccordingtotheparameterindex
(see"ProjectionParameterIndices"onpage 90).Parameterwithindex0isthefirstone.Projectionparametersare
delimitedbycommas.
ForUTMprojections,youmustprovidepositiveUTMzonenumbersfornorthUTMzonesandnegativenumbersfor
southUTMzones.
Youcanaddallotherinformationascomments(suchasusageorregion).
Codesofunits,data,projectionmethods,andellipsoids,andprojectionparameterindicesarelistedinthetablesbelow.
Code =" Name of t he syst em"; Uni t Code; Dat umCode; Pr oj ect i on Met hod Code, Pr oj ect i on
Par amet er s; " Comment s"
4230 = " ED50" ; 101; 230; 1; " Eur ope - west "
32045 = " NAD27 / Ver mont " ; 2; 267; 6, - 72. 5, 42. 5, 500000, 0, 0. 9999643; " Uni t ed
St at es - Ver mont "
Code = " Name of t he syst em" ; Uni t Code; {El l i psoi d Code, Dx, Dy, Dz, Rx, Ry, Rz, S};
Pr oj ect i on Met hod Code, Pr oj ect i on Par amet er s; " Comment s"
88
UnitCodes
DatumCodes
Code CartographicUnits Code GeographicUnits
0 Metre 100 Radian
1 Kilometre 101 Degree
2 Foot 102 Grad
3 Link 103 ArcMinute
4 Chain 104 ArcSecond
5 Yard
6 Nauticalmile
7 Mile
1 Unspecified 1 Unspecified
Code Datum Code Datum
121 GreekGeodeticReferenceSystem1987 260 Manoca
125 Samboja 261 Merchich
126 Lithuania1994 262 Massawa
130 Moznet(ITRF94) 263 Minna
131 Indian1960 265 MonteMario
201 Adindan 266 M'poraloko
202 AustralianGeodeticDatum1966 267 NorthAmericanDatum1927
203 AustralianGeodeticDatum1984 268 NADMichigan
204 AinelAbd1970 269 NorthAmericanDatum1983
205 Afgooye 270 Nahrwan1967
206 Agadez 271 Naparima1972
207 Lisbon 272 NewZealandGeodeticDatum1949
208 Aratu 273 NGO1948
209 Arc1950 274 Datum73
210 Arc1960 275 NouvelleTriangulationFranaise
211 Batavia 276 NSWC9Z2
212 Barbados 277 OSGB1936
213 Beduaram 278 OSGB1970(SN)
214 Beijing1954 279 OS(SN)1980
215 ReseauNationalBelge1950 280 Padang1884
216 Bermuda1957 281 Palestine1923
217 Bern1898 282 PointeNoire
218 Bogota 283 GeocentricDatumofAustralia1994
219 BukitRimpah 284 Pulkovo1942
221 CampoInchauspe 285 Qatar
222 Cape 286 Qatar1948
223 Carthage 287 Qornoq
224 Chua 288 LomaQuintana
225 CorregoAlegre 289 Amersfoort
226 Coted'Ivoire 290 RT38
227 DeirezZor 291 SouthAmericanDatum1969
228 Douala 292 SapperHill1943
229 Egypt1907 293 Schwarzeck
230 EuropeanDatum1950 294 Segora
89
ProjectionMethodCodes
EllipsoidCodes
231 EuropeanDatum1987 295 Serindung
232 Fahud 296 Sudan
233 Gandajika1970 297 Tananarive1925
234 Garoua 298 Timbalai1948
235 GuyaneFrancaise 299 TM65
236 HuTzuShan 300 TM75
237 HungarianDatum1972 301 Tokyo
238 IndonesianDatum1974 302 Trinidad1903
239 Indian1954 303 TrucialCoast1948
240 Indian1975 304 Voirol1875
241 Jamaica1875 305 VoirolUnifie1960
242 Jamaica1969 306 Bern1938
243 Kalianpur 307 NordSahara1959
244 Kandawala 308 Stockholm1938
245 Kertau 309 Yacare
247 LaCanoa 310 Yoff
248 ProvisionalSouthAmericanDatum1956 311 Zanderij
249 Lake 312 MilitarGeographischeInstitut
250 Leigon 313 ReseauNationalBelge1972
251 Liberia1964 314 DeutscheHauptdreiecksnetz
252 Lome 315 Conakry1905
253 Luzon1911 322 WGS72
254 HitoXVIII1963 326 WGS84
255 HeratNorth 901 AncienneTriangulationFranaise
256 Mahe1971 902 NorddeGuerre
257 Makassar 903
NAD1927Guatemala/Honduras/Salvador
(PanamaZone)
258 EuropeanReferenceSystem1989
Code ProjectionMethod Code ProjectionMethod
0 Undefined 8 ObliqueStereographic
1 Noprojection>Longitude/Latitude 9 NewZealandMapGrid
2 LambertConformalConical1SP 10 HotineObliqueMercator
3 LambertConformalConical2SP 11 LabordeObliqueMercator
4 Mercator 12 SwissObliqueCylindrical
5 CassiniSoldner 13 ObliqueMercator
6 TransverseMercator 14 UTMProjection
7 TransverseMercatorSouthOriented
Code Name MajorAxis MinorAxis
1 Airy1830 6377563.396 6356256.90890985
2 AiryModified1849 6377340.189 6356034.44761111
3 AustralianNationalSpheroid 6378160 6356774.71919531
4 Bessel1841 6377397.155 6356078.96261866
5 BesselModified 6377492.018 6356173.50851316
6 BesselNamibia 6377483.865 6356165.38276679
Code Datum Code Datum
90
ProjectionParameterIndices
7.1.4 CreatingaCoordinateSysteminAtoll
Atollprovidesalargedefaultcatalogueofcoordinatesystems.However,itispossibletoaddnewgeographicandcartographic
coordinatesystems.Newcoordinatesystemscanbecreatedfromscratchorinitialisedbasedonexistingones.
Tocreateanewcoordinatesystemfromscratch:
1. SelectDocument >Properties.ThePropertiesdialogueopens.
2. SelecttheCoordinatestab.
3. ClicktheBrowsebutton( )totherightofProjection.TheCoordinateSystemsdialogueappears.
4. ClickNew.TheCoordinateSystemdialogueappears.
7 Clarke1858 6378293.63924683 6356617.98173817
8 Clarke1866 6378206.4 6356583.8
9 Clarke1866Michigan 6378693.7040359 6357069.45104614
10 Clarke1880(Benoit) 6378300.79 6356566.43
11 Clarke1880(IGN) 6378249.2 6356515
12 Clarke1880(RGS) 6378249.145 6356514.86954978
13 Clarke1880(Arc) 6378249.145 6356514.96656909
14 Clarke1880(SGA1922) 6378249.2 6356514.99694178
15 Everest1830(1937Adjustment) 6377276.345 6356075.41314024
16 Everest1830(1967Definition) 6377298.556 6356097.5503009
17 Everest1830(1975Definition) 6377301.243 6356100.231
18 Everest1830Modified 6377304.063 6356103.03899315
19 GRS1980 6378137 6356752.31398972
20 Helmert1906 6378200 6356818.16962789
21 IndonesianNationalSpheroid 6378160 6356774.50408554
22 International1924 6378388 6356911.94612795
23 International1967 6378160 6356774.71919530
24 Krassowsky1940 6378245 6356863.01877305
25 NWL9D 6378145 6356759.76948868
26 NWL10D 6378135 6356750.52001609
27 Plessis1817 6376523 6355862.93325557
28 Struve1860 6378297 6356655.84708038
29 WarOffice 6378300.583 6356752.27021959
30 WGS84 6378137 6356752.31398972
31 GEM10C 6378137 6356752.31398972
32 OSU86F 6378136.2 6356751.51667196
33 OSU91A 6378136.3 6356751.61633668
34 Clarke1880 6378249.13884613 6356514.96026256
35 Sphere 6371000 6371000
Index ProjectionParameter Index ProjectionParameter
0 UTMzonenumber 4 Scalefactoratorigin
0 Longitudeoforigin 4 Latitudeof1stparallel
1 Latitudeoforigin 5 Azimuthofcentralline
2 FalseEasting 5 Latitudeof2ndparallel
3 FalseNorthing 6 Anglefromrectifiedtoskewedgrid
Code Name MajorAxis MinorAxis
91
5. IntheCoordinateSystemdialogue:
a. Selectthecoordinatesystemscataloguetowhichyouwanttoaddthenewcoordinatesystem.
b. UnderGeneral,enteraNameforthenewcoordinatesystemandselectaUnit.InUse,youcanentercomments
aboutitsusage.Atollassignsthecodeautomatically.
c. Under Category, select the Type of coordinate system. Enter the longitude and latitude for a geographic
coordinatesystem,orthetypeofprojectionanditssetofassociatedparametersforacartographiccoordinate
system(falseeastingandnorthing,andthefirstandsecondparallels).
d. Under Geo, specify the meridian and choose a Datum for the coordinate system. The associated ellipsoid is
automaticallyselected.Youcanalsodescribeageodeticdatumbyselecting"<Customised>"intheDatumlist.In
this case, you must select an Ellipsoid and enter parameters (Dx, Dy, Dz, Rx, Ry, Rz, and S) needed for the
transformationofthedatumintoWGS84.
6. ClickOK.Thenewcoordinatesystemisaddedtotheselectedcoordinatesystemcatalogue.
To create a new coordinate system based on an existing system, select a coordinate system in the Coordinate Systems
dialoguebeforeclickingNewinstep 4.Thenewcoordinatesystemisinitialisedwiththevaluesoftheselectedcoordinate
system.
7.2 Units
IntheAtolldocuments,youcandefinemeasurementunitsforreception,transmission,antennagain,distance,heightand
offset, and temperature. You can accept the default measurement units, or you can change them using the document
propertiesdialogue.
TransmissionandReceptionPowerUnits
Dependingontheworkingenvironment,Atollcanuseeitheroneortwomeasurementunitsforthetransmission/reception
power.
Ifyouareworkingwithstandalonedocuments,i.e.,documentsnotconnectedtodatabases,thereisonlyonemeasurement
unitusedinAtollfordisplay.Itcorrespondstothetransmission/receptionpowerunitdefinedintheAtolldocument.
Ifyouareworkinginamultiuserenvironment,Atollusestwomeasurementunits:
A measurement unit for display in the Atoll document. It corresponds to the transmission/reception power unit
defined in the current Atoll document. It is used for the display in the dialogues and in the tables, e.g., reception
thresholds (coverage prediction properties, microwave link properties, etc.), and received signal levels
(measurements,pointanalysis,coveragepredictions,microwavelinkproperties,etc.).
Aninternalmeasurementunitforthedatabase.Theinternalunitisthetransmission/receptionpowerunitstoredin
thedatabase.Itcorrespondstothetransmission/receptionpowerunitusedinthemasterAtolldocumentwhenthe
database is created. Users working in documents connected to a database can modify the transmission/reception
powerunitandsavethischangeintheirdocumentslocally,buttheycannotmodifytheinternalpowerunitstoredin
thedatabase.OnlytheadministratorcanmodifyitmanuallybyeditingtheentryintheUnitstables.
AntennaGainUnits
Dependingontheworkingenvironment,Atollcanuseeitheroneortwomeasurementunitsfortheantennagain.
Ifyouareworkingwithstandalonedocuments,i.e.,documentsnotconnectedtodatabases,thereisonlyonemeasurement
unitusedinAtollfordisplay.ItcorrespondstotheantennagainunitdefinedintheAtolldocument.
Ifyouareworkinginamultiuserenvironment,Atollusestwomeasurementunits:
AmeasurementunitfordisplayintheAtolldocument.Itcorrespondstotheantennagainunitdefinedinthecurrent
Atolldocumentanditisusedforthedisplayinthedialoguesandinthetables.
Aninternalmeasurementunitforthedatabase.Theinternalunitistheantennagainunitstoredinthedatabase.It
correspondstotheantennagainunitusedinthemasterAtolldocumentwhenthedatabaseiscreated.Usersworking
in documents connected toa database can modify the antenna gainunit and save this change in their documents
locally,buttheycannotmodifytheantennagainunitstoredinthedatabase.Onlytheadministratorcanmodifyit
manuallybyeditingtheentryintheUnitstables.
DistanceUnits
Atolluses the distance unitdefinedinthe currentAtoll document as display unit of the distances in the dialogues, in the
tables,andinthestatusbar.
Metre is used as the internal measurement unit for the distance in all Atoll documents whether they are connected to
databasesornot.Theinternalmeasurementunitisnotstoredinthedatabaseandcannotbechanged.
92
HeightandOffsetUnits
AtollusestheheightandoffsetunitdefinedinthecurrentAtolldocumentasdisplayunitoftheheightsandtheoffsetsinthe
dialogues,inthetables,andinthestatusbar.
MetreisusedastheinternalmeasurementunitfortheheightsandoffsetsinallAtolldocumentswhethertheyareconnected
todatabasesornot.Theinternalmeasurementunitisnotstoredinthedatabaseandcannotbechanged.
TemperatureUnits
AtollusesthetemperatureunitdefinedinthecurrentAtolldocumentasdisplayunitofthetemperaturesinthedialogues
andinthetables.
Degree Celsius is used as the internal measurement unit for the temperature in all Atoll documents whether they are
connectedtodatabasesornot.Theinternalmeasurementunitisnotstoredinthedatabaseandcannotbechanged.
7.3 BSICFormat
Dependingontheworkingenvironment,therecanbeeitheroneortwotypesofBSICformats.Ifyouareworkingwithstand
alonedocuments,i.e.,documentsnotconnectedtodatabases,thereisonlyoneBSICformat:
DisplayBSICformat
Ifyouareworkinginamultiuserenvironment,Atollusestwotypeofformats:
DisplayBSICformatfortheAtolldocument
InternalBSICformatforthedatabase
Thedisplayformatisusedforthedisplayindialogsandtables.Youcansetthedisplayformatforyourdocumentfromthe
Transmittersfolderscontextmenu.
The internal format is the BSIC format stored in a database. The BSIC format set by the administrator in the central Atoll
projectisstoredinthedatabasewhenthedatabaseiscreated,andcannotbemodifiedbyusers.Onlytheadministratorcan
modifytheinternalformatmanuallybyeditingthecorrespondingentryintheUnitstables.AllAtolldocumentsopenedfrom
adatabasewillhavetheinternalformatofthedatabaseastheirdefaultBSICformat.
Usersworkingondocumentsconnectedtoadatabasecanmodifytheformatintheirdocumentslocally,andsavethischange
intheirdocuments,buttheycannotmodifytheformatstoredinthedatabase.
AT320_AM_E2 Chapter8:GeographicData
93
8 GeographicData
Atollsupportsseveralgeographicdatatypes;DTM(DigitalTerrainModel),clutter,scannedimages,vectordata,trafficmaps,
population, and custom geographic data. Atoll offers import/export filters for the most commonly used geographic data
formats.Thedifferentfiltersare:
8.1 DigitalTerrainModel(DTM)
TheDigitalTerrainModel(DTM)describesthegroundelevationabovethesealevel.DTMmapsaretakenintoaccountinpath
losscalculationsbyAtollpropagationmodels.
DTMfilesprovidealtitudevaluez(inmetre)onevenlyspacedpoints.Abscissaandordinateaxesarerespectivelyorientedin
rightanddownwardsdirections.SpacebetweenpointsisdefinedbypixelsizeP(inmetre).Pixelsizemustbethesameinboth
directions.Thefirstpointgiveninthefilecorrespondstothecentreofthetopleftpixelofthemap(northwestpointgeo
referencedbyAtoll).
FileFormat
Importand
Exportin
Atoll
GeographicData Georeferencing
BIL Both
DTM,clutterclasses,clutterheights,trafficmaps,
images,population,other
Yes
(viaHDRfiles)
TIFF Both
Yes
(viaTFWfiles)
Planet Both DTM,clutterclasses,images,vectordata
Yes
(viaindexfiles)
BMP Both
Yes
(viaBPWorBMWfiles)
DXF Import Vectordata,vectortrafficmaps Yes
SHP Both Vectordata,vectortrafficmaps,population,other Yes
MapInfo
(MIF,TAB)
Both Vectordata,vectortrafficmaps,population,other Yes
ErdasImagine
(IMG)
Import
Yes
ArcViewGrid
(TXT)
Export
Yes
(embeddedinthedatafile)
AtollGeoData
(AGD)
Both Vectordata,vectortrafficmaps,population,other
Yes
VerticalMapper
(GRD,GRC)
Both
Yes
ECW Import Images
Yes
(viaERSfiles)
PNG Both WMS,images
Yes
(viaPGWfiles)
JPEG Both WMS,images
Yes
(viaJGWfiles)
WLDfilescanbeusedforgeoreferencingforanytypeofbinaryrasterfile.
Thesmallestsupportedresolutionforrasterfilesis1 m.Thereisnorestrictiononthe
resolutionofimages.
DTM,clutterclasses,andclutterheightmapsmusthaveanintegerresolution.
AlltherastermapsyouwanttoimportinanATLdocumentmustberepresentedin
thesameprojectionsystem.
94
Chapter8:GeographicData Forsk2013
Fourpoints(hence,fouraltitudevalues)arenecessarytodescribeabin;thesepointsarebinvertices.Therefore,aDTMfile
thatcontainsNxNbinsrequiresN
2
points(altitudevalues).
DTMfileformatssupportedbyAtollare:
BIL(32bitsintegerandreal,16bitsinteger,8bitsinteger)
TIFF(16bitsinteger,8bitsinteger)
BMP(8bits)
ErdasImagine(32bitsintegerandreal,16bitsinteger,8bitsinteger)
VerticalMapper(GRD,GRC)
Planet(16bitsinteger)
8.2 ClutterClasses
Clutterclassesdescribethelandcover(denseurban,buildings,residential,forest,open,villages,etc.).Theclutterclassesmap
isagridrepresentingthegroundwitheachbinassignedaclutterclasscodecorrespondingtoitscluttertype.Itispossibleto
specifyanaverageheightforeachclutterclassinAtoll.Clutterclassmapsaretakenintoaccountinpathlosscalculationsby
Atollpropagationmodels.
Clutterclassfilesprovideacluttercodeperbin.BinsizeisdefinedbypixelsizeP(inmetre).Pixelsizemustbethesamein
bothdirections.Abscissaandordinateaxesarerespectivelyorientedinrightanddownwardsdirections.Thefirstpointgiven
inthefilecorrespondstothecentreofthetopleftpixelofthemap(northwestpointgeoreferencedbyAtoll.
Figure 8.1:DigitalTerrainModel
Figure 8.2:SchematicviewofaDTMfile
Altitudesmightdifferwithinasinglepixel.Themethodusedtocalculatealtitudesin
AtollisdescribedintheTechnicalReferenceGuide.
TodisplayaDTMmap,Atolltakesthealtitudeofthesouthwestpointofeachbinto
assignacolour.
InAtoll,DEM(DigitalElevationModel)isthesameasDigitalTerrainModel(DTM).In
literature,DEMandDTMdonotalwayshavethesamemeaning.Bydefinition,DEM
referstothealtitudeabovesealevelincludinggroundandclutter,whileDTMrefers
tothegroundaltitudeabovesealevelalone.
95
Atollsupportsamaximumof255clutterclasses(8bits/pixel).AclutterclassesfilefilethatcontainsNxNbinsrequiresN
2
codevalues.
ClutterclassesfileformatssupportedbyAtollare:
BIL(8bits)
TIFF(8bits)
BMP(8bit)
ErdasImagine(8bits)
Planet(16bits)
8.3 ClutterHeights
Clutterheightfilesprovideaclutterheightvalueperbin.BinsizeisdefinedbypixelsizeP(inmetre).Pixelsizemustbethe
sameinbothdirections.Abscissaandordinateaxesarerespectivelyorientedinrightanddownwardsdirections.Firstpoint
giveninthefilecorrespondstothecentreofthetopleftpixelofthemap(northwestpointgeoreferencedbyAtoll.Clutter
heightmapsaretakenintoaccountinpathlosscalculationsbyAtollpropagationmodels.
ClutterheightsfileformatssupportedbyAtollare:
BIL(32bitsintegerandreal,16bitsinteger,8bitsinteger)
TIFF(16bitsinteger,8bitsinteger)
BMP(8bits)
ErdasImagine(32bitsintegerandreal,16bitsinteger,8bitsinteger)
8.4 TrafficData
Atollsupportsdifferentkindsoftrafficmaps.Userprofiletrafficmapsbasedonuserprofiledensitiesandsectortrafficmaps
(vectortrafficmaps)supportthefollowingformats:
MIF/TAB
SHP
DXF
Planet
AGD
Figure 8.3:ClutterClasses
Thecluttercodeisthesameinsideabin.
Atoll considers the clutter height of the nearest point in calculations. The method
used to determine clutter heights in Atoll is described in the Technical Reference
Guide.
Todisplayaclutterheightmap,Atolltakesthealtitudeofthesouthwestpointofeach
bintoassignacolour.
96
Userprofiletrafficmapsbasedonuserprofileenvironments(rastertrafficmaps)supportthefollowingformats:
BIL(8bits)
TIFF(8bits)
BMP(8bits)
ErdasImagine(8bits)
Planet(16bits)
Userdensitytrafficmaps(rastertrafficmaps)supportthefollowingformats:
BIL(32bits,16bits)
TIFF(32bits,16bits)
BMP(32bits,16bits)
ErdasImagine(32bits,16bits)
8.5 VectorData
Vectordatacanbepolygons(regions,etc.),lines(roads,coastlines,etc.),orpoints(towns,etc.).Vectordatacanbeimported
inAtollfordisplayandtoprovideinformationaboutthegeographicenvironment.
VectorfileformatssupportedbyAtollare:
MIF/TAB
SHP
DXF
Planet
AGD
8.6 PopulationData
Populationdatadescribethepopulationdistribution(numberordensityofinhabitants).PopulataiondatacanbeusedinAtoll
inclutterstatisticsandcoveragepredictionreports.
PopulationdatarasterfileformatssupportedbyAtollare:
BIL(8,16,32bits)
TIFF(8,16,32bits)
BMP(8,32bits)
ErdasImagine(8,16,32bits)
PopulationdatavectorfileformatssupportedbyAtollare:
MIF/TAB
SHP
AGD
8.7 Images
Images include air and satellite images. Images can be imported in Atoll for display and to provide information about the
geographicenvironment.
ImagefileformatssupportedbyAtollare:
BIL(1,4,8,24bits)
TIFF(1,4,8,24bits)
BMP(1to24bits)
ErdasImagine(1,4,8,24bits)
ECW(EnhancedCompressedWavelet)(24bits)
Planet(1,4,8,24bits)
97
8.8 WebMapServices(WMS)Data
Webmapservicesprovideonlinemapsintheformofimages.WMSdatacanbeimportedinAtollfordisplayandtoprovide
informationaboutthegeographicenvironment.
WMSfileformatssupportedbyAtollare:
TIFF
BMP
PNG
JPEG
8.9 CustomData
Itispossibletoimportcustomgeographicdatatypes,otherthanthoselistedabove,inAtoll.Thesemapscanbetakeninto
accountinclutterstatisticsandcoveragepredictionreports.
CustomfileformatssupportedbyAtollare:
BIL(8,16,32bits)
TIFF(8,16,32bits)
BMP(8,32bits)
ErdasImagine(8,16,32bits)
MIF/TAB
SHP
AGD
8.10 GeographicDataFileFormats
8.10.1 BILFormat
BandInterleavedbyLineisamethodoforganizingimagedataformultibandimages.Itisaschemaforstoringtheactualpixel
valuesofanimageinafile.Thepixeldataistypicallyprecededbyafileheaderthatcontainsauxiliarydataabouttheimage,
suchasthenumberofrowsandcolumnsintheimage,acolourmap,etc.BILdatastorespixelinformationbandbybandfor
eachline,orrow,oftheimage.BILfilesareusuallybinaryfileswithoutheader.DataarestoredstartingfromtheNorthwest
cornerofthearea.
Although BIL is a data organisation schema, it is treated as an image format. An image description (number of rows and
columns,numberofbands,numberofbitsperpixel,byteorder,etc.)hastobeprovidedtobeabletodisplaytheBILfile.This
informationisincludedintheheaderHDRfileassociatedwiththeBILfile.AnHDRfilehasthesamenameastheBILfileit
refersto,andshouldbelocatedinthesamedirectoryasthesourcefile.TheHDRstructureissimple;itisanASCIItextfile
containingelevenlines.YoucanopenanHDRfileusinganyASCIItexteditor.
8.10.1.1 HDRHeaderFile
TheheaderfileisatextfilethatdescribeshowdataareorganisedintheBILfile.Theheaderfileismadeofrows,eachrow
havingthefollowingformat:
wherekeywordcorrespondstoanattributetype,andvaluedefinestheattributevalue.
KeywordsrequiredbyAtollaredescribedbelow.Otherkeywordsareignored.
keyword val ue
nrows Number of r ows i n t he i mage.
ncols Number of col umns i n t he i mage.
nbands Number of spect r al bands i n t he i mage, ( 1 f or DTM and 8 bi t pi ct ur es) .
nbits Number of bi t s per pi xel per band; 8 or 16 f or DTMs or Cl ut t er hei ght s
( al t i t ude i n met r es) , 8 f or cl ut t er cl asses f i l e ( cl ut t er code) , 16 f or
pat h l oss mat r i ces ( pat h l oss i n dB, f i el d val ue i n dBm, dBV and DBV/ m) .
byteorder Byt e or der i n whi ch i mage pi xel val ues ar e st or ed. Accept ed val ues ar e M
( Mot or ol a byt e or der ) or I ( I nt el byt e or der ) .
layout Must be bi l .
98
Fouradditionalkeywordscanoptionallybemanaged.
Thiscanbe:
Insomecases,thiskeywordcanbereplacedbydatatypedefinedasfollows:
Thiscanbe:
Theotheroptionalkeywordsare:valueoffset,valuescale,andnodatavalue.
Bydefault,integerdatatypesarechosenwithrespecttothepixellength(nbits).
So,wehave
DTMSample
Here,thedatais20 m.
ClutterClassesSample
skipbytes Byt e t o be ski pped i n t he i mage f i l e i n or der t o r each t he begi nni ng of
t he i mage dat a. Def aul t val ue i s 0.
ulxmap x coor di nat e of t he cent r e of t he upper - l ef t pi xel .
ulymap y coor di nat e of t he cent r e of t he upper - l ef t pi xel .
xdim x si ze i n met r e of a pi xel .
ydim y si ze i n met r e of a pi xel .
pixeltype Type of dat a r ead ( i n addi t i on t o t he l engt h)
UNSIGNDINT Undefined 8,16,24or32bits
SIGNEDINT Integer 16or32bits
FLOAT Real 32or64bits
datatype Type of dat a r ead ( i n addi t i on t o t he l engt h)
Un Undefined nbits(8,16,24or32bits)
In Integer nbits(16or32bits)
Rn Real nbits(32or64bits)
RGB24 Integer 3colourcomponentson24bits
valueoffset Real val ue t o be added t o t he r ead val ue ( V
read
)
valuescale Scal i ng f act or t o be appl i ed t o t he r ead val ue
nodatavalue Val ue cor r espondi ng t o NO DATA
nrows 1500
ncols 1500
nbands 1
nbits 8 or 16
byteorder M
layout bi l
skipbytes 0
ulxmap 975000
ulymap 1891000
xdim 20. 00
ydim 20. 00
nrows 1500
ncols 1500
nbands 1
V V
read
val uescal e val ueoffset + =
99
8.10.2 TIFFFormat
TaggedImageFileFormatsupportsallimagetypes(monochrome,greyscale,palettecolour,andRGBfullcolourimages).TIFF
files are not systematically georeferenced. You have to enter spatial references of the image manually during the import
procedure(xandyaxismapcoordinatesofthecentreoftheupperleftpixel,pixelsize);anassociatedfilewithTFWextension
willbesimultaneouslycreatedwiththesamenameandinthesamedirectoryastheTIFFfileitrefersto.Atollwillthenuse
theTFWfileduringtheimportprocedureforanautomaticgeoreferencing.
8.10.2.1 TFWHeaderFile
TFWfilescontainthespatialreferencedataofassociatedTIFFfiles.TheTFWfilestructureissimple;itisanASCIItextfilethat
containssixlines.YoucanopenaTFWfileusinganyASCIItexteditor.TheTFWfilestructureisasfollows:
8.10.3 BMPFormat
BMPformatsupportsblack&white,16,256andtruecolourimages.Theimagedatacaneithercontainpointerstoentries
inacolourtableorliteralRGBvalues.BMPfilesarenotsystematicallygeoreferenced.Youhavetoenterspatialreferences
oftheimagemanuallyduringtheimportprocedure(xandyaxismapcoordinatesofthecentreoftheupperleftpixel,pixel
nbits 8
byteorder M
layout bi l
skipbytes 0
ulxmap 975000
ulymap 1891000
xdim 20. 00
ydim 20. 00
TiledTIFFformatisnotsupported.
YoucanmodifythecolourpaletteconventionusedbyAtollwhenexportingTIFFfiles.
Formoreinformation,see"SettingtheTIFFColourConvention"onpage 178.
ItispossibletoimportPackbit,FAXCCITT3,andLZWcompressedTIFFfiles.However,
in case of DTM and clutter,it isrecommended touse uncompressed files for better
performance.Largeuncompressedfilescanbesplitintosmallerones.
IfyouareusingcompressedTIFFfiles,performancecanbeimprovedbyeitherhiding
the Status Bar or by hiding some of the information displayed in the Status Bar
(altitude, clutter class, or clutter height). For more information, see "Hiding
InformationDisplayedintheStatusBar"onpage 189.
CompressedTIFFfilescanbeexportedtouncompressedTIFFfilesusingAtoll.
Line Description
1 xdimensionofapixelinmapunits
2
a
a. Atolldoesnotusethelines2and3whenimportingaTIFFformatgeographicfile.
amountoftranslation
3 amountofrotation
4 negativeoftheydimensionofapixelinmapunits
5 xaxismapcoordinateofthecentreoftheupperleftpixel
6 yaxismapcoordinateofthecentreoftheupperleftpixel
100. 00
0. 00
0. 00
- 100. 00
60000. 00
2679900. 00
100
size).Whenexporting(saving)aBMPfile,anassociatedfilewithBPWextensioniscreatedwiththesamenameandinthe
samedirectoryastheBMPfileitrefersto.Atollstoresthegeoreferencinginformationinthisfileforfutureimportsofthe
BMPsothattheBPWfilecanbeusedduringtheimportprocedureforautomaticgeoreferencing.AtollalsosupportsBMW
extensionfortheBMPrelatedworldfiles.
8.10.3.1 BMPFileStructure
ABMPfilehasthefollowingdatastructure:
BITMAPFILEHEADER(bmfh)containssomeinformationaboutthebitmapfile(aboutthefile,notaboutthebitmap
itself).
BITMAPINFOHEADER(bmih)containsinformationaboutthebitmap(suchassize,colours,etc.).
RGBQUADcontainsacolourtable.
BYTEcontainstheimagedata(whoseformatisspecifiedbythebmihstructure).
Thefollowingtablesgiveexactinformationaboutthedatastructures.TheStartvalueisthepositionofthebyteinthefileat
which the explained data element of the structure starts, the Sizevalue contains the number of bytes used by this data
element,theNamecolumncontainsbothgenericnameandthenameassignedtothisdataelementbytheMicrosoftAPI
documentation,andtheDescriptioncolumngivesashortexplanationofthepurposeofthisdataelement.
BITMAPFILEHEADER(Header14bytes):
BITMAPINFOHEADER(InfoHeader40bytes):
Start Size
Name
Description
Generic MSAPI
1 2 Signature bfType Mustalwaysbesetto'BM'todeclarethatthisisaBMPfile
3 4 FileSize bfSize Specifiesthesizeofthefileinbytes.
7 2 Reserved1 bfReserved1 Notused.Mustbesettozero.
9 2 Reserved2 bfReserved2 Notused.Mustbesettozero.
11 4 DataOffset bfOffBits
Specifiestheoffsetfromthebeginningofthefiletothebitmap
rasterdata.
Start Size
Name
Description
Generic MSAPI
15 4 Size biSize
SpecifiesthesizeoftheBITMAPINFOHEADERstructure,inbytes(=
40bytes).
19 4 Width biWidth Specifiesthewidthoftheimage,inpixels.
23 4 Height biHeight Specifiestheheightoftheimage,inpixels.
27 2 Planes biPlanes
Specifiesthenumberofplanesofthetargetdevice,mustbesetto
zeroor1.
29 2 BitCount biBitCount
Specifiesthenumberofbitsperpixel.
1=monochromepallete.#ofcolours=1
4=4bitpalletised.#ofcolours=16
24=24bitpalletised.#ofcolours=16M
31 4 Compression biCompression
Specifiesthetypeofcompression,usuallysettozero.
0=BI_RGBnocompression
1=BI_RLE88bitRLEencoding
2=BI_RLE44bitRLEencoding
35 4 ImageSize biSizeImage
Specifiesthesizeoftheimagedata,inbytes.Ifthereisno
compression,itisvalidtosetthiselementtozero.
39 4 XpixelsPerM biXPelsPerMeter Specifiesthethehorizontalpixelspermeter.
43 4 YpixelsPerM biYPelsPerMeter Specifiesthetheverticalpixelspermeter.
47 4 ColoursUsed biClrUsed
Specifiesthenumberofcoloursactuallyusedinthebitmap.Ifsetto
zerothenumberofcoloursiscalculatedusingthebiBitCount
element.
51 4 ColoursImportant biClrImportant
Specifiesthenumberofcolourthatare'important'forthebitmap.If
settozero,allcoloursareconsideredimportant.
101
RGBQUADarray(ColorTable):
Pixeldata:
TheinterpretationofthepixeldatadependsontheBITMAPINFOHEADERstructure.Itisimportanttoknowthatthe
rowsofaBMParestoredupsidedownmeaningthattheuppermostrowwhichappearsonthescreenisactuallythe
lowermostrowstoredinthebitmap.Anotherimportantthingisthatthenumberofbytesinonerowmustalwaysbe
adjustedbyappendingzerobytestofitintotheborderofamultipleoffour(16bitor32bitrows).
8.10.3.2 BMPRasterDataEncoding
DependingontheimageBitCountandontheCompressionflagthereare6differentencodingschemes.Inallofthem,
Pixelsarestoredbottomup,lefttoright.
Pixellinesarepaddedwithzerostoendona32bitboundary.
Foruncompressedformatseverylinewillhavethesamenumberofbytes.
Colourindicesarezerobased,meaningapixelcolourof0representsthefirstcolourtableentry,apixelcolourof255
(iftherearethatmany)representsthe256thentry.Forimageswithmorethan256coloursthereisnocolourtable.
Start Size
Name
Description
Generic MSAPI
1 1 Blue rgbBlue Specifiesthebluepartofthecolour
2 1 Green rgbGreen Specifiesthegreenpartofthecolour
3 1 Red rgbRed Specifiestheredpartofthecolour
4 1 Reserved rgbReserved Mustalwaysbesettozero
In a colour table (RGBQUAD), the specification for a colour starts with the blue byte,
whileinapaletteacolouralwaysstartswiththeredbyte.
Encodingtype BitCount Compression Remarks
1bit
B&Wimages
1 0
Everybyteholds8pixels,itshighestorderbitrepresentingtheleftmost
pixelofthese8.Thereare2colourtableentries.Somereadersassumethat
0isblackand1iswhite.Ifyouarestoringblackandwhitepicturesyou
shouldsticktothis,withanyother2coloursthisisnotanissue.Remember
paddingwithzerosuptoa32bitboundary.
4bit
16colourimages
4 0
Everybyteholds2pixels,itshighorder4bitsrepresentingtheleftofthose.
Thereare16colourtableentries.Thesecoloursdonothavetobethe16
MSWindowsstandardcolours.Paddingeachlinewithzerosuptoa32bit
boundarywillresultinupto28zeros=7'wastedpixels'.
8bit
256colour
images
8 0
Everybyteholds1pixel.Thereare256colourtableentries.Paddingeach
linewithzerosuptoa32bitboundarywillresultinupto3bytesofzeros=
3'wastedpixels'.
16bit
Highcolour
images
16 0
Every2byteshold1pixel.Therearenocolourtableentries.Paddingeach
linewithzerosuptoa16bitboundarywillresultinupto2zerobytes.
24bit
Truecolour
images
24 0
Every4byteshold1pixel.Thefirstholdsitsred,theseconditsgreen,and
thethirditsblueintensity.Thefourthbyteisreservedandshouldbezero.
Therearenocolourtableentries.Nozeropaddingnecessary.
4bit
16colourimages
4 2
Pixeldataisstoredin2bytechunks.Thefirstbytespecifiesthenumberof
consecutivepixelswiththesamepairofcolour.Thesecondbytedefines
twocolourindices.Theresultingpixelpatternwillhaveinterleavedhigh
order4bitsandloworder4bits(ABABA...).Ifthefirstbyteiszero,the
seconddefinesanescapecode.TheEndofBitmapiszeropaddedtoendon
a32bitboundary.Duetothe16bitnessofthisstructurethiswillalwaysbe
eithertwozerobytesornone.
8bit
256colour
images
8 1
Thepixeldataisstoredin2bytechunks.Thefirstbytespecifiesthenumber
ofconsecutivepixelswiththesamecolour.Thesecondbytedefinestheir
colourindices.Ifthefirstbyteiszero,theseconddefinesanescapecode.
TheEndofBitmapiszeropaddedtoendona32bitboundary.Duetothe
16bitnessofthisstructurethiswillalwaysbeeithertwozerobytesornone.
102
8.10.3.3 RasterDataCompression
Thefollowingtableprovidesthedescriptionoftherasterdatacompressionfor4bit,16colourimages:
Thefollowingtableprovidesthedescriptionoftherasterdatacompressionfor8bit,256colourimages:
8.10.3.4 BPW/BMWHeaderFile
TheheaderfileisatextfilethatdescribeshowdataareorganisedintheBMPfile.Theheaderfileismadeofrows,eachrow
havingthefollowingdescription:
AtollsupportsBPWandBMWheaderfileextensionsforImport,butexportsheaderswithBPWfileextensions.
8.10.4 PNGFormat
PortableNetworkGraphics(PNG)isabitmappedimageformatthatemployslosslessdatacompression.PNGsupportspalette
based (palettes of 24bit RGB or 32bit RGBA colors), greyscale, RGB, or RGBA images. PNG was designed for transferring
imagesontheInternet,notprofessionalgraphics,andsodoesnotsupportothercolorspaces(suchasCMYK).
Whenexporting(saving)aPNGfile,anassociatedfilewithPGWextensioniscreatedwiththesamenameandinthesame
directoryasthePNGfileitrefersto.AtollstoresthegeoreferencinginformationinthisfileforfutureimportsofthePNGso
thatthePGWfilecanbeusedduringtheimportprocedureforautomaticgeoreferencing.
n(Byte1) c(Byte2) Description
>0 any
npixelstobedrawn.The1st,3rd,5th,...pixels'colourisinc'shighorder4bits,theevenpixels'
colourisinc'sloworder4bits.Ifbothcolourindicesarethesame,itresultsinjustnpixelsofcolour
c.
0 0 Endofline
0 1 EndofBitmap
0 2
Delta.Thefollowing2bytesdefineanunsignedoffsetinxandydirection(ybeingup).Theskipped
pixelsshouldgetacolourzero.
0 >=3
Thefollowingcbyteswillbereadassinglepixelcoloursjustasinuncompressedfiles.Upto12bits
ofzerosfollow,toputthefile/memorypointerona16bitboundaryagain.
n(Byte1) c(Byte2) Description
>0 any npixelsofcolournumberc
0 0 Endofline
0 1 EndofBitmap
0 2
Delta.Thefollowing2bytesdefineanunsignedoffsetinxandydirection(ybeingup).Theskipped
pixelsshouldgetacolourzero.
0 >=3
Thefollowingcbyteswillbereadassinglepixelcoloursjustasinuncompressedfiles.Azero
follows,ifcisodd,puttingthefile/memorypointerona16bitboundaryagain.
Line Description
2 amountoftranslation
3 amountofrotation
100. 00
0. 00
0. 00
- 100. 00
60000. 00
2679900. 00
103
FormoreinformationonthePNGfileformat,seewww.w3.org/TR/PNG/.
8.10.4.1 PGWHeaderFile
A PNG world file (PGW file) is a plain text file used by geographic information systems (GIS) to provide georeferencing
informationforrastermapimagesinPNGformat.Theworldfileparametersare:
8.10.5 JPEGFormat
TheJPEGimagefileformatisbasedonamethodoflossycompressionfordigitalimagescreatedbytheJointPhotographic
Experts Group (JPEG). The JPEG standard allows for an adjustable degree of compression which provides a possibility for
tradeoffbetweenstoragesizeandimagequality.JPEGisthemostcommonimageformatusedbydigitalcamerasandother
photographicimagecapturedevices.Itisalsothemostcommonformatforstoringandtransmittingphotographicimageson
theWorldWideWeb.
Whenexporting(saving)aJPEGfile,anassociatedfilewithJGWextensioniscreatedwiththesamenameandinthesame
directoryastheJPEGfileitrefersto.AtollstoresthegeoreferencinginformationinthisfileforfutureimportsoftheJPEGso
thattheJGWfilecanbeusedduringtheimportprocedureforautomaticgeoreferencing.
8.10.5.1 JGWHeaderFile
A JPEG world file (JGW file) is a plain text file used by geographic information systems (GIS) to provide georeferencing
informationforrastermapimagesinJPEGformat.Theworldfileparametersare:
8.10.6 DXFFormat
AtolliscapableofimportingandworkingwithAutoCADdrawingsintheDrawingInterchangeFormat(DXF).DXFfilescanhave
ASCIIorbinaryformats.ButonlytheASCIIDXFfilescanbeusedinAtoll.
DXFfilesarecomposedofpairsofcodesandassociatedvalues.Thecodes,knownasgroupcodes,indicatethetypeofvalue
thatfollows.DXFfilesareorganisedintosectionsofrecordscontainingthegroupcodesandtheirvalues.Eachgroupcodeand
valueisaseparateline.
Each section starts with a group code 0 followed by the string, SECTION. This is followed by a group code 2 and a string
indicatingthenameofthesection(forexample,HEADER).Eachsectionendswitha0followedbythestringENDSEC.
8.10.7 SHPFormat
ESRI (Environmental Systems Research Institute, Inc.) ArcView GIS Shape files have a simple, nontopological format for
storinggeometriclocationsandattributeinformationofgeographicfeatures.Ashapefileisoneofthespatialdataformats
thatyoucanworkwithinArcExplorer.SHPfilesusuallyhaveassociatedSHXandDBFfiles.TheSHPfilestoresthefeature
geometry,theSHXfilestorestheindexofthefeaturegeometry,andtheDBFfilestorestheattributeinformationoffeatures.
Whenashapefileisaddedasathemetoaview,thisfileisdisplayedasafeaturetable.
YoucandefinemappingsbetweenthecoordinatesystemusedfortheESRIvectorfiles,definedinthecorrespondingPRJfiles,
andAtoll.Inthisway,whenyouimportavectorfile,Atollcandetectthecorrectcoordinatesystemautomatically.Formore
Line Description
3 amountofrotation
Line Description
3 amountofrotation
104
informationaboutdefiningthemappingbetweencoordinatesystems,see"MappingAtollCoordinateSystemswithMapInfo/
ESRIVectorFiles"onpage 180.
8.10.8 MIFFormat
MapInfoInterchangeFormat(MIF)allowsvarioustypesofdatatobeattachedtoavarietyofgraphicalitems.TheseASCIIfiles
are editable, easy to generate, and work on all platforms supported by MapInfo. Two files, a MIF and a MID file, contain
MapInfodata.GraphicsresideintheMIFfilewhilethetextcontentsarestoredintheMIDfile.Thetextdataisdelimitedwith
onerowperrecord,andCarriageReturn,CarriageReturnplusLineFeed,orLineFeedbetweenlines.TheMIFfilehastwo
sections,thefileheaderandthedatasection.TheMIDfileisoptional.WhenthereisnoMIDfile,allfieldsareblank.Youcan
findmoreinformationathttp://www.mapinfo.com.
YoucandefinemappingsbetweenthecoordinatesystemusedfortheMapInfovectorfiles,definedinthecorrespondingMIF
files,andAtoll.Inthisway,whenyouimportavectorfile,Atollcandetectthecorrectcoordinatesystemautomatically.For
more information about defining the mapping between coordinate systems, see "Mapping Atoll Coordinate Systems with
MapInfo/ESRIVectorFiles"onpage 180.
8.10.9 TABFormat
TABfiles(MapInfoTables)arethenativeformatofMapInfo.Theyactuallyconsistofanumberoffileswithextensionssuch
asTAB,DAT,andMAP.Allofthesefilesneedtobepresentandkepttogetherforthetabletowork.Thesearedefinedas
follows:
TAB:tablestructureinASCIIformat
DAT:tabledatastorageinbinaryformat
MAP:storageofmapobjectsinbinaryformat
ID:indextotheMapInfographicalobjects(MAP)file
IND:indextotheMapInfotabular(DAT)file
Youcanfindmoreinformationathttp://www.mapinfo.com.
YoucandefinemappingsbetweenthecoordinatesystemusedfortheMapInfovectorfiles,definedinthecorrespondingMIF
files,andAtoll.Inthisway,whenyouimportavectorfile,Atollcandetectthecorrectcoordinatesystemautomatically.For
more information about defining the mapping between coordinate systems, see "Mapping Atoll Coordinate Systems with
MapInfo/ESRIVectorFiles"onpage 180.
TAB files are also supported as georeference information files for raster files (BMP and TIFF). The TAB file must have the
followingformat:
Thefieldsinboldaredescribedbelow:
! t abl e
! ver si on 300
! char set Wi ndowsLat i n1
Def i ni t i on Tabl e
Fi l e "raster.bmp"
Type " RASTER"
(ulxmap,ulymap) ( 0, 0) Label " Pt 1" ,
(llxmap,llymap) (0, nrows) Label " Pt 2" ,
(lrxmap,lrymap) (ncols,nrows) Label " Pt 3" ,
(urxmap,urymap) (ncols, 0) Label " Pt 4"
Field Description
File"raster.bmp" Nameoftherasterfile(e.g.,raster.bmp)
ulxmap xcoordinateofthecentreoftheupperleftpixelinmetres
ulymap ycoordinateofthecentreoftheupperleftpixelinmetres
llxmap xcoordinateofthecentreofthelowerleftpixelinmetres
llymap ycoordinateofthecentreofthelowerleftpixelinmetres
lrxmap xcoordinateofthecentreofthelowerrightpixelinmetres
lrymap ycoordinateofthecentreofthelowerrightpixelinmetres
urxmap xcoordinateofthecentreoftheupperrightpixelinmetres
urymap ycoordinateofthecentreoftheupperrightpixelinmetres
105
8.10.10 ECWFormat
The Enhanced Compressed Wavelet (ECW) files are georeferenced image files. The ECW format is developed by Earth
ResourceMapping.ECWcancompressimageswithuptoa100to1compressionratio.Eachcompressedimagefilecontains
aheadercarryingthefollowinginformationabouttheimage:
Theimagesizeexpressedasthenumberofcellsacrossanddown
Thenumberofbands(RGBimageshavethreebands)
Theimagecompressionrate
Thecellmeasurementunits(meters,degreesorfeet)
Thesizeofeachcellinmeasurementunits
Coordinatespaceinformation(Projection,Datumetc.)
8.10.11 ErdasImagineFormat
Erdas Imagine IMG files use the Erdas Imagine Hierarchical File Format (HFA) structure. For any type of file, if there are
pyramids(storageofdifferentresolutionlayers),theyareusedtoenhanceperformancewhendecreasingtheresolutionof
thedisplay.SomeaspectsofworkingwithErdasImagineformatinAtollare:
Atollsupportsuncompressedaswellascompressed(orpartiallycompressed)IMGfilesforDTM.
YoucancreateanMNUfiletoimprovetheclutterclassmaploading.
Thecolourtocodeassociation(rastermaps)canbeautomaticallyimportedfromtheIMGfile.
Thesefilesareautomaticallygeoreferenced,i.e.,theydonotrequireanyadditionalfileforgeoreference.
Forimagefiles,thenumberofsupportedbandsiseither1(colourpaletteisdefinedseparately)or3(nocolourpalettebut
directRGBinformationforeachpixel).Incaseof3bands,only8bitperpixelformatissupported.Therefore,8bitimages,
containingRGBinformation(threebandsareprovided:thefirstbandisforBlue,thesecondoneisforGreenandthethirdfor
Red),canbeconsideredas24bitperpixelfiles.32bitperpixelfilesarenotsupported.
8.10.12 PlanetEV/VerticalMapperGeographicDataFormat
VerticalMapperofferstwotypesofgrids:
Numericalcontinuousgrids,whichcontainnumericalinformation(suchasDTM),andarestoredinfileswiththeGRD
extension.
Classifiedgrids,whichcontainalphanumeric(characters)information,andarestoredinfileswiththeGRCextension.
Atoll is capable of supporting the Vertical Mapper Classified Grid (GRC) and Vertical Mapper Continuous Grid (GRD) file
formatsinordertoimportandexport:
GRD:DTM,image,population,trafficdensity,andotherdatatypes.
GRC:DTM,clutterclasses,clutterheights,environmenttraffic,image,population,andotherdatatypes.
ItisalsopossibletoexportcoveragepredictionsinGRDandGRCformats.
ThisisthegeographicdataformatusedbyPlanetEV.So,itispossibletodirectlyimportgeographicdatafromPlanetEVto
Atollusingthisformat.
8.10.13 ArcViewGridFormat
TheArcViewGridformat(TXT)isanASCIIformatdedicatedtodefiningrastermaps.Itcanbeusedtoexportanyrastermap
such as DTM, images, clutter classes and/or heights, population, other data maps, and even coverage predictions. The
contentsofanArcViewGridfileareinASCIIandconsistofaheader,describingthecontent,followedbythecontentinthe
formofcellvalues.
Theformatofthesefilesisasfollows:
nrows Numberofrowsintheimage
ncols Numberofcolumnsintheimage
Field Description
If you are using compressed Erdas Imagine files, performance can be improved by
either hiding the Status Bar or by hiding some of the information displayed in the
StatusBar(altitude,clutterclass,orclutterheight).Formoreinformation,see"Hiding
InformationDisplayedintheStatusBar"onpage 189.
CompressedfilescanbeexportedtouncompressedfilesusingAtoll.
106
Sample
8.10.14 OtherFileFormats
AtollsupportsISTandDISformats.TheseareASCIIfilesusedforDigitalTerrainModelsonly.ISTimagescomefromIstarand
DISimagescomefromIGN(InstitutGographiqueNational).TheISTformatworksinexactlythesamewayastheBILformat,
exceptforDTMimages.ForDTMimages,theISTformatusesadecimetriccodingforaltitudes,whereasBILimagesuseonly
ametriccoding.
8.10.15 GenericRasterHeaderFile
WLDisanewAtollspecificheaderformatthatcanbeusedforanyrasterdatafileforgeoreferencing.Atthetimeofimport
ofanyrasterdatafile,AtollcanusethecorrespondingWLDfiletoreadthegeoreferencinginformationrelatedtotheraster
datafile.TheWLDfilecontainsthespatialreferencedataofanyassociatedrasterdatafile.TheWLDfilestructureissimple;
itisanASCIItextfilecontainingsixlines.YoucanopenaWLDfileusinganyASCIItexteditor.
TheWLDfileisatextfilethatdescribeshowdataareorganisedintheassociatedrasterdatafile.Theheaderfileismadeof
rows,eachrowhavingthefollowingdescription:
ClutterClassesFileSample
ncols XXX Number of col umns of t he gr i d ( XXX col umns) .
nrows XXX Number of r ows of t he gr i d ( XXX r ows) .
xllcenter XXX OR
xllcorner XXX Si gni f i cant val ue r el at i ve t o t he bi n cent r e or cor ner .
yllcenter OR
yllcorner XXX Si gni f i cant val ue r el at i ve t o t he bi n cent r e or cor ner .
cellsize XXX Gr i d r esol ut i on.
nodata_value XXXOpt i onal val ue cor r espondi ng t o no dat a ( no i nf or mat i on) .
//Row 1 Top of t he r ast er . Descr i pt i on of t he f i r st r ow. Synt ax: ncol s number of
val ues separ at ed by spaces.
:
:
//Row N Bot t omof t he r ast er .
ncol s 303
nr ows 321
xl l cor ner 585300. 000000
yl l cor ner 5615700. 000000
cel l si ze 100. 000000
nodat a_val ue 0
. . .
Line Description
3 amountofrotation
100. 00
0. 00
0. 00
- 100. 00
60000. 00
107
8.10.16 PlanetFormats
ThePlanetgeographicdataaredescribedbyasetoffilesstoredinthesamelocation.Thedirectorystructuredependsonthe
geographicdatatype.
8.10.16.1 DTMFiles
TheDTMdirectoryconsistsofthreefiles;theheightfileandtwootherfilesdetailedbelow:
Theindexfilestructureissimple;itisanASCIItextfilethatholdspositioninformationaboutthefile.Itcontainsfive
columns.YoucanopenanindexfileusinganyASCIItexteditor.Theformatoftheindexfileisasfollows:
Theprojectionfileprovidesinformationabouttheprojectionsystemused.Thisfileisoptional.ItisanASCIItextfile
withfourlinesmaximum.
Sample
Indexfileassociatedwithheightfile(DTMdata):
Projectionfileassociatedwithheightfile(DTMdata):
8.10.16.2 ClutterClassFiles
TheClutterdirectoryconsistsofthreefiles;theclutterfileandtwootherfilesdetailedbelow:
Themenufile,anASCIItextfile,definesthefeaturecodesforeachtypeofclutter.Itconsistsofasmanylines(with
thefollowingformat)astherearecluttercodesintheclutterdatafiles.Thisfileisoptional.
2679900. 00
Filename Text Nameoffilereferencedbytheindexfile
Eastmin Float xaxismapcoordinateofthecentreoftheupperleftpixelinmeters
Eastmax Float xaxismapcoordinateofthecentreoftheupperrightpixelinmeters
Northmin Float yaxismapcoordinateofthecentreofthelowerleftpixelinmeters
Northmax Float yaxismapcoordinateofthecentreoftheupperleftpixelinmeters
Squaresize Float Dimensionofapixelinmeters
Line Description
Spheroid
Zone
Projection
Centralmeridian
Latitudeandlongitudeofprojectioncentralmeridianandequivalentxandycoordinatesinmeters
(optional)
Intheassociatedbinaryfile,thevalue9999correspondstoNodatawhichissupported
byAtoll.
sydney1 303900 343900 6227900 6267900 50
Aust r al i an- 1965
56
UTM
0 153 500000 10000000
Cluttercode Integer(>1) Identificationcodeforclutterclass
Featurename Text(32) Nameassociatedwiththecluttercode.(Itcancontainspaces)
108
Theindexfilegivesclutterspatialreferences.ThestructureofclutterindexfileisthesameasthestructureofDTM
indexfile.
Sample
Menufileassociatedwiththeclutterfile:
8.10.16.3 VectorFiles
Vectordatacomprisesterrainfeaturessuchascoastlines,roads,etc.Eachofthesefeaturesisstoredinaseparatevectorfile.
Fourtypesoffilesareused,thevectorfile,wherexandycoordinatesofvectorpathsarestored,andthreeotherfilesdetailed
below:
Themenufile,anASCIItextfile,liststhevectortypesstoredinthedatabase.Themenufileiscomposedofoneor
morerecordswiththefollowingstructure:
Thefieldsareseparatedbyspacecharacter.
Theindexfile,anASCIItextfile,liststhevectorfilesandassociateseachvectorfilewithonevectortype,andoptionally
withoneattributefile.Theindexfileconsistsofoneormorerecordswiththefollowingstructure:
Intheassociatedbinaryfile,thevalue9999correspondstoNodatawhichissupported
byAtoll.
1 open
2 sea
3 i nl andwat er
4 r esi dent i al
5 meanur ban
6 denseur ban
7 bui l di ngs
8 vi l l age
9 i ndust r i al
10 openi nur ban
11 f or est
12 par ks
13 denseur banhi gh
14 bl ockbui l di ngs
15 densebl ockbui l d
16 r ur al
17 mi xedsubur ban
Vectortypecode Integer(>0) Identificationcodeforthevectortype
Vectortype
name
Text(32) Nameofthevectortype
Vectorfilename Text(32) Nameofthevectorfile
Attributefile
name
Text(32) Nameofattributefileassociatedwiththevectorfile(optional)
Dimensions Real
eastmin:minimumxaxiscoordinateofallvectorpathpointsinthevectorfile
eastmax:maximumxaxiscoordinateofallvectorpathpointsinthevectorfile
northmin:minimumyaxiscoordinateofallvectorpathpointsinthevectorfile
northmax:maximumyaxiscoordinateofallvectorpathpoints
Vectortype
name
Text(32)
Nameofthevectortypewithwhichthevectorfileisassociated.Thisonemustmatch
exactlyavectortypenamefieldinthemenufile.
109
Thefieldsareseparatedbyspaces.
Theattributefilestorestheheightanddescriptionpropertiesofvectorpaths.Thisfileisoptional.
Sample
Indexfileassociatedwiththevectorfiles
8.10.16.4 ImageFiles
Theimagedirectoryconsistsoftwofiles,theimagefilewithTIFFextensionandanindexfilewiththesamestructureasthe
DTMindexfilestructure.
8.10.16.5 TextDataFiles
Thetextdatadirectoryconsistsof:
ThetextdatafilesareASCIItextfileswiththefollowingformat:
Eachfilecontainsalineoftextfollowedbyeastingandnorthingofthattext,etc.
The index file, an ASCII text file, stores the position of each text file. It consists of one or more records with the
followingstructure:
Thefieldsareseparatedbyspaces.
Themenufile,anASCIItextfile,containsthetextfeatures.Thisfileisoptional.
8.10.16.6 MNUFormat
An MNU file is used for importing clutter classes or raster traffic files in TIFF, BIL, and IMG formats. It gives the mapping
betweentheclutterortrafficclasscodeandtheclassname.Itisatextfilewiththesamenameastheclutterortrafficfile
sydney1. ai r por t 313440 333021 6239426 6244784 ai r por t
sydney1. r i ver l ake 303900 342704 6227900 6267900 r i ver l ake
sydney1. coast l i ne 322837 343900 6227900 6267900 coast l i ne
sydney1. r ai l ways 303900 336113 6227900 6267900 r ai l ways
sydney1. hi ghways 303900 325155 6240936 6267900 hi ghways
sydney1. maj st r eet s 303900 342770 6227900 6267900 maj st r eet s
sydney1. maj or r oads 303900 342615 6227900 6267900 maj or r oads
Ai r por t
637111. 188 3094774. 00
Ai r por t
628642. 688 3081806. 25
Filename Text(32) Filenameofthetextdatafile
EastMin Real Minimumxaxiscoordinateofallpointslistedinthetextdatafile
EastMax Real Maximumxaxiscoordinateofallpointslistedinthetextdatafile
NorthMin Real Minimumyaxiscoordinateofallpointslistedinthetextdatafile
NorthMax Real Maximumyaxiscoordinateofallpointslistedinthetextdatafile
Textfeature Text(32) Thisfieldisomittedincasenomenufileisavailable.
r ai l wayp. t xt - 260079 693937 2709348 3528665 Rai l way_St at i on
ai r por t . t xt - 307727 771663 2547275 3554675 Ai r por t
f er r ypor t . t xt 303922 493521 2667405 3241297 Fer r ypor t
1 Ai r por t
2 Fer r ypor t
3 Rai l way_St at i on
110
withMNUextension.Itmustbestoredatthesameastheclutterortrafficfile.Ithasthesamestructureasthemenufileused
inthePlanetformat.
Eitherspaceortabcanbeusedastheseparator.
AnMNUfileassociatedtoaclutterclassesfile:
Classcode Integer(>0) Identificationcodefortheclutter(ortraffic)class
Classname Text(50) Nameoftheclutter(ortraffic)class.Itcancontainspaces.
0 none
1 open
2 sea
3 i nl and_wat er
4 r esi dent i al
5 meanur ban
AT320_AM_E2 Chapter9:RadioDataFormats
111
9 RadioDataFormats
RadionetworkdatainAtollincludesthefollowing,dependingonthetechnologyusedinthenetworkbeingplanned:
Site:Thegeographiclocationoftransmitters(sectors,installedantennas,otherequipment).Asitecanhaveoneor
moretransmitters.
Antenna:Theradiationpatternsandgainsforantennasinstalledattransmitters.
Transmitter:Agroupofradiodevicesinstalledatasitewiththeretransmission/receptioncharacteristics(antennas,
feeders,TMAs,otherequipment).Atransmittercanhaveoneormorecellsorsubcells.
Cell:AnRFcarrieravailableatatransmitterinUMTS,CDMA2000,TDSCDMA,LTE,WiMAX,andWiFinetworks.Acell
isfullydefinedbythe"transmittercarrier"pair.Eachcellinthesenetworksisindependent,i.e.,hasitsownidentifier,
powerlevels,performancecharacteristics.
TRX:AnRFcarrieravailableatatransmitterinGSMnetworks.Atransceiver(TRX)cancarryoneARFCNwhichcan
correspondtotheBCCH(7traffictimeslots)orTCH(8traffictimeslots).
Subcell:AsubcellisagroupofTRXswiththesameradiocharacteristics.Asubcellisfullydefinedbythe"transmitter
TRXtype"pair.
Basestation:Thisisthegenericnameforacellsite("sitetransmittercell"or"sitetransmittersubcells").Technology
specificnamescanbeBTS,NodeB,eNodeB,etc.
RFrepeater:AnRFrepeaterreceives,amplifies,andretransmitsRFcarriersbothindownlinkanduplink.Therepeater
receivessignalsfromadonortransmitterwhichitretransmitsusingacoveragesideantennawithamplification.
Remoteantenna:Transmitterantennaslocatedataremotelocationwithrespecttothetransmitterssite.
Microwavelink:Apointtopointlinkusingmicrowavefrequenciesusedforbackhaulinradioaccessnetworksorfor
fixedwirelessaccess.
PMPmicrowavelink:Agroupofmicrowavelinksoriginatingfromacommonnodetoservemorethanonelocation.
Passive microwave repeater: A passive microwave repeater receives and retransmits microwave signals without
amplification.Passiverepeatersdonothavepowersourcesoftheirown.Activerepeaters,ontheotherhand,amplify
thereceivedsignal.Reflectorsareexamplesofpassiverepeaters.
9.1 XMLImport/ExportFormat
AllthedatatablesinanAtolldocumentcanbeexportedtoXMLfiles.Atollcreatesthefollowingfileswhendatatablesare
exportedtoXMLfiles:
Anindex.xmlfilewhichcontainsthemappingbetweenthedatatablesinAtollandtheXMLfilecreatedforeachtable.
OneXMLfileperdatatablewhichcontainsthedatatableformat(schema)andthedata.
When XML files are imported to a document, the table and field definitions are not modified, i.e., the Networks and
CustomFieldstablesareexportedtoXMLfilebutarenotimported.
ThefollowingsectionsdescribethestructuresoftheXMLfilescreatedatexport.
9.1.1 Index.xmlFileFormat
Theindex.xmlfilestoresthesystem(GSM,UMTS,etc.)andthetechnology(TDMA,CDMA,etc.)ofthedocument,andthe
versionofAtollusedforexportingthedatatablestoXMLfiles.Italsocontainsthemappingbetweenthedatatablesinthe
AtolldocumentandtheXMLfilecorrespondingtoeachdatatable.
Theroottag<Atoll_XML_Config...>oftheindex.xmlfilecontainsthefollowingattributes:
TheindexfilealsocontainsthemappingbetweenthetablesexportedfromAtollandtheXMLfilescorrespondingtoeach
table.ThislistissortedintheorderinwhichtablesmustbeimportedinAtoll.
Thelistiscomposedof<XML_Table.../>tagswiththefollowingattributes:
Asampleextractoftheindex.xmlisgivenbelow:
Attribute Description
Atoll_File_System CorrespondstotheSYSTEM_fieldoftheNetworkstableoftheexporteddocument
Atoll_File_Technology CorrespondstotheTECHNOLOGYfieldoftheNetworkstableoftheexporteddocument
Atoll_File_Version CorrespondstotheAtollversion
Attribute Description
XML_File CorrespondstotheexportedXMLfilename(e.g.,"Sites.xml")
Atoll_Table CorrespondstotheexportedAtolltablename(e.g.,"Sites")
112
Chapter9:RadioDataFormats Forsk2013
Notethatnoclosingtag</XML_Table>isrequired.
9.1.2 XMLFileFormat
AtollcreatesanXMLfileperexporteddatatable.ThisXMLfilehastwosections,oneforstoringthedescriptionofthetable
structure,andthesecondforthedataitself.TheXMLfileusesthestandardXMLrowsetschema(schemaincludedintheXML
filebetween<s:Schemaid=RowsetSchema>and</s:Schema>tags).
RowsetSchema
TheXMLroottagforXMLfilesusingtherowsetschemaisthefollowing:
Theschemadefinitionfollowstheroottagandisenclosedbetweenthefollowingtags:
Intherowsetschema,aftertheschemadescription,thedataareenclosedbetween<rs:data>and</rs:data>.
Betweenthesetags,eachrecordishandledbya<z:row/>taghavingitsattributessettotherecordfieldvaluessinceinthe
rowsetschema,valuesarehandledbyattributes.Notethatnoclosingtag</z:row>isrequired.
AsampleextractofaSites.xmlfilecontainingtheSitestablewithonlyonesiteisgivenbelow:
<At ol l _XML_Conf i g At ol l _Fi l e_Syst em=" UMTS" At ol l _Fi l e_Technol ogy=" CDMA"
At ol l _Fi l e_Ver si on=" 3. x. x bui l d xxxx" >
<XML_Tabl e XML_Fi l e=" Cust omFi el ds. xml " At ol l _Tabl e=" Cust omFi el ds" / >
<XML_Tabl e XML_Fi l e=" Coor dSys. xml " At ol l _Tabl e="Coor dSys" / >
. . .
</ At ol l _XML_Conf i g>
<xml xml ns: s=' uui d: BDC6E3F0- 6DA3- 11d1- A2A3- 00AA00C14882'
xml ns: dt =' uui d: C2F41010- 65B3- 11d1- A29F- 00AA00C14882'
xml ns: r s=' ur n: schemas- mi cr osof t - com: r owset '
xml ns: z=' #Rowset Schema' >
<s: Schema i d= Rowset Schema >
<! - Schema i s def i ned her e, usi ng <s: El ement Type> and <s: At t r i but eType> t ags - >
</ s: Schema>
<xml xml ns: s=' uui d: BDC6E3F0- 6DA3- 11d1- A2A3- 00AA00C14882'
xml ns: dt =' uui d: C2F41010- 65B3- 11d1- A29F- 00AA00C14882'
xml ns: r s=' ur n: schemas- mi cr osof t - com: r owset '
xml ns: z=' #Rowset Schema' >
<s: Schema i d=' Rowset Schema' >
<s: El ement Type name=' r ow' cont ent =' el t Onl y' r s: updat abl e=' t r ue' >
<s: At t r i but eType name=' NAME' r s: number =' 1' r s: maydef er =' t r ue'
r s: wr i t eunknown=' t r ue' r s: baset abl e=' Si t es' r s: basecol umn=' NAME'
r s: keycol umn=' t r ue' >
<s: dat at ype dt : t ype=' st r i ng' dt : maxLengt h=' 50' / >
</ s: At t r i but eType>
<s: At t r i but eType name=' LONGI TUDE' r s: number =' 2' r s: maydef er =' t r ue'
r s: wr i t eunknown=' t r ue' r s: baset abl e=' Si t es' r s: basecol umn=' LONGI TUDE' >
<s: dat at ype dt : t ype=' f l oat ' dt : maxLengt h=' 8' r s: pr eci si on=' 15'
r s: f i xedl engt h=' t r ue' / >
<s: At t r i but eType name=' LATI TUDE' r s: number =' 3' r s: maydef er =' t r ue'
r s: wr i t eunknown=' t r ue' r s: baset abl e=' Si t es' r s: basecol umn=' LATI TUDE' >
<s: dat at ype dt : t ype=' f l oat ' dt : maxLengt h=' 8' r s: pr eci si on=' 15'
113
9.2 RF2DAntennaPatternFormat
ThissectiondescribestheformatoftheDIAGRAMfieldoftheAntennastable.Thisfieldstorestheantennadiagramsina2D
(anglevs.attenuation)format.ThisistheformatofthecontentsoftheDIAGRAMfieldoftheAntennastablewhenitiscopied
from,pastedto,importedto(fromTXTorCSVfiles),andexportedfrom(fromTXT,CSV,orXLSfiles)theAntennastable.
AntennapatternscanalsobeimportedinPlanet2Dformatantennafilesand3Dantennafiles.Thefileformatrequiredfor
3Dantennafileimportisdescribedin"ImportFormatof3DAntennaPatternTextFiles"onpage 115.
Theformatof2DantennapatternscontainingcopolardiagramsonlycanbeunderstoodfromFigure 9.1onpage 113.
ThecontentsoftheDIAGRAMfieldareformattedasfollows:
PatternDescriptor1:Spaceseparatedlistofparameters.
Firstentry:Thenumberofcopolardiagrams.Forexample,2.
Secondentry:Firstcopolardiagramtype=0forazimuth(horizontal)diagram.
Thirdentry:Theelevationangleoftheazimuthdiagram.
Fourthentry:Thenumberofangleattenuationpairsinthefirstcopolardiagram.Forexample,360.
Copolar Horizontal Diagram: Horizontal copolar diagram (the second entry in the preceding descriptor is 0). The
formatisspaceseparatedangleattenuationpairs.Forexample,001020.1....
Firstentry:Secondcopolardiagramtype=1forelevation(vertical)diagram.
Secondentry:Theazimuthangleoftheelevationdiagram.
Thirdentry:Thenumberofangleattenuationpairsinthesecondcopolardiagram.Forexample,360.
CopolarVerticalDiagram:Verticalcopolardiagram(thefirstentryintheprecedingdescriptoris1).Theformatis
spaceseparatedangleattenuationpairs.Forexample,0010.1....
End:Thenumbercrosspolardiagrams=0.
The format of 2D antenna patterns containing copolar and crosspolar diagrams can be understood from Figure 9.2 on
page 114.
<s: At t r i but eType name=' ALTI TUDE' r s: number =' 4' r s: nul l abl e=' t r ue'
r s: maydef er =' t r ue' r s: wr i t eunknown=' t r ue' r s: baset abl e=' Si t es'
r s: basecol umn=' ALTI TUDE' >
<s: dat at ype dt : t ype=' r 4' dt : maxLengt h=' 4' r s: pr eci si on=' 7'
<s: At t r i but eType name=' COMMENT_' r s: number =' 5' r s: nul l abl e=' t r ue'
r s: maydef er =' t r ue' r s: wr i t eunknown=' t r ue' r s: baset abl e=' Si t es'
r s: basecol umn=' COMMENT_' >
<s: dat at ype dt : t ype=' st r i ng' dt : maxLengt h=' 255' / >
<s: ext ends t ype=' r s: r owbase' / >
</ s: El ement Type>
</ s: Schema>
<r s: dat a>
<r s: i nser t >
<z: r ow NAME=' Si t e0' LONGI TUDE=' 8301' LATI TUDE=' - 9756' / >
</ r s: i nser t >
</ r s: dat a>
</ xml >
Figure 9.1:2DRFAntennaPatternFormatContainingCopolarDiagramsOnly
Pattern
End Co-polar Horizontal Diagram Co-polar Vertical Diagram
2 0 0 360 0 0 1 0 2 0.1 1 0 360 0 0 1 0.1 0
Discriptor 1
Pattern
Discriptor 2
114
ThecontentsoftheDIAGRAMfieldareformattedasfollows:
Secondentry:Firstcopolardiagramtype=0forazimuth(horizontal)diagram.
Fourthentry:Thenumberofangleattenuationpairsinthefirstcopolardiagram.Forexample,360.
Copolar Horizontal Diagram: Horizontal copolar diagram (the second entry in the preceding descriptor is 0). The
Firstentry:Secondcopolardiagramtype=1forelevation(vertical)diagram.
Thirdentry:Thenumberofangleattenuationpairsinthesecondcopolardiagram.Forexample,360.
CopolarVerticalDiagram:Verticalcopolardiagram(thefirstentryintheprecedingdescriptoris1).Theformatis
spaceseparatedangleattenuationpairs.Forexample,0010.1....
Firstentry:Thenumberofcrosspolardiagrams.Forexample,2.
Secondentry:Firstcrosspolardiagramtype=0forazimuth(horizontal)diagram.
Fourthentry:Thenumberofangleattenuationpairsinthefirstcrosspolardiagram.Forexample,360.
CrosspolarHorizontalDiagram:Horizontalcrosspolardiagram(thesecondentryintheprecedingdescriptoris0).
Theformatisspaceseparatedangleattenuationpairs.Forexample,001020.1....
Firstentry:Secondcrosspolardiagramtype=1forelevation(vertical)diagram.
Thirdentry:Thenumberofangleattenuationpairsinthesecondcrosspolardiagram.Forexample,360.
CrosspolarVerticalDiagram:Verticalcrosspolardiagram(thefirstentryintheprecedingdescriptoris1).Theformat
isspaceseparatedangleattenuationpairs.Forexample,0 0 1 0.1....
Youcanusea3rdpartysoftwareordevelopatooltoconvertthecontentsoftheDIAGRAMfieldintobinary.Inbinary,each
antennaisdescribedbyaheaderandalistofvaluepairs.
Theheaderisdefinedasfollows:
flag:(Integer,32bits)1foromnidiagrams,0fordirectional
num:(Shortinteger,16bits)Numberofdiagrams(0,1,2,3,4)
siz0:(Shortinteger,16bits)Sizeofthefirstdiagram(horizontalcopolarsection,elevation=0)
siz1:(Shortinteger,16bits)Sizeoftheseconddiagram(verticalcopolarsection,azimuth=0)
siz2:(Shortinteger,16bits)Sizeofthethirddiagram(horizontalcrosspolar)
siz3:(Shortinteger,16bits)Sizeofthefourthdiagram(verticalcrosspolar)
prec:(Shortinteger,16bits)Precisionofthefollowinganglevalues(100)
Thenfollowsthecontentofeachofthedefineddiagrams,i.e.,thediagramswhosesizes(siz0,siz1,siz2,siz3)arenotzero.
Eachdiagramconsistsofalistofvaluepairs.Thenumberofvaluepairsinalistdependsonthevalueofthesiz0,siz1,siz2,
andsiz3parameters.Forexample,siz2=5meanstherearefivevaluepairsinthethirddiagram.
Thevaluepairsineachlistare:
ang: (Short integer, 16 bits) The first component of the value pair is the angle in degrees multiplied by 100. For
example,577means5.77degrees.
loss:(Shortinteger,16bits)ThesecondcomponentofthevaluepairisthelossindBforthegivenangleang.
Allthelistsofvaluepairsareconcatenatedwithoutaseparator.
Figure 9.2:2DRFAntennaPatternFormatContainingCopolarandCrosspolarDiagrams
Pattern
Co-polar Horizontal Diagram Co-polar Vertical Diagram
2 0 0 360 0 0 1 0 2 0.1 1 0 360 0 0 1 0.1
Discriptor 1
Pattern
Discriptor 2
Pattern
Cross-polar Horizontal Diagram Cross-polar Vertical Diagram
Discriptor 3
Pattern
Discriptor 4
2 0 0 360 0 0 1 0 2 0.1 1 0 360 0 0 1 0.1
115
9.3 ImportFormatof3DAntennaPatternTextFiles
Textfilescontaining3DantennapatternsthatcanbeimportedinAtollmusthavethefollowingformat:
Header:Thetextfilecancontainaheaderwithadditionalinformation.Whenyouimporttheantennapatternyoucan
indicatetherownumberinthefilewheretheheaderendsandtheantennapatternbegins.
AntennaPattern:Eachrowcontainsthreevaluestodescribethe3Dantennapattern.Thecolumnscontainingthe
valuescanbeinanyorder:
Azimuth:Allowedrangeofvaluesisfrom0to360.Thesmallestincrementallowedis1.
Tilt:Allowedrangeofvaluesisfrom90to90orfrom0to180.Thesmallestincrementallowedis1.
Attenuation:TheattenuationindB.
9.4 Microwave2DAntennaPatternFormat
ThissectiondescribestheformatofthePATTERNfieldoftheMWAntennastable.Thisfieldstorestheantennadiagramsina
2D(anglevs.attenuation)format.ThisistheformatofthecontentsofthePATTERNfieldoftheMWAntennastablewhenit
is copied from, pasted to, imported to (from TXT or CSV files), and exported from (from TXT, CSV, or XLS files) the MW
Antennastable.
AntennapatternscanalsobeimportedinPlanet2Dformatantennafilesand3Dantennafiles.Thefileformatrequiredfor
3Dantennafileimportisdescribedin"ImportFormatof3DAntennaPatternTextFiles"onpage 115.
Theformatof2DantennapatternscanbeunderstoodfromFigure 9.3onpage 115.
ThecontentsofthePATTERNfieldareformattedasfollows:
Secondandthirdentries:Firstcopolardiagramtype=01,forHVdiagram.
Fourthentry:Theelevationangleoftheazimuthdiagram.
Fifthentry:Thenumberofangleattenuationpairsinthefirstcopolardiagram.Forexample,360.
CopolarHVDiagram:CopolarHVdiagram(thesecondandthirdentriesintheprecedingdescriptorare01).The
Firstandsecondentries:Secondcopolardiagramtype=00,forHHdiagram.
Thirdentry:Theazimuthangleoftheelevationdiagram.
Figure 9.3:2DMicrowaveAntennaPatternFormat
Pattern
Co-polar H-V Diagram Co-polar H-H Diagram
Discriptor 1
Pattern
Discriptor 2
Pattern
Co-polar V-V Diagram Co-polar V-H Diagram
Discriptor 3
Pattern
Discriptor 4
Pattern
Cross-polar H-V Diagram Cross-polar H-H Diagram
Discriptor 5
Pattern
Discriptor 6
Pattern
Cross-polar V-V Diagram Cross-polar V-H Diagram
Discriptor 7
Pattern
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 ...
116
Fourthentry:Thenumberofangleattenuationpairsinthesecondcopolardiagram.Forexample,360.
CopolarHHDiagram:CopolarHHdiagram(thefirstandsecondentriesintheprecedingdescriptorare00).The
Firstandsecondentries:Thirdcopolardiagramtype=11,forVVdiagram.
Fourthentry:Thenumberofangleattenuationpairsinthethirdcopolardiagram.Forexample,360.
CopolarVVDiagram:CopolarVVdiagram(thefirstandsecondentriesintheprecedingdescriptorare11).The
Firstandsecondentries:Fourthcopolardiagramtype=10,forVHdiagram.
Fourthentry:Thenumberofangleattenuationpairsinthefourthcopolardiagram.Forexample,360.
CopolarVHDiagram:CopolarVHdiagram(thefirstandsecondentriesintheprecedingdescriptorare10).The
Firstentry:Thenumberofcrosspolardiagrams.Forexample,4.
Secondandthirdentries:Firstcrosspolardiagramtype=01,forHVdiagram.
Fourthentry:Theelevationangleoftheazimuthdiagram.
Fifthentry:Thenumberofangleattenuationpairsinthefirstcrosspolardiagram.Forexample,360.
CrosspolarHVDiagram:CrosspolarHVdiagram(thesecondandthirdentriesintheprecedingdescriptorare01).
Firstandsecondentries:Secondcrosspolardiagramtype=00,forHHdiagram.
Fourthentry:Thenumberofangleattenuationpairsinthesecondcrosspolardiagram.Forexample,360.
CrosspolarHHDiagram:CrosspolarHHdiagram(thefirstandsecondentriesintheprecedingdescriptorare00).
Firstandsecondentries:Thirdcrosspolardiagramtype=11,forVVdiagram.
Fourthentry:Thenumberofangleattenuationpairsinthethirdcrosspolardiagram.Forexample,360.
CrosspolarVVDiagram:CrosspolarVVdiagram(thefirstandsecondentriesintheprecedingdescriptorare11).
Firstandsecondentries:Fourthcrosspolardiagramtype=10,forVHdiagram.
Fourthentry:Thenumberofangleattenuationpairsinthefourthcrosspolardiagram.Forexample,360.
CrosspolarVHDiagram:CrosspolarVHdiagram(thefirstandsecondentriesintheprecedingdescriptorare10).
9.5 MicrowaveNSMAAntennaFileFormats
YoucanimportmicrowaveantennasinAtollfromfilesinPlanetmicrowaveantennaandstandardNSMA(NationalSpectrum
ManagersAssociation)formats,whicharedescribedintheWG16.89.003andWG16.99.050recommendations.TheNSMA
formatsaredescribedbelow.
9.5.1 WG16.89.003Format
TheantennapatternfileisanASCIItextfilewiththefollowingstructure:
Field
Length
(Char)
Description
AntennaManufacturer 30 NameunderwhichthedatawasfiledwiththeFCC
AntennaModelnumber 30 FullmodelnumberasusedwhenthedatawasfiledwiththeFCC
Comment 30 Fieldforcommentsonthecurrentrevision
FCCIDnumber 16 IDnumberissuedbytheCommonCarrierBranchoftheFCC
ReversepatternIDnumber 16 ThisliststhereversepatternFCCIDnumber
117
Sample
Dateofdata 16 Datereferencedonthepublishedpattern
ManufacturerIDNumber 16 Referencenumberassignedbytheantennamanufacturer.
Frequencyrange 16
Thisistoidentifythefullfrequencyrangeforwhichthispatternisvalidand
agreeswiththerangeasspecifiedintheprintedpattern.Thefrequencyisin
Megahertz.
Midbandgain 16 Gainoftheantennaatmidband(dBi)
Halfpowerbeamwidth 16
Thisistheincludedanglecenteredonthemainbeamoftheantennaand
definestheanglewheretheantennaresponsefalls3dB
Polarization
+Space
+Datacount
+Space
7
7
Thedataisprecededbyanindicationofthepolarisationofthedata.The
commonlyacceptedpolarisationdesignatorsforlinearpolarisationaretobe
used:
HH:Horizontalpolarisedportresponsetoahorizontallypolarisedsignalinthe
horizontaldirection.
HV:Horizontalpolarisedportresponsetoaverticallypolarisedsignalinthe
horizontaldirection.
VV:Verticalpolarisedportresponsetoaverticallypolarisedsignalinthe
horizontaldirection
VH:Verticalpolarisedportresponsetoahorizontallypolarisedsignalinthe
horizontaldirection
ELHH:Horizontalpolarisedportresponsetoahorizontallypolarisedsignalinthe
verticaldirection
ELHV:Horizontalpolarisedportresponsetoaverticallypolarisedsignalinthe
verticaldirection
ELVV:Verticalpolarisedportresponsetoaverticallypolarisedsignalinthe
verticaldirection
ELVH:Verticalpolarisedportresponsetoahorizontallypolarisedsignalinthe
verticaldirection
Thedatacountwillbethenumberofdatapointstofollow.
Alleightresponsesshouldbeincluded.Ifdifferentpolarisationshaveidentical
responses,theyaretobeduplicatedinorderthatafullsetofdatabelisted.
Angle
+Space
+AntennaResponse
+Space
7
7
Fullcomplimentofdatawillshowtheantennaresponseinthehorizontal
directionfora'horizontalcut'andintheverticaldirectionfora'verticalcut'.The
dataispresentedintwocolumns.Theangleofobservationislistedfirst
followedbytheantennaresponse.
Forthehorizontaldirection,theangleofobservationstartsfrom180degrees
(definedastheleftsideoftheantenna)anddecreaseinangletothemainbeam
,0degrees,andthenincreaseto+180degrees.Thefulldatawillcoverthe360
degreesoftheantenna.
Fortheverticaldirection,theangleofobservationstartsfrom5(90)degrees
(definedastheantennaresponsebelowthemainbeam)anddecreaseinangle
tothemainbeam,0degrees,andthenincreaseto+5(+90)degrees.Thefull
datawillcoverthe10(180)degreescenteredaboutthemainbeam.
TheantennaresponseislistedasdBdownfromthemainloberesponseandis
shownasnegative.
MARK ANTENNA PRODUCTS I nc.
MHP- 100A120D
( none)
M15028
M15027
11- 25- 85
NONE
10700- 11700 MHZ
48. 4 dB
0. 6 Deg
HH 39
Field
Length
(Char)
Description
118
9.5.2 WG16.99.050Format
TheantennapatternfileisanASCIItextfilewiththefollowingstructure:
- 180 - 88
- 160 - 88
- 150 - 90
- 97 - 90
- 66 - 70
. . .
160 - 88
180 - 88
HV 33
- 180 - 89
- 170 - 89
. . .
180 - 89
VV 39
- 180 - 88
- 160 - 88
. . .
150 - 90
160 - 88
180 - 88
VH 33
- 180 - 89
- 170 - 89
- 160 - 90
. . .
180 - 89
ELHH 7
- 4 - 36
- 1. 7 - 30
. . .
4 - 36
ELHV 11
- 4. 5 - 63. 4
. . .
4. 5 - 63. 4
ELVV 7
- 4 - 36
. . .
4 - 36
ELVH 11
- 4. 5 - 63. 4
. . .
4. 5 - 63. 4
119
Field
Length
(Char)
Abbreviated
Name
Description
RevisionNumber 42 REVNUM Versionofthisstandardtowhichthepatternconforms
RevisionDate 16 REVDAT Dateofthecurrentrevisionofthestandard
Comment1 80 COMNT1 Fieldforcommentsonthecurrentrevision
Comment2 80 COMNT2 Fieldforcommentsonthecurrentrevision
AntennaManufacturer 42 ANTMAN Nameoftheantennamanufacturer
ModelNumber 42 MODNUM Fullmodelnumberasusedwhenthedatawastaken
PatternIDNumber 42 PATNUM NSMAIDnumber
PatternFileNumber 13 FILNUM
Usedwhenmorethanonefileisassociatedwithaspecificantenna
modelnumber.
Thisfieldwillcontaintheparticularfilenumberandthetotal
numberoffilesassociatedwiththatmodelnumber.Anexampleof
suchacasewouldbeadualbandantennawithtwopatternfiles
associatedwithit.
FeedOrientation 13 FEDORN
Orientationofthefeedhookwhenlookingfromthebackofthe
antennainthedirectionofthemechanicalboresite
Description1 80 DESCR1 Usedtodescribetheantennaanditscharacteristics
Dateofdata 16 DTDATA Datethepatterndatawastaken
LowFrequency(MHz) 21 LOWFRQ
Lowerfrequencyoftheoperatingbandwidthoftheantenna
(MHertz).Iftheantennacanbeoperatedintwodistinctfrequency
bands,thentheperformanceoftheantennaineachbandshallbe
describedinseparatefiles.
HighFrequency(MHz) 21 HGHFRQ
Upperfrequencyoftheoperatingbandwidthoftheantenna
(MHertz).Iftheantennacanbeoperatedintwodistinctfrequency
bands,thentheperformanceoftheantennaineachbandshallbe
describedinseparatefiles
GainUnits 15 GUNITS Gainunit
Lowbandgain 12 LWGAIN
Gainoftheantennaatthelowfrequencyofthefrequencyband.The
gainisinunitsdescribedinGUNITS
Midbandgain 16 MDGAIN
Gainoftheantennaatthemidfrequencyofthefrequencybandand
mightincludeafullbandwidthtolerance.Thegainisinunits
describedinGUNITS
Highbandgain 12 HGGAIN
Gainoftheantennaathighfrequencyofthefrequencyband.The
gainisinunitsdescribedinGUNITS
MidbandAzBmwdth 16 AZWIDT
Nominaltotalwidthofthemainbeamatthe3dBpointsinthe
azimuthplane.Thisisamidbandmeasurementexpressedin
degreesandmightincludeafullbandwidthtolerance
MidbandElBmwdth 16 ELWIDT
Nominaltotalwidthofthemainbeamatthe3dBpointsinthe
elevationplane.Thisisamidbandmeasurementexpressedin
degreesandmightincludeafullbandwidthtolerance
ConnectorType 80 CONTYP Descriptionoftheantennaconnectortype
VSWR 13 ATVSWR
WorstcaselimitoftheantennasVSWRovertheoperating
bandwidth
FronttobackRatio(dB) 10 FRTOBA
WorstcasepowerlevelindBbetweenthemainlobepeakandthe
peakoftheantennasbacklobe.Thebacklobepeakdoesnot
necessarilypoint180degreesbehindthemainlobe.
ElectricalDowntilt(deg) 16 ELTILT
Amountthatthemainbeampeakoftheantenna(electrical
boresite)isdowtiltedbelowthemechanicalboresiteoftheantenna.
Thisisamidbandmeasurementandmightincludeatolerance.This
measurementisexpressedindegrees.
120
RadiationCenter(m) 13 RADCTR
Heightofthecenteroftheradiatingapertureabovethemechanical
bottomoftheantenna(m).Itisnotnecessarilythephasecenterof
theantenna.
PorttoPortIso(dB) 12 POTOPO
Measurementmadeondualpolarisationantennas.Itisthe
maximumamountofpowerovertheantennasoperatingbandwidth
thatiscoupledbetweenports.Itisthepowerratio(dB)betweena
referencesignalinjectedintooneportandtheamountofcoupled
powerreturnedbackoutoftheotherport.
MaxInputPower(W) 17 MAXPOW
MaximumamountofaverageRFinputpowerwhichcanbeapplied
toeachoftheantennasinputportsintheantennasoperating
frequencyrange(Watts).
AntennaLength(m) 14 ANTLEN
Mechanicallengthoftheantenna(m).Thisdoesnotincludethe
antennamount.Foracircularlysymmetricparabolicantennathis
wouldbethediameter.
AntennaWidth(m) 14 ANTWID
Mechanicalwidthoftheantenna(m).Thisdoesnotincludethe
antennamount.Foracircularlysymmetricparabolicantennathis
wouldbethediameter.
AntennaDepth(m) 14 ANTDEP
Mechanicaldepthantenna(m).Thisdoesnotincludetheantenna
mount.
AntennaWeight(kg) 16 ANTWGT weightoftheantennainkg.Thisincludestheantennamount.
FutureField 80 FIELD1
PatternType 16 PATTYP Patterntype,eithertypicalorenvelope.
#Freqthisfile 10 NOFREQ Thenumberofpatternfrequencieswhichcomprisethefulldataset.
PatternFreq(Mhz) 21 PATFRE Frequencyofthepatterndataforatypicalpattern(MHz).
#Patterncuts 11 NUMCUT Numberofpatterncutswhichcomprisethefulldataset.
PatternCut 11 PATCUT Geometryofaparticularpatterncut.
Polarization 15 POLARI
Particularpolarisationofapatterncut.Thefirstpolarisationisthe
polarisationoftheantennaundertestandthesecondthe
polarisationoftheilluminatingsource.Thetwopolarisationsare
separatedbya/.
#DataPoints 13 NUPOIN Thenumberofdatapointsinaparticularpatterncutdataset.
First&LastAngle 25 FSTLST
Thefirstandlastangle(indegrees)oftheantennapatterndata.
Patterndatashallbeexpressedmonotonically,withrespectto
angle.Azimuthsshallbestatedaseither180to+180or0to360
degrees.
XaxisOrientation 53 XORIEN
Averbaldescriptionofthephysicalorientationofthexaxisonthe
antenna.
YaxisOrientation 53 YORIEN
Averbaldescriptionofthephysicalorientationoftheyaxisonthe
antenna.
ZaxisOrientation 53 ZORIEN
Averbaldescriptionofthephysicalorientationofthezaxisonthe
antenna.
Patterncutdata 28/point
Thedataispresentedinthreecolumns.Theangleofobservationis
listedfirstfollowedbytheantennamagnituderesponseandphase
response.Inmostcasesthephaseresponsewillnotbeincludedin
thedataset.Sdesignatesthesignofthenumber.
Theantennapowermagnitudeislistedintheunitsspecifiedinthe
antennaunitsfield(GUNITS).
Theangleandphasedataareexpressedinunitsofdegrees.
Endoffile 11 ENDFIL ThisfielddesignatestheendofthefilewiththecharactersEOF
Field
Length
(Char)
Abbreviated
Name
Description
121
Sample
REVNUM: , NSMA WG16. 99. 050
REVDAT: , 19990520
ANTMAN: , RADI O WAVES I NC
MODNUM: , HP4- 64
DESCR1: , 4 FT LOWSI DELOBE ANTENNA
PATNUM: , 9005
DTDATA: , 20030807
LOWFRQ: , 6425
HGHFRQ: , 7125
GUNI TS: , DBI / DBR
LWGAI N: , 35. 5
MDGAI N: , 35. 9
HGGAI N: , 36. 3
AZWI DT: , 2. 8
ELWI DT: , 2. 8
ELTI LT: , 0
ANTLEN: , 1. 2,
PATTYP: , ENVELOPE,
NOFREQ: , NA,
PATFRE: , NA,
NUMCUT: , 4,
PATCUT: , AZ,
POLARI : , H/ H,
NUPOI N: , 29,
FSTLST: , - 180, 180
- 180, - 60,
-100,-60,
- 51, - 42. 3,
. . .
PATCUT: , AZ,
POLARI : , H/ V,
NUPOI N: , 11,
FSTLST: , - 180, 180
- 180, - 60,
- 22, - 60,
. . .
PATCUT: , AZ,
POLARI : , V/ V,
NUPOI N: , 33,
FSTLST: , - 180, 180
- 180, - 60,
. . .
PATCUT: , AZ,
POLARI : , V/ H,
NUPOI N: , 11,
FSTLST: , - 180, 180
- 180, - 60,
122
9.6 MicrowaveNSMARadioFileFormats
AtollenablesyoutoimportmicrowaveradiosthatareinstandardNSMA(NationalSpectrumManagersAssociation)format
definedbytherecommendationWG21.99.051orinPathlossformat(version4.0).TheNSMAformatisdescribedbelow.
9.6.1 WG21.99.051Format
ThefileisanASCIItextfilewiththeextensionNSM.Itconsistsofrows;eachdataitemisplacedonaseparaterowstarted
withthespecificnameoftheitem.Thenameanddataitemsareseparatedwithcommas(,).Eachtextfieldisenclosedin
doublequotes("").Numericvaluesarenotenclosedwithquotesandmustnotcontainanyembeddedcommas.
Thefilehasthefollowingstructure:
. . .
ENDFI L: , EOF,
Row Description
"$HDR",Filetype,"$"
Fileheader.Thefiletypeindicatesthedatacontained,theformat
andtheversionoftheformat.Forversion1.0oftheEquipment
format,thisvaluemustbeEQUIP1.0.
"EQUIP_MFG",Equipmentmanufacturer Manufacturerwithnoabbreviations
"MFG_MODEL",Modelnumber Manufacturermodelnumber
"REV_NUM",Documentrevisionnumber DocumentrevisionnumberNotusedbyAtoll
"REV_DATE",Documentrevisiondate
DocumentrevisiondateDateformat:yyyymmddNotusedby
Atoll
"RADIO_ID",RadioIDnumber RadioidentificationNotusedbyAtoll
"FCC_CODE",FCCcode FCCcodeNotusedbyAtoll
"EQ_DATE",Equipmentdatadate
DateequipmentdatawasrecordedbymanufacturerDateformat:
mmddyyyyNotusedbyAtoll
"EMISSION",Emissiondesignator Codedesignatingthebandwidthandmodulationtype
"MAX_LOADING",Numberofcircuits Numberofvoicecircuits
"DATA_RATE",Datarate PayloaddatarateinMbits/s
"RADIO_CAP",Numberoflines,Signalstandard
RadiocapacityTheNumberofLinesisthenumberofinstalled
DS1s,DS3s,etc.TheSignalStandardisatextfieldforthetypeof
interface(e.g.,DS3)
"MODULATION",Modulationtype Typeofmodulation
"DEVIATION",Deviation FrequencydeviationinkHz(analogradioonly)NotusedbyAtoll
"FREQ_RANGE",Lowfrequency,Highfrequency FrequencyrangeinMHzoverwhichthisradiomodelworks
"POWER_OPTION",Power#1,Power#2,etc.,
TransmitpoweroptionsindBm(whendiscretepowerlevelsare
available)
"POWER_RANGE",Transmitpowerlow,Transmit
powerhigh
TransmitpowerrangeindBmwithadjustablepowerlevels
"STABILITY",Carrierstability
Toleranceoftransmitteroutputfrequencyexpressedasapercentof
carrierfrequencyNotusedbyAtoll
"ATPC_POWER",Powerreduction ATPCpowerreductionindB
"ATPC_STEP",Stepsize
ATPCstepsizeindBwhenpowerincreasestocompensatefor
reductioninreceivelevelNotusedbyAtoll
"ATPC_TRIG",Receiverlevel
ReceiverlevelindBmatwhichATPCfirstactivatesNotusedby
Atoll
"THRESH_DIG",Thresholdfor106BER,Threshold
for103BER
ReceiverthresholdindBmatthespecifiedthresholds(digitalradio
only)
"THRESH_ANA",Thresholdfor30dBanalogsignal
tonoiselevel,Thresholdfor37dBanalogsignalto
noiselevel
ReceiverthresholdindBmatthespecifiedthresholds(analogradio
only)NotusedbyAtoll
123
"BRANCHING",Configuration,Transmitterloss,Main
receiverloss,Protectreceiverloss
SystemconfigurationandbranchinglossesindB
Configurationcanbe:NP=notprotected;MHSB=monitoredhot
standby;MHSD=monitoredhotspacediversity;FD=frequency
diversitydiversity;1:M=multiline
"MAX_RSL",Overflowthresholdfor106BER,
Overflowthresholdfor103BER
MaximumreceivelevelindBm(overflowthreshold)
"DFM",DFMfor106BER,DFMfor103BER
Dispersivefademargin(dB)atthespecifiedBER(digitalradioonly)
NotusedbyAtoll
"TX_SPECTRUM",Numberofpoints Numberofpointsusedtodefinethetransmittermaskgraph
"CURVE_POINT",FrequencyshiftinMHz,Response
indBm/4Hz
Datapointsofthetransmittermaskgraph
"TX_FILTER", NotusedbyAtoll
"FCC_BANDWIDTH",FCCbandwidth
FCCchannelbandwidthinMHzusedtocalculatetheFCCspectrum
maskNotusedbyAtoll
"99%_BANDWIDTH",99%powerbandwidth
BandwidthoccupiedbythetransmitterinMHz(including99%ofthe
transmittedpower)
"3DB_BANDWIDTH",3dBbandwidth
BandwidthoccupiedbythetransmitterinMHz(betweenthe3dB
points)NotusedbyAtoll
"T/T_FREQ_SEP",SameAntenna&Polarization,Same
Antenna&DifferentPolarization,DifferentAntenna
&Polarization
Minimumrequiredfrequencyseparationbetweentwotransmitters
inMHzNotusedbyAtoll
"T/R_FREQ_SEP",SameAntenna&Polarization,Same
Antenna&DifferentPolarization,DifferentAntenna
&Polarization
Minimumrequiredfrequencyseparationbetweentheclosest
transmitterandreceiverinMHzNotusedbyAtoll
"T/R_FIXED",T/Rspacing#1,T/Rspacing#2,etc.,
Someradiosonlyallowfixedtransmitreceivefrequency
separations.Ifapplicable,showallallowablefrequencyseparations
inMHzNotusedbyAtoll
"T/I_LIKE",Numberofpoints
NumberofpointsusedtodefinetheThresholdtoInterference(T/I)
graph.Theinterferingtransmitterandvictimreceiverarethesame
typeofradio,usingthesamemodulationanddatarate.
indB
DatapointsoftheT/Igraph
"T/I_CW",Numberofpoints
NumberofpointsusedtodefinetheThresholdtoInterference(T/I)
graph.TheinterferingtransmitterisaCWtoneandthevictim
receiverisadigitalradio.ThisT/IcurveisusedtomodelFM
transmittersinterferingintodigitalreceiversNotusedbyAtoll
indB
DatapointsoftheT/IgraphNotusedbyAtoll
"T/I_OTHER",RADIO_ID,InterferorBandwidth,
Numberofpoints
Othercapacityradiointospecifiedradio
RADIO_IDreferstotheRadioIdentificationoftheinterfering
transmitter.
InterferorBandwidthshallcorrespondtotheFCCorITUemission
bandwidthoftheinterferor,specifiedasarealnumberinMHz.
indB
DatapointsoftheT/Igraph
"BB_FREQ",Lowfrequency,Highfrequency
BasebandfrequencyrangeinkHz(analogradioonly)Notusedby
Atoll
"RX_RF_FILTER",Numberofpoints Numberofpointsusedtodefinethereceivermaskgraph
indB
Datapointsofthereceivermaskgraph
"RX_IF_FILTER",Numberofpoints NotusedbyAtoll
indB
NotusedbyAtoll
"IF_FILTER_EXT",Switchonpoint,Numberofpoints NotusedbyAtoll
indB
NotusedbyAtoll
Row Description
124
Sample
"RX_BB_FILTER",Numberofpoints NotusedbyAtoll
indB
NotusedbyAtoll
"COM_COUNT",Numberofcomments Numberofcomments
"COMMENT",Description#1 Comment
"COMMENT",Description#2 Comment
"COMMENT",Description#n Comment
"$TLR",Filetype,"$"
Filetrailer.Thefiletypeindicatesthedatacontained,theformat
andtheversionoftheformat.Forversion1.0oftheEquipment
format,thisvaluemustbeEQUIP1.0.
" $HDR" , " EQUI P1. 0" , " $"
" EQUI P_MFG" , " Al cat el USA"
" MFG_MODEL" , " MDR- 6706- 8"
" REV_NUM" , " Ver si on 1. 0"
" REV_DATE" , " 03- 01- 1999"
" RADI O_I D" , " J F6- 9406"
" FCC_CODE" ,
" EQ_DATE" , " 02- 24- 1999"
" EMI SSI ON" , " 2M50D7W"
" MAX_LOADI NG" , 192
" DATA_RATE" , 12. 4
" RADI O_CAP" , 8, " DS1"
" MODULATI ON" , " 128 TCM"
" DEVI ATI ON" ,
" FREQ_RANGE" , 5850, 7125
" POWER_OPTI ON" , 15, 29, 31
" POWER_RANGE"
" STABI LI TY" , 0. 001
" ATPC_POWER" , 10
" ATPC_STEP" , 1
" ATPC_TRI G" , - 65
" THRESH_DI G" , - 79, - 81
" THRESH_ANA"
" BRANCHI NG" , " Non- Pr ot ect ed" , 0, 0
" BRANCHI NG" , " Moni t or ed Hot - St andby" , 0, 0. 5, 10
" MAX_RSL" , - 10, - 8
" DFM" , 68, 70
" TX_SPECTRUM" , 25
" CURVE_POI NT" , - 3. 12, - 85. 65
. . .
" CURVE_POI NT" , 3. 12, - 85. 51
" TX_FI LTER" , 0
" FCC_BANDWI DTH" , 2. 5
" 99%_BANDWI DTH" , 2. 48
" 3DB_BANDWI DTH" , 2. 08
" T/ T_FREQ_SEP" , 49, 2. 5, 28
" T/ R_FREQ_SEP" , 132, 105, 33
Row Description
125
9.7 PathLossMatrixFileFormat
Whenpathlossmatricesarestoredexternally,i.e.,outsidetheATLfile,thepathlossmatricesfoldercontainsapathloss.dbf
filecontainingthecalculationparametersofthetransmittersandoneLOS(pathlossresults)filepercalculatedtransmitter.
ThepathlossmatricesfolderalsocontainsaLowResfolderwithanotherpathloss.dbffileandoneLOS(pathlossresults)file
pertransmitterthathasanextendedpathlossmatrix.
Theformatsofthepathloss.dbfandLOSfilesaredescribedhere.
9.7.1 Pathloss.dbfFileFormat
Thepathloss.dbffilehasastandardDBF(dBaseIII)format.ThefilecanbeopenedinMicrosoftAccess,butitshouldnotbe
modifiedwithoutconsultingtheForskcustomersupport.
Forgeneralinformation,theformatofDBFfilesinanyXbaselanguageisasfollows:
DBFStructure
DBFHeader
TheDBFheadersizeisvariableanddependsonthefieldcount.
"T/ R_FI XED"
"T/ I _LI KE" , 171
"CURVE_POI NT" , - 125. 000, - 130. 7
. . .
"CURVE_POI NT" , 125. 000, - 133. 0
"T/ I _CW" , 171
"CURVE_POI NT" , - 125. 000, - 152. 9
. . .
"CURVE_POI NT" , 125. 000, - 143. 0
"T/ I _OTHER" , " " , 0, 0
"BB_FREQ"
"RX_RF_FI LTER" , 68
"CURVE_POI NT" , - 125, - 113. 7
. . .
"CURVE_POI NT" , 125, - 110. 5
"RX_I F_FI LTER" , 0
"I F_FI LTER_EXT" , 0
"RX_BB_FI LTER" , 0
"COM_COUNT" , 1
"COMMENT", " T/ I Dat a f or 6. 425- 7. 125 GHz band"
"$TLR" , "EQUI P1. 0", " $"
Notationsusedinthefollowingtables:FS=FlagShip;D3=dBaseIII+;Fb=FoxBase;D4=
dBaseIV;Fp=FoxPro;D5=dBaseV;CL=Clipper
Byte Description Remarks
0...n DBFheader(seenextpartforsize,byte8)
n+1
1strecordoffixedlength(seenextparts);2ndrecord(seenextpartforsize,byte10);last
record
If.dbfisnotempty
last optional:0x1a(eofbyte)
126
FielddescriptorarrayintheDBFheader(32bytesforeachfield):
Byte Size Contents Description Appliesto
00 1 0x03 plain.dbf FS,D3,D4,D5,Fb,Fp,CL
0x04 plain.dbf D4,D5(FS)
0x05 plain.dbf D5,Fp(FS)
0x43 with.dbvmemovarsize FS
0xB3 with.dbvand.dbtmemo FS
0x83 with.dbtmemo FS,D3,D4,D5,Fb,Fp,CL
0x8B with.dbtmemoinD4format D4,D5
0x8E withSQLtable D4,D5
0xF5 with.fmpmemo Fp
01 3 YYMMDD Lastupdatedigits All
04 4 ulong Numberofrecordsinfile All
08 2 ushort Headersizeinbytes All
10 2 ushort Recordsizeinbytes All
12 2 0,0 Reserved All
14 1 0x01 Begintransaction D4,D5
0x00 EndTransaction D4,D5
0x00 ignored FS,D3,Fb,Fp,CL
15 1 0x01 Encrypted D4,D5
0x00 normalvisible All
16 12 0(1) multiuserenvironmentuse D4,D5
28 1 0x01 productionindexexists Fp,D4,D5
0x00 indexupondemand All
29 1 n languagedriverID D4,D5
0x01 codepage437DOSUSA Fp
0x02 codepage850DOSMultiling Fp
0x03 codepage1251WindowsANSI Fp
0xC8 codepage1250WindowsEE Fp
30 2 0,0 reserved All
32 n*32 FieldDescriptor(seenextparagraph) all
+1 1 0x0D HeaderRecordTerminator all
0 11 ASCI fieldname,0x00termin all
11 1 ASCI fieldtype(seenextparagraph) all
12 4 n,n,n,n Fldaddressinmemory D3
n,n,0,0 offsetfromrecordbegin Fp
0,0,0,0 ignored FS,D4,D5,Fb,CL
16 1 byte Fieldlength,bin(seenextparagraph) all\FS,CL:forCfieldtype
17 1 byte decimalcount,bin all/bothusedforfldlng
18 2 0,0 reserved all
20 1 byte WorkareaID D4,D5
0x00 unused FS,D3,Fb,Fp,CL
21 2 n,n multiuserdBase D3,D4,D5
0,0 ignored FS,Fb,Fp,CL
23 1 0x01 SetFields D3,D4,D5
127
FieldtypeandsizeintheDBFheader,fielddescriptor(1byte):
EachDBFrecord(fixedlength):
9.7.2 Pathloss.dbfFileContents
TheDBFfileprovidesinformationthatisneededtocheckvalidityofeachpathlossmatrix.
0x00 ignored FS,Fb,Fp,CL
24 7 0...0 reserved all
31 1 0x01 Fieldisin.mdxindex D4,D5
Size Type Description/Storage Appliesto
C1...n Char
ASCII(OEMcodepagechars)
rest=space,not\0term.
all
n=1...64kb(usingdecicount) FS
n=1...32kb(usingdecicount) Fp,CL
n=1...254 all
D8 Date 8ASCIIdigits(0...9)intheYYYYMMDDformat all
F1...n Numeric
ASCIIdigits(.0123456789)
variablepos.offloat.point
n=1...20
FS,D4,D5,Fp
N1...n Numeric
ASCIIdigits(.0123456789)
fixposit/nofloat.point
all
n=1...20 FS,Fp,CL
n=1...18 D3,D4,D5,Fb
L1 Logical ASCIIchars(YyNnTtFfspace) FS,D3,Fb,Fp,CL
ASCIIchars(YyNnTtFf?) D4,D5(FS)
M10 Memo
10digitsrepres.thestartblockposit.in.dbtfile,or10
spacesifnoentryinmemo
all
V10 Variable
Variable,bin/ascdatain.dbv
4bytesbin=startposinmemo
4bytesbin=blocksize
1byte=subtype
1byte=reserved(0x1a)
10spacesifnoentryin.dbv
FS
P10 Picture
binarydatain.ftp
structurelikeM
Fp
B10 Binary
binarydatain.dbt
structurelikeM
D5
G10 General
OLEobjects
structurelikeM
D5,Fp
22 shortint binaryintmax+/32767 FS
44 longint binaryintmax+/2147483647 FS
88 double binarysigneddoubleIEEE FS
Byte Size Description Appliesto
0 1 deletedflag"*"ornotdeleted"" All
1n 1
xtimescontentsoffields,fixedlength,unterminated.
Forn,see(2)byte1011
All
TX_NAME Text Nameofthetransmitter
FILE_NAME Text Name(andoptionally,path)of.losfile
128
9.7.3 LOSFileFormat
The LOS (path loss results) files are binary files with a standard rowcolumn structure. Data are stored starting from the
southwesttothenortheastcornerofthearea.Thefilecontains16bitsignedintegervaluesintherange[32768;+32767]
witha1/16 dBprecision."Nodata"valuesarerepresentedby+32767.
MODEL_NAME Text Nameofpropagationmodelusedtocalculatepathloss
MODEL_SIG Text
Signature(identitynumber)ofmodelusedincalculations.Youcancheckitinthe
propagationmodelproperties(Generaltab).
TheModel_SIGisusedforthepurposeofvalidity.AuniqueModel_SIGisassignedto
eachpropagationmodel.Whenmodelparametersaremodified,theassociatedmodel
IDchanges.ThisenablesAtolltodetectpathlossmatrixinvalidity.Inthesameway,two
identicalpropagationmodelsindifferentprojectsdonothavethesamemodelID
a
.
ULXMAP Float Xcoordinateofthetopleftcornerofthepathlossmatrixupperleftpixel
ULYMAP Float Ycoordinateofthetopleftcornerofthepathlossmatrixupperleftpixel
RESOLUTION Float Resolutionofpathlossmatrixinmetre
NROWS Float Numberofrowsinpathlossmatrix
NCOLS Float Numberofcolumnsinpathlossmatrix
FREQUENCY Float Frequencyband
TILT Float Transmitterantennamechanicaltilt
AZIMUTH Float Transmitterantennaazimuth
TX_HEIGHT Float Transmitterheightinmetre
TX_POSX Float Xcoordinateofthetransmitter
TX_POSY Float Ycoordinateofthetransmitter
ALTITUDE Float Groundheightabovesealevelatthetransmitterinmetre
RX_HEIGHT Float Receiverheightinmetre
ANTENNA_SI Float
Logicalnumberreferringtoantennapattern.Antennaswiththesamepatternwillhave
thesamenumber.
MAX_LOS Float
Maximumpathlossstatedin1/16dB.Thisinformationisused,whennocalculation
radiusisset,tocheckthematrixvalidity.
CAREA_XMIN Float
Lowestxcoordinateofcentrepixellocatedonthecalculationradius
b
CAREA_XMAX Float Highestxcoordinateofcentrepixellocatedonthecalculationradius
CAREA_YMIN Float Lowestycoordinateofcentrepixellocatedonthecalculationradius
CAREA_YMAX Float Highestycoordinateofcentrepixellocatedonthecalculationradius
WAREA_XMIN Float
Lowestxcoordinateofcentrepixellocatedinthecomputationzone
c
WAREA_XMAX Float Highestxcoordinateofcentrepixellocatedinthecomputationzone
WAREA_YMIN Float Lowestycoordinateofcentrepixellocatedinthecomputationzone
WAREA_YMAX Float Highestycoordinateofcentrepixellocatedinthecomputationzone
LOCKED Boolean
Lockingstatus
0:pathlossmatrixisnotlocked
1:pathlossmatrixislocked.
INC_ANT Boolean
Atollindicatesiflossesduetotheantennapatternaretakenintoaccountinthepath
lossmatrix.
0:antennalossesnottakenintoaccount
1:antennalossesincluded
a. Inordertobenefitfromthecalculationsharingfeature,usersmustretrievethepropagationmodelsfromthesame
central database. This can be done using the Open from database command for a new document or the Refresh
commandforanexistingone.Otherwise,Atollgeneratesdifferentmodel_ID(evenifsameparametersareappliedon
thesamekindofmodel)andcalculationsharingbecomeunavailableduetoinconsistency.
b. ThesecoordinatesenableAtolltodeterminetheareaofcalculationforeachtransmitter.
c. ThesecoordinatesenableAtolltodeterminetherectangleincludingthecomputationzone.
129
9.8 PathLossTuningFileFormat
AtollcantunepathlossescalculatedbypropagationmodelsusingCWmeasurementsordrivetestData.Pathlossesaretuned
bymergingmeasurementdatawithpropagationresultsonpixelscorrespondingtothemeasurementpointsandthepixelsin
thevicinity.Pathlossessurroundingthemeasurementpointsaresmoothedforhomogeneity.
Measuremmentpathsthatareusedforpathlosstuningarestoredasacatalogueinafoldercontainingapathloss.dbffileand
onePTS(pathlosstuning)filepertransmitter.Atuningfilecancontainseveralmeasurementpaths.
Formoreinformationonthepathlosstuningalgorithm,seetheTechnicalReferenceGuide.
9.8.1 Pathloss.dbfFileFormat
See"Pathloss.dbfFileFormat"onpage 125.
9.8.2 Pathloss.dbfFileContents
TheDBFfileprovidesinformationaboutthemeasuredtransmittersinvolvedinthetuning.
9.8.3 PTSFileFormat
ThePTS(pathlosstuning)filescontainaheaderandthelistofmeasurementpoints.
Header:
4bytes:version
4bytes:flag(canbeusedtomanageflagslikeactiveflag)
50bytes:GUID
4bytes:numberofpoints
255bytes:originalmeasurementname(withprefix"Num"fordrivetestdataand"CW"forCWmeasurements)
256bytes:comments
4bytes:X_RADIUS
4bytes:Y_RADIUS
4bytes:gain=measurementgainlosses
4bytes:globalerror
4bytes:rxheight
4bytes:frequency
8bytes:txPosition
Listofmeasurementpoints:
4bytes:X
4bytes:Y
4bytes:measurementvalue
4bytes:incidenceangle.
9.9 InterferenceMatrixFileFormats
InterferencematricesareusedbyGSM,LTE,andWiMAXAFPs(automaticfrequencyplanningtools).Interferencematrices
canbeimportedandexportedusingthefollowingformats:
GSM:CLC,IM0,IM1,IM2
LTEandWiMAX:IM2,TXT,CSV
Interferencematrixfilesmustcontaininterferenceprobabilityvaluesbetween0and1,andnotinprecentage(between0and
100%).Wheninterferencematrixfilesareimported,Atolldoesnotchecktheirvalidityandimportsinterferenceprobability
valuesforloadedtransmittersonly.
TX_NAME Text Nameofthetransmitter
FILE_NAME Text Name(andoptionally,path)of.ptsfile
AREA_XMIN Float Notused
AREA_XMAX Float Notused
AREA_YMIN Float Notused
AREA_YMAX Float Notused
130
Inthefollowingformatdescriptionsandsamples,linesstartingwiththe"#"areconsideredascomments.
9.9.1 CLCFormat(OneValueperLine)
TheCLCformatuseswoASCIItextfiles:aCLCfileandaDCTfile.InterferencematricesareimportedbyselectingtheCLCfile
toimport.AtolllooksfortheassociatedDCTfileinthesamedirectoryandusesittodecodetransmitteridentifiers.IfnoDCT
fileisavailable,Atollassumesthatthetransmitteridentifiersarethetransmitternames,andthecolumns1and2oftheCLC
filemustcontainthenamesoftheinterferedandinterferingtransmittersinsteadoftheiridentificationnumbers.
9.9.1.1 CLCFileFormat
TheCLCfileconsistsoftwoparts.Thefirstpartisaheaderusedforformatidentification.Itmuststartwithandcontainthe
followinglines:
Thesecondpartdetailsinterferencehistogramofeachinterferedsubcellinterferingsubcellpair.Thelinesaftertheheader
areconsideredascommentsiftheystartwith"#".Ifnot,theymusthavethefollowingformat:
The5tabseparatedcolumnsaredefinedinthetablebelow:
Thecolumns1,2,and3mustbedefinedonlyinthefirstlineofeachhistogram.
Sample
InGSMinterferencematrices:
The interferer TRX type is not specified and is always considered to be BCCH.
Subcells have different powers defined as offsets with respect to the BCCH. For
subcells other than the BCCH, if the power offset of a subcell is X dB, then its
interferencehistogramwillbeshiftedbyX dBwithrespecttotheBCCHinterference
histogram.
IfnopoweroffsetisdefinedontheinterferedTRXtype,itispossibletoset"All".
For each interfered subcellinterferer subcell pair, Atoll saves probabilities for
severalC/Ivalues(6to24values),includingfivefixedones:9,1,8,14,and22 dB.
BetweentwofixedC/Ivalue,therecanbeuptothreeadditionalvalues(thisnumber
dependsontheprobabilityvariationbetweenthefixedvalues).TheC/Ivalueshave
0.5 dBaccuracyandprobabilityvaluesarecalculatedandstoredwithanaccuracyof
0.002 for probabilities between 1 and 0.05, and with an accuracy of 0.0001 for
probabilitieslowerthan0.05.
# Cal cul at i on Resul t s Dat a Fi l e.
# Ver si on 1. 1, Tab separ at ed f or mat . Comment ed l i nes st ar t wi t h #.
<Col umn1><t ab><Col umn2><t ab><Col umn3><t ab><Col umn4><t ab><Col umn5><newl i ne>
Column Name Description
Column1 Interferedtransmitter
Identificationnumberoftheinterferedtransmitter.Ifthecolumnisempty,
itsvalueisidenticaltotheoneofthelineabove.
Column2 Interferingtransmitter
Identificationnumberoftheinterferertransmitter.Ifthecolumnisnull,its
valueisidenticaltotheoneofthelineabove.
Column3 InterferedTRXtype
Interferedsubcell.Ifthecolumnisnull,itsvalueisidenticaltotheoneofthe
lineabove.Inordertosavestorage,allsubcellswithnopoweroffsetarenot
duplicated(e.g.BCCH,TCH).
Column4 C/Ithreshold C/Ivalue.Thiscolumncannotbenull.
Column5 ProbabilityC/I>Threshold
ProbabilitytohaveC/Ithevaluespecifiedincolumn4(C/Ithreshold).This
fieldmustnotbeempty.
# Remar k: C/ I r esul t s do not i ncor por at e power of f set val ues.
# Fi el ds ar e:
##- - - - - - - - - - - - #- - - - - - - - - - - - #- - - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - - - - - - - - - - #
131
9.9.1.2 DCTFileFormat
The.dctfileisdividedintotwoparts.Thefirstpartisaheaderusedforformatidentification.Itmuststartwithandcontain
thefollowinglines:
ThesecondpartprovidesinformationabouttransmitterstakenintoaccountinAFP.Thelinesaftertheheaderareconsidered
ascommentsiftheystartwith"#".Ifnot,theymusthavethefollowingformat:
#| I nt er f er ed | I nt er f er i ng| I nt er f er ed | C/ I | Pr obabi l i t y |
#| Tr ansmi t t er | Tr ansmi t t er | Tr x t ype | Thr eshol d | C/ I >= Thr eshol d |
##- - - - - - - - - - - - #- - - - - - - - - - - - #- - - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - - - - - - - - - - #
#
# War ni ng, The par amet er set t i ngs of t hi s header can be wr ong i f
# t he " expor t " i s per f or med f ol l owi ng an "i mpor t " . They
# ar e cor r ect when t he " expor t " f ol l ows a " cal cul at e" .
#
# Ser vi ce Zone Type i s " Best si gnal l evel of t he hi ghest pr i or i t y HCS l ayer " .
# Mar gi n i s 5.
# Cel l edge cover age pr obabi l i t y 75%.
# Tr af f i c spr eadi ng was Uni f or m
##- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #
1 2 TCH_I NNER 8 1
9 0. 944
10 0. 904
11 0. 892
14 0. 844
15 0. 832
16 0. 812
17 0. 752
22 0. 316
25 0. 292
1 2 BCCH, TCH
a
8 1
9 0. 944
10 . 904
13 0. 872
14 0. 84
17 0. 772
a. IftheTCHandBCCHhistogramsarethesame,theyarenotrepeated.Asinglerecordindicatesthatthehistograms
belongtoTCHandBCCHboth.
# Cal cul at i on Resul t s Di ct i onar y Fi l e.
<Col umn1><t ab><Col umn2><newl i ne>
Column Name Type Description
Column1 Transmittername Text Nameofthetransmitter
Column2 TransmitterIdentifier Integer Identificationnumberofthetransmitter
Column3 BCCHduringcalculation Integer BCCHusedincalculations
Column4 BSICduringcalculation Integer BSICusedincalculations
Column5 %ofviccoverage Float Percentageofoverlapofthevictimservicearea
Column6 %ofintcoverage Float Percentageofoverlapoftheinterfererservicearea
132
The last four columns describe the interference matrix scope. One transmitter per line is described separated with a tab
character.
Sample
9.9.2 IM0Format(OneHistogramperLine)
Thisfilecontainsonehistogramperlineforeachinterfered/interferingsubcellpair.ThehistogramisalistofC/Ivalueswith
associatedprobabilities.
The.im0fileconsistsoftwoparts.Thefirstpartisaheaderusedforformatidentification.Itmuststartwithandcontainthe
followinglines:
Thesecondpartdetailsinterferencehistogramofeachinterferedsubcellinterferersubcellpair.Thelinesaftertheheader
# Cal cul at i on Resul t s Di ct i onar y Fi l e.
# Fi el ds ar e:
##- - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - #- - - - - - - - - #
#| Tr ansmi t t er | Tr ansmi t t er | BCCH dur i ng| BSI C dur i ng| %of vi c' | %of i nt ' |
#| Name | I dent i f i er | cal cul at i on| cal cul at i on| cover age | cover age |
##- - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - - - #- - - - - - - - - #- - - - - - - - - #
#
# t he " expor t " i s per f or med f ol l owi ng an " i mpor t ". They
# ar e cor r ect when t he "expor t " f ol l ows a " cal cul at e" .
#
# Ser vi ce Zone Type i s "Best si gnal l evel per HCS l ayer " .
# Mar gi n i s 5.
# Cel l edge cover age pr obabi l i t y i s 75%.
# Tr af f i c spr eadi ng was Uni f or m( per cent age of i nt er f er ed ar ea)
##- - - - - - - - - - - - - - - - - - - - - - - - - - - #
Si t e0_0 1 - 1 - 1 100 100
Si t e0_1 2 - 1 - 1 100 100
Si t e0_2 3 - 1 - 1 100 100
Si t e1_0 4 - 1 - 1 100 100
Si t e1_1 5 - 1 - 1 100 100
Si t e1_2 6 - 1 - 1 100 100
Si t e2_0 7 - 1 - 1 100 100
Si t e2_1 8 - 1 - 1 100 100
<Col umn1><t ab><Col umn2><t ab><Col umn3><t ab><Col umn4><newl i ne>
Column1 Interferedtransmitter Nameoftheinterferedtransmitter.
Column2 Interferingtransmitter Nameoftheinterferertransmitter.
Interferedsubcell.Inordertosavestorage,allsubcellswithnopoweroffset
arenotduplicated(e.g.BCCH,TCH).
Column4 C/Iprobability
C/Ivalueandtheprobabilityassociatedtothisvalueseparatedbyaspace
character.Thisentrycannotbenull.
133
Sample
9.9.3 IM1Format(OneValueperLine,TXNameRepeated)
This file contains one C/I threshold and probability pair value per line for each interfered/interfering subcell pair. The
histogramisalistofC/Ivalueswithassociatedprobabilities.
The.im1fileconsistsoftwoparts.Thefirstpartisaheaderusedforformatidentification.Itmuststartwithandcontainthe
followinglines:
Thesecondpartdetailsinterferencehistogramofeachinterferedsubcellinterferersubcellpair.Thelinesaftertheheader
# Fi el ds ar e:
#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#Tr ansmi t t er I nt er f er er TRX t ype {C/ I Pr obabi l i t y} val ues
#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#
#
# Mar gi n i s 5.
##- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #
#
Si t e0_2 Si t e0_1 BCCH, TCH- 10 1 - 9 0. 996 - 6 0. 976 - 4 0. 964 - 1 0. 936
0 0. 932 1 0. 924 4 0. 896 7 0. 864 8 0. 848
9 0. 832 10 0. 824 11 0. 804 14 0. 712 17 0. 66
Si t e0_2 Si t e0_3 BCCH, TCH- 10 1 - 9 0. 996 - 6 0. 976 - 4 0. 972 - 1 0. 948
0 0. 94 1 0. 928 4 0. 896 7 0. 856 8 0. 84
11 0. 772 13 0. 688 14 0. 636 15 0. 608 18 0. 556
Si t e0_3 Si t e0_1 BCCH, TCH- 10 1 - 9 0. 996 - 6 0. 98 - 3 0. 948 0 0. 932
1 0. 924 4 0. 892 7 0. 852 8 0. 832 9 0. 816
10 0. 784 11 0. 764 14 0. 644 15 0. 616 18 0. 564
Si t e0_3 Si t e0_2 BCCH, TCH- 9 1 - 6 0. 972 - 3 0. 964 - 2 0. 96 0 0. 94
1 0. 932 4 0. 904 7 0. 876 8 0. 86 9 0. 844
11 0. 804 13 0. 744 14 0. 716 15 0. 692 18 0. 644
<Col umn1><t ab><Col umn2><t ab><Col umn3><t ab><Col umn4><t ab><Col umn5><newl i ne>
Column1 Interferedtransmitter Nameoftheinterferedtransmitter.
Column2 Interferingtransmitter Nameoftheinterferertransmitter.
134
Sample
9.9.4 IM2Format(CoandAdjacentchannelProbabilities)
IM2 files contain cochannel and adjacentchannel interference probabilities for each interfered transmitter interfering
transmitterpair.InGSM,thereisonlyonesetofvaluesforallthesubcellsoftheinterferedtransmitter.Eachlinemusthave
thefollowingformat:
Wheretheseparator(<SEP>)caneitherbeataborasemicolon.
Thefourcolumnsaredefinedinthetablebelow:
Interferedsubcell.Inordertosavestorage,allsubcellswithnopoweroffset
arenotduplicated(e.g.BCCH,TCH).
Column4 C/Ithreshold C/Ivalue.Thiscolumncannotbenull.
Column5 ProbabilityC/I>Threshold
ProbabilitytohaveC/Ithevaluespecifiedincolumn4(C/Ithreshold).This
fieldmustnotbeempty.
# Fi el ds ar e:
#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#Tr ansmi t t er I nt er f er er TRX t ype C/ I Pr obabi l i t y
#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#
# t he " expor t " i s per f or med f ol l owi ng an " i mpor t ". They
# ar e cor r ect when t he "expor t " f ol l ows a " cal cul at e" .
#
# Ser vi ce Zone Type i s "Best si gnal l evel of t he hi ghest pr i or i t y HCS l ayer " .
# Mar gi n i s 5.
##- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #
Si t e0_2 Si t e0_1 BCCH, TCH - 10 1
Si t e0_2 Si t e0_1 BCCH, TCH - 9 0. 996
Si t e0_2 Si t e0_1 BCCH, TCH 0 0. 932
. . .
<Col umn1><SEP><Col umn2><SEP><Col umn3><SEP><Col umn4><newl i ne>
135
Sample
Thecolumnsinthesampleaboveareseparatedwithatab.Thesecolumnscanalsobeseparatedwithasemilcolon:
Column1 Interferedtransmitter Nameoftheinterferedtransmitter
Column2 Interferingtransmitter Nameoftheinterferertransmitter
Column3 Cochannelprobability Cochannelinterferenceprobability
Column4 Adjacentchannelprobability Adjacentchannelinterferenceprobability
# Fi el ds ar e:
#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#Tr ansmi t t er I nt er f er er Co- channel Adj acent channel
#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#
#
# Mar gi n i s 5.
##- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - #
Si t e0_2 Si t e0_1 0. 226667 0. 024
Si t e0_2 Si t e0_3 0. 27 0. 024
Si t e0_3 Si t e0_1 0. 276 0. 02
Si t e0_3 Si t e0_2 0. 226 0. 028
Si t e0_2; Si t e0_1; 0. 226667; 0. 024
Si t e0_2; Si t e0_3; 0. 27; 0. 024
Si t e0_3; Si t e0_1; 0. 276; 0. 02
Si t e0_3; Si t e0_2; 0. 226; 0. 028
136
AT320_AM_E2 Chapter10:AdministrationandUsageRecommendations
137
10 AdministrationandUsageRecommendations
ThischapterlistsvarioustechnicalrecommendationsforoptimisingyourworkwithAtoll.
10.1 GeographicData
LocationoftheGeographicData
Inmultiuserenvironments,itisrecommendedtoplaceallthegeographicdataonafileserveraccessibletoallthe
users.Thisapproachavoidstheneedtoreplicatethegeographicdataonalltheworkstations.
Geographicdatashouldeitherbelocatedoneachserveroraccessiblethroughafastnetworkconnection,e.g.,1 Gbps.
Youcanrestrictaccesstothegeographicdatalocationsbyassigningread/writeaccessrightstoadministratorsand
readonlyrightstoendusers.
LinkorEmbed
Only embed geographic data in ATL files if you wish to make a portable document. In all other cases, it is
recommendedtolinkgeographicdatafilestotheAtolldocuments.
ItisrecommendedtosetthepathstolinkedgeographicdatafilesusingtheUniversalNamingConvention(UNC).
Following the UNC, an absolute path, such as "C:\Program Files\Forsk\Geo Data\...", is represented as
"\\Computer\C\Program Files\Forsk\Geo Data\...", where "Computer" is the computer name, and "C" is the share
nameofdiskC.
Example:
IfyoudefinepathstogeographicdatafilesusingtheUNC,Atollwillbeabletokeeptrackofthelinkedfilesevenifthe
Atolldocumentismovedtoanothercomputer.
SizeofTiles
Somenetworkplanningtoolsrequiregeographicdatatobeavailableinsmalltilesinordertoworkmoreefficiently.
For a countrywide project, this can lead to hundreds of files describing the geographic data. Atoll is designed to
optimisememoryconsumption,whichenablesittoperformefficientlywithregionaltiles(1tile/fileperregion).In
Atoll,Mergingsmalltilestobuildaregionaltilecanimproveperformancegreatly.
Tonoteaswell:
Recommendedfilesize:100to200MB
ErdasImaginePyramidsfilescanbebigger.
ECWfilescanbeofanysize(nolimitations).
RecommendedFormats
Inordertoimproveperformance,itisrecommendedtouseuncompressedDTMandclutterfiles,forexample,BIL
files.Usingcompressedgeographicdatafiles,forexample,compressedTIForErdasImagine,cancauseperformance
reduction due to decompression of these files in real time. If you are using compressed geographic data files, it is
stronglyrecommendedto:
Either,hidethestatusbarthatdisplaysgeographicdatainformationinrealtime.Youcanhidethestatusbarfrom
theViewmenu.
Or,disablethedisplayofsomeoftheinformationcontainedinthestatusbar,suchasaltitude,clutterclass,and
clutterheightusinganoptionintheAtoll.inifile,see"HidingInformationDisplayedintheStatusBar"onpage 189.
Thefollowingtableshowstherecommendedfileformatsfordifferentgeographicdata:
AbsolutePath C:\ProgramFiles\Forsk\GeoData\...
RelativePath \ProgramFiles\Forsk\GeoData\...
UNCPath \\Computer\C\ProgramFiles\Forsk\GeoData\...
Geographicdatatype Recommendedfileformat
Scannedmaps ECW
Vectors SHP
138
Chapter10:AdministrationandUsageRecommendations Forsk2013
10.2 PathLossMatrices
SharedPathLossMatrices
Shared path loss matrices should be accessible through a fast network connection, e.g., 1 Gbps. These results are
accessedbyAtollduringcalculations,andshouldbeavailabletotheusersthroughafastnetworkconnection,i.e.,
30 Mbpsatleastperuser.
Youcanrestrictaccesstothesharedpathlossmatricesfolderbyassigningread/writeaccessrightstoadministrators
andreadonlyrightstoendusers.
PrivatePathLossMatrices
Atollsynchronisestheprivatepathlossmatriceswiththesharedpathlossmatrices.Ifprivatepathlossmatricesare
invalid,andthecorrespondingsharedpathlossmatricesarevalid,Atolldeletestheinvalidprivatepathlossmatrices
andusesthesharedones.YoucanmakeAtollverifyandremoveprivatepathlossmatrices,validorinvalid,whose
corresponding shared path loss matrices are valid. This can be useful for disk space management. For more
information,see"SynchronisingPrivateandSharedPathLossMatrices"onpage 185.
LinkorEmbed
Only embed path loss matrices in ATL files if you wish to make a portable document. In all other cases, it is
recommendedtolinkpathlossmatricestotheAtolldocuments.
ExternalisingpathlossmatricestosharedorprivatepathlossfolderswillkeeptheATLfilesizereasonable,whichwill
result in less fragmentation. Externalising path loss matrices does not reduce the performance of display and
calculationsinAtoll.
ItisrecommendedtosetthepathstotheprivateandsharedpathlossmatricesfoldersusingtheUniversalNaming
Convention(UNC).
Following the UNC, an absolute path, such as "C:\Program Files\Forsk\PathLosses\...", is represented as
"\\Computer\C\ProgramFiles\Forsk\PathLosses\...",where"Computer"isthecomputername,and"C"istheshare
nameofdiskC.
Example:
IfyoudefinepathstotheprivateandsharedpathlossmatricesfoldersusingtheUNC,Atollwillbeabletokeeptrack
ofthelinkedfileseveniftheAtolldocumentismovedtoanothercomputer.
CalculatingPathLossMatricesinMultiRATDocuments
WhenthepathlossmatricesinmultiRATdocumentsusingtheRunPathlossAPIfunction,thepathlossmatricesof
eachtechnologyarecalculatedsimultaneouslyusingthesamenumberofthreads.Forexample,if4threadsareused
tocalculatepathlossmatrices,andthereare3technologies(GSM,UMTS,andLTE),atotalof12threadswillbeused
tocalculatethepathlossmatricesatthesametime.Thiscanleadtothefollowingproblems:
InsufficientCPUresources
Insufficientmemory
Insufficientlicencesifexternalpropagationmodelsareused.
To avoid these problems when using the RunPathloss API function to calculate path loss matrices in multiRAT
documents,usethefollowingworkarounds:
UsetheDistributedCalculationServer,evenlocally.
Inyourscriptormacro,deactivatethetransmittersofthetechnologiesforwhichyoudonotwanttocalculatethe
pathlossmatricesandreactivatethemafterwards.Repeatitforalltechnologies.
Lower the number of threads using the NumberOfThreadsPathloss option in RemoteCalculation section in
Atoll.ini.Forexample,youcansettheoptionto2touseamaximumof6threads(3*2)duringpathlosscalculation
usingtheRunPathlossfunction.
AbsolutePath C:\ProgramFiles\Forsk\PathLosses\...
RelativePath \ProgramFiles\Forsk\PathLosses\...
UNCPath \\Computer\C\ProgramFiles\Forsk\PathLosses\...
Resource saturation during the calculation of path loss matrices for multiRAT
documentsonlyoccurswhenusingtheRunPathlossAPIfunctioninamacroorscript.
WhencalculatingpathlossmatricesforamultiRATdocumentusingAtoll,thisdoes
notoccur.
139
Atollsynchronisestheprivatepathlossmatriceswiththesharedpathlossmatrices.Ifprivatepathlossmatricesare
invalid,andthecorrespondingsharedpathlossmatricesarevalid,Atolldeletestheinvalidprivatepathlossmatrices
andusesthesharedones.YoucanmakeAtollverifyandremoveprivatepathlossmatrices,validorinvalid,whose
corresponding shared path loss matrices are valid. This can be useful for disk space management. For more
information,see"SynchronisingPrivateandSharedPathLossMatrices"onpage 185.
10.3 Databases
General
InordertouseAtollwithOracle,youmustcreateOracleusersandschemawithnamesinuppercase.
Createbackupsofthedatabasebeforeupgrading.
Itisrecommendedtodefinearuleformakingbackupsofthedatabaseatregularintervals.
Do not skip a major Atoll version. For example, if you are currently using Atoll 2.7.x, you should first upgrade the
databasetoAtoll2.8.xbeforeupgradingtoAtoll3.1.x.
Upgradingyourdatabasewillbesimplerifyoudonotskipamajorversion.Ifyouskiporhaveskippedanintermediate
majorversion,youmustupgradeyourdatabasetwiceinordertomakeitcompatiblewiththenewversion.
TablesandFields
Tableandfieldnamesarecasesensitive.
Tableandfieldnamesshouldbenotmorethan20characterslong.
Oracledatabasesallowamaximumlengthof30charactersforfieldandtablenames.However,foruseinAtoll,you
mustnotcreatetablesandfieldswithnameslongerthan20characters.ThisisbecauseAtolladdssomecharactersto
thetableandfieldnamesforcertainoperations:creatingassociatedtriggers,creatingprojectdatabases,etc.Limiting
thelengthoftableandfieldnamesto20characterswillhelpavoiddatabaseconnectionandconsistencyproblems.
Tableandfieldnamesshouldonlyusealphanumericcharacters(AZ,az,09).
Tableandfieldnamesmustnotstartwithanumericcharacter(09).
TableandfieldnamesmustnotcontainanSQLorRDBMSspecifickeyword,suchasORDER,DATE,etc.
Table and field names must not contain spaces or special characters, such as periods (.), exclamation marks (!),
interrogationmarks(?),parentheses(()),brackets({}),squarebrackets([]),etc.
Booleanfields,systemoruserdefined,shouldalwayshavedefaultvaluesassigned.
TheCustomFieldstableenablesyoutodefinedefaultvalues,choicelists,andread/writeaccessforanyfieldinany
table in Atoll, including userdefined fields that you add to the Atoll tables. The values defined in this table have
priorityovertheinternalpredefineddefaultvalues.Ifyoudefinefloatingpointdefaultvalues,makesurethatallthe
usershavethesamedecimalseparator.
IfyouwishtoaddcustomfieldsintheAtolldocument,youshouldfirstaddthefieldinthedatabase,andthenupdate
yourAtolldocumentfromthedatabase.
Whensettingupyourdatabaseforthefirsttime,trytoanticipateuserrequirementsintermsofcustomfieldsinAtoll
tables.Somerequirementsofthedifferentusergroupscanbesatisfiedifafewgeneralpurposeuserdefinedfields
areaddedinAtolltableswhensettingupthedatabase.
Forexample,ifyouaddthreeuserdefinedfields(oneoftypeinteger,float,andtext(limitedsize))totheSitesand
Transmitterstables,userswillbeabletousetheseforsorting,filtering,grouping,orotherpurposes.Thisapproach
canhelpthedatabasefunctionalongtimebeforeusersrequiretheadditionofothercustomfields.
To improver performance, if your projects allow it, reduce the size of the fields corresponding to the sites and
transmittersnames.
To improver performance, unless absolutely necessary, do not add userdefined fields of Text type. Rather, use
numericfieldtypes,whichallowsortingandotherfunctions.IfyoumustaddTextfields,allocatethemtheappropriate
sizethatwouldsuffice.Forexample,a255characterlongTexttypefieldwould,forthemostpart,occupydiskspace
fornopurpose.
Toimproverperformance,youshouldavoidaddingcustomfieldstotheneighbourmanagementtables.
10.4 CalculationServer
ComputationServerStabilityandResourceManagement
Incertainconditions,asdescribedbelow,Atollusersmightexperienceadecreaseinserverperformanceandstabilityina
multiuserCitrixenvironment.TheprincipaldifferenceobservedmightbetheinabilitytorunmultipleAtollsessionsonthe
server without getting error messages, general application failures, or server crashes. Such problems can occur when the
numberofAtollsessionsontheserver,carryingoutcalculations,increasestomorethanfour.
140
CausesofInstabilityandLossofPerformance
Thisgeneralinstabilityandlowperformanceoftheserversisdueto:
Insufficientmemoryresources:globallyandperprocess(Atollsession)
InsufficientCPUresources
Networkcongestion
Atollcanprocessfoursimultaneouspathlossmatricescalculations,whichmeanshighCPUandRAMresourceconsumption,
andaspathlosscalculationssharetheamountofmemoryallocatedtotheAtollsession,thetotalmemoryrequirementcan
exceed the Microsoft Windows (32bit editions) limit of 2 GB per process. This is especially the case with large Atoll
documentsandpropagationmodelsthatrequireconsiderablememory.
TroubleshootingandSolution
Asthecauseofthisproblemisresourcesaturationontheserver,resourceconsumptionshouldbecontrolledinordertoavoid
memoryandCPUoverloadingasfollows:
Toreducetheimpactofalargenumberofsimultaneouspathlosscalculations,aDistributedCalculationServershould
besetup.UsingtheDistributedCalculationServer,pathlosscalculationscanbeperformedoutsideAtoll.Usingthe
DistributionCalculationServerhasthefollowingadvantages:
PathlosscalculationsarelimitedtofourparallelinstancesregardlessofthenumberofAtollsessionsrunningon
theserver.ThisnotablyimprovesthememoryandCPUconsumption.
A queuing system, integrated in the Distributed Calculation Server, manages the calculation requests from
differentAtollsessions.
A failover mechanism automatically switches and hands over the path loss calculations back to Atoll in case a
problemoccurs.
Pathlosscalculationsarecarriedoutbyaseparateprocess(AtollSvr),whichhasitsownmemoryallocationapart
fromAtoll,i.e.,theamountofmemoryneededforcalculationsdoesnotimpactstheAtollmemoryallocation.
ThissetupcanintroduceconsiderableimprovementsinboththenumberofAtollsessionsperserverandthecalculations.A
serverwithfourprocessors(eightthreadswithhyperthreading)canaccommodatefoursimultaneouspathlosscalculations
andusetheotherfourthreadsforAtollsessions.Atollsinterfacewillalsobemoreefficientandtheoverallprocessingtime
forvarioustaskswillbeimproved.
Apartfromtheabovesetup,youcanalsomakesomeothersystemimprovements:
To avoid error messages caused by requesting a large number of files over the network, the following Microsoft
Windowsregistryparametercanbemodifiedinordertodedicatemoreresourcestonetworkread/writeoperations:
IRQSTACKSIZEshouldbesetto30insteadof11,forexample.
Toavoidoutofmemoryproblems,thePagefilesizeshouldbeincreasedsothattheserverdoesnotrunoutofglobal
memory when supporting more than 10 Atoll sessions simultaneously. This is different from the 2 GB per process
limit.Virtualmemorycanbeincreasedfrom8 GBto16 GB,forexample.
For32bitWindowsoperatingsystems,youcanalsoincreasethedefaultWindowsmemoryallocationlimitfrom2 GB
to3 GBasexplainedin"ProcessMemory"onpage 141.
10.5 AtollAdministrationFiles
ThereisnospecificorderinwhichconfigurationandinitialisationfilesshouldbecreatedorinstalledonAtollworkstations
and servers. It is sufficient to have these files created and placed in the right locations before running Atoll to have the
predefinedconfigurationofallworkstationsandservers.
Ifyouhavealreadyconfiguredthesefilesforoneserver,andyouaresettingupanotherserver,youcancopythesefilesto
theirrespectivelocationsonthenewservertohavetheexactconfigurationandsetupasthefirst.Ifyoudonotcopythese
files,orcreatethem,youwillnothavethesameconfigurationofthenewserver,butapartfromthatyouwillbeabletowork
withAtollnormally.Thesefilesareoptional,notobligatory.
InitialisationFile(INI)
ItishighlyrecommendedthattheAtollinitialisationfilebecreatedandmodifiedonlybytheadministrator.
IfyouareusingWindows2000Server,statetheactualnumberofprocessorsintheINIfile.
InordertopreventusersfromdeactivatingtheuseoftheDistributedCalculationServer,
andhencebypassingtheresourcecontrolprocedureestablishedabove,theAtoll.inifile
shouldbesetmadereadonlyforendusers.
141
UserConfigurationFile(CFG)
UseAtolltocreatethesefilesandavoidmodifyingthesefilesmanuallyashumanerrorscancreateproblems.
Uncheckimagevisibilitytoavoidloadingunnecessarydatainthememory.
Youcansetupyourconfigurationfilesinthefollowingmanner:
Acommonconfigurationfilethatpointstothegeographicdata,macros,andothercommonparametersinyour
Atolldocuments.
Separate configuration files created for your 2G and 3G projects, which would store their respective coverage
prediction studies parameters, traffic information, neighbour allocation parameters, and other technology
specificparameters.
Separate configuration files based on, and for, different groups of users. These groups of users can be, for
example,groupsofusersworkingondifferentregions,groupsofusersworkingondifferenttechnologies,groups
ofusersfocusingoncertainoperations(i.e.,performingcertaintypesofcoveragepredictions,performingtheAFP,
etc.).
CustomPredictionsFile
Coverage prediction studies can easily be duplicated within Atoll. Before creating study templates, and the XML
studiesfile,makesurethatthisstudytemplateisaimedatservinganumberofusers.Thismeans,avoidcreatingstudy
templatesunlessthesewillbeneededforalongtimebyanumberofusers.Youcanusetheconfigurationfilestostore
yourcreatedcoveragepredictionstudieslocally.And,youcanalsousethestudyduplicatefeaturetocreatecopiesof
existingcoveragepredictionstudies.
10.6 ProcessMemory
32bitOperatingSystems
Atoll can support 3 GB address space on a properly configured 32bit system. For more information, please refer to the
following URL: http://www.microsoft.com/whdc/system/platform/server/PAE/PAEmem.mspx (/3GB section in Memory
SupportandWindowsOperatingSystems).
ThefollowinglinkprovidesinformationonhowyoucansetupyourWindowsServer2003systemstoactivatethe3 GBswitch
atstartup:http://technet.microsoft.com/enus/library/bb124810.aspx.
64BitOperatingSystems
The64biteditionsofMicrosoftWindowsprovide4 GBofmemoryperprocess.
10.7 Printing
Youshouldplacedifferentlayersofgeographicandradiodatainadefiniteorderwhenprintingaprojectorasectionofthe
project.Thefollowingordershouldbefollowed:
1. VisibleobjectsoftheDatatab
AllthevisibleobjectsoftheDatatabaredisplayedabovethoseintheGeotab.However,itisstronglyrecommended
toplacevectorlayersonthetopofcoveragepredictionplots.Youcandothisbytransferringthesevectorlayersto
theDatatabusingthecontextmenu.Forperformancereasons,itisadvisedtoplacevectorlayersontopofraster
layersbeforeprintingaproject.SitesandTransmittersmustbeontheverytop,aboveallotherlayers.Youshould
placesitesandsectorsonthetop,thenvectorlayers,andthenrasterlayers.
2. Unidimensionalvectors(points)
3. Openpolygonalvectors(lines,i.e.,roadsandotherlinearitems,etc.)
4. Closedpolygonalvectors(surfaces,i.e.,zonesandareas,etc.)
5. Multiformatmaps(vectororrastermaps,i.e.,population,rain,genericmaps,traffic,etc.)
6. Transparentrastermaps(clutterclassmaps,etc.)
7. Nontransparentmaps(images,DTM,clutterheightmaps,etc.)
10.8 CoveragePredictionCalculations
If you do not want Atoll to calculatethe shadowing margin during a coverage prediction, it is advised to clear the
Shadowingtakenintoaccountcheckbox.Thisapproachismoreefficientintermsofperformancethanselectingthis
optionandsettingtheCelledgecoverageprobabilityto50%.
142
To improve memory consumption and optimise the calculation times, you should set the display resolutions of
coverage predictions according to the precision required. The following table lists the levels of precision that are
usuallysufficient:
10.9 CWMeasurementsandDriveTestData
ItisrecommendedtouseFastDisplayinordertoincreasedisplayspeed.ThisoptionisavailableintheDisplaytabof
the Properties dialogues for CW Measurements and Drive Test Data folders. Although this approach only displays
measurementpointsassmallsquares,itcanhaveasignificantimpactonperformancedependingonthenumberof
measurementpointsintheAtolldocument.
WhenperformingaCWmeasurementsdrivetestcampaign,pleasefollowtherecommendedproceduredescribedin
theMeasurementsandModelCalibrationGuide.
10.10 AntennaPatternsandImport
Antennanamesusedinsometools,suchasNetAct,canbedifferentfromthoseusedintheircorrespondingantenna
files.Tosolvethisissue,youcancreateanewfile,named"Index",containingthelistofantennanames,whichwould
infactbethepattern(antennafile)names.Youshouldplacethisfileatthesamelocationastheantennapatterns
(files).Thiswillreplacetheantennanameswiththenewantennanames.
SomeKathreinantennapatternfilesmighthavenamesdifferentfromtheantennapatternnamespresentinsidethe
file.Youwillhavetoreplacethenameofthepatterninsidethefilebythenameofthepatternfileitself,inorderto
importtheseantennascorrectly.
APlanetIndexfilecontainsthepathtoandthenameofeachantennafileavailable.CreatingsuchanIndexfilewhen
therearehundredsofantennapatternsavailablecanbeadifficulttask.Youcaneasilycreatetheindexfilefromthe
MicrosoftWindowscommandprompt.YoucanopentheCommandPromptwindowbyselectingStart>Run,entering
"cmd" and pressing ENTER. In the Command Prompt window, navigate to the directory containing the antenna
patternfiles,enterthefollowingcommandandpressENTER:
di r / b > I ndex
Thiswillcreateafilecalled"Index"inthesamedirectoryastheantennapatterfilescontainingalistofalltheantenna
patternfilenames,withonenameperline.Thefilewillalsocontainalinewithitsownname,so,beforeimporting
thisfileintoAtoll,youshoulduseatexteditortoremovethelinecontainingthefilename"Index."
Theelectricaltilt,whichcanbedefinedintheantennapropertiesdialoguesinAtoll,isanadditionalelectricaldowntilt.
It might be redundant to define an additional electrical downtilt for antennas whose patterns already include
electrical tilt. Users should verify whether the antenna patterns of the antennas in their projects, do not already
includetheeffectofanelectricaltilt.
10.11 TrafficMaps
Userprofileenvironmentbasedtrafficmapsshouldonlybeusedforaprecisionontrafficthatisofthesamelevelas
thestatisticalclutteravailableinaproject.
Forhigherprecisionontrafficdata,youshouldusesectortrafficmapsoruserdensitytrafficmaps.Userdensitytraffic
mapsprovideyouwithameanstodefineadensityforeachsetofservice,terminaltype,andmobilitytype.
SectortrafficmapsarebestsuitedfortrafficdataissuedbytheOMC.
10.12 AtollAPI
CorrectfunctioningofAtollwhenusingAtollthroughtheAPIisguaranteedduringinteractiveusersessionsonly.Atollisan
application that requires creating tool bars, creating menus, reading user profile options from the Windows registry,
accessingprinters,etc.,evenwhenitisaccessedthroughtheAPI.ThesameistrueforaddinsworkingwithAtoll.
Sizeofthecoverageprediction Displayresolution
CityCenter 5m
City 20m
County 50m
State 100m
Country Accordingtothesize
143
EventhoughitispossibletoloadanduseAtollwhenthereisnousersessionopenonacomputer,itscorrectfunctioningis
notguaranteed.Unexpectederrorscanoccur.Particularly,creatingobjectsthroughCreateObjectorCoCreateInstancemight
fail.
Therefore,thecorrectfunctioningofAtollrequiresanopenusersessiononthecomputer.
10.13 PerformanceandMemory
MemoryRefresh
YoucanavoidmemoryfragmentationwhileworkingwithAtolldocumentsbysavingtheAtolldocumentfromtimeto
time,closingandrestartingAtoll,andreopeningthedocument.
ThisadviceisapplicabletoanyapplicationrunningunderMicrosoftWindowsbecausemanycommonDLLfilesare
accessedbyapplications,andunloadingandreloadingtheseDLLfilesrefreshesthememoryallocation.
IfyouareworkinginaCitrixXenAppenvironment,youshouldrestartyourCitrixservereveryweekorfortnight.The
exacttimeshouldbedeterminedbytheadministratordependingonthestateofthenetwork(LAN).
Incertaincases,itmightbemoreappropriatetostartworkingonacompletelyfreshATLfile.Ifyouhavebeenworking
onyourexistingATLfileforalongtime,itmightbecomeunnecessarilylargeandmightcontainsomeuselessremains
from your earlier operations, e.g., traces of records that no longer exist in the database, etc. You can completely
refreshyourprojectbyfollowingthesesteps:
a. OpentheexistingATLfileinAtollthatyouwanttoreplace.
b. CreateaCFGfilefromyourexistingATLfilewithalltherequiredinformation,e.g.,geographicdataset,coverage
predictionparameters,neighbourallocationparameters,etc.Formoreinformation,referto"ConfigurationFiles"
onpage 147.
c. ClosetheoldATLfile.
d. CreateanewATLfromthedatabasetocreateafreshATLfile.
e. ImporttheCFGfileinthenewATLfile.
YounowhaveacleanATLfiletoworkwith,whichhasallthesameinformationastheoldATLfile,andtakesupless
spaceontheharddisk,haslessfragmenteddata,andimprovedperformance.
MemoryAllocation
IfyouhavetoopenseverallargeATLfilessimultaneouslyonthesamecomputer,itisbettertoopeneachinaseparate
AtollsessionratherthantoopenthemallinthesameAtollwindow.EachAtollsessiononthesamecomputerhasits
ownmemoryspaceallocatedbytheoperatingsystem.Eachcomputerconsumesasinglelicencetokenindependent
ofthenumberofAtollsessionsopenedsimultaneously.
For32bitWindowsoperatingsystems,youcanalsoincreasethedefaultWindowsmemoryallocationlimitfrom2 GB
to3 GBasexplainedin"ProcessMemory"onpage 141.
FileSize
Coverage predictions calculated over large areas require more memory. If you are working on an Atoll document
coveringalargearea,withcoveragepredictionscalculatedovertheentirenetwork,thisdocumentwillrequiremore
memoryforloadingallthecoveragepredictions.YoucanreducememoryconsumptionbymakingcopiesofyourAtoll
document,andkeepingafewcoveragepredictionsineachcopy.TheseATLfileswillbefastertoloadandworkwith
comparedtoasingleATLfilewithallthecoveragepredictions.
Largecoveragepredictionscantakeupaconsiderableamountofmemoryeveniftheyarenotdisplayedonthemap.
ExternaliseDTM,clutter,pathlossmatrices,andanyotherdatathatcanbeexternalised,sothattheATLfilesizedoes
notbecomeunnecessarilylarge.
PathLossCalculation
Beforestartingpathlosscalculation,verifythatthecalculationradiiandresolutionsassignedtothedifferenttypesof
transmittersareconsistent.Forexample,calculatingpathlossmatricesofpicocellsoverlargecalculationradiiwould
onlywastememoryanddiskspace.
Forcalculatingpathlossmatricesoverlargeareas,youshouldusethedualresolutionfeatureinAtoll.Defineshort
calculationradiiandfineresolutionsforthemainpathlossmatrices,andlargecalculationradiiandlowresolutions
forextendedpathlossmatrices.Thisapproachdecreasesthecalculationtimesignificantlycomparedtocalculating
justonematrixpertransmitterusingafineresolution.Themainpathlossmatricesshouldbecalculatedusingthe
sameresolutionastheresolutionofthegeographicdataavailable.Theextendedpathlossmatricescanbecalculated
usingalowerresolution,e.g.,twicetheresolutionofthegeographicdata.
144
Regionalisation
Usedatabaseregionalisationorsitelistsifyouareworkingonsmallerpartsofalargenetwork.Atollloadsonlythe
data necessary for your working area. If you load a large network, Atoll will load a lot of data that might not be
necessaryallthetime,suchastheneighbourrelationdata.
PerformanceandMemoryIssuesinLargeGSMProjects
MemoryproblemsmightbeexperiencedintheC/Icoveragepredictionstudies,interferencematricescalculations,andthe
AFPwhileworkingonlargeGSMnetworks.Largenetworkprojectsaremoresusceptibletotheseproblems.Ifthenetworkis
largebuthomogeneous,theseproblemsmightonlyappearifthenumberoftransmittersisover15,000orso.But,ifthereare
largecitycentresinvolved,witheachpixelhavingmanyoverlappingpathlossmatrices,thenthissizelimitmightdecreaseto
around5,000transmittersorso.
Also, if the Atoll session has been open for a long time, memory problems can even appear while working on smaller
networks.Thisisbecausetheprocessmemoryspace(memoryspaceallocatedtoAtollbytheoperatingsystem)becomes
fragmented.
Followingisalistofadvicewhichyoucanfollowinordertoavoidsuchproblems:
Useregionalisationorsitelists:Ifyouloadalargenetwork,Atollwillberequiredtoloadalotofdatathatmightnot
benecessaryallofthetime.Forexample,inatypicallargeGSMnetwork,youmighthavearound10,000transmitter
records,20,000subcellrecords,50,000TRXrecords,andupto150,000neighbourrecords.
Externaliseembeddedinterferencematrices:YoucanstoreinterferencematriceslistedintheInterferenceMatrices
folderinexternalfiles.Atollloadsinterferencematricesfromtheexternalfilestothememoryonlywhenneeded.You
willalsoreducetheATLfilesizebyexternalisingtheinterferencematrices.
Adapt calculation radii to the cell type and the EIRP: Before calculating path loss matrices, take care to correctly
associatecalculationradiiandresolutionstodifferenttypesofcells.Ifyoucalculatepathlossmatricesforalltypesof
cellsoveralargecalculationradius,itwillunnecessarilyburdentheC/Iandinterferencematricescomputations.
Properlyconfiguretheinterferencethresholds:Thesethresholdsindicatethelevelafterwhichaninterferercanbe
ignored. The default value for this threshold (130 dBm), defined in the Predictions tab of the Predictions folders
Propertiesdialogue,meansthatthecomputationswilltakeintoaccountalltheinterferers.However,ifyousetittoo
high, you might lose important interference information. The proper value for this threshold depends on the
Reception Thresholds and the C/I Thresholds defined in the Subcells table. The optimum value would be
. Which means the minimum value of the factor computed for all
subcells,i.Where,RT
i
isthereceptionthresholdofthesubcelli,CIT
i
theC/Ithresholdofthissubcell,andMisasafety
margin.
Sincethisinterferencethresholdisusedbothininterferencematricescalculationandininterferencepredictions,itis
importantto have atleasta 3dB margin fortheinterference energy aggregationin C/I studies. Werecommend a
safetymarginof5dB,whichcanbereducedifanyproblemisencountered.
DonotdefineveryhighC/Iqualitythresholds(Defaultvalues:12dBforBCCHand9dBforTCH).Ifyouwantacertain
TRXtypetocarryGPRS/EDGEtraffic,youcanadd1or2dBtothisvalueforthatTRXtype,andusetheoptionofsafety
margin in the AFP modules Cost tab. The 12 dB and 9 dB default values already include safety margins. If you
incrementthesevaluestoomuch,itwillunnecessarilyloadtheinterferencematrixgenerationandtheAFP.
DonotstartanAFPsessioniftheinterferencematricesreportindicatesproblems:Allthetransmittersshouldhave
interferersandveryfewofthem(notmorethan20%)shouldhavemorethan70interferers.Iftherearetoomanyor
toofewentriesinyourinterferencematrices,theAFPplanwillnotbeoptimal.
Ifthememorycriticaltaskisinterferencematricesgeneration:Youcangenerateinterferencematricesinapiecewise
manner.
Thismeansthatyoucangeneratenationwideinterferencematriceswithlowresolutionsbasedonthepercentageof
interferedarea(toimprovecomputationtime),withacelledgecoverageprobabilityof50%(whichmeansnoaccess
toclutterforreadingstandarddeviationvalues),andaninterferencethresholdof112dBm.Thiswillproviderough
global interference matrices which can be locally improved. These interference matrices will be less memory
consuming.
Then,usepolygonorsitelistfilterstofocusoneachimportantlocation,andcalculatelocalinterferencematriceswith
higherresolutionsandreliabilities.Makesurethatthecomputationzoneinyourprojectcompletelyencompassesthe
filteringzonesthatyoudefine.
If the memorycritical task istheAFP session: Trytomake the document lighter,e.g., removecoverage prediction
studies,exitandrestartAtoll,andtrytogenerateinterferencematriceswithfewerentries.
Ifthememorycriticaltaskisthetrafficcapture:YoucanusetrafficloadfieldoftheSubcellstabletoprovidetraffic
loadsdirectlytotheAFP,andpossiblyskipthisstep.
PerformanceandMemoryIssuesinUMTS/CDMASimulations
Inordertooptimisememoryusageduringsimulations,youcansetthe"Informationtoretain"optionto"Onlythe
Average Simulation and Statistics". With this option Atoll uses much less memory because it only keeps limited
Mi n
Al l Subcel l s
RT
i
CIT
i
M ( ) RT
i
CIT
i
M
145
informationinmemoryduringthesimulationprocess.Simulationresultsaredetailedenoughtobeusedingenerating
coveragepredictionstudies.
PerformanceandMemoryIssuesinCoplanningProjects
Coplanning with Atoll requires that both technology documents be open in the same Atoll window at the same time.
However, loading, for example, a GSM and a UMTS document can cause memory saturation especially if the documents
containlarge,countrywidenetworks.TodecreasetheamountofmemoryusedbyAtollinsuchcases,youcan:
Loadvectorlayersinmaindocumentonly.Loadingvectorsinthelinkeddocumentisnotnecessaryandonlyconsumes
morememory.
Avoidloadingneighboursandcustomfieldswhicharenotrequired.Thiscanbeperformedbycreatingviewsinthe
database.Formoreinformation,see"Appendix2:SettingUpDatabasesforCoplanning"onpage 70.
146
AT320_AM_E2 Chapter11:ConfigurationFiles
147
11 ConfigurationFiles
Configurationfilescanbeusedtostoreparameteranddisplaysettings.Thesefilesareoptional,notrequiredforworkingwith
Atoll,butareusefulmeansformakingworkeasier.
Thischapterdescribestheformatsofthesefilesindetail:
Userconfigurationfiles(UTF8encodedXMLformatGEOorCFGfiles)
A user configuration file containing only the geographic data settings can be saved with a GEO extension. A user
configuration file containing the geographic data settings and other parameter settings can be saved with a CFG
extension.
UserconfigurationfilesmustbecreatedusingAtolltoensurecorrectsyntaxandstructure.Itispossibletoeditthe
contentsofthesefilesinanXMLeditorandmakechangesifrequired(forexample,toupdatethepathstogeographic
datafiles).FormoreinformationonhowtocreateandloaduserconfigurationfilesinAtoll,seetheUserManual.
Thesefilescanstore:
Geographicdatasettings
Filtering,focus,computation,printing,andgeographicexportzones
Mapcentreandzoomlevel
Folderconfigurations
ListofcoveragepredictionsinthePredictionsfolderandtheirsettings
Automaticneighbourallocationparameters
Automaticfrequencyplanningparameters(GSMGPRSEDGEdocuments)
Automaticscramblingcodeallocationparameters(UMTSHSPAandTDSCDMAdocuments)
AutomaticPNoffsetallocationparameters(CDMA2000documents)
AutomaticOFDMresourceallocationparameters(LTE,WiMAX,WiFi)
Microwavelinkparameters
Fullpathstomacrofiles
For more information on the contents of user configuration files, see "Contents of User Configuration Files" on
page 148.
AuserconfigurationfilecanbeautomaticallyloadedwhenAtollisrunif:
a. ThefileisidentifiedinthecommandlineparameterCfg"cfgfilename"(see"AtollCommandLineParameters"on
page 36formoreinformation),or
b. The file is named "Atoll.cfg" and is located in the Atoll installation folder. This file will be ignored if a user
configurationfileisloadedthroughthecommandlineparameter.
Additionalconfigurationfiles(UTF8encodedXMLformatCFGfilesorplaintextINIfiles)
ThefollowingparametersettingscanbestoredinadditionalconfigurationfileswithaCFGextension:
Printsetupconfiguration
Tableimport/exportconfiguration
Coveragepredictionreportconfiguration
ThefollowingparametersettingscanbestoredinspecificINIfiles:
CWmeasurementimportconfiguration
Drivetestdataimportconfiguration
For more information on the contents of additional configuration files, see "Contents of Additional Configuration
Files"onpage 171.
Custompredictionsfile(UTF8encodedXMLfiles)
This file contains the list and parameter settings of customised coverage predictions. By default, this file is named
"Studies.xml"andislocatedintheAtollinstallationfolder.
ThecustompredictionsfilemustbecreatedusingAtolltoensurecorrectsyntaxandstructure.Itispossibletoedit
the contents of this file in an XML editor and make changes if required. For more information on working with
customisedpredictionsinAtoll,seetheUserManual.
Formoreinformationonthecontentsofthecustompredictionsfile,see"ContentsoftheCustomPredictionsFile"on
page 175.
Projection and display coordinate systems are stored in the database, not in user
configurationfiles.
Simulationsettingsarenotstoredinuserconfigurationfiles.
148
Chapter11:ConfigurationFiles Forsk2013
11.1 ContentsofUserConfigurationFiles
Thedescriptionsandexamplesprovidedbelowforeachparametersetcanhelpunderstandtheformatandfunctionofthe
userconfigurationfiles.Thefollowingdetailsareavailable:
"GeographicDataSet"onpage 148
"MapCentreandZoomLevel"onpage 152
"Zones"onpage 151
"FolderConfiguration"onpage 152
"CoveragePredictions"onpage 159
"AutomaticNeighbourAllocationParameters"onpage 161
"AutomaticFrequencyPlanningParameters"onpage 163
"AutomaticScramblingCodeAllocationParameters"onpage 164
"AutomaticPNOffsetAllocationParameters"onpage 165
"MicrowaveRadioLinksParameters"onpage 167
"Macros"onpage 171.
11.1.1 GeographicDataSet
Thefollowingparametersaresavedforvariousgeographicdatatypes:
<DegreeFormat>:Formatusedtodisplaydegrees,minutes,andsecondsforgeographiccoordinatesystems
Population,geoclimaticparameters,vectortrafficmaps,andothervectorlayers:
<Name>:Nameofthefolder
<Display>:(Differentcombinationsofthefollowingparametersexistindifferentdisplaysettings.)
Displaytype<type>,selectedfield<FieldSelector>,fielddescription<FieldDesc>containing<FieldId>(same
as <FieldSelector>) and <FieldTitle>, visibility flag <visible>, and visibility range between <minZoom> and
<maxZoom>
<SymbolFont> properties, such as: font name <Name>, font size <Size>, font colour <Color>, background
colour<BackColor>,andfontstyle<Style>
<LabelFont>properties,such as:labelfontname <Name>,labelfont size <Size>,labelfontcolour <Color>,
labelfontbackgroundcolour<BackColor>,andlabelfontstyle<Style>
<Items> properties, such as for each item: <Value>, <Min>, <Max>, <Legend>, <MainColor>,
<SecondaryColor>,<LineStyle>,<LineWidth>,and<FillStyle>
<AddToLegend>:Addtolegendoptioncheckedornot
<Type>:Datatypeproperties,suchas<Name>,<Formats>,<Type>,and<Integrable>
<File>:Containsthefileformat,path,coordinatesysteminformation.
<Format>ofand<Path>tolinkedfiles,ifany
Coordinate system information for vector format data including: <CoordinateSystemName>,
<CoordinateSystemCode>,<EllipsoidCode>,<EllipsoidMajorRadius>,<EllipsoidMinorRadius>,<DatumCode>,
<DatumShiftX>,<DatumShiftY>,<DatumShiftZ>,<DatumRotationX>,<DatumRotationY>,<DatumRotationZ>,
<DatumScaleFactor>, <ProjectionMethod>, <ProjectionZone>, <ProjectionLongitudeOrigin>,
<ProjectionLatitudeOrigin>, <ProjectionFalseEasting>, <ProjectionFalseNorthing>, <ProjectionScaleFactor>,
<ProjectionFirstParallel>,<ProjectionSecondParallel>,and<ProjectionAngle>
ClutterClasses:
Displatetype<type>,selectedfield<FieldSelector>,fielddescription<FieldDesc>containing<FieldId>(same
as<FieldSelector>)and<FieldTitle>,transparencylevel<Opacity>,visibilityflag<visible>,andvisibilityrange
between<minZoom>and<maxZoom>
<Attributes>,suchas:<records>and<fields>,whichare,
Common:CODE,COLOR,NAME,HEIGHT,INDOOR
Under<GSM>:STDDEV,COVERI_STDDEV,TX_DIV_GAIN,ANT_HOP_GAIN
Under <UMTS>: STDDEV, EC_IO_STDDEV, EB_NT_DL_STDDEV, EB_NT_UL_STDDEV, ALPHA, FORTHO,
SM_GAIN_FACTOR,STTD_GAIN_OFFSET
Under <LTE>: STDDEV, COVERI_STDDEV, MIMO_GAIN_FACTOR, DIV_GAIN_OFFSET_DL,
DIV_GAIN_OFFSET_UL
Under<1XRTT>:STDDEV,EC_IO_STDDEV,EB_NT_DL_STDDEV,EB_NT_UL_STDDEV,ALPHA,FORTHO
Under <TDSCDMA>: STDDEV, EC_IO_STDDEV, EB_NT_DL_STDDEV, EB_NT_UL_STDDEV, FORTHO_UL,
FORTHO_DL,ANGULAR_SPREAD
Under <IEEE_802.16e>: STDDEV, COVERI_STDDEV, MIMO_GAIN_FACTOR, STTD_OFFSET_DL,
STTD_OFFSET_UL
Under<WiFi>:STDDEV,COVERI_STDDEV,MIMO_GAIN_FACTOR,STTD_OFFSET_DL,STTD_OFFSET_UL
149
<DefaultValues>,forthefieldsstatedabove.
ClutterHeightsandDigitalTerrainModels:
as<FieldSelector>)and<FieldTitle>,transparencylevel<opacity>,visibilityflag<visible>,andvisibilityrange
between<minZoom>and<maxZoom>
<File>:<Format>and<Path>tolinkedfiles,ifany
Sample
Samplewithdisplaysettovalueintervals.
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<At ol l >
<Geodat aset ver si on=" 2" >
<Degr eeFor mat >0</ Degr eeFor mat >
<Popul at i on> / / or <GeoCl i mat i cPar ams> or <Vect or s>
<Name>Popul at i on</ Name> / / or <Name>Geocl i mat i c Par amet er s</ Name>
or <Name>Vect or s</ Name>
<Di spl ay>
<mi nZoom>500</ mi nZoom>
<maxZoom>20000000</ maxZoom>
<vi si bl e>Yes</ vi si bl e>
<Type>ByI nt er val s</ Type>
<Fi el dSel ect or >80000001</ Fi el dSel ect or >
<Fi el dDesc>
<Fi el dI d>80000001</ Fi el dI d>
<Fi el dTi t l e>Popul at i on ( i nhab. / km ) </ Fi el dTi t l e>
</ Fi el dDesc>
<Symbol Font >
<Name>Wi ngdi ngs</ Name>
<Si ze>- 120</ Si ze>
<Col or >0 0 0</ Col or >
<BackCol or >255 255 255</ BackCol or >
<St yl e>0</ St yl e>
</ Symbol Font >
<Label Font >
<Name>MS Shel l Dl g</ Name>
<Si ze>- 83</ Si ze>
</ Label Font >


<Mi n>900. </ Mi n>
<Max>1000. </ Max>
<Legend>900 <=Popul at i on( Densi t y) <1 000</ Legend>
<Mai nCol or >255 96 0</ Mai nCol or >
<Secondar yCol or >255 0 0</ Secondar yCol or >
150


</ Di spl ay>
<AddToLegend>0</ AddToLegend>
<Type>
<Name>Popul at i on</ Name>
<For mat s>15</ For mat s>
<Type>800</ Type>
1
</ Type>
<Fi l es/ >
</ Popul at i on> / / or </ GeoCl i mat i cPar ams> or </ Vect or s>
<Cl assi f i edCl ut t er UseOnl yDef aul t =" 0" >
<Di spl ay>
<Fi el dDesc>
<Fi el dTi t l e>Hei ght ( m) </ Fi el dTi t l e>
</ Fi el dDesc>
<Opaci t y>50</ Opaci t y>


<Mi n>54. </ Mi n>
<Max>56. </ Max>
<Legend>54 <=Hei ght ( m) <56</ Legend>
<Li neSt yl e>5</ Li neSt yl e>
<Li neWi dt h>10</ Li neWi dt h>
<Fi l l St yl e>1</ Fi l l St yl e>


</ Di spl ay>
<At t r i but es>
<f i el ds>
<f i el d l engt h=" 1" t ype=" ui nt " name=" CODE" / >
<f i el d l engt h=" 4" t ype=" i nt " name="COLOR" / >
<f i el d l engt h=" 50" t ype=" t ext " name=" NAME" / >
<f i el d l engt h=" 4" t ype=" r eal " name=" HEI GHT" / >
<f i el d l engt h=" 2147483647" t ype=" t ext " name=" I NDOOR"/ >
</ f i el ds>
<r ecor ds/ >
</ At t r i but es>
<Name>Cl ut t er Cl asses</ Name>
151
11.1.2 Zones
Theuserconfigurationfilesstorethecoordinatesoftheverticesofthefiltering,focus,computation,printing,andgeographic
exportzonepolygons,i.e.,thepointsformingthesepolygons.Thefirstandthelastpointshavethesamecoordinates.
Sample
Thefollowingsamplehasrectangularcomputationandfocuszonesofthesamesize.
<Def aul t Val ues>
</ Def aul t Val ues>
</ Cl assi f i edCl ut t er >
<Al t i t udes> / / or <Bui l di ngHei ght s>
<Name>Di gi t al Ter r ai n Model </ Name> / / or <Name>Cl ut t er Hei ght s</ Name>
<Di spl ay>
<Fi el dDesc>
<Fi el dTi t l e>Al t i t ude</ Fi el dTi t l e>
</ Fi el dDesc>


<Mi n>900. </ Mi n>
<Max>1000. </ Max>
<Legend>900 <=Al t i t ude <1 000</ Legend>


</ Di spl ay>
</ Al t i t udes> / / or </ Bui l di ngHei ght s>
</ Geodat aset >
</ At ol l >
<At ol l >
<Cal cul at i onZone>
<Poi nt >35950. 000000 - 15445. 000000</ Poi nt >
<Poi nt >33. 000000 - 15445. 000000</ Poi nt >
<Poi nt >33. 000000 - 33. 000000</ Poi nt >
<Poi nt >35950. 000000 - 33. 000000</ Poi nt >
<Poi nt >35950. 000000 - 15445. 000000</ Poi nt >
152
11.1.3 MapCentreandZoomLevel
Thefollowingparametersaresaved:
<MapPosition>:XandYcoordinatesofthecentreofthemapwindowandthezoomlevel.
Sample
11.1.4 FolderConfiguration
Thefollowingparametersaresavedforthefollowingfolders:
Sitesfolder:
<Display>:
as <FieldSelector>) <FieldTitle> and <FieldDBName>, visibility flag <Visible>, and visibility range between
<MinZoom>and<MaxZoom>
<SymbolFont> properties, such as font name <Name>, font size <Size>, font colour <Color>, background
<LabelFont>properties,suchaslabelfontname<Name>,labelfontsize<Size>,labelfontcolour<Color>,label
fontbackgroundcolour<BackColor>,andlabelfontstyle<Style>
<Items>properties,suchasforeach<Item>:<Value>,<Legend>,<MainColor>,<SecondaryColor>,<Symbol>,
and<SymbolSize>
<DataTips>:Listof<items>displayedintiptexts
<Labels>:Listof<items>displayedinlabels
<DefaultConfiguration>: The default configuration for the folder, this tag contains the default configuration
<Filter>,<Groups>,and<Sort>criteria
<Configuration>: If any configuration exists for the folder, this tag contains the configuration <Name> and the
Antennasfolder:
Transmitters,MultiHops,andPointtoMultipointfolders:
<Display>:
Displatetype<Type>,selectedfield<FieldSelector>,fielddescription<FieldDesc>containing<FieldId>(same
as <FieldSelector>) <FieldTitle> and <FieldDBName>, visibility flag <Visible>, and visibility range between
<LabelFont>properties,suchaslabelfontname<Name>,labelfontsize<Size>,labelfontcolour<Color>,label
</ Cal cul at i onZone>
<FocusZone>
<Poi nt >35950. 000000 - 15445. 000000</ Poi nt >
<Poi nt >33. 000000 - 15445. 000000</ Poi nt >
<Poi nt >33. 000000 - 33. 000000</ Poi nt >
<Poi nt >35950. 000000 - 33. 000000</ Poi nt >
<Poi nt >35950. 000000 - 15445. 000000</ Poi nt >
</ FocusZone>
<At ol l >
<At ol l >
<MapPosi t i on Cent er X=" 609433" Cent er Y="5632019" Scal e=" 250000" / >
</ At ol l >
153
<Items>properties,suchasforeach<Item>:<Value>,<Legend>,<MainColor>,<SecondaryColor>,<Symbol>,
and<SymbolSize>
<OFDM_AFP>:LTE,WiMAX,andWiFifrequencyallocationconstraintweights:
<Techno>:Nameofthetechnology
<NeighbourWeight>:Weightofthefirstorderneighbourrelation
<InterNeighbourWeight>:Weightoftherelationbetweentwoneighboursofacommoncell
<IMWeight>:Weightoftheinterferencematricesrelation
<DistanceWeight>:Weightofthedistancebasedrelation
<PCI_Alloc>:LTEphysicalcellIDallocationconstraintweights:
<SecondNeighbourWeight>:Weightofthesecondorderneighbourrelation
<IDWeight>:WeightofthephysicalcellIDconstraint
<PSSWeight>:WeightofthePSSIDconstraint
<SSSWeight>:WeightofthesameSSSIDpersiteconstraint
<ULDMRSSGWeight>:WeightoftheULDMRS(PCIMod30)collisionconstraint
<DLRSSCaWeight>:WeightofthesingleantennaportDLCRS(PCIMod6)collisionconstraint
<PCFICHREGWeight>:WeightofthePCFICHREG(PCIMod(N_RB/2))collisionconstraint
<PI_Alloc>:WiMAXpreambleindexallocationconstraintweights:
<SecondNeighbourWeight>:Weightofthesecondorderneighbourrelation
<IndexWeight>:Weightofthepreambleindexconstraint
<SegmentWeight>:Weightofthesegmentconstraint
<PermBaseWeight>:Weightofthesamecellpermbasepersiteconstraint
Linksfolder:
<Display>:Containsvisibilityflag<visible>,andvisibilityrangebetween<minZoom>and<maxZoom>
<DefaultConfiguration>:Thedefaultconfigurationforthefolder
<LabelFont>properties,suchas:labelfontname<Name>,labelfontsize<Size>,labelfontcolour<Color>,label
<SiteDisplay>properties,suchas:
<LabelFont>properties,suchas:labelfontname<Name>,labelfontsize<Size>, label fontcolour<Color>,
<Symbol>:Symbolusedformicrowavelinks
<ShowText>:Captionformicrowavelinksshownornot
<RepeaterDisplay>properties,suchas:
CWMeasurementsfolder:
<Distance>:Theminimum<Min>andmaximum<Max>distanceformeasurementfiltering
<DistanceUnit>:Thedistanceunit
<Measure>:Theminimum<Min>andmaximum<Max>measuredlevelforfiltering
<MeasureUnit>:Themeasurementunit
<Angle>:Theminimum<Min>andmaximum<Max>angleformeasurementfiltering
<Relative>:Whethertheangleisrelativetoeachtransmittersazimuthoranabsolutevalue
<Clutter>:Foreach<Class>,its<Code>andwhetheritisinthe<Filter>ornot
<Advanced>:Anyadvancedfilterusedforfiltering
<PathLosses>:Pathlosstuingparameters,i.e.,<ParallelAxisRadius>,<PerpendicularAxisRadius>,<GlobalMargin>,
<LocalMargin>,and<Threshold>
<Display>:
154
Displate type <Type>, selected field <FieldSelector>, visibility flag <Visible>, and visibility range between
<LabelFont>properties,such as:labelfontname <Name>,labelfontsize <Size>,labelfontcolour <Color>,
<Items> properties, such as for each <Item>: <Legend>, <MainColor>, <SecondaryColor>, <Symbol>, and
<SymbolSize>
DriveTestDatafolder:
<Techno>:Nameofthetechnology(ifexportedfroma3GPPMultiRATdocument.
<Clutter>:Foreach<Class>,its<Code>andwhetheritisinthe<Filter>ornot
<Advanced>:Anyadvancedfilterusedforfiltering
<PathLosses>:Pathlosstuingparameters,i.e.,<ParallelAxisRadius>,<PerpendicularAxisRadius>,<GlobalMargin>,
<LocalMargin>,and<Threshold>
<Display>:
Displate type <Type>, selected field <FieldSelector>, visibility flag <Visible>, and visibility range between
<LabelFont>properties,such as:labelfontname <Name>,labelfontsize <Size>,labelfontcolour <Color>,
<Items> properties, such as for each <Item>: <Legend>, <MainColor>, <SecondaryColor>, <Symbol>, and
<SymbolSize>
PropagationModelsandSmartAntennaModelsfolders:
Sample
<At ol l >
<Fol der sConf i gur at i ons>
<Si t es>
<Name>Si t es</ Name>
<Di spl ay>
<Type>ByVal ues</ Type>
<Fi el dDesc>
<Fi el dTi t l e>Vendor </ Fi el dTi t l e>
</ Fi el dDesc>
<Symbol Font >
<Si ze>- 120</ Si ze>
155
</ Symbol Font >
<Label Font >
</ Label Font >


<Val ue>Vendor </ Val ue>
<Legend>Vendor </ Legend>
<Symbol >164</ Symbol >
<Symbol Si ze>120</ Symbol Si ze>


<Dat aTi ps>
0
</ Dat aTi ps>
<Label s>
0
</ Label s>
</ Di spl ay>
<Def aul t Conf i gur at i on>
<Gr oups>Type</ Gr oups>
</ Def aul t Conf i gur at i on>
</ Si t es>
<Ant ennas>
<Name>Ant ennas</ Name>
<Fi l t er >( [ CONSTRUCTOR] = Kat hr ei n) </ Fi l t er >
<Conf i gur at i on>
<Name>Conf </ Name>
<Fi l t er >( [ CONSTRUCTOR] = Kat hr ei n) </ Fi l t er >
</ Conf i gur at i on>
</ Ant ennas>
<Tr ansmi t t er s> / / or <MWMul t i Hops> / / or <MWHubs>
<Name>Tr ansmi t t er s</ Name> / / or <Name>Mul t i - Hops</ Name> / /
or <Name>Poi nt t o Mul t i poi nt </ Name>
<Di spl ay>
<Type>ByVal ues</ Type>
156
<Fi el dDesc>
<Fi el dTi t l e>Aut omat i c</ Fi el dTi t l e>
</ Fi el dDesc>


<Dat aTi ps>
0
</ Dat aTi ps>
</ Di spl ay>
<Def aul t Conf i gur at i on/ >
</ Tr ansmi t t er s> / / or </ MWMul t i Hops> / / or </ MWHubs>
<MWLi nks>
<Name>Li nks</ Name>
<Di spl ay>
</ Di spl ay>
<Label Font >
</ Label Font >
<Si t eDi spl ay>
<Symbol Font >
<Si ze>80</ Si ze>
</ Symbol Font >
<Label Font >
</ Label Font >
</ Si t eDi spl ay>
<ShowText >0</ ShowText >
<Repeat er Di spl ay>
<Symbol Font >
157
<Si ze>80</ Si ze>
</ Symbol Font >
</ Repeat er Di spl ay>
</ MWLi nks>
<CWMeasur ement s>
<Di st ance>
<Mi n>0. </ Mi n>
<Max>1000. </ Max>
</ Di st ance>
<Di st anceUni t >0</ Di st anceUni t >
<Measur e>
<Mi n>- 105. </ Mi n>
<Max>- 90. </ Max>
</ Measur e>
<Measur eUni t >0</ Measur eUni t >
<Angl e>
<Mi n>- 180. </ Mi n>
<Max>180. </ Max>
</ Angl e>
<Rel at i ve>Yes</ Rel at i ve>
<Cl ut t er >
<Cl ass>
<Code>1</ Code>
<Fi l t er >Yes</ Fi l t er >
</ Cl ass>
</ Cl ut t er >
<Advanced>( [ DI ST] &gt ; 500) </ Advanced>
<Pat hLosses>
<Par al l el Axi sRadi us>200. </ Par al l el Axi sRadi us>
<Per pendi cul ar Axi sRadi us>100. </ Per pendi cul ar Axi sRadi us>
<Gl obal Mar gi n>30. </ Gl obal Mar gi n>
<Local Mar gi n>30. </ Local Mar gi n>
<Thr eshol d>- 130. </ Thr eshol d>
</ Pat hLosses>
<Di spl ay>
<Fi el dSel ect or >Er r or ( P- M) ( dB) </ Fi el dSel ect or >
<Symbol Font >
<Si ze>- 120</ Si ze>
158
</ Symbol Font >
<Label Font >
</ Label Font >


<Mi n>- 20. </ Mi n>
<Legend>Er r or ( P- M) ( dB) &gt ; =- 20</ Legend>


<Dat aTi ps>
M ( dBm) 
</ Dat aTi ps>
<Label s>
M ( dBm) 
</ Label s>
</ Di spl ay>
</ CWMeasur ement s>
<Test Mobi l eDat a>
<Techno>GSM</ Techno>
<Cl ut t er >
<Cl ass>
<Code>1</ Code>
<Fi l t er >Yes</ Fi l t er >
</ Cl ass>
</ Cl ut t er >
<Advanced></ Advanced>
<Pat hLosses>
<Par al l el Axi sRadi us>200. </ Par al l el Axi sRadi us>
<Per pendi cul ar Axi sRadi us>100. </ Per pendi cul ar Axi sRadi us>
<Gl obal Mar gi n>30. </ Gl obal Mar gi n>
<Local Mar gi n>30. </ Local Mar gi n>
<Thr eshol d>- 130. </ Thr eshol d>
</ Pat hLosses>
<Di spl ay>
<Fi el dSel ect or >Ec_I 0</ Fi el dSel ect or >
<Symbol Font >
159
11.1.5 CoveragePredictions
ThelistofcoveragepredictionsavailableinthePredictionsfolderandthefollowingparametersaresaved:
Generaltab:
<Techno>:Nameofthetechnology
<Resolution>:Predictionresolution
<Configuration>:<Filter>,<Groups>,and<Sort>criteriafortheprediction
<LockedStudy>:Lockedornot
Conditionstab:Dependontechnologiesandpredictiontypes.
<Reliability>:Celledgecoverageprobability
<Indoor>:Indoorcoveragecheckedornot
<WithShadowing>:Shadowingmargintakenintoaccountornot
...
Displaytab:
Displaytype<type>,selectedfield<FieldSelector>,fielddescription<FieldDesc>containing<FieldId>(same
as<FieldSelector>)and <FieldTitle>,visibilityflag<visible>,opacity <Opacity>,and visibilityrange between
<minZoom>and<maxZoom>
<Si ze>- 120</ Si ze>
</ Symbol Font >
<Label Font >
</ Label Font >


<Mi n>- 60. </ Mi n>
<Legend>Ec_I 0 &gt ; =- 60</ Legend>


</ Di spl ay>
</ Test Mobi l eDat a>
<Pr opagat i onModel s> / / or <Smar t Ant ennasModel s>
<Name>Pr opagat i on Model s</ Name> / / or <Name>Smar t Ant enna Model s</ Name>
</ Pr opagat i onModel s> / / or </ Smar t Ant ennasModel s>
</ Fol der sConf i gur at i ons>
</ At ol l >
160
Sample
GSMcoveragebysignallevel
<At ol l >
<St udi es>
<Cover ageTRXSt udy>
<Techno>GSM</ Techno>
<Name>GSM: Cover age by Si gnal Level 0</ Name>
<Di spl ay>


<Mi n>- 75. </ Mi n>
<Legend>Best Si gnal Level ( dBm) &gt ; =- 75</ Legend>


<Mi n>- 85. </ Mi n>


<Mi n>- 95. </ Mi n>


<Mi n>- 105. </ Mi n>
161
11.1.6 AutomaticNeighbourAllocationParameters
The following parameters are saved for intratechnology (intracarrier and intercarrier) and intertechnology automatic
neighbourallocations:
<ANP_options>:Intratechnology(intracarrier)neighbourallocationparameters
<ANP_IL_options>: Intratechnology intercarrier neighbour allocation parameters (UMTS HSPA and CDMA2000
documents)
<ANP_IT_options>:Intertechnologyneighbourallocationparameters
A<Techno></Techno>tagisalsopresentiftheuserconfigurationisexportedfroma3GPPMultiRATdocument.This
tagcontainsthenameofthetechnologytowhichtheparametersbelong.
Thefollowingparametersaresaved:
Parameterscommontoalltechnologies:
<numMax>:Maximumnumberofneighbourstoallocate
<useCoSite>:Forcecositetransmitters/cellsasneighboursornot
<useAdjacent>:Forceadjacenttransmitters/cellsasneighboursornot
<symetric>:Forcesymmetrybetweenneighboursornot
<keepNeighbs>:Resetexistingneighboursorkeepthem
<MaxDist>:Maximumdistancebetweensites
<PercentCoverage>:Coverageconditions:Minimumpercentageofcoveredarea
<UseShadowing>:Coverageconditions:Takeshadowingintoaccountornot
<reliability>:Coverageconditions:Celledgecoverageprobability
<applyConstraints>:Forceexceptionalpairsasneighboursornot
<covBased>:Notimplementedyet


<Dat aTi ps>
c0000000
c0000001
</ Dat aTi ps>
</ Di spl ay>
<Resol ut i on>50</ Resol ut i on>
<LockedSt udy>0</ LockedSt udy>
<Comput eHi st o>1</ Comput eHi st o>
<Hi st oPer Tx>0</ Hi st oPer Tx>
<Hi st oLabel ></ Hi st oLabel >
<Condi t i ons>
<Fi el dDbm>
<Mi n>- 105. </ Mi n>
</ Fi el dDbm>
<Rel i abi l i t y>0. 75</ Rel i abi l i t y>
<TRXType>BCCH</ TRXType>
<Def Tr gThr eshol d>1</ Def Tr gThr eshol d>
0
<Wi t hShadowi ng>0</ Wi t hShadowi ng>
</ Condi t i ons>
</ Cover ageTRXSt udy>
</ St udi es>
</ At ol l >
162
<minCov>:Neighbourimportance:minimumfactorforcoverage
<maxCov>:Neighbourimportance:maximumfactorforcoverage
<minAdj>:Neighbourimportance:minimumfactorforadjacency
<maxAdj>:Neighbourimportance:maximumfactorforadjacency
<minCos>:Neighbourimportance:minimumfactorforcosite
<maxCos>:Neighbourimportance:maximumfactorforcosite
<minDistImportance>:Neighbourimportance:minimumfactorfordistance
<maxDistImportance>:Neighbourimportance:maximumfactorfordistance
<resolution>:Resolutionusedforcoveragecalculationforoverlapping(1meansthedefaultresolutiondefinedin
thepropertiesofthePredictionsfolderisused)
<UseIndoor>:Coverageconditions:Useindoorlossesdefinedperclutterclassornot
<UseGlobalThreshold>:CoverageconditionsforWiMAXandLTE:WhethertouseaglobalminimumpreambleC/
NorRSRP,orpercellvalues
ParametersspecifictoGSMGPRSEDGE:
<minField>:Coverageconditions:MinimumBCCHsignallevel
<margin>:Coverageconditions:Marginfortheminimumsignallevel(Handoverstart)
<traffic>:Coverageconditions:Taketrafficintoaccountornot
<deltaMax>:Coverageconditions:Handoverend
ParametersspecifictoUMTSHSPA,TDSCDMA,andCDMA20001xRTT1xEVDO:
<minField>:Coverageconditions:Minimumpilotsignallevel
<margin>:Coverageconditions:Marginfortheminimumsignallevel(E
c
/I
0
margin)
<traffic>:Coverageconditions:Taketrafficintoaccountornot
<deltaMax>:Coverageconditions:Handoverend
<EcIoMin>:Coverageconditions:MinimumE
c
/I
0
<usePmax>:Coverageconditions:Usemaximumpowerornot
<PerCentMaxPower>:Coverageconditions:Percentageofmaximumpowertoconsiderincalculations
<EcIoMax>:Coverageconditions:MaximumE
c
/I
0
<useEcIoMax>:Coverageconditions:UsemaximumE
c
/I
0
ornot
<TDrop>:TDropvalue(TDSCDMAdocuments,intratechnologyneighbourallocationonly)
ParametersspecifictoWiMAX802.16eandLTE:
<HOStart>:Thehandoverstartmargin(intratechnologyneighbourallocationonly)
<HOEnd>:Thehandoverendmargin(intratechnologyneighbourallocationonly)
<BSmargin>:RSRPmarginfromthebestserver(intertechnologyneighbourallocationonly)
Sample
UMTSHSPAintertechnology,intracarrierneighbourallocationparameters:
<At ol l >
<ANP_opt i ons>
<Techno>UMTS</ Techno>
<numMax>16</ numMax>
<r esol ut i on>- 1</ r esol ut i on>
<mi nFi el d>- 10500</ mi nFi el d>
<mar gi n>500</ mar gi n>
<useCoSi t e>1</ useCoSi t e>
<useAdj acent >1</ useAdj acent >
<t r af f i c>0</ t r af f i c>
<symet r i c>0</ symet r i c>
<keepNei ghbs>0</ keepNei ghbs>
<MaxDi st >10000</ MaxDi st >
<Per cent Cover age>1000</ Per cent Cover age>
<UseShadowi ng>0</ UseShadowi ng>
<r el i abi l i t y>7500</ r el i abi l i t y>
<UseI ndoor >0</ UseI ndoor >
<del t aMax>1200</ del t aMax>
<appl yConst r ai nt s>0</ appl yConst r ai nt s>
163
11.1.7 AutomaticFrequencyPlanningParameters
Thefollowingparametersaresavedforautomaticfrequencyplanning(GSMGPRSEDGEdocuments):
<defSeparations__CONF_CO_SITE_BB>:DefaultcositeseparationrulefortwoBCCHtypeTRXs.
<defSeparations__CONF_CO_CELL_BB>:DefaultcotransmitterseparationrulefortwoBCCHtypeTRXs.
<defSeparations__CONF_NEIGH_BOUR_BB>:DefaultneighbourseparationrulefortwoBCCHtypeTRXs.
<defSeparations__CONF_CO_SITE_BT>:DefaultcositeseparationruleforaBCCHandaTCHtypeTRX.
<defSeparations__CONF_CO_CELL_BT>:DefaultcotransmitterseparationruleforaBCCHandaTCHtypeTRX.
<defSeparations__CONF_NEIGH_BOUR_BT>:DefaultneighbourseparationruleaforBCCHandaTCHtypeTRX.
<defSeparations__CONF_CO_SITE_TT>:DefaultcositeseparationrulefortwoTCHtypeTRXs.
<defSeparations__CONF_CO_CELL_TT>:DefaultcotransmitterseparationrulefortwoTCHtypeTRXs.
<defSeparations__CONF_NEIGH_BOUR_TT>:DefaultneighbourseparationrulefortwoTCHtypeTRXs.
<freezeState>:LastminuteresourcefreezingoptionsavailableintheAFPlaunchwizard
<numMinutes>:TargettimeallotedtotheAFP
<useDTX>:Considertheeffectofdiscontinuoustransmissionornot
<dtxVocalFactor>:Voiceactivityfactorfordiscontinuoustransmission
<AfpBasedOnInterference>:Loadallpotentialinterferersornot
<AfpBasedOnSeparations>:Loadallthesubcellspotentiallyinvolvedinseparationconstraintsornot
<IM_calculate__WithTraffic>:Whethertrafficspreadingisuniformorbasedonthemapsusedinthedefaulttraffic
capture(forinterferencematricescalculation)
<IM_calculate__BestServerZoneMargin>:MarginincaseofBestsignallevelperHCSlayer(forinterferencematrices
calculation)
<IM_calculate__ServiceZoneType>:AllorBestsignallevelperHCSlayer(forinterferencematricescalculation)
<IM_calculate__reliability_X_10000>:Celledgecoverageprobability(forinterferencematricescalculation)
<TakeTfFromCapt>:WhethertrafficloadsarereadfromthedefaulttrafficcaptureorfromtheSubcellstable
<preferedSenario>:Scenariotype,i.e.,modificationofexistingTRXsallowedornot
Sample
<covBased>1</ covBased>
<mi nDi st I mpor t ance>100</ mi nDi st I mpor t ance>
<maxDi st I mpor t ance>1000</ maxDi st I mpor t ance>
<mi nCov>1000</ mi nCov>
<maxCov>3000</ maxCov>
<mi nAdj >3000</ mi nAdj >
<maxAdj >6000</ maxAdj >
<mi nCos>6000</ mi nCos>
<maxCos>10000</ maxCos>
<UseGl obal Thr eshol d>0</ UseGl obal Thr eshol d>
<EcI oMi n>- 1400</ EcI oMi n>
<usePmax>0</ usePmax>
<Per Cent MaxPower >5000</ Per Cent MaxPower >
<EcI oMax>- 700</ EcI oMax>
<useEcI oMax>0</ useEcI oMax>
</ ANP_opt i ons>
</ At ol l >
<At ol l >
<AFP_opt i ons>
<def Separ at i ons__CONF_CO_SI TE_BB>2</ def Separ at i ons__CONF_CO_SI TE_BB>
<def Separ at i ons__CONF_CO_CELL_BB>3</ def Separ at i ons__CONF_CO_CELL_BB>
<def Separ at i ons__CONF_NEI GH_BOUR_BB>2</ def Separ at i ons__CONF_NEI GH_BOUR_BB>
<def Separ at i ons__CONF_CO_SI TE_BT>2</ def Separ at i ons__CONF_CO_SI TE_BT>
<def Separ at i ons__CONF_CO_CELL_BT>3</ def Separ at i ons__CONF_CO_CELL_BT>
<def Separ at i ons__CONF_NEI GH_BOUR_BT>1</ def Separ at i ons__CONF_NEI GH_BOUR_BT>
164
11.1.8 AutomaticScramblingCodeAllocationParameters
Thefollowingparametersaresavedforautomaticscramblingcodeallocation(UMTSHSPAandTDSCDMAdocuments):
<MinEcI0>:MinimumE
c
/I
0
constraint(notusedinTDSCDMA)
<margin>:E
c
/I
0
margin(notusedinTDSCDMA)
<reliability>:Celledgecoverageprobability(notusedinTDSCDMA)
<DistanceMin>:Defaultreusedistance
<Strategy0>:Clusteredstrategyavailableornot
<Strategy1>:DistributedperCellstrategyavailableornot
<Strategy2>:OneCluster/SYNC_DLCodeperSitestrategyavailableornot
<Strategy3>:DistributedperSitestrategyavailableornot
<Strategy>:Scramblingcodeallocationstrategy
<FromScratch>:Resetallalreadyallocatedcodesornot
<UseCurrentNghbs>:Useexistingfirstorderneighboursornot
<NghbOrder>:Theorderofneigbourstotakeintoaccount,i.e.,1st,2nd,or3rd
<ComputeNghbs>:CalculateneighboursusingtheadditionE
c
/I
0
conditionsornot
<UseMaxCodes>:Useamaximumofcodesornot
<UseShadowing>:Shadowingtakenintoaccountornot(notusedinTDSCDMA)
<SameCodeForCarriers>:Allocatecarriersidenticallyornot
<NbClusterPerSite>:Numberoftransmitterspersiteamongwhichaclustershouldbedistributed
<ClustNghbs>:Additionalconstraintoftakingintoaccountthefirstorderneighboursinotherclusters
<Clust2ndNghbs>:Additionalconstraintoftakingintoaccountthesecondorderneighboursinotherclusters
<NbCodesPerCluster>:Thenumberofscramblingcodesinonecluster/SYNC_DL
<UseDistance>:Taketheminimumreusedistanceintoaccountornot
<UseExcepPairs>:Takeexceptionalpairsintoaccountornot
<minField>:Minimumpilotsignallevelconstraint(notusedinTDSCDMA)
<usePmax>:Usethemaximumdownlinktransmissionpowerornot(notusedinTDSCDMA)
<PerCentMaxPower>: The percentage of the maximum downlink power is <usePmax> is set to 0 (not used in TD
SCDMA)
<Max1stNghbCost>:Themaximumcostof1storderneighbours
<Max2ndNghbCost>:Themaximumcostof2ndorderneighbours
<Max3rdNghbCost>:Themaximumcostof3rdorderneighbours
<CoplanCost>:Thecostforintertechnologyneighbours
<MaxCoClusterCost>:Themaximumcostforsamecluster/SYNC_DLneighbours
<MaxDistCost>:Themaximumcostforaminimumreusedistanceconstraintviolation
<ExcepPairCost>:Thecostforexceptionalpairconstraintviolation
<UseCloseNghbs>:TaketheCloseNeighboursconstraintintoaccountornot(TDSCDMAonly)
<CloseDistance>:Maximumdistancewithinwhichcloseneighboursarelocated(TDSCDMAonly)
<CloseImportance>:Minimumimportancevalueofcloseneighbour(TDSCDMAonly)
<MaxCloseCost>:Maximumcostofacloseneighbourrelation(TDSCDMAonly)
<def Separ at i ons__CONF_CO_SI TE_TT>1</ def Separ at i ons__CONF_CO_SI TE_TT>
<def Separ at i ons__CONF_CO_CELL_TT>2</ def Separ at i ons__CONF_CO_CELL_TT>
<def Separ at i ons__CONF_NEI GH_BOUR_TT>1</ def Separ at i ons__CONF_NEI GH_BOUR_TT>
<f r eezeSt at e>0</ f r eezeSt at e>
<numMi nut es>1000</ numMi nut es>
<useDTX>0</ useDTX>
<dt xVocal Fact or >70</ dt xVocal Fact or >
<Af pBasedOnI nt er f er ence>1</ Af pBasedOnI nt er f er ence>
<Af pBasedOnSepar at i ons>1</ Af pBasedOnSepar at i ons>
0
5
1
7500
<TakeTf Fr omCapt >1</ TakeTf Fr omCapt >
<pr ef er edSenar i o></ pr ef er edSenar i o>
</ AFP_opt i ons>
</ At ol l >
165
Sample
11.1.9 AutomaticPNOffsetAllocationParameters
ThefollowingparametersaresavedforautomaticPNoffsetallocation(CDMA2000documents):
<MinEcI0>:MinimumE
c
/I
0
constraint
<TDrop>:ValuefortheTDrop
<At ol l >
<SCP_opt i ons>
<Mi nEcI 0>- 1500. </ Mi nEcI 0>
<mar gi n>500. </ mar gi n>
<r el i abi l i t y>5000. </ r el i abi l i t y>
<Di st anceMi n>200000. </ Di st anceMi n>
<St r at egy0>1</ St r at egy0>
<St r at egy>0</ St r at egy>
<Fr omScr at ch>1</ Fr omScr at ch>
<UseCur r ent Nghbs>1</ UseCur r ent Nghbs>
<NghbOr der >1</ NghbOr der >
<Comput eNghbs>0</ Comput eNghbs>
<UseMaxCodes>1</ UseMaxCodes>
<SameCodeFor Car r i er s>0</ SameCodeFor Car r i er s>
<NbCl ust er Per Si t e>3</ NbCl ust er Per Si t e>
<Cl ust Nghbs>0</ Cl ust Nghbs>
<Cl ust 2ndNghbs>0</ Cl ust 2ndNghbs>
<NbCodesPer Cl ust er >8</ NbCodesPer Cl ust er >
<UseDi st ance>1</ UseDi st ance>
<UseExcepPai r s>1</ UseExcepPai r s>
<Max1st NghbCost >100</ Max1st NghbCost >
<Max2ndNghbCost >50</ Max2ndNghbCost >
<Max3r dNghbCost >5</ Max3r dNghbCost >
<Copl anCost >100</ Copl anCost >
<MaxCoCl ust er Cost >50</ MaxCoCl ust er Cost >
<MaxDi st Cost >100</ MaxDi st Cost >
<ExcepPai r Cost >100</ ExcepPai r Cost >
<UseCl oseNghbs>1</ UseCl oseNghbs>
<Cl oseDi st ance>80000. </ Cl oseDi st ance>
<Cl oseI mpor t ance>3000. </ Cl oseI mpor t ance>
<MaxCl oseCost >100</ MaxCl oseCost >
</ SCP_opt i ons>
</ At ol l >
166
<reliability>:Celledgecoverageprobability
<DistanceMin>:Defaultreusedistance
<Strategy0>:PNOffsetperCellstrategyavailableornot
<Strategy1>:AdjacentPNClusterperSitestrategyavailableornot
<Strategy2>:DistributedPNClusterperSitestrategyavailableornot
<Strategy>:PNoffsetallocationstrategy
<FromScratch>:Resetallalreadyallocatedcodesornot
<UseCurrentNghbs>:Useexistingneighboursornot
<NghbOrder>:Theorderofneigbourstotakeintoaccount,i.e.,1st,2nd,or3rd
<ComputeNghbs>:CalculateneighboursusingtheadditionE
c
/I
0
conditionsornot
<UseShadowing>:Shadowingtakenintoaccountornot
<SameCodeForCarriers>:AllocatesamePNoffsettocellsofthesametransmitterornot
<PilotIncr>:ValueforthePILOT_INC
<PNClusterSize>:NumberofPNoffsetspercluster
<UseDistance>:Taketheminimumreusedistanceintoaccountornot
<UseExcepPairs>:Takeexceptionalpairsintoaccountornot
<UseMaxCodes>:Useamaximumofcodesornot
<minField>:Minimumpilotsignallevelconstraint
<usePmax>:Usethemaximumdownlinktransmissionpowerornot
<PerCentMaxPower>:Thepercentageofthemaximumdownlinkpoweris<usePmax>issetto0
<Max1stNghbCost>:Themaximumcostof1storderneighbours
<Max2ndNghbCost>:Themaximumcostof2ndorderneighbours
<Max3rdNghbCost>:Themaximumcostof3rdorderneighbours
<CoplanCost>:Thecostforintertechnologyneighbours
<MaxDistCost>:Themaximumcostforaminimumreusedistanceconstraintviolation
<ExcepPairCost>:Thecostforexceptionalpairconstraintviolation
Sample
<At ol l >
<PNO_opt i ons>
<Di st anceMi n>200000. </ Di st anceMi n>
<St r at egy>2</ St r at egy>
<Fr omScr at ch>1</ Fr omScr at ch>
<UseCur r ent Nghbs>1</ UseCur r ent Nghbs>
<NghbOr der >1</ NghbOr der >
<Comput eNghbs>1</ Comput eNghbs>
<SameCodeFor Car r i er s>0</ SameCodeFor Car r i er s>
<Pi l ot I ncr >4</ Pi l ot I ncr >
<PNCl ust er Si ze>3</ PNCl ust er Si ze>
<UseExcepPai r s>1</ UseExcepPai r s>
<UseMaxCodes>1</ UseMaxCodes>
<Mi nEcI 0>- 1600. </ Mi nEcI 0>
<TDr op>- 1800. </ TDr op>
<r el i abi l i t y>6000. </ r el i abi l i t y>
<Max1st NghbCost >100</ Max1st NghbCost >
<Max2ndNghbCost >50</ Max2ndNghbCost >
167
11.1.10 AutomaticOFDMResourceAllocationParameters
ThefollowingparametersaresavedforautomaticallocationofresourcesinOFDMnetworks:
<UseNeighbs>:Neighbourstakenintoaccountornot
<UseDistance>:Distancetakenintoaccountornot
<UseIM>:Interferencematricestakenintoaccountornot
<BasedOnFrqPlan>:Frequencyplantakenintoaccountornot
<SameSegPerTx>:Allocatethesamesegmenttocotransmittercellsornot
<MinDistance>:Minimumglobalreusedistance
<SiteStrategy>:PersiteorfreeallocationforSSSID(LTE)andcellpermbase(WiMAX)
<UniformIDDistribution>:UniformphysicalcellIDorpreambleindexdistributionactiveornot
<RangeType>:PhysicalcellID,preambleindex,orzonepermbaseallocationdomain(restricted=0,entire=1,custom
=2,orpercell=3)
<ExcludedPis>:ListofexcludedphysicalcellIDs,preambleindexes,orzonepermbasesforcustomallocationdomain
type
AutomaticallyallocatedresourcesinOFDMnetworksinclude:
LTE:FrequencyandphysicalcellIDallocationparameters
WiMAX:Frequency,preambleindex,andzonepermbaseallocationparameters
WiFi:Frequencyallocationparameters
Sample
11.1.11 MicrowaveRadioLinksParameters
Thefollowingparametersaresavedformicrowaveradiolinks:
<Name>:NameoftheMicrowaveRadioLinksfolder
<Display>:Displayparametersforthemicrowavelinks,suchas<minZoom>,<maxZoom>,and<visible>
<AddToLegend>:Addmicrowavelinkstolegendwindowornot
<QualityModel>:Qualitymodelusedforcalculations
<QualityObjective0>,<QualityObjective1>,<QualityObjective2>,<QualityObjective3>:Qualityobjectives
<Max3r dNghbCost >5</ Max3r dNghbCost >
<Copl anCost >100</ Copl anCost >
<MaxDi st Cost >100</ MaxDi st Cost >
<ExcepPai r Cost >100</ ExcepPai r Cost >
</ PNO_opt i ons>
</ At ol l >
<At ol l >
<OFDM_AFP_opt i ons>
<UseNei ghbs>1</ UseNei ghbs>
<UseI M>1</ UseI M>
<BasedOnFr qPl an>1</ BasedOnFr qPl an>
<SameSegPer Tx>0</ SameSegPer Tx>
<Mi nDi st ance>100. </ Mi nDi st ance>
<Si t eSt r at egy>1</ Si t eSt r at egy>
<Uni f or mI DDi st r i but i on>1</ Uni f or mI DDi st r i but i on>
<RangeType>2</ RangeType>
<Excl udedPi s></ Excl udedPi s>
</ OFDM_AFP_opt i ons>
</ At ol l >
168
<AvailabilityObjective0>, <AvailabilityObjective1>, <AvailabilityObjective2>, <AvailabilityObjective3>: Availability
objectives
<RainModel>:Rainmodelused
<RBER>:ResidualBER
<ALFA1>:Valueofalpha1
<ALFA2>:Valueofalpha2
<RefDelayM>:Referencedelayforminimumphase
<refDelayNM>:Referencedelayfornonminimumphase
<EquipPercent>:Availabilityobjectivesratioforequipment
<RainPercent>:Availabilityobjectivesratioforrain
<kMoy>:Averagevalueofk
<kMin>:Minimumvalueofk
<UseAtpc>:Useautomaticpowercontrolornot
<P0Method>:Multipathoccurencemethod
<IgnoreXPD>:Ignorecrosspolardiscrimination
<IgnorePR>:Ignorepassiverepeaters
<WhichBER>:BERtocalculate
<BER1>:ValueofBER1
<BER2>:ValueofBER2
<Rec838>:Rainmodelrecommendationsversion
<UseK1Global>:Usetheglobalvaluefork1
<UseK2Global>:Usetheglobalvaluefork2
<CALC_LINK_PORTS>:Calculateforgivenlinkports
<MultilineShared>:Sharedmultichannelfrequencydiversity
<NoAcm>:Signalenhancements
<InterferenceDistanceMax>:Maximumdistanceforinterferencefiltering
<InterferenceDropMin>:Localminthresholddegradation
<InterferenceDropMinGlobal>:Globalminthresholddegradation
<InterferenceCalcGo>:InterferencecalculationinthedirectionfromsiteAtositeB
<InterferenceCalcReturn>:InterferencecalculationinthedirectionfromsiteBtositeA
<InterferenceCalcUplink>:Interferencecalculationintheuplink
<InterferenceCalcDownlink>:Interferencecalculationinthedownlink
<InterferenceRainSurfCorrelation>:Interferencecorrelationsurfacearea
<InterferenceAutoWeight>:Automaticinterferenceweighting
<InterferenceUseAtpc>:Powercontrolforinterferencecalculation
<InterferenceWidth>:Interferedwantedbandwidth
<InterferenceOverShoot>:Interferenceovershootcalculation
<CochannelOnly>:Interferedbandwidthcochannelonly
<IgnoreIntraLinkInterference>:Ignoreinterferencebetweenchannelsofthesamelink
<Resolution>:Interferingprofilecalculationstep
<INTERF_DETAIL>:Calculationdetails(none,uplink,downlink,both)
<ClutterCategory0>through<ClutterCategory36>:Bitsetsforcluttercategoryproperties
<ClutterDryCategory0>through<ClutterDryCategory36>:Soiltype
Sample
<At ol l >
<Mi cr owave>
<Name>Mi cr owave Radi o Li nks</ Name>
<Di spl ay>
</ Di spl ay>
<Qual i t yModel >6</ Qual i t yModel >
<Qual i t yObj ect i ve0>3</ Qual i t yObj ect i ve0>
169
<Avai l abi l i t yObj ect i ve0>3</ Avai l abi l i t yObj ect i ve0>
<Rai nModel >5</ Rai nModel >
<RBER>1. e- 012</ RBER>
<ALFA1>10</ ALFA1>
<ALFA2>1</ ALFA2>
<Ref Del ayM>6. 30000019</ Ref Del ayM>
<r ef Del ayNM>6. 30000019</ r ef Del ayNM>
<Equi pPer cent >33. </ Equi pPer cent >
<Rai nPer cent >33. </ Rai nPer cent >
<kMoy>1. 33</ kMoy>
<kMi n>0. 88</ kMi n>
<UseAt pc>0</ UseAt pc>
<P0Met hod>1</ P0Met hod>
1
0
<Whi chBER>5</ Whi chBER>
<BER1>1. e- 003</ BER1>
<BER2>1. e- 006</ BER2>
<Rec838>1</ Rec838>
<UseK1Gl obal >1</ UseK1Gl obal >
<UseK2Gl obal >1</ UseK2Gl obal >
<CALC_LI NK_PORTS>sel ect ed</ CALC_LI NK_PORTS>
<Mul t i l i neShar ed>0</ Mul t i l i neShar ed>
<NoAcm>1</ NoAcm>
50000. 
1. 
3. 
1
1
0
0
100. 
0
0
250
0
<Cochannel Onl y>0</ Cochannel Onl y>
1
<Resol ut i on>50</ Resol ut i on>
bot h
<Cl ut t er Cat egor y0>0</ Cl ut t er Cat egor y0>
<Cl ut t er Dr yCat egor y0>B</ Cl ut t er Dr yCat egor y0>
170
<Cl ut t er Dr yCat egor y15>E</ Cl ut t er Dr yCat egor y15>
<Cl ut t er Dr yCat egor y26>A</ Cl ut t er Dr yCat egor y26>
171
11.1.12 Macros
Thefollowingparametersaresavedformacros:
<Path>:Fullpathtothemacrofile
<Language>:Languageinwhichthemacroiswritten
<Timeout>:Thetargettimeallocatedtomacroexecution
Sample
11.2 ContentsofAdditionalConfigurationFiles
Completedescriptionsofthedifferentadditionalconfigurationfilesareprovidedbelow.
11.2.1 PrintSetupConfiguration
Thefollowingparametersaresavedforprintsetup:
Pagetab<Page>:
Papersizeandorientation<Papersize=""orientation=""/>,margins<Marginsright=""left=""bottom=""top="">,
scalingwiththefittopageoption<ScalefitToPage="">
Componentstab:
</ Mi cr owave>
</ At ol l >
<At ol l >
<Macr os>
<Fi l e>
<Pat h>C: \ Test sAddi n\ t est Event s. vbs</ Pat h>
<Language>VBScr i pt </ Language>
<Ti meout >3600</ Ti meout >
</ Fi l e>
</ Macr os>
</ At ol l >
172
Rulersandareainsidefocuszoneonly<Map>:<MapinsideFZonly=""rulers=""/>
Legend<Legend>:Legendflag,outerandinnerposition,andinsidemapflag<LegendPosenable=""majorPos=""
minorPos=""insideMap=""/>
Comments <Comments>: Comments flag, vertical and horizontal position, and the inside map flag <Position
vPos="" enable="" hPos="" insideMap=""/>, comment text <text>, and font details 
Header/Footertab:
Header logo <Logo>: Logo flag, vertical and horizontal position, and the inside map flag <Position vPos=""
enable="" hPos="" insideMap=""/>, logo image <bitmap>, and logo width and height in pixels <Dimensions
width=""height=""/>
Header title <Title>: Header flag, vertical and horizontal position, and the inside map flag <Position vPos=""
enable=""hPos=""insideMap=""/>,titletext<text>,andfontdetails<fontheight=""weight=""charset=""face=""
italic=""/>
Footerlogo<LogoBottom>:Logoflag,verticalandhorizontalposition,andtheinsidemapflag<PositionvPos=""
enable="" hPos="" insideMap=""/>, logo image <bitmap>, and logo width and height in pixels <Dimensions
width=""height=""/>
Footer text <Footer>: Footer flag, vertical and horizontal position, and the inside map flag <Position vPos=""
enable="" hPos="" insideMap=""/>, footer text <text>, and font details 
Sample
<Pr i nt Conf i gur at i on ver si on=" 1" >
<Page>
<Paper si ze=" " or i ent at i on=" 1"/ >
<Mar gi ns r i ght =" 2000" l ef t =" 2000" bot t om=" 2000" t op=" 2000" / >
<Scal e f i t ToPage=" 1" >12 495</ Scal e>
</ Page>
<Map i nsi deFZonl y=" 1" r ul er s=" 1" / >
<Legend>
<LegendPos enabl e=" 0" maj or Pos=" 3" mi nor Pos=" 0" i nsi deMap=" 0" / >
</ Legend>
<Comment s>
<Posi t i on vPos=" 1" enabl e=" 0" hPos=" 1" i nsi deMap=" 0" / >
<t ext ></ t ext >
<f ont hei ght ="14" wei ght =" 400" char set =" 1" f ace=" MS Shel l Dl g" i t al i c="0" / >
</ Comment s>
<Logo>
<bi t map></ bi t map>
<Di mensi ons wi dt h=" 46" hei ght =" 18" / >
</ Logo>
<Ti t l e>
<t ext ></ t ext >
<f ont hei ght ="14" wei ght =" 400" char set =" 1" f ace=" MS Shel l Dl g" i t al i c="0" / >
</ Ti t l e>
<LogoBot t om>
<bi t map></ bi t map>
<Di mensi ons wi dt h=" 46" hei ght =" 18" / >
</ LogoBot t om>
<Foot er >
173
11.2.2 TableImport/ExportConfiguration
Thefollowingparametersaresavedfortableimport/export:
Headerflag<TITRE>
Fieldseparator<FLD_SEPARATOR>
Decimalsymbol<DEC_SEPARATOR>
Fieldsavailableinthetable(fieldlegends)<FIELDS>
Fieldsselectedforimport/export(fieldlegends)<CHOOSEN_FIELDS>
Sample
11.2.3 CoveragePredictionReportConfiguration
Thefollowingparametersaresavedforcoveragepredictionreports:
ColumnsselectedintheColumnstobedisplayeddialogue<SelectedFields>includingthefieldtitles<Field><Title>
Sample
<t ext ></ t ext >
<f ont hei ght =" 14" wei ght =" 400" char set ="1" f ace=" MS Shel l Dl g" i t al i c=" 0"/ >
</ Foot er >
</ Pr i nt Conf i gur at i on>
<TI TRE>1</ TI TRE>
<FLD_SEPARATOR>&l t ; t ab&gt ; </ FLD_SEPARATOR>
<DEC_SEPARATOR>. </ DEC_SEPARATOR>
<FI ELDS>
Si t e
Tr ansmi t t er
. . .
</ FI ELDS>
<CHOOSEN_FI ELDS>
Si t e
Tr ansmi t t er
. . .
</ CHOOSEN_FI ELDS>
<Repor t Conf i gur at i on>
<Sel ect edFi el ds>
<Fi el d>
<Ti t l e>Sur f ace ( km ) </ Ti t l e>
</ Fi el d>
<Fi el d>
<Ti t l e>%of Cover ed Ar ea</ Ti t l e>
</ Fi el d>
. . .
</ Sel ect edFi el ds>
</ Repor t Conf i gur at i on>
174
11.2.4 CWMeasurementImportConfiguration
MorethanoneCWmeasurementimportconfigurationscanbesavedinasingleCWMeasurementsImport.inifile.
ThefollowingparametersaresavedintheCWMeasurementsImport.inifiles:
Configurationnameinsquarebrackets
Firstmeasurementrow(Header)
Separator(Separator)
Decimalsymbol(DecimalSeparator)
Typeoffilesforwhichtheconfigurationhasbeendefined(Pattern)
ColumncontainingtheXcoordinates(Xindex)
ColumncontainingtheYcoordinates(Yindex)
Columncontainingthemeasurementvalues(MeasIndex)
Unitofthemeasurementvalues(Unit)
Frequencyofthemeasurements(Frequency)
Heightofthereceiverusedformeasurements(Height)
Gainofthereceiverusedformeasurements(Gain)
Lossesofthereceiverusedformeasurements(Losses)
Totalnumberofcolumnsinmeasurementfiles(NbCol)
Columntypes(Col0toColNbCol)
Thecolumntypeindexesareasfollows:
Sample
11.2.5 DriveTestDataImportConfiguration
MorethanonedrivetestdataimportconfigurationscanbesavedinasingleDriveTestDataImport.inifile.
ThefollowingparametersaresavedintheDriveTestDataImport.inifiles:
Configurationnameinsquarebrackets
Firstmeasurementrow(Header)
Type Index
Text 0
Integer 1
Real 2
Date 3
<Ignore> 4
[ Conf i gur at i onName]
Header =2
Separ at or =t ab
Deci mal Separ at or =.
Pat t er n=*. t xt
Xi ndex=1
Yi ndex=2
MeasI ndex=4
Uni t =0
Fr equency=2110
Hei ght =1. 5
Gai n=0
Losses=0
NbCol =23
Col 0=1
Col 3=4
Col 5=0
. . .
175
Separator(Separator)
Decimalsymbol(DecimalSeparator)
Typeoffilesforwhichtheconfigurationhasbeendefined(Pattern)
ColumncontainingtheXcoordinates(Xindex)
ColumncontainingtheYcoordinates(Yindex)
Unitofthemeasurementvalues(Unit)
Heightofthereceiverusedformeasurements(Height)
Gainofthereceiverusedformeasurements(Gain)
Lossesofthereceiverusedformeasurements(Losses)
Firstidentifier(GenericNameIdOne)
Secondidentifier(GenericNameIdTwo)
Formatofthesecondidentifier(IdFormat)
Wirelesstechnology(Techno)
Totalnumberofcolumnsinmeasurementfiles(NbCol)
Columntypes(Col0toColNbCol)
Thecolumntypeindexesareasfollows:
Sample
11.3 ContentsoftheCustomPredictionsFile
Thecontentsofthecustompredictionsfilearethesameasthoseofthecoveragepredictionlistintheuserconfigurationfiles
excludingthe<Atoll></Atoll>and<Studies></Studies>tags.Formoreinformation,see"CoveragePredictions"onpage 159.
Type Index
Text 0
Integer 1
LongInteger 2
Single 3
Double 4
Date 5
<Ignore> 6
[ Conf i gur at i onName]
Header =2
Separ at or =t ab
Deci mal Separ at or =.
Pat t er n=*. *
Xi ndex=1
Yi ndex=2
Uni t =0
Hei ght =1. 5
Gai n=0
Losses=0
Gener i cNameI dOne=
Gener i cNameI dTwo=BSI D
I dFor mat =Deci mal
Techno=I EEE 802. 16e
NbCol =21
Col 0=1
Col 3=1
Col 4=4
. . .
176
AT320_AM_E2 Chapter12:InitialisationFiles
177
12 InitialisationFiles
Initialisationfilescanbeusedtostoreoperationalandworkingenvironmentsettings.Thesefilesareoptional,notrequired
forworkingwithAtoll,butareusefulmeansforselectingrequiredcalculationmethodsandothersettings.
Thischapterdescribestheformatsofthesefilesindetail:
Atollinitialisationfile(INIfiles)
This file contains conventions, calculation settings, and other options. For more information on these options, see
"AtollInitialisationFile"onpage 177.
TheAtollinitialisationfilecanbeautomaticallyloadedwhenAtollisrunif:
a. ThefileisidentifiedinthecommandlineparameterIni"inifilename"(see"AtollCommandLineParameters"on
page 36formoreinformation),or
b. Thefileisnamed"Atoll.ini"andislocatedintheAtollinstallationfolder.Thisfilewillbeignoredifaninitialisation
fileisloadedthroughthecommandlineparameter.
ACPinitialisationfile(INIfiles)
ThisfilecontainscalculationsettingsandotheroptionsfortheACPmodule.Formoreinformationontheseoptions,
see"ACPInitialisationFile"onpage 219.
12.1 AtollInitialisationFile
Thefollowingmaingroupsofoptionsareavailable:
"GeneralOptions"onpage 177
"GUIOptions"onpage 188
"DistributedCalculationServerOptions"onpage 191
"LicenceManagementOptions"onpage 192
"DatabaseOptions"onpage 193
"CommonCalculationOptions"onpage 196
"GSMGPRSEDGEOptions"onpage 202
"UMTSHSPA,CDMA2000,andTDSCDMAOptions"onpage 206
"LTE,WiMAX,andWiFiOptions"onpage 212
"3GPPMultiRATOptions"onpage 215
"MicrowaveRadioLinksOptions"onpage 215
"MeasurementOptions"onpage 217
"ACPOptions"onpage 218
12.1.1 GeneralOptions
12.1.1.1 ModifyingtheDefaultFormatsofSiteandTransmitterNames
ThroughtheAtoll.inifile,itispossibletospecifyprefixestobeusedfornamingsitesandtransmitters.
Incaseofsites,youmustaddtheselines:
You can open the Atoll.ini file in the Atoll installation folder for editing by pressing
CTRL+SHIFT+i.IfnoAtoll.inifileexists,ablankAtoll.inifileiscreated.
You have to restart Atoll in order to take into account any modifications in the
Atoll.inifile.
AnAtoll.inisection,forexample,[GUIUserRights]or[LTE],mustoccuronlyonceinthe
file, with all the options pertaining to that section listed under it. If you enter the
same section more than once, only the first occurrence will be read and loaded by
Atoll.
TheAtollinitialisationfileisapowerfultool.Youshouldnotmodifyanyoptionuntiland
unlessyouareabsolutelysureofwhatyouaredoing.
178
Chapter12:InitialisationFiles Forsk2013
EachnewsitewillthenbenamednewprefixNinsteadofSiteN,whereNisthesitenumberorindex.
Fortransmitters,youcandefineaprefixbyaddingtheselines:
Each new transmitter will be named newprefixN instead of Sitename_X (Sitename is the name of the site where the
transmitterislocatedandXisthetransmittersectornumberonthissite).Notaddingtheabovelines,orsettingtheprefixto
<Auto>(Prefix="<AUTO>"),willinstructAtolltokeeptheconventionalnamingmethod,i.e.,eachtransmitterwillbenamed
Sitename_X.
Furthermore,itisalsopossibletoremovetheunderscorecharacter"_"fromthetransmittersname,i.e.,thetransmittercan
benamedSitenameXinsteadofSitename_X.Todothis,addthefollowinglineinthe[Transmitter]sectionoftheAtoll.inifile:
Settingthisvalueto0meanstheunderscorecharacterwillnotbeusedwhennamingtransmitters.Thedefaultvalueis1.You
canalsodefinewhetherthesuffixXinthetransmittersnameshouldbeanumberoraletter.Thefollowingtwolinesdefine
thisoptionintheAtoll.inifile:
WhenSuffixIsNum=1,thedefault,thesuffixXinthetransmitternameSitename_Xwillbeanumber.Whenitissetto0,this
suffixwillbealetter.ThestartingsuffixinthiscasewillbeAbydefaultbutcanbechangedtoanyothercharacterthrough
thesecondline.
Ifyouareusingnumbersuffixes,youcanalsoinitialisethenumbersuffixatanyothernumberthan1.Todothis,youcanadd
thefollowinglinesunderthe[Transmitter]sectionoftheAtoll.inifile:
Where,Xisanumber.
12.1.1.2 DisablingAutomaticRenamingofTransmittersandCells
Whenthenameofanysiteismodified,Atollautomaticallyrenamesthetransmittersandcellsrelatedtothesiteaccordingto
the new site name. Similarly, renaming a transmitter renames the corresponding cells automatically. Automatic renaming
accordingtositenamesisenabledbydefault.However,itcanbedisabledbyaddingthefollowinglinesintheAtoll.inifile:
"Transmitters"referstotransmitterrenamingwhenthesitenameischanged.
"3Gcells"referstocellrenamingwhenthetransmitternameischanged.
12.1.1.3 SettingtheTIFFColourConvention
Inthedefaultpalette,thefirstcolourindexesrepresenttheusefulinformationandtheremainingcolourindexesrepresent
thebackground.YoucanexportTIFFfileswithapalettecontainingthebackgroundcolouratindex0alongwithothercolour
indicesrepresentingtheforeground.ThiscanbehelpfulwhenworkingonTIFFfilesexportedbyAtollinothertools.Todoso,
theAtoll.inifilemustcontaintheselines:
12.1.1.4 CreatinganEventViewerLogFile
You can define a log file path and file name in Atoll.ini in order to save all the warning, error, and information messages
displayedintheEventViewerwindowtoalogfile.Todothis,addthefollowinglinestoAtoll.ini:
[ Si t e]
Pr ef i x = " newpr ef i x"
[ Tr ansmi t t er ]
Pr ef i x = " newpr ef i x"
Under scor e = 0 or 1
Suf f i xI sNum= 0 or 1
Fi r st Char Suf f i x = " A"
Fi r st = X
[ Aut oRename]
Tr ansmi t t er s = 0
3GCel l s = 0
[ Ti f f Expor t ]
Pal et t eConvent i on = Gi s
179
Thepathshouldbethefullpathtothelogfile,whichcanbe,forexample,"\\Server\Drive\Root\Folder\Atoll\"or"C:\Program
Files\Forsk\Atoll\"(withoutquotationmarks)."LogFile.log"willbecreatedbyAtollasanASCIItextfile,andcanhaveanyfile
nameandextension.Atollwilloverwriteanyalreadyexistinglogfilewiththesamename.IfAtollisunabletooverwritethe
existinglogfile,itwillnotcreateanylog.
YoucanalsostartAtoll,specifyingalogfile,bystartingitwith"Atoll.exelogLogFile.log",eitherfromthecommandline,or
bymodifyingtheshortcutparameters.IfyouhavealogfiledefinedintheAtoll.inifile,andrunAtollwiththelogoptionin
thecommandline,thecommandlinelogfilewillhavepriorityovertheonementionedintheAtoll.inifile.
TheoptionavailableinAtoll.iniismoresuitableforrunningAtollusingmacros.Apartfromtheseoptions,youalsohavethe
possibilitytosavethemessagesintheEventViewertoalogfileduringanAtollsession(throughtheEventViewercontext
menu).
12.1.1.5 DisplayingInsufficientPermissionMessagesintheEventViewer
If a user attempts to load an addin for which he does not have the necessary permissions, by default, a message will be
displayedintheEventViewer.Bydefininganoptionintheatoll.inifile,messagesregardinginsufficientpermissionwillnotbe
displayed.
12.1.1.6 IncreasingtheMaximumPrintingResolution
Bydefault,Atolllimitstheprintingresolutionto150dpi(dotsperinch)toimproveperformanceandconsumelessmemory
whenprinting.IfyouwantAtolltoprintyourmapsinahigherresolutionthan150dpi,youcanaddthefollowinglinestothe
Atoll.inifile:
300dpiisgivenasanexampleonly.
12.1.1.7 DuplicatingLinkedPathLossMatricesonSaveAs
WhenyousaveanAtolldocumentwithlinkedpathlossmatricesasanotherdocumentusingSaveAs,Atollcreatesthethe
linkedpathlossmatricesfoldercorrespondingtothecreatedfileandcopiestheexistinglinkedpathlossmatricesfromthe
pathlossmatricesfolderoftheoriginaldocument.TherecanbealargenumberofLOSfiles,andcopyingthesefilescantake
alongtimeandusealotofdiskspace.IfyouwantAtollnottomakecopiesofthelinkedpathlossmatrices,youcanaddthe
followinglinestotheAtoll.inifile:
StoreExternPrivLosFilesOnCopyissetto1bydefault,whichmeansthatAtollmakescopiesofthelinkedpathlossmatriceson
Save As. If you set StoreExternPrivLosFilesOnCopy to 0, Atoll does not create the linked path loss matrices folder
correspondingtothecreatedfile,andthelinkedpathlossmatricesoftheoriginalAtolldocumentareusedforthenewAtoll
documentaswell.
AfileopeninAtollhasexclusiveaccessrightstoitsprivatepathlossmatrices.Iftwofilespointtothesamelinkedpathloss
matricesfolder,thefileopenfirstwillhaveaccesstothethepathlossmatrices.Youwillbeabletoopenthesecondfile,but
itwillnolongerpointtoanyprivatepathlossmatricesfolder.Therefore,ifyouhavemorethanonefilethatpointstothe
sameprivatepathlossmatricesfolder,youshouldnotopenthematthesametime.
WhenStoreExternPrivLosFilesOnCopyissetto1,youcanaddanotheroptionintheAtoll.inifiletomakeAtollaskthewhether
theuserwantsAtolltomakecopiesthelinkedpathlossmatricesornot.ToaddthisconfirmationsteponSaveAs,addthe
followinglinesintheAtoll.inifile:
ConfirmStoreExternPrivLosFilesOnCopyissetto0bydefault.ThisoptionisignoredwhenAtollisruninnoninteractivemode,
forexampleusingtheAPI.
[ Event sObser ver ]
LogPat h = Ful l Pat h\ LogFi l e. l og
ShowAddi nAccessDeni edMsg=0 #1 by def aul t ; i nsuf f i ci ent per mi ssi on messages ar e shown
[ Pr i nt ]
MaxDPI = 300
[ Per f os]
St or eExt er nPr i vLosFi l esOnCopy = 0
[ Per f os]
Conf i r mSt or eExt er nPr i vLosFi l esOnCopy = 1
180
12.1.1.8 RestrictingtheListofPredictionsforCreatingSectorTrafficMaps
Whenyoucreateasectortrafficmap,i.e.,trafficmapbasedoncellcoverageareas,Atollusesanexistingbestservercoverage
predictioninordertobeabletodistributethelivetrafficdatageographically.Atollletsyouselectthebestservercoverage
predictiononwhichthetrafficmapwillbebased.Inthelistofavailablebestservercoveragepredictions,Atolllistsallthebest
servercoveragepredictionavailableinthePredictionsfolder,whethertheywerecreatedusingamarginorwithout.
IfyouwantAtolltolistonlythebestservercoveragepredictionsthatwerecreatedwithoutamargin,i.e.,with0 dBmargin,
youcanaddthefollowinglinestotheAtoll.inifile:
SelectNullMarginOnlyissetto0bydefault,whichmeansthatAtolllistsallthebestservercoveragepredictionsavailable.
12.1.1.9 DisplayingPathLossCalculationDetailsintheEventViewer
Duringpathlosscalculations,AtolldisplaysdetailsaboutthesecalculationsintheTaskstaboftheEventViewer.Thesedetails
cannotbecopiedorsaved.Ifyouwantaccesstothesedetails,ortoasummaryofthesedetails,oncethecalculationshave
finished,youcanaddthefollowinglinesintheAtoll.inifile:
SettingtheDisplayInvalidityCauseoptionto1willdisplaythecauseforwhichpathlosseswerecalculatedforeachtransmitter,
setting DisplayIndividualSuccessOrFailure to 1 will display whether the path loss calculation succeeded or failed for each
transmitter,andsettingDisplayOverallSuccessOrFailureto1willdisplaythetotalnumberofpathlossmatricescalculated,the
numberofpathlossmatricescalculatedsuccessfully,andthenumberofcalculationsthatfailed.
ThesedetailsarelistedintheEventstaboftheEventViewer.
12.1.1.10 MappingAtollCoordinateSystemswithMapInfo/ESRIVectorFiles
ItisnowpossibletodefineamappingbetweenthecoordinatesystemsinAtollandthecoordinatesystemsdefinedinthe
headerfilesofMapInfo(MIF)andESRI(PRJ)vectorfilesthatyouwanttoimport.Youcandefneamappingbetweenthetwo
coordinatesystemsbyaddingthefollowinglinesintheAtoll.inifile:
In this way, Atoll is able to exactly detect the coordinate system used by the vector file being imported. In MIF files, the
CoordSys clause defines the coordinate systems, datum, unit, and other information. The coordinate system definition is
differentinthePRJfiles.ThesyntaxusedinAtoll.inifollowsthesyntaxoftheCoordSysclauseinMIFfiles.Usingthesame
syntaxforMIFandPRJfiles,AtollisabletoreadthedetectthecoordinatesystemsforbothMapInfoandESRIvectorfiles.
ThecoordinatesystemcodesinAtollarestoredintheCSfilesinthecoordsystemsfolder.Toaccessthecoordinatesystem
codesthroughAtoll:
1. SelectTools>Options.TheOptionsdialogueopens.
2. On the Coordinates tab, click the browse button (...) to the left of the Projection field. The Coordinate Systems
dialogueopens.
3. Selectacoordinatesysteminthepane.
4. ClickthePropertiesbutton.TheCoordinateSystempropertiesdialogueopens.
Thecoordinatesystemcodeisavailableinthepropertiesdialogue.
Afewexamplesofsuchmappingaregivenbelow.
[ St udi es]
Sel ect Nul l Mar gi nOnl y = 1
[ Pat hl osses]
Di spl ayI nval i di t yCause = 1
Di spl ayI ndi vi dual SuccessOr Fai l ur e = 1
Di spl ayOver al l SuccessOr Fai l ur e = 1
[ MI TAB]
Coordinate system definition in the header file = Coordinate system code in Atoll
[ MI TAB]
; NTF
Ear t h Pr oj ect i on 1, 107 = 4275
; Tokyo
Ear t h Pr oj ect i on 1, 97 = 4301
; WGS 84 / UTM zone 31N
181
12.1.1.11 ExportingCoveragePredictionPolygonsinTextFormat
Youcanexportcoveragepredictionsintheformofpolygonstotextformatfiles.
YoucanenablethisfeaturebyaddingthefollowinglinesintheAtoll.inifile:
SettingEnableLBSto1addsanewcoveragepredictionexportformat"LBSPolygonFiles(*.txt)"toAtoll.Thepolygonsare
exportedinacommaseparatedvaluesformat.
12.1.1.12 DefiningWebMapServicesServers
WebMapServicesallowyoutodirectlyimportgeographicdatafromspecialisedserversintoAtoll.ThelistofWMSservers
canbedefinedintheAtoll.inifileasfollows:
YoucandefineanynumberofserversbyincrementingtheindexN.TheseserverswillbeavailableintheWMSdataimport
dialogueinAtoll.
12.1.1.13 ImprovingPointAnalysisPerformance
Youcanimprovetheperformance,i.e.,calculationspeed,ofthePointAnalysistoolbyrestrictingthenumberoftransmitters
forwhichthereceivedsignallevelsarecalculated.TorestrictthenumberoftransmittersconsideredinthePointAnalysistool,
addthefollowinglinesintheAtoll.inifile:
The option PtAnalysisNbServersMax lets to define the maximum number of transmitters (servers) to consider for the
calculationofthereceivedsignallevels.Xisthemaximumnumberoftransmitters.
TheoptionPtAnalysisMarginletsyoudefinethemarginwithrespecttothebestserversignallevel.Atollcalculatesthesignal
levelsfromallthetransmitterswithinY dBmarginfromthebestserversignallevel.ThedefaultvalueforPtAnalysisMarginis
30 dB.
Inadditiontotheabove,youcanalsosetthenumberoftransmittersforwhicharrowsaredisplayedfromthepointerlocation
inthemapwindow.Forsettingthisnumber,addthefollowinglinesintheAtoll.inifile:
Ear t h Pr oj ect i on 8, 104, "m" , 3, 0, 1, 500000, 0 = 32631
Ear t h Pr oj ect i on 8, 104, "m" , 135, 0, 0. 9996, 500000, 0 = 32653
Ear t h Pr oj ect i on 8, 104, "m" , 141, 0, 0. 9996, 500000, 0 = 32654
; NTF ( Par i s) / Fr ance I I t endue
Ear t h Pr oj ect i on 3, 1002, " m" , 0, 46. 8, 45. 8989188889, 47. 69601444, 600000, 2200000
= 27595
Enablingthisoptioninfluencestheexportfeatureforallexportablevectorfomats(MIF,
TAB,AGD,SHP,TXT).Whenthisoptionisenabled,onlythelargestpolygonisexported
forcoveragelayershavingmorethanonepolygon.
[ St udi es]
Enabl eLBS = 1
[ WMS]
S1 = Server1
S2 = Server2
. . .
SN = ServerN
[ Per f os]
Pt Anal ysi sNbSer ver sMax = X
Pt Anal ysi sMar gi n = Y
[ Recept i onTab]
Number Of Tr ansmi t t er Di spl ayed = Z
182
Zisthenumberoftransmittersforwhicharrowsgeneratedfromthepointerlocationwillbedisplayedinthemapwindow.
12.1.1.14 LoadingVectorFilesDynamically
VectorgeodatafromfilesimportedinanAtolldocumentareloadedinthememorywhenthedocumentisopen.Atollcan
dynamicallyloadthedatafromSHPandTABvectorfileswhenthefollowingoptionissetintheAtoll.inifile:
LoadVectorsissetto0bydefault,whichmeansthatthedatafromimportedvectorfilesareloadedinmemory.Whenyouset
LoadVectorsto1,Atollreadsthedatafromthevectorfilesdirectly.
Fromthepointofviewofperformance,thisoptionisonlyadvisablewhenworkingwithlargevectordatafiles.
12.1.1.15 ExcludingVectorsfromImportedKML/KMZFiles
By default, when a KML or KMZ file is imported in an Atoll document, the placemarks and vectors are both imported. By
definingthefollowingoptionintheAtoll.inifile,youcanimportKMLandKMZfileswithoutvectors:
LoadKMLVectorsissetto1bydefault,whichmeansthatvectorsareimportedalongwithplacemarks.
12.1.1.16 SettingthePrecisionfortheAntennaPatternVerificationatImport
Atollcheckswhethertheverticalandhorizontalpatternsarecorrectlyalignedattheextremities.Theantennapatternsare
correctlyalignedwhen:
thehorizontalpatternattenuationat0isthesameastheverticalpatternattenuationatthepatternelectricaltilt
angle,and
thehorizontalpatternattenuationat180isthesameastheverticalpatternattenuationatthe180lessthepattern
electricaltiltangle.
Bydefault,theoptionisinactive,i.e.,thepatternattenuationsareconsideredthesameiftheydifferlessthan100 dB.Ifyou
wanttochangethisdefaultprecision,addthefollowinglinesintheAtoll.inifile:
WhereXistherequiredprecisionindBmultipliedby10.Forexample,ifyouwanttosettheprecisionto0.5 dB,Xwillbe
.
12.1.1.17 OpeningExportedXLSFilesAutomaticallyinMSExcel
Whenyouexportanentiredatatable,orselectedcolumns,toanMSExcelfile,AtollcanautomaticallyrunMSExceloncethe
exportiscompleteandopentheXLSfilecreatedbytheexportinMSExcel.Toenablethisfeature,addthefollowingoption
intheAtoll.inifile:
AutoOpenWithExcelissetto0bydefault.
12.1.1.18 DisallowingCreationofNewDocumentsfromTemplates
YoucandisallowthecreationofnewAtolldocumentsfromtemplatesbyaddingthefollowinglinesintheAtoll.inifile:
EnableNewDocFromTemplateissetto1bydefault.
12.1.1.19 BlockingAccesstoMacrosandAddins
YoucanblockaccesstotheAddinsandMacrosdialoguebyaddingthefollowinglinesintheAtoll.inifile:
[ I mpor t ]
LoadVect or s = 1
[ I mpor t ]
LoadKMLVect or s = 0
[ Ant enna]
Pr eci si onTi mes10 = X
0.5 10 5 =
[ Expor t ]
Aut oOpenWi t hExcel = 1
[ GUI User Ri ght s]
Enabl eNewDocFr omTempl at e = 0
183
EnableMacrosAddinsissetto1bydefault.
12.1.1.20 DisablingSavingandOpeningZIPFiles
YoucanblockaccesstotheFile>SavetoZipandFile>OpenFromZipmenusbyaddingthefollowinglinesintheAtoll.inifile:
EnableZipissetto1bydefault.
12.1.1.21 EnablingNotificationforDonorTransmitterParameterModifications
Atollcannotifyyouwheneveradonortransmitterparameter,whichhasanimpactonarepeater,ismodified.Toactivatethe
notification,addthefollowinglinesintheAtoll.inifile:
CheckImpactOnRepeatersissetto0bydefault,whichmeansthatnonotificationsaredisplayed.
12.1.1.22 SettingtheDisplayPrecisionofFloatingPointValues
MostfloatingpointvaluesinAtollareformattedfordisplayingtwodigitsafterthedecimalpoint.Suchformattedfloating
pointvaluesincludethresholdsandpowervaluesindBm.However,incaseofdocumentsconnectedtodatabases(otherthan
MSAccess),somenonformattedfloatingpointvaluescanbedisplayedwithtoomanydigitsafterthedecimalpoint.
YoucansetthedisplayprecisionfornonformattedfloatingpointvaluesinAtolldialoguesandtables.Forexample,inorder
todisplaytwodigitsafterthedecimalpoint,youcanaddthefollowinglinesintheAtoll.inifile:
This option applies to all nonformatted floating point parameters in Atoll, i.e., excluding geographic coordinates and
formattedfloatingpointvalues.
NbDecimalsissetto1bydefault.Thiscorrespondstomaximumprecision,i.e.,allthedigitsafterthedecimalpointavailable
inthedatabasearedisplayed.
12.1.1.23 ChangingthePathtoLinkedGeoDataFiles
YoucanchangethepathtoalinkedgeographicdatafilebyclickingtheFindbuttoninthePropertiesdialogueofthefile.By
default,theFindbuttoninthePropertiesdialogueisavailableonlyformissinggeographicdatafiles,i.e.,thelinkedfilesthat
Atollisunabletolocateandload.However,youcanenabletheFindbuttonevenforavailablegeographicdatafilesbyadding
thefollowinglinesintheAtoll.inifile:
FindGeoButtonAlwaysActiveissetto0bydefault.YoudonothavetorestartAtollforittotakethisoptionintoaccount.
Thisoptioncanbeusefulwhenyouhavechangedthelocationofageographicdatafile,andyouwishtochangethepathto
thenewlocation.
12.1.1.24 Exporting/ImportingVectorDatawithaDisplayConfigurationFile
WhenyouexportvectordatafromanAtolldocument,youcansimultaneouslyexportthecorrespondingdisplayconfiguration
file(CFG)oftheeditedvectorlayerbyaddingthefollowinglinesintheAtoll.inifile.Theexporteddisplayconfigurationfilewill
havethesamefilenameandwillbesavedinthesamedirectoryastheexportedvectorformatfile.
Enabl eMacr osAddi ns = 0
Enabl eZi p = 0
[ Tr ansmi t t er ]
CheckI mpact OnRepeat er s = 1
[ Gr i ds]
NbDeci mal s = 2
[ Geo]
Fi ndGeoBut t onAl waysAct i ve = 1
Whenchangingthepathtoalinkedgeographicdatafile,youmustprovidethenewpath
tothesamefile.Thisoptiondoesnotallowlinkingtoanotherfileinstead.Inordertolink
toanotherfile,youmustfollowthenormalfileimportprocedure.
184
VectorDisplayConfigurationCompanionFileissetto1bydefault.YoudonothavetorestartAtollforittotakethisoptioninto
account.
WhenyouimportvectordatainanAtolldocument,thesameoptionenablesyoutosimultaneouslyimportthecorresponding
display configuration file (CFG). The display configuration file will only be imported if it has the same file name and if it is
locatedinthesamedirectoryastheimportedvectorformatfile.
12.1.1.25 UsingOnlyVisibleGeoDatainPredictionReports
Bydefault,Atolltakesintoaccountallthegeographicdatawhengeneratingpredictionreports,whetherthegeographicdata
is visibleon the mapornot.Youcan change the default behaviour forpopulation, traffic,and generic geographicdataby
addingthefollowinglinesintheAtoll.inifile:
ReportObeysVisibilityissetto0bydefault.
12.1.1.26 ExportingBMP,TIF,andPNGFileswithaTABReferenceFile
WhenexportingBMP,TIF,andPNGfiles,AtollcanexportthegeoreferenceinformationinaTABfileinsteadofthedefault
respectiveWorldfiles(BPWorBMWforBMP,TFWforTIF,andPGWforPNG).IfyouwantAtolltoexportthegeoreference
informationinaTABfilewhenyouexportinBMP,TIF,andPNGformats,addthefollowinglinesintheAtoll.inifile:
GeorefWithTABissetto0bydefault.
12.1.1.27 CoPlanning:LinkingtheSitesFolder
You can link the Sites folder, in addition to the Transmitters and Predictions folders, of a document to another (main)
documentusingtheFile >LinkWithcommandbyaddingthefollowinglinesintheAtoll.inifile:
LinkSitesissetto0bydefault.
12.1.1.28 DisablingNormalisationofMIF/TABVectorFiles
Whenimportingvectorfiles,Atollnormalisesallthevectorsinthefilesbasedontheconventionthatavectorwhosevertices
coordinates are defined clockwise creates a filled polygon, and a vector whose vertices coordinates are defined counter
clockwisecreatesahole.MapInfovectorsdonotfollowthesameconvention,andhencetheirnormalisationatthetimeof
import can take a long time. If you want to disable this normalisation when importing MIF and TAB vector files, add the
DisableNormalizationissetto0bydefault.
12.1.1.29 AddingtheDuplicateSitetotheOriginalSitesSiteList
Whenyouduplicateasite,youcanchoosetoaddtheduplicatesitetothesitelist(ifany)oftheoriginalsitebyaddingthe
AddToSiteListOnDuplicateissetto0bydefault.
[ Geo]
Vect or Di spl ayConf i gur at i onCompani onFi l e = 1
[ Geo]
Repor t ObeysVi si bi l i t y = 1
[ Rast er Expor t ]
Geor ef Wi t hTAB = 1
[ CoPl anni ng]
Li nkSi t es = 1
[ MI TAB]
Di sabl eNor mal i zat i on = 1
[ Si t e]
AddToSi t eLi st OnDupl i cat e = 1
185
12.1.1.30 UsingOnlyVisibleClutterClassesinInterferencePredictionReports
By default, Atoll takes into account all the clutter classes when generating reports on interferencebased coverage
predictions,whethertheclutterclassesarevisibleonthemapornot.Youcanchangethedefaultbehaviourbyaddingthe
OnlyVisibleClassesInInterferenceReport is set to 0 by default. The visibility of clutter classes on the map can be managed
through theDisplaytabofthePropertiesdialogue oftheClutterClassesfolder.Usingthisoptionyou canexcludeclutter
classeswhicharenotrelevantincoveragepredictionreports,forexample,water.
12.1.1.31 Displaying%ofCoveredClutterClassesw.r.t.theFocusZoneinReports
Incoveragepredictionreports,Atolldisplaysthepercentagesofcoveredclutterclasseswithrespecttothetotalsurfacearea
ofalltheclutterclassescoveredbytheprediction.IfyouwantAtolltodisplaythepercentagesofcoveredclutterclasseswith
respecttothetotalsurfaceareaofalltheclutterclasseswithintheFocusZone,addthefollowinglinesintheAtoll.inifile:
PerClassPercentagesRelativeToCoverageInReportissetto1bydefault.
12.1.1.32 Displaying%ofCoveredTrafficClassesw.r.t.theFocusZoneinReports
Incoveragepredictionreports,Atolldisplaysthepercentagesofcoveredenvironmenttrafficclasseswithrespecttothetotal
surfaceareaofalltheenvironmenttrafficclassescoveredbytheprediction.IfyouwantAtolltodisplaythepercentagesof
covered environment traffic classes with respect to the total surface area of all the environment traffic classes within the
FocusZone,addthefollowinglinesintheAtoll.inifile:
PerClassPercentagesRelativeToCoverageInReportissetto1bydefault.
12.1.1.33 SynchronisingPrivateandSharedPathLossMatrices
Whencalculationsarerun,Atollverifieswhetherthesharedandprivatepathlossmatricesarevalid.Ifthesharedpathloss
matricesarevalid,
Atolldeletesanycorrespondinginvalidprivatepathlossmatricesandusesthevalidsharedonesforcalculationsif
Atoll.inicontainsthefollowinglines:
Atoll deletes any corresponding valid and invalid private path loss matrices and uses the valid shared ones for
calculationsifAtoll.inicontainsthefollowinglines:
If you haveprivatepathlossmatrices tuned usingmeasurement data,setting FullResyncPrivShared to1 will make
Atollautomaticallydeletethemwhencalculationsarerun.YoushouldsetFullResyncPrivSharedto0whenworking
withtunedprivatepathlossmatrices.
FullResyncPrivSharedissetto1bydefault.
12.1.1.34 SelectingtheLogo2CheckBoxbyDefaultinPrintSetup
PrintsetupparametersarestoredintheAtolldocuments,andyoucansavetheprintsetupparametersinCFGfiles(see"Print
SetupConfiguration"onpage 171).IfyouwishtohavetheLogo2checkboxselectedbydefaultforanynewAtolldocument,
addthefollowinglinestotheAtoll.inifile:
[ Cl ut t er ]
Onl yVi si bl eCl assesI nI nt er f er enceRepor t = 1
[ Cl ut t er ]
Per Cl assPer cent agesRel at i veToCover ageI nRepor t = 0
[ Tr af f i c]
Per Cl assPer cent agesRel at i veToCover ageI nRepor t = 0
[ Pat hl osses]
Ful l ResyncPr i vShar ed = 0
[ Pat hl osses]
Ful l ResyncPr i vShar ed = 1
186
LogoFooterCheckedissetto0bydefault.
12.1.1.35 FilteringPredictionsbyTechnologyWhenReadingtheXMLStudiesFile
IntheXMLstudiesfile,somecommonCDMAcoveragepredictionscanbeavailableforbothCDMA2000andUMTS,orsome
common OFDMA coverage predictions can be available for both WiMAX and LTE. If you wish to filter the customised
predictionsstoredintheXMLstudiesfilebytheirtechnology,e.g.,separatetheWiMAXandLTEcoveragepredictions,and
onlyloadthepredictionsspecifictothetechnologyofthecurrentactiveAtolldocument,addthefollowinglinesintheAtoll.ini
file:
CustomStudiesFilteredByTechnoissetto0bydefault.ThisoptionisonlyrelevantforreadingtheXMLstudiesfile.Atollalways
writesthetechnologytypeintheXMLstudiesfilewhencustomisedcoveragepredictionsaresavedinit.
12.1.1.36 EnablingEventViewerMessagesforMapInfoFileImport/Export
YoucanenablethedisplayofEventViewerinformation,warning,orerrormessagesrelatedtoMapInfofilesbyaddingthe
EnableMessagesissetto0bydefault,andAtolldoesnotdisplayanymessagesrelatedtoMapInfofileimportandexport.
12.1.1.37 SettingCoveragePredictionReportResolutionForPopulationMaps
Atollusesthedefaultresolution,definedinthePredictionsfoldersPropertiesdialogue,forrasterisationofthepopulation
maps.Inordertouseadifferentresolutionforhigherorlowerprecision,youcanaddthefollowinglinesintheAtoll.inifile:
WhereXistheresolutionfortheconversionofpopulationmapvectorsintoraster.
12.1.1.38 SettingCoveragePredictionReportPrecision
Youcansettheprecisionofthefloatingpointvaluesdisplayedintheabsolutevaluecolumnsofcoveragepredictionreports
byaddingthethefollowinglinesintheAtoll.inifile:
WhereXisthenumberofdigitsfollowingthedecimal.
Youcansettheprecisionofthefloatingpointvaluesdisplayedinthepercentagevaluecolumnsofcoveragepredictionreports
byaddingthethefollowinglinesintheAtoll.inifile:
WhereXisthenumberofdigitsfollowingthedecimal.
[ Pr i nt ]
LogoFoot er Checked = 1
[ St udi es]
Cust omSt udi esFi l t er edByTechno = 1
[ MI TAB]
Enabl eMessages = 1
[ Popul at i on]
Repor t Resol ut i on = X
IfyousetReportResolutiontoaveryprecise(low)value,theperformance(calculation
speed)canbeconsiderablydecreaseddependingonthesizeofthepopulationmapsin
thedocument.Itisrecommendedtosetthisparametertoanoptimumvalue,i.e.,just
preciseenoughtogettherequiredaccuracy.
[ St udi es]
Repor t Deci mal Pl acesAbsol ut e = X
[ St udi es]
Repor t Deci mal Pl acesPer cent = X
187
12.1.1.39 ChangingHotSpotReferenceSurfaceinPredictionReports
Inacoveragepredictionreport,Atolldisplaysthepercentageofhotspotscoveredbyeachcoveragelayer(displaythresholds)
withasreferencethehotspotsurfaceareacoveredbythewholeprediction.IfyouwantAtolltodisplaythepercentageof
hotspotscoveredbyeachcoveragelayer(displaythresholds)withasreferencethehotspotsurfacearea,addthefollowing
linesintheAtoll.inifile:
12.1.1.40 ExportingOnlyVisibleValueIntervalLayersofCoveragePredictions
By default, Atoll exports all the layers (levels) of a coverage prediction being exported. For some coverage predictions
(coveragepredictionsdisplayedbyvalueintervalsandnotbydiscretevalues,excludingGSMcoveragepredictionsbycoding
schemes,throughput,andCQI),youcanexportonlythevisiblelevelsbyaddingthefollowinglinesintheAtoll.inifile:
ExportOnlyVisibleLevelsissetto0bydefault,whichmeansthatwhenanycoveragepredictionisexported,Atollexportsall
itslevels,visibleornot.
12.1.1.41 AvoidingOverlappingPixelsinBestServerCoveragePrediction
Inbestservercoveragepredictions,i.e.,CoveragebyTransmitterwithoption"Bestserver"andamarginof0 dB,somepixels
canbecoveredbymorethanonetransmitterifthereceivedsignallevelfromtwoormoretransmittersisexactlythesame.
Toavoidthis,addthefollowinglinesintheAtoll.inifile:
Bydefault,NoOverlapOnBestServerissetto0.WhenNoOverlapOnBestServerissetto1,Atollarbitrarilyselectsoneofthe
bestservers on such pixels. This optioncan be useful,for example, whencalculating population statisticsbasedon a best
servercoverageprediction.Whenapixeliscoveredbymorethanonebestserver,thepopulationbelongingtothatpixelis
countedasmanytimesasthenumberofbestservers,whichcangiveerroneouspercentagesofcoveredpopulation.
12.1.1.42 SettingtheMinimumATLFileSizeRequiringCompression
YoucansetthefilesizeabovewhichAtollshouldcompressdatainATLfilesbyaddingthefollowinglinesintheAtoll.inifile:
WhereXisthefilesizeinMB.AtollwillcompresstheATLfileifitislargerthanX.Bydefault,StartSizeInMBissetto800.
12.1.1.43 Loading,Activating,andSettingAddinsasVisible
Installed addins are automatically loaded by Atoll and appear in the Addins and Macros dialogue. You can change this
defaultbehaviourforeachindividualaddinasfollows:
Ifyouwantanaddinneithertobeloaded(i.e.,deactivated)norbeavailableintheAddinsandMacrosdialogue,add
If you want an addin to be loaded, activated, and accessible in the Addins and Macros dialogue for activation/
deactivation,addthefollowinglinesintheAtoll.inifile:
[ St udi es]
UseFul l Hot Spot Sur f aceOnRepor t = 1 # " 1" = act i vat ed ( Def aul t )
[ St udi es]
Expor t Onl yVi si bl eLevel s = 1
Atollexportsonlyvisiblecoveragepredictions.Ifacoveragepredictionconsistsofonly
onelevel,thevisibilitycheckboxofthatlevelalsocontrolsthevisibilitycheckboxofthe
prediction itself. This means that if the visibility check box of the only level of such a
predictioniscleared,thepredictionwillitselfbehiddenandwillnotbeexported.
[ St udi es]
NoOver l apOnBest Ser ver = 1
[ Compr essi on]
St ar t Si zeI nMB = X
[ Add- i ns]
Add-in Name = 0
188
Ifyouwantanaddintobeloaded,activated,andavailableintheAddinsandMacrosdialogueforinformation,add
If you want an addin to be mandatorily loaded, activated, and available in the Addins and Macros dialogue for
information,addthefollowinglinesintheAtoll.inifile:
WhereAddinNameisthenameoftheaddinasitappearsintheAddinsandMacrosdialogueinAtoll.Usingthisoption.Atoll
failstostartifforsomereasonitisunabletoloadanaddinwhosestatusissetto3.Thedefaultstatusforaddinsis1.
12.1.1.44 DefiningOnlineMapURLs
OnlinemapsallowyoutodisplaymapdatafromtheInternetinAtoll.YoucandefinealistofonlinemapURLsintheAtoll.ini
fileasfollows:
YoucandefineanynumberofonlinemapURLsbyincrementingtheindexN.TheseURLswillbeavailableintheonlinemap
importdialogueinAtoll.
12.1.2 GUIOptions
12.1.2.1 DefiningtheParametersfortheDefaultSitesSymbol
YoucandefinetheparametersofthedefaultsymbolusedfordisplayingsitesonthemapthroughtheAtoll.inifile.Youcan
definetheparametesasfollows:
ThedefaultsitessymbolisusedwhenanewdocumentiscreatedinAtoll.Toknowthenameofthefonttouse,andtosetthe
symbol,youcanusetheWindowsCharacterMaptool.Youcanusethecopy/pastefeaturestosetthesymbolintheAtoll.ini
file.
Example:
[ Add- i ns]
Add-in Name = 1
[ Add- i ns]
Add-in Name = 2
[ Add- i ns]
Add-in Name = 3
[ Onl i neMaps]
Name1 = Ci t y1
URL1 = ht t p: / / . . .
Name2 = Ci t y2
URL2 = ht t p: / / . . .
. . .
NameN = Ci t yN
URLN = ht t p: / / . . .
[ Si t esSymbol ]
Font Name = Name of the font
Symbol = Character used for the site symbol from the character set of the font
Si ze = Character size in number of pts
Col or = Colour of the symbol
[ Si t esSymbol ]
Font Name = Wi ngdi ngs
Symbol =
Si ze = 12
Col or = 0
189
12.1.2.2 UsingaUniqueSymbolforRemoteAntennas
Bydefault,remoteantennasaredisplayedusingthesamesymbolonthemapastransmitters.Youcanuseaunique,non
modifiablesymbolforremoteantennasonthemapbyaddingthefollowinglinesintheAtoll.inifile:
FrozenSymbolissetto0bydefault.WhenyousetFrozenSymbolto1,theremoteantennasymbolwillbefixedandnolonger
linkedwiththetransmittersymbol.
12.1.2.3 KeepingTransmitterSymbolsFromChangingonSearch
WhenusingtheSearchTool,allthetransmittersthatdonotfulfilthesearchcriteriaaredisplayedasgreylinesonthemap.If
youwantthesetransmitterstokeeptheiroriginalsymbols,addthefollowinglinesintheAtoll.inifile:
ChangeSymbolOnSearchissetto1bydefault.
12.1.2.4 DisplayingFilledSymbolsforInactiveTransmittersontheMap
Bydefault,Atollemptiesthesymbolsofinactivetrasnmitters,repeaters,andremoteantennasonthemap.Ifyouwishto
displayfilledsymbolsforinactivetransmitters,repeaters,andremoteantennasonthemap,addthefollowinglinesinthe
Atoll.inifile:
EmptySymbolWhenInactiveissetto1bydefault.
12.1.2.5 RefreshingtheDisplayAutomaticallyWhenaNewStationisDropped
YoucanhaveAtollrefreshthedisplayautomaticallyeachtimeanewstationoragroupofstationsisdroppedonthemapby
AutoSynchronizeDisplayissetto0bydefault.
12.1.2.6 HidingInformationDisplayedintheStatusBar
Usingcompressedgeodataformats(TIFF,ErdasImagine,ECW)cancauseperformancelossduetorealtimedecompression.
PerformancecanbeimprovedbyeitherhidingtheStatusBarorbyhidingsomeoftheinformationdisplayedintheStatusBar
(altitude,clutterclass,orclutterheight).TohideinformationintheStatusBar,addthefollowinglinestotheAtoll.ini:
DisplayZ,DisplayClutterClassandDisplayClutterHeightrespectivelyrefertothedisplayofaltitude,clutterclass,andclutter
height.
12.1.2.7 DisplayingDateandTimeintheEventViewer
YoucaninstructAtolltodisplaythedate,andtimewithmillisecondsintheEventviewer.Todisplaythisinformation,addthe
followinglinestotheAtoll.inifile:
[ Remot eAnt ennas]
Fr ozenSymbol = 1
[ Tr ansmi t t er ]
ChangeSymbol OnSear ch = 0
[ Tr ansmi t t er ]
Empt ySymbol WhenI nact i ve = 0
[ Tr ansmi t t er ]
Aut oSynchr oni zeDi spl ay = 1
[ St at usBar ]
Di spl ayZ = 0
Di spl ayCl ut t er Cl ass = 0
Di spl ayCl ut t er Hei ght = 0
mi l l i seconds = 1
dat e = 1
190
12.1.2.8 SettingtheMaximumNumberofLinesinCoveragePredictionToolTips
Ifyouhavemorethanonecoveragepredictiondisplayedonthemap,thetooltipsdisplaythetiptextforallthecoverage
predictionsavailableatapixelupto30linesbydefault.Youcanchangethisdefaultnumberoftooltiptextlinesthroughthe
followingoptionintheAtoll.inifile:
Xisthenumberoflinestodisplayinthetooltips.Bydefault,MultiplePlotsTipTextLinesissetto30.Ifyousetittoaverylarge
value,however,thetooltipmightnotdisplaycorrectly.
12.1.2.9 ChangingtheDisplayforDownlinkSmartAntennaResults
The downlink smart antenna simulation results, i.e, the angular distributions of downlink transmitted power density,
calculatedduringMonteCarlosimulationsusingtheOptimumBeamformerandConventionalBeamformercanbedisplayed
intwodifferentways.Bydefault,thesediagramsrepresenttheaveragearraycorrelationmatricesandaresymmetricabout
thexaxis(sameonthefrontandback).Ifyouwanttodisplaythesediagramstakingintoaccounttheantennapatternofthe
singleantennaelement,addthefollowingoptionintheAtoll.inifile:
DrawSingleElementPattern is set to 0 by default, in which case the displayed diagram is . When you set
DrawSingleElementPatternto1,thediagramdisplayedwillrepresent .
12.1.2.10 DisplayingCoveragePredictionCommentsintheLegendWindow
YoucandisplaythecontentsoftheCommentsboxofcoveragepredictionpropertiesintheLegendwindowbyaddingthe
Thecommentsaredisplayedbetweenthenameofthecoveragepredictionandthethresholds.CommentsInLegendissetto
0bydefault.
12.1.2.11 DisplayingLeadingZerosintheCELL_IDENTITYField
Bydefault,AtolldoesnotdisplayleadingzerosintheCELL_IDENTITYfieldoftheTransmitterstableinGSMandtheCellstables
inUMTS,CDMA2000,andTDSCDMA.Forexample,cellidentity"00678"isdisplayedas"678".IfyouwantAtolltodisplay
leadingzeros,youmustsettheminimunnumberofdigitstheCELL_IDENTITYfieldshouldcontainbyaddingthefollowinglines
intheAtoll.inifile:
WhereXisthenumberofdigitsthattheCELL_IDENTITYfieldshouldcontain.Forexample,CellIDNbDigits=5meansthatAtoll
willdisplayatleastfivedigitsintheCELL_IDENTITYfieldbyaddingleadingzeroswhererequired.ThismeansthatAtollwill
display"00678"intheaboveexample.However,iftheCELL_IDENTITYfieldcontainsanumberthathasmorethanXdigits,all
thedigitswillstillbedisplayed.Forexample,allsevendigitsin"9376562"willstillbedisplayedevenifCellIDNbDigitsissetto
5.
12.1.2.12 MakingtheAntennaAdditionalElectricalDowntiltAccessible
By default, Atoll does not allow modification of the Additional Electrical Downtilt for transmitters, station templates,
repeaters,andremoteantennas.TomakethisparameteraccessibleintheGUI,addthefollowinglinesintheAtoll.inifile:
REDTDisplayissetto0bydefault.
[ St udi es]
Mul t i pl ePl ot sTi pText Li nes = X
[ SAModel ]
Dr awSi ngl eEl ement Pat t er n = 1
S
H
R
Avg
S

g
n
( ) S
H
R
Avg
S

[ St udi es]
Comment sI nLegend = 1
[ Di spl ay]
Cel l I DNbDi gi t s = X
[ Ant enna]
REDTDi spl ay = 1
191
12.1.2.13 IncreasingtheWidthoftheClutterDescriptionPaneintheStatusBar
You can increase the width of the clutter description pane in the Status bar (bottom right), to display the descriptions of
clutterclasseswithlongnames,byaddingthefollowinglinesintheAtoll.inifile:
ClutterPaneWidthissetto100bydefault,whichmeans100%ofitsdefaultwidth.Toincreasethewidthto,forexample,twice
theoriginalwidth,setClutterPaneWidthto200.
12.1.2.14 ChangingtheDefaultCacheLocationfortheLoadedMapTiles
ThemaptilesthatyouloadintoAtollarestoredinaspecificcachedirectorynamedafterthecorrespondingtileserver.By
default, the location of this cache is "%TEMP%\Forsk". You can change this location by adding the following lines in the
Atoll.inifile:
12.1.2.15 HidingtheTechnologyNameintheAtollTitleBar
Thenamesofthetechnologiescorrespondingtothecurrentactivedocumentaredisplayedinthetitlebar.Youcanhidethe
technologynamesbyaddingthefollowinglinesintheAtoll.inifile:
UseTechnoNameissetto1bydefault.
12.1.3 DistributedCalculationServerOptions
12.1.3.1 DetectingandListingDistributedCalculationServers
YoucanuseAtolltodetectdistributedcalculationserversandlistthemintheAtoll.inifile.Acomputer,servingasadistributed
calculationserver,canrunupto10instancesofAtollsvr,thedistributedcalculationapplication.Thedistributedcalculation
servernamescanbelistedintheAtoll.inifileinthefollowingformat:
HereServer1NameandServer2Namerefertothenamesofthecomputersbeingusedascalculationservers,andNisanumber
from0to9.Thismeans,forexample,thatServer1canrunupto10instancesofthedistributedcalculationapplication,and
alltheseinstancescanbelistedintheNumberedServersoption(Server1Name0;Server1Name1;Server1Name2;...).Using
thisoption,youcanassigndistributedcalculationserverstodifferentgroupsofusersworkingwithtwodifferentAtoll.inifiles.
Forexample,usergroup1canuseServer1Name0toServer1Name4,andgroup2canuseServer1Name5toServer1Name9.
Ifanerroroccursonanyofthedistributedcalculationservers,Atolltransfersthecalculationsbacktothelocalcomputer.
However,toavoidmemorysaturation,Atollusesonethreadonthelocalcomputerandcalculatesthepathlossmatricesone
byone.Itdoesnotattemptcreatingmorethanonethread.
12.1.3.2 SettingtheDistributedCalculationServerPriority
Bydefault,theAtolldistributedcalculationserver(AtollSvr.exe)runswithanormalprocesspriority.However,itispossible
tomodifyitspriority,inbothserviceandapplicationmodes,andsetithigherorlower.Youcandothisbyaddingthefollowing
Youcanchoosebetween4possibleprioritylevels:
1:BelowNormalpriority
0:Normalpriority
1:AboveNormalpriority
2:Highpriority
[ St at usBar ]
Cl ut t er PaneWi dt h = X
[ TMP]
Ti l esCachePat h = <new pat h>
[ DocTi t l e]
UseTechnoName = 0
[ Remot eCal cul at i on]
Number edSer ver s = Server1NameN; Server2NameN; . . .
At ol l Svr Pr i or i t y = - 1, 0, 1 or 2
192
Thisoptionworksforboth,applicationandservice,modesofthedistributedcalculationserver.
12.1.3.3 ModifyingtheDefaultDetectionTimeOut
Thedefaulttimeout(2seconds)forlocatingcalculationserverswithinthenetworkmightbetooshortincertaincases.You
canincreasethistimeoutbyaddingthefollowinglinestotheAtoll.inifile:
Inthisexample,thedetectiontimeoutissetto5000ms.
12.1.4 LicenceManagementOptions
12.1.4.1 SettinganAlarmfortheLicenceEndDate
Youcansetawarningmessageaboutthelicenceenddatetoappearacertainnumberofdaysbeforethisdate.TheAtoll.ini
fileshouldcontainthefollowinglines:
XisthenumberofdayspriortothetemporarylicenceenddateyouwantAtolltowarnyou.Whennoinformationisgivenin
theAtoll.inifile,Atollwarnstheuser30daysbeforethelicenceend.
12.1.4.2 BlockingAccesstoTechnologyModules
Thisoptionisusefulwhenworkingwithafloatinglicencemanagementsystemwhereafloatinglicenceservermanagesand
distributestokensbetweenseveralAtollusers.Thisoptioncanalsobeusefulinsettingdifferentlicencerightstousers.
Toblockaccesstothedifferenttechnologymodules,addthecorrespondinglinesinthe[License]sectionoftheAtoll.inifile:
YoucanalsoblockaccesstoGSM,UMTS,orLTEradioaccesstechnologiesin3GPPMultiRATdocumentsusingtheseoptions.
12.1.4.3 BlockingAccesstoACPandAFPModules
YoucanblockaccesstotheACPandAFPlicencesforusersorusergroups.ToblockaccesstoACPorAFPmodules,addthe
correspondinglinesinthe[License]sectionoftheAtoll.inifile:
The distributed calculation server (AtollSvr.exe) must be restarted in order to take
intoaccountthenewvaluefortheAtollSvrPriorityoption.
TheRealtimeprioritymodehasnotbeenimplementedforreasonsofstability.
Det ect Ti meOut = 5000
[ Li cense]
Ti meBombNot i ce = X
Toblockaccessto Add
GSMGPRSEDGE GSM=0
UMTSHSPA UMTS=0
CDMA2000 CDMA=0
TDSCDMA TDSCDMA=0
WiMAXandWiFi WiMAX=0
LTE LTE=0
MicrowaveRadioLinks MW=0
Backhaul BH=0
Measurements Measures=0
ACP_GSM = 0
ACP_UMTS = 0
ACP_LTE = 0
ACP_Wi MAX = 0
GSM_AFP = 0
LTE_AFP = 0
193
In order to carry out a combined GSM and UMTS optimisation using the ACP module, you must have access to both ACP
modulelicences,i.e.,ACP_GSMandACP_UMTSmustbothnotbesetto0.
InordertocarryoutaWiFioptimisationusingtheACPmodule,youmusthaveaccesstotheWiMAXACPmodulelicence,i.e.,
ACP_WiMAXmustnotbesetto0.
In order to carry out a WiFi frequency planning using the AFP module, you must have access to the WiMAX AFP module
licence,i.e.,WiMAX_AFPmustnotbesetto0.
12.1.4.4 ChangingtheNetHASPLicenceManagerIdleTimeSetting
Thefloatinglicencemanagerhasanidletimeparameterwith10minutesasdefaultvalue.Atollsessionsconsumingfloating
licencesfromalicencemanagerserverresetthisidletimeparametertoitsinitialvalueeveryminute.Ifyouareperforming
timeconsumingcalculationsonAtollconnectedtoafloatinglicenceserver,andconsumingalicence,itmightoccurthatAtoll
doesnotgetthechancetoresettheidletimevaluetoitsinitialvalue.Inthiscase,anewAtollsessioncanstealthelicence
actuallyallocatedtoanalreadyrunningsession.Thismightcauseproblemsinthecasewhereallthelicencesareused,the
Atollsessionperformingheavycalculationsdoesnotgetthechancetoinitialisetheidletimeparameterforitslicence,anda
new Atoll session is launched on another computer. In such a situation, the floating licence manager considers that the
alreadyrunningsessionhasbeeninactiveorclosed,andthelicenceallocatedtothealreadyrunningAtollsessionisallocated
tothenewsession.
Youcanmodifythedefaultidletimeparametervaluetoahighervaluetoavoidthiseffect.Tosetadifferentdefaultvaluefor
theidletimeparameter,addthefollowinglinestotheAtoll.inifile:
WhereXisthetimeinminutes.TheidletimecanbesettoinfinitybydefiningIdleTime=0.
12.1.5 DatabaseOptions
12.1.5.1 CheckingDataIntegrityAfterDatabaseUpgradeandDataRefresh
AtollasksyoutoperformadatabaseintegritycheckwhenyouopenanAtolldocumentconnectedtoadatabasethatwas
recentlyupgradedtoanewversion,orwhenyourefreshdatainanAtolldocumentfromthedatabase.Itisrecommededto
performtheproposeddataintegritycheck.
However,ifyoudonotwishtocheckthedataintegrity,addthefollowinglinesintheAtoll.inifile:
ControlIntegrityissetto1bydefault.
12.1.5.2 AutomaticallyRunningaDatabaseIntegrityCheckatOpenorRefresh
Thisoptionautomaticallyperformsadataintegritycheckwhenopeningadocumentfromadatabaseorrefreshingdatafrom
adatabase.Toturnthisfeatureon,youhavetoaddthefollowinglinesintheAtoll.inifile:
Ifthisoptionissetto1,AtollperformsSELECTfiltersinthedatabasetoguaranteedataintegrity.Thisfeatureenablesselection
directlyinthedatabaseinordertoavoidintegrityproblemsinthefuture.
12.1.5.3 AutomaticallyRunningGSMSubcellAuditatOpenorRefresh
ThefollowingoptionsautomaticallyperformsubcellauditwhenopeningaGSMdocumentfromadatabaseorrefreshingdata
fromadatabase.
Toautomaticallyaudittheconsistencyofredundantvaluesinthetransmitters,subcells,andTRXstableswithoutfixingany
problemsfound,addthefollowinglinesintheAtoll.inifile:
Wi MAX_AFP = 0
[ Li cense]
I dl eTi me = X
[ Ref r esh]
Cont r ol I nt egr i t y = 0
[ Dat abase]
I nt egr i t yChecker = 1
[ Dat abase]
SubCel l Audi t Consi st ency = 1
194
Toautomaticallyaudittheconsistencyofredundantvaluesinthetransmitters,subcells,andTRXstablesandfixanyproblems
found,addthefollowinglinesintheAtoll.inifile:
Toautomaticallyauditthecompatibilityofthemainsubcellvalueswithoutfixinganyproblemsfound,addthefollowinglines
intheAtoll.inifile:
Toautomaticallyauditthecompatibilityofthemainsubcellvaluesandfixianyproblemsfound,addthefollowinglinesinthe
Atoll.inifile:
SubCellAuditConsistencyandSubCellAuditMainValuesaresetto0bydefault.
12.1.5.4 ModifyingtheDefaultDatabaseConnectionTimeout
TheODBCdriverhasadefaultcommandtimeoutvaluewhichcouldbetooshortinsomecases,suchasslownetworks.You
canchangethisdefaulttimeoutvalueandsetahighervalueifyouencounterproblems,duringexecutionofcommandson
thedatabase,whichmightberelatedtotimeout.TochangethevalueofthecommandtimeoutparameteroftheODBCdriver,
Where X is the timeout value in an integer number of seconds. After X seconds, the command is considered too long to
execute.IfyousetCommandTimeout=0,therewillbenotimelimitfortheexecutionofthecommand.
12.1.5.5 MakingAtollCaseSensitiveforDatabaseImportFromPlanet
ThenetworkdataimportfromaPlanetdatabaseintoAtollisnotcasesensitivebydefault.Youcansetthisimporttocase
sensitivebyaddingthefollowinglinesintheAtoll.inifile:
Casesensitivemeansthat"Site0"willbeconsidereddifferentfrom"site0"duringimport.
12.1.5.6 SettingtheSignforK
Clutter
WhenImportingDataFromPlanetEV
PlanetEVusestheoppositesignfortheK
clutter
parameterwithrespecttoPlanetDMS.IfyouareimportingdatafromPlanet
EV,youmighthavetochangethesignofthisparameter.YoucaninstructAtolltochangethesignforK
clutter
whenimporting
datafromPlanetEVbyaddingthefollowinglinestotheAtoll.inifile:
ChangeKclutterSignissetto0bydefault.
12.1.5.7 Enabling/DisablingPasswordPromptatArchive
YoucaninstructAtolltoprompttheuserforpasswordbeforearchivingdatainadatabase.IfyouwantAtolltoasktheuser
toentertheusernameandpasswordonceperAtollsession,addthefollowinglinesintheAtoll.inifile:
PromptOnArchive=1isthedefaultsettingusedifthisoptionisnotprovidedintheAtoll.inifile.Theuserwillbepromptedfor
passwordwhenhetriestoarchivedatainthedatabaseforthefirsttimeduringanAtollsession.
IfyouwantAtolltoasktheusertoentertheusernameandpasswordforeveryrefreshandarchive,set:
[ Dat abase]
SubCel l Audi t Consi st ency = 2
[ Dat abase]
SubCel l Audi t Mai nVal ues = 1
[ Dat abase]
SubCel l Audi t Mai nVal ues = 2
[ Dat abase]
CommandTi meout = X
[ Pl anet I mpor t ]
Sensi t i veCase = 1
[ Pl anet I mpor t ]
ChangeKcl ut t er Si gn = 1
[ Dat abase]
Pr ompt OnAr chi ve = 1
195
Ifyouwanttodisablethepromptforpassword,set:
12.1.5.8 ArchivingDatatoDatabasesUsingTransactions
Atollsupportstransactionsforarchivingdatatodatabases.Thisapproachensuresthatusersalwaysgetconsistentdatawhen
refreshingtheirdocumentswithdatafromthedatabase,evenwhenanotheruserisarchivinghismodificationsatthesame
time.Bydefault,Atollusestransactionsforarchivingdata,howeveryoucandisablethetransactionmodeforAtollbyadding
thefollowinglinestotheAtoll.inifile:
UseTransactionissetto1bydefault.
12.1.5.9 KeepingSeparateWorkandMasterPathLossDirectories
Whensynchronisingamasterprojectwithaworkproject,thesharedpathlossdirectoryisalsoupdated.Thiscancausethe
workandmasterprojectstooverwriteeachotherssharedfolder.Fromanoperationalstandpoint,itisoftenpreferableto
keeptwodifferentpathlossdirectories:oneforthemasterprojectandasecondfortheworkproject.
Whenthe[OverwriteSharedFolderPath]optionissetto"0",Atolldoesnotoverwritethesharedpathlossdirectory.
12.1.5.10 EnablingPartialRefreshfromRecentlyUpgradedDatabases
WhenyouopenanAtoll2.8.xdocumentconnectedtoadatabasethathasbeenupgradedtoAtoll3.1.0,Atollautomatically
performsafullrefresh,i.e.,loadsallthedatafromthedatabase,whenupgradingthedocumenttothenewversion.Ifyou
wishtoenablepartialrefreshofdatafromtheupgradeddatabase(notrecommendedasitcancausedataintegrityproblems),
EnablePartialRefreshInMigrationissetto0bydefault.
12.1.5.11 SettingtheTypeofDatabaseBeingUsed
YoucansetthetypeofdatabasebeingusedbyaddingthefollowinglinesintheAtoll.inifile:
Whereprovidernamecanbe"Access","SQLServer",or"Oracle".Whenthisoptionisset,Atollusesthedefineddatabasetype
anddoesnotdisplaythedatabaseselectiondialoguethatappearswhencreatinganewdocumentfromanexistingdatabase
orwhenexportingadocumenttocreateanewdatabase.
UsernameandpasswordarestoredintheATLfileinanencryptedform.
Thisoptionisonlyappropriateifthedatabaseconnectionstringcontainsapassword.
[ Dat abase]
UseTr ansact i on = 0
Beforemodifyingthisoption,makesurethatthedatabaseserveriscorrectlyconfigured
fortransactions.
[ Dat abase]
Over wr i t eShar edFol der Pat h=0 # " 1" i s def aul t : pat h l oss di r ect or y i s over wr i t t en
[ Maj or Ver si onChange]
Enabl ePar t i al Ref r eshI nMi gr at i on = 1
[ Dat abase]
Excl usi vePr ovi der = providername
196
12.1.6 CommonCalculationOptions
12.1.6.1 SettingtheAntennaPatternsModellingMethod
Inordertosetthemodellingmethodforantennapatterns,theAtoll.inifilecancontainthefollowinginformation:
AngleCalculationvaluesof2000and3000areonlyvalidfortheForskspropagationmodellibrary,i.e.,thepropagationmodels
availablewithAtollbydefault.SettingAngleCalculation=2000makesthepropagationmodelscalculate"unmasked"path
losses, i.e., path losses without considering the transmitter antenna patterns. Setting AngleCalculation = 3000 makes the
propagationmodelscalculatetheanglesofincidencetoeachpixelinsteadofpathloss.
CatalogVerticalDiagramOrientationisonlyadisplayoption.Itenablesrepresentingtheantennasverticaldiagramwitha
certain orientation. Adjusting Catalog Vertical Diagram Orientation = 90, for example, will rotate the vertical diagram 90
clockwise.0correspondstothedefaultdisplay.
InterpolatePatternEvenIfOnlyOneDiagram can be used to change the way Atoll interpolates antenna pattern attenuation
diagrammes for antennas with only one diagramme available, vertical or horizontal. With
InterpolatePatternEvenIfOnlyOneDiagram = 0 (default, new method), Atoll uses the only diagramme available for both
vertical and horizontal planes. With InterpolatePatternEvenIfOnlyOneDiagram = 1 (previous method), Atoll uses the
diagrammeavailablefortheplanetowhichitcorresponds,verticalorhorizontal,andanisotropicdiagramme(a0 dBcircular
attenuationpattern)fortheplaneforwhichnodiagrammeisavailable.
InterpolatePatternIndBsets theunit used byAtoll whenitperformslinear interpolations on antennapatternattenuation.
WhenInterpolatePatternIndB=0(default),interpolationsarecalculatedinWatts.WhenInterpolatePatternIndB=1(orany
valueotherthan0),interpolationsarecalculatedindBleadingtostrongerantennapatternattenuation.
12.1.6.2 DisablingAutomaticLockingofCoveragePredictions
Bydefault,Atollautomaticallylocksacoveragepredictionstudyonceitiscalculated.ToinstructAtollnottolockprediction
studiesautomatically,theselineshavetobeincludedintheAtoll.inifile:
ThissettingisreadbyAtollwithoutAtollhavingtoberestarted.
12.1.6.3 EnablingShadowingMargininCalculations
Anaveragevalue ofshadowingmargin iscalculated byAtoll and applied tothe signal level and interferencelevelsduring
coverage predictions and other calculations such as point analysis, automatic neighbour allocation, automatic scrambling
codeandPNoffsetallocation,andinterferencematricescalculation.Thisaveragevaluedependsonthecelledgecoverage
probabilitythatyoudefineforthecalculationandthestandarddeviationsdefinedperclutterclass.
In the dialogues of all the abovementioned calculations, the Shadowing taken into account check box is not selected by
default.Notselectingthischeckboximpliesthattheshadowingmarginisneithercalculatednorusedinthecalculations.
IfyouwanttoselecttheShadowingtakenintoaccountcheckboxbydefaultinalltheabovementioneddialogues,youhave
toenterthefollowinglinesintheAtoll.inifile:
UseShadowingissetto0bydefault.
[ Ant enna]
Angl eCal cul at i on = 2000 or 3000
Cat al og Ver t i cal Di agr amOr i ent at i on = 0 or angl e val ue
I nt er pol at ePat t er nEvenI f Onl yOneDi agr am= 0 or 1
I nt er pol at ePat t er nI ndB = 0 or 1
[ St udi es]
Aut oLock = 0
[ Shadowi ng]
UseShadowi ng = 1
This option does not affect the shadowing margin calculation during Monte Carlo
simulations. Monte Carlo simulations do not use an average value of the shadowing
margindependingonthecelledgecoverageprobability.DuringMonteCarlosimulations,
randomshadowingmarginvaluesarecalculatedbasedonlyonthestandarddeviations
definedperclutterclass.
197
InUMTSHSPAandCDMA2000documents,youcanalsodeactivatethecalculationanduseofmacrodiversitygains.Formore
information,see"DisablingMacrodiversity(SHO)GainsinCalculations"onpage 206.
12.1.6.4 SettingaDefaultValuefortheCellEdgeCoverageProbability
ThedefaultvalueofthecelledgecoverageprobabilitycanbeconfiguredintheAtoll.inifile.Ifyouenterthefollowinglinesin
theAtoll.inifile,AtollwillconsiderthevalueofthecelledgecoverageprobabilitydefinedintheAtoll.inifileasthedefault
value,andwilltakeitintoaccountwhenperformingpointanalysis,intheshadowingmarginscalculator,andwillproposeit
asthedefaultvalueforcoveragepredictionstudies.
Reliability=60means60 %celledgecoverageprobability.
12.1.6.5 EnablingIndoorCoverageinCalculations
IndoorlossesaretakenintoaccountincalculationswhentheIndoorCoveragecheckboxisselected.Thischeckboxisnot
selectedbydefault.Ifyouwanttoselectthecheckboxbydefaultinthepropertiesdialoguesofallthecalculations,youhave
toenterthefollowinglinesintheAtoll.inifile:
IndoorActivityissetto0bydefault.
12.1.6.6 ModifyingtheResolutionfortheLOSAreaCalculationAroundaSite
Thecalculationoflineofsightareaaroundagivensiteusestheresolutionofthegeographicdataasthedefaultcalculation
resolution.Thesecalculationscanbetimeconsumingifthegeographicdataisavailablewithaveryhighresolution.Youcan
setthecalculationresolutiontoamultipleoftheresolutionofthegeographicdatabyaddingthefollowinglinesintheAtoll.ini
file:
WhereXisaninteger.Therefore,settingResolutionMultFactorto2willdoublethecalculationresolutionanddecreasethe
timerequiredforthecalculationbyhalf.
12.1.6.7 EmbeddingPathLossesinNewDocuments
Ifyoucalculatepathlossmatricesforanewdocumentthathasnotbeensavedyet,Atollasksifyouwouldliketosavethe
document and externalise the path loss matrices or if you would like to keep the path loss matrices embedded in the
documentandsaveitlater.YoucansuppressthismessagebyaddingthefollowinglinesintheAtoll.inifile:
EmbeddedByDefaultissetto0bydefault.
12.1.6.8 StoppingCalculationsonError
If a problem occurs in calculating one or more path loss matrices while calculating a coverage prediction, Atoll continues
performing the remaining calculations, and provides results even if they are not complete. If you want Atoll to stop the
calculationsifthereisanerror,youcanaddthefollowinglinesintheAtoll.inifile:
ContinueOnError=1bydefault.ThismeansthatbydefaultAtolldoesnotstopthecalculationsonerror.
[ Shadowi ng]
Rel i abi l i t y = 60
Thevalueofcelledgecoverageprobabilityusedforautomaticneighbourallocationand
interferencematricescalculationisstoredinuserconfigurationfiles(CFG).
[ Cl ut t er Par ams]
I ndoor Act i vi t y = 1
[ LOSAr ea]
Resol ut i onMul t Fact or = X
[ Pat hLosses]
EmbeddedByDef aul t = 1
[ St udi es]
Cont i nueOnEr r or = 0
198
12.1.6.9 WarningAboutPredictionValidityWhenDisplayOptionsareModified
Coveragepredictionshavetoberecalculatedifyoumodifytheirdisplayoptions.Atolldisplaysawarningmessagewhenyou
modifythedisplayoptionsforcoveragepredictions.Todeactivatethiswarningmessage,addthefollowinglinesintheAtoll.ini
file:
RecomputationWarningissetto1bydefault.
12.1.6.10 ReadingExactAltitudesFromtheDTM
AtolluseseithertheuserdefinedsitealtitudesfromtheSitestableor,iftheyarenotdefined,thesitealtitudesreadfromthe
DTMforthesitecoordinatesdefinedintheSitestable.However,transmitterscanbelocatedatcertaindistancesfromthe
sitecoordinates.YoucansetthesedistancesoftransmittersfromtheirsitesintheTransmitterstableunderDXandDY.
IfyouwantAtolltoconsidertheexacttransmittercoordinates,i.e.,includingDXandDY,duringcalculationsfordetermining
thetransmitterheight,whichwillbereadfromtheDTMattheexacttransmittercoordinates,youmustaddthefollowinglines
intheAtoll.inifile:
UseSiteAltitudeissetto1bydefault,whichmeansthatthealtitudeusedincalculationswillbetheonewhichiseitherread
fromtheSitestableorfromtheDTMatthesitescoordinates,iftheuserdefinedaltitudeisnotavailableintheSitestable.
Setting UseSiteAltitude to 0 means that, during calculations, Atoll will read the altitudes from the DTM at the exact
coordinatesofeachtransmitterconsideringthevaluesenteredfortheDXandDYparameters.
Theaboveoptionisalsovalidformicrowavelinks.Inthiscase,settingUseSiteAltitudeto0meansthat,duringcalculations,
AtollwillreadthealtitudesfromtheDTMattheexactcoordinatesofeachmicrowavelinkconsideringthevaluesenteredfor
theDX_A,DY_A,DX_B,andDY_Bparameters.
12.1.6.11 SettingaCommonDisplayResolutionForAllCoveragePredictions
Youcansetadisplayresolutionforeachcoveragepredictionindividuallyaswellasadefaultdisplayresolutionforallcoverage
predictionsthatyoucreate,inthePredictionstabofthePredictionsfoldersPropertiesdialogue.Ifyoucreateanewcoverage
prediction,AtollreadsthedefaultresolutionfromthePredictionsfoldersPropertiesdialogueandsetsthatasthedisplay
resolutionforthenewcoverageprediction.Then,ifyoudeletethisresolutionfromthecoveragepredictionproperties,and
donotenteranyresolution,Atollresetstheresolutiontothedefaultvalue.Inthisway,eachcoveragepredictionhasadisplay
resolution defined. However, it is possible to manage a common display resolution for all coverage predictions, new or
existing,thatdonothavearesolutiondefinedforthem.Youcanswitchtothisoptionbyaddingthefollowinglinesinthe
Atoll.inifile:
OnceSpecifyResolutionAfterComputationissetto0,Atollnolongerresetstheresolutiontothedefaultvalueforcoverage
predictions that do not have a resolution defined. Atoll allows you to leave the field empty in the coverage prediction
properties,anddirectlyreadsthedefaultresolutiondefinedinthePredictionsfoldersPropertiesdialogue.Inthisway,when
you create coverage predictions without defining resolutions for them, you can modify the default resolution of the
PredictionsfoldersPropertiesdialogueand,therefore,changethedisplayresolutionforallthecoveragepredictions,newor
existing.
To return to the normal working, you can either remove the lines from the Atoll.ini file, or set
SpecifyResolutionAfterComputationto1.
12.1.6.12 SettingthePrioritiesforGUIandCalculations
YoucansettheprioritiesforuserinterfaceandcalculationsthroughthefollowingoptionintheAtoll.inifile:
[ St udi es]
Recomput at i onWar ni ng = 0
[ Cal cul at i ons]
UseSi t eAl t i t ude = 0
WithUseSiteAltitude=0,ifDXandDYare0,i.e.,fortransmittersandmicrowavelinks
locatedatthesitecoordinates,Atollwillstillusethealtitudesdefinedpersite,ifany,or
thealtitudesfromtheDTMotherwise
[ St udi es]
Speci f yResol ut i onAf t er Comput at i on = 0
199
Priorityenablesyoutosettheprioritybetweencalculationsanduserinterface.
0:Userinterfacehasthehighestpriority.
1(default):Userinterfacehasahigherprioritythancalculations.
2:Userinterfaceandcalculationshavethesamepriority.
12.1.6.13 SettingtheNumberofParallelProcessorsandThreads
YoucanmanagethenumberofprocessorsandthreadsthroughtheAtoll.inifile.Thefileshouldcontainthefollowingoptions:
Maximumnumberofprocessors:
NumberOfProcessorsisthemaximumnumberofprocessorsthatcanbeusedforcalculations.Ifyousetthisoptionto
0,Atollwilluseactualnumberofavailableprocessors.
Maximumnumberofcalculationthreads:
NumberOfThreadsPathloss is the maximum number of threads that can be used for path loss calculations (4 by
default,8maximum)
NumberOfThreadsSimulation is the maximum number of threads that can be used for Monte Carlo simulation
calculations(4bydefault,8maximum)
NumberOfThreadsStudy is the maximum number of threads that can be used for the calculation of coverage
predictions(4bydefault,8maximum)
NumberOfThreadsStudyTileisthemaximumnumberofthreadsthatcanbeusedpercoveragepredictioncalculation
(0bydefault,8maximum).Ifyousetthisoptionto0or1(recommended),Atollwilluseonethreadforthecalculation.
NumberOfThreadsNeighbouristhemaximumnumberofthreadsthatcanbeusedforautomaticneighbourallocation
(4bydefault,8maximum)
NumberOfThreadsMicrowaveisthemaximumnumberofthreadsthatcanbeusedformicrowavelinkcalculations(4
bydefault,8maximum)
Alltheseoptionsareupperlimitspercomputer.Atollsupportsamaximumof64parallelthreads.
12.1.6.14 DisablingParallelCalculationofMonteCarloSimulations
For UMTS HSPA and CDMA2000 1xRTT 1xEVDO documents, Atoll can perform multithread calculations of Monte Carlo
simulations.Ifyouwanttodisabletheparallelcalculation,addthefollowinglinestotheAtoll.inifile:
ParallelSimulationsissetto1bydefault.
TheparallelcalculationofMonteCarlosimulationsinTDSCDMA,WiMAX,LTE,andWiFidocumentsisdisabledbydefault.It
shoudnotbeenabledinTDSCDMAdocuments.
12.1.6.15 PerformingCalculationsinReadOnlyDocuments
Bydefault,whenyouopenareadonlyAtolldocument,itisnotpossibletoruncalculationsinit.Ifyouwanttoruncalculations
inreadonlydocuments,youwillhavetoaddthefollowinglinesintheAtoll.inifile:
Pr i or i t y = 0, 1, or 2
Number Of Pr ocessor s = X
Number Of Thr eadsPat hl oss = 1, 2, . . . , or 8
Number Of Thr eadsSi mul at i on = 1, 2, . . . , or 8
Number Of Thr eadsSt udy = 1, 2, . . . , or 8
Number Of Thr eadsSt udyTi l e = 0, 1, 2, . . . , or 8
Number Of Thr eadsNei ghbour = 1, 2, . . . , or 8
Number Of Thr eadsMi cr owave = 1, 2, . . . , or 8
[ CDMA]
Par al l el Si mul at i ons = 0
TheGeneratorInitialisationmustbesetto0inorderforthesimulationstobecalculated
inparallel.
[ St udi es]
200
IfyouopenadocumentthatisalreadyopeninanotherAtollsession,Atollletsyouopenthedocumentasreadonly.
12.1.6.16 IdentifyingTransmitter,Repeater,andRemoteAntennaCoverageAreas
InGSMGPRSEDGE,UMTSHSPA,LTE,andWiMAXdocuments,youcancreatea"CoveragebyAerial"signallevelcoverage
predictionforseparatecoverageareasoftransmittersandtheirrepeatersandremoteantennas.
InordertomakethiscoveragepredictionavailableinAtoll,addthefollowinglinesintheAtoll.inifile:
12.1.6.17 ChangingtheRoundingMethodUsedforProfileExtraction
BeforeAtoll2.8.0,realvaluesforaltitudesreadfromtheDTMfileswereroundeddowntotheirintegervalues.However,from
Atoll2.8.0 onwards, real values are rounded up or down to their nearest integer values. For example, using the previous
method,98.8 mwasroundedto98 m,butwiththenewmethod,itisroundedto99 m.Ifyouwanttoswitchbacktothe
previousmethod,addthefollowinglinesintheAtoll.inifile:
RoundAltitudesissetto1bydefault.
12.1.6.18 EstimatingRequiredandUsedMemorySizeforUMTSSimulations
AtollcanestimatetherequiredandusedmemorysizesforUMTSsimulationsanddisplaytheestimatesintheSourceTraffic
tabofthenewsimulationgroupdialogue.Estimatedmemorysizewithinthegreenregionmeanslowconsumption,within
theyellowregionmeansmediumconsumption,withintheorangeregionmeanshighconsumption,andwithintheredregion
meansveryhighconsumption,inwhichcasethesimulationsmightgenerateanoutofmemoryerrorandnotcomplete.
Toactivatethememoryestimationfeature,addthefollowinglinesintheAtoll.inifile:
PredictSimuMemorySizeissetto0bydefaultwhichmeansthefeatureisnotactive.
12.1.6.19 DisablingCalculationsOverNoDataValuesforDTMandClutterClasses
IfyoudontwantAtolltocalculatepathlossesonthepixelslocatedovernodatavaluesdefinedintheDTMandclutterclasses
files,addthefollowinglinesintheAtoll.inifile:
Bydefault,OptimOnNoDataissetto0.ThisoptiononlyworkswiththepropagationmodelsavailablewithAtollbydefault.
12.1.6.20 CoPlanning:CalculatingPredictionsintheCurrentDocumentOnly
Atoll calculates all the unlocked coveragepredictions inthePredictions folder of the currentdocument andtheunlocked
coveragepredictionsinthelinkedPredictionsfolderfromanotherdocumentwhenyouclicktheCalculatebutton,pressF7,
or select the command from a context menu in the current document. If you want Atoll to calculate only the unlocked
coveragepredictionsinthePredictionsfolderofthecurrentdocument,andnotinthelinkedPredictionsfolderfromanother
document,addthefollowinglinesintheAtoll.inifile:
ComputeLinkedPredictionsissetto1bydefault.
Comput eEvenI f ReadOnl y = 1
[ St udi es]
Aer i al St udy = 1
[ Cal cul at i ons]
RoundAl t i t udes = 0
[ CDMA]
Pr edi ct Si muMemor ySi ze = 1
[ FskPr opagModel s]
Opt i mOnNoDat a = 1
[ CoPl anni ng]
Comput eLi nkedPr edi ct i ons = 0
201
12.1.6.21 CoPlanning:CalculatingPredictionsinSerialorinParallel
IfyouwantAtolltocalculateinparalleltheinvalidorunavailablepathlossmatricesandunlockedcoveragepredictionsinthe
PredictionsfolderofthecurrentdocumentandthelinkedPredictionsfolderfromanotherdocument,addthefollowinglines
intheAtoll.inifile:
LinkedPredictionsComputationMode is set to Serialized by default, which means the path loss matrices and unlocked
coveragepredictionsinthecurrentandlinkeddocumentsarecalculatedinserial.
IfyousetLinkedPredictionsComputationModetoanyothervalue,thecalculationsareperformedinparallelbutwithoutbeing
managedbyatasklist.
CalculationsarecarriedoutstartingwiththecurrentdocumentintheorderofthecoveragepredictionsinthePredictions
folder.
12.1.6.22 ForcingNeighbourSymmetryOnlyInsideFocusZone
AtollcarriesoutautomaticneighbourallocationontransmitterslocatedinsidetheFocusZone(ortheComputationZoneif
theFocusZonedoesnotexist).WhenyourunanautomaticneighbourallocationwiththeForceSymmetryoptionselected,
Atollmakescalculatedneighbourrelationssymmetricaleven ifoneofthetransmitterintheneighbourrelationislocated
outsidetheFocusZone.IfyouwantAtolltomakeonlythoseneighbourrelationssymmetricalforwhichbothtransmittersin
theneighbourrelationarelocatedinsidetheFocusZone,addthefollowinglinesintheAtoll.inifile:
ForceSymmetryInFocusZoneissetto0bydefault.
12.1.6.23 UsingPoissonDistributioninMonteCarloSimulations
By default, mobiles are generated in each simulation following a Poisson distribution. This means that there are small
variationsinthenumberofrandomlydistributedmobilesfromonesimulationtoanother.Todisablethistypeofdistribution,
i.e.,tohavethesamenumberofmobilesgeneratedineachsimulationofagroup,addthefollowinglinesintheAtoll.inifile:
Bydefault,RandomTotalUsersissetto1.
12.1.6.24 CalculatingEIRPfromMaxPowerinSignalLevelPredictions
Atoll calculates the EIRP from the pilot power in UMTS and CDMA2000, and reference signal power in LTE. If you wish to
calculatetheEIRPfromtheMaxPowervalueswhencalculatingsignallevelbasedcoveragepredictions,addthefollowing
Bydefault,EIRPfromMaxPowerissetto0.
This option applies to Coverage by Transmitter, Coverage by Signal Level, and Overlapping Zones predictions in UMTS,
CDMA2000,andLTE.
12.1.6.25 ExcludingFilteredTransmittersfromtheListofNeighbours
Bydefault,Atollincludesfilteredtransmittersinthelistofneighbours.Ifyouwishtoexcludefilteredtransmittersfromthe
listofneighbours,addthefollowinglinesintheAtoll.inifile:
Bydefault,ExcludeFilteredCellsFromNeighbourListsissetto0.
[ CoPl anni ng]
Li nkedPr edi ct i onsComput at i onMode = Par al l el i zed
[ Nei ghbour s]
For ceSymmet r yI nFocusZone = 1
[ Si mul at i on]
RandomTot al User s = 0
[ St udi es]
EI RPf r omMaxPower = 1
[ Nei ghbour s]
Excl udeFi l t er edCel l sFr omNei ghbour Li st s = 0 ( def aul t )
202
12.1.6.26 ChangingtheWeightingFactoroftheEffectiveIntertransmitterDistance
Bydefault,theweightingfactoroftheeffectiveintertransmitterdistanceisset0.3.Tochangethisweightingfactor,addthe
12.1.6.27 EnablingandDisablingPersitePathLossMatrixCalculations
Atollcalculatespathlossmatricesofcolocatedcositetransmittersinasinglestep,i.e.,persite,insteadofcalculatingeach
transmittersmatrixseparately.Youcandisablepersitecalculationofpathlossmatricesbyaddingthefollowinglinesinthe
Atoll.inifile:
DisablePathlossPerSiteCalculationissetto0bydefaultforAtoll64bitandto1forAtoll32bit.
12.1.7 GSMGPRSEDGEOptions
12.1.7.1 ConsideringOverlappingZonesforIMCalculationBasedonTraffic
When calculating interference matrices based on traffic, overlapping between coverage areas of different transmitters is
taken into account when the option "Best Server" is selected and a positive margin is defined. For interference matrices
calculation based on "All" the servers (not Best Server), Atoll does not consider the overlapping to improve performance.
However,youcaninstructAtolltoconsidertheoverlappingduringthesecalculationsaswellbyaddingthefollowinglinesin
theAtoll.inifile:
12.1.7.2 SettingtheDefaultBSICFormat
YoucansetthedefaultBSICformattobeusedbyAtollbyaddingtheselinesintheAtoll.inifile:
DefaultValueenablesyoutochangethedefaultBSICformat(Octalbydefault)whenyoucreateanewAtolldocument.
12.1.7.3 SelectingtheInterferenceMatricesUsedDuringtheAFP
AllactiveinterferencematricesaretakenintoaccountduringanAFPsessionaccordingtothemethoddefinedintheAtoll.ini
file:
ThisoptionisvalidforForsksAFP.
1referstothedefaultmethod,whichistheworstcaseone.Settingthisvalueto0willinstructtheAFPtousethesecond
method.
Worst Case Method: For each interference matrix relationship, the worst case value in all the active interference
matricesistakenintoconsideration.
FirstValueMethod:Foreachinterferencematrixrelationship,thefirstvaluefoundinanyactiveinterferencematrix
istakenintoconsideration.Theorderinwhichtheinterferencematricesarescannedtofindthefirstvalueistheorder
oftheinterferencematricesintheInterferenceMatricesfolderintheNetworktab,i.e.thefirstIMistheoneatthe
top.
[ Nei ghbour s]
Di st anceAzi mut Wei ght i ngPer cent = 0. 3 ( def aul t )
Ifthevalueyousetistoohigh(e.g.0.7),theresultingintertransmitterdistancecanbe
negative.Insuchacase,nothingwillbedisplayedinthecorrespondingtablecell.
Di sabl ePat hl ossPer Si t eCal cul at i on = 1
[ Feat ur es]
I M_TRAFFI C_OVERLAP = 1
[ Bsi cFor mat ]
Def aul t Val ue = 1 f or Oct al or 0 f or Deci mal f or mat
[ AFP]
Wor st CaseI M_FskAf p = 0 or 1
203
TheFirstValuemethodwasthedefaultmethodinearlierversionsofAtollwhichallowedmultipleinterferencematriximport.
12.1.7.4 DefiningtheMaximumNumberofTransmittersforReuseDistance
WhenusingthereusedistancewiththeAFP,youcanlimitthenumberofrelationsbasedondistancetakenintoconsideration
foreachtransmitterinordertoensurethatperformanceisnotdegraded.Inthisexample,thenumberislimitedto70:
12.1.7.5 CheckingDatabaseConsistencyAutomatically
IfyouwantAtolltoautomaticallyperformabasicdataconsistencychecktoavoidincompatibilitybetweenredundantfields
inGSMGPRSEDGEdocuments,addthefollowinglinestotheAtoll.inifile:
Bydefault,thisoptionisconsideredtobesetto0,whichimprovesAtollsperformance.
If this option is set to 1, Atoll updates the values of the fields "Number of TRXs" and "Channels" in the Table tab of the
TransmittersfoldersPropertiesdialoguewiththevaluesfromtheTRGsandtheTRXstablesrespectively,whenadocument
isopenedfromadatabaseorrefreshed.
12.1.7.6 DisablingtheMaximumRangeParameter
Themaximumcellrangeparameter(SystemframeintheNetworkSettingsfoldersPropertiesdialogue)inGSMGPRSEDGE
documentsisusedbydefaultandsetto35 km.YoucandisablethisoptionbyaddingthefollowinglinesintheAtoll.inifile:
Ifyousetthisoptiontoanythingotherthan"No",Atollwillusethemaximumrangeparameterandsetittothedefaultvalue
of35 km.
12.1.7.7 EnablingtheSupportforMultibandTransmitters
Atolliscapableofmodellingtransmitterswithsubcells(TRXgroups)belongingtodifferentfrequencydomains.Toturnonthe
multibandmodellingfeature,addthefollowinglinesintheAtoll.inifile:
MultiBandManagementissetto0bydefault.Enablingmultibandmanagementallowstheuserstoaccessthemultiband
management features through the Frequency Band Propagation button under the Subcells section of the TRXs tab of a
transmittersPropertiesdialogue,andthroughtheSubcells>MultiBandPropagationParameterscommandinthecontext
menuoftheTransmittersfolder.
IntheMultiBandPropagationParameterstableandinthedatabase,Atollusesthe"@"charactertoidentifythemultiband
transmitters.Therefore,ifyouareworkingonadocumentwithmultibandtransmitters,andyouhavethe"@"characterin
thenamesofrepeaters,remoteantennas,orsubcellswithoutadonor/maintransmitter,Atolldeletestheserecordswhen
opening the document from a database. If you do not want Atoll to automatically delete such records when opening the
documentfromadatabase,youhavetosettthefollowingoptionintheAtoll.inifile:
RemoveBadMultiCellsissetto1bydefault.
If you are not working with multiband transmitters, i.e., MultiBandManagement is set to 0, Atoll does not automatically
deletesuchrecords.IfyouwantAtolltoautomaticallydeletesuchrecordswhenopeningthedocumentfromadatabase,you
havetosettthefollowingoptionintheAtoll.inifile:
CleanMultiCellManagementissetto0bydefault.
[ AFP]
Gl obal Di st anceMat r i xDegr eeUB=70
[ Ref r esh]
TRXI nt egr i t y = 1
[ Per f os]
MaxRangeAppl i ed = No
[ St udi es]
Mul t i BandManagement = 1
[ St udi es]
RemoveBadMul t i Cel l s = 0
[ St udi es]
Cl eanMul t i Cel l Management = 1
204
12.1.7.8 SettingtheBestServerCalculationMethodinSamePriorityHCSLayers
AtollcancalculateservingtransmittersaccordingtoHCSlayerprioritiesincoveragepredictions.Thesignallevelreceivedfrom
theservingtransmittermustbehigherthantheminimumreceptionthreshold( )foritsHSClayer.
IftherearetwoHCSlayerswithdifferentpriorities:
TheservingtransmitteristheonethatbelongstotheHCSlayerwiththehighestpriority.
IftherearetwoHCSlayerswiththesamepriority:
1ststrategy:Theservingtransmitteristheoneforwhichthedifferencebetweenthereceivedsignalleveland
isthehighest.Where, istheminimumreceptionthresholdfortheHSClayerofeachrespectivetransmitter.
2ndstrategy:Theservingtransmitteristheonewhichhasthehighestreceivedsignallevel.
Thedefaultstrategyisthe1stone.Youcanusethe2ndstrategybyaddingthefollowinglinesintheAtoll.inifile:
UseThresholdForSameLayerPrioritiesissetto1bydefault.
12.1.7.9 HidingAdvancedAFPParameters
YoucanhidetheadvancedparametersfromtheAtollAFPPropertiesdialoguebyaddingthefollowinglinesintheAtoll.inifile:
SimpleUserGUIissetto0bydefault.SettingSimpleUserGUIto1hidestheInterferenceMatrices,MAIO,andAdvancedtabs.
12.1.7.10 HidingViolationsBetweenLowImportanceNeighboursinAFPResults
Bydefault,eachneighbourpairhasanimportancevaluewhichdefinesthequality(andtherank)oftheneighbourlink.This
importancecanbeevaluatedduringtheautomaticneighbourallocation,aspecificcalculationprocessormanuallypopulated
in the neighbour tables. In the Allocation tab of the AFP results dialogue, no difference is made between high and low
importanceneighboursintermofviolationdisplay.Inotherwords,whatevertheimportancevalueis,anyneighbourlinkina
separationviolationissystematicallydisplayedinaspecificcolour.Youcanavoiddisplayingseparationviolationsbetween
lowimportanceneighboursinaspecificcolourbyaddingthefollowinglinesintheAtoll.inifile:
WhereXXistheminimumimportanceforaneighbourpairtobeconsideredaspotentiallyviolated.
12.1.7.11 HidingViolationsBetweenNonSynchronisedMALsMAIOsinAFPResults
In SFH, one can call synchronised MALsMAIOs the case where, assuming the synchronisation site and the HSN can be
identifiedovertheentiredurationofaGSMframe.Asanexample,whenthesynchronisationsite,theHSNandtheMALlength
of 2 MALsMAIOs are identical, it is always possible to identify if these are or not in separation violation. In case the
synchronisationsite,theHSNand/ortheMALlengthsor2MALsMAIOsaredifferent,acertainprobabilityofcollision(and
consequentlyaseparationviolation)mayoccur.
You can avoid displaying separation violations between nonsynchronised MALsMAIOs in a specific colour by adding the
ShowNonSynchSFHViolationsInAFPResultsissetto1bydefault.SettingShowNonSynchSFHViolationsInAFPResultsto0does
notshownonsynchronised(MALsMAIOs)possiblyinaseparationviolationcase.
[ St udi es]
UseThr eshol dFor SameLayer Pr i or i t i es = 0
T
Rec
HCS
T
Rec
HCS
T
Rec
HCS
[ AFP]
Si mpl eUser GUI = 1
[ GSM]
Mi nNei ghbour I mpor t anceI nAFPResul t s = XX
ThevalueintheAtoll.inifilehastobebetween0and100whereastheimportancevalue
intheneighbourstablesisbetween0and1.
[ GSM]
ShowNonSynchSFHVi ol at i onsI nAFPResul t s = 0
205
12.1.7.12 MakingRedundantFieldsintheTransmittersTableReadonly
SomeofthefieldsintheTransmitterstableareredundantwithotherfieldsintheSubcellstable.Modifyingvaluesinonetable
mightcauseinconsistenciesbetweenthetwotablesinsomecases.Youcanmaketheseredundantfieldsuneditableinthe
TransmitterstablebyaddingthefollowinglinesintheAtoll.inifile:
TheredundantfieldsintheTransmitterstablearetheBCCHandtheNumberofTRXsfields.
CanEditTRXInfoAtTXLevelissetto1bydefault,whichmeansthatthefieldsareeditable.
12.1.7.13 SettingtheTransmissionDiversityGain
Ifasubcellisusingtransmissiondiversity,theaircombininggainof3 dBisappliedtoallthereceivedsignallevels,wanted(C)
aswell asinterfering(I), duringcalculations.Youcan modifythedefault valueof3 dB by addingthe following lines in the
Atoll.inifile:
WhereXisthevalueoftheaircombininggainindB.
12.1.7.14 AddingGroupedHCSServersOptioninCalculations
Bydefault,theGroupedHCSServersoptionisnotavailableinthelistofchoicesforServerincoveragepredictions,traffic
capture,andinterferencematrixcalculations.Tomakethisoptionavailable,addthefollowinglinesintheatoll.inifile:
12.1.7.15 DeactivatingFrequencyBandFilteringinIMCalculation
Whencalculatinginterferencematrices,Atollfilterspotentialinterferersbasedonthefrequencybandsusedbytheinterfered
and interfering subcells. For example, if the interfered subcell uses the GSM900 band and a potential interferer uses the
GSM1800band,andthetwobandsdonotoverlap,thenthispotentialinterfererisignored.Thisfilteringhelpsimprovethe
calculationperformancebyignoringtheinterferedinterfererpairsthatwouldhaveeventuallyresultedinnoIMentryafter
thecalculation.Anyinterfererwhoseassignedfrequencybandoverlapswiththefrequencybandassignedtotheinterfered
subcellisnotfiltered.
YoucandeactivatethisfilteringbyaddingthefollowinglinesintheAtoll.inifile:
FilterByFrequencyBandsissetto1bydefault.
12.1.7.16 StartingTRXIndexesat1
Bydefault,TRXsareindexedbyAtollstartingatindex0.Ifyouwishtostarttheindexingat1,addthefollowinglinesinthe
Atoll.inifile:
FirstTRXIndexissetto0bydefault.SettingFirstTRXIndextoanyothervaluehasthesameeffectassettingitto1.
12.1.7.17 HidingtheTRXIndex
IfyouwishtohidetheTRXindexcolumn,addthefollowinglinesintheAtoll.inifile:
TRXIndexHiddenissetto0bydefault.
[ GSM]
CanEdi t TRXI nf oAt TXLevel = 0
[ St udi es]
2GTxDi ver si t yGai n = X
[ TMP]
Ext r aSer vZone = 1
[ I M]
Fi l t er ByFr equencyBands = 0
[ GSM]
Fi r st TRXI ndex = 1
[ GSM]
TRXI ndexHi dden = 1
206
12.1.7.18 ExtendingtheAllowedValueRangeforC/IandReceptionThresholds
CurrentlythesubcellC/Ithresholdallowsvaluesfrom0to24 dBandthereceptionthresholdallowsvaluesfrom116to
50 dBm.Ifyouwishtoextendthisrangeto30 dBand134 dBmfortheC/Iandreceptionthresholdsrespectively,addthe
WideRangeSubcellThresholdsissetto0bydefault,whichcorrespondstothedefaultvalueranges.
12.1.7.19 AutomaticallyCorrectingOutofrangeSubcellValues
WhenoutofrangesubcellvaluesarefoundintheGSMnetwork,Atollfixesthembydefaultasfollows:
Ifyouwishtomodifythisdefaultbehaviour,addthefollowinglinesintheAtoll.inifile:
SubcellValueFixMethodissetto0bydefault,whichcorrespondstothedefaultbehaviourdescribedabove.
Ifyousetthisparameterto1,thevaluescurrentlyoutofrangeareshiftedtotheclosestboundaryoftheauthorisedrange.
Forexampleifthereceptionthresholdislessthan116dBm,itwillbereplacedby116dBminsteadof102dBmasinthe
defaultbehaviour.Likewise,ifitisgreaterthan50dBm,itwillbereplacedby50dBminsteadof102dBm.
12.1.8 UMTSHSPA,CDMA2000,andTDSCDMAOptions
12.1.8.1 SuppressingCellNameCarrierSuffixes
Itisonlypossibletosuppressthecarriersuffixina3Gcellnameinthecaseofasinglecarrierscenario,i.e.,thefirstcarrieris
alsothelastcarrierintheglobalparameters.Todothis,addthefollowinglinesintheAtoll.inifile:
Thisissetto0bydefault,whichmeansthatcellnameswillfollowthenormalconventionofAtoll,SiteN_X(C).Ifthereisonly
onecarrier,meaningthatCisunique,thenthisoptioncanbesetto1.Thiswillresultincellnameswhichwillbesameasthe
transmitternames,SiteN_X.
12.1.8.2 DisablingMacrodiversity(SHO)GainsinCalculations
InUMTSHSPAandCDMA2000documents,macrodiversitygainsarecalculatedforpilotEc/Io,andDLandULEb/Ntbasedon
therespectivestandarddeviations.Youcandeactivatethecalculationanduseofmacrodiversitygainsinallthecalculations
byaddingthefollowinglinesintheAtoll.inifile:
[ GSM]
Wi deRangeSubcel l Thr eshol ds = 1
SubcellValue Ifitis... ...thenitisreplacedby:
NumberofrequiredTRXs <1or>62 1
NumberofrequiredBCCHs not1 1
Trafficload <0or>1 1
Receptionthreshold <116dBmor>50dBm 102dBm
MinimumC/I >25 dB 12dB
Halfratetrafficratio <0%or>100% 40%
Meanpowercontrolgain <0dBor>32dB 4dB
DLpowerreduction <0dBor>25dB 0dB
AFPweight <0or>100 1
Targetrateoftrafficoverflow <0%or>100% 0%
Maximumpercentageofinterference <1%or>100% 1%
MaximumMALsize >62 62
[ GSM]
Subcel l Val ueFi xMet hod = 1
[ 3GCel l s]
NoSuf f i xI f Uni queCar r i er = 0 or 1
[ Shadowi ng]
207
WithSHOGainissetto1bydefault.
Ifyouwish,youcandeactivatethemacrodiversitygaincalculationforthepilotEc/Ioonlybyaddingthefollowinglinesinthe
Atoll.inifile:
AddPilotSHOGainissetto1bydefault.
12.1.8.3 CalculatingandDisplayingPeakorInstantaneousHSDPAThroughput
InUMTSHSPAdocuments,youcanchoosetodisplayandworkwitheitherpeakvaluesorinstantaneousvaluesoftheHSDPA
throughputspermobile,cell,andsiteinsimulationresults.Todothis,youcanaddthefollowinglinesintheAtoll.inifile:
0:Instantaneousthroughput(Default)
1:Peakthroughput
IfyouchoosetodisplaytheinstantaneousHSDPAthroughputs,Atollwill:
DisplaythenumberofsimultaneousHSDPAusersinthesimulationresults.
PlaceacertainpartofHSDPAusersinawaitingqueueduringsimulations.
Display the instantaneous gross and instantaneous application level throughputs per mobile and per cell in the
simulationresults.
DisplaytheinstantaneousthroughputpersiteintheSitestabofthesimulationresults.
IfyouchoosetodisplaythepeakHSDPAthroughputs,Atollwill:
NotdisplaythenumberofsimultaneousHSDPAusersinthesimulationresults.
Displaythepeakgrossandpeakapplicationlevelthroughputspermobileandpercellinthesimulationresults.
DisplaytheMUGtableinthecellproperties.Inputfromthisareusedtocalculatethepeakgrossthroughputpercell
whentheschedulingalgorithmis"ProportionalFair".
DisplaytheaverageHSDPAthroughputperuserintheCellstabofthesimulationresults.
HSDPA resource scheduling will not be carried out. The HSDPA throughput for each user will be calculated by taking into
accounttheMUGcorrespondingtothecurrentnumberofconnectedHSDPAusers.
InAverageSimulationresults,theaverageHSDPAthroughputperusercanbecalculatedexcludingthesimulationswhereno
HSDPAuserswereserved.Todothis,enterthefollowinglinesintheAtoll.inifile:
HSDPAAvgSimuResults=0bydefault.
12.1.8.4 SettingthePowertoUseforIntracellInterferenceinHSDPA
InHSDPApredictionstudies,youcanchoosewhethertoperformintracellinterferencecalculationsbasedontotalcellpower
(Ptot)ormaximumcellpower(Pmax).Bydefault,Atollperformsthiscalculationbasedonthetotalpower.Youcaninstruct
AtolltousemaximumpowerinsteadbyaddingthefollowinglinesintheAtoll.inifile:
0:Intracellinterferencecalculationbasedontotalpower(Default)
1:Intracellinterferencecalculationbasedonmaximumpower
12.1.8.5 EnablingCoveragePredictionsofConnectionProbabilities
YoucanperformcoveragepredictionstudiesforconnectionprobabilitiesinUMTSHSPAdocumentsbyaddingthefollowing
Wi t hSHOGai n = 0
[ CDMA]
AddPi l ot SHOGai n = 0
[ CDMA]
HSDPAThr oughput Peak = 0 or 1
[ CDMA]
HSDPAAvgSi muResul t s = 1
[ CDMA]
PmaxI nI nt r aI t f = 1
[ CDMA]
UseSt udyCnxPr oba = 1
208
ThiscoveragepredictionstudyisavailableinthelistofpredictionstudiesifUseStudyCnxProbaissetto1.Otherwise,itwill
notbeavailable.MinUsersPerBinistheminimumnumberofusersperpixelrequiredforthatpixeltobetakenintoaccount
inthecoverageprediction.
12.1.8.6 SettingtheCalculationMethodforHSPDSCHCQI
IfyouchoosetheCQIbasedonCPICHqualityoptioninGlobalParameters,youcanselecttheformulausedforcalculating
HSPDSCHCQIinAtollbyaddingthefollowinglinesintheAtoll.inifile:
CQIDeltaWithPowerissetto1bydefault.IfyousetCQIDeltaWithPowerto0,theHSPDSCHCQIwillbecalculatedusingthe
formula:
IfyousetCQIDeltaWithPowerto1,theHSPDSCHCQIwillbecalculatedusingtheformula:
TheaboveequationsareindB.RefertotheTechnicalReferenceGuideformoredetails.
12.1.8.7 EnablingOrthogonalityFactorinPilotE
C
/N
T
CalculationinHSDPA
%PilotFingerandtheOrthogonalityFactormodeltwodifferenteffectsontheCPICHquality.%PilotFingerisrelatedtothe
CPICHphysicalchannelonlyandmodelsthelossofenergyintheCPICHsignalduetomultipath.TheOrthogonalityFactoris
relatedtothecorrelationbetweentheCPICHphysicalchannelandotherintracellphysicalchannels.
YoucaninstructAtolltousetheOrthogonalityFactorinthecalculationofpilotE
C
/N
T
inHSDPAinsteadof%PilotFingerby
12.1.8.8 SettingtheMaximumNumberofRejectionsforMobiles
YoucandefineamaximumnumberofrejectionsformobilesduringsimulationsbyaddingthefollowinglinesintheAtoll.ini
file:
IfamobileisrejectedXnumberoftimes,itwillnolongerbeconsideredinthenextiterations.
12.1.8.9 SettingtheMaximumNumberofRejectionsforHSDPAMobiles
You can set the number of times an HSDPA mobile should be rejected (or placed in a queue) before it is considered
permanentlyrejected(orpermanentlyplacedinthequeue).Thedefaultvalueofthisoptionis5.Tomodifythedefaultvalue,
enterthefollowinglinesintheAtoll.inifile:
Where X is the number of times an HSDPA mobile should be rejected to be considered permanently rejected for the
simulation.
12.1.8.10 DefininganOffsetWithRespecttoTheThermalNoise
YoucandefineanoffsetwithrespecttothethermalnoisebyaddingthefollowinglinesintheAtoll.inifile:
Mi nUser sPer Bi n = X
[ CDMA]
CQI Del t aWi t hPower = 0 or 1
CQI ( )
HS PDSCH
CQI ( )
pi l ot
E
C
N
T
-------
\ .
| |
pi l ot
E
C
N
T
-------
\ .
| |
HS PDSCH
+ =
CQI ( )
HS PDSCH
CQI ( )
pi l ot
P
pi l ot
P
HS PDSCH
+ =
[ CDMA]
Or t hoI nCPI CH = 1
[ CDMA]
MaxRej ect i ons = X
[ CDMA]
HSDPAMaxRej ect i ons = X
[ CDMA]
Cut Of f Si mu = X
209
Where,XistheoffsetvalueindBs.DuringMonteCarlosimulations,calculationsperformedoneachmobileonlytakeinto
accountthecellswhosereceivedpower,atthemobilelocation,isgreaterthanthethermalnoiseminusthisoffset.Youshould
setCutOffSimuto20dBforoptimumperformancewithoutlosingalotofinterference.
12.1.8.11 SettingPrecisionoftheRasterisationProcess
During Monte Carlo simulations, Atoll internally converts vector traffic maps to raster traffic maps in order to perform a
distributionofusersaccordingtothetrafficdensitiesandtheconnectionprobabilities.Theaccuracyofthisconversionfrom
vectorstorasterishighenoughformost,nearlyall,cases.However,thisaccuracymightnotbeenoughforhighlyprecise
vectorpolygonsdefiningtraffichotspots.
Thefigurebelowdepictsthiseffectforavectorpolygonwhichisjustslightlylargerthan1rasterpixel.Thevectorpolygonand
therasterbinhavethesametrafficdensityinthefollowingfigure.
The primitive libraries, which perform the conversion from vector to raster, deal in terms of float values for the x and y
coordinates of the vector polygons. Since these are float values, you will have to create vector polygons with the exact
(accuratetoallthedecimalplaces)sizeofapixel(ormultiplesofapixel)inordertogetrasterpixelswiththeexactsame
surfaceareaasthevectorpolygons.Ifthecoordinatesofthevectorpolygonsarenotaccurate,itispossiblethattheraster
pixelfoundfromthevectorpolygonwillbeshifted1bintotherightortotheleft.
Sucharasterisationmeansthatthenumberofusersinthevectorremainscorrect,butthedensitymightbedifferentsince
thesurfaceareahaschanged(Numberofusers=UserDensityxArea).
IfyouwantAtolltoincreasetheprecisionoftherasterisationprocessforhotspotsinyournetwork.Youcanaddthefollowing
Theoptionsare:
Improve=1(bydefault)meansthatAtollwillusetheaccuraterasterisationmethodforsmallpolygons.Improve=0
meansthatthenormalrasterisationmethodwillbeusedforallpolygons.Settingthisoptionto1impliesthatthis
algorithm will not be used globally for all polygons, but only for small polygons which are defined by the options
SurfRatioorMaximumSurf.
Precision=1(bydefault)meansthattherasterisationresolution(step)usedbythealgorithmforsmallpolygonsis1
metre.Youcansetittoahighervalueifyouobserveperformancedegradation.Thestepofrasterisationmeansthe
sizeofthebinusedtoapproximatethevectorshapewithbins.
SurfRatio=20(bydefault)meansthattheaccuratealgorithmwillbeusedonlyforpolygonswhosesizeissmallerthan
20timesthesizeofthenormalrasterbin.Thenormalrasterbinsize inan Atolldocumentis the finestresolution
amongthegeographicdataavailableinthedocument.
Figure 12.1:RasterisationProcess
[ Rast er i zat i on]
I mpr ove = 0 or 1
Pr eci si on = 1
Sur f Rat i o = 20
Maxi mumSur f = 2500
If you set Precision = 1, the performance (calculation speed) can be considerably
decreased depending on the size of your network. It is recommended to set a higher
valueforthePrecisionoption.
210
MaximumSurf=2500(bydefault)meansthatapolygonwillbeconsideredsmallonlyifitssurfaceareaislessthanor
equalto2500sq.m.
So,apolygonwillbeconsideredsmall,andwillberasterisedusingtheaccuratealgorithm,ifeithertheratioofitssurfacearea
tothesurfaceareaofthenormalrasterbinisequaltoorlessthanSurfRatio,orifitssurfaceareaislessthanMaximumSurf.
IfyouwanttousejusttheMaximumSurfoption,youcansettheSurfRatioto0.
12.1.8.12 DefiningtheNumberofIterationsBeforeDowngrading
YoucansetthenumberofiterationsthatAtollshouldcarryoutbeforestartingthedowngrading.Thedefaultvalueofthis
optionis30.Tomodifythedefaultvalue,enterthefollowinglinesintheAtoll.inifile:
WhereXistheintegernumberofiterations.
12.1.8.13 AdjustingtheWorkingoftheProportionalFairScheduler
InUMTSHSPAdocuments,youcanadjusthowtheproportionalfairschedulerfunctionsbyaddingthefollowinglinesinthe
Atoll.inifile:
WhereXisanumberbetween0and100,whichrepresentstheproportionalfairschedulerweight.PFSchedulerCQIFactor=
50bydefault.IfyousetPFSchedulerCQIFactor=0,theproportionalfairschedulerfunctionsliketheRoundRobinscheduler.
IfyousetPFSchedulerCQIFactor=100,theproportionalfairschedulerfunctionsliketheMaxC/Ischeduler.
12.1.8.14 DisplayingE
c
/I
0
ofRejectedMobilesinSimulationResults
InUMTSandCDMAsimulationresults,theEc/I0AS1columnintheMobilestabcanlisttheEc/I0valuesfromthebestserver
forallthemobiles,connectedorrejected.TodisplaytheEc/I0fromthebestserverfortherejectedmobiles,addthefollowing
DisplayEcIoOfRejectedissetto0bydefault.
12.1.8.15 SwitchingBacktotheOldBestServerDeterminationMethod
BeforeAtoll2.8.0,bestserverdeterminationinUMTSandCDMAnetworksusedtobeperformedbyselectingthebestcarrier
withintransmittersaccordingtotheselectedmethod(siteequipment)andthenthebesttransmitterusingthebestcarrier.
Toswitchbacktothisbestserverdeterminationmethod,addthefollowinglinesintheAtoll.inifile:
MultiBandSimuissetto1bydefault.
12.1.8.16 DisplayingAutomaticAllocationCostValues
YoucandisplaythecostvaluescalculatedbyAtollfordifferentrelationswhenallocatingscramblingcodesandPNoffsets.To
displaycostvalues,addthefollowinglinesintheAtoll.inifile:
DisplayCostValuesissetto0bydefault.
IfyourAtolldocumentcontainstwogeographicdatafiles,onewitha20mresolutionand
theotherwitha5mresolution,andyouremovethe5monefromyourdocument,Atoll
willstillkeep5masthenormalrasterbinsize.
[ CDMA]
I t er Bef or eDown = X
[ CDMA]
PFSchedul er CQI Fact or = X
[ CDMA]
Di spl ayEcI oOf Rej ect ed = 1
[ CDMA]
Mul t i BandSi mu = 0
[ PSC]
Di spl ayCost Val ues = 1
211
12.1.8.17 SelectingSCandPNOffsetAllocationStrategiesAvailableintheGUI
IntheAtoll.inifile,youcanselectthescramblingcode(UMTSandTDSCDMA)andPNoffset(CDMA2000)allocationstrategies
thatwillbeavailabletotheuserintheautomaticallocationdialogue.Toselecttheallocationstrategies,addthefollowing
Theallocationstrategies1,2,3,and4correspondtothefollowing:
InUMTS:
1:Clustered
2:DistributedperCell
3:OneClusterperSite
4:DistributedperSite
InTDSCDMA:
1:Clustered
2:DistributedperCell
3:OneSYNC_DLCodeperSite
4:DistributedperSite
InCDMA2000:
1:PNOffsetperCell
2:AdjacentPNClustersperSite
3:DistributedPNClustersperSite
12.1.8.18 DefiningaFixedIntervalBetweenScramblingCodes
Youcandefineafixedintervalbetweenscramblingcodesassignedtocellsonasamesitewhentheallocationisbasedona
distributedstrategy(DistributedperCellorDistributedperSite).Toapplythedefinedinterval,addthefollowinglinesinthe
Atoll.inifile:
ConstantStepissetto0bydefault.
12.1.8.19 CompressedMode:RestrictingIntercarrierandIntertechnology
NeighbourAllocation
YoucanpreventAtollfromallocatingintercarrierandintertechnologyneighbourstocellslocatedonsiteswhoseequipment
doesnotsupportcompressedmode,byaddingthefollowinglinesintheAtoll.inifile:
CompressModeEvalissetto0bydefault.
12.1.8.20 SettingtheMaximumASSizeforSCInterferencePrediction
You can setthemaximumactiveset size toa fixednumberoftransmittersforthescrambling code interferencecoverage
predictionbyaddingthefollowinglinesintheAtoll.inifile:
WhereXisthemaximumnumberoftransmittersintheactiveset.IfyousetSCActivesetMaxSize=10,youwillgetthesame
resultsinthecoveragepredictionastheSCInterferencetabinthepointanalysis.
12.1.8.21 DisplayingUplinkTotalLossesinCoveragebySignalLevel
InUMTSandCDMAdocuments,youcanactivatetheUplinkTotalLossesandMinimumUplinkTotalLossesdisplayoptionsin
theCoveragebySignalLevelpredictionbyaddingthefollowinglinesintheAtoll.inifile:
[ CDMA]
CodeSt r at egi es = 1, 2, 3, 4
[ PSC]
Const ant St ep = 1
[ Nei ghbour s]
Compr essModeEval = 1
[ St udi es]
SCAct i veset MaxSi ze = X
212
UplinkLossesissetto0bydefault.Uplinktotallossesarecalculatedfromthedownlinktotallossesbyreplacingthedownlink
transmitterlossesbyuplinktransmitterlosses.
12.1.8.22 SettingtheMaximumULReuseFactorforHSUPAUsersNoiseRise
Estimation
InUMTSHSPAsimulations,Atollassumesaconstantuplinkreusefactorforestimatingthemaximumavailablenoiseriseper
HSUPAuser.ThiscancauseunnecessaryrejectionofsomeHSUPAusersinverylowtrafficcases.Youcansetanupperlimit
fortheuplinkreusefactorbyaddingthefollowinglinesintheAtoll.inifile:
MaxReuseFactorissetto5bydefault.
12.1.9 LTE,WiMAX,andWiFiOptions
12.1.9.1 BlockingAccesstoIEEEParametersinWiMAX
YoucandisallowmodificationoftheparametersthatcomefromtheIEEEspecifications,andarenotsupposedtobechanged,
By default, ModifiableIEEEParams is set to 1, which means that all the parameters are modifiable. When you set
ModifiableIEEEParamsto0,itmeansthatthefollowingparameterswillbeunmodifiableintheGUI:
In the Permutation Zones table: Number of Used Subcarriers, Number of Data Subcarriers, and Number of
SubchannelsperChannel.
InthePermutationZonestable:SubchannelGroups(Segment0),SubchannelGroups(Segment1),andSubchannel
Groups(Segment2)forFFTsizes<1000.
IntheFrameConfigurationstableandintheGeneraltaboftheframeconfigurationsPropertiesdialogue:
NumberofPreambleSubcarriers.
12.1.9.2 UsingOnlyBearersCommonBetweentheTerminalsandCells
Equipment
IfyouwantAtolltoperformanintersectionoverthebearerssupportedbythecellequipmentandbytheterminalequipment,
UseCommonBearersOnly is set to 0 by default. When UseCommonBearersOnly is set to 1, Atoll only uses the bearers for
whichselectionthresholdsaredefinedinboththeterminalsandthecellsequipmentforbothdownlinkanduplinkbearer
selection.
[ St udi es]
Upl i nkLosses = 1
[ UMTSSi mus]
MaxReuseFact or = X
[ Wi MAX]
Modi f i abl eI EEEPar ams = 0
In the Permutation Zones table, the first DL PUSC permutation zone cannot be
deactivated.
IntheFramesConfigurationstable,thecellsunderTotalNumberofSubcarrierschange
intocomboboxeswiththefollowingfivevalues:128,256,512,1024,2048.
[ OFDM]
UseCommonBear er sOnl y = 1
213
12.1.9.3 EnablingDisplayofSignalsperSubcarrierPointAnalysisinLTE
BydefaultapointanalysisinLTEdisplaysRSperchannel,SS&PBCHperchannel,PDCCH&PDSCHperchannel,andRSper
subcarrier.Ifdesired,youcanalsouseapointanalysistodisplaySS&PBCHpersubcarrierandPDCCH&PDSCHpersubcarrier
DisplaySignalsPerSCInPtAissetto0bydefault.WhentheDisplaySignalsPerSCInPtAoptionissetto"0"orisabsent,SS&PBCH
persubcarrierandPDCCH&PDSCHpersubcarrierarenotavailableoptionsinapointanalysis.
12.1.9.4 IncludingCyclicPrefixEnergyinLTESignalLevelCalculation
Theusefulsignallevelcalculationtakesintoaccounttheusefulsymbolenergy(Es),i.e.,excludingtheenergycorresponding
tothecyclicprefixpartofthetotalsymbolduration.However,youcanincludethecyclicprefixenergyintheusefulsignallevel
calculationbyaddingthefollowinglinesintheAtoll.inifile:
ExcludeCPFromUsefulPowerissetto1bydefault.
Independant of the option, interference levels are calculated for the total symbol durations, including the energy useful
symboldurationandthecyclicprefixenergy.
12.1.9.5 ExcludingCyclicPrefixEnergyinWiMAXandWiFiSignalLevelCalculation
Theusefulsignallevelcalculationcanexcludetheenergycorrespondingtothecyclicprefixpartofthetotalsymbolduration,
hence taking into account only the energy belonging to the useful symbol duration. In order to do so, you must add the
ExcludeCPFromUsefulPowerissetto0bydefault.
Independant of the option, interference levels are calculated for the total symbol durations, including the energy useful
symboldurationandthecyclicprefixenergy.
12.1.9.6 IgnoringInterNeighbourPreambleIndexCollisioninWiMAX
The automatic preamble index allocation algorithm in Atoll takes into account the possible collision of preamble indexes
assignedtoneighboursofacell.ThismeansthatAtolltriestonotallocatethesamepreambleindextotwoneighboursofa
cell.Ifyouwanttodisablethisconstraint,i.e.,allowAtolltoallocatethesamepreambleindextotwoneighboursofacell,
InterNeighbourPICollisionsissetto1bydefault.
Thepreambleindexauditbasedonneighboursalsotakesthisoptionintoaccount.WithInterNeighbourPICollisions=1,the
audit lists the cell pairs that are neighbours of a cell and are allocated the same preamble index. When
InterNeighbourPICollisions=0,thepreambleindexcollisionisnotverifiedbetweenneighboursofacell.
12.1.9.7 IgnoringInterNeighbourPhysicalCellIDCollisioninLTE
TheautomaticphysicalcellIDallocationalgorithminAtolltakesintoaccountthepossiblecollisionofphysicalcellIDsassigned
toneighboursofacell.ThismeansthatAtolltriestonotallocatethesamephysicalcellIDtotwoneighboursofacell.Ifyou
want to disable this constraint, i.e., allow Atoll to allocate the same physical cell ID to two neighbours of a cell, add the
InterNeighbourIDCollisionsissetto1bydefault.
[ LTE]
Di spl aySi gnal sPer SCI nPt A = 1
[ LTE]
Excl udeCPFr omUsef ul Power = 0
[ Wi MAX]
Excl udeCPFr omUsef ul Power = 1
[ Wi MAX]
I nt er Nei ghbour PI Col l i si ons = 0
[ LTE]
I nt er Nei ghbour I DCol l i si ons = 0
214
ThephysicalcellIDauditbasedonneighboursalsotakesthisoptionintoaccount.WithInterNeighbourIDCollisions=1,the
audit lists the cell pairs that are neighbours of a cell and are allocated the same physical cell ID. When
InterNeighbourIDCollisions=0,thephysicalcellIDcollisionisnotverifiedbetweenneighboursofacell.
12.1.9.8 RenamingOPUSCZonetoPUSCULinWiMAX
IfyouwishtoworkwithtwoPUSCULpermutationzones,youcanrenametheOPUSCpermutationzonetoPUSCULbyadding
ReplaceOPUSCwithPUSCULissetto0bydefault.
12.1.9.9 DeactivatingUniformDistributionofResources
By default, the basic automatic allocation of physical cell IDs and preamble indexes distributes the allocated resources
uniformly.Ifyouwishtodeactivatetheuniformdistributionofresources,addthefollowinglinesintheAtoll.inifile:
UniformIDDistributionissetto1bydefault.
12.1.9.10 TakingSecondOrderNeighboursintoAccountintheAFP
The LTE AFP takes first order neighbours into account when allocating physical cell IDs. The WiMAX AFP takes first order
neighboursintoaccountwhenallocatingpreambleindexesanddownlinkanduplinkzonepermbases.IfyouwanttheAFPto
takebothfirstandsecondorderneighboursintoaccount,addthefollowinglinesintheAtoll.inifile:
SecondNeighboursissetto0bydefault.
12.1.9.11 SettingPDCCHto100%LoadedinLTEInterferenceCalculations
By default, the downlink interference calculated from PDSCH and PDCCH is weighted by the downlink traffic loads of the
interferingcells.IfyouwishtosetthePDCCHto100%loaded,i.e.,onlyweighttheinterferencefromPDSCHbythedownlink
trafficloadandnottheinterferencefromthePDCCH,addthefollowinglinesintheAtoll.inifile:
ApplyDLLoadOnPDCCHInterfissetto1bydefault.
12.1.9.12 CalculatingEIRPfromRSEPREinLTESignalLevelPredictions
Atoll calculates theEIRP from the reference signal power inLTE. In signallevelbased coverage predictions, if you wish to
calculatetheEIRPfromtheReferenceSignalEPREinstead,addthefollowinglinesintheAtoll.inifile:
EIRPfromRSEPREissetto0bydefault.
ThisoptionappliestoCoveragebyTransmitter,CoveragebySignalLevel,andOverlappingZonespredictionsinLTE.
12.1.9.13 AveragingtheUplinkNoiseRiseindB
The average simulation results provide the linear average of uplink noise rise values displayed in dB. If you want Atoll to
calculatetheaveragebydirectlyusingthenoiserisevaluesindB,addthefollowinglinesintheAtoll.inifile:
MeanNRInDBissetto0bydefault.
[ Wi MAX]
Repl aceOPUSCwi t hPUSCUL = 1
[ OFDM]
Uni f or mI DDi st r i but i on = 0
[ OFDM]
SecondNei ghbour s = 1
[ LTE]
Appl yDLLoadOnPDCCHI nt er f = 0
[ LTE]
EI RPf r omRSEPRE = 1
[ OFDM_SI MU]
MeanNRI nDB = 1
215
12.1.9.14 DeactivatingServiceMaxThroughputDemandDowngradinginLTE
Service maximum throughput demand downgrading is active by default in LTE Monte Carlo simulations. If you wish to
deactivatethisdowngrading,addthefollowinglinesintheAtoll.inifile:
ServiceMBRDowngradingissetto1bydefault.
12.1.9.15 DisplayingPixelswithZeroThroughputinCoveragePredictions
Inthroughputcoveragepredictions,pixelsarecolouredaccordingtothedefinedthroughputthresholdcoloursifthereare
bearersavailableonthosepixels.Ifyouwishtohaveotherpixels,i.e.,thosewithnoavailablebearerhencezerothroughput,
tobecolouredaswell,addthefollowinglinesintheAtoll.inifile:
DisplayThroughputZeroissetto0bydefault.
12.1.10 3GPPMultiRATOptions
12.1.10.1 BSIC,SC,andPCIAllocationWithIntertechnologyNeighbourConstraints
TheautomaticallocationsofBSIC(usingtheGSMAFP),scramblingcodes(inUMTS),andphysicalcellIDs(usingtheLTEAFP)
takeintertechnologyneighbourconstraintsintoaccount.Forexample,differentphysicalcellIDsareassignedtotwoLTEcells
that are neighbours of the same GSM transmitter or UMTS cell. If you wish to disable the intertechnology neighbour
constraintsintheautomaticallocationsofBSIC,SC,andPCI,addthefollowinglinesintheAtoll.inifile:
AllCodesAllocWithInterRATNeighboursissetto1bydefault.
12.1.11 MicrowaveRadioLinksOptions
12.1.11.1 ExcludingNearfieldInterferencefromCalculations
If you want to exclude the effect of nearfield interference from interference calculations, add the following lines in the
Atoll.inifile:
IgnoreCositeInterferenceissetto0bydefault.WhenIgnoreCositeInterferenceissetto1,interferencereceivedfromcosite
sourcesisignored.
12.1.11.2 ExcludingStandbyChannelsfromInterferenceCalculations
Ifyouwanttoexcludethestandby,anddiversitystandbychannelsfrominterferencecalculations,addthefollowinglinesin
theAtoll.inifile:
HSB_INTERFERERissetto0bydefault.
12.1.11.3 UpdatingA>>BandB>>AProfilesinRealtime
IntheMWAnalysiswindowsProfileview,whenachangeismadeontheA>>Blink,itisnotautomaticallytakenintoaccount
intheB>>Adirectioninrealtime.Thisproducesinconsistentresultsinthe2directions.Ifyouwanttomaketheprofileupdate
realtimeinbothdirections,i.e.,changesinonedirectionautomaticallyupdatedintheotherdirection,addthefollowinglines
intheAtoll.inifile:
[ LTE]
Ser vi ceMBRDowngr adi ng = 0
[ OFDM]
Di spl ayThr oughput Zer o = 1
[ Mul t i RAT]
Al l CodesAl l ocWi t hI nt er RATNei ghbour s = 0
[ MWCal cul at i ons]
I gnor eCosi t eI nt er f er ence = 1
HSB_I NTERFERER = 1
216
UpdateOppositeHopissetto1bydefault.
12.1.11.4 DisablingShieldingFactoronWantedSignalatReceiver
Ifyouwanttodisabletheuseoftheshieldingfactoronthewantedsignalatthereceiverduringinterferencecalculations,add
ShieldingFactorOnWantedSignal is set to 1 by default, which means that the shielding factor is taken into account at the
receiver when calculating interference. On the transmitter side, the shielding factor is always taken into account when
calculatinginterference.
12.1.11.5 HidingtheRec.ITURP.5305Method
TheRec.ITURP.5305methodishiddenbydefaultontheModelstaboftheMicrowaveRadioLinksPropertiesdialogue.
YoucanhaveitbackintheMethodlistboxes(AvailabilityandQualityframes)byaddingthefollowinglinesintheAtoll.inifile:
HIDE_REC5issetto1bydefault,whichmeansthattheRec.ITURP.5305methoddoesnotappearintheMethodlistboxes
mentionedabove.ThissettingisreadbyAtollwithoutAtollhavingtoberestarted.
IfitwasselectedinadocumentthatwassavedinapreviousAtollversion,theRec.ITURP.5305methodwillbelistedeven
ifHIDE_REC5issetto1intheAtoll.inifile.
12.1.11.6 UsingOldMinC/IValues
IfyouwishtouseMinC/IvaluesdefinedorcalculatedinoldversionsofAtoll,addthefollowinglinesintheAtoll.inifile:
MWEquipment_CIMINissetto0bydefault.
12.1.11.7 SolvingAlignmentIssueinGeneratedReports
IfyouencounteranalignmentissueintheMicrowavereportorintheReflectionAnalysisreport,youcansolveitbyincreasing
thetabvalue.Todothat,addthefollowinglinesintheAtoll.inifile:
12.1.11.8 DefiningDefaultConfigurationFilesforLinkBudgetsReports
YoucandefineadefaultconfigurationfileforeachlinkbudgetreportbyspecifyinganabsoluteorUNCpathintheAtoll.inifile:
Updat eOpposi t eHop = 1
Shi el di ngFact or OnWant edSi gnal = 0
HI DE_REC530_5 = 0
[ Compat i bi l i t y]
MWEqui pment _CI MI N = 1
[ MWRepor t ]
t ab = 2000 # Def aul t val ue i s 500
[ MWRepor t ]
Desi gnSummar yCf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
Li nkAnal ysi sCf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
Li nkI nt er f er enceCf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
Requi r edMar gi nCf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
Li nksBudget Cf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
Li nksI nt er f er enceCf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
Mul t i hopAnal ysi sCf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
Ref l ect i onAnal ysi sCf g = pat h t o t he r epor t s def aul t conf i gur at i on f i l e
217
WhereeachoftheaboveoptionscorrespondstoaspecificReportConfigurationdialogue:
DesignSummaryCfg:correspondstotheReportConfigurationdialoguedisplayedafterclickingtheConfigureReport
button( )fromtheDesignSummaryview(MWAnalysiswindow).
LinkAnalysisCfg: corresponds to the Report Configuration dialogue displayed after clicking the Configure Report
buttonfromtheAnalysisReportview(MWAnalysiswindow).
LinkInterferenceCfg:correspondstotheReportConfigurationdialoguedisplayedafterclickingtheConfigureReport
buttonfromtheInterferenceReportview(MWAnalysiswindow).
RequiredMarginCfg:correspondstotheReportConfigurationdialoguedisplayedafterclickingtheConfigureReport
buttonfromtheRequiredMarginview(MWAnalysiswindow).
LinksBudgetCfg:correspondstotheReportConfigurationdialoguedisplayedafterselectingMicrowaveRadioLinks
>Links>LinkBudgets>ConfigurationReportfromtheNetworkexplorer.
LinksInterferenceCfg:correspondstotheReportConfigurationdialoguedisplayedafterselectingMicrowaveRadio
Links>Links>Interference>ConfigurationReportfromtheNetworkexplorer.
MultihopAnalysisCfg:correspondstotheReportConfigurationdialoguedisplayedafterselectingMicrowaveRadio
Links>MultiHops>[MultiHopX]>AnalysisfromtheNetworkexplorer.
ReflectionAnalysisCfg:correspondstotheReportConfigurationdialoguedisplayedafter:
rightclickingintheProfileAnalysisview(MWAnalysiswindow)andselectingReflectionandDiversityAnalysis,
thenclickingtheConfigureReportbuttonfromtheAnalysisReportview(MWReflection/Diversitywindow).
12.1.11.9 DefiningaDefaultTemplateforMicrowaveLinksCustomReports
YoucandefineadefaulttemplateformicrowavelinkscustomreportsbyspecifyinganabsoluteorUNCpathintheAtoll.ini
file:
12.1.12 MeasurementOptions
12.1.12.1 DisplayingAdditionalInformationinDriveTestData
Itispossibletodisplaythefollowingadditionalinformationinthecolumnsofservingandneighbourcells:
BCCHBSICpair(GSMGPRSEDGEdocuments)
ScramblingCodeScramblingCodeGrouppair(UMTSHSPAdocuments)
PNOffsetPNOffsetGrouppair(CDMA20001xRTT1xEVDOdocuments)
YouhavetoaddthefollowinglinesintheAtoll.inifiletodisplaythisinformation:
SettingShowCoupleInfoto0hidesthisinformation.
12.1.12.2 SettingtheNumberofTransmittersperDriveTestDataPath
By default, Atoll can import information about one serving transmitter (or cell in CDMA documents) and six neighbour
transmitters(orcellsinCDMAdocuments)fordrivetestdatapaths.Youcanchangethenumberoftransmittersperdrivetest
datapathbyaddingthefollowinglinesintheAtoll.inifile:
WhereXisthenumberoftransmittersperdrivetestdatapath.ThedefaultvalueofNumberOfTestMobileTransmittersis7.
12.1.12.3 RecalculatingDistancesofPointsFromThereServingCellsatImport
IfyouwantAtolltocalculatethedistanceofeachmeasurementpointfromitsnearestservingcell,youcanaddthefollowing
[ MWRepor t ]
Def aul t Templ at e = pat h t o t he def aul t t empl at e f or mi cr owave l i nks cust omr epor t s
[ Test Mobi l eDat a]
ShowCoupl eI nf o = 1
Number Of Test Mobi l eTr ansmi t t er s = X
Recal cDi st = 1 or 0
218
The default value of RecalcDist is 1, which means that Atoll will calculate the distance for each measurement point. The
nearest serving cell is the one closest to the measurement point which has the same (Scrambling Code, SC Group), (BSIC,
BCCH),or(PNOffset,PNOffsetGroup)pairasthepoint.
12.1.12.4 DefiningtheBCCHandBSICColumnsforFMTImport
The.fmtfilesgeneratedbytheTEMSInvestigationGSMtoolcontainanumberofcolumns.Todefinewhichofthesecolumns
shouldbeimportedastheBCCHcolumnandwhichoneastheBSICcolumninAtoll,youcanaddthefollowinglinesinthe
Atoll.inifile:
Where, Column1 and Column2 are the titles of the two columns in the .fmt file corresponding to the BCCH and the BSIC
columnsrespectively.
12.1.12.5 ImportingDriveTestDatawithScramblingCodesasIntegers
Youcanforcetheconversionofscramblingcodestointegervalueswhenimportingdrivetestdatabyaddingthefollowing
optionintheAtoll.inifile:
FloatingPointScramblingCodeSupportissetto0bydefault,andthescramblingcodesareimportedaccordingtothenumeric
datatypeselectedforthescramblingcodecolumnintheimportdialogue.
12.1.12.6 ImportingDriveTestDataforActiveandFilteredTransmittersOnly
When you import drive test data in Atoll, it assigns servers and neighbours to each measurement point based on the cell
identification method defined for the import. By default, Atoll takes all the transmitters and cells of the document into
account,whethertheyareactiveorinactiveandfilteredornot.IfyouwantAtolltotakeonlyactiveandfilteredtransmitters
andcellsintoaccountfordrivetestdataimport,addthefollowingoptionintheAtoll.inifile:
ImportForFilteredTransmittersOnlyissetto0bydefault.
12.1.13 ACPOptions
Forthemostpart,youcanconfiguretheACPwithitsowninitialisationfile:theacp.ini.However,thereareafewoptionsthat
youcansetintheatoll.initoconfiguretheACP.
12.1.13.1 SpecifyingtheLocationoftheAcp.iniFile
Bydefault,Atoll ACPuses the global acp.inifile, located intheinstallationdirectoryofAtoll. You can set anoption inthe
atoll.inifiletodefineadifferentlocationfortheacp.inifile.ThisoptionisusefulforassigningadifferentACPinitialisationfor
adifferentgroupofusers.
Touseanotherlocation,addthefollowinglinetotheatoll.inifile:
[ Test Mobi l eDat aI mpor t Fmt ]
BCCHCol umn = Column1
BSI CCol umn = Column2
Fl oat i ngPoi nt Scr ambl i ngCodeSuppor t = 1
I mpor t For Fi l t er edTr ansmi t t er sOnl y = 1
219
12.2 ACPInitialisationFile
TheACPinitialisationfileisusedtoinformAtollofthepreferredsettingswhentheACPisusedforautomaticcellplanning
duringAtollsessions.ItcanbeusedtoadjustthebehaviouroftheACP.
Youcancommentoutanyoptionintheacp.inibyprecedingthelinewithasemicolon(";")orwithahashmark("#").
InorderfortheACPinitialisationfiletobeusedbyAtoll,youshouldplacetheacp.inifileintheAtollinstallationdirectory.
Youcandefineadifferentlocationfortheacp.inifilebysettingthefollowingoptionintheatoll.inifile:
Thefollowingsectionsdescribetheoptionsavailableintheacp.inifile.
12.2.1 ManagingPreferences
Someofthesettingsprovidedintheacp.inifilecanbemodifieddirectlyusingtheACPAutomaticCellPlanningProperties
dialogue,underACPAutomaticCellPlanningontheSetupTemplatetab.ACPeitherembedsthesesettingsdirectlyintheATL
documentorinauserdefinedacp.inifile.Thesesettingsarereferredas"localsettings."Localsettingsarethesettingsfound
insectionsusingthe"Tpl"keyword,suchas[ACPTplGeneralPage].
12.2.2 GUIOptions
InthissectionarethesettingsdefiningdefaultvaluesanddefiningcertainaspectsoftheGUIconfiguration.Thesesettingsare
localandareusuallydefinedusingSetupTemplatetaboftheACP AutomaticCellPlanningPropertiesdialogue,andstored
eitherintheAtollprojectoralocalacp.inifile.
12.2.2.1 DefaultValuesontheOptimisationTab
Inthe[ACPTplGeneralPage]section,youcanfindtheoptionsusedtosetdefaultvaluesfortheOptimisationtab.
Thefollowingoptionscanbeusedtosetdefaultvaluesforthenumberofiterationsandresolution:
Otheroptionscanbeusedtodefinethedefaultvaluesforcalculatingcost:
[ ACP]
i ni Fi l e = / pat h/ t o/ t he/ ACP. i ni
The ACP initialisation file is a powerful tool. You should not modify any option in the
acp.inifileuntilandunlessyouareabsolutelysureofwhatyouaredoing.
[ ACP]
i ni Fi l e = / pat h/ t o/ t he/ ACP. i ni
The local settings, defined using the ACP Automatic Cell Planning Properties
dialogue, take precedence over the same settings defined in the global acp.ini
file. The settings in the acp.ini file are read when you start a new project to
initialisethesettingsoftheACP.
When using the acp.ini file to define options, instead of using the ACP
Automatic Cell Planning Properties dialogue, you can also define any other
settings even if they can not be set using the ACP Automatic Cell Planning
Propertiesdialogue.Thesesettingsredefinedlocallyhaveprecedenceoverthe
globalsettings.
[ ACPTpl Gener al Page]
nbI t er at i on=100
r esol ut i on=50
cost . t ype=0 # 0=of f , 1=l i mt _t o_max, 2=appl y_cost _t o_change_pl an
; cost . uni t =
# her e def i ne t he opt i onal ' uni t ' f or cost : $, ' yen' , et c. Less t han 4 char act er s
cost . t r adeof f Level =1 # 0=l ow, 1=nor mal , 2=st r ong
220
12.2.2.2 DisplayingAdvancedCostOptions
Inthe[ACPGeneralPage]section,youcandefineanoptiontodisplayadvancedcostoptionswhichenabletheusertodefine
themaximumnumberofchangestobemade(eitherasavalueoraratio)andtochangetherankingoftheorderofcostin
the final implementation plan: changes with the lowest cost are performed first and changes with the highest cost are
performedlast.
Inthe[ACPTplGeneralPage]section,youcandefinedefaultvaluesforadvancedcostcontrol.The"cost.planCostWeighting"
optionenablesyoutodefinetheimportanceofcostintheimplementationplan:
The"cost.planLimitType"optionenablesyoutolimitthenumberofchangesintheimplementationplan:
Ifthe"cost.planLimitType"optionissetto"1"(i.e.,anabsolutevalue),thenthe"cost.planChangeMax"optionmustbesetto
definethenumberofchangesintheimplementationplan:
Ifthe"cost.planLimitType"optionissetto"2"(i.e.,apercentageofthetotalantennasinthecomputationzone),thenthe
"cost.planChangePercent"optionmustbesettodefinethenumberofchangesintheimplementationplanasapercentage
ofthenumberofantennas:
Ifthe"cost.planLimitType"optionissetto"2"(i.e.,apercentageofthetotalantennas),theusercanthenusethefocuszone
instead of the computation zone as the reference zone by setting the "cost.planChangRefZone" option in the
[ACPGeneralPage]:
cost . maxCost =50
cost . azi mut h. cost =1
cost . azi mut h. i sSi t eVi si t =t r ue
cost . t i l t . cost =1
cost . t i l t . i sSi t eVi si t =t r ue
cost . ant enna. cost =1
cost . ant enna. i sSi t eVi si t =t r ue
cost . et i l t . cost =0. 1
cost . et i l t . i sSi t eVi si t =f al se
cost . power . cost =0. 1
cost . power . i sSi t eVi si t =f al se
cost . si t eVi si t Cost =2
cost . upgr adeSi t eCost =5
cost . newSi t eCost =10
cost . r emoveSi t eCost =- 5
[ ACPGener al Page]
enabl eAdvancedCost =0 # "1" t o di spl ay ( def aul t ) ; " 0" t o hi de
cost . pl anCost Wei ght i ng=0 # " 0" =l ow, " 1" =medi um( def aul t ) , " 2" =hi gh
cost . pl anLi mi t Type=0 # "0" =no l i mi t ( def aul t ) " 1"=absol ut e val ue
# " 2" =per cent of t ot al ant ennas i n t he comput at i on zone
cost . pl anLi mi t Type=1
cost . pl anChangeMax=10 # I n t hi s exampl e, t he maxi mumno. of changes i s " 10. "
cost . pl anLi mi t Type=1
cost . pl anChangePer cent =10 # I n t hi s exampl e, t he maxi mumno. of changes i s " 10%"
# of t he t ot al number of ant ennas i n t he comput at i on zone
[ ACPGener al Page]
221
12.2.2.3 AutomaticallyCreatingCustomZonesontheOptimisationTab
Inthe[ACPTplGeneralPage]section,youcanfindtheoptionsusedtoautomaticallycreatecustomzonesthatwillappearon
theOptimisationtabwhenyoucreateanewACPsetup.
ThefollowingoptioncanbeusedtoautomaticallycreateACPcustomzonesfromthehotspotsintheAtollproject:
ThefollowingoptionscanbeusedtoautomaticallycreateACPcustomzonesfromoneormoreclutterclassesorfromaSHP
file:
12.2.2.4 DefaultValuesontheObjectivesTab
Inthe[ACPTplObjectivePage]sectionarethesettingsdefiningdefaultvaluesfortheObjectivestab.
Thefollowingoptionisusedtodefinethedefaultvaluefortrafficextractionresolutioninmetres:
Thefollowingoptionsareusedtodefinethedefaultvaluesforthetechnologyqualityindicators(UMTSEc/Io,UMTSRSCP,
UMTSoverlap,GSMsignallevel,GSMoverlap,WiMAXCINR,WiMAXC/N,LTEC/N,etc.):
cost . pl anChangRef Zone=1 # Rat i on comput ed agai nst comput at i on zone
# ( 0: Def aul t ) or f ocus zone ( 1)
zone. aut obui l dHot spot =1 # aut omat i cal l y bui l d hot spot f r omAt ol l hot spot ( def aul t )
zone. count =2 # The number of zones t o be cr eat ed.
zone. 0. name=MyCl ut t er Zone1 # The name of t he zone ( i n t hi s case f r omcl ut t er )
zone. 0. cl ut t er =10, 11, 12 # The cl ut t er cl asses t hat wi l l const i t ut e t hi s zone
zone. 1. name=MyVect or Zone2 # The name of t he zone ( i n t hi s case f r omSHP)
zone. 1. f i l e=c: \ pat h\ t o\ f i l e. shp # Absol ut e pat h t o t he SHP f i l e.
[ ACPTpl Obj ect i vePage]
t r af f i c. ext r act i on. r esol ut i on=50 # t he t r af f i c ext r act i on r esol ut i on, i n met r es
par am. gsm. over l ap. aut oPr edi ct i on=yes
par am. gsm. over l ap. mar gi n=5
par am. gsm. over l ap. mi nRxLevel =0 # 0=use def i ned TRG t hr eshol d, ot her =def i ned val ue
par am. gsm. bcch. aut oPr edi ct i on=yes
par am. gsm. bcch. i sShadowi ng=no
par am. gsm. bcch. cel l EdgeCov=0. 75
par am. umt s. over l ap. aut oPr edi ct i on=yes
par am. umt s. over l ap. mar gi n=10
par am. umt s. over l ap. mi nRxLevel =- 120
par am. umt s. r scp. aut oPr edi ct i on=yes
par am. umt s. r scp. i sShadowi ng=no
par am. umt s. r scp. cel l EdgeCov=0. 75
par am. umt s. eci o. aut oPr edi ct i on=yes
par am. umt s. eci o. i sShadowi ng=no
par am. umt s. eci o. cel l EdgeCov=0. 75
par am. cdma. over l ap. aut oPr edi ct i on=yes
par am. cdma. over l ap. mar gi n=10
par am. cdma. over l ap. mi nRxLevel =- 120
par am. cdma. cover age. aut oPr edi ct i on=yes
par am. cdma. cover age. i sShadowi ng=no
par am. cdma. cover age. cel l EdgeCov=0. 75
par am. cdma. eci o. aut oPr edi ct i on=yes
par am. cdma. eci o. i sShadowi ng=no
222
Thefollowingoptionsareusedtodefinethedefaultthresholdforeachobjectiverule:
par am. cdma. eci o. cel l EdgeCov=0. 75
par am. wi max. over l ap. aut oPr edi ct i on=yes
par am. wi max. over l ap. mar gi n=5
par am. wi max. over l ap. mi nRxLevel =- 105
par am. wi max. cover age. aut oPr edi ct i on=yes
par am. wi max. cover age. i sShadowi ng=no
par am. wi max. cover age. cel l EdgeCov=0. 75
par am. wi max. cni r . aut oPr edi ct i on=yes
par am. wi max. cni r . i sShadowi ng=no
par am. wi max. cni r . cel l EdgeCov=0. 75
par am. wi max. cni r . useFr eqBand=1
par am. wi max. cni r . useSegment at i on=1
par am. l t e. over l ap. aut oPr edi ct i on=yes
par am. l t e. over l ap. mar gi n=5
par am. l t e. over l ap. mi nRxLevel =- 105
par am. l t e. cover age. aut oPr edi ct i on=yes
par am. l t e. cover age. i sShadowi ng=no
par am. l t e. cover age. cel l EdgeCov=0. 75
par am. l t e. ci nr . aut oPr edi ct i on=yes
par am. l t e. cni r . i sShadowi ng=no
par am. l t e. cni r . cel l EdgeCov=0. 75
par am. l t e. cni r . useFr eqBand=1
par am. l t e. cni r . useSegment at i on=1
qual i t y. gsm. bcch. t hr eshol d= - 85
qual i t y. gsm. over l ap. t hr eshol d=4
qual i t y. umt s. r scp. t hr eshol d= - 85
qual i t y. umt s. eci o. t hr eshol d= - 13
qual i t y. umt s. over l ap. t hr eshol d=4
qual i t y. cdma. r scp. t hr eshol d= - 85
qual i t y. cdma. eci o. t hr eshol d= - 13
qual i t y. cdma. over l ap. t hr eshol d=4
qual i t y. wi max. cover age. t hr eshol d= - 85
qual i t y. wi max. c. t hr eshol d=- 85
qual i t y. wi max. cn. t hr eshol d=20
qual i t y. wi max. ci nr . t hr eshol d=10
qual i t y. wi max. over l ap. t hr eshol d=5
qual i t y. l t e. cover age. t hr eshol d= - 85
qual i t y. l t e. c. t hr eshol d= - 85
qual i t y. l t e. cn. t hr eshol d=20
qual i t y. l t e. r sr p. t hr eshol d= - 105
qual i t y. l t e. ci nr . t hr eshol d=10
qual i t y. l t e. r sr q. t hr eshol d= - 12
223
ThefollowingoptionsareusedtodefinethedefaultobjectivesproposedbytheACP.Allobjectivesdefinedwiththeoption
"auto=yes"areautomaticallycreatedduringanewsetup.Othersareavailableonthecontextmenuusedforcreatingnew
objectives.
qual i t y. l t e. over l ap. t hr eshol d=5
Forthesetting"objective.X.conditions.X.operande,"avalueof"0"means"<"(lessthan)
and"1"means">"(greaterthan).
obj ect i ve. count =14 # The t ot al number of obj ect i ves t o be def i ned.
obj ect i ve. 0. name=GSM Cover age # Name of obj ect i ve " 0" def i ned.
obj ect i ve. 0. condi t i ons. count =1
obj ect i ve. 0. condi t i ons. 0. l ayer =gsm
obj ect i ve. 0. condi t i ons. 0. qual i t y=bcch
obj ect i ve. 0. condi t i ons. 0. t hr eshol d=- 85
obj ect i ve. 0. condi t i ons. oper ande=OR
obj ect i ve. 0. aut o=t r ue
obj ect i ve. 0. wei ght =1
obj ect i ve. 0. t ar get Zone=- 1 # - 2=compZone, - 1=f ocusZone, or ot her zone i dx
obj ect i ve. 0. t ar get . i sAbsol ut eCover age=yes
obj ect i ve. 0. t ar get . absol ut eCover age=90
obj ect i ve. 0. f i l t er . count =0
; ; The f ol l owi ng obj ect i ve shoul d be def i ned separ at el y f or each l ayer
obj ect i ve. 1. name=GSM Cel l Domi nance # Name of obj ect i ve " 1" def i ned.
obj ect i ve. 1. condi t i ons. oper ande=AND
obj ect i ve. 1. condi t i ons. 0. qual i t y=over l ap
obj ect i ve. 1. condi t i ons. 0. oper ande=1 # " 1" means " >" ( gr eat er t han) .
obj ect i ve. 1. condi t i ons. 0. t hr eshol d=0
obj ect i ve. 1. condi t i ons. 1. oper ande=0 # " 0" means " <" ( l ess t han)
obj ect i ve. 2. name=UMTS RSCP Cover age # Name of obj ect i ve " 2" def i ned.
obj ect i ve. 2. condi t i ons. 0. l ayer =umt s
obj ect i ve. 2. condi t i ons. 0. qual i t y=r scp
obj ect i ve. 3. name=UMTS EcI o # Name of obj ect i ve " 3" def i ned.
224
obj ect i ve. 3. condi t i ons. 0. qual i t y=eci o
obj ect i ve. 4. name=UMTS Pi l ot Pol l ut i on # Name of obj ect i ve " 4" def i ned.
obj ect i ve. 4. aut o=f al se
obj ect i ve. 4. condi t i ons. 0. oper ande=0 # " 0" means "<" ( l ess t han)
obj ect i ve. 5. name=UMTS Sof t Handover # Name of obj ect i ve "5" def i ned.
obj ect i ve. 5. condi t i ons. 0. oper ande=1 # " 1" means ">" ( gr eat er t han)
obj ect i ve. 5. f i l t er s. count =1
obj ect i ve. 5. f i l t er s. 0. l ayer =umt s
obj ect i ve. 5. f i l t er s. 0. qual i t y=r scp
obj ect i ve. 5. f i l t er s. 0. oper ande=0
obj ect i ve. 5. f i l t er s. 0. t hr eshol d=- 95
obj ect i ve. 6. name=Wi MAX Pr eambl e Cover age # Name of obj ect i ve " 6" def i ned.
obj ect i ve. 6. condi t i ons. 0. l ayer =wi max
obj ect i ve. 6. condi t i ons. 0. qual i t y=cover age
obj ect i ve. 7. name=Wi MAX Pr eambl e CI NR # Name of obj ect i ve " 7" def i ned.
obj ect i ve. 7. condi t i ons. 0. l ayer =wi max
obj ect i ve. 7. condi t i ons. 0. qual i t y=ci nr
obj ect i ve. 7. condi t i ons. 0. oper ande=1 # " 1" means ">" ( gr eat er t han)
225
obj ect i ve. 8. name=LTE RS Cover age # Name of obj ect i ve " 8" def i ned.
obj ect i ve. 8. condi t i ons. 0. l ayer =l t e
obj ect i ve. 9. name=LTE RS CI NR # Name of obj ect i ve "9" def i ned.
obj ect i ve. 9. condi t i ons. 0. l ayer =l t e
obj ect i ve. 9. condi t i ons. 0. qual i t y=ci nr
obj ect i ve. 10. name=CDMA Cover age # Name of obj ect i ve " 10" def i ned.
obj ect i ve. 10. condi t i ons. 0. l ayer =cdma
obj ect i ve. 11. name=CDMA EcI o # Name of obj ect i ve " 11" def i ned.
obj ect i ve. 11. condi t i ons. 0. qual i t y=eci o
obj ect i ve. 12. name=CDMA Pi l ot Pol l ut i on # Name of obj ect i ve " 12" def i ned.
obj ect i ve. 13. name=CDMA Sof t Handover # Name of obj ect i ve " 13" def i ned.
226
ThefollowingoptionenablesyoutousetheXORbooleanexpressionwhencreatingobjectives.
ThefollowingoptionisusedtoremovetheCapacityandLoadBalancingfeaturesfromtheObjectivestab:
ThefollowingoptionisusedtocleartheScaleTrafficaccordingtoZoneWeightingcheckboxontheCapacitypageofthe
Objectivestab:
Thefollowingoptionsareusedtodefineacapacitytrafficmap,eitherbyaBILfileorbyacommaseparatedlistoftrafficmap
names:
Thefollowingoptionsareusedtodefinethedefaultthresholdforeachquality(Objectivestab>Capacitypage> Services
Definitionframe):
obj ect i ve. 13. condi t i ons. 0. oper ande=1 # "0" means " <" ( l ess t han)
obj ect i ve. 13. condi t i ons. 1. oper ande=0 # "0" means " <" ( l ess t han
obj ect i ve. 13. f i l t er s. count =1
obj ect i ve. 13. f i l t er s. 0. l ayer =cdma
obj ect i ve. 13. f i l t er s. 0. qual i t y=cover age
obj ect i ve. 13. f i l t er s. 0. oper ande=0
obj ect i ve. 13. f i l t er s. 0. t hr eshol d=- 95
[ ACPObj ect i vePage]
combi nat i on. XOR. use=0 # di sabl ed by def aul t
[ ACPCapaci t yPage]
enabl e=0 ( def aul t =1 => capaci t y and l oad bal anci ng enabl ed)
[ ACPTpl Capaci t yPage]
useZoneWei ght =0 ( def aul t =1 => zone wei ght i ng appl i ed on capaci t y t r af f i c)
t r af f i c. f i l e=c: \ t mp\ t r af f i c. bi l
t r af f i c. maps=User densi t y t r af f i c map; envi r onment map
t r af f i c. r esol ut i on=50
qual i t y. gsm. bcch. t hr eshol d=- 85
qual i t y. umt s. r scp. t hr eshol d=- 85
qual i t y. umt s. eci o. t hr eshol d=- 13
qual i t y. cdma. r scp. t hr eshol d=- 85
qual i t y. cdma. r scp. t hr eshol d=- 85
qual i t y. wi max. cover age. t hr eshol d=- 85
qual i t y. wi max. c. t hr eshol d=- 85
qual i t y. wi max. cn. t hr eshol d=20
qual i t y. wi max. ci nr . t hr eshol d=10
227
Thefollowingoptionsareusedtodefinethedefaultqualityusedbyeachtechnologyfortrafficcapturecondition:
Thefollowingoptionisusedtoenabletheloadbalancingfeaturebydefault:
Thefollowingoptionisusedtospecifytheloadbalancingdefaulttargetzone:
2=>computationzone
1=>focuszone
0andabove=>indexofcustomzone
12.2.2.5 DefaultValuesontheReconfigurationTab
Inthe[ACPTplReconfPage]sectionarethesettingsdefiningdefaultvaluesfortheReconfigurationtab.
The following options enable you to define the default reconfiguration that will be done: power, antenna, azimuth, or
mechanicaltiltoptimisation.
qual i t y. l t e. cover age. t hr eshol d=- 85
qual i t y. l t e. c. t hr eshol d=- 85
qual i t y. l t e. cn. t hr eshol d=20
qual i t y. l t e. r sr p. t hr eshol d=- 105
qual i t y. l t e. ci nr . t hr eshol d=10
qual i t y. l t e. r sr q. t hr eshol d=- 12
ser vi ce. gsm. condi t i on. qual i t y=bcch
ser vi ce. umt s. condi t i on. qual i t y=r scp
ser vi ce. cdma. condi t i on. qual i t y=cover age
ser vi ce. wi max. condi t i on. qual i t y=cover age
ser vi ce. l t e. condi t i on. qual i t y=cover age
ser vi ce. f act or =1. 0
ser vi ce. densi t y=30
l oadBal anci ng. enabl e=1 ( def aul t set t i ng i s 0 => l oad bal anci ng f eat ur e di sabl ed)
l oadBal anci ng. t ar get ZoneI dx=- 2
l oadBal anci ng. t ar get =80
l oadBal anci ng. wei ght =1
Whentheoptionsinthissectionaresetto"1",thedefaultreconfigurationoptionisnot
selected.Insteadthereconfigurationoptionisdisabled.
[ ACPTpl Reconf Page]
umt s. di sabl ePi l ot Power Opt i mi sat i on=1
umt s. di sabl eMaxPower Opt i mi sat i on=1
umt s. SyncMul t i Cel l Power =1
umt s. def aul t Power Aut oMi nMax=3 # aut omat i cal l y set mi n/ max power at an of f set of 3dBm
# ar ound act ual val ue. I f 0, use f i xed val ue 37- 46
cdma. 1xr t t . SyncMul t i Cel l Power =1
cdma. 1xevdo. SyncMul t i Cel l Power =1
cdma. 1xr t t . di sabl ePi l ot Power Opt i mi sat i on=1
cdma. 1xr t t . di sabl eMaxPower Opt i mi sat i on=1
cdma. 1xevdo. di sabl eMaxPower Opt i mi sat i on=1
228
Thefollowingoptionsareusedtodefinethedefaultreconfigurationthatwillbedoneontransmittersandsites:
Thefollowingoptionsareusedtospecifydefaultvaluesforthereconfigurationranges:
ThefollowingoptioncanbeusedtodisplayanadditionalconstraintontheTransmitterstaboftheReconfigurationtabthat
willbeappliedtoelectricaltiltchanges.
Whentheoptionaboveissettoone,youcandefinethevariationintheheaderofthenewVariation+column.Thevalue
youenterbesidetheVariation+headerdefinestherangeofelectricaltiltchangeswithrespecttothecurrentelectricaltilt.
cdma. def aul t Power Aut oMi nMax=3 # aut omat i cal l y set mi n/ max power at an of f set of 3dBm
gsm. di sabl ePower Opt i mi sat i on=1
gsm. def aul t Power Aut oMi nMax=3 # aut omat i cal l y set mi n/ max power at an of f set of 3dBm
wi max. di sabl ePr eambl ePower Opt i mi sat i on=1
wi max. SyncMul t i Cel l Power =1
wi max. def aul t Power Aut oMi nMax=3 #aut omat i cal l y set mi n/ max power at an of f set of 3dBm
l t e. di sabl ePower Opt i mi sat i on=1
l t e. SyncMul t i Cel l Power =1
l t e. def aul t Power Aut oMi nMax=3 # aut omat i cal l y set mi n/ max power at an of f set of 3dBm
di sabl eAnt ennaOpt i mi zat i on=1
di sabl eETi l t Opt i mi zat i on=1
di sabl eAzi mut hOpt i mi zat i on=1
di sabl eMechTi l t Opt i mi zat i on=1
di sabl eSi t eSel ect i on=1
def aul t TxAzi mut hVar i at i on=20
def aul t TxAzi mut hSt ep=5
def aul t TxAzi mut hMi nI nt er Sect or =0
def aul t TxTi l t Mi n=0
def aul t TxTi l t Max=5
def aul t TxTi l t St ep=1
def aul t TxETi l t Mi n=0
def aul t TxETi l t Max=10
def aul t TxHei ght Mi n=0
def aul t TxHei ght Max=10
def aul t TxHei ght St ep=5
def aul t TxHei ght Mi n. f eet =0
def aul t TxHei ght Max. f eet =30
def aul t TxHei ght St ep. f eet =15
umt s. di sabl ePi l ot Power Opt i mi zat i on=0
umt s. di sabl eMaxPower Opt i mi zat i on=0
[ ACPReconf Page]
t x. et i l t . del t aLi mi t Const r ai nt . show=1 ( def aul t =0)
229
Forexample,settingavariationof"4"meansthattheACPcanfindanoptimalelectricaltiltthatis4degreesmoreor4degrees
lessthanthecurrentelectricaltilt.Thepossiblerangeisdisplayedforeachantenna.
Eachcellintheelectricaltiltcolumndisplaysacheckboxenablingtheusertodefinewhethertheconstraintshouldbeused,
and the corresponding absolute limit for the electrical tilt. This constraint is an additional constraint on the electrical tilt
configurationoptions.Thefinalelectricaltiltwillbeallowedwithintheintersectionofthetworangeconstraints.
ThefollowingoptioncanbeusedtodefineadefaultvaluefortheVariation+headermentionedabove:
Thefollowingoptionisusedtoautomaticallydisablereconfigurationofalldonors(possiblyincascade)ofarepeater:
Thepossiblevaluesare:
"0",noautolock(thedefaultvalue)
"1",theUsecheckboxesfortransmitterreconfigurationparametersarecleared(antenna,tilt,azimuth,andheight).
Only the last repeater in a series of cascading repeaters is optimised; the rest are cleared by default (but can be
selectedmanually).
"2",theUsecheckboxesforallreconfigurationparametersarecleared(antenna,tilt,azimuth,height,andpower).
Only the last repeater in a series of cascading repeaters is optimised; the rest are cleared by default (but can be
selectedmanually).
"5",thesameasoption"1",exceptthattheUsecheckboxescannotbeselectedintheuserinterface.
"6",thesameasoption"2",exceptthattheUsecheckboxescannotbeselectedintheuserinterface.
12.2.2.6 DefaultValuesontheSitesTaboftheReconfigurationTab
Inthe[ACPTplReconfPage]sectionarethesettingsdefiningdefaultvaluesfortheSitestaboftheReconfigurationtab.
Thefollowingoptionsenableyoutodefinethereconfigurationoptionsthatareselectedbydefault:siteorsectorremovable,
or antenna azimuth or height. The settings of "defaultSiteCellsRemoveable", "defaultSiteRemoveable", and
"defaultSiteHeightLocked"alsodefinethedefaultsettingsforStationTemplateReconfigurationdialogue.
12.2.2.7 DefaultValuesontheTransmittersTaboftheReconfigurationTab
Inthe[ACPReconfPage]sectionarethesettingsdefiningdefaultvaluesforthedisplayofmechanicalandelectricaltilts,and
forthedisplayoflinkedtransmitters.
Thefollowingoptionsareusedtodisplaythemechanicalandelectricaltiltsasrelativevaluesinsteadofabsolutevalues.Asa
result,theMin.andMax.columnswillberenamedtoMin.Offset.andMax.Offset.
et i l t . del t aLi mi t Const r ai nt =4 ( def aul t =0)
aut oLockDonor =0
Whentheoptionsinthissectionaresetto"1",thecorrespondingreconfigurationoption
isselectedbydefault.
# Speci f y t he def aul t val ues f or t he si t e sel ect i on
def aul t Si t eCel l sRemoveabl e=0 # " 0" means Sect or s r emovabl e not sel ect ed by def aul t .
def aul t Si t eRemoveabl e=1 # " 0" means Si t e r emovabl e not sel ect ed by def aul t .
def aul t Si t eAzi mut hLocked=0 # " 0" means Lock Sect or / Azi mut h not sel ect ed by def aul t .
def aul t Si t eHei ght Locked=1 # " 0" means Lock Sect or / hei ght not sel ect ed by def aul t .
# " def aul t Si t eHei ght Locked" i s f or ced t o f al se ( " 0" ) f or si t es t hat have ant ennas
# at di f f er ent hei ght s
def aul t Si t eReconf i gur at i onLocked=0 #" 0" means t hat t he def aul t val ue f or t he Di sabl e
r econf i gur at i on opt i on i s not sel ect ed by def aul t .
[ ACPReconf Page]
t x. t i l t . asRel at i ve=1 ( def aul t =0)
t x. et i l t . asRel at i ve=1 ( def aul t =0)
230
Thefollowingoptionisusedtodisplaytheminimumandmaximummechanicalandelectricaltiltsonlyonceforeachgroupof
linkedtransmitters.
When"tx.etilt.groupMinMax"issetto0,themin/maxmechanicalandelectricaltiltsaredisplayedforeachtransmitter.
12.2.2.8 DefaultValuesonthePatternstaboftheAntennaTab
In the [ACPAntennaPage] section are the settings defining default values for the display of additional constraints on
mechanicalandelectricaltiltvalues.Thefollowingoptionsareusedtodisplaytheseadditionalconstraints:
12.2.2.9 DefaultValuesforEMFExposure
Inthe[ACPTplEMFPage]sectionarethesettingsdefiningdefaultvaluesfortheEMFExposuresectionoftheOptimisationtab.
ThefollowingoptionisusedtoenabletheEMFexposuremodule:
Theoption"weightLevel"enablesyoutodefinethelevelofimportanceaccordedtotheoptimisationofEMFexposure.Thre
arethreepossiblevalues:
0:Low:EMFexposureisoptimisedonlyifdoesnotworsencoveragequality.
1:normal:ThereisatradeoffbetweenEMFexposureandcoveragequality(default).
2:critical:EMFexposureisoptimisedindependentlyoftheeffectitmighthaveoncoveragequality.
ThefollowingoptionsenableyoutodefinethedefaultresolutioninmetresintheX,Y,andZplanes:
ThefollowingoptionsdefinehowEMFexposurewillbemeasuredinbuildings:onlyonthefacadeorinsidethebuildingas
well:
Thefollowingoptiondefineswhetherclutterclassesandclutterheightsareusedtocreatea3Drepresentationoftheterrain
orwhetherjustvectorsaretobeused.Thedefaultis"1"(yes),but,giventhatvectorsarealwaysgivenprioritywherethey
exist,thisoptioncanbedisabledifvectorsareavailablefortheentireareaofinterest.
Thefollowingoptiondefineswhetherthe3Dpropagationmodelisusingdiffraction.Whenitisnot,onlypositionswithadirect
LOStotransmitterswillregisterEMFexposure.
ThefollowingoptiondefineswhethertheEMFmoduleshouldusetransparentmode.Whentransparentmodeisused,no
obstacleorindoorlossisaccountedfor.
Thefollowingoptiondefinesthecalculationradius(inmetres)aroundtransmitterswhencalculatingEMFexposure:
ThefollowingoptionsdefinethedefaultthresholdandweightfortheEMFexposureobjective:
[ ACPReconf Page]
t x. et i l t . gr oupMi nMax=1 ( def aul t =0)
[ ACPReconf Page]
enabl eMTi l t =1 ( def aul t =0)
enabl eETi l t =1 ( def aul t =0)
[ ACPTpl EMFPage]
enabl e=1
wei ght Level =1 # 0=l ow, 1=nor mal , 2=cr i t i cal
r esol ut i onXY=5
r esol ut i onZ=3
onl yFacade=1 # Measur ement onl y on f acade i n bui l di ng pr opagat i on cl asses.
# Def aul t = 1 ( yes)
bui l di ngDeepi ng=10 # i f " onl yFacade" i s set t o 0, t he dept h i n t he bui l di ng measur ed.
useDhmFr omCl ut t er =1 # Def aul t i s " 1" ( yes)
useDi f f r act i on=0
i sWor st Case=0 # Def aul t i s " 0" ( no)
cal cul at i onRadi us=300
231
Thefollowingoptionsenableyoutodefineupto16propagationclassesforEMFexposure.Eachclassisdefinedbyaname,
anindoorloss,andwhetheritcanbeeditedbytheuser.
Thefollowingoptionsenableyoutomapclutterclassestopropagationclasses.Eachmappingisdefinedontwolines:thefirst
linedefinestheclutterclass(byitscodefromtheDescriptiontaboftheClutterClassesPropertiesdialogue);thesecondline
definesthepropagationclass(byitsIDunderPropagationontheOptimisationtaboftheACPSetupdialogue).Thedefault
propagationclassesintheACPare"Open"(ID"0"),"Vegetation"(ID"1"),and"Building"(ID"2").Anyadditionalpropagation
classeswillhaveanIDassignedwhentheyarecreated.
Inthe[ACPEMFPage]section,youcanspecifywhetherornotuserscandefinenewpropagationclasses:
12.2.2.10 ControllingAntennaPatternSmoothing
Crosswave version 4.0.4 has introduced the "AntennaLossesThreshold" option to control the smoothing performed on
antennapatternsingaincalculations.AsimilaroptionhasbeenintroducedinAtollACPforcompliancewithCrosswaveresults.
When"AntennaLossesThreshold"isspecifiedintheCrosswave.inifile,thefollowinglinesmustbeincludedinACP.ini:
where X is a value between 0 and 500 specified by "AntennaLossesThreshold" in Crosswave.ini to increase the specific
thresholdappliedbyCrosswave.
12.2.2.11 DefaultValuesontheAntennasTab
Inthe[ACPAntennaPage]sectionarethesettingsdefiningdefaultvaluesfortheAntennastab.
The following options enable you to define default REGEX pattern that will is used to automatically calculating antenna
groups:
def aul t Obj Thr eshol d=0. 6
def aul t Obj Wei ght =1
ecl ass. count =2 # The t ot al number of pr opagat i on cl asses def i ned.
ecl ass. 0. name=Open
ecl ass. 0. posi t i on=0 # Di st r i but i on of measur ement poi nt s:
# 0=3D, i . e. , di st r i but i on at al l hei ght s over ar ea, 1=2D on t op, 2=2D on bot t om
ecl ass. 0. bui l di ngLos=0
ecl ass. 0. l i near Bui l di ngLos=0
ecl ass. 0. l i near Bui l di ngSt ar t =0
ecl ass. 0. edi t i onFl ag=0 # 0 can not be edi t ed by user
cl ut t er Mappi ng. count =3
cl ut t er Mappi ng. 0. cl ut t er Code=10
cl ut t er Mappi ng. 0. cl assCode=0
[ ACPEMFPage]
i sPr opCl assesExt endabl e=1 # " 1" enabl es user t o cr eat e pr opagat i on cl asses.
[ ACPGener i cPM]
cw. ant ennaLossesThr eshol d = X
[ ACPAnt ennaPage]
aut oGr oupPat t er n=( . *) _
aut oGr oupPat t er n_ant =( . *) _
aut oGr oupPat t er n_gr oup=( . *) _
232
Bysettingthefollowingoptionto"1"(default),ACPwillautomaticallyapplythedefaultantennaconfigurationeachtimea
newsetupiscreated(i.e.,theconfigurationwhichhavehavebeenbackedupbyauser):
Bysettingthefollowingoptionto"1",youenabletheuseofAEDT(additionalelectricaltilt)formanagingdifferentelectrical
tiltoneachantennapattern:
By setting the following option, you can control the internal logic that ACP uses to assign different antenna patterns to
differentfrequencybands.ACPconsidersthatanantennapatternisallowedforagivenfrequencybandifitsbasefrequency
iswithintheallowedrange(inMHz):
12.2.2.12 DefiningtheAntennaMaskingModel
Inthe[ACPAntMaskModelPage]section,youcanfindtheoptionsusedtosetthechoicesavailableunderAntennaMasking
MethodontheSetupTemplatetaboftheACP AutomaticCellPlanningPropertiesdialogue.
You can use the "advancedUI" option to display a column called Delegate Calculation to Model. Using the Delegate
CalculationtoModelcolumn,youcandefinewhethertheACPcalculatesthepathlossmatricesoranglesofincidenceused
in antenna masking or whether it delegates calculation to the propagation model (providing the propagation model
implementstheappropriatemethodsofAtollsAPI).Delegatingcalculationtothepropagationmodelprovidesmoreaccurate
resultsbutmighttakelonger.Additionally,itwillusediskspacetostorethecalculationresults.
Thefollowingoptioncanbeusedtoallow"Optimised"propagationmodels(i.e.,propagationmodelsthatusethe"Optimised"
mode)touse"FullPathLoss"mode:
12.2.2.13 DefiningMultiStoreyOptions
Inthe[ACPGeneralPage]section,youcandefineanoptiontodisplaythemultistoreymodule.Oncedisplayed,theusercan
stillchoosetonotmakeamultistoryoptimisation;the"enable3dMode"onlygovernsthedisplayofthemodule.
12.2.2.14 DefiningReconfigurationValuesinCustomAtollFields
Inthe[ACPCustomFieldExtraction]section,youcansetoptionsthatwillenableACPtoextractdatafromcustomfieldsfrom
tablesintheAtolldatabase.ACPwillextractthevaluesenteredinthecustomfieldsandusethemasdefaultreconfiguration
valueswhenanewoptimisationsetupiscreated.ThevaluesextractedcanbeupdatedintheACPsetup,butACPwillnot
updatetheAtolltableswiththenewvalues.
12.2.2.14.1 DefiningReconfigurationValuesforTransmittersandRepeatersUsingCustomAtollFields
theTransmittersandRepeaterstablesintheAtolldatabase.ThecustomcolumnsintheTransmittersorRepeaterstables
mustmatchthecolumnnamedefinedintheacp.inifile.Bydefault,theACPdoesnotextractcustomfields.
aut oRest or eDef aul t Conf i g=1
enabl eAedt =1
f r eqBandRange=99
[ ACPAnt MaskModel Page]
advancedUI =1 # The def aul t i s " 0" ; t he "Del egat e Cal cul at i on t o Model "
# f eat ur e i s di sabl ed.
nat i veAl l owFul l Pat hLoss=1 # The def aul t i s " 0" ; t he f eat ur e i s di sabl ed.
[ ACPAnt MaskModel Page]
enabl e3dMode=1 # The def aul t i s " 1" ; Set t i ng t he opt i on t o " 0" hi des t he modul e.
Ifavalueisundefinedinacustomfieldforacell,ACPwillusethedefaultvalueforthat
parameter.
[ ACPCust omFi el dExt r act i on]
# The name of t he cust omcol umn i n Tr ansmi t t er s and Repeat er s t abl e use t o
# i ni t i al i ze t he r econf i gur at i on par amet er f or each t r ansmi t t er or r epeat er .
t x. ant enna. opt i mi ze=acp_ant _use # Best t o def i ne t hi s col umn as a Bool ean
t x. ant enna. gr oup=acp_ant _gr oup
233
12.2.2.14.2 DefiningReconfigurationValuesforSecondaryAntennasUsingCustomAtollFields
theSecondaryAntennastableintheAtolldatabase.ThecustomcolumnsintheSecondaryAntennastablemustmatchthe
columnnamesdefinedintheacp.inifile.Bydefault,theACPdoesnotextractcustomfields.Howeve,ifthecustomcolumns
are defined using these options and the column exists in the secondary antenna table, the reconfiguration items are
automaticallyconfiguredusingthesevalues(insteadofusingthevaluesdefinedatthetransmitterlevel).
t x. et i l t . opt i mi ze=acp_et i l t _use
t x. et i l t . mi n=acp_et i l t _mi n
t x. et i l t . max=acp_et i l t _max
t x. t i l t . opt i mi ze=acp_t i l t _use
t x. t i l t . mi n=acp_t i l t _mi n
t x. t i l t . max=acp_t i l t _max
t x. t i l t . st ep=acp_t i l t _st ep
t x. azi mut h. opt i mi ze=acp_azi m_use # r el at i ve val ues f r omcur r ent azi mut h
t x. azi mut h. del t ami n=acp_azi m_del t ami n
t x. azi mut h. del t amax=acp_azi m_del t amax
t x. azi mut h. mi n=acp_azi m_mi n # absol ut e val ue f or azi mut h angl e
t x. azi mut h. max=acp_azi m_max
t x. azi mut h. st ep=acp_azi m_st ep
t x. azi mut h. mi nI nt er Sect or =acp_azi m_i nt er
t x. hei ght . opt i mi ze=acp_hei ght _use
t x. hei ght . del t ami n=acp_hei ght _del t ami n # r el at i ve val ues f r omcur r ent hei ght
t x. hei ght . del t amax=acp_hei ght _del t amax
t x. hei ght . mi n=acp_hei ght _mi n # absol ut e val ue f or hei ght val ues
t x. hei ght . max=acp_hei ght _max
t x. hei ght . st ep=acp_hei ght _st ep
t x. gsm. power . opt i mi ze=acp_gsmpower _use
t x. gsm. power . mi n=acp_gsmpower _mi n
t x. gsm. power . max=acp_gsmpower _max
t x. gsm. power . st ep=acp_gsmpower _st ep
r epeat er . gai n. opt i mi ze=acp_gai n_use
r epeat er . gai n. mi n=acp_gai n_mi n
r epeat er . gai n. max=acp_gai n_max
r epeat er . gai n. st ep=acp_gai n_st ep
Somereconfigurationparameters such asheight andazimuth canbedefinedeither as
relativevalues(i.e.,bydefiningthereconfigurationrangestartingfromthecurrentvalue)
orasabsolutevalues.Youthereforeonlyneedtodefinethesettingsrelevanttothevalue
type(i.e.,relativeorabsolute).
# The name of t he cust omcol umn i n Secondar y Ant enna t abl e use t o
# i ni t i al i ze t he r econf i gur at i on par amet er f or each t r ansmi t t er or r epeat er .
t x. ant enna. opt i mi se=acp_ant _use # Best t o def i ne t hi s col umn as a Bool ean
t x. ant enna. gr oup=acp_ant _gr oup
t x. et i l t . opt i mi ze=acp_et i l t _use
t x. et i l t . mi n=acp_et i l t _mi n
t x. et i l t . max=acp_et i l t _max
t x. t i l t . opt i mi ze=acp_t i l t _use
t x. t i l t . mi n=acp_t i l t _mi n
234
12.2.2.14.3 DefiningReconfigurationValuesforCellsUsingCustomAtollFields
theCellstableintheAtolldatabase.ThecustomcolumnsintheCellstablemustmatchthecolumnnamesdefinedinacp.ini
file.
ThefollowingoptionscanbeusedtodefinethecustomcolumnsintheCdmaCellstable.Bydefault,theACPdoesnotextract
customfields.
The following options can be used to define the custom columns in the WCells table. These will be used for default
reconfigurationoptionsforWiMAXcells.Bydefault,thevalueofeachisundefined;thereforethefieldwillnotbeextracted.
The following options can be used to define the custom columns in the T4GCells table. These will be used for default
reconfigurationoptionsforLTEcells.Bydefault,thevalueofeachisundefined;thereforethefieldwillnotbeextracted.
12.2.2.14.4 DefiningReconfigurationValuesforSitesUsingCustomAtollFields
SitestableintheAtolldatabase.ThecustomcolumnsintheSitestablemustmatchthecolumnnamedefinedbythesettings
intheacp.inifile:
t x. t i l t . max=acp_t i l t _max
t x. t i l t . st ep=acp_t i l t _st ep
t x. azi mut h. opt i mi ze=acp_azi m_use # r el at i ve val ues f r omcur r ent azi mut h
t x. azi mut h. del t ami n=acp_azi m_del t ami n
t x. azi mut h. del t amax=acp_azi m_del t amax
t x. azi mut h. mi n=acp_azi m_mi n # absol ut e val ue f or azi mut h angl e
t x. azi mut h. max=acp_azi m_max
t x. azi mut h. st ep=acp_azi m_st ep
t x. azi mut h. mi nI nt er Sect or =acp_azi m_i nt er
Some reconfigurationparameterssuchasheight andazimuth canbedefinedeitheras
relativevalues(i.e.,bydefiningthereconfigurationrangestartingfromthecurrentvalue)
orasabsolutevalues.Youthereforeonlyneedtodefinethesettingsrelevanttothevalue
type(i.e.,relativeorabsolute).
ccel l . pi l ot Power . opt i mi ze=acp_pi l ot power _use
ccel l . pi l ot Power . mi n=acp_pi l ot power _mi n
ccel l . pi l ot Power . max=acp_pi l ot power _max
ccel l . pi l ot Power . st ep=acp_pi l ot power _st ep
ccel l . maxPower . opt i mi ze=acp_maxpower _use
ccel l . maxPower . mi n=acp_maxpower _mi n
ccel l . maxPower . max=acp_maxpower _max
ccel l . maxPower . st ep=acp_maxpower _st ep
wcel l . power . opt i mi ze=acp_power _use
wcel l . power . mi n=acp_power _mi n
wcel l . power . max=acp_power _max
wcel l . power . st ep=acp_power _st ep
l cel l . power . opt i mi ze=acp_power _use
l cel l . power . mi n=acp_power _mi n
l cel l . power . max=acp_power _max
l cel l . power . st ep=acp_power _st ep
235
Statusofsites:Byusingthe"site.status"optiontodefinethenameofthecustomstatuscolumnintheSitestable,
youcanextractthestatus(candidateorexisting)ofsitesforsiteselection.AllsitesintheSitestablewiththelabelset
totheonedefinedbythe"site.status.candidate"optionwillbeautomaticallysetascandidatesites.Anysiteswitha
labelotherthantheonedefinedbythe"site.status.candidate"optionwillbeconsideredasexistingsites.Bydefault,
allactivesitesareconsideredasexistingsites.
ThefollowingoptionscanbeusedtodefinecustomcolumnsintheSitestable.Thesewillbeusedfordefaultreconfiguration
optionsforeachsite.
Thefollowingoptioncanbeusedtomanagethedisablereconfigurationattribute.
12.2.2.14.5 DefiningReconfigurationValuesforAntennasUsingCustomAtollFields
AntennastableintheAtolldatabase.ACPcanusetheinformationinthecustomfieldstogroupantennasandtosetdefault
reconfigurationvalueswhenanewoptimisationsetupiscreated.ThecustomcolumnintheAntennastablemustmatchthe
columnnamesdefinedintheacp.inifile.
ThefollowingoptioncanbeusedtonamethecustomcolumnintheAntennastabletogroupantennapatternsintogroups
of physical antennas (i.e., all patterns related to the same physical antenna) and group the physical antennas at different
frequencies into radomes by using the "antenna.model" option. Using the "antenna.model" enables you to automatically
formamultibandantenna.TheantennamodelisbydefaultsettothePHYSICAL_ANTENNAcolumnoftheAntennastable.
Hencebydefaulttheautoantennagroupingisalwaysenabledifantennapatternsarecorrectlyassignedtophysicalantennas.
Ifthephysicalantennahasbeendefinedusingthe"antenna.model"option,thefollowingoptioncanbeusedtonamethe
customcolumnintheAntennastablethatisusedtodefineantennagroups.InthecustomcolumnintheAntennastable,all
antennapatternscorrespondingtophysicalantennabelongingtothesamegroupareidentifiedwithauniquestring.TheACP
automaticallygroupsallphysicalantennaintoanewgroupwiththenamegivenbythestringusedinthecolumn.
si t e. st at us=acp_si t e_st at us # Name of t he cust omcol umn i n Si t es t abl e.
# Def aul t val ue i s ' ACP_STATUS' .
si t e. gsm. st at us=acp_si t e_gsm_st at us
si t e. umt s. st at us=acp_si t e_umt s_st at us
si t e. l t e. st at us=acp_si t e_l t e_st at us
si t e. st at us. candi dat e=candi dat e # Name used t o def i ne a candi dat e si t e.
si t e. di sabl eSel ect i on=acp_si t e_di sabl eSel ect i on
si t e. gsm. di sabl eSel ect i on=acp_si t e_gsm_di sabl eSel ect i on
si t e. umt s. di sabl eSel ect i on=acp_si t e_umt s_di sabl eSel ect i on
si t e. l t e. di sabl eSel ect i on=acp_si t e_l t e_di sabl eSel ect i on
si t e. r emoveabl e=acp_si t e_r emoveabl e
si t e. gsm. r emoveabl e=acp_si t e_gsm_r emoveabl e
si t e. umt s. r emoveabl e=acp_si t e_umt s_r emoveabl e
si t e. l t e. r emoveabl e=acp_si t e_l t e_r emoveabl e
si t e. sect or sRemoveabl e=acp_si t e_sect or sRemoveabl e
si t e. gsm. sect or sRemoveabl e=acp_gsm_si t e_sect or sRemoveabl e
si t e. umt s. sect or sRemoveabl e=acp_umt s_si t e_sect or sRemoveabl e
si t e. l t e. sect or sRemoveabl e=acp_l t e_si t e_sect or sRemoveabl e
si t e. azi mLocked=acp_si t e_azi mLocked
si t e. hei ght Locked=acp_si t e_hei ght Locked
si t e. r econf Locked=acp_si t e_r econf Locked
ant enna. model =PHYSI CAL_ANTENNA
236
ThefollowingoptionscanbeusedtonamethecustomcolumnsintheAntennastabletoautomaticallydefinethemechanical
tiltoptions.
ThefollowingoptioncanbeusedtonamethecustomcolumnintheAntennastabletoautomaticallylinkantennaelements
of a multiband physical antenna which have the same electrical tilt. In the ACP Setup dialogue, this is accomplished by
selecting the check box in the Same Elec. Tilt column. The "antenna.etilt.share" option should contain a list of the space
separatedfrequenciesforwhichthecorrespondingphysicalantennamustbelinked(i.e.,physicalantennathatalwaysuses
sameelectricaltilt).
ThefollowingoptionscanbeusedtonamethecustomcolumnsintheAntennastabletoautomaticallydefinetheelectrical
tiltoptions.
12.2.2.15 DefiningSiteClassOptions
YoucansetoptionsintheACP.inifiletodefinesiteclassesintheACP.Youcanbothdefinesiteclassesthatautomatically
appearintheACPSetupdialogueandsetoptionsintheACP.inisothattheACPappliessiteclassesbasedonoptionaldatain
theAtolldatabase.
12.2.2.15.1 DefiningAutomaticSiteClasses
Inthe[ACPGeneralPage]section,youcanfindtheoptionusedtodefinethewhetherthesiteclassfeatureappears.
Thefollowingoptioncanbeusedtoshoworhidethesiteclassfeatureandsetthenumberofsiteclassesdefined:
Inthe[ACPTplGeneralPage]section,youcandefinethedefaultvalueswhenthesiteclassoptionisavailable.Thesesettings
arelocalsettings.
ant enna. gr oup. model =acp_gr oup_model
# The name of t he cust omcol umn i n ANTENNA t abl e of t ype ' bool ' , def i ni ng
# whi ch ant enna pat t er n i s associ at ed wi t h a ' mechani cal t i l t const r ai nt '
ant enna. t i l t . use=ACP_TI LT_USE
# The name of t he cust omcol umns i n ANTENNA t abl e of t ype ' st r i ng' or numer i c,
# def i ni ng t he mechani cal t i l t al l owed r ange. Non- val i d val ues ar e t r eat ed as
# " f or bi dden"
ant enna. t i l t . mi n=ACP_TI LT_MI N
ant enna. t i l t . max=ACP_TI LT_MAX
ant enna. et i l t . shar e=ACP_ETI LT_SHARE
Tooptimisetheelectricaltilt,firstsetthe"enableAedt"and"enableETilt"optionsto"1"
toactivatethem.
# The name of t he cust omcol umn i n ANTENNA t abl e of t ype ' bool ' , def i ni ng
# whi ch ant enna pat t er n i s associ at ed wi t h an ' el ect r i cal t i l t const r ai nt '
ant enna. et i l t . use=ACP_ETI LT_USE
# The name of t he cust omcol umns i n ANTENNA t abl e of t ype ' st r i ng' or numer i c,
# def i ni ng t he AEDT and e- t i l t al l owed r ange. Non- val i d val ues ar e t r eat ed as
# " f or bi dden"
ant enna. et i l t . mi n=ACP_ETI LT_MI N
ant enna. et i l t . max=ACP_ETI LT_MAX
[ ACPGener al Page]
cost . cl asses. showUI =1 # The def aul t i s "1" ; t he si t e cl ass f eat ur e i s enabl ed.
cost . cl asses. count =1 # Number of def i ned cl asses
237
YoucanthendefinethesiteclassesthatwillappeareachtimeanewACPoptimisationiscreatedalongwithpredefinedcosts.
ThenameofeachclassasitappearsintheACPisdefinedbyanoptioncalled"cost.classes.X.name"where"X"isasequential
number.Thecorrespondingsettingsfortheclassdefinedin"cost.classes.X.name"aredefinedusingthefollowingoptions:
cost.classes.X.azimuth.cost:Thiskeyisusedtodefinethecostofchangingtheantennaazimuth.
cost.classes.X.azimuth.isSiteVisit:Thiskeyissetto"true"ifthiscostentailsasitevisit;"false"ifitdoesnot.
cost.classes.X.tilt.cost:Thiskeyisusedtodefinethecostofchangingthemechanicaltiltoftheantenna.
cost.classes.X.tilt.isSiteVisit:Thiskeyissetto"true"ifthiscostentailsasitevisit;"false"ifitdoesnot.
cost.classes.X.antenna.cost:Thiskeyisusedtodefinethecostofchangingthetypeoftheantenna.
cost.classes.X.antenna.isSiteVisit:Thiskeyissetto"true"ifthiscostentailsasitevisit;"false"ifitdoesnot.
cost.classes.X.etilt.cost:Thiskeyisusedtodefinethecostofchangingtheelectricaltiltoftheantenna.
cost.classes.X.etilt.isSiteVisit:Thiskeyissetto"true"ifthiscostentailsasitevisit;"false"ifitdoesnot.
cost.classes.X.height.cost:Thiskeyisusedtodefinethecostofchangingtheantennaheight.
cost.classes.X.height.isSiteVisit:Thiskeyissetto"true"ifthiscostentailsasitevisit;"false"ifitdoesnot.
cost.classes.X.power.cost:Thiskeyisusedtodefinethecostofchangingthepower.
cost.classes.X.power.isSiteVisit:Thiskeyissetto"true"ifthiscostentailsasitevisit;"false"ifitdoesnot.
cost.classes.X.siteVisitCost:Thiskeyisusedtodefinethecostofasitevisit.
cost.classes.X.upgradeSiteCost:Thiskeyisusedtodefinethecostofupgradinganexistingsite.
cost.classes.X.newSiteCost:Thiskeyisusedtodefinethecostofcreatinganewsite.
cost.classes.X.removeSiteCost:Thiskeyisusedtodefinethecostofremovinganexistingsite.
Thefollowingisanexampleofthekeysforthefirstsiteclass(numbered"0")called"Planned"inthisexample.
12.2.2.15.2 AutomaticAssignmentofSiteClassesintheACP
In the [ACPCustomFieldExtraction] section, you can define the custom field in the Sites table of the Atoll database that
identifiesthesiteclassofeachsite.
ThesiteclassdefinedintheSitestablewillbeassignedautomaticallywhenanACPoptimisationisdefined.Fornewcandidate
siteswhicharelocatedonanexistingsite,thesiteclassisthesameasthesiteonwhichthenewcandidateislocated.Fornew
candidatesiteswhicharenotcolocatedonanexistingsite,thesiteclassissetto"Default"andcanbechangedmanually.
cost . cl asses. count =1 # Number of def i ned cl asses
cost . cl asses. 0. name=Pl anned
cost . cl asses. 0. azi mut h. cost =1
cost . cl asses. 0. azi mut h. i sSi t eVi si t =t r ue
cost . cl asses. 0. t i l t . cost =1
cost . cl asses. 0. t i l t . i sSi t eVi si t =t r ue
cost . cl asses. 0. ant enna. cost =1
cost . cl asses. 0. ant enna. i sSi t eVi si t =t r ue
cost . cl asses. 0. et i l t . cost =0. 1
cost . cl asses. 0. et i l t . i sSi t eVi si t =f al se
cost . cl asses. 0. hei ght . cost =1
cost . cl asses. 0. hei ght . i sSi t eVi si t =t r ue
cost . cl asses. 0. power . cost =0. 1
cost . cl asses. 0. power . i sSi t eVi si t =f al se
cost . cl asses. 0. si t eVi si t Cost =2
cost . cl asses. 0. upgr adeSi t eCost =5
cost . cl asses. 0. newSi t eCost =10
cost . cl asses. 0. r emoveSi t eCost =- 5
You must first create the corresponding custom column in the Sites table of the Atoll
databaseandassignasiteclasstoeachsiteinthiscolumnforthisoptiontohaveeffect.
si t e. cost Cl ass=[ name of cust omf i el d i n Si t e t abl e]
238
Bydefiningthecostsofeachsiteclassasexplainedin"DefiningAutomaticSiteClasses"onpage 236,thecoststructureis
automaticallydefinedaswell.
12.2.2.16 DefiningtheAppearanceoftheOptimisationDialogue
Inthe[ACPMapPage]and[ACPMapDefault]sectionsarethesettingsdefiningtheappearanceoftheOptimisationdialogue
thatappearswhenrunninganoptimisation.SomeoptionsrefertotheGraphstabandsometotheQualityMapstab.
12.2.2.16.1 DefiningtheColoursintheQualityAnalysisMaps
Thefollowingsettingsinthe[ACPMapDefault]sectionareusedtodefinethecoloursusedinthequalityanalysismapsonthe
QualityMapstab.
Therearetwopossibleformatsfordefiningtherangeofcoloursonmaps:
1. Detailedformat:Thedetailedformatenablesyoutosetanonuniformrange.Thenumberofrangesisdefinedand,
foreachrange,theminimumandmaximumvalueoftherangefollowedbyitsRGBcolorrepresentation.
2. Uniformformatdescription:Auniformformatdescriptionusingarangeandstep:[firstBreakstartcolor][lastBreak
endColor]interval:
Thesecolormapdescriptionsareusedfordefaultcolormapandcaneasilybechangedbytheuser.Thesettingsarethesame
forthevariousqualityindicatorofthevarioustechnologies,whereyoureplace:
<techno>withumts,gsm,lte,wimax,cdma
<quality>with:
InUMTS:ecio,ec,ecgain,eciogain
InGSM:sl,slgain,
InWiMAX:sl,slC,slCN,cinr,slgain,cinrgain
InLTE:sl,slC,slCN,rsrp,cinr,rsrq,slgain,cinrgain
Inaddition,anumberofothercolormapscanbedefinedforothertypeofmaps:
colormap.overlapandcolormap.overlapgainforoverlapmaps
colormap.objectiveandcolormap.objective.gainforobjectivestatusmaps
colormap.bestcell.ttiltandcolormap.change.ttiltforcombinedelectrical/mechanicaltiltmaps
andafewothersforchangemaps,emfmaps,etc.Thedefaultacp.inifileinstalledwiththeACPhasacompletelist
12.2.2.16.2 OtherComponentsoftheOptimisationDialogue
Thefollowingsettingsinthe[ACPMapPage]sectionareusedtodefineothercomponentsoftheOptimisationdialoguethat
appearswhenrunninganoptimisation.SomeoptionsrefertotheGraphstabandsometotheQualityMapstab.
The following options define the background and foreground colours of the Quality Maps tab, with the RGB code as an
integer:
TheRGBcodeforwhiteiscalculatedasfollows: .
ThefollowingoptionsdefinethepixelsizeusedinthemapsontheQualityMapstab.YoucanletACPautomaticallydefine
thepixelsizeoryoucandefinethepixelsize:
col or map. <t echno>. <qual i t y>. nbRange=8 # Number of r anges t o be def i ned
col or map. <t echno>. <qual i t y>. r ange. 0=[ - 99999. 000000 - 15. 000000] RGB( 0 0 255)
col or map. <t echno>. <qual i t y>. r ange. 7=[ - 3. 000000 99999. 000000] RGB( 255 0 0)
col or map. <t echno>. <qual i t y>. r angeDef i ni t i on=[ - 5 RGB( 255 0 0) ] [ - 20 RGB( 0 0 255) ] - 5
conf i g. backgr ound=0 # RGB code as i nt eger ( R+G*2^8+B*2^16) : her e bl ack
conf i g. f or egr ound=16777215 # RGB code as i nt eger ( R+G*2^8+B*2^16) : her e whi t e
conf i g. i sAut oPi xel =1 # Aut omat i cal l y cal cul at e poi nt si ze f r omcover age sur f ace
conf i g. pi xel Si ze=1 #I f aut opi xel i s not set , use t hi s number of pi xel s f or each poi nt
255 255 2
8
255 2
16
16777215 = + +
239
ThefollowingoptionsdefinethesizeofthemaptitleontheQualityMapstab:
ThefollowingoptiondefinesthewidthofthemargininpixelsontheQualityMapstab:
ThefollowingoptionsdefinetheappearanceofthemaplegendontheQualityMapstab:
ThefollowingoptiondefineswhethertheaxisisdisplayedontheQualityMapstab:
ThefollowingoptionsdefinetheappearanceofthehistogramontheQualityMapstab:
ThefollowingoptionsdefinetheappearanceofthefocuszoneontheQualityMapstab:
12.2.2.17 DefiningtheAppearanceofPredictions
Inthe[ACPMapDefault]sectionistheoptionfordefiningtheappearanceofpredictionscreatedfromoptimisationresults.
Thefollowingoptiondefinesthetransparencyofpredictions:
12.2.2.18 DefiningNewPredictions
Inthe[ACPNewMapDlg]sectionareoptionsfordisplayingadditionalpredictionsthatcanbecreatedfromsetupsandfrom
theoptimisationresults.
Setting the option "showBestServerAerialMap" enables the user to create a prediction that displays the initial and final
coveragebyantenna.
Settingtheoption"showObjectiveWeightMap"enablestheusertocreateapredictionthatdisplaystheweightusedforthe
trafficandforeachzone.
Settingtheoption"showBestServerTxMap"enablestheusertocreateapredictionthatdisplaystheinitialandfinalcoverage
bytransmitter.
conf i g. pi xel Cover age=50 # I f aut opi xel i s set , cal cul at e t he pi xel si ze of a poi nt
t o t r y t o cover t he set per cent age of t he used sur f ace
conf i g. maxPi xel Si ze=6 # I f aut opi xel i s set , l i mi t t he pi xel si ze t o t he set maxi mum.
conf i g. t i t l eHei ght =16 # Ti t l e hei ght i n pi xel s
conf i g. t i t l eFont Si ze=16 # Si ze of t i t l e f ont i n poi nt s
conf i g. mar gi n=2
conf i g. showLegend=1 # Def i nes whet her t he l egend i s di spl ayed.
conf i g. l egendWi dt h=40 # Def i nes t he wi dt h of t he l egend i n pi xel s.
conf i g. l egendFont Si ze=11 # Def i nes t he f ont used i n poi nt s.
conf i g. l egendFor egr ound=0 # RGB code as i nt eger : her e bl ack
conf i g. showAxi s=1
conf i g. showHi st ogr am=1 # Def i nes whet her t he hi st ogr ami s di spl ayed.
conf i g. hi st ogr amHei ght =60 # Def i nes t he wi dt h of t he hi st ogr ami n pi xel s.
conf i g. showFocusZone=1 # Def i nes whet her t he f ocus zone i s di spl ayed.
conf i g. f ocusLi ght er Per cent =30 # Def i nes how much l i ght er t he ar ea out si de t he f ocus
zone i s di spl ayed.
t r anspar ency=50
[ ACPNewMapDl g]
showBest Ser ver Aer i al Map=1 # " 1" di spl ays t he opt i on, " 0" hi des t he opt i on
[ ACPNewMapDl g]
showObj ect i veWei ght Map=1 # " 1" di spl ays t he opt i on, " 0" hi des t he opt i on
[ ACPNewMapDl g]
showBest Ser ver TxMap=1 # " 1" di spl ays t he opt i on, "0" hi des t he opt i on
240
Settingtheoption"showchangeImprovementMap"enablestheusertocreateapredictionthatdisplaystheimprovementin
coverage.
Settingtheoption "showSectorSelectionMap"enables the user tocreate a prediction thatdisplays the addedorremoved
sectorsduringsiteselection.
Settingtheoption"showTotTilt"enablestheusertocreateapredictionthatdisplaysthetotaltilt(electricalandmechanical).
12.2.2.19 DefiningtheFunctionalityoftheCommitTab
Inthe[ACPCommitPage]sectionistheoptionfordefiningwhethertheusercanonlyeditthesetofchangestobecommitted
ontheChangeDetailstab(default).Setting"allowUserChangeForCommit"to"true"allowstheusertoeditthesetofchanges
ontheCommittab;thissettingisnotrecommended.
Youcanusethe"addCandidateComment"optiontocreateacommentinanysite,transmitter,andcellsautomaticallycreated
byACPinAtollaspartofthecandidatesiteselection.Nocommentisaddedifthisoptionisleftblank.
12.2.2.20 DefiningtheAppearanceoftheOverlayWindow
Inthe[ACPOverlayDialog]sectionistheoptionfordefiningtheopacityoftheoverlaywindowwhenitlosesfocus.Avalueof
100disablesit.
12.2.2.21 DefiningtheAppearanceoftheGraphTab
Inthe[ACPGraphPage]sectionistheoptionforenablingthedisplayoftimemarkersontheGraphtaboftheOptimisation
Propertiesdialogue.Avalueof100disablesit.
12.2.2.22 DefiningtheDefaultFont
In the [ACPUI] section is the option for defining the default font to be used by the grid, graph component, and map
component.Intheexamplebelow,thefont"MSUIGothic,"usedinJapanesesystems,issetasthedefaultfont.
12.2.2.23 ExportingOptimisationResultsinXML
Inthe[ACPXmlReport]sectionaretheoptionsfordefiningthecontentsandappearanceofanXMLreportgeneratedfromthe
StatisticstaboftheoptimisationPropertiesdialogue.
[ ACPNewMapDl g]
showchangeI mpr ovement Map=1 # " 1" di spl ays t he opt i on, " 0" hi des t he opt i on
[ ACPNewMapDl g]
showSect or Sel ect i onMap=1 # " 1" di spl ays t he opt i on, " 0" hi des t he opt i on
[ ACPNewMapDl g]
showTot Ti l t =1 # " 1" ( def aul t ) di spl ays t he opt i on, " 0" hi des t he opt i on
[ ACPCommi t Page]
al l owUser ChangeFor Commi t =f al se
[ ACPCommi t Page]
addCandi dat eComment =Cr eat ed f r omACP candi dat e l i st
[ ACPOver l ayDi al og]
opaci t y=100
[ ACPGr aphPage]
showTi meMar ker s=1 # add t i me mar ker s on t he X axi s. Def aul t i s " 0" ( OFF)
[ ACPUI ]
# def i ne t he f ont used by gr i d, gr aph component and map component
Def aul t Font =MS UI Got hi c
# f or gr i d onl y, def i ne t he used f ont si ze. 0 mean def aul t si ze
Def aul t Gr i dFont Si ze=0
enabl eXml Expor t =1 #enabl e t he xml r epor t f r omt he Resul t St at Page
241
12.2.2.24 ChangingtheColourLegendfortheOptimisationGraph
Inthe[ACPColorsDefault]sectionaretheoptionsfordefiningthedefaultcoloursintheOptimisationwindow(duringand
afterarun).Thesedefaultcolourscanbedefinedineitherofthefollowingformats:
ThefollowingarethedefaultcolourcodesforthegraphsintheOptimisationwindow(ontheGraphstabduringarun)andin
theOptimisationresultsafterarun(ontheChangeDetailsandGraphtabs)
ThefollowingarethedefaultcolourcodesforthehistogramintheOptimisationwindow(ontheChangestabduringarun).
gener at eXml Sect i on=- 1 # bi t combi nat i on of f ol l owi ng: 1=met adat a, 2=set up,
4=r esul t Summar y, 8=r esul t Sect or s, 16=r esul t I t er at i ons, 32=r esul st Changeset ,
64=r esul t Maps. , - 1=al l
encodi ng=UTF- 8
saveDef aul t St yl esheet =1 #save a def aul t st yl esheet i f none exi st
def aul t St yl esheet Name=. acpRepor t . xsl t # name of t he def aul t st yl esheet f i l e. set i t
empt y t o di sabl e st yl esheet pr ocessi ng i nst r uct i on
gr aph. umt s1 = RGB( 0 0 255)
or
gr aph. umt s1 = 0000FF - > RGB hexadeci mal col or code as used i n HTML
gr aph. umt s1 = B34700 ( samecolourcodesareusedinCDMA)
gr aph. umt s2 = FF6600
gr aph. umt s3 = FFB380
gr aph. gsm1 = 660099
gr aph. gsm2 = D580FF
gr aph. gsm3 = EABFFF
gr aph. wi max1 = 458A8A ( samecolourcodesareusedinWiFi)
gr aph. wi max2 = 30BFBF
gr aph. wi max3 = 66FFFF
gr aph. l t e1 = FFD100
gr aph. l t e2 = 999900
gr aph. l t e3 = d9cc7f
gr aph. obj 1 = FF000D ( colourcodesusedformultitechnologyobjectivesinmultitechnologyoptimisations)
gr aph. obj 2 = 3600FF
gr aph. obj 3 = 18FF00
gr aph. obj 4 = FFD100
gr aph. cost = 99FF99 ( colourcodeforfinancialcost)
gr aph. expos = 3737A6 ( colourcodeforEMFexposure)
gr aph. l oad = f 9f 602 ( colourcodesforloadbalance)
gr aph. l oadqi = f 9bb02
gr aph. t r af = a27901
change. ant enna = RGB( 0 0 255)
change_et i l t = RGB( 64 224 208)
change_azi mut h = RGB( 0 255 0)
change_t i l t = RGB( 255 255 0)
change_power = RGB( 193 0 66)
change_hei ght = RGB( 255 173 93)
change_t xRemoved = FFCDE8
change_si t eRemoved = FF99CC
change_si t eAdded = 99CCFF
change_t xAdded = 5D927D
change_r epGai n = 660099
242
12.2.3 ACPCoreEngineOptions
Thesettingsinthe[ACPCore]sectionareusedtodefinehowtheACPenginefunctions.
12.2.3.1 LogFileSettings
ACPenablesyoutosetupalogfileaswellascreateacrashreportincaseofanapplicationcrash.
ThefollowingoptiondefineswhetherACPgeneratesalogfile(withthenameATL_NAME_optim.log):
12.2.3.2 CalculationThreadPoolSettings
The following options define how the calculation thread pool will be managed. If "useComputationThreadPool" is set to
"false,"ACPusesonlyonethread.If"useComputationThreadPool"issetto"true,"ACPusesthenumberofthreadsspecified
bythe"computationThreadPoolSize"option.Thedefaultsettingfor"computationThreadPoolSize"is"1"andmeansthatACP
willuseonethreadperprocessorcore(CPU)available.
12.2.3.3 NumberofThreadsUsedforPropagationModelCalculations
Thefollowingoptiondefineshowmanythreadsthepropagationmodelcanusewhencalculations(forexample,ofheightor
angles of incidence) are delegated to the propagation model. This can be useful, for example, to control the number of
licensestakenbytheACP,withoutreducingthenumberofthreadsusedbyregularACPcalculations.Thefollowingsettings
arepossible:
2:Thedefaultvaluemeansthatthepropagationmodelwillusethesamenumberofthreadsasthatdefinedbythe
"computationThreadPoolSize"option.
1:Autoconfiguration;thepropagationmodelwilluseonethreadforeachCPUcore.
Other: Entering a numerical value for "pathlossThreadPoolSize" indicates the number of threads the propagation
modelcanuse.
12.2.3.4 MemoryManagementSettings
ThefollowingoptionsdefinehowtheACPmanagesmemoryduringcalculations.
TheACPtriestoestimatetheworstcasescenarioinmemoryuse,andindicatestotheuserwhenmemoryuseseemstoohigh.
Usingoneofthefollowingoptions,youcandefinethemethodACPusestoindicateexcessivememoryuse:
memLimitNumPos:Memoryuseisdeterminedtobeexcessivewhenthemaximumnumberofpixels,asdefinedin
"memLimitNumPos"isreachedduringacalculation.Setting"memLimitNumPos"to"1"deactivatesthisoption.
memLimitMemory:MemoryuseisdeterminedtobeexcessivewhentheestimatedmemoryuseinMb,asdefinedin
"memLimitMemory"isreachedduringacalculation.Setting"memLimitMemory"to"1"deactivatesthisoption.
memLimitUseableMemory:Memoryuseisdeterminedtobeexcessivewhentheestimatedmemoryuseexceedsthe
percentage of the total memory available for Atoll, as defined in "memLimitUseableMemory." Setting
"memLimitUseableMemory"to"1"deactivatesthisoption.
Ifallthreeoptionsaredeactivated,ACPdoesnotcheckexcessivememoryusage.
The"abortIfMemLimitReach"optiondefineshowACPreactsifthedefinedmaximummemoryuseisreached.Bydefault(with
"abortIfMemLimitReach" set to"0"),ACP willattemptto allocatememory. Ifunabletosuccessfullyallocate memory, ACP
displaysamessageandthecalculationisstopped.Whenusingtheoption"abortIfMemLimitReach",thenACPwillnotstartif
themessageindicatingexcessivememoryuseisdisplayed.
By default, excessive memory use is considered an estimate of 80% of the memory available to the process; ACP is not
preventedrunningevenwhen80%isexceeded.
[ ACPCor e]
gener at eLogFi l e=0 # The def aul t i s " 0" ; no l og f i l e.
[ ACPCor e]
useComput at i onThr eadPool =t r ue
comput at i onThr eadPool Si ze=- 1
[ ACPCor e]
pat hl ossThr eadPool Si ze=- 2 # Def aul t . Same as comput at i onThr eadPool Si ze.
When ACP estimates actual memory use (i.e., using either "memLimitMemory" or
"memLimitUseableMemory"),thememoryestimateisonlyaroughestimate.Depending
ontheproject,actualmemoryusagecanbequitedifferent.
243
12.2.3.5 SignalLevelandMacroDiversityGainCalculationOptions
ThefollowingoptionsdeterminehowACPcalculatesthesignallevelandthemacrodiversitygainmode.
12.2.3.5.1 SignalLevel
YoucandefinehowACPmeasuresthesignallevel(UMTSRSCP,GSMBCCHPower,WiMAXPreamblePower,LTEReference
signalPower,CDMApilotpower)usingthe"linkMode"option.The"linkMode"optioncanhaveoneofthefollowingvalues:
0:When"linkMode"issetto"0,"ACPconsidersthesignallevelonthedownlinkandtransmissionlossesaretaken
intoaccount.Thisisthedefaultsetting.
1: When "linkMode" is set to "1," ACP considers the signal level on the uplink and reception losses are taken into
account.
2:When"linkMode"issetto"2,"ACPdoesnottakereceptionortransmissionlossesintoaccount.
12.2.3.6 AutomaticCandidatePositioningOptions
Thefollowingoptiondefinestheminimumdistancethatmustberespectedbetweenanautomaticallycreatedcandidateand
anexistingsiteorapredefinedcandidatesite.IfAtollcannotcreateanautomaticcandidatesiteandrespectthisdistance,
no candidate will be created. The default value is 25% of the intersite distance defined in the Automatic Candidate
Positioningdialogue.
Thefollowingoptiondefinesthedefaultintercandidatesitedistanceinmetres.
TheACPnormallyplacescandidatesitesinastricthexagonalpattern.However,theACPcansearchforamoreappropriate
sitewithinasearchradiusratioaccordingtothedefinedrules.Thefollowingoptiondefinesthedefaultsearchradiusratioas
apercentageofthedefinedintercandidatesitedistance.
Thefollowingoptiondefinesthedefaultminimumincreaseinaltitude(inmetres)thattheACPmustfindwhenplacinganew
automaticcandidatesite.
12.2.3.7 BalancingSpeed,MemoryUse,andAccuracyinCalculations
OntheUserPreferencestaboftheACPAutomaticCellPlanningPropertiesdialogue,ACPenablesyoutoselectamodeof
operationthatbalancesbalancespeed,memoryuse,andaccuracy.Bydefiningthesettingsoftheoptionsintheacp.inifile
thateachmodeuses,youcanfinetunehowACPwilloperateintheselectedmode:
High Speed: Using the highest speed also uses the least memory although the final results might be slightly less
accurate.
Default: When no changes are made to the acp.ini file, ACP uses the default settings. The default settings can be
overriddenbychangingthesettingsinthissection.
HighPrecision:Whenthesettingsinthissectionaredefinedtogivetheresultsofthehighestprecision,calculating
theresultswilltakethelongesttimeandwillusemorememory.
Theoptionsdescribedbelowarethoseusedforthedefaultoperationmode
Theacp.inioptionsthatdefinehowtheselectedmodeworksaredescribedbelow:
memLi mi t NumPos=- 1 # A set t i ng of "- 1" deact i vat es t hi s opt i on.
memLi mi t Memor y=- 1 # A set t i ng of "- 1" deact i vat es t hi s opt i on.
memLi mi t Useabl eMemor y=80 # A set t i ng of " - 1" deact i vat es t hi s opt i on.
abor t I f MemLi mi t Reach=0
l i nkMode = 0 # The def aul t
addPi l ot SHOGai n=1 # The def aul t
useSi t eAl t i t ude=1 # The def aul t
[ ACPAut oCandPosDl g]
mi nI nt er Si t eDi st Rat i o=0. 25 # Def aul t
i nt er Si t eDi st =500
sear chRadi usRat i o=30
hpHei ght Thr es=10
244
maxMonitorCell:The"maxMonitorCell"definesthemaximumnumberofcellsmonitored.Thisoptionaffectsmemory
use and accuracy. The analogous options for the high speed mode and the high precision mode are
"maxMonitorCellSpeed"and"maxMonitorCellPrec",respectively.
threshLevelMonitorCell: The "threshLevelMonitorCell" defines the best server signal threshold (dB) in order to be
monitored.Thisoptionaffectsmemoryandaccuracy.
Theanalogousoptionsforthehighspeedmodeandthehighprecisionmodeare"threshLevelMonitorCellSpeed"and
"threshLevelMonitorCellPrec",respectively.
ThefollowingoptionsdefinethevaluesACPusesfordefaultmode:
ThefollowingoptionsdefinethevaluesACPusesforhighspeedmode:
ThefollowingoptionsdefinethevaluesACPusesforhighprecisionmode:
Otheroptionsintheacp.inifilecanbeusedtodefineadditionaloffsetsthatwillbeusedbythespecifictechnologythatACP
isoptimising:
12.2.3.8 AccessingRasterData
Whenworkingincoplanningmode,youhaveseveralAtolldocumentsopenandyouareworkingwiththeACPfromthemain
document.ACPneedstoaccessrasterdataandbydefaultitaccessesonlytherasterdataspecifiedinthemaindocument.If
forsomereasondifferentrasterdataisusedinthesecondarydocument,youmustsettheACPtoaccessrasterdataforeach
documentseparatelyusingthefollowingoption:
AtollACPloadsrasterdatawithblockbasedprocessingtoreducememoryusage.Themaximummemory(inMb)allowedfor
thisblockprocessinginMbiscontrolledwiththefollowingsetting:
YoucanreducethisnumberifyouexperienceissueswithACPfailureduetomemoryallocation.
12.2.3.9 AccessingPathLossMatrices
YoucandefinehowACPaccessespathlossmatricesusingthe"pathlossAccessMode"option.Thisoptionhastwopossible
values:
0:Ifthisoptionissetto"0,"ACPwillaccesspathlossmatricesthroughAtoll.
1:Ifthisoptionissetto"1,"ACPwillaccesspathlossmatricesdirectly.Withthissetting,thepathlossmatricesmust
bestoredexternally;theycannotbeembedded.
2:Ifthisoptionissetto"2,"ACPwillaccesspathlossmatricesdirectlyiftheyareexternal,otherwisethroughAtollif
theyareembedded.Thisisthedefaultvalue.
maxMoni t or Cel l =32
t hr eshLevel Moni t or Cel l = 35
maxMoni t or Cel l Speed=30
t hr eshLevel Moni t or Cel l Speed = 30
maxMoni t or Cel l Pr ec=35
t hr eshLevel Moni t or Cel l Pr ec = 40
t hr eshLevel Of f Umt s=0
maxMoni t or Of f Umt s=0
t hr eshLevel Of f Gsm=0
maxMoni t or Of f Gsm=0
t hr eshLevel Of f Wi max=5
maxMoni t or Of f Wi max=5
t hr eshLevel Of f Lt e=10
maxMoni t or Of f Lt e=10
gi sDat aTechnoShar ed=0
gi sDat aCacheMemMax=256
pat hl ossAccessMode=2
245
12.2.3.10 FilteringClutterClassLayers
Whenusingseverallayersofrasterclutterclasses,eachwithadifferentresolution,youcandefinewhichresolution(usually
thelowerresolution)ACPshouldusewhendefiningzonesbyclutterclass.Settingthe"gisDataClutterOnlyRes"optionto"0"
(thedefault)meansthatclutterclasslayerswillnotbefilteredoutbyresolution.Settingthisoptiontoanyothervalue(for
example,"20")meansthatACPwillonlyuseclutterclasseswiththatresolution(inthiscalse,"20").
Ifyousetthe"gisDataClutterOnlyRes"optiontofilteroutallclutterclassesbutthosewiththedefinedoption,youshouldalso
listtheclutterclassesthatarenottobeusedinthe"zone.clutter.hiddenCodes"inthe[ACPGeneralPage]sectiontoensure
thattheuserwillnotcreatezonesbasedonclutterclassesthatarenotused.Whenyoudefinetheclutterclassesthatarenot
used,theywillnotbedisplayedintheZoneDefinitiondialogue.
12.2.3.11 PreambleSegmentation(WiMAX)
YoucandefinehowACPtakessegmentationintoaccountusingthe"wimaxPreambleSegmented"option.Thisoptionenables
youtotakeintoaccountthechangeinchangeincalculationmethodsfromversion2.7.1toversion2.8.0ofAtoll.Inversion
2.7.1, the preamble was not considered as segmented unless the frame configuration used by the cell was flagged as
segmented.Inversion2.8.0,thepreambleisconsideredbydefaulttobesegmented.
Thisoptionhasthepossiblevalues:
0:ThisvalueisintendedforversionsofAtolluptoandincludingversion2.7.1.Ifthisoptionissetto"0,"ACPwillonly
takepreamblesegmentationintoaccountifthesegmentationflagofcellframeconfigurationissettoON.
1:ThisvalueisintendedforversionsofAtollof2.8.0andup.Ifthisoptionissetto"1,"ACPalwaystakespreamble
segmentationintoaccount.
2:Ifthisoptionissetto"2,"ACPautomaticallydetectstheversionofAtollused.Thisisthedefaultvalue.
12.2.3.12 FixedRatioBetweenPilotPowerandMaxPower(UMTS)
WhenoptimisingthemaximumcellpowerinUMTS,theACPforcestheratiobetweenpilotpowerandmaximumpowerto
stayconstant.Youcanremovethisconstraintusingthefollowingoption:
12.2.3.13 EnablingMultitechnologyOptimisationIncludingWiMAX
InordertousetheACPtooptimiseyourWiMAXnetworkwithanyothertechnologynetwork(GSM,UMTS,orLTE),setthe
followingoptioninACP.ini:
12.2.4 EMFExposureCoreOptions
Inthe[ACPEMFCore]sectionthereareseveraloptionscontrollingtheEMFexposurecalculationengine.
Onesetofoptionsallowsforthedetectionandautocorrectionoftransmitterheightswhicharefoundtobeindoors,just
belowtheroof.Thisisusuallycausedbyinconsistenciesbetweenthevectorsimportedtocreatethe3Drepresentationofthe
terrainandAtolldatabase.
Theotheroptioncontrolstheresolutionusedinternallytorasteriseinputvectors,thedefaultbeing2 metres.
Whenthe heightofatransmitteriswithintheDigitalHeightModel(i.e., thecombinationofclutterheightsand imported
vectorsusedtocreatethe3Drepresentationoftheterrain)andDHMoffset,thenitisconsideredtobeindoors,justbelow
[ ACPCor e]
gi sDat aCl ut t er Onl yRes=20 # ACP wi l l onl y use cl ut t er cl asses wi t h t hi s r esol ut i on
[ ACPGener al Page]
zone. cl ut t er . hi ddenCodes=0, 1, 2, 12, 13 # These cl ut t er cl asses ar e not di spl ayed
wi maxPr eambl eSegment ed=2
umt sPi l ot Power Rat i oFi xed=0
[ ACPI mpor t Pr oj ect ]
i mpor t Wi max=1 ( def aul t =0)
ThisoptionisonlyvalidforcoplanningsupportbetweenWiMAXandsingleRANGSM,
UMTS,andLTEdocuments,notwithmultiRATprojects.
246
the roof. The ACP automatically detects these transmitters and displays warnings in the Event Viewer. The default
distancebeneaththeroofis5 metres.
TheACPcanautomaticallyadjusttheheightoftransmittersthatarebelowroofsothattheyareontopoftheclutterheight
usingthedefinedoffset(inmetres).
Thefollowingoptiondefinestheinternalresolutioninmetresforterrain3DrepresentationwhentheACPrasterisesinput
vectors:
ThefollowingoptionallowsyoudecreasethedisplayedEMFlevelwhenpenetrationlossisincreasedforbuildings.
flagPixelFacadeDistdefinestheindoordistancefromfaadeforapixeltobeconsideredas"indoor".Whenthedistanceis0,
theoutdoorpixelswillbeappliedtheindoorpenetrationlossspecifiedinthePropagationClassDefinitiontable(Propagation
pageontheOptimisationtab).
12.2.5 OtherOptions
Inthe[ACPMisc]sectionareseveraladditionalACPconfigurationoptions.
12.2.5.1 ValidityofCoveragePredictions
Youcanusethefollowingoptiontoenableordisabletheautomaticverificationofthevalidityofcoveragepredictionsbefore
runninganoptimisationsetup.
Thefollowingoptionscanbeusedtoenableotherautomaticverificationsonthenumberofactivetransmitters,theirpathloss
filesize,andlockedstatusintheAtolldocument:
If"autoCheckPredictionValidity"issetto"1,"therebyenablingtheverificationofthevalidityofcoveragepredictions,youcan
haveACPautomaticallyrecalculatetheinvalidcoveragepredictionsusingthefollowingoption.Ifitissetto"0,"ACPwillnot
automaticallyrecalculatepredictions.
[ ACPEMFCor e]
det ect TxI ndoor Of f set =5
r eset TxHei ght WhenI ndoor =0 # " 0" i s t he def aul t ; hei ght i s not r eset .
vect or Rast er i zat i onResol ut i on=2 # " 2" i s t he def aul t .
f l agPi xel FacadeDi st =0 # " 0" i s a di st ance i n met r es.
aut oCheckPr edi ct i onVal i di t y=1 # " 1" enabl es t he aut omat i c ver i f i cat i on
aut oCheckPr edi ct i onFi l eVal i di t y=1 # Check of pat h l oss mat r i ces bef or e a r un.
aut oCheckTxNumber =1 # Check number of act i ve t r ansmi t t er s.
manageLockedPr edi ct i onAsval i d=1 # Tr eat l ocked pr edi ct i on as al ways val i d.
# Def aul t i s " 1" ( t r ue)
aut oPat hl ossRecomput at i on=0
Part3
"GSMGPRSEDGEDataStructure"onpage 249
"UMTSHSPADataStructure"onpage 281
"LTEDataStructure"onpage 341
"3GPPMultiRATDataStructure"onpage 371
"CDMA2000DataStructure"onpage 313
"TDSCDMADataStructure"onpage 407
"WiMAXandWiFiDataStructure"onpage 439
"MicrowaveLinksDataStructure"onpage 469
DataStructures
Thispartoftheadministratormanualprovidesinformationonthe
datastructuresoftheAtolltechnologymodules.
AT320_AM_E2 Chapter13:GSMGPRSEDGEDataStructure
249
13 GSMGPRSEDGEDataStructure
TheGSMGPRSEDGEdatastructureisdescribedbelow.Figure 13.1onpage 249,Figure 13.2onpage 250,andFigure 13.3on
page 251 depict theGSMGPRSEDGE database structure. The following subsections list the tables in the GSMGPRS EDGE
templatedatastructure.
Figure 13.1:GSMGPRSEDGETemplate1
250
Chapter13:GSMGPRSEDGEDataStructure Forsk2013
251
13.1 ChangesinDataStructureFrom3.1to3.2
13.1.1 AddedTablesandFields
AntennasTable
CustomFieldsTable
Field Type Description Attributes
ELECTRICAL_AZIMUTH Float Antennaelectricalazimuth
Nullcolumnallowed:Yes
Defaultvalue:
DISPLAY_TYPE Integer 0=Fieldismodifiable;1=Fieldisreadonly
Defaultvalue:0
252
EGPRSServicesTable
EGPRSServicesUsageTable
EGPRSTerminalsTable
SitesTable
TplTransmittersTable
TransmittersTable
TRGsTable
MIN_THROUGHPUT_UL Float Uplinkminimumuserthroughputrequestedfortheservice
Defaultvalue:15
PRIORITY Short Servicepriority(0:lowest)
Defaultvalue:0
UL_VOLUME Float
Volumetransferredontheuplinkduringasession(forpacketswitched
services)
Defaultvalue:
PMIN Float Minimumreceiverpowerontrafficchannelsnottoexceed
Defaultvalue:40
SUPPORT_INFO Text(50) Typeofsupport(pylon,tower,etc.)usedatthesite
Defaultvalue:
NOISE_FIGURE Float
Totalnoisefigureusedtodeterminethethermalnoiseatthe
transmitter
Defaultvalue:
REUSE_DISTANCE Float Typicalreusedistanceforassignments
Defaultvalue:
RXLOSSES Float Lossesontheuplinkduetotransmitterradioequipment
Defaultvalue:
SIDE_TILT Float Mechanicalsidetiltofthemainantenna
Nullcolumnallowed:
Defaultvalue:
NOISE_FIGURE Float
transmitter
Defaultvalue:5
Defaultvalue:
Defaultvalue:0
Nullcolumnallowed:
Defaultvalue:0
VAMOS_RATIO Float
PercentageofVAMOS(VoiceservicesoverAdaptiveMultiuserchannels
onOneSlot)trafficinthesubcell.
Defaultvalue:0
253
13.1.2 DeletedTablesandFields
SitesTable
SUPPORT_NATURE
13.2 AfpModelsTable
ForAFPmodels.
13.3 AntennasTable
Forantennas.
DATA Binary Modelspecificparameters
Defaultvalue:
DESCRIPTION
Text
(255)
Userdefined
Defaultvalue:
NAME Text(50) NameoftheAFPmodel
Nullcolumnallowed:No
Defaultvalue:
SIGNATURE Text(40) UniqueGlobalIDoflastmodelupdate
Defaultvalue:
TYPE Text(50) ProgIDofthemodel
Defaultvalue:
Beamwidth Float Antennabeamwidth
Defaultvalue:
COMMENT_
Text
(255)
Additionalinformationaboutantenna
Defaultvalue:
CONSTRUCTOR Text(50) Antennamanufacturername
Defaultvalue:
DIAGRAM Binary Antennahorizontalandverticalpatterns
Defaultvalue:
Defaultvalue:
ELECTRICAL_TILT Float Antennaelectricaltilt(forinformation)
Defaultvalue:
FMax Double
Maximumoperatingfrequencyoftheantennas
Unit:MHz
Defaultvalue:
FMin Double
Minimumoperatingfrequencyoftheantenna
Unit:MHz
Defaultvalue:
GAIN Float
Antennaisotropicgain
Unit:dBi
Defaultvalue:0
NAME Text(50) Nameofantenna
Defaultvalue:
PHYSICAL_ANTENNA Text(50) Physicalantennaname
Defaultvalue:
Theformatofthebinaryfield,DIAGRAM,isdescribedin"RF2DAntennaPatternFormat"
onpage 113.
254
13.4 BSICDomainsTable
FornamesofBSICdomains.
13.5 BSICGroupsTable
ForBSICgroupsbelongingtoBSICdomains.
13.6 BTSEquipmentsTable
ForBTSequipment.
13.7 CellTypesTable
Forcelltypes.
NAME Text(50) Nameofthedomain
Defaultvalue:
DOMAIN_NAME Text(50) Calledgroupingscheme.Setofresourcegroups.
Defaultvalue:
EXCLUDED
Text
(225)
ListofBSICstobeexcludedfromtheseriesdefinedbyFIRST,LASTand
STEP(separatedwithcommas)
Defaultvalue:
EXTRA
Text
(225)
BSICtobeadded.ItisforbiddenforEXTRAandEXLUDEDtohave
commonnumbers
Defaultvalue:
FIRST Integer
Groupelementsare:FIRST,FIRST+STEP,FIRST+2*STEP,,
FIRST+n*STEP.nisthegreatestpositiveintegersothatFIRST+n*STEP
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
NAME Text(50) Uniquekey.Nameofaresourcegroup
Defaultvalue:
STEP Integer
LAST.
Defaultvalue:1
TheFIRSTandLASTfieldsofthistableareoftypeIntegerinthetemplate(.mdb)andina
database (if connected to one). But these fields are of type Text when accessed or
retrievedfromanaddin.
CONFIG_DL_LOSSES Float
DownlinklossesduetotheconfigurationoftheBTS(duplexerand/or
combiner)
Defaultvalue:0
CONFIG_UL_LOSSES Float
UplinklossesduetotheconfigurationoftheBTS(duplexerand/or
combiner)
Defaultvalue:0
NAME Text(50) NameofBaseStationEquipment
Defaultvalue:
NOISE_FIGURE Float NoisefigureofBaseStation
Defaultvalue:0
RHO_FACTOR Short Rhofactor(notused)
Defaultvalue:100
255
13.8 ChannelModelsTable
Forchannelmodels.
13.9 CodecEquipmentsTable
Forcodecconfigurations.
13.10 CodecModeAdaptationsTable
Forcodecmodeselection.
13.11 CodecModesTable
Forcodectypesandmodes.
NAME Text(50) DefinesthelistofTRXsofthestationandassociatedparameters.
Defaultvalue:
NAME Text(50) Nameofthechannelmodel
Defaultvalue:
TX_DIV_GAIN Float GainappliedforsubcellsusingTXdiversity
Defaultvalue:0
IDEAL_LINK_ADAPTATION Boolean Automaticmodeselectionprovidingthebestquality
Defaultvalue:True
IDEAL_QI_NAME Text(20) Referencequalityindicatornameusedforideallinkadaptation
Defaultvalue:
NAME Text(50) NameofCodecequipment
Defaultvalue:
REFERENCE_NOISE Float Receiverreferencenoise
Defaultvalue:113
CODEC_EQT Text(50) Codecequipmentname
Defaultvalue:
CODEC_MODE Text(50) Codecmode
Defaultvalue:
FREQUENCY_BAND Text(20) FrequencyBand(empty=allbands)
Defaultvalue:
HOPPING Short Frequencyhopping1=NH;2=idealFH;empty=allhoppingmodes
Defaultvalue:
MAL_LENGTH Integer MALlength
Defaultvalue:
MIN_CIR Float
C/(I+N)qualitythresholdforselectingthismodewhenthereisnoideal
linkadaptation
Defaultvalue:0
MOBILITY Text(50) Mobility(empty=allmobilities)
Defaultvalue:
_8PSK_MODULATION Boolean Modulationis8PSK
Defaultvalue:False
256
13.12 CodecQualityTablesTable
Forcodecperformancegraphs.
13.13 CoordSysTable
Fortheprojectioncoordinatesystemandthedatabasesinternalcoordinatesystem(thisisthedisplaycoordinatesystem
usedwhencreatingadatabase).
CODEC_TYPE Text(50) Nameofcodectype
Defaultvalue:
HR Boolean Halfratesupport
Defaultvalue:False
MAX_RATE Float Maximumsupportedrateforthismode(kbps)
Defaultvalue:0
NAME Text(50) Nameofthecodecmode
Defaultvalue:
SELECTION_PRIORITY Short Priorityvalueusedtoselectthebestpossiblemode
Defaultvalue:0
C_I_TABLE Memo QI=f(C/I)table
Defaultvalue:
C_N_TABLE Memo QI=f(C/N)table
Defaultvalue:
CODEC_EQT Text(50) Codecequipmentname
Defaultvalue:
CODEC_MODE Text(50) Codecmode
Defaultvalue:
Defaultvalue:
HOPPING Short Frequencyhopping1=NH;2=idealFH;empty=allhoppingmodes
Defaultvalue:
Defaultvalue:
Defaultvalue:
QI_NAME Text(20) Qualityindicatorname
Defaultvalue:
CODE Integer
Identificationnumberofthecoordinatesystem(thecodeofuser
definedcoordinatesystemsisanintegerhigherthan32768)
Defaultvalue:0
DATUM_CODE Double
Defaultvalue:0
DATUM_ROTX Double Arcseconds
Defaultvalue:0
DATUM_ROTY Double Arcseconds
Defaultvalue:0
DATUM_ROTZ Double Arcseconds
Defaultvalue:0
DATUM_SCALE Double Partspermillion(ppm)
Defaultvalue:0
DATUM_SHIFTX Double Meters
Defaultvalue:0
257
13.14 CustomFieldsTable
Fordefininguserdefinedfieldsaddedtotables,defaultvaluesforanyfield(includinguserdefinedfields),andchoicelists,
captions,andgroupnamesforuserdefinedfields.
DATUM_SHIFTY Double Meters
Defaultvalue:0
DATUM_SHIFTZ Double Meters
Defaultvalue:0
ELLIPS_CODE Integer
Defaultvalue:0
ELLIPS_RMAJOR Double Meters
Defaultvalue:0
ELLIPS_RMINOR Double Meters
Defaultvalue:0
NAME Text(50) Coordinatesystemname
Defaultvalue:
PROJ_ANGLE Double Decimaldegrees
Defaultvalue:0
PROJ_FALSE_EASTING Double Meters
Defaultvalue:0
PROJ_FALSE_NORTHING Double Meters
Defaultvalue:0
PROJ_FIRST_PARALLEL Double Decimaldegrees
Defaultvalue:0
PROJ_LATITUDE_ORIGIN Double Decimaldegrees
Defaultvalue:0
PROJ_LONGITUDE_ORIGIN Double Decimaldegrees
Defaultvalue:0
PROJ_METHOD Short
UTM,Undefined,NoProjection,Lambert1SP,Lambert2SP,Mercator,
CassiniSoldner,TransMercator,TransMercatorSO,
ObliqueStereographic,NewZealandMapGrid,HotineOM,LabordeOM,
SwissObliqueCylindical
Defaultvalue:0
PROJ_SCALE_FACTOR Double
Defaultvalue:0
PROJ_SECOND_PARALLEL Double Decimaldegrees
Defaultvalue:0
PROJ_ZONE_NUMBER Integer UsedwithUTM
Defaultvalue:0
CAPTION Text(50) Captionofthefield(displayedinsteadofthename)
Defaultvalue:
CHOICE_LIST Memo Choicelistforthefield
Defaultvalue:
CHOICE_TYPE Integer 0:ChoiceListisoptional;1:ChoiceListismandatory
Defaultvalue:0
COLUMN_NAME Text(50) Secondpartoftheuniquekey.Fieldname
Defaultvalue:
DEFAULT_VALUE Text(50) Defaultvalueforthefield
Defaultvalue:
Defaultvalue:0
GROUP_NAME Text(50) Nameofthegrouptowhichthatfieldbelongs
Defaultvalue:
258
See"TablesandFields"onpage 139forrecommendationsandinformationonuserdefinedfields.
13.15 EGPRSCodingSchemesTable
ForGPRS,EGPRS,andEGPRS2codingschemes.
13.16 EGPRSDimensioningModelTable
Fornetworkdimensioningmodels.
13.17 EGPRSEnvironmentDefsTable
Fortrafficenvironmenttypes.
TABLE_NAME Text(50) Firstpartoftheuniquekey.Tablename
Defaultvalue:
CS_NUMBER Short Codingschemenumber
Defaultvalue:1
DATA_CODING Short TypeofFECcoding(0:Convolutional,1:Turbo)
Defaultvalue:0
MAX_THROUGHPUT Float
Maximumrateobtainedwhenthereisnodatatransmissionerror
Unit:kbps
Defaultvalue:1
MODULATION Short Modulation(0:GMSK,1:8PSK,2:QPSK,3:16QAM,4:32QAM)
Defaultvalue:0
NAME Text(50) Nameofthecodingscheme
Defaultvalue:
TECHNOLOGY Text(15) Technology("GPRS","GPRS/EDGE","EGPRS2")
Defaultvalue:GPRS
MAX_CHANNELS Text(4) MaximumnumberofTRXsthatcanbeallocated
Defaultvalue:16
MAX_TRXS_TO_ADD_FOR_P
ACKET
Integer
MaximumallowednumberofTRXstoaddinordertoreachrequired
qualityforpacketswitchedservices
Defaultvalue:100
MIN_DEDICATED_PDCH Integer Minimumdedicatedtimeslotsnumberforpacketswitchedtraffic
Defaultvalue:0
NAME Text(50) ServiceName
Defaultvalue:
PDCH_BLOCKING_PROBA_KP
I
Boolean BlockingprobabilityKPI
Defaultvalue:False
PDCH_DELAY_KPI Boolean ServicedelayKPI
Defaultvalue:False
PDCH_THROUGHPUT_MIN_K
PI
Boolean MinimumthroughputKPI
Defaultvalue:True
QUEUING_MODEL Text(50) Queuingmodel:ErlangB,ErlangC
Defaultvalue:ErlangB
DENSITY Float
Numberofsubscribersperkm
2
Defaultvalue:0
ENVIRONMENT Text(50) Environmentname
Defaultvalue:
MOBILITY Text(50) Typeofmobility
Defaultvalue:
259
13.18 EGPRSEquipmentsTable
ForGPRS,EGPRS,andEGPRS2configurations.
13.19 EGPRSMobilityTable
Formobilitytypes.
13.20 EGPRSQualityTable
ForGPRS,EGPRS,andEGPRS2performancegraphs.
13.21 EGPRSServiceQualityTable
Forgraphsusedforthepacketswitchedtrafficdimensioning.
USER_PROFILE Text(50) Userprofile
Defaultvalue:
NAME Text(50) Equipmentname
Defaultvalue:
REFERENCE_NOISE Float
Referencenoiseoftheequipmentwhichhasbeenusedtoproducethe
curves
Defaultvalue:113
TECHNOLOGY Text(15)
GSM,GPRSorGPRS/EDGE.Toallocatetraffictocompatibletransmitter
mobilepair.
Defaultvalue:GPRS
NAME Text(50) Nameofmobilitytype
Defaultvalue:
SPEED Float Averagespeed(km/h)
Defaultvalue:
C_THRESHOLD Float
Minimumpower(C)requiredatthereceiverinorderforacoding
schemetobeused
Defaultvalue:1
C_THROUGHPUTS Memo Setofvaluesusedtogeneratethroughput=f(C)graph
Defaultvalue:
COVERI_THRESHOLD Float
Minimumcarriertointerferenceratio(C/I)requiredatthereceiverin
orderforacodingschemetobeused
Defaultvalue:1
COVERI_THROUGHPUTS Memo Setofvaluesusedtogeneratethethroughput=f(C/I)graph
Defaultvalue:0
CS_NAME Text(10) Codingschemename
Defaultvalue:
EQUIPMENT Text(50) Typeofequipment
Defaultvalue:
Defaultvalue:
HOPPING Short
Hoppingmodecorrespondingtothecurves(1=NH;2=idealFH;empty=
allhoppingmodes)
Defaultvalue:
Defaultvalue:
Defaultvalue:
260
13.22 EGPRSServicesTable
Forservices.
13.23 EGPRSServicesUsageTable
Foruserprofileparameters.
AVAIL_CONNECTIONS Float Numberofavailableconnections
Defaultvalue:1
DIMENSIONING_MODEL Text(50) Nameofthedimensioningmodel
Defaultvalue:
LOAD_BLOCKING_PROBA Memo SetofvaluesusedtogeneratethechartBlocking=f(Load)
Defaultvalue:1
LOAD_DELAY Memo SetofvaluesusedtogeneratethechartDelay=f(Load)
Defaultvalue:1
LOAD_RF Memo
Setofvaluesusedtogeneratethechartthroughputreduction
factor=f(Load)
Defaultvalue:1
DL_ACTIVITY Float Activityfactorforvoiceservicesonthedownlink
Defaultvalue:1
DL_MBR Float DLMaximumThroughput
Defaultvalue:0
MAX_BLOCKING_RATE Float
Maximumprobabilitythatapacketisblocked(delayed),GoSforcircuit
switchedservices
Defaultvalue:2
MAX_DELAY Float Maximumdelayallowedfortheservice
Defaultvalue:1
MAX_TS_SUPPORT Integer Maximumnumberoftimeslotssupportedbytheservice
Defaultvalue:4
MIN_THROUGHPUT Float Minimumuserthroughputrequestedfortheservice
Defaultvalue:15
MIN_THROUGHPUT_RATIO Float
Dimensioningtargetofthe%ofsurfacewhereminimumthroughputis
reached
Defaultvalue:95
MIN_THROUGHPUT_UL Float Minimumuserthroughputrequestedfortheservice
Defaultvalue:15
Defaultvalue:1
Defaultvalue:0
REQ_AVERAGE_UL_RATE Float RequestedAverageUplinkRate(kbps)
Defaultvalue:
TH_OFFSET Float Offsetwhichshouldbeaddedtothescalefactor
Defaultvalue:0
TH_SCALE_FACTOR Float PercentageofenduserthroughputcomparedtoMACthroughput
Defaultvalue:95
TYPE Short Typeofservice(0:circuit;1:packet;2:circuitoverpacket)
Defaultvalue:0
UL_ACTIVITY Float Activityfactorforvoiceservicesontheuplink
Defaultvalue:1
UL_MBR Float ULMaximumThroughput
Defaultvalue:0
261
13.24 EGPRSTerminalsTable
Forterminaltypes.
13.25 EGPRSTrafficEnvironmentsTable
Fortrafficenvironmentclutterweighting.
CALL_DURATION Float Averagedurationofacall(forcircuitswitchedservices)
Defaultvalue:
CALL_NUMBER Float
Averagenumberofcallsperhourforcircuitswitchedservicesor
averagenumberofsessionsperhourforpacketswitchedservices
Defaultvalue:0
DL_VOLUME Float
Volumetransferredonthedownlinkduringasession(forpacket
switchedservices)
Defaultvalue:
SERVICE Text(50) Servicethatthesubscribercanrequest
Defaultvalue:
TERMINAL Text(50) Typeofterminalusedbythesubscriberfortheservice
Defaultvalue:
UL_VOLUME Float
services)
Defaultvalue:
USER_PROFILE Text(50) Userprofilename
Defaultvalue:
CODEC_EQUIPMENT Text(50) AssociatedCodecEquipment(forvoiceservices)
Defaultvalue:
DL_AVAIL_CARRIERS Short Numberofsimultaneouscarriers
Defaultvalue:1
DL_AVAIL_TIME_SLOT Float Numberoftimeslotsthemobileterminalcanmultiplexindownlink
Defaultvalue:1
DTX Boolean DTXcapabilityofterminal
Defaultvalue:True
EGPRS_EQUIPMENT Text(50) AssociatedGPRS/EDGEequipment(forPSservices)
Defaultvalue:
MAX_CS Short Highestcodingscheme(CS)availableforGPRS
Defaultvalue:4
MAX_MCS Short Highestcodingscheme(MCS)availableforEDGE
Defaultvalue:12
NAME Text(50) Terminalname
Defaultvalue:
NOISE_FIGURE Float Noisefigureoftheterminal
Defaultvalue:8
PMAX Float MaxpowerthatcanbeusedinUL(forULcalculations)
Defaultvalue:33
Defaultvalue:40
PRIMARY_BAND Text(50) Frequencybandthemobileterminaliscompatiblewith
Defaultvalue:
SAIC Boolean
TerminalcapabilityforSingleAntennaInterferenceCancellation(for
futureuse)
Defaultvalue:False
SECONDARY_BAND Text(50)
Frequencybandthemobileterminaliscompatiblewith(fordualband
mobileterminals)
Defaultvalue:
TECHNOLOGY Text(15) Technologysupportedbythemobileterminal
Defaultvalue:
262
13.26 EGPRSUserProfilesTable
Fornamesofuserprofiles.
13.27 FeederEquipmentsTable
Forfeeders.
13.28 FrequencyBandsTable
Forfrequencybands.
13.29 FrequencyDomainsTable
Forfrequencybandsbelongingtofrequencydomains.
CLUTTER_WEIGHTS Binary Internalbinaryformatdescribingweightsassignedtoeachclutterclass
Defaultvalue:
NAME Text(50) Nameofthecreatedenvironment
Defaultvalue:
NAME Text(50) Nameofthecreateduserprofile
Defaultvalue:
CONNECTOR_LOSSES_DL Float Feederconnectorlossesindownlink
Defaultvalue:0
CONNECTOR_LOSSES_UL Float Feederconnectorlossesinuplink
Defaultvalue:0
LOSS_PER_METER Float Feederlosspermeter
Defaultvalue:0
NAME Text(50) NameofFeeder
Defaultvalue:
CHANNEL_WIDTH Double
Widthofeachphysicalchannelcomposingthefrequencyband
Unit:kHz
Defaultvalue:1
EXCLUDED_CHANNELS
Text
(255)
Physicalchannelsyoudonotwanttoallocate
Defaultvalue:
FIRST_CHANNEL Integer Numberofthefirstphysicalchannelavailableinthenetwork
Defaultvalue:0
FREQUENCY Double
Frequencyofthedownlinkcarrier
Unit:MHz
Defaultvalue:1000
LAST_CHANNEL Integer Numberofthelastphysicalchannelavailableinthenetwork
Defaultvalue:0
MAX_CHANNEL_NUM Integer ExtendedChannelOffset(usedforbandEGSM)
Defaultvalue:
MULTIPLEX_FACTOR Integer Numberoflogicalchannelscomposingaphysicalchannel
Defaultvalue:1
NAME Text(20) Nameofthefrequencyband
Defaultvalue:
263
13.30 FrequencyGroupsTable
Forfrequencygroupsbelongingtofrequencydomains.
13.31 HSNDomainsTable
FornamesofHSNdomains.
13.32 HSNGroupsTable
ForHSNgroupsbelongingtoHSNdomains.
FREQUENCY_BAND_NAME Text(50) Nameofthefrequencybandonwhichdomainisbased
Defaultvalue:
NAME Text(50) Nameofdomain
Defaultvalue:
Defaultvalue:
EXCLUDED
Text
(255)
ListoffrequenciestobeexcludedfromtheseriesdefinedbyFIRST,LAST
andSTEP(separatedwithcommas)
Defaultvalue:
EXTRA
Text
(225)
Frequenciestobeadded.ItisforbiddenforEXTRAandEXLUDEDtohave
commonnumbers
Defaultvalue:
FIRST Integer
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
NAME Text(50) Uniquekey.NameofaResourceGroup
Defaultvalue:
STEP Integer
LAST.
Defaultvalue:1
NAME Text(50) NameofHSN(HoppingSequenceNumber)domain.
Defaultvalue:
Defaultvalue:
EXCLUDED
Text
(225)
ListofHSNstobeexcludedfromtheseriesdefinedbyFIRST,LASTand
STEP(separatedwithcommas)
Defaultvalue:
EXTRA
Text
(225)
HSNstobeadded.ItisforbiddenforEXTRAandEXLUDEDtohave
commonnumbers
Defaultvalue:
FIRST Integer
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
NAME Text(50) Uniquekey.nameofaResourceGroup
Defaultvalue:
264
13.33 InterNetChProtectTable
Forinternetworkinterferencereductionfactorgraphs.
13.34 LayersTable
ForHCSlayers.
13.35 NeighboursTable
Forintratechnologyneighbourrelations.
13.36 NeighboursConstraintsTable
Forintratechnologyneighbourallocationconstraints.
STEP Integer
LAST.
Defaultvalue:1
ICP Memo Internetworkchannelprotection=f( MHz)
Defaultvalue:
ITF_BW Double Interferingbandwidth(kHz)
Defaultvalue:0
ITF_TECHNO Text(50) Interferingtechnology
Defaultvalue:
V_BW Double Victimbandwidth(kHz)
Defaultvalue:0
A
MAX_SPEED Float Thresholdspeedforamobileconsideredeligibletoresideonalayer
Defaultvalue:300
MIN_PRIORITY_POWER Float MinimumpowervaluefortheHCSlayer
Defaultvalue:130
NAME Text(50) Nameofthehierarchicalcellstructurelayer
Defaultvalue:
PRIORITY Short Priorityofthelayer(largestvaluehasthehighestpriority)
Defaultvalue:1
IMPORTANCE Float Handoverimportance(forAFPuse)
Defaultvalue:1
NEIGHBOUR Text(50) Secondpartoftheuniquekey.Listofneighbours
Defaultvalue:
REASON Integer
Reasonoftheneighbourhood
Choicelist:0=Manual;1=Forced;2=Cosite;3=Adjacent;4=Symmetric;
5=Distance;6=Coverage;
Defaultvalue:0(Manual)
TRANSMITTER Text(50) Firstpartoftheuniquekey.Transmittersorcells
Defaultvalue:
TYPE Text(50) Typeoftheneighbourhood(handover,measurement)
Defaultvalue:
Defaultvalue:
265
13.37 NeighboursConstraintsExtTable
Forintertechnologyneighbourallocationconstraints.
13.38 NeighboursExtTable
Forintertechnologyneighbourrelations.
13.39 NetworksTable
Fornetworklevelparameters.
Defaultvalue:
STATUS Integer
Typeofconstraintontheneighbourhoodrelationship.Constraintis
usedinautomaticallocation.
Choicelist:0=Forced;1=Forbidden;
Defaultvalue:0
TRANSMITTER Text(50) Firstpartoftheuniquekey.Transmittersorcells.
Defaultvalue:
Defaultvalue:
NEIGHBOUR Text(50) Secondpartoftheuniquekey.Listofneighboursfromanotherproject.
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
Defaultvalue:
NEIGHBOUR Text(50) Secondpartoftheuniquekey.Listofneighboursfromanotherproject
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
DEFAULT_MODEL Text(50) Defaultpropagationmodel
Defaultvalue:
DEFAULT_RESOLUTION Float Defaultcalculationresolution
Defaultvalue:50
DMAX Float Maximumradiusforacell
Defaultvalue:1
INTERFERERS_RX_THRESH Float Interferers'receptionthreshold
Defaultvalue:130
NAME Text(50)
Defaultvalue:
266
13.40 PropagationModelsTable
Forpropagationmodels.
13.41 QualityIndicatorsTable
Forqualityindicators(BER,BLER,etc.).
13.42 ReceiversTable
Forreceiverparameters.
SHARED_RESULTS_FOLDER
Text
(255)
Sharedresultsstoragefolder
Defaultvalue:
SYSTEM_ Text(50) Nameofthesystem
Defaultvalue:GSM
TECHNOLOGY Text(10) Nameofthetechnology
Defaultvalue:TDMA
THERMAL_NOISE Float Thermalnoise
Defaultvalue:121
Data Binary Modelspecificparameters
Defaultvalue:
Description
Text
(255)
Userdefined
Defaultvalue:
Name Text(50) Nameofthepropagationmodel
Defaultvalue:
Signature Text(40) UniqueGlobalIDoflastmodelupdate
Defaultvalue:
Type Text(50) ProgIDofthemodel
Defaultvalue:
CS_QI Boolean FlagwhichindicatesifthisindicatorisusedinCSservices
Defaultvalue:True
MEAS_PARAM Short
NameofthemeasuredfigureusedforthisQIdetermination
Choicelist:1=C;2=CIR;
Defaultvalue:1
NAME Text(20) Nameofthemanagedqualityindicator
Defaultvalue:
PS_QI Boolean FlagwhichindicatesifthisindicatorisusedforPSservices
Defaultvalue:True
USE_INTERPOLATION Boolean FlagwhichindicatesifthisQImustbeinterpolatedornot
Defaultvalue:True
ADJ_CHANNEL_PROT Float Protectionagainstinterferingsignalsfromadjacentchannels.
Defaultvalue:18
ANTENNA Text(50) Receiverantennaname(ifemptyanomniantennaisused)
Defaultvalue:
HEIGHT Float Heightofthereceiver
Defaultvalue:1.5
LOSS Float Lossesduetoreceiverradioequipment(upanddownlink)
Defaultvalue:0
267
13.43 RepeaterEquipmentsTable
Forrepeaterequipment.
13.44 RepeatersTable
Forrepeaters.
NAME Text(50) Receivername
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
MANUFACTURER Text(50) Manufactureroftherepeaterequipment
Defaultvalue:
MAX_AMPLIFIER_GAIN Float Maximumgainoftheamplifier(dB)
Defaultvalue:90
MAX_OUTPUT_DL Float Maximumdownlinkoutputpower(dBm)
Defaultvalue:30
MAX_OUTPUT_UL Float Maximumuplinkoutputpower(dBm)
Defaultvalue:12
MIN_AMPLIFIER_GAIN Float Minimumgainoftheamplifier(dB)
Defaultvalue:50
NAME Text(50) Nameoftherepeaterequipment
Defaultvalue:
NOISE_FIGURE Float RepeaternoiseFigure(dB)
Defaultvalue:5
STEP_AMPLIFIER_GAIN Float Stepofamplifiergain(dB)
Defaultvalue:1
TIME_DELAY Float Timedelayintheequipment(microseconds)
Defaultvalue:5
AMPLIFIER_GAIN Float Gainoftheamplifier
Defaultvalue:80
AZIMUT Float Azimuthofthedonorsideantenna
Defaultvalue:0
DONOR_CELLID Text(50) Nameofthedonortransmitter
Defaultvalue:
DONOR_LINK_LOSS Float Loss(dB)betweendonoranddonorsideoftherepeater
Defaultvalue:0
DONOR_LINK_TYPE Short 1Offair2Microwave3Fibre
Defaultvalue:1
DONOR_PROPAG_MODEL Text(50)
Nameofthepropagationmodelusedtocalculatepredictionbetween
donorandrepeater
Defaultvalue:
DOWNTILT Float Downtiltofthedonorsideantenna
Defaultvalue:0
EIRP Float EIRPoftherepeater
Defaultvalue:0
EQUIPMENT_NAME Text(50) Ifnoequipment,therepeaterisapassivecomponent
Defaultvalue:
FEEDER_NAME Text(50) Nameofthedonorsidefeeder
Defaultvalue:
268
13.45 SecondaryAntennasTable
Foradditionalantennas.
13.46 SeparationRulesTable
Fordefaultseparationconstraintsbetweeneachtypeofsubcells.
13.47 SeparationsTable
Forseparationconstraintsbetweentypesofsubcells.
FEEDERLENGTH Float Lengthofdonorsidefeeder
Defaultvalue:0
HEIGHT Float Heightofthedonorsideantenna
Defaultvalue:25
REC_ANTENNA Text(50) Nameofthedonorsideantenna
Defaultvalue:
REC_FEEDERLENGTH_UL Float Lengthofdonorsideuplinkfeeder
Defaultvalue:0
TX_ID Text(50) Nameofthetransmitter(andofthetransmitterusedforcoverage)
Defaultvalue:
Repeater properties are saved in two tables: the donorside parameters are in the
RepeaterstableandthecoveragesideparametersintheTransmitterstable.
TherepeaterEIRPtakenintoaccountincalculationsisstoredintheRepeaterstable
(theEIRPcolumnoftheTransmitterstableisnotused).
ANTENNA Text(50) Nameoftheantennainstalledonthetransmitter
Defaultvalue:
AZIMUT Float Secondpartoftheuniquekey.Azimuthoftheantenna
Defaultvalue:0
PERCENT_POWER Float Percentageofpowerdedicatedtothesecondaryantenna
Defaultvalue:0
REDT Float Remoteelectricaltiltforsecondaryantenna
Defaultvalue:0
TILT Float Mechanicaldowntiltofthesecondaryantenna
Defaultvalue:0
TX_ID Text(50) Firstpartoftheuniquekey.Transmittername
Defaultvalue:
DEFAULT_MIN_SEP Short Minimumseparationrequirement
Defaultvalue:1
RELATION_TYPE Short Typeoftherelation:1=CoSubcell;2=CoCell;3=CoSite;4=Neighbour
Defaultvalue:1
TRX_TYPE Text(15) TypeofTRXorAll
Defaultvalue:All
TRX_TYPE_OTHER Text(15) TypeofTRXorAll
Defaultvalue:All
MIN_SEP Integer Minimumseparationrequirement.
Defaultvalue:1
269
13.48 SitesTable
Forsites.
13.49 SitesListsTable
Forsitesbelongingtositelists.
13.50 SitesListsNamesTable
Fornamesofsitelists.
13.51 TMAEquipmentsTable
Fortowermountedamplifiers.
TRX_TYPE Text(15) FirsttransmittersubcellorAll
Defaultvalue:All
TRX_TYPE_OTHER Text(15) SecondtransmittersubcellorAll
Defaultvalue:All
TX_ID Text(50) Firsttransmitternameinasymmetricrelation.
Defaultvalue:
TX_ID_OTHER Text(50) Secondtransmitternameinasymmetricrelation.
Defaultvalue:
ALTITUDE Float
Realaltitude
Unit:m
Defaultvalue:
COMMENT_
Text
(255)
Additionalinformationonthesite
Defaultvalue:
LATITUDE Double Ycoordinate
Defaultvalue:0
LONGITUDE Double Xcoordinate
Defaultvalue:0
NAME Text(50) Sitename
Defaultvalue:
PYLON_HEIGHT Float Heightofthepylonatsite
Defaultvalue:50
Defaultvalue:
LIST_NAME Text(50) Firstpartoftheuniquekey.Nameofthelist
Defaultvalue:
SITE_NAME Text(50) Secondpartoftheuniquekey.Nameofthesite
Defaultvalue:
NAME Text(50) Nameofthelist
Defaultvalue:
DL_LOSSES Float DownlinklossesofTowerMountedAmplifier
Defaultvalue:0
270
13.52 TplTransmittersTable
Forstationtemplates.
NAME Text(50) NameofTowerMountedAmplifier
Defaultvalue:
NOISE_FIGURE Float NoisefigureofTowerMountedAmplifier
Defaultvalue:0
UL_GAIN Float UplinkgainofTowerMountedAmplifier
Defaultvalue:0
ACTIVE Boolean Transmitteractivity:'Yes'meansthatthetransmitterisactive
Defaultvalue:
ANTENNA_NAME Text(50) Nameofthemainantennainstalledonthetransmitter
Defaultvalue:
AZIMUT Float Azimuthofthefirstantenna
Defaultvalue:
BSIC_DOMAIN Text(50)
AtextfieldpointingtoResourceGroups.NAME.ItlimitstheBSICdomain
ofthesite.
Defaultvalue:
BTS_NAME Text(50) NameoftheBTSequipment
Defaultvalue:
CALC_RADIUS Integer
Calculationradiususedtodefineeachtransmittercalculationarea
Unit:m
Defaultvalue:
CALC_RADIUS2 Integer
Extendedcalculationradius
Unit:m
Defaultvalue:
CALC_RESOLUTION Integer Calculationresolution
Defaultvalue:
CALC_RESOLUTION2 Integer Extendedcalculationresolution
Defaultvalue:
CELL_RESELECT_OFFSET Integer Cellreselectionoffset
Defaultvalue:
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:
CELL_TYPE Text(50)
ThisfieldmarksasetofrecordsintheTRGConfigurationstables(allthe
recordsforwhichTRG_CONFIGhasthesamevalue.)Eachofthese
recordsspecifiesaTRGthatshouldexistinthistransmitter.
Defaultvalue:
CODEC_EQUIPMENT Text(50) AssociatedCodecequipment(forvoiceservices)
Defaultvalue:
CODING_SCHEME_NUMBER Short
ThenumberofcodingschemessupportedbytheGPRS/EDGE
transmitters
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
EGPRS_EQUIPMENT
Text
(255)
NameoftheequipmentassignedtotheGPRS/EDGEstation
Defaultvalue:
EIRP Float Transmitterseffectiveisotropicradiatedpower
Defaultvalue:
ENABLE_EGPRS Boolean 'Yes'enablesyoutoconsiderthetransmitterasaGPRS/EDGEstation
Defaultvalue:
FEEDER_NAME Text(50) Nameofthefeederequipment
Defaultvalue:
FEEDERLENGTH_DL Float
Lengthofdownlinkfeeder
Unit:m
Defaultvalue:
FEEDERLENGTH_UL Float
Lengthofuplinkfeeder
Unit:m
Defaultvalue:
271
FN_OFFSET Integer Framenumberoffset
Defaultvalue:
HEIGHT Float
Antennaheightabovetheground
Unit:m
Defaultvalue:
LAYER Text(50) NameoftheHierarchicalCellStructurelayer
Defaultvalue:
LAYER_RECEPTION_THRESH
OLD
Float
Iffilledin,takesprecedenceonthethresholdvaluedefinedinthe
HCSLayerstable
Defaultvalue:
LOSSES Float
Lossesduetotransmitterradioequipment
Unit:dB
Defaultvalue:
MAX_EXT_NEIGHB_NUMBER Short
Maximumnumberofintertechnologyneighboursforthecellorthe
transmitter
Defaultvalue:
MAX_NEIGHB_NUMBER Short Maximumnumberofneighboursforthecellorthetransmitter
Defaultvalue:
MAX_RANGE Integer Maximumrange(m)ofcoverage(forextendedcells)
Defaultvalue:
MIN_RANGE Integer Minimumrange(m)ofcoverage(forextendedcells)
Defaultvalue:
MISCDLL Float Miscellaneousdownlinklosses
Defaultvalue:
MISCULL Float Miscellaneousuplinklosses
Defaultvalue:
NAME Text(50) Templatename
Defaultvalue:
NOISE_FIGURE Float
transmitter
Defaultvalue:
NUM_SECTORS Integer Numberofsectors
Defaultvalue:3
PBCCH_CELL_RESELECT_OFF
SET
Integer CellreselectionoffsetforGPRScellswithPBCCHinuse(Forfutureuse)
Defaultvalue:
PBCCH_IN_USE Boolean PacketBroadcastControlChannelusedornot(Forfutureuse)
Defaultvalue:
PBCCH_RECEPTION_THRESH
OLD
Float
ReceptionthresholdvalueforGPRScellswithPBCCHinuse(Forfuture
use)
Defaultvalue:
POWER Float Transmitterpower
Defaultvalue:
PROPAG_MODEL
Text
(255)
Nameofthepropagationmodelusedtocalculatepredictions
Defaultvalue:
PROPAG_MODEL2
Text
(255)
Nameofthepropagationmodelusedtocalculateextendedprediction
Defaultvalue:
REDT Float RemoteElectricaltilt
Defaultvalue:
REQ_CHANNELS Integer Numberofrequiredphysicalchannels
Defaultvalue:
Nullcolumnallowed:
Defaultvalue:
Nullcolumnallowed:
Defaultvalue:
SHAREDMAST Text(50) Sharedmastname:enablesantennasharingbetweentransmitters
Defaultvalue:
Nullcolumnallowed:
Defaultvalue:
TILT Float Mechanicaldowntiltofthemainantenna
Defaultvalue:
272
13.53 TransmittersTable
Fortransmitters.
TMA_NAME Text(50) NameoftheTowerMountedAmplifierequipment
Defaultvalue:
TRX_MAX_NUMBER Short MaximumnumberofTRXthatcanbeallocatedbyTRXdimensioning
Defaultvalue:
TX_TYPE Short Typeoftransmitter(0=Normal;1=Interfereronly)
Defaultvalue:
Defaultvalue:True
Defaultvalue:
AZIMUT Float Azimuthofthemainantenna
Defaultvalue:0
BSIC Text(10) BSICcolourcode(BaseStationIdentityCode)assignedtothestation
Defaultvalue:
BSIC_DOMAIN Text(50) AtextfieldpointingattheBSICdomain.
Defaultvalue:
BSIC_FROZEN Boolean AFPnotallowedtomodifyBSIC.
Defaultvalue:False
Defaultvalue:
CALC_RADIUS Integer
Calculationradiususedtodefinethecalculationarea
Unit:m
Defaultvalue:4000
CALC_RADIUS2 Integer Extendedcalculationradius
Defaultvalue:
Defaultvalue:50
Defaultvalue:
CELL_IDENTITY Integer Cellidentity
Defaultvalue:
CELL_RESELECT_OFFSET Integer Cellreselectionoffset
Defaultvalue:0
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:2000
CELL_TYPE Text(50)
ThisfieldidentifiesasetofrecordsintheTRGConfigurationstables(all
therecordsthatpointtothiscelltype)eachoftheserecordsspecifiesa
TRGthatshouldexistinthistransmitter.
Defaultvalue:
CHANNELS
Text
(255)
Physicalchannelsallocatedtothetransmitter
Defaultvalue:
CODEC_EQUIPMENT Text(50) AssociatedCodecequipment(forvoiceservices)
Defaultvalue:
CODING_SCHEME_NUMBER Integer
ThenumberofcodingschemessupportedbytheGPRS/EDGE
transmitters
Defaultvalue:
COMMENT_
Text
(255)
Additionalinformationaboutthetransmitter
Defaultvalue:
CONTROL_CHANNEL Integer PhysicalchannelusedasBroadcastControlChannel(BCCH)
Defaultvalue:
COST_FACTOR Double UsedbytheAFPassignprioritiestotransmitters
Defaultvalue:1
273
DX Float Xcoordinaterelativetothesitelocation
Defaultvalue:0
DY Float Ycoordinaterelativetothesitelocation
Defaultvalue:0
EGPRS_EQUIPMENT Text(50) NameoftheequipmentassignedtotheGPRS/EDGEstation
Defaultvalue:
EIRP Float Transmitterseffectiveisotropicradiatedpower
Defaultvalue:43
ENABLE_EGPRS Boolean 'Yes'enablesyoutoconsiderthetransmitterasaGPRS/EDGEstation
Defaultvalue:False
FBAND Text(20) Nameofthefrequencyband
Defaultvalue:
Defaultvalue:
FEEDERLENGTH_DL Float LengthoffeederinDL
Defaultvalue:0
FEEDERLENGTH_UL Float LengthoffeederinUL
Defaultvalue:0
FN_OFFSET Integer FrameNumberoffset
Defaultvalue:0
FROZEN Boolean
OnlyTRXsthatarenotfrozenandbelongtononfrozencellscanbe
assignedfrequenciesbytheAFP.
Defaultvalue:False
HEIGHT Float
Unit:m
Defaultvalue:25
HEXAGON_GROUP Text(50) Groupofhexagonsusedtocreatethistransmitter
Defaultvalue:
HOP_MODE Text(25) ThehoppingmodeofthedefaulttrafficTRGinthistransmitter.
Defaultvalue:
HSN_FROZEN Boolean
OnlyTRGsbelongingtononHSNfrozencells,andwhichhave
non_HSN_frozenconfigurations,canbeassignedHSNsbytheAFP.
Defaultvalue:False
LAYER Text(50) NameoftheHierarchicalCellStructurelayer
Defaultvalue:
LAYER_RECEPTION_THRESH
OLD
Float
Iffilledin,takesprecedenceonthethresholdvaluedefinedinthe
HCSLayerstable
Defaultvalue:
LOSSES Float
Lossesduetotransmitterradioequipment
Unit:dB
Defaultvalue:0
MAX_EXT_NEIGHB_NUMBER Integer Maximumnumberofintertechnologyneighboursforthetransmitter
Defaultvalue:
MAX_NEIGHB_NUMBER Integer Maximumnumberofneighboursforthetransmitter
Defaultvalue:
Defaultvalue:35000
Defaultvalue:0
MISCDLL Float MiscellaneousDLloss
Defaultvalue:0
MISCULL Float MiscellaneousULloss
Defaultvalue:0
NOISE_FIGURE Float
transmitter
Defaultvalue:5
NUM_TRX Float
ThetotalnumberofTRXsinthistransmitter.InthecasesofnoorBase
bandhopping,itmustcorrespondtothenumberofchannelsinthe
CHANNELSfield.
Defaultvalue:0
PBCCH_CELL_RESELECT_OFF
SET
Integer CellreselectionoffsetforGPRScellswithPBCCHinuse(Forfutureuse)
Defaultvalue:0
274
13.54 TRGConfigurationsTable
Forsubcelltypes.
PBCCH_IN_USE Boolean PacketBroadcastControlChannelusedornot(Forfutureuse)
Defaultvalue:False
PBCCH_RECEPTION_THRESH
OLD
Float
ReceptionthresholdvalueforGPRScellswithPBCCHinuse(Forfuture
use)
Defaultvalue:102
POWER Float Transmitterpower
Defaultvalue:
PROPAG_MODEL
Text
(255)
Nameofthepropagationmodelusedtocalculateprediction
Defaultvalue:Default
model
PROPAG_MODEL2
Text
(255)
Defaultvalue:
Defaultvalue:0
REQ_CHANNELS Integer NumberofrequiredTRXs
Defaultvalue:1
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
SITE_NAME Text(50)
Nameofthesiteonwhichthetransmitterislocated(fromtheSites
table)
Defaultvalue:
TILT Float Mechanicaldowntiltofthefirstantenna
Defaultvalue:0
TMA_NAME Text(50) NameoftheTMAequipment
Defaultvalue:
TRX_MAX_NUMBER Short MaximumnumberofTRXthatcanbeallocatedbyTRXdimensionning
Defaultvalue:16
TX_ID Text(50) Transmittername
Defaultvalue:
Defaultvalue:0
_8PSK_PWBCKFF Float Reductionofpowerdueto8PSKmodulation
Defaultvalue:3
ASSIGN_MODE Text(25) Oneofthetwooptions:FreeorGroupconstrained.
Defaultvalue:Free
BAD_QUAL_UB Float
Additionalconstraintsonsubcellquality(consideredinAFP):maximum
probabilitytohaveC/IlowerthanC_OVER_I_MIN.
Defaultvalue:1
C_OVER_I_MIN Float MinimumC/I
Defaultvalue:12
CELL_TYPE Text(50) Firstpartofuniquekey.
Defaultvalue:
COST_FACTOR Float
Bydefault,1.Thecostfactorwillbeusedtoincreaseordecreasethe
importanceofsubcellsofthisconfiguration.
Defaultvalue:1
DEF_DTX Boolean
Thisisadefaultvalueofasubcellspecificparameter.Itissettotrueif
theTRXsofthesubcelluseDiscontinuoustransmission
Defaultvalue:True
275
13.55 TRGsTable
Forsubcells.
DEF_HOP_MODE Text(25)
Thisisadefaultvalueofasubcellspecificparameter.Hoppingmodecan
beNonHopping,BaseBandHopping,orSynthesizedHopping.
Defaultvalue:Non
Hopping
DEF_MIN_RECEPTION Float
Thisisadefaultvalueofasubcellspecificparameter.Itdenotesthe
minimumreceivedpowerrequiredtobeservedbythissubcell.
Defaultvalue:102
DEF_POWER_OFFSET Float
Thisisadefaultvalueofasubcellspecificparameter:theaveragepower
offsetwithrespecttotheBCCHchannel.
Defaultvalue:0
DEF_TRX_EQUIPMENT Text(25) DefaultTRXequipmentofTRXsbelongingtothissubcell
Defaultvalue:
FREQUENCY_DOMAIN Text(50)
AllfrequenciesassignedtoTRXsofthisconfigurationmustbelongtothis
domain.Domainscontaingroupinginfoaswell.
Defaultvalue:
HR_RATIO Float PercentageofHalfRatevoicetrafficinthesubcell.
Defaultvalue:40
HSN_DOMAIN Text(50)
AllHSNsassignedtosubcellsofthisconfigurationmustbelongtothis
domain.
Defaultvalue:
HSN_FROZEN Boolean
Onlysubcellsthatpointtononhsn_frozenconfigurationsinnon
hsn_frozencellscanbybeassignedHSNsbytheAFP.
Defaultvalue:False
MAXIMAL_MAL Integer LimitationonlengthoftheMAL(Mobileallocationlist).
Defaultvalue:48
MEAN_POWER_CONTROL Float AveragevalueofDLpowercontrol
Defaultvalue:0
TRAFFIC_OVERFLOW_TARGE
T
Float Thepercentageoftrafficthatisconsideredtooverflowfromthesubcell.
Defaultvalue:0
TRX_TYPE Text(15) Secondpartofuniquekey
Defaultvalue:
TS_CONFIGURATION_NAME Text(50) Timeslotconfiguration
Defaultvalue:
TX_DIVERSITY_MODE_DL Short
Ifmorethanoneantennaareused(TX_DIVERSITY_NBANT),thisfield
indicatesiftheyareused0simultaneously(TXDiv)or1alternatively
(antennahopping)
Defaultvalue:0
TX_DIVERSITY_NBANT Short
TXdiversity
Choicelist:1=NoTXdiversity;2=TXdiversitywith2antennas;
Defaultvalue:1
_8PSK_PWBCKFF Float Powerreductiondueto8PSKmodulation
Defaultvalue:3
AFP_BLOCKED_COST Float SecondaryAFPqualityindicator
Defaultvalue:0
AFP_CONGESTION Float SecondaryAFPindicatordepictingthespectralcongestionstate
Defaultvalue:0
AFP_COST Float MainAFPqualityindicator
Defaultvalue:0
AFP_FREEZE_DIM Boolean PermittheAFPtonotalwaysrespectthenumberofrequiredTRXs
Defaultvalue:False
AFP_SEP_COST Float SecondaryAFPqualityindicator
Defaultvalue:0
ASSIGN_MODE Text(25) Oneofthetwooptions:FreeorGroupconstrained.
Defaultvalue:Free
BAD_QUAL_UB Float
Additionalconstraintsonsubcellquality(consideredinAFP):maximum
probabilitytohaveC/IlowerthanC_OVER_I_MIN.
Defaultvalue:1
276
BLOCKING_PROBA Float Blockingprobability(%)
Defaultvalue:0
C_OVER_I_MIN Float MinimumC/I
Defaultvalue:12
COST_FACTOR Float
Bydefault,1.Thecostfactorisusedtoincreaseordecreasethe
importanceofsubcellsofthisconfiguration.
Defaultvalue:1
CS_ERLANGS Float CircuitswitcheddemandinErlangs
Defaultvalue:0
DEF_TRX_EQUIPMENT Text(25) DefaultTRXequipmentofTRXsbelongingtothissubcell
Defaultvalue:
DTX Boolean ItissettotrueiftheTRXsofthesubcelluseDiscontinuoustransmission.
Defaultvalue:True
DTX_GAIN_DL Float DownlinkGainduetoDTX(dB)
Defaultvalue:0
EFFECTIVE_TRAFFIC_OVERFL
OW
Float Effectivetrafficoverflow
Defaultvalue:
EXCLUDED
Text
(250)
ListoffrequencieswhichshouldnotbeusedbyTRXofthecurrent
subcell.
Defaultvalue:
FREQUENCY_DOMAIN Text(50)
AllfrequenciesassignedtoTRXsofthisconfigurationmustbelongtothis
domain.Domainscontaingroupinginfoaswell.
Defaultvalue:
HOP_MODE Text(25)
ThehoppingmodeofasubcellcanbeNonHopping,BaseBand
Hopping,orSynthesizedHopping.
Defaultvalue:Non
Hopping
HR_RATIO Float PercentageofHalfratetrafficinthesubcell.
Defaultvalue:40
HSN Integer AssignedHSN.
Defaultvalue:
HSN_DOMAIN Text(50)
AllHSNsassignedtosubcellsofthisconfigurationmustbelongtothis
domain.
Defaultvalue:
HSN_FROZEN Boolean
Onlysubcellsthatpointtononhsn_frozenconfigurationsinnon
hsn_frozencellscanbeassignedHSNsbytheAFP.
Defaultvalue:False
MAXIMAL_MAL Integer LimitationonlengthoftheMAL(Mobileallocationlist).
Defaultvalue:48
MEAN_POWER_CONTROL Float AveragevalueofDLpowercontrol
Defaultvalue:0
MIN_RECEPTION Float Minimumreceptionpowerrequiredtobeservedbythissubcell.
Defaultvalue:102
POWER_OFFSET Float TheaveragepoweroffsetwithrespecttotheBCCHchannel.
Defaultvalue:0
PREFERRED_FREQ_GROUP Text(50) Frequencygroupwhichshouldbeusedifpossible
Defaultvalue:
PS_DATA_ERLANGS Float
PacketswitcheddemandindataErlangs
(equivalenttoavaragedusedtimeslots)
Defaultvalue:0
REQ_CHANNELS Integer Numberofrequiredchannels.
Defaultvalue:0
SYNCHRO_NAME Text(50) Definessynchronizationsets.
Defaultvalue:
TRAFFIC_LOAD Float
TRAFFIC_LOAD=(TrafficinErlangs)/(NUM_TRX*Multyplexing_factor)
(Where,Multiplexing_factor=8).
Defaultvalue:1
TRAFFIC_OVERFLOW_TARGE
T
Float
Thepercentageoftrafficthatisconsideredtooverflowfromone
subcell.
Defaultvalue:0
TRX_TYPE Text(15) Secondpartofauniquekey.PointstotheTRXtypetable.
Defaultvalue:
TS_CONFIGURATION_NAME Text(50) Timeslotconfiguration
Defaultvalue:
277
13.56 TRXEquipmentsTable
ForTRXequipment.
13.57 TRXsTable
ForTRXs.
TX_DIVERSITY_MODE_DL Short
Ifmorethanoneantennaareused(TX_DIVERSITY_NBANT),thisfield
indicatesiftheyareused0simultaneously(TXDiv)or1alternatively
(antennahopping)
Defaultvalue:0
TX_DIVERSITY_NBANT Short
TXdiversity
Choicelist:1=NoTXdiversity;2=TXdiversitywith2antennas;
Defaultvalue:1
TX_ID Text(50)
Firstpartofauniquekey.Itisthetransmittertowhichthissubcell
belongs.(Thecelltypecanberetrievedbyfollowingthislink).
Defaultvalue:
UL_TRAFFIC_LOAD Float SubcellsUplinkTrafficload
Defaultvalue:1
VAMOS_RATIO Float
Defaultvalue:0
_8PSK_POWER Float Nominaloutputpowerin8PSKmodulation
Defaultvalue:44
COMMENT_
Text
(100)
Comments
Defaultvalue:
GMSK_POWER Float NominaloutputpowerinGMSKmodulation
Defaultvalue:47
MAX_CS Short Highestcodingscheme(CS)availableforGPRS
Defaultvalue:4
MAX_MCS Short Highestcodingscheme(MCS)availableforEDGE
Defaultvalue:12
NAME Text(25) NameofTRXequipment
Defaultvalue:
_8PSK_PWBCKFF Float Reductionofpowerdueto8PSKmodulation
Defaultvalue:3
AFP_RANK Short RankofthisTRXaccordingtotheAFP
Defaultvalue:0
CN_LIST
Text
(255)
ListofallfrequenciesassignedtoaTRX.(separatedwithspaces)
Defaultvalue:
DOWNLINK_EXTERNAL_NOIS
E_RISE
Float Internetworkdownlinknoiserise
Defaultvalue:0
FROZEN Boolean Allows/disallowschangingparametersofthisTRX.
Defaultvalue:False
MAIO Integer AssignedMAIO(MobileAllocationIndexOffset).
Defaultvalue:
TRX_EQUIPMENT Text(25) TRXequipmentofthisTRX
Defaultvalue:
TRX_NUMBER Integer
AnorderonTRXsinthesamesubcell.Itisthesecondpartofaunique
key.
Defaultvalue:
TRX_TYPE Text(15)
ThecoupleTX_ID,TRG_TYPEisthekeyoftheTRGstabletowhichthis
TRXbelongs
Defaultvalue:
278
13.58 TRXTypesTable
ForTRXtypes(BCCH,TCH,TCH_INNER,etc.).
13.59 TSConfigurationNamesTable
Fornamesoftimeslotconfigurations.
13.60 TSConfigurationsTable
Fortimeslotconfigurations.
13.61 TxsListsTable
Fortransmittersbelongingtotransmitterlists.
TX_ID Text(50)
Firstpartofauniquekey.ItpointstoTransmitters.Thevalueofthe
fieldCELL_TYPEintheTransmitterstablecanthereforeberetrieved
andcanserveinordertoaccessrelevantinformationinthe
TRGConfigurationstable.
Defaultvalue:
UPLINK_EXTERNAL_NOISE_R
ISE
Float Internetworkuplinknoiserise
Defaultvalue:0
UPLINK_NOISE_RISE Float Uplinknoiserise
Defaultvalue:0
IS_BCCH Boolean
IndicatesthataTRG_TYPEistheCommonBroadcastcarrier.Testsinthe
codewillverifythatonlyonetypecarriesthebroadcast.
Defaultvalue:False
IS_TCH_DEF Boolean
IndicatesthataTRG_TYPEisthedefaulttrafficcarrier(theOUTERzone).
TestsinthecodewillverifythatonlyonetypeisthedefaultTCH.
Defaultvalue:False
NAME Text(15) TypeofTRX
Defaultvalue:
PRIORITY Short
PriorityofacertaintypeofTRXtocarrytraffic(largestvaluehasthe
highestpriority)
Defaultvalue:0
TRAFFIC_POOL Short
AllTRXsofthesamepoolcanexchangetrafficiftheyneedtobalance
theirloads.Iftheyareindifferentpools,theloadbalancingmightfail.
Defaultvalue:1
NAME Text(50) Nameoftheconfiguration
Defaultvalue:
CIRCUIT_TS Integer Numberoftimeslotsthatsupportcircuitswitchedtraffic
Defaultvalue:0
COMPOSITE_TS Integer Numberoftimeslotsthatsupportcircuitandpacketswitchedtraffic
Defaultvalue:8
NAME Text(50) Nameoftheconfiguration
Defaultvalue:
PACKET_TS Integer Numberoftimeslotsthatsupportpacketswitchedtraffic
Defaultvalue:0
TRX_NUMBER Integer ZerobasedindexofTRX
Defaultvalue:1
LIST_NAME Text(50) Firstpartoftheuniquekey.Nameofthelist.
Defaultvalue:
279
13.62 TxsListsNamesTable
Fornamesoftransmitterlists.
13.63 UnitsTable
For the reception and transmission units, the projection coordinate system specified in the ATL document, the database
internalcoordinatesystem,andtheinternalBSICformat.
TX_NAME Text(50) Secondpartoftheuniquekey.Nameofthetransmitter.
Defaultvalue:
NAME Text(50) Nameofthetransmitterlist
Defaultvalue:
BSIC_FORMAT Integer
BSICformat
Choicelist:0=Decimal;1=Octal;
Defaultvalue:1
COORD_SYSTEM Integer Displaycoordinatesystemwhencreatingdatabase
Defaultvalue:1
GAIN_UNIT Integer
Unitusedforgains(dBdordBi)
Choicelist:0=dBd;1=dBi;
Defaultvalue:0
PROJECTION Integer Projectedcoordinatesystemforgeodata
Defaultvalue:1
RECEPTION_UNIT Integer
Receptionunitwhencreatingdatabase
Choicelist:0=dBm;1=dbV;2=dbV/m;
Defaultvalue:0
TRANSMISSION_UNIT Integer
Transmissionunitwhencreatingdatabase
Choicelist:0=dBm;1=Watts;2=kWatts;
Defaultvalue:0
280
AT320_AM_E2 Chapter14:UMTSHSPADataStructure
281
14 UMTSHSPADataStructure
Figure 14.1onpage 281,Figure 14.2onpage 282,andFigure 14.3onpage 283depicttheUMTSHSPAdatabasestructure.The
followingsubsectionslistthetablesintheUMTSHSPAtemplatedatastructure.
Figure 14.1:UMTSHSPATemplate1
282
Chapter14:UMTSHSPADataStructure Forsk2013
283
284
AntennasTable
CdmaCellsTable
CdmaEquipmentsTable
CustomFieldsTable
FrequencyBandsTable
HSUPAUECategoriesTable
MUGTablesTable(New)
Defaultvalue:
HSDPA_SCHEDULER Text(50) HSDPAscheduler
Nullcolumnallowed:
Defaultvalue:
RSCP_MIN Float MinimumRSCPreceptionlevel(dBm)
Defaultvalue:150
HSDPA_MULTI_BAND Short
MultiBandactivation
0=Inactive;1=Active
Defaultvalue:0
SCHEDULER_ALGO Text(50) Scheduler
Defaultvalue:
Defaultvalue:0
DELTA_CN Integer Stepbetweentwoadjacentcarriernumbers
Defaultvalue:1
EXCLUDED_CHANNELS
Text
(255)
Listoftheforbiddencarriersinsidethisband
Defaultvalue:
MULTI_CARRIER Short Multicarriermode(0:None;1:Dualcell)
Defaultvalue:0
CELL_NUMBER Short
Themultiuserdiversitygainmaybedifferentifthenumberofcells
increase.
Defaultvalue:0
MUG_TABLE Memo Multiuserdiversitygaintable
Defaultvalue:
SCHEDULER_NAME Text(50)
Nameoftheschedulerforwhichthemultiuserdiversitygaintableis
defined.
Defaultvalue:
285
NeighboursTable
SchedulersTable(New)
SitesTable
TransmittersTable
UMTSTerminalsTable
CdmaCellsTable
HSDPA_MUG_TABLE
HSDPA_SCHEDULER_ALGO
NetworksTable
DEFAULT_ORTHO_FACTOR
RELATION_TYPE Short
Thetypeoftheneighbourrelationbetweencells:intracarrierorinter
carrier
Defaultvalue:
NAME Text(30) Nameofthescheduler
Defaultvalue:
SCHEDULING_METHOD Short 0=MaxC/I;1=Roundrobin;2=ProportionalFair
Defaultvalue:0
Defaultvalue:
Defaultvalue:
MAX_RANGE Integer Maximumrangeofcoverage
Defaultvalue:
MIMO_SUPPORT Short
SupportedMIMOfeatures:0=None;1=openloopMIMO;2=closed
loopMIMO
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
NOISE_FACTOR_THIRD Float
Noisefigureusedtodeterminethethermalnoiseatthereceiver(for
thirdfrequencyband)
Defaultvalue:8
THIRD_BAND Text(50) Thirdfrequencyband
Defaultvalue:
286
SitesTable
SUPPORT_NATURE
HSDPA_MUG_TABLE
MC_HSDPA_MUG
MC_HSDPA_SCHED_ALGO
TransmittersTable
MC_HSDPA_MUG
MC_HSDPA_SCHED_ALGO
14.2 AntennasTable
Forantennas.
ForNodeBequipment.
Defaultvalue:
COMMENT_
Text
(255)
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
FMax Double
Unit:MHz
Defaultvalue:
FMin Double
Unit:MHz
Defaultvalue:
GAIN Float
Unit:dBi
Defaultvalue:0
Defaultvalue:
Defaultvalue:
The format of the binary field, DIAGRAM, is described in the "RF 2D Antenna Pattern
Format"onpage 113.
combiner)
Defaultvalue:0
combiner)
Defaultvalue:0
Defaultvalue:
287
14.4 CDMACellsTable
Forcells.
Defaultvalue:0
RHO_FACTOR Short Rhofactortomodelselfgeneratedinterference(100%=ideal)
Defaultvalue:100
ACTIVE Boolean Cell'sactivity:'Yes'meansthatthecellisactive
Defaultvalue:True
AS_THRESHOLD Float MaximumdifferencewiththebestservertoenteractiveSet(dB)
Defaultvalue:5
CARRIER Integer Carriernumber
Defaultvalue:0
CELL_ID Text(50) Nameofthecell
Defaultvalue:
Defaultvalue:
COMMENT_
Text
(255)
Additionalinformationaboutthecell
Defaultvalue:
E_RISE
Defaultvalue:0
DYN_HS_SCCH_POWER_ALL
OC
Boolean AllocationofpowerforHSSCCH(True=Dynamic,False=Static)
Defaultvalue:True
DYN_HSDPA_POWER_ALLOC Boolean AllocationofpowerforHSDPA(True=Dynamic,False=Static)
Defaultvalue:False
HS_SCCH_POWER Float
ValueofpowerdedicatedtoaHSSCCHchannel.Incaseofdynamic
allocation,itisthemaximumavailablepower.
Defaultvalue:
HSDPA_MAX_CODES Short MaximumnumberofHSPDSCHcodes
Defaultvalue:16
HSDPA_MAX_USERS Short MaxnumberofHSDPAusersmanagedsimultaneouslybythescheduler
Defaultvalue:64
HSDPA_MIN_CODES Short MinimumNumberofHSPDSCHcodes
Defaultvalue:1
HSDPA_PWR Float Amountofpower(dBm)dedicatedtoHSDPA
Defaultvalue:
HSDPA_SCHEDULER Text(50) MinimumRSCPreceptionlevel(dBm)
Defaultvalue:
HSPA_SUPPORT Short HSPAfeaturessupported:0=None;1=HSDPA;2=HSPA;3=HSPA+
Defaultvalue:0
HSUPA_DLPOWER Float
Amountofpower(dBm)dedicatedtoHSUPADLchannels(EAGCH,E
RGCH,EHICH)
Defaultvalue:
HSUPA_MAX_USERS Short MaxnumberofHSUPAusersmanagedsimultaneouslybythescheduler
Defaultvalue:15
HSUPA_UL_LOAD Float
UplinkcellloadfactorduetoHSUPAusers:calculatedbytheWCDMA
simulationalgorithm
Defaultvalue:
LOCKED_SC Boolean FieldusedtofreezeallocatedSCofthecellduringautomaticallocation
Defaultvalue:False
MAX_DL_LOAD Float
Maximumdownlinkloadallowed(percentageofmaxpowerused).Used
inpowercontrolsimulation
Defaultvalue:50
MAX_EXT_NEIGHB_NUMBER Integer Maximumnumberofintertechnologyneighboursforthecell
Defaultvalue:
288
14.5 CdmaEqptsHSUPARssUseTable
ForHSUPAresourceconsumptioninsiteequipment.
MAX_INTERCAR_NEIGHB_NB Integer Maximumnumberofintercarrierneighboursforthiscell
Defaultvalue:
MAX_NEIGHB_NUMBER Integer Maximumnumberofneighboursforthecell
Defaultvalue:
MAX_R99BEARER_DL_RATE Float MaxbearerrateavailableinDL(kbps)
Defaultvalue:1000
MAX_R99BEARER_UL_RATE Float MaxbearerrateavailableinUL(kbps)
Defaultvalue:1000
MAX_UL_LOAD Float
Maximumuplinkloadallowed(percentage).Usedinpowercontrol
simulation
Defaultvalue:75
MIMO_SUPPORT Short MIMOfeaturessupported:0=None;1=TransmitDiversity;2=SUMIMO;
Defaultvalue:0
NUM_HS_SCCH Short NumberofHSSCCHchannels
Defaultvalue:1
NUM_HSDPA_USERS Short
NumberofservedHSDPAusersinthecell:calculatedbytheWCDMA
simulationalgorithm
Defaultvalue:
NUM_HSUPA_USERS Short
NumberofservedHSUPAusersinthecell:calculatedbytheWCDMA
simulationalgorithm
Defaultvalue:
OTHERS_CCH_POWER Float PowerofothercommonchannelsexceptSCH
Defaultvalue:30
PILOT_POWER Float Powerofthepilotchannel
Defaultvalue:33
POWER_MAX Float Maximumpowersupportedbythetransmitter
Defaultvalue:43
PWR_HEADROOM Float
PowerControlHeadroom(dB)forDCH(usedinWCDMAsimulation
algorithm)
Defaultvalue:0
REUSE_DIST Float Minimumreusedistanceforscramblingcodes
Defaultvalue:
RSCP_MIN Float MinRSCPreceptionlevel(dBm)
Defaultvalue:150
SC_DOMAIN_NAME Text(50) Scramblingcodedomainname.
Defaultvalue:
SCH_POWER Float Powerofthesynchronisation(SCH)channel
Defaultvalue:21
SCRAMBLING_CODE Integer Scramblingcode.
Defaultvalue:
TOTAL_POWER Float
Totaldownlinkpower:manuallyspecifiedbytheuserorcalculatedby
theWCDMAsimulationalgorithm
Defaultvalue:
TX_ID Text(50) Nameofthetransmitter
Defaultvalue:
UL_LOAD Float
Uplinktransmitterloadfactor:manuallyspecifiedbytheuseror
calculatedbytheWCDMAsimulationalgorithm
Defaultvalue:
UL_REUSE_FACTOR Float
Uplink(Iintra+Iextra)/Iintra:calculatedbytheWCDMAsimulation
algorithm
Defaultvalue:
ISE
Defaultvalue:0
BEARER_INDEX Short Cellidentity
Defaultvalue:
289
14.6 CDMAEquipmentsTable
Forsiteequipment.
14.7 CDMAEquipmentsCEsUseTable
Forchannelelementsconsumptioninsiteequipment.
CHANNEL_ELTS_UL Integer Internetworkdownlinknoiserise
Defaultvalue:1
EQUIPMENT Text(50) Nameofthesiteequipment
Defaultvalue:
IUB_RATE_UL Float Internetworkuplinknoiserise
Defaultvalue:15
CARRIER_SELECTION Short
Carrierselectionmode
Choicelist:0=MinULnoise;1=MinDLpower;2=Random;3=Sequential;
Defaultvalue:0
CES_OVERHEAD_DL Integer
NumberofchannelelementsusedforDLoverheadchannels(pilot,
synchro,...)
Defaultvalue:0
CES_OVERHEAD_UL Integer
NumberofchannelelementsusedforULoverheadchannels(pilot,
synchro,...)
Defaultvalue:0
ENABLE_COMPRESSED_MOD
E
Boolean Iftrue,NodeBsofthesitecanmanagecompressedmode
Defaultvalue:False
MultiBandactivation
0=Inactive;1=Active
Defaultvalue:0
IUB_E1_RATE Float SupportedrateperE1line(kbps)
Defaultvalue:2048
IUB_HSDPA_PERCENT Short IubHSDPABackhaulOverhead(%)
Defaultvalue:20
IUB_OVERHEAD_DL Float IubCommonTransportChannelBackhaulOverheadpercell(rateinkps)
Defaultvalue:40
MANUFACTURER Text(50) Nameofthemanufacturer
Defaultvalue:
MUD_FACTOR Float MUDfactorforULinterferencecancellation
Defaultvalue:0
Defaultvalue:
RAKE_EFFICIENCY Float
Efficiencyoftherakereceiver.UsedforcombinationofASmember
contributions
Defaultvalue:1
Defaultvalue:
USE_NEIGHBOURS Boolean
Iftrue,selectionofASmembersislimitedtotheneighboursofthe
selectedtransmitter
Defaultvalue:False
CHANNEL_ELTS_DL Integer Numberofchannelelementsusedfordownlink
Defaultvalue:1
CHANNEL_ELTS_UL Integer Numberofchannelelementsusedforuplink
Defaultvalue:1
EQUIPMENT Text(50) Firstpartoftheuniquekey.Nameofequipment
Defaultvalue:
IUB_RATE_DL Float Iubbackaulratefordownlink(kbps)
Defaultvalue:15
290
14.8 CoordSysTable
IUB_RATE_UL Float Iubbackaulrateforuplink(kbps)
Defaultvalue:15
SERVICE Text(50) Secondpartoftheuniquekey.Servicename.
Defaultvalue:
CODE Integer
Defaultvalue:0
DATUM_CODE Double
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
ELLIPS_CODE Integer
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
PROJ_METHOD Short
Defaultvalue:0
Defaultvalue:0
291
Forfeeders.
Forfrequencybands.
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
CHOICE_TYPE Integer 0=Choicelistisoptional;1=Choicelistismandatory;
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
BAND_WIDTH Double Bandwidth(MHz)
Defaultvalue:5
Defaultvalue:1
EXCLUDED_CHANNELS
Text
(255)
Defaultvalue:
292
14.12 HSDPABearersTable
ForHSDPAbearers.
14.13 HSDPABearerSelectTablesTable
ForHSDPAbearerselectiongraphs.
14.14 HSDPAQualityTablesTable
ForHSDPAbearerperformancegraphs.
FIRST_CARRIER Integer Numberofthefirstcarrieravailableonthenetwork
Defaultvalue:0
FREQUENCY Double
Averagefrequencyofcarriers
Unit:MHz
Defaultvalue:2110
LAST_CARRIER Integer Numberofthelastcarrieravailableonthenetwork
Defaultvalue:0
Defaultvalue:
SPREADING_WIDTH Double Spreadingbandwidthdefinition
Defaultvalue:3.84
BEARER_INDEX Short Uniquekeytoaddressbearer
Defaultvalue:
HSPDSCH_NUM Short NumberofHS_PDSCHchannelsused
Defaultvalue:5
MODULATION Short Modulation(0:QPSK;1:16QAM;2:64QAM)
Defaultvalue:0
RLC_PEAK_THROUGHPUT Float PeakRLCthroughput(withoutBLERconsideration)
Defaultvalue:0
TRANSPORT_BL_SIZE Integer TransportBlockSize(bits)
Defaultvalue:0
BEST_BEARER_TABLE Memo TablesBEST_BEARER_INDEX=f(CQI_HSPDSCH)
Defaultvalue:
CQI_TABLE Memo
TablesCQI=f(Quality),QualitydefinedbyCQI_CPICH_BASEDin
Networkstable
Defaultvalue:
MOBILITY Text(50) UEmobility
Defaultvalue:
RX_EQUIP Text(50) TypeofreceiveroftheUserEquipment
Defaultvalue:
BEARER_INDEX Short Bearerindex
Defaultvalue:
DL_QI_TABLE Memo
QI=f(MEAS_PARAM)
MEAS_PARAMfromQualityIndicatorstable
Defaultvalue:
Defaultvalue:
QI_NAME Text(50) NameoftheQualityIndicator
Defaultvalue:
293
14.15 HSPAMIMOConfigsTable
ForHSPAMIMOgains.
14.16 HSUPABearersTable
ForHSUPAbearers.
14.17 HSUPABearerSelectionTable
ForHSUPAbearerselectionthresholds.
Defaultvalue:
DL_DIVERSITY_GAIN Float Downlinkdiversitygain(DTxAA)
Defaultvalue:0
HSDPA_BEARER_INDEX Short HSDPABearerindex
Defaultvalue:0
MAX_MIMO_GAIN_TABLE Memo Maximumspatialmultiplexingcapacitygaingraphs
Defaultvalue:
MIMO_RX_ANTENNAS Short NumberofreceptionantennasusedforMIMO
Defaultvalue:1
MIMO_TX_ANTENNAS Short NumberoftransmissionantennasusedforMIMO
Defaultvalue:1
Defaultvalue:
Defaultvalue:
BEARER_INDEX Short Indexofthebearer
Defaultvalue:
EDPDCH_NUM Short NumberofEDPDCHcodesused
Defaultvalue:
MIN_SF Integer SmallestSpreadingFactor
Defaultvalue:
MODULATION Short Modulation(0:QPSK;1:16QAM)
Defaultvalue:0
RLC_PEAK_RATE Float PeakRLCthroughput(withoutBLER)
Defaultvalue:
Defaultvalue:
TTI_LENGTH Float DurationofTTI(ms)
Defaultvalue:
BEARER_INDEX Short Indexoftheselectedbearer
Defaultvalue:0
EARLY_TERM_TABLE Memo Tablesofprobabilitiesofearliertermination=f(REPEAT_NUM)
Defaultvalue:
EC_NT_REQ Float RequiredEDPDCHEc/Nt
Defaultvalue:
294
14.18 HSUPAQualityTablesTable
ForHSUPAbearerperformancegraphs.
14.19 HSUPAUECategoriesTable
ForHSUPAUEcategories.
MOBILITY Text(50) Usersmobility
Defaultvalue:
REPEAT_NUM Integer Numberofretransmissionstoensureacorrecttransmission
Defaultvalue:1
RX_EQUIP Text(50) Receptionequipmentoftheterminal
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
REPEAT_NUM Integer Numberofretransmissionstoensureacorrecttransmission
Defaultvalue:1
Defaultvalue:
UL_QI_TABLE Memo
QI=f(MEAS_PARAM),whereMEAS_PARAMisreadfromthe
QualityIndicatorstable
Defaultvalue:
MAX_BLOCK_SIZE_10MS Integer MaximumtransportblocksizesupportedforTTI=10ms(bits)
Defaultvalue:
MAX_BLOCK_SIZE_2MS Integer MaximumtransportblocksizesupportedforTTI=2ms(bits)
Defaultvalue:
MAX_EDPDCH_NUM Short MaximumnumberofEDPDCHcodesforHSUPA
Defaultvalue:
MIN_SF Integer SmallestSpreadingFactorsupported
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
TTI_2MS Boolean TrueifTTI=2msissupported
Defaultvalue:False
UE_CATEGORY Short UEcategoryforHSUPA
Defaultvalue:
UE_CATEGORY_NAME Text(50) NameoftheHSUPAUEcategory
Defaultvalue:
295
14.20 InterfReductionFactorsTable
Forinterferencereductionfactorsbetweencarriers.
14.22 MUGTablesTable
Formultiuserdiversitygains.
CARRIER1 Integer Firstcarrier
Defaultvalue:0
CARRIER2 Integer Secondcarrier
Defaultvalue:0
FACTOR Double Interferencereductionfactor
Defaultvalue:200
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
A
CELL_NUMBER Short
increase.
Defaultvalue:0
Defaultvalue:
defined.
Defaultvalue:
FORCE_HHO Boolean
ForceHandovertypetohardhandoverincaseofintracarriers
neighbours
Defaultvalue:False
Defaultvalue:1
Defaultvalue:
REASON Integer
RELATION_TYPE Short
carrier
Defaultvalue:
Defaultvalue:
296
14.27 NetworksTable
Defaultvalue:
FORCE_HHO Boolean
neighbours
Defaultvalue:False
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
297
ADD_MRC_SOFTERSOFT Boolean Iftrue,gainduetoMRCistakenintoaccountforsofter/softcases
Defaultvalue:False
COMPRESSED_DELTA_DL_Q
UAL
Float Eb/NtDLtargetoverheadduetocompressedmodeactivated
Defaultvalue:1
COMPRESSED_DELTA_UL_Q
UAL
Float Eb/NtULtargetoverheadduetocompressedmodeactivated
Defaultvalue:1
COMPRESSED_ON_ECIO Boolean CompressedmodeactivatedonEc/Iothreshold(forfutureuse)
Defaultvalue:True
COMPRESSED_ON_RSCP Boolean CompressedmodeactivatedonRSCPthreshold(forfutureuse)
Defaultvalue:False
COMPRESSED_THRESHOLD Float Ec/Iothresholdforcompressedmodeactivation
Defaultvalue:13
CQI_CPICH_BASED Boolean
CQIdeterminationidsbasedonCPICHquality(true)oronHSPDSCH
quality(false)
Defaultvalue:True
DEFAULT_HOGAIN_UL Float Defaultsofthandoffgainuplink
Defaultvalue:0
Defaultvalue:CostHata
Defaultvalue:50
Defaultvalue:1
HSDPA_NTISNTOT Boolean
Ntincludesornotpilot'ssignalforHSSCCH,HSPDSCHandCPICHfor
CQIdetermination
Defaultvalue:False
Defaultvalue:130
IOISNTOT Boolean Ioincludespilotsignalornot
Defaultvalue:True
NAME Text(50)
Defaultvalue:
NTISNTOT Boolean Ntincludespilotsignalornot
Defaultvalue:False
POWERS_RELATIVE_TO_PILO
T
Boolean
CellpagingandSynchropowers,ServiceAllowedDLminandmaxTCH
powersareabsolutevaluesorrelativetocellpilotpower
Defaultvalue:False
PTOT_RELATIVE_TO_PMAX Boolean
Celltotalpowerisabsolutevalue(dBm)orrelativetoCellmaximum
power(%)
Defaultvalue:False
RSCP_COMPRESSED_THRESH
OLD
Float RSCPthresholdforcompressedmodeactivation(forfutureuse)
Defaultvalue:100
Text
(255)
Defaultvalue:
SPREADING_WIDTH Float Spreadingwidth(MHz)
Defaultvalue:3.84
Defaultvalue:UMTS
Defaultvalue:CDMA
Defaultvalue:
298
14.30 R99BearersTable
Forrelease99bearers.
Description
Text
(255)
Userdefined
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:True
MEAS_PARAM Short
Choicelist:1=CPICH_ECIO;2=CPICH_CI;3=CPICH_ECNT;4=DCH_EBNT;
5=HSPDSCH_ECNT;
Defaultvalue:1
Defaultvalue:
Defaultvalue:True
Defaultvalue:True
ACTIVE_SPREADING_FACTOR
_DL
Integer DLSpreadingFactorforactiveusers
Defaultvalue:256
DL_NOMINAL_BIT_RATE Float
Bearernominalrateindownlink
Unit:kbps
Defaultvalue:9.6
DPCCH_DPCH_RATIO_DL Float RatiobetweenDPCCHandDPCHpowersinDL
Defaultvalue:0
DPCCH_DPCH_RATIO_UL Float RatiobetweenDPCCHandDPCHpowersinUL
Defaultvalue:0
INACTIVE_SPREADING_FACT
OR_DL
Integer DLSpreadingFactorforinactiveusers
Defaultvalue:256
NAME Text(50) Bearername
Defaultvalue:
PTCH_MAX Float
ForDLpartofBearer:Maximumtransmitterpowerontrafficchannel
forthebearernottoexceed
Defaultvalue:21
PTCH_MIN Float
ForDLpartofBearer:Minimumtransmitterpowerontrafficchannelfor
thebearernottoexceed
Defaultvalue:20
TYPE Short
Bearertype(0:Empty,1:Interactive,2:Conversational,3:Background
,4:Streaming)
Defaultvalue:0
UL_NOMINAL_BIT_RATE Float
Bearernominalrateinuplink
Unit:kbps
Defaultvalue:9.6
299
Forrepeaters.
Defaultvalue:18
Defaultvalue:
Defaultvalue:1.5
Defaultvalue:0
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
Defaultvalue:
Defaultvalue:90
Defaultvalue:30
Defaultvalue:12
Defaultvalue:50
Defaultvalue:
Defaultvalue:5
Defaultvalue:1
Defaultvalue:5
Defaultvalue:80
Defaultvalue:0
DONOR_CELLID Text(50) Nameofthedonorcell
Defaultvalue:
Defaultvalue:0
Defaultvalue:1
donorandrepeater
Defaultvalue:
300
14.34 ScramblingCodesDomainsTable
Fornamesofscramblingcodedomains.
14.35 ScramblingCodesGroupsTable
Forscramblingcodegroupsbelongingtoscramblingcodedomains.
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:25
Defaultvalue:
Defaultvalue:0
TOTAL_GAIN Float Totalgaintobeappliedtodonorcellpilotpower
Defaultvalue:0
TOTAL_GAIN_UL Float Uplinktotalgaintobeappliedtomobileoutputpower
Defaultvalue:0
Defaultvalue:
DOMAIN_NAME Text(50) Resourcedomainname
Defaultvalue:
DOMAIN_NAME Text(50)
Secondpartoftheuniquekey.Calledgroupingscheme.Setof
scramblingcodegroups.
Defaultvalue:
EXCLUDED
Text
(225)
ListofcodestobeexcludedfromtheseriesdefinedbyFIRST,LASTand
STEP(separatedbyblankcharacters)
Defaultvalue:
EXTRA
Text
(225)
Codestobeadded.ItisforbiddenforEXTRAandEXLUDEDtohave
commonnumbers.Separatormustbeablankcharacter.
Defaultvalue:
FIRST Integer
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
NAME Text(50) Firstpartoftheuniquekey.Nameofthescramblingcodegroup
Defaultvalue:
STEP Integer
LAST.
Defaultvalue:1
301
14.36 SchedulersTable
Forschedulers.
Forscramblingcodeallocationconstraints.
14.39 ServiceQualityTablesTable
Forrelease99performancegraphs.
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
TX_ID Text(50) Firstpartoftheuniquekey.Firstcellnameinasymmetricrelation
Defaultvalue:
TX_ID_OTHER Text(50)
Secondpartoftheuniquekey.Secondcellnameinasymmetric
relation
Defaultvalue:
DL_QI_TABLE Memo QI=f(MEAS_PARAM)MEAS_PARAMfromQualityIndicatorstable
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
SERVICE Text(50) Nameoftheservice(canbenullforsomeQI)
Defaultvalue:
UL_QI_TABLE Memo QI=f(MEAS_PARAM)MEAS_PARAMfromQualityIndicatorstable
Defaultvalue:
302
14.40 SitesTable
Forsites.
ALTITUDE Float
Realaltitude
Unit:m
Defaultvalue:
CDMA_EQUIPMENT Text(50) Equipmentassociatedwiththesite
Defaultvalue:
CHANNEL_ELEMENTS_DL Integer Numberofavailablechannelelementsfordownlink
Defaultvalue:256
CHANNEL_ELEMENTS_UL Integer Numberofavailablechannelelementsforuplink
Defaultvalue:256
COMMENT_
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
MAX_IUB_RATE_DL Float MaxIubBackhaulratefordownlink
Defaultvalue:12288
MAX_IUB_RATE_UL Float MaxIubBackhaulrateforuplink
Defaultvalue:12288
Defaultvalue:
Defaultvalue:50
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
303
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
ANTDIVGAIN Float
Antennadiversitygain
Unit:dB
Defaultvalue:
Defaultvalue:
AS_THRESHOLD Float MaxalloweddifferencewiththebestservertoentertheActiveSet(dB)
Defaultvalue:
Defaultvalue:
Defaultvalue:
CALC_RADIUS Integer
Unit:m
Defaultvalue:
Unit:m
Defaultvalue:
Defaultvalue:
Defaultvalue:
CARRIERS
Text
(255)
Carriersusedbythetransmitter
Defaultvalue:
CDMA_EQUIPMENT Text(50) CDMAequipment
Defaultvalue:
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:
CELLS_POWER_SHARING Boolean Iftrue,cells'powersaresharedforHSDPAusers
Defaultvalue:
CHANNEL_ELEMENTS_DL Integer Numberofchannelelementsfordownlink
Defaultvalue:
CHANNEL_ELEMENTS_UL Integer Numberofchannelelementsforuplink
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
E_RISE
Defaultvalue:
OC
Boolean AllocationofpowerforHSSCCH(True=Dynamic,False=Static)
Defaultvalue:
Defaultvalue:
FBAND Text(50) Frequencyband
Defaultvalue:
Defaultvalue:
304
Unit:m
Defaultvalue:
Unit:m
Defaultvalue:
HEIGHT Float
Unit:m
Defaultvalue:
HS_SCCH_POWER Float
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
HSPA_SUPPORT Short HSPAfeaturessupported:0:None;1:HSDPA;2:HSPA;3:HSPA+
Defaultvalue:
HSUPA_DLPOWER Float
Amountofpower(dBm)dedicatedtoHSUPADLchanels(EAGCH,E
RGCH,EHICH
Defaultvalue:
HSUPA_MAX_USERS Short MaxnumberofHSUPAusersmanagedsimultaneouslybythescheduler
Defaultvalue:
HSUPA_UL_LOAD Float
UplinktransmitterloadfactorduetoHSUPAusers:calculatedbythe
WCDMAsimulationalgorithm
Defaultvalue:
MAX_DL_LOAD Float
Defaultvalue:
transmitter
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
MAX_UL_LOAD Float
simulation
Defaultvalue:
Defaultvalue:
MIMO_SUPPORT Short
loopMIMO
Defaultvalue:
Defaultvalue:
Defaultvalue:
MULTI_CARRIER Short Multicarriermode:0=None;1=Dualcell;
Defaultvalue:
305
Defaultvalue:
NOISE_FIGURE Float Noisefigureusedtodeterminethethermalnoiseatthetransmitter
Defaultvalue:
NUM_HS_SCCH Short NumberofHS_SCCHchannels
Defaultvalue:
NUM_HSDPA_USERS Short
NumberofservedHSDPAusersinthecell:calculatedbytheWCDMA
simulationalgorithm
Defaultvalue:
NUM_HSUPA_USERS Short
NumberofservedHSUPAusersinthecell:calculatedbytheWCDMA
simulationalgorithm
Defaultvalue:
NUM_RX_ANTENNAS Short Numberoftransmissionantennaportsavailableatthetransmitter
Defaultvalue:
Defaultvalue:3
NUM_TX_ANTENNAS Short Numberofreceptionantennaportsavailableatthetransmitter
Defaultvalue:
OTHERS_CCH_POWER Float Powerofcommonchannels(exceptSCH)
Defaultvalue:
Defaultvalue:
Defaultvalue:
PROPAG_MODEL
Text
(255)
Defaultvalue:
PROPAG_MODEL2
Text
(255)
Defaultvalue:
PWR_HEADROOM Float
algorithm)
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
RXLOSSES Float
Lossesintheuplinkduetotransmitterradioequipment
Unit:dB
Defaultvalue:
SC_DOMAIN_NAME Text(50) Scramblingcodedomainname
Defaultvalue:
SCH_POWER Float Powerofthesynchronisation(SCH)channel
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
TOTAL_POWER Float
Defaultvalue:
TX_DIVERSITY_CFG Integer
TXdiversityconfiguration1NoTXdiversity2TXdiv.openloop3TX
div.closedloop
Defaultvalue:
TX_MAX_POWER Float Maximumpowersharablebetweensectors.
Defaultvalue:
306
Fortransmitters.
TXLOSSES Float
Lossesinthedownlinkduetotransmitterradioequipment
Unit:dB
Defaultvalue:
UL_LOAD Float
Defaultvalue:
Uplink(Iintra+Iextra)/Iintra:calculatedbytheWCDMAsimulation
algorithm
Defaultvalue:
ISE
Defaultvalue:
Defaultvalue:True
ANTDIVGAIN Float Antennadiversitygain
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:
CALC_RADIUS Integer
Unit:m
Defaultvalue:4000
Defaultvalue:
Defaultvalue:50
Defaultvalue:
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:2000
CELLS_POWER_SHARING Boolean Iftrue,cells'powersaresharedforHSDPAusers
Defaultvalue:False
COMMENT_
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
HEIGHT Float
Unit:m
Defaultvalue:25
Defaultvalue:
307
14.46 TxsListsTable
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:5
Defaultvalue:1
Defaultvalue:1
PROPAG_MODEL
Text
(255)
model
PROPAG_MODEL2
Text
(255)
Defaultvalue:
Defaultvalue:0
RXLOSSES Float Lossesintheuplinkduetotransmitterradioequipment
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
SITE_NAME Text(50)
table)
Defaultvalue:
Defaultvalue:0
Defaultvalue:
TX_DIVERSITY_CFG Short
TXdiversityconfiguration:1=NoTXdiversity;2=TXdiv.openloop;3=TX
div.closedloop;
Defaultvalue:0
Defaultvalue:
TX_MAX_POWER Float Maximumpowersharablebetweensectors
Defaultvalue:43
TXLOSSES Float Lossesinthedownlinkduetotransmitterradioequipment
Defaultvalue:0
Defaultvalue:
Defaultvalue:
308
14.48 UECategoriesTable
ForHSDPAUEcategories.
14.49 UERxEquipmentsTable
FornamesofUEreceptionequipment.
14.50 UMTSEnvironmentDefsTable
14.51 UMTSMobilityTable
Formobilitytypes.
Defaultvalue:
MAX_BLOCK_SIZE Integer Maximumtransportblocksizesupported(bits)
Defaultvalue:26000
MAX_HSPDSCH_NUM Short MaximumnumberofHSPDSCHchannelsforHSDPA
Defaultvalue:5
MIMO_SUPPORT Short MIMOsupport:0=None;1=MIMO;
Defaultvalue:0
MIN_INTERTTI_NUM Short MinimumnumberofTTIbetweentwoTTIused
Defaultvalue:1
MODULATION Short Modulation:0=QPSK;1=16QAM;2=64QAM;
Defaultvalue:0
Defaultvalue:0
UE_CATEGORY Short UEcategoryforHSDPA
Defaultvalue:
UE_CATEGORY_NAME Text(50) NameoftheHSDPAUEcategory
Defaultvalue:
NAME Text(50) NameofthetypeofreceiverintheUE
Defaultvalue:
DENSITY Float
2
Defaultvalue:0
Defaultvalue:
Defaultvalue:
USER_PROFILE Text(50) Typeofuserprofile
Defaultvalue:
HSSCCH_ECNT Float HSSCCHEc/NttargetforHSDPA
Defaultvalue:12
309
14.52 UMTSServicesTable
Forservices.
MEAN_SPEED Float Meanmobilespeed(km/h)usedforHSDPA
Defaultvalue:0
NAME Text(50) Typeofmobility
Defaultvalue:
TADD Float MinimumEc/Ioforbestserverselection
Defaultvalue:
ADPCH_ACTIVITY Float ActivityFactorforHSDPAusers
Defaultvalue:0.1
BODY_LOSS Float Bodyloss
Defaultvalue:0
CARRIER_LIST Text(50) Listofpreferredcarriernumbers
Defaultvalue:
CARRIER_SUPPORT Integer Carriersupporttype:0=Prefered;1=Allowed;
Defaultvalue:0
CPC_SUPPORT Short
Continuouspacketconnectivitysupport:None;DLDRX/ULDTX;HS
SCCHLessoperation;HSFACH
Defaultvalue:0
DL_ACTIVITY Float Activityfactorforcircuitswitchedserviceonthedownlink
Defaultvalue:1
DL_DP Float Packetinterarrivaltime(ms)onthedownlink
Defaultvalue:0
DL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)onthedownlink
Defaultvalue:0
DL_GBR Float Guaranteddownlinkbitrate(kbps)
Defaultvalue:
DL_MBR Float Maximumdownlinkbitrate(kbps)
Defaultvalue:
DL_NPC Integer Numberofpacketcallsduringasessiononthedownlink
Defaultvalue:1
DL_PACKET_EFFICIENCY Float Packetefficiencyfactoronthedownlink
Defaultvalue:
DL_SP Integer Packetsize(Bytes)onthedownlink
Defaultvalue:1500
DL_SPC_MAX Float DownlinkmaxPacketcallsize(kBytes)
Defaultvalue:2000
DL_SPC_MIN Float DownlinkminPacketcallsize(kBytes)
Defaultvalue:4
EDPCH_ACTIVITY Float ActivityFactorforHSUPAusers
Defaultvalue:0.1
ENABLE_DOWNGRADING Boolean Servicesupportslowerbearerthannominalbearer
Defaultvalue:True
NAME Text(50) Servicename
Defaultvalue:
PRIORITY Integer Priorityleveloftheservice:parameterusedintheWCDMAsimulation
Defaultvalue:0
R99BEARER Text(50) NameoftheR99Bearer
Defaultvalue:
REQ_AVERAGE_DL_RATE Float RequestedAverageDownlinkRate(kbps)
Defaultvalue:
310
14.53 UMTSServicesQualityTable
Forrelease99serviceaccessthresholds.
Defaultvalue:
TH_OFFSET Float Offsettoaddtotheaboveratio
Defaultvalue:0
TH_SCALE_FACTOR Float RatiobetweenapplicationthroughputandRLClayerthroughput
Defaultvalue:95
TYPE Short Typeofservice:0=circuit;1=packet;2=circuitoverpacket;
Defaultvalue:0
UL_ACTIVITY Float Activityfactorforcircuitswitchedserviceontheuplink
Defaultvalue:1
UL_DP Float Packetinterarrivaltime(ms)ontheuplink
Defaultvalue:0
UL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)ontheuplink
Defaultvalue:0
UL_GBR Float Guaranteduplinkbitrate(kbps)
Defaultvalue:
UL_MBR Float Maximumuplinkbitrate(kbps)
Defaultvalue:
UL_NPC Integer Numberofpacketcallsduringasessionontheuplink
Defaultvalue:1
UL_PACKET_EFFICIENCY Float Packetefficiencyfactorontheuplink
Defaultvalue:
UL_SP Integer Packetsize(Bytes)ontheuplink
Defaultvalue:1500
UL_SPC_MAX Float UplinkmaxPacketcallsize(kBytes)
Defaultvalue:2000
UL_SPC_MIN Float UplinkminPacketcallsize(kBytes)
Defaultvalue:4
USE_HANDOFF Boolean 'Yes'iftheservicesupportssofthandoff
Defaultvalue:False
DL_TARGET_QUAL Float Eb/Nttargetonthedownlinkforatypeofmobility
Defaultvalue:0
DL_TGT_QUAL_DIVCLOSED Float Eb/NttargetondownlinkincaseofTXdiversityclosedloop
Defaultvalue:0
DL_TGT_QUAL_DIVOPEN Float Eb/NttargetondownlinkincaseofTXdiversityopenloop
Defaultvalue:0
MOBILITY Text(50) Secondpartoftheuniquekey.Typeofmobility
Defaultvalue:
RX_EQUIP Text(50) Typeofreceiver
Defaultvalue:
Standard
SERVICE Text(50) Firstpartoftheuniquekey.NameoftheR99Bearer
Defaultvalue:
UL_TARGET_QUAL Float Eb/Nttargetontheuplinkforatypeofmobility
Defaultvalue:0
UL_TGT_QUAL_DIV2RX Float Eb/Nttargetonuplinkincaseof2RXdiversity
Defaultvalue:0
UL_TGT_QUAL_DIV4RX Float Eb/Nttargetonuplinkincaseof4RXdiversity
Defaultvalue:0
311
14.54 UMTSServicesUsageTable
14.55 UMTSTerminalsTable
Forterminalstypes.
CALL_DURATION Float
Averagedurationofacall(forcircuitswitchedservices)
Unit:s
Defaultvalue:
CALL_NUMBER Float
Defaultvalue:0
DL_VOLUME Float
Datavolumetransferredonthedownlinkduringasession(forpacket
switchedservices)
Unit:Kbyte
Defaultvalue:
Defaultvalue:
Defaultvalue:
UL_VOLUME Float
Datavolumetransferredontheuplinkduringasession(forpacket
switchedservices)
Unit:Kbyte
Defaultvalue:
Defaultvalue:
ACTIVE_SET_SIZE Short Maximumnumberoftransmitterspossiblyconnectedtothereceiver
Defaultvalue:3
CPC_SUPPORT Short
Continuouspacketconnectivitysupport:None;DLDRX/ULDTX;HS
SCCHLessoperation;HSFACH
Defaultvalue:0
ENABLE_COMPRESSED_MOD
E
Boolean
Iftrue,themobileconnectedtoacompressedmodecapableNodeBis
abletomanagecompressedmodewhennecessary
Defaultvalue:False
GAIN Float Receiverantennagain
Defaultvalue:0
HSPA_SUPPORT Short HSPAfeaturessupported:0=None;1=HSDPA;2=HSPA;
Defaultvalue:0
HSUPA_UE_CATEGORY Short CategoryoftheUserEquipmentforHSUPA
Defaultvalue:1
LOSS Float Receiverantennaloss
Defaultvalue:0
MUD_FACTOR Float
AdvancedReceiverFactortomodelintracellinterferencereductionfor
HSDPAterminalsonly
Defaultvalue:0
Defaultvalue:
NOISE_FACTOR Float Noisefigureusedtodeterminethethermalnoiseatthereceiver
Defaultvalue:8
NOISE_FACTOR_SEC Float
Noisefigureusedtodeterminethethermalnoiseatthereceiver(forthe
secondaryfrequencyband)
Defaultvalue:8
thirdfrequencyband)
Defaultvalue:8
NUM_RX_ANTENNAS Short Numberofreceptionantennaportsavailableattheterminal
Defaultvalue:1
PMAX Float Maximumreceiverpowerontrafficchannel
Defaultvalue:21
PMIN Float Minimumreceiverpowerontrafficchannels
Defaultvalue:20
312
14.56 UMTSTraficEnvironmentsTable
14.57 UMTSUserProfilesTable
14.58 UnitsTable
Forthereceptionandtransmissionunits,theprojectioncoordinatesystemspecifiedintheATLdocument,andthedatabase
internalcoordinatesystem.
PRIMARY_BAND Text(50) Primaryfrequencyband
Defaultvalue:
Efficiencyoftherakereceiver.UsedforcombinationofActiveSet
membercontributions
Defaultvalue:1
RHO_FACTOR Short Rhofactortomodelselfgeneratedinterference
Defaultvalue:100
RX_EQUIP Text(50) TypeoftheUserEquipmentReceiver
Defaultvalue:Standard
SECONDARY_BAND Text(50) Secondaryfrequencyband
Defaultvalue:
Defaultvalue:
UE_CATEGORY Short CategoryoftheUserEquipmentforHSDPA
Defaultvalue:1
Defaultvalue:Yes
Defaultvalue:
Defaultvalue:
Defaultvalue:1
GAIN_UNIT Integer
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
AT320_AM_E2 Chapter15:CDMA2000DataStructure
313
15 CDMA2000DataStructure
Figure 15.1 on page 313, Figure 15.2 on page 314, and Figure 15.3 on page 315 depict the CDMA2000 1xRTT 1xEVDO
databasestructure.ThefollowingsubsectionslistthetablesintheCDMA20001xRTT1xEVDOtemplatedatastructure.
Figure 15.1:CDMA20001xRTT1xEVDOTemplate1
314
Chapter15:CDMA2000DataStructure Forsk2013
Figure 15.2:CDMA20001xRTT1xEVDOTemplate2
315
Figure 15.3:CDMA20001xRTT1xEVDOTemplates3
316
AntennasTable
CdmaCellsTable
CustomFieldsTable
FrequencyBandsTable
NeighboursTable
SitesTable
TransmittersTable
Defaultvalue:
RSCP_MIN Float Minimumreceivedsignalcodepower
Defaultvalue:150
Defaultvalue:0
DELTA_CN Integer Logicalnumericspacingbetweentwoadjacentcarriernumbers
Defaultvalue:1
EXCLUDED_CHANNELS
Text
(255)
Excludedcarriernumbers
Defaultvalue:
RELATION_TYPE Short
Neighbourrelationtype
0=Intracarrier;1=Intercarrier
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
317
UMTSTerminalsTable
NetworksTable
AS_PARAMS_IN_CELL
SitesTable
SUPPORT_NATURE
15.2 AntennasTable
Forantennas.
ForNodeBequipment.
NOISE_FACTOR_THIRD Float Noisefigureoftheterminalforthethirdfrequencyband
Defaultvalue:8
THIRD_BAND Text(50) Thirdfrequencybandsupportedbytheterminal
Defaultvalue:
Defaultvalue:
COMMENT_
Text
(255)
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
ELECTRICAL_TILT Float Antennaelectricaltilt
Defaultvalue:
FMax Double Maximumoperatingfrequency(MHz)oftheantennas
Defaultvalue:
FMin Double Minimumoperatingfrequency(MHz)oftheantenna
Defaultvalue:
GAIN Float Antennaisotropicgain(dBi)
Defaultvalue:0
Defaultvalue:
Defaultvalue:
onpage 113.
318
15.4 CarriersTypeTable
Forcarriertypedefinition(1xEVDOor1xRTT).
15.5 CDMACellsTable
Forcells.
combiner)
Defaultvalue:0
combiner)
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:100
Defaultvalue:0
TYPE Short Carriertype
Defaultvalue:0
ACTIVE Boolean Cell'sactivity:Truemeansthatthecellisactive
Defaultvalue:True
BCMCS_RATE Float BCMCSservicerate
Defaultvalue:204.8
BCMCS_TS_PCT Float %oftimeslotsdedicatedtoBroadcast/MultiCastservices
Defaultvalue:5
Defaultvalue:0
CCH_TS_PCT Float %oftimeslotsdedicatedtoCommonControlChannels
Defaultvalue:3
Defaultvalue:
Defaultvalue:
COMMENT_
Text
(255)
Defaultvalue:
E_RISE
Defaultvalue:0
DRC_ER_RATE Float DRCErasureRate(ie%oftimeDRCvaluesareinerror)
Defaultvalue:25
IDLE_POWER_GAIN Float Gaindedicatedtotransmittedpowerinidlestate.
Defaultvalue:10
LOCKED_PNO Boolean
FieldusedtofreezeallocatedPNOofthecellduringautomatic
allocation
Defaultvalue:False
MAX_DL_LOAD Float
Defaultvalue:50
MAX_EVDO_USERS Integer MaximumnumberofEVDOusers
Defaultvalue:256
319
Forsiteequipment.
Defaultvalue:
Defaultvalue:
Defaultvalue:
MAX_UL_LOAD Float
simulation
Defaultvalue:75
MUG_TABLE Memo SetofvaluesusedtogeneratethegraphMUG=f(numberofusers)
Defaultvalue:
PAGING_POWER Float PowerofothercommonchannelsexceptSCH
Defaultvalue:30
Defaultvalue:33
PN_DOMAIN_NAME Text(50) PNOffsetdomainname.
Defaultvalue:
PN_OFFSET Integer PNOffset.
Defaultvalue:
POOLED_PWR Float AmountofpowerwhichcanbeborrowedintheBTSpowerpool(dB)
Defaultvalue:1
Defaultvalue:43
REUSE_DIST Float MinimumreusedistanceforPNOffsets
Defaultvalue:
ROT_RANGE Float Deltaofacceptablenoiserise(dB)
Defaultvalue:1
ROT_TARGET Float ReceiverNoiseRiseOverThermaltarget(dB)
Defaultvalue:4
Defaultvalue:150
SYNCHRO_POWER Float Powerofthesynchronisation(SCH)channel
Defaultvalue:23
Defaultvalue:14
TDROP Float Ec/Iothresholdforactivesetrejection
Defaultvalue:17
TOTAL_POWER Float
Defaultvalue:
Defaultvalue:
UL_LOAD Float
Defaultvalue:
ISE
Defaultvalue:0
CARRIER_SELECTION Short
Carrierselectionmode
Choicelist:0=MinULnoise;1=MinDLpower;2=Random;3=Sequential;
Defaultvalue:0
CE_SHARED_ALL_SECTORS Boolean IftrueCEresourcesissharedbetweenallsectorsofthesite
Defaultvalue:False
320
15.8 CoordSysTable
CES_OVERHEAD_DL Integer
NumberofchannelelementsusedforDLoverheadchannels(pilot,
synchro,...)
Defaultvalue:0
CES_OVERHEAD_UL Integer
NumberofchannelelementsusedforULoverheadchannels(pilot,
synchro,...)
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Efficiencyoftherakereceiver.UsedforcombinationofASmember
contributions
Defaultvalue:1
SPP Boolean
(SectorPowerPooling)IfTrue,sectors'powersavailableforTCHcanbe
sharedamongallcositesectors
Defaultvalue:False
USE_NEIGHBOURS Boolean
Iftrue,selectionofASmembersislimitedtotheneighboursofthe
selectedtransmitter
Defaultvalue:False
CHANNEL_ELTS_DL Float Numberofchannelelementsusedfordownlink
Defaultvalue:1
CHANNEL_ELTS_UL Float Numberofchannelelementsusedforuplink
Defaultvalue:1
Defaultvalue:
TERMINAL Text(50) Secondpartoftheuniquekey.Terminalname.
Defaultvalue:
CODE Integer
Defaultvalue:0
DATUM_CODE Double
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
321
ELLIPS_CODE Integer
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
PROJ_METHOD Short
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
CHOICE_TYPE Integer 0=Choicelistisoptional;1=Choicelistismandatory
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
322
15.10 DLBearersSelectionTable
Fordownlinkbearerselectionthresholds.
15.11 DLDORABearersTable
FordownlinkEVDORev.Abearers.
15.12 DORABearersTable
ForuplinkEVDORev.Abearers.
15.13 DORABearersProbaTable
ForuplinkEVDORev.Abearerprobabilities.
BEARER_INDEX Short Indexofselectedbearer
Defaultvalue:0
CI_REQ Float RequiredPilotC/I
Defaultvalue:
EARLY_TERM_TABLE Memo TablesofProbabilitiesofEarlierTermination=f(REPEAT_NUM)
Defaultvalue:
Defaultvalue:
MODULATION Short 0=QPSK;1=8PSK;2=16QAM;3=64QAM
Defaultvalue:0
NUM_SLOTS Integer Numberofretransmissionstoensureacorrecttransmission
Defaultvalue:1
Defaultvalue:"Standard"
BEARER_INDEX Short EVDObearerindex
Defaultvalue:
RLC_PEAK_RATE Float RLCbearerrate
Defaultvalue:0
TRANSPORT_BLOCK_SIZE Integer Transportblocksize(Bits)
Defaultvalue:0
Defaultvalue:
RLC_PEAK_RATE Float RLCbearerrate
Defaultvalue:0
TRANSPORT_BLOCK_SIZE Integer Transportblocksize(Bits)
Defaultvalue:0
Defaultvalue:
PROBA Float Probabilityofusingabearer
Defaultvalue:0
SERVICE Text(50) Nameoftheservice
Defaultvalue:
323
15.14 DORATerminalT2PRatiosTable
Foruplinktraffictopilotgains.
Forfeeders.
Forfrequencybands.
AUX_PILOT_GAIN Float Auxiliarypilotgain
Defaultvalue:
Defaultvalue:0
HC_T2P_GAIN Float TraffictopilotgainforHighCapacityservices
Defaultvalue:
LL_T2P_GAIN Float TraffictopilotgainforLowLatencyservices
Defaultvalue:
TERMINAL Text(50) Terminalname
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:5
DELTA_CN Integer Logicalnumericspacingbetweentwoadjacentcarriernumbers
Defaultvalue:1
EXCLUDED_CHANNELS
Text
(255)
Excludedcarriernumbers
Defaultvalue:
Defaultvalue:0
FREQUENCY Double
Unit:MHz
Defaultvalue:2110
Defaultvalue:0
Defaultvalue:
Defaultvalue:1.2288
324
Defaultvalue:0
Defaultvalue:0
Defaultvalue:200
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
A
FORCE_HHO Boolean
neighbours
Defaultvalue:False
Defaultvalue:1
Defaultvalue:
REASON Integer
RELATION_TYPE Short
Neighbourrelationtype
0=Intracarrier;1=Intercarrier
Defaultvalue:
Defaultvalue:
Defaultvalue:
FORCE_HHO Boolean
neighbours
Defaultvalue:False
Defaultvalue:
325
15.23 NetworksTable
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:False
Defaultvalue:0
Defaultvalue:50
Defaultvalue:1
326
15.24 PnCodesDomainsTable
FornamesofPNoffsetdomains.
15.25 PnCodesGroupsTable
ForPNoffsetgroupsbelongingtoPNoffsetdomains.
Defaultvalue:130
Defaultvalue:True
NAME Text(50)
Defaultvalue:
Defaultvalue:False
T
Boolean
Defaultvalue:False
power(%)
Defaultvalue:False
Text
(255)
Defaultvalue:
Defaultvalue:1.2288
Defaultvalue:1xRTT
Defaultvalue:CDMA
UC_PWC_ON_PILOT Boolean Trueifuplinkpowercontrolisbasedonpilotstarget
Defaultvalue:False
Defaultvalue:
DOMAIN_NAME Text(50) Secondpartoftheuniquekey.DomainofthePNcodegroup.
Defaultvalue:
EXCLUDED
Text
(225)
STEP(separatedbyblankcharacter)
Defaultvalue:
EXTRA
Text
(225)
Defaultvalue:
FIRST Integer
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
NAME Text(50) Firstpartoftheuniquekey.NameofthePNcodegroup
Defaultvalue:
STEP Integer
LAST.
Defaultvalue:1
327
Defaultvalue:
Description
Text
(255)
Userdefined
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:True
MEAS_PARAM Short
5=HSPDSCH_ECNT;
Defaultvalue:1
Defaultvalue:
Defaultvalue:True
Defaultvalue:True
Defaultvalue:18
Defaultvalue:
Defaultvalue:1.5
Defaultvalue:0
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
328
Forrepeaters.
Defaultvalue:
Defaultvalue:90
Defaultvalue:30
Defaultvalue:12
Defaultvalue:50
Defaultvalue:
Defaultvalue:5
Defaultvalue:1
Defaultvalue:5
Defaultvalue:80
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:1
donorandrepeater
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:25
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
329
ForPNoffsetallocationconstraints.
For1xRTTperformancegraphs.
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
relation
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
330
15.34 SitesTable
Forsites.
ALTITUDE Float
Realaltitude
Unit:m
Defaultvalue:
Defaultvalue:
Defaultvalue:256
Defaultvalue:256
COMMENT_
Text
(255)
Defaultvalue:
EVDO_CES Integer NumberofEVDOCEspercarrier
Defaultvalue:96
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:50
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
331
Defaultvalue:0
Defaultvalue:
ANTDIVGAIN Float
Unit:dB
Defaultvalue:
Defaultvalue:
Defaultvalue:
BCMCS_RATE Float BCMCSservicerate
Defaultvalue:
BCMCS_TS_PCT Float %oftimeslotsdedicatedtoBroadcast/MultiCastservices
Defaultvalue:
Defaultvalue:
CALC_RADIUS Integer
Unit:m
Defaultvalue:
Unit:m
Defaultvalue:
Defaultvalue:
Defaultvalue:
CARRIERS
Text
(255)
Carriersusedbythetransmitter
Defaultvalue:
CCH_TS_PCT Float %oftimeslotsdedicatedtoCommonControlChannels
Defaultvalue:
Defaultvalue:
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:
CHANNEL_ELEMENTS_DL Integer Numberofchannelelementsfordownlink
Defaultvalue:
CHANNEL_ELEMENTS_UL Integer Numberofchannelelementsforuplink
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
E_RISE
Defaultvalue:
DRC_ER_RATE Float DRCErasureRate(ie%oftimeDRCvaluesareinerror)
Defaultvalue:
EVDO_CES Integer NumberofEVDOchannelelementspercarrier
Defaultvalue:
Defaultvalue:
Defaultvalue:
332
Unit:m
Defaultvalue:
Unit:m
Defaultvalue:
HEIGHT Float
Unit:m
Defaultvalue:
IDLE_POWER_GAIN Float Gaindedicatedtotransmittedpowerinidlestate
Defaultvalue:
MAX_DL_LOAD Float
Defaultvalue:
MAX_EVDO_USERS Integer MaximumnumberofEVDOusers
Defaultvalue:
transmitter
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
MAX_UL_LOAD Float
simulation
Defaultvalue:
MC_MODE_MUG Memo Multiusergaingraphusedinmulticarriermode
Defaultvalue:
MC_MODE_UL_ECNT_MIN Float RequiredEc/Ntformulticarriermodeintheuplink
Defaultvalue:
Defaultvalue:
Defaultvalue:
MUG_TABLE Memo SetofvaluesusedtogeneratethegraphMUG=f(numusers)
Defaultvalue:
MULTI_CARRIER Short 0=None;1=MultiCarrier
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:3
PAGING_POWER Float Powerofthepagingchannel
Defaultvalue:
Defaultvalue:
PN_DOMAIN_NAME Text(50) PNOffsetcodedomainname
Defaultvalue:
POOLED_PWR Float AmountofpowerwhichcanbeborrowedintheBTSpowerpool(dB)
Defaultvalue:
Defaultvalue:
PROPAG_MODEL
Text
(255)
Defaultvalue:
PROPAG_MODEL2
Text
(255)
Defaultvalue:
333
Fortransmitters.
Defaultvalue:
REUSE_DIST Float MinimumreusedistanceforPNoffsets
Defaultvalue:
ROT_RANGE Float Deltaofacceptablenoiserise(dB)
Defaultvalue:
ROT_TARGET Float ReceiverNoiseRiseOverThermaltarget(dB)
Defaultvalue:
Defaultvalue:
RXLOSSES Float
Unit:dB
Defaultvalue:
Defaultvalue:
Defaultvalue:
SYNCHRO_POWER Float Powerofthesynchronisation(SCH)channel
Defaultvalue:
Defaultvalue:
TDROP Float Ec/Iothresholdforactivesetrejection
Defaultvalue:
Defaultvalue:
Defaultvalue:
TOTAL_POWER Float
Defaultvalue:
TXLOSSES Float
Unit:dB
Defaultvalue:
UL_LOAD Float
Defaultvalue:
ISE
Defaultvalue:
Defaultvalue:True
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:
CALC_RADIUS Integer
Unit:m
Defaultvalue:4000
Defaultvalue:
334
Defaultvalue:50
Defaultvalue:
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:2000
COMMENT_
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
HEIGHT Float
Unit:m
Defaultvalue:25
Defaultvalue:
Defaultvalue:
MC_MODE_MUG Memo Multiusergaingraphusedinmulticarriermode
Defaultvalue:
MC_MODE_UL_ECNT_MIN Float RequiredEc/Ntformulticarriermodeintheuplink
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
MULTI_CARRIER Short 0=None;1=MultiCarrier
Defaultvalue:0
Defaultvalue:5
PROPAG_MODEL
Text
(255)
model
PROPAG_MODEL2
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
SITE_NAME Text(50)
table)
Defaultvalue:
Defaultvalue:0
335
15.40 TxsListsTable
ForUEreceptionequipment.
15.43 ULBearersSelectionTable
Foruplinkbearerselectionthresholds.
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
BEARER_INDEX Short Indexofselectedbearer
Defaultvalue:0
EARLY_TERM_TABLE Memo TablesofProbabilitiesofEarlierTermination=f(REPEAT_NUM)
Defaultvalue:
HC_ECNT_REQ Float RequiredPilotEc/NtforHighCapacityservices
Defaultvalue:
LL_ECNT_REQ Float RequiredPilotEc/NtforLowLatencyservices
Defaultvalue:
Defaultvalue:
Defaultvalue:0
NUM_SUBFRAMES Integer Numberofretransmissionstoensureacorrecttransmission
Defaultvalue:1
Defaultvalue:"Standard"
336
Formobilitytypes.
Forservices.
DENSITY Float
2
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
COVERI_THROUGHPUTS Memo SetofvaluesusedtogeneratetheRate=f(C/I)graph
Defaultvalue:'38.410.5
76.87.5153.64.5307.2
2.614.41921.63.3
1228.851843.29.2
2457.611.5'
DELTA_TADD Float Delta(dB)tobeaddedtotheT_ADDdefinedincellsstructure
Defaultvalue:0
DELTA_TDROP Float Delta(dB)tobeaddedtotheT_DROPdefinedincellsstructure
Defaultvalue:0
Defaultvalue:
UL_ECNT_MIN Float MinimumuplinkEc/Nt(EVDO)
Defaultvalue:22
Defaultvalue:0
CARRIER Integer Carriersupportingtheservice.1meansthatallcarrierscanbeused.
Defaultvalue:1
DLFCH_ACTIVITYFACTOR Float Occupancytimeofthefundamentalchannelonthedownlink
Defaultvalue:1
DLRATE_16 Float
Probabilitytotransmitsixteentimesthenominalrateonthe
supplementarychannel(SCH)onthedownlink
Defaultvalue:0
DLRATE_2 Float
Probabilitytotransmittwicethenominalrateonthesupplementary
channel(SCH)onthedownlink
Defaultvalue:0
DLRATE_4 Float
Probabilitytotransmitfourtimesthenominalrateonthe
Defaultvalue:0
DLRATE_8 Float
Probabilitytotransmiteighttimesthenominalrateonthe
Defaultvalue:0
DOWN_153K6_76K8 Float EVDORev.0Downgradingprobability(153.6>76.8)(Unit1/255)
Defaultvalue:0
Defaultvalue:0
337
Defaultvalue:0
Defaultvalue:0
ENABLE_DOWNGRADING Boolean Trueifdowngradingisenabledfortheservice
Defaultvalue:True
EVDO_ULRATE_1 Float Probabilitytotransmitat9.6kbpsforanEVDOservice
Defaultvalue:0
MIN_RATE_DL Float Downlinkguaranteedbitrate(kbps)
Defaultvalue:0
MIN_RATE_UL Float Uplinkguaranteedbitrate(kbps)
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
QOS_CLASS Short 0="BestEffort"1="GuaranteedBitRate"
Defaultvalue:0
TCP_ACK_CURVE Memo
TableofReverseLinkthroughputs=f(ForwardLinkapplicationlayer
throughput)
Defaultvalue:'0030010
6002090030120040
150050180060240080'
TCP_SERVICE Boolean TrueiftheuserapplicationisusingTCP
Defaultvalue:False
Defaultvalue:0
Defaultvalue:95
TYPE Short '0'=Speech,1=Data1xRTT2=EVDO
Defaultvalue:0
UL_OPERATION_MODE Short 0="HighCapacity"1="LowLatency"
Defaultvalue:0
ULFCH_ACTIVITYFACTOR Float
Eitheroccupancytimeofthefundamentalchannelontheuplinkfor
1xRTT,orprobabilitytotransmitthenominalrateonthesupplementary
channel(SCH)ontheuplinkincaseof1xEVDO.
Defaultvalue:1
ULRATE_16 Float
Probabilitytotransmitsixteentimesthenominalrateonthe
supplementarychannel(SCH)ontheuplink
Defaultvalue:0
ULRATE_2 Float
Probabilitytotransmittwicethenominalrateonthesupplementary
channel(SCH)ontheuplink
Defaultvalue:0
ULRATE_4 Float
Probabilitytotransmitfourtimesthenominalrateonthe
Defaultvalue:0
ULRATE_8 Float
Probabilitytotransmitheighttimesthenominalrateonthe
Defaultvalue:0
UP_19K2_38K4 Float EVDORev.0Upgradingprobability(19.2>38.4)(Unit1/255)
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
USE_HANDOFF Boolean 'Yes'iftheservicesupportssofthandoff
Defaultvalue:False
338
For1xRTTserviceaccessthresholds.
Forterminaltypes.
DL_TARGET_QUAL Float Eb/Nttargetonthedownlinkforeachtypeof(mobility,SCHrate)pair
Defaultvalue:
FCH2PILOT Float
FCHpowertoPilotpowergain.UsedifglobalflagUL_PWC_ON_PILOTis
settoTrue
Defaultvalue:0
Defaultvalue:
PTCH_MAX Float
Maximumtransmitterpoweronfundamentaltrafficchannelforthe
service
Defaultvalue:34
PTCH_MIN Float
Minimumtransmitterpoweronfundamentaltrafficchannelforthe
service
Defaultvalue:14
SCH_RATE Integer SCHRatefactor(0>16)
Defaultvalue:0
SCH2PILOT Float
SCHpowertoPilotpowergain.UsedifglobalflagUL_PWC_ON_PILOTis
settoTrue
Defaultvalue:0
SERVICE Text(50) Firstpartoftheuniquekey.Nameoftheservice
Defaultvalue:
TERMINAL Text(50) Secondpartoftheuniquekey.Typeofterminal
Defaultvalue:
UL_ECNT_MIN Float PilotsEc/Nttarget.UsedifglobalflagUL_PWC_ON_PILOTissettoTrue
Defaultvalue:0
UL_TARGET_QUAL Float Eb/Nttargetontheuplinkforeachtypeof(mobility,SCHrate)pair
Defaultvalue:
CALL_DURATION Float
Unit:s
Defaultvalue:
CALL_NUMBER Float
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
ACK_GAIN Float ACKgain
Defaultvalue:4
ACK_GAIN_DORA Float ACKgainfor1xEvDoRevA
Defaultvalue:3
339
ACTIVE_SET_SIZE Short
Maximumnumberoftransmitterspossiblyconnectedwiththereceiver
forthefundamentalchannel(FCH)
Defaultvalue:6
DRC_GAIN_NOHO Float DRCgain(Nohandoffcase)
Defaultvalue:1
DRC_GAIN_NOHO_DORA Float DRCgain(Nohandoffcase)for1xEvDoRevA
Defaultvalue:1
DRC_GAIN_SOFT Float DRCgain(anykindofsofthandoff)
Defaultvalue:3
DRC_GAIN_SOFT_DORA Float DRCgain(anykindofsofthandoff)for1xEvDoRevA
Defaultvalue:3
DRC_GAIN_SOFTER Float DRCgain(onlysofterhandoff)
Defaultvalue:1
DRC_GAIN_SOFTER_DORA Float DRCgain(onlysofterhandoff)for1xEvDoRevA
Defaultvalue:1
FWD_BASEDATARATE Float
Downlinknominalratesupportedbythereceiveronthefundamental
channel
Defaultvalue:9.6
Defaultvalue:0
HANDOFF_TYPE Short 0=LockedHO;1=UnlockedHO
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:8
NOISE_FACTOR_SEC Float
secondaryfrequencyband)
Defaultvalue:8
NOISE_FACTOR_THIRD Float Noisefigureoftheterminalforthethirdfrequencyband
Defaultvalue:8
NUM_CARRIERS_MAX Short Maximumnumberofcarrierssupportedinmulticarriermode
Defaultvalue:3
PILOT_POWER_PCT Float PercentageofmaximumpowerdedicatedtotheULpilotchannel
Defaultvalue:0
Defaultvalue:23
Defaultvalue:50
PRIMARY_BAND Text(50) Primaryfrequencyband
Defaultvalue:
Efficiencyoftherakereceiver.UsedforcombinationofActiveSet
membercontributions
Defaultvalue:1
RAKE_NUM_FINGERS Short Numberoflinksoftheactivesetthatwillbecombined
Defaultvalue:3
REV_BASEDATARATE Float
Uplinknominalratesupportedbythereceiveronthefundamental
channel
Defaultvalue:9.6
Defaultvalue:94
RRI_GAIN_DORA Float RRIgainfor1xEvDoRevA
Defaultvalue:6
340
15.52 UnitsTable
SCH_AS_SIZE Short
Maximumnumberoftransmitterspossiblyconnectedwiththereceiver
forthesupplementarychannel(SCH)
Defaultvalue:3
SECONDARY_BAND Text(50) Secondaryfrequencyband
Defaultvalue:
SUPPORTED_TECHNO Short 0:Speech,1:1xRTT_Data,2:1xEvDo_Rel0,3:1xEvDo_RelA
Defaultvalue:0
THIRD_BAND Text(50) Thirdfrequencybandsupportedbytheterminal
Defaultvalue:
TRAFFIC_GAIN_153_6 Float Trafficgain(153.6kbps)
Defaultvalue:18
Defaultvalue:7
Defaultvalue:10
Defaultvalue:13
Defaultvalue:4
Defaultvalue:Yes
Defaultvalue:
Defaultvalue:
Defaultvalue:1
GAIN_UNIT Integer
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
AT320_AM_E2 Chapter16:LTEDataStructure
341
16 LTEDataStructure
Figure 16.1 on page 341, Figure 16.2 on page 342, and Figure 16.3 on page 343 depict the LTE database structure. The
followingsubsectionslistthetablesintheLTEtemplatedatastructure.
Figure 16.1:LTETemplate1
342
Chapter16:LTEDataStructure Forsk2013
343
AntennasTable
CustomFieldsTable
FrequencyBandsTable
Defaultvalue:
Defaultvalue:0
DELTA_CN Integer Stepbetweentwoadjacentchannelnumbers
Defaultvalue:1
344
lcchdivgainsTable(New)
lframeconfigsTable
llayersTable(New)
MUGTablesTable
EQUIPMENT Text(50)
Nameofthereceptionequipmenttowhichthecontrolchanneldiversity
gainscorrespond
Defaultvalue:
Defaultvalue:1
Defaultvalue:1
MOBILITY Text(50)
Nameofthemobilitytypetowhichthecontrolchanneldiversitygains
correspond
Defaultvalue:
PBCH_DIV_GAIN Float PBCHdiversitygain
Defaultvalue:0
PDCCH_DIV_GAIN Float PDCCHdiversitygain
Defaultvalue:0
CELLEDGE_PWR_BOOST Float
Ratioofthetransmissionpowerofcelledgefrequencyblockstocell
centrefrequencyblocksforSoftFFRandPartialSoftFFR
Defaultvalue:
CYCLIC_PREFIX Short Cyclicprefixusedbydatasubframesofacell
Defaultvalue:0
ICIC_MODE Short
Theintercellinterferencecoordinationmodeoftheconfiguration:0
TDFFR;1HardFFR;2SoftFFR;3PartialSoftFFR
Defaultvalue:0
PDCCH_SYMBOLS Short NumberofOFDMsymbolspersubframecorrespondingtothePDCCH
Defaultvalue:1
PRACH_PREAMBLE_FORMAT Short ThepreambleformatforthePRACH
Defaultvalue:
PUCCH_AVG_NRB Float AveragenumberoffrequencyblockscorrespondingtothePUCCH
Defaultvalue:2
LAYER_INDEX Short Indexofthenetworklayer
Defaultvalue:0
MAX_SPEED Float Nameofthenetworklayer
Defaultvalue:300
NAME Text(50) Priorityofthenetworklayer
Defaultvalue:
PRIORITY Short Maximumspeedofmobilesforthislayer
Defaultvalue:0
SELECTION_MARGIN Float Layerselectionmargin
Defaultvalue:0
BEARER_INDEX Short IndexofradiobearerforwhichtheMUGgainisdefined
Defaultvalue:
MUG_TABLE_UL Memo Uplinkmultiuserdiversitygaintable
Defaultvalue:
345
NetworksTable
SitesTable
T4GBearersRequiredCITable
T4GCellsTable
T4GMimoConfigsTable
T4GServicesTable
MIMO_INT_PWR_COMB Short Whetherinterferingsignalsarecombinedovermultipleantennasornot
Defaultvalue:1
MUMIMO_CRITERION Short RadioconditionsbasedonwhichMUMIMOisactivatedornot
Defaultvalue:0
MAX_S1_RATE_DL Float
MaximumdownlinkuserthroughputsupportedbytheS1interface
excludingcontrolplanemessaging,GTPU/UDP/IPheaders,andother
Defaultvalue:950000
MAX_S1_RATE_UL Float
MaximumuplinkuserthroughputsupportedbytheS1interface
Defaultvalue:950000
Defaultvalue:
AMS_THRESHOLD Float
RadioqualityrequiredtoswitchfromdiversitygainstoSUMIMO
throughputgains
Defaultvalue:
MUMIMO_THRESHOLD Float RadioqualityrequiredtoactivateMUMIMO
Defaultvalue:
ABS_PATTERN Text(80) Thepatternofabsoluteblanksubframeswith1=ABSand0=nonABS
Defaultvalue:
CELL_TYPE Short Typeofcell(0=LTER8;1=LTER10PCell;2=LTER10SCell)
Defaultvalue:0
DL_MU_SM_GAIN Float DownlinkMUMIMOcapacitygain
Defaultvalue:0
P_SCH_ID Short PrimarySynchronisationSignalID[02]
Defaultvalue:0
PSS_ID_STATUS Short PSSIDallocationstatus(0=Notallocated,1=Allocated,2=Locked)
Defaultvalue:0
S_SCH_ID Short SecondarySynchronisationSignalID[0167]
Defaultvalue:0
UNIQUE_ID Text(50) UniqueID
Defaultvalue:
MUMIMO_DIV_GAIN Float DiversitygainapplicablewithMUMIMO
Defaultvalue:0
SUMIMO_DIV_GAIN Float DiversitygainapplicablewithSUMIMO
Defaultvalue:0
MIN_RB_UL Integer Minimumnumberofrequiredfrequencyblocksfortheservice
Defaultvalue:1
346
T4GTerminalsTable
T4GUECategoriesTable
TransmittersTable
SitesTable
SUPPORT_NATURE
16.2 AntennasTable
Forantennas.
QCI Short 3GPPQCI(QoSClassIdentifier)fortheservice
Defaultvalue:
SUPPORTED_LAYER_LIST Text(50) Listofnetworklayersonwhichtheserviceisallowed
Defaultvalue:1
N_SCELLS_DL Short Numberofsecondarycellsindownlink(carrieraggregation)
Defaultvalue:0
N_SCELLS_UL Short Numberofsecondarycellsinuplink(carrieraggregation)
Defaultvalue:0
SUPPORTED_LAYER_LIST Text(50) Listofnetworklayerssupportedbytheterminal
Defaultvalue:1
UE_CAT_FOR_DOWNGRADE Text(50) NameoftheUEcategoryfordowngradefromLTER10toLTER8
Defaultvalue:
Defaultvalue:
LAYER_LIST
Text
(255)
Listoflayers
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
COMMENT_
Text
(255)
Additionalinformationabouttheantenna
Defaultvalue:
CONSTRUCTOR
Text
(255)
Antennamanufacturername
Defaultvalue:
DIAGRAM Binary
Internalbinaryformatcontainingthedescriptionoftheantenna
horizontalandverticalpatterns
Defaultvalue:
347
ForeNodeBequipment.
16.4 CoordSysTable
Forthe projection coordinatesystem andthe databasesinternalcoordinatesystem(this isthe displaycoordinatesystem
Defaultvalue:
Defaultvalue:
FMax Double
Maximumfrequencyofcreatedantenna
Unit:MHz
Defaultvalue:
FMin Double
Minimumfrequencyofcreatedantenna
Unit:MHz
Defaultvalue:
GAIN Float
Unit:dBi
Defaultvalue:0
NAME Text(50) Nameofantennacreatedinthecurrentproject
Defaultvalue:
Defaultvalue:
onpage 113.
combiner)
Defaultvalue:0
combiner)
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
RHO_FACTOR Float Rhofactor(notused)
Defaultvalue:0
CODE Integer
Defaultvalue:0
DATUM_CODE Double
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
348
Defaultvalue:0
Defaultvalue:0
ELLIPS_CODE Integer
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
PROJ_METHOD Short
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
349
Forfeeders.
Forfrequencybands.
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
ADJ_CHANNEL_PROT Float Protectionagainstinterferingsignalsfromadjacentchannels
Defaultvalue:28
Unit:MHz
Defaultvalue:5
Defaultvalue:1
DL_FREQUENCY Double
DLfrequencyofthe1stchannel
Unit:MHz
Defaultvalue:2110
DUPLEXING_METHOD Short
Duplexingmethodusedinthefrequencyband
Choicelist:0=FDD;1=TDD;
Defaultvalue:0
EXCLUDED_CHANNELS
Text
(255)
Defaultvalue:
FIRST_CHANNEL Integer Numberofthefirstphysicalchannelofthefrequencyband
Defaultvalue:0
GUARD_BAND Float Guardbandbetweencarriers(MHz)
Defaultvalue:0
LAST_CHANNEL Integer Numberofthelastphysicalchannelofthefrequencyband
Defaultvalue:0
N_RB Integer Numberofresourceblocksperchannel
Defaultvalue:25
Defaultvalue:
SAMPLING_FREQUENCY Float
Samplingfrequency
Unit:MHz
Defaultvalue:7.68
UL_FREQUENCY Double
ULfrequencyofthe1stchannel
Unit:MHz
Defaultvalue:
350
16.9 lcchdivgainsTable
Forcontrolchanneldiversitygains.
16.10 lframeconfigsTable
Forframeconfigurations.
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
A
EQUIPMENT Text(50)
gainscorrespond
Defaultvalue:
Defaultvalue:1
Defaultvalue:1
MOBILITY Text(50)
correspond
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
ICIC_MODE Short
Defaultvalue:0
N_RB_GROUP0
Text
(255)
Frequencyblocksbelongingtothefirstgroup(PSSID0)
Defaultvalue:
N_RB_GROUP1
Text
(255)
Frequencyblocksbelongingtothesecondgroup(PSSID1)
Defaultvalue:
N_RB_GROUP2
Text
(255)
Frequencyblocksbelongingtothethirdgroup(PSSID2)
Defaultvalue:
N_RB_TOTAL Short Numberoffrequencyblocksforwhichtheconfigurationisdefined
Defaultvalue:0
NAME Text(50) NameoftheICICframeconfiguration
Defaultvalue:
Defaultvalue:1
Defaultvalue:
Defaultvalue:2
351
16.11 llayersTable
Forheterogeneousnetwork(HetNet)deploymentlayers.
16.12 lpcidomainsTable
ForphysicalcellIDdomains.
16.13 lpcigroupsTable
ForphysicalcellIDgroups.
Formultiuserdiversitygainsofproportionalfairschedulers.
Defaultvalue:0
Defaultvalue:300
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
DOMAIN_NAME Text(50) NameofthephysicalcellIDdomain
Defaultvalue:
DOMAIN_NAME Text(50) NameofthephysicalcellIDdomain
Nullcolumnallowed:
Defaultvalue:
EXCLUDED
Text
(225)
ListofIDstobeexcludedfromtheseriesdefinedbyFIRST,LASTand
Defaultvalue:
EXTRA
Text
(225)
IDstobeadded.ItisforbiddenforEXTRAandEXLUDEDtohave
Defaultvalue:
FIRST Integer
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
NAME Text(50) NameofthephysicalcellIDgroupinthedomain
Defaultvalue:
STEP Integer
LAST.
Defaultvalue:1
Defaultvalue:
MAX_CINR Float C/(I+N)abovewhichnoMUGwillbeapplied.
Defaultvalue:16.8
352
MOBILITY Text(50) MobilitytypeforwhichtheMUGtableisdefined.
Defaultvalue:
Defaultvalue:
Defaultvalue:
SCHEDULER_NAME Text(30) NameoftheschedulerforwhichtheMUGtableisdefined.
Defaultvalue:
IMPORTANCE Float Handoverimportance
Defaultvalue:1
NEIGHBOUR Text(50) Neighbourcell
Defaultvalue:
REASON Integer
RELATION_TYPE Short Typeoftheneighbourrelation:0=Intracarrier;1=Intercarrier
Defaultvalue:0
TRANSMITTER Text(50) Referencecell
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer Constraintusedinautomaticallocation.0=Forced;1=Forbidden.
Defaultvalue:0
Defaultvalue:
Defaultvalue:
NEIGHBOUR Text(50) Neighbourcellortransmitter
Defaultvalue:
Defaultvalue:0
Defaultvalue:
353
16.19 NetworksTable
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
AMS_SEL_CRITERION Short
AMScriterion
(0ReferencesignalC/N;1ReferencesignalC/(I+N))
Defaultvalue:0
BS_SELECTION Short Bestserverselectionmethod:0=RSC;1=RSRP;
Defaultvalue:1
CELL_SELECTION Short
Servingcellselectionmethod
(0=Obsolete,1=Obsolete,2=Random,3=Layerpriority;4=Traffic
balancing)
Defaultvalue:3
DEFAULT_CP Short
Defaultcyclicprefix
Choicelist:0=Normal;1=Extended;
Defaultvalue:0
Defaultvalue:"Cost
Hata"
Defaultvalue:50
Defaultvalue:1
Defaultvalue:20
Defaultvalue:1
Defaultvalue:0
NAME Text(50) Typeofnetwork
Defaultvalue:
PDCCH_SYMBOLS Short NumberofsymboldurationspersubframeforPDCCHoverhead
Defaultvalue:1
POWER_CONTROL_MARGIN Float MarginOverMaxBearerThresholddefiningC/ITarget(dB)
Defaultvalue:1
PUCCH_AVG_NRB Float AveragenumberofoverheadresourceblocksforPUCCH
Defaultvalue:2
RS_EPRE_DEFINITION Short
RSEPREDefinitionMethod
0CalculatedfromMaxPower,1UserDefined
Defaultvalue:0
Text
(255)
Defaultvalue:
354
SP_PERIODICITY Short
Switchingpointperiodicity(TDD)
Choicelist:0=HalfFrame;1=Frame;
Defaultvalue:0
SSF_CONFIG Short TDD:Specialsubframeconfiguration(0;1;2;3;4;5;6;7;8;)
Defaultvalue:0
Defaultvalue:LTE
TECHNOLOGY Text(10) Nameofthetechnlogy
Defaultvalue:OFDM
Defaultvalue:121
Defaultvalue:
Description
Text
(255)
Userdefined
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
CS_QI Boolean
FlagindicatingwhethertheQualityIndicatorisusedforVoice(CS)
services
Defaultvalue:True
MEAS_PARAM Short
Defaultvalue:0
NAME Text(50) NameoftheQualityIndicator
Defaultvalue:
PS_QI Boolean
FlagindicatingwhethertheQualityIndicatorisusedforData(PS)
services
Defaultvalue:True
USE_INTERPOLATION Boolean
FlagindicatingwhethertheQualityIndicatormustbeinterpolatedor
not
Defaultvalue:True
ANTENNA Text(50) Receiver'santennaname(ifemptyanomniantennaisused)
Defaultvalue:
HEIGHT Float HeightofthereceiverUnit:m
Defaultvalue:1.5
LOSS Float Lossesduetoreceiverradioequipment(upanddownlink)Unit:dB
Defaultvalue:0.
355
Forrepeaters.
NAME Text(50) Nameofthereceiver
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
Defaultvalue:
Defaultvalue:90
Defaultvalue:30
Defaultvalue:12
Defaultvalue:50
Defaultvalue:
Defaultvalue:5
Defaultvalue:1
Defaultvalue:5
Defaultvalue:80
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:1
donorandrepeater
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
356
Forschedulers.
Defaultvalue:25
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
BEARER_SELECTION Short
BearerSelectionCriterion:0BearerIndex;1PeakRLCThroughput;2
EffectiveRLCThroughput
Defaultvalue:0
Defaultvalue:
SCHEDULING_METHOD Short
0=ProportionalFair;1=ProportionalDemand;2=RoundRobin;3=
MaxC/I
Defaultvalue:0
TARGET_THROUGHPUT_DAT
A
Short
0=PeakRLCThroughput;1=EffectiveRLCThroughput;2=Application
Throughput
Defaultvalue:0
TARGET_THROUGHPUT_VOI
CE
Short
0=PeakRLCThroughput;1=EffectiveRLCThroughput;2=Application
Throughput
Defaultvalue:0
UL_BW_ALLOCATION Short
ULBandwidthAllocationTarget:0FullBandwidth;1Maintain
Connection;2BestBearer
Defaultvalue:2
ANTENNA Text(50)
Nameoftheantennainstalledonthetransmitter
(fromtheAntennastable)
Defaultvalue:
AZIMUT Float Azimuthoftheantenna
Defaultvalue:0
Defaultvalue:0
REDT Float RemoteElectricaltiltofthesecondaryantenna
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
357
16.27 SitesTable
Forsites.
16.30 SmartAntennasTable
Forsmartantennaequipment.
ALTITUDE Float
Realaltitude(userdefined)
Unit:m
Defaultvalue:
COMMENT_
Text
(255)
Additionalinformationaboutthesite
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:950000
Defaultvalue:950000
Defaultvalue:
Defaultvalue:50
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
BROADCAST_ANTENNA Text(50) Broadcast(main)antennamodelforthesmartantenna
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
NAME Text(50) NameoftheSmartAntenna
Defaultvalue:
SA_MODEL Text(50) Smartantennamodelused
Defaultvalue:
358
16.31 SmartAntennasModelsTable
Forsmartantennamodels.
16.32 T4GBearerQualityCurvesTable
Forbearerperformancegraphs.
16.33 T4GBearersTable
Forbearers.
16.34 T4GBearersRequiredCITable
Forbearerselectionthresholds.
SA_DATA Binary Smartantennamodeldata
Defaultvalue:
SA_DESCRIPTION Text(50) Descriptionofthesmartantennamodel
Defaultvalue:
SA_NAME Text(50) Nameofthesmartantennamodel
Defaultvalue:
SA_SIGNATURE Text(50) Signatureofthesmartantennamodel
Defaultvalue:
SA_TYPE Text(50) Typeofthesmartantennamodel
Defaultvalue:
Defaultvalue:0
MOBILITY Text(50) Mobilitytype
Defaultvalue:
QI_CURVE Memo
DLQualityQI=f(MEAS_PARAM)MEAS_PARAMfromQualityIndicators
table
Defaultvalue:
Defaultvalue:
RX_EQUIP Text(50) Nameofthereceptionequipment
Defaultvalue:
BEARER_INDEX Short Modulationandcodingschemenumber
Defaultvalue:1
CODING_RATE Float Codingrate
Defaultvalue:1
MODULATION Short
Modulationtype
Choicelist:0=BPSK;1=QPSK;2=16QAM;3=64QAM;
Defaultvalue:1
NAME Text(50) NameoftheLTEradiobearer
Defaultvalue:
SPECTRAL_EFFICIENCY Float Spectralefficiency=PeakRLCThroughputperHzUnit:bps/Hz
Defaultvalue:0
AMS_THRESHOLD Float
throughputgains
Defaultvalue:
BEARERS_REQUIRED_COVERI Memo
C/IrequiredinDLforselectingaLTEbearerC/I_Req=
f(Best(BEARER_INDEX))
Defaultvalue:
359
16.35 T4GCellsTable
Forcells.
MOBILITY Text(50) CPEmobility
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
AAS_RESULTS Binary Angulardistributionsofdownlinkpower
Defaultvalue:
AAS_USAGE Float Percentageofdownlinktrafficloadcarriedbythesmartantenna
Defaultvalue:0
ACTIVE Boolean Cell'sactivity.Cellisactiveiftrue.
Defaultvalue:True
AMS_THRESHOLD Float
C/(I+N)thresholdforswitchingfromspatialmultiplexingtospacetime
transmitdiversity
Defaultvalue:
Defaultvalue:
Defaultvalue:0
CHANNEL Integer Channelnumber
Defaultvalue:0
CHANNEL_STATUS Short Channelallocationstatus(0=Notallocated,1=Allocated,2=Locked)
Defaultvalue:0
COMMENT_
Text
(255)
Defaultvalue:
DIVERSITY_SUPPORT Short Thetypeofantennadiversitysupportedbythecellindownlink
Defaultvalue:1
DIVERSITY_SUPPORT_UL Short Thetypeofantennadiversitysupportedbythecellinuplink
Defaultvalue:1
DL_FFR_USAGE Float
PercentageofthedownlinktrafficloadcarriedbytheICICpartofthe
cell
Defaultvalue:0
DL_LOAD Float Downlinkcelltrafficload
Defaultvalue:1
Defaultvalue:0
E_RISE
Defaultvalue:0
FBAND Text(50) Frequencybandofthecell
Defaultvalue:
FRAME_CONFIG Text(50) NameoftheICICframeconfiguration
Defaultvalue:
ICIC_DELTAPL_TH Float
MaximumdifferenceindBbetweenthebestserverpathlossand
secondbestServerpathlosstobeconsideredinICICzone
Defaultvalue:0
ICIC_SUPPORT Short
InterCellInterferenceCoordinationSupport
0=None;1=StaticDL;2=StaticUL
Defaultvalue:0
ID_REUSE_MIN_DIST Float TheminimumreusedistancefortheAFPandphysicalcellIDallocation
Defaultvalue:
360
ID_STATUS Short SSSIDallocationstatus(0=Notallocated,1=Allocated,2=Locked)
Defaultvalue:0
MAX_DL_LOAD Float Maximumtrafficloadallowedondownlink
Defaultvalue:100
MAX_EXT_NEIGHB_NUMBER Integer Maximumnumberofintertechnologyneighboursforthiscell
Defaultvalue:
MAX_NEIGHB_NUMBER Integer Maximumnumberofintratechnologyneighboursforthiscell
Defaultvalue:
MAX_NUMBER_OF_USERS Integer Maxsupportednumberofusersforthecell
Defaultvalue:
MAX_UL_LOAD Float Maximumtrafficloadallowedonuplink
Defaultvalue:100
NOISE_RISE_ICIC_UL Float Noiserisereceivedbycelledgetraffic
Defaultvalue:0
NOISE_RISE_UL Float
Uplinknoiserise(dB).Manuallyspecifiedbytheuserorcalculated
duringsimulations.
Defaultvalue:0
NUM_DL_USERS Float NumberofDLconnectedusersforthecell
Defaultvalue:1
NUM_UL_USERS Float NumberofULconnectedusersforthecell
Defaultvalue:1
Defaultvalue:0
PBCH_POWER_OFFSET Float EPREoffsetforPBCHwithrespecttoRSEPRE
Defaultvalue:0
PCI_DOMAIN_NAME Text(50) NameofthephysicalcellIDdomain
Defaultvalue:
PDCCH_POWER_OFFSET Float EPREoffsetforPDCCHwithrespecttoRSEPRE
Defaultvalue:0
PDSCH_POWER_OFFSET Float EPREoffsetforPDSCHwithrespecttoRSEPRE
Defaultvalue:0
PHY_CELL_ID Integer PhysicalcellID
Defaultvalue:0
POWER Float MaximumoutputpowerUnit:dBm
Defaultvalue:43
Defaultvalue:0
RANK Short Zerobasedorderusedbyschedulerforsequentialcellselection
Defaultvalue:
RS_EPRE Float EnergyperresourceElementofreferencesignals
Defaultvalue:0
RSRQ_THRES Float RequiredRSRPforcoverage
Defaultvalue:140
RX_EQUIPMENT Text(50) Receptionequipmentinstalledatthecell
Defaultvalue:
Defaultvalue:0
SCH_POWER_OFFSET Float EPREoffsetforSSwithrespecttoRSEPRE
Defaultvalue:0
SCHEDULER Text(50) Schedulerusedbythecell
Defaultvalue:
SF_CONFIG Short SubframeconfigurationusedbythecellincaseofTDDfrequencyband
Defaultvalue:1
TX_ID Text(50) Nameofthetransmittertowhichthecellbelongs
Defaultvalue:
361
16.36 T4GEnvironmentDefsTable
16.37 T4GEquipmentsTable
Forreceptionequipment.
16.38 T4GMimoConfigsTable
ForMIMOgaingraphs.
UL_FPC_CINR_MAX Float
TargetPUSCHC/(I+N)providesPo_puschandisdrivenbynoiserise
limitationsofneighbouringcells.Thisfieldwillbeoutputfrom
simulation.
Defaultvalue:20
UL_FPC_FACTOR Float
Factorenablingreductionoftransmissionpowersofcelledgeusers
FPCOff;0;0.4;0.5;0.6;0.7;0.8;0.9;1
Defaultvalue:1
UL_FPC_NR_MAX Float Maximumuplinknoiserise
Defaultvalue:6
UL_LOAD Float Uplinkcelltrafficload
Defaultvalue:1
UL_MU_SM_GAIN Float Multiuser(collaborative)MIMOgaininuplink
Defaultvalue:0
Defaultvalue:
ISE
Defaultvalue:0
DENSITY Float
2
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
NAME Text(50) Nameofthereceptionequipment
Defaultvalue:
BEARER_INDEX Short IndexoftheLTEbearer
Defaultvalue:1
EQUIPMENT Text(50) NameoftheequipmenttowhichtheMIMOgainscorrespond
Defaultvalue:
MAX_BLER Float MaximumvalueofBLERforwhichthegainsareapplicable
Defaultvalue:1
MAX_MIMO_GAIN Memo GraphofmaximumMIMOgainsvs.C/(I+N)
Defaultvalue:
MIMO_RX_ANTENNAS Short NumberofMIMOantennasusedforreception
Defaultvalue:1
MIMO_TX_ANTENNAS Short NumberofMIMOantennasusedfortransmission
Defaultvalue:1
362
16.39 T4GMobilityTable
Formobilitytypes.
16.40 T4GServicesTable
Forservices.
MOBILITY Text(50) Usermobility
Defaultvalue:
Defaultvalue:0
STTD_GAIN Float DiversitygainthatwillbeappliedtotheCINR(dB)
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
BODY_LOSS Float Lossesduetotheusersbody(dB)
Defaultvalue:0
Defaultvalue:1
DL_DP Float Packetinterarrivaltime(ms)indownlink
Defaultvalue:0
DL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)indownlink
Defaultvalue:0
DL_GBR Float MinimumrequiredtransmissionrateinDL(GuaranteedBitRate)
Defaultvalue:0
DL_HIGHEST_BEARER Float ThehighestbearerallowedtobeusedforthisserviceinDL
Defaultvalue:15
DL_LOWEST_BEARER Short ThelowestbearerallowedtobeusedforthisserviceinDL
Defaultvalue:1
DL_MBR Float MaximumsustainedtrasmissionrateinDL(MaximumBitRate)
Defaultvalue:0
DL_NPC Integer Numberofpacketcallsduringasessionindownlink
Defaultvalue:1
DL_SP Integer Packetsize(Bytes)indownlink
Defaultvalue:1500
DL_SPC_MAX Float Downlinkmaximumpacketcallsize(kBytes)
Defaultvalue:2000
DL_SPC_MIN Float Downlinkminimumpacketcallsize(kBytes)
Defaultvalue:4
Defaultvalue:1
Defaultvalue:
Defaultvalue:0
363
16.41 T4GServicesUsageTable
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:1
TH_OFFSET Float OffsettoaddtoTH_SCALE_FACTOR
Defaultvalue:0
TH_SCALE_FACTOR Float RatiobetweenapplicationlevelthroughputandRLClayerthroughput
Defaultvalue:95
TYPE Short
Servicetype
Choicelist:0=Voice;1=Data;
Defaultvalue:0
Defaultvalue:1
UL_DP Float Packetinterarrivaltime(ms)inuplink
Defaultvalue:0
UL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)inuplink
Defaultvalue:0
UL_GBR Float MinimumrequiredtransmissionrateinUL(GuaranteedBitRate)
Defaultvalue:0
UL_HIGHEST_BEARER Float ThehighestbearerallowedtobeusedforthisserviceinUL
Defaultvalue:15
UL_LOWEST_BEARER Short ThelowestbearerallowedtobeusedforthisserviceinUL
Defaultvalue:1
UL_MBR Float MaximumsustainedtrasmissionrateinUL(MaximumBitRate)
Defaultvalue:0
UL_NPC Integer Numberofpacketcallsduringasessioninuplink
Defaultvalue:1
UL_SP Integer Packetsize(Bytes)inuplink
Defaultvalue:1500
UL_SPC_MAX Float Uplinkmaximumpacketcallsize(kBytes)
Defaultvalue:2000
UL_SPC_MIN Float Uplinkminimumpacketcallsize(kBytes)
Defaultvalue:4
CALL_DURATION Float Averagedurationofacall(forcircuitswitchedservices)Unit:s
Defaultvalue:
CALL_NUMBER Float
Defaultvalue:0
DL_VOLUME Float
switchedservices)Unit:Kbyte
Defaultvalue:
SERVICE Text(50) Service(fromtheServicetable)thatthesubscribercanrequest
Defaultvalue:
TERMINAL Text(50)
Typeofterminal(fromtheTerminaltable)usedbythesubscriberfor
theservice
Defaultvalue:
UL_VOLUME Float
services)Unit:Kbyte
Defaultvalue:
364
16.42 T4GTerminalsTable
Forterminaltypes.
16.43 T4GTraficEnvironmentsTable
16.44 T4GUECategoriesTable
ForUEcategories.
Defaultvalue:
Defaultvalue:
DIVERSITY_SUPPORT Short Antennadiversitysupport(0=None,1=MIMO)
Defaultvalue:1
GAIN Float Terminalantennagain(dB)
Defaultvalue:0
LOSS Float Terminalantennaloss(dB)
Defaultvalue:0
Defaultvalue:1
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
NOISE_FACTOR Float Noisefigureusedtodeterminethethermalnoiseatthereceiver(dB)
Defaultvalue:8
PMAX Float Maximumterminalpowerontrafficchannel(dBm)
Defaultvalue:23
PMIN Float Minimumterminalpowerontrafficchannel(dBm)
Defaultvalue:40
RX_EQUIP Text(50) Nameofthereceptionequipmentavailableattheterminal
Defaultvalue:"Default
CPEReception
Equipment"
Defaultvalue:1
UE_CATEGORY Text(50) UEcategory
Defaultvalue:
Defaultvalue:
Defaultvalue:
365
16.45 T4GUserProfilesTable
BEST_MODULATION Short
Highestsupportedmodulationinuplink
Choicelist:0=QPSK;1=16QAM;2=64QAM;
Defaultvalue:1
DL_TBS_MAX Float MaximumnumberoftransportblockbitsperTTIindownlink
Defaultvalue:
MAX_MIMO_RX_ANTENNAS Short Maximumnumberofreceptionantennaports
Defaultvalue:1
NAME Text(50) UEcategoryname
Defaultvalue:
Defaultvalue:
UL_TBS_MAX Float MaximumnumberoftransportblockbitsperTTIinuplink
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
AMS_THRESHOLD Float CINRthresholdindBtoswitchfromSMtoSTTD
Defaultvalue:
ANTENNA_NAME Text(50)
Nameofthemainantennainstalledonthetransmitter(fromthe
Antennastable)
Defaultvalue:
Defaultvalue:
Defaultvalue:
CALC_RADIUS Integer
CalculationradiususedtodefineeachtransmittercalculationareaUnit:
m
Defaultvalue:
Secondcalculationradius
Unit:m
Defaultvalue:
366
Defaultvalue:
CALC_RESOLUTION2 Integer Secondcalculationresolution
Defaultvalue:
CELL_SIZE Float Radiusofthecell(schematicallyrepresentedbyanhexagon)Unit:m
Defaultvalue:
Defaultvalue:
CHANNEL_LIST Text(255) Channelnumbersusedbytransmitters
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
DIVERSITY_SUPPORT Short
Typeofdiversitysupportusedindownlink
0=None,1=Diversity,2=SUMIMO,3=AMS
Defaultvalue:
DIVERSITY_SUPPORT_UL Short
Typeofdiversitysupportusedinuplink
0=None,1=Diversity,2=SUMIMO,3=AMS,4=MUMIMO
Defaultvalue:
DL_FFR_USAGE Float
PercentageofthedownlinktrafficloadcarriedbytheICICpartofthe
cell
Defaultvalue:
DL_LOAD Float Downlinktrafficload
Defaultvalue:
E_RISE
Defaultvalue:
Defaultvalue:
Defaultvalue:
FEEDERLENGTH_DL Float LengthofdownlinkfeederUnit:m
Defaultvalue:
FEEDERLENGTH_UL Float LengthofuplinkfeederUnit:m
Defaultvalue:
FRAME_CONFIG Text(50) ICICframeconfiguration
Defaultvalue:
HEIGHT Float AntennaheightabovethegroundUnit:m
Defaultvalue:
ICIC_DELTAPL_TH Float
MaximumdifferenceindBbetweenthebestserverpathlossand
secondbestServerpathlosstobeconsideredinICICzone
Defaultvalue:
ICIC_SUPPORT Short
InterCellInterferenceCoordinationSupport
0=None;1=StaticDL;2=StaticUL
Defaultvalue:
ID_REUSE_MIN_DIST Float TheminimumreusedistancefortheAFPandphysicalcellIDallocation
Defaultvalue:
LAYER_LIST
Text
(255)
Listoflayers
Defaultvalue:
Defaultvalue:
MAX_EXT_NEIGHB_NUMBER Integer Maximumnumberofintertechnologyneighbours
Defaultvalue:
MAX_NEIGHB_NUMBER Integer Maximumnumberofintratechnologyneighbours
Defaultvalue:
Defaultvalue:
Defaultvalue:
MISCDLL Float Miscellaneousdownlinkloss
Defaultvalue:
367
MISCULL Float Miscellaneousuplinkloss
Defaultvalue:
Defaultvalue:
NOISE_FIGURE Float
TotalNoisefigureusedtodeterminethethermalnoiseatthe
transmitter(Temp)
Defaultvalue:
NOISE_RISE_ICIC_UL Float Noiserisereceivedbycelledgetraffic
Defaultvalue:
NOISE_RISE_UL Float Uplinkinterferencenoiserise(dB)
Defaultvalue:
Defaultvalue:
PBCH_POWER_OFFSET Float EPREoffsetforPBCHwithrespecttoRSEPRE
Defaultvalue:
PCI_DOMAIN_NAME Text(50) NameofthephysicalcellIDdomain
Defaultvalue:
PDCCH_POWER_OFFSET Float EPREoffsetforPDCCHwithrespecttoRSEPRE
Defaultvalue:
PDSCH_POWER_OFFSET Float EPREoffsetforPDSCHwithrespecttoRSEPRE
Defaultvalue:
PHY_CELLID_LIST Text(255) PhysicalcellIDsusedbytransmitters
Defaultvalue:
POWER Float Maximumcelloutputpower(dBm)
Defaultvalue:
PROPAG_MODEL
Text
(255)
Defaultvalue:
PROPAG_MODEL2
Text
(255)
Nameofthesecondpropagationmodelusedtocalculateprediction
Defaultvalue:
Defaultvalue:
RS_EPRE Float EnergyperresourceElementofreferencesignals
Defaultvalue:
RSRQ_THRES Float RequiredRSRPforcoverage
Defaultvalue:
RX_ANTENNAS_PORTS Short Numberofreceptionantennaports
Defaultvalue:
RX_EQUIPMENT Text(50) Receptionequipment
Defaultvalue:
RXLOSSES Float LossesontheuplinkduetotransmitterradioequipmentUnit:dB
Defaultvalue:
SA_NAME Text(50) Nameofthesmartantennaequipment
Defaultvalue:
SCH_POWER_OFFSET Float EPREoffsetforSSwithrespecttoRSEPRE
Defaultvalue:
Defaultvalue:
SF_CONFIG Short SubframeconfigurationusedbythecellincaseofTDDfrequencyband
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
368
Fortransmitters.
Defaultvalue:
TX_ANTENNAS_PORTS Short Numberoftransmissionantennaports
Defaultvalue:
Defaultvalue:
TXLOSSES Float LossesonthedownlinkduetotransmitterradioequipmentUnit:dB
Defaultvalue:
UL_FPC_CINR_MAX Float
TargetPUSCHC/(I+N)providesPo_puschandisdrivenbynoiserise
limitationsofneighbouringcells.Thisfieldwillbeoutputfrom
simulation.
Defaultvalue:
UL_FPC_FACTOR Float
Factorenablingreductionoftransmissionpowersofcelledgeusers
0;0.4;0.5;0.6;0.7;0.8;0.9;1
Defaultvalue:
UL_FPC_NR_MAX Float Maximumuplinknoiserise
Defaultvalue:
UL_LOAD Float Uplinktrafficload
Defaultvalue:
Defaultvalue:
ISE
Defaultvalue:
Defaultvalue:True
Antennastable)
Defaultvalue:
Defaultvalue:0
Defaultvalue:
CALC_RADIUS Integer CalculationradiususedtodefinethecalculationareaUnit:m
Defaultvalue:4000
Unit:m
Defaultvalue:
Defaultvalue:50
Defaultvalue:
CELL_SIZE Float Radiusofthecell(schematicallyrepresentedbyanhexagon)
Defaultvalue:2000
COMMENT_
Text
(255)
Defaultvalue:
DX Float Xcoordinaterelativetothesiteposition
Defaultvalue:0
DY Float Ycoordinaterelativetothesiteposition
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
369
16.49 TxsListsTable
Defaultvalue:0
Defaultvalue:25
HEXAGON_GROUP Text(50) Groupofhexagonswhichcontainsthistransmitter
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
NOISE_FIGURE Float
transmitter
Defaultvalue:5
POLARIZATION Text(1) Polarizationoftheantennasinstalledatthetransmitter
Defaultvalue:"V"
PROPAG_MODEL Text(50) Nameofthepropagationmodelusedtocalculateprediction
Defaultvalue:
PROPAG_MODEL2 Text(50) Nameofthesecondpropagationmodelusedtocalculateprediction
Defaultvalue:
REDT Float Remoteelectricaltiltofthemainantenna
Defaultvalue:0
RX_ANTENNAS_PORTS Short Numberofantennaportsinreception
Defaultvalue:1
Defaultvalue:0
SA_NAME Text(50) Nameofthesmartantennaequipment
Defaultvalue:
Defaultvalue:
Defaultvalue:0
SITE_NAME Text(50)
Nameofthesiteatwhichthetransmitterislocated(fromtheSites
table)
Defaultvalue:
Defaultvalue:0
Defaultvalue:
TX_ANTENNAS_PORTS Short Numberofantennaportsintransmission
Defaultvalue:1
Defaultvalue:
Defaultvalue:0
TXLOSSES Float Lossesonthedownlinkduetotransmitterradioequipment
Defaultvalue:0
Defaultvalue:
Defaultvalue:
370
16.51 UnitsTable
Defaultvalue:
Defaultvalue:1
GAIN_UNIT Integer
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
AT320_AM_E2 Chapter17:3GPPMultiRATDataStructure
371
17 3GPPMultiRATDataStructure
3GPPMultiRATAtolldocumentscancontainone,two,orall3GPPtechnologies:GSM,UMTS,andLTE.Tablesinthe3GPP
MultiRATtemplateincludethefollowingcategoriesoftables:
"TablesCommontoAllTechnologies"onpage 371
These tables are shared and used by all the technologies. There structures (fields, keys, and relations with other
tables)aresimilartothestructuresofthesetablesinsingletechnologydocuments.
The multiRAT traffic model allows you to define services, terminals, and mobility types, user profiles, and traffic
environmentsforallthreetechnologies.Thesetableshaveamultileveldefinition:atechnologyindependentlevel
andatechnologyspecificlevel.
"GSMspecificTables"onpage 377
"UMTSspecificTables"onpage 382
"LTEspecificTables"onpage 387
Thesetablesarespecifictotechnologies.Therestructuresarethesameasinsingletechnologydocuments.
17.1 TablesCommontoAllTechnologies
17.1.1 ChangesinDataStructureFrom3.1to3.2
17.1.1.1 AddedTablesandFields
antennasTable
customfieldsTable
networksTable
sitesTable
17.1.1.2 DeletedTablesandFields
networksTable
Defaultvalue:
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:950000
Defaultvalue:950000
Defaultvalue:
372
Chapter17:3GPPMultiRATDataStructure Forsk2013
sitesTable
SUPPORT_NATURE
17.1.2 antennasTable
Forthetabledescription,see"AntennasTable"onpage 346.
17.1.3 btsequipmentsTable
Forthetabledescription,see"BTSEquipmentsTable"onpage 347.
17.1.4 coordsysTable
Forthetabledescription,see"CoordSysTable"onpage 347.
17.1.5 customfieldsTable
Forthetabledescription,see"CustomFieldsTable"onpage 348.
17.1.6 environmentdefsTable
Forthetabledescription,see"T4GEnvironmentDefsTable"onpage 361.
17.1.7 feederequipmentsTable
Forthetabledescription,see"FeederEquipmentsTable"onpage 349.
17.1.8 internetchprotectTable
Forthetabledescription,see"InterNetChProtectTable"onpage 349.Thistablecontainsthefollowingadditionalfieldinthe
3GPPmultiRATtemplate:
17.1.9 mobilityTable
Figure 17.1onpage 372,showsthemultileveldefinitionofthemultiRATmobilitytypesmodeltables.
V_TECHNO Text(50) Victimtechnology
Defaultvalue:
Figure 17.1:3GPPMobilityTypesModel
Defaultvalue:
MEAN_SPEED Float Averagespeed(km/h)
Defaultvalue:
373
17.1.10 networksTable
Thenetworkstablecontainsonerecordforeachtechnologyinthedocument.Ineachrecord,onlyparametersrelevantfor
therowstechnologyareused.
Defaultvalue:False
AMScriterion
Defaultvalue:0
Defaultvalue:0
(0=MinDLLoad,1=MinULLoad,2=Random,3=Sequential)
Defaultvalue:2
COMPRESSED_DELTA_DL_Q
UAL
Float Eb/NtDLtargetoverheadduetocompressedmodeactivated
Defaultvalue:1
COMPRESSED_DELTA_UL_Q
UAL
Float Eb/NtULtargetoverheadduetocompressedmodeactivated
Defaultvalue:1
COMPRESSED_ON_ECIO Boolean CompressedmodeactivatedonEc/Iothreshold
Defaultvalue:True
COMPRESSED_ON_RSCP Boolean CompressedmodeactivatedonRSCPthreshold
Defaultvalue:False
COMPRESSED_THRESHOLD Float Ec/Iothresholdforcompressedmodeactivation
Defaultvalue:13
CQI_CPICH_BASED Boolean
CQIdeterminationidsbasedonCPICHquality(true)oronHSPDSCH
quality(false)
Defaultvalue:True
DEFAULT_CP Short
Defaultcyclicprefix
Defaultvalue:0
Defaultvalue:0
Defaultvalue:"Cost
Hata"
Defaultvalue:50
Defaultvalue:1
Ntincludesornotpilot'ssignalforHSSCCH,HSPDSCHandCPICHfor
CQIdetermination
Defaultvalue:False
Defaultvalue:130
Defaultvalue:True
Defaultvalue:1
Defaultvalue:0
Defaultvalue:
Defaultvalue:False
Defaultvalue:1
Defaultvalue:1
T
Boolean
Defaultvalue:False
374
17.1.11 propagationmodelsTable
Forthetabledescription,see"PropagationModelsTable"onpage 354.
17.1.12 receiversTable
Forthetabledescription,see"ReceiversTable"onpage 266.
17.1.13 repeaterequipmentsTable
Forthetabledescription,see"RepeaterEquipmentsTable"onpage 355.
17.1.14 servicesTable
Figure 17.2onpage 375,showsthemultileveldefinitionofthemultiRATservicesmodeltables.
power(%)
Defaultvalue:False
Defaultvalue:2
Defaultvalue:0
RSCP_COMPRESSED_THRESH
OLD
Float RSCPthresholdforcompressedmodeactivation
Defaultvalue:100
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:3.84
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:121
375
17.1.15 servicesusageTable
Forthetabledescription,see"T4GServicesUsageTable"onpage 363.
17.1.16 sitesTable
Figure 17.2:3GPPServicesModel
Defaultvalue:1
Defaultvalue:
Defaultvalue:
Defaultvalue:
TECHNO_PRIORITY Text(50) Listofsupportedtechnologiesintheorderofpriority
Defaultvalue:
Defaultvalue:1
ALTITUDE Float
Realaltitude
Unit:m
Defaultvalue:
Defaultvalue:
Defaultvalue:256
Defaultvalue:256
COMMENT_
Text
(255)
Defaultvalue:
376
17.1.17 siteslistsTable
Forthetabledescription,see"SitesListsTable"onpage 357.
17.1.18 siteslistsnamesTable
Forthetabledescription,see"SitesListsNamesTable"onpage 357.
17.1.19 smartantennasmodelsTable
Forthetabledescription,see"SmartAntennasModelsTable"onpage 358.
17.1.20 terminalsTable
Figure 17.3onpage 376,showsthemultileveldefinitionofthemultiRATterminalsmodeltables.
Defaultvalue:0
Defaultvalue:0
Defaultvalue:12288
Defaultvalue:12288
Defaultvalue:950000
Defaultvalue:950000
Defaultvalue:
Defaultvalue:50
Defaultvalue:
Figure 17.3:3GPPTerminalsModel
NAME Text(50) Nameofterminal
Defaultvalue:
377
17.1.21 tmaequipmentsTable
Forthetabledescription,see"TMAEquipmentsTable"onpage 365.
17.1.22 trafficenvsTable
Forthetabledescription,see"T4GTraficEnvironmentsTable"onpage 364.
17.1.23 unitsTable
Forthetabledescription,see"UnitsTable"onpage 279.
17.1.24 userprofilesTable
Forthetabledescription,see"T4GUserProfilesTable"onpage 365.
17.2 GSMspecificTables
Figure 13.1 on page 249, Figure 13.2 on page 250, and Figure 13.3 on page 251 depict the GSM GPRS EDGE database
structure.
gservicesTable
gservicesusageTable
gterminalsTable
gtpltransmittersTable
MIN_THROUGHPUT_UL Float Uplinkminimumuserthroughputrequestedfortheservice
Defaultvalue:15
Defaultvalue:0
UL_VOLUME Float
services)
Defaultvalue:
Defaultvalue:40
NOISE_FIGURE Float
transmitter
Defaultvalue:
Defaultvalue:
Defaultvalue:
Nullcolumnallowed:
Defaultvalue:
378
gtransmittersTable
gtrgsTable
17.2.2 gafpmodelsTable
Forthetabledescription,see"AfpModelsTable"onpage 253.
17.2.3 gbsicdomainsTable
Forthetabledescription,see"BSICDomainsTable"onpage 254.
17.2.4 gbsicgroupsTable
Forthetabledescription,see"BSICGroupsTable"onpage 254.
17.2.5 gcelltypesTable
Forthetabledescription,see"CellTypesTable"onpage 254.
17.2.6 gcodecequipmentsTable
Forthetabledescription,see"CodecEquipmentsTable"onpage 255.
17.2.7 gcodecmodeadaptsTable
Forthetabledescription,see"CodecModeAdaptationsTable"onpage 255.
17.2.8 gcodecmodesTable
Forthetabledescription,see"CodecModesTable"onpage 255.
17.2.9 gcodecqualtablesTable
Forthetabledescription,see"CodecQualityTablesTable"onpage 256.
17.2.10 gcodingschemesTable
Forthetabledescription,see"EGPRSCodingSchemesTable"onpage 258.
17.2.11 gcsequipmentsTable
Forthetabledescription,see"EGPRSEquipmentsTable"onpage 259.
NOISE_FIGURE Float
transmitter
Defaultvalue:5
Defaultvalue:
Defaultvalue:0
Nullcolumnallowed:
Defaultvalue:0
VAMOS_RATIO Float
Defaultvalue:0
379
17.2.12 gcsqualityTable
Forthetabledescription,see"EGPRSQualityTable"onpage 259.
17.2.13 gdimensmodelTable
Forthetabledescription,see"EGPRSDimensioningModelTable"onpage 258.
17.2.14 gfreqdomainsTable
Forthetabledescription,see"FrequencyDomainsTable"onpage 262.
17.2.15 gfreqgroupsTable
Forthetabledescription,see"FrequencyGroupsTable"onpage 263.
17.2.16 gfrequencybandsTable
Forthetabledescription,see"FrequencyBandsTable"onpage 262.
17.2.17 ghsndomainsTable
Forthetabledescription,see"HSNDomainsTable"onpage 263.
17.2.18 ghsngroupsTable
Forthetabledescription,see"HSNGroupsTable"onpage 263.
17.2.19 glayersTable
Forthetabledescription,see"LayersTable"onpage 264.
17.2.20 glneighboursTable
17.2.21 glneighconstraintsTable
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
380
17.2.22 gneighboursTable
Forthetabledescription,see"NeighboursTable"onpage 264.
17.2.23 gneighconstraintsTable
Forthetabledescription,see"NeighboursConstraintsTable"onpage 264.
17.2.24 gneighextTable
Forthetabledescription,see"NeighboursExtTable"onpage 265.
17.2.25 gneighextconstraintsTable
Forthetabledescription,see"NeighboursConstraintsExtTable"onpage 265.
17.2.26 gqualityindicatorsTable
Forthetabledescription,see"QualityIndicatorsTable"onpage 266.
17.2.27 grepeatersTable
Forthetabledescription,see"RepeatersTable"onpage 267.
17.2.28 gsecondaryantennasTable
Forthetabledescription,see"SecondaryAntennasTable"onpage 268.
17.2.29 gseparationrulesTable
Forthetabledescription,see"SeparationRulesTable"onpage 268.
17.2.30 gseparationsTable
Forthetabledescription,see"SeparationsTable"onpage 268.
17.2.31 gservicequalityTable
Forthetabledescription,see"EGPRSServiceQualityTable"onpage 259.
17.2.32 gservicesTable
Forthetabledescription,see"EGPRSServicesTable"onpage 260.Thetabledoesnotcontainthefollowingfields:
DL_ACTIVITY
REQ_AVERAGE_DL_RATE
REQ_AVERAGE_UL_RATE
UL_ACTIVITY
17.2.33 gterminalsTable
Forthetabledescription,see"EGPRSTerminalsTable"onpage 261.
Defaultvalue:
381
17.2.34 gtpltransmittersTable
Forthetabledescription,see"TplTransmittersTable"onpage 270.
17.2.35 gtransmittersTable
Forthetabledescription,see"TransmittersTable"onpage 272.
17.2.36 gtrgconfigsTable
Forthetabledescription,see"TRGConfigurationsTable"onpage 274.
17.2.37 gtrgsTable
Forthetabledescription,see"TRGsTable"onpage 275.
17.2.38 gtrxequipmentsTable
Forthetabledescription,see"TRXEquipmentsTable"onpage 277.
17.2.39 gtrxsTable
Forthetabledescription,see"TRXsTable"onpage 277.
17.2.40 gtrxtypesTable
Forthetabledescription,see"TRXTypesTable"onpage 278.
17.2.41 gtsconfignamesTable
Forthetabledescription,see"TSConfigurationNamesTable"onpage 278.
17.2.42 gtsconfigsTable
Forthetabledescription,see"TSConfigurationsTable"onpage 278.
17.2.43 gtxslistsTable
Forthetabledescription,see"TxsListsTable"onpage 278.
17.2.44 gtxslistsnamesTable
Forthetabledescription,see"TxsListsNamesTable"onpage 279.
17.2.45 guneighboursTable
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
382
17.2.46 guneighconstraintsTable
17.3 UMTSspecificTables
Figure 14.1onpage 281,Figure 14.2onpage 282,andFigure 14.3onpage 283depicttheUMTSHSPAdatabasestructure.
ucellsTable
uequipmentsTable
ufrequencybandsTable
uhsupauecategoriesTable
umugtablesTable(New)
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
Nullcolumnallowed:
Defaultvalue:
Defaultvalue:150
MultiBandactivation
0=Inactive;1=Active
Defaultvalue:0
Defaultvalue:
Defaultvalue:1
EXCLUDED_CHANNELS
Text
(255)
Defaultvalue:
Defaultvalue:0
CELL_NUMBER Short
increase.
Defaultvalue:0
383
uneighboursTable
uschedulersTable(New)
uterminalsTable
utpltransmittersTable
utransmittersTable
17.3.1.2 DeletedTablesandFields
ucellsTable
HSDPA_MUG_TABLE
utpltransmittersTable
HSDPA_MUG_TABLE
Defaultvalue:
defined.
Defaultvalue:
RELATION_TYPE Short
carrier
Defaultvalue:
Defaultvalue:
Defaultvalue:0
thirdfrequencyband)
Defaultvalue:8
Defaultvalue:
Defaultvalue:
Defaultvalue:
MIMO_SUPPORT Short
loopMIMO
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
384
MC_HSDPA_MUG
MC_HSDPA_SCHED_ALGO
utransmittersTable
MC_HSDPA_MUG
MC_HSDPA_SCHED_ALGO
17.3.2 ucellsTable
Forthetabledescription,see"CDMACellsTable"onpage 287.
17.3.3 uceuseTable
Forthetabledescription,see"CDMAEquipmentsCEsUseTable"onpage 289.
17.3.4 uequipmentsTable
Forthetabledescription,see"CDMAEquipmentsTable"onpage 289.
17.3.5 ufrequencybandsTable
17.3.6 ugneighbours
17.3.7 ugneighconstraints
17.3.8 uhsdpabearersTable
Forthetabledescription,see"HSDPABearersTable"onpage 292.
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
385
17.3.9 uhsdpabearerselectTable
Forthetabledescription,see"HSDPABearerSelectTablesTable"onpage 292.
17.3.10 uhsdpaqualtablesTable
Forthetabledescription,see"HSDPAQualityTablesTable"onpage 292.
17.3.11 uhspamimoconfigsTable
Forthetabledescription,see"HSPAMIMOConfigsTable"onpage 293.
17.3.12 uhsupabearersTable
Forthetabledescription,see"HSUPABearersTable"onpage 293.
17.3.13 uhsupabearerselectTable
Forthetabledescription,see"HSUPABearerSelectionTable"onpage 293.
17.3.14 uhsupaqualtablesTable
Forthetabledescription,see"HSUPAQualityTablesTable"onpage 294.
17.3.15 uhsuparessuseTable
Forthetabledescription,see"CdmaEqptsHSUPARssUseTable"onpage 288.
17.3.16 uhsupauecategoriesTable
Forthetabledescription,see"HSUPAUECategoriesTable"onpage 294.
17.3.17 uinterfreducfactorsTable
Forthetabledescription,see"InterfReductionFactorsTable"onpage 295.
17.3.18 ulneighbours
17.3.19 ulneighconstraints
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:
386
17.3.20 umobilityTable
Forthetabledescription,see"UMTSMobilityTable"onpage 308.
17.3.21 umugtablesTable
Forthetabledescription,see"MUGTablesTable"onpage 295.
17.3.22 uneighboursTable
17.3.23 uneighconstraintsTable
17.3.24 uneighextTable
17.3.25 uneighextconstraintsTable
17.3.26 upscdomainsTable
Forthetabledescription,see"ScramblingCodesDomainsTable"onpage 300.
17.3.27 upscforbidpairsTable
17.3.28 upscgroupsTable
Forthetabledescription,see"ScramblingCodesGroupsTable"onpage 300.
17.3.29 uqualityindicatorsTable
17.3.30 ur99bearersTable
Forthetabledescription,see"R99BearersTable"onpage 298.
17.3.31 urepeatersTable
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
387
17.3.32 uschedulersTable
Forthetabledescription,see"SchedulersTable"onpage 301.
17.3.33 usecondaryantennasTable
17.3.34 uservicequaltablesTable
Forthetabledescription,see"ServiceQualityTablesTable"onpage 301.
17.3.35 uservicesTable
Forthetabledescription,see"UMTSServicesTable"onpage 309.Thetabledoesnotcontainthefollowingfields:
DL_ACTIVITY
REQ_AVERAGE_DL_RATE
REQ_AVERAGE_UL_RATE
UL_ACTIVITY
17.3.36 uservicesqualityTable
Forthetabledescription,see"UMTSServicesQualityTable"onpage 310.
17.3.37 uterminalsTable
Forthetabledescription,see"UMTSTerminalsTable"onpage 311.
17.3.38 utpltransmittersTable
17.3.39 utransmittersTable
17.3.40 utxslistsTable
17.3.41 utxslistsnamesTable
17.3.42 uuecategoriesTable
Forthetabledescription,see"UECategoriesTable"onpage 308.
17.3.43 uuerxequipmentsTable
Forthetabledescription,see"UERxEquipmentsTable"onpage 308.
17.4 LTEspecificTables
Figure 16.1onpage 341,Figure 16.2onpage 342,andFigure 16.3onpage 343depicttheLTEdatabasestructure.
388
lbearersrequiredciTable
lcchdivgainsTable(New)
lcellsTable
lframeconfigsTable
AMS_THRESHOLD Float
throughputgains
Defaultvalue:
Defaultvalue:
EQUIPMENT Text(50)
gainscorrespond
Defaultvalue:
Defaultvalue:1
Defaultvalue:1
MOBILITY Text(50)
correspond
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
ICIC_MODE Short
Defaultvalue:0
Defaultvalue:1
389
lfrequencybandsTable
llayersTable(New)
lmimoconfigsTable
lmugtablesTable
lservicesTable
lterminalsTable
Defaultvalue:
Defaultvalue:2
Defaultvalue:1
Defaultvalue:0
Defaultvalue:300
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:1
Defaultvalue:
Defaultvalue:1
Defaultvalue:0
390
ltpltransmittersTable
ltransmittersTable
luecategoriesTable
17.4.2 lbearerqualitycurvesTable
Forthetabledescription,see"T4GBearerQualityCurvesTable"onpage 358.
17.4.3 lbearersTable
Forthetabledescription,see"T4GBearersTable"onpage 358.
17.4.4 lbearersrequiredciTable
Forthetabledescription,see"T4GBearersRequiredCITable"onpage 358.
17.4.5 lcellsTable
Forthetabledescription,see"T4GCellsTable"onpage 359.
17.4.6 lcchdivgainsTable
Forthetabledescription,see"lcchdivgainsTable"onpage 350.
17.4.7 lequipmentsTable
Forthetabledescription,see"T4GEquipmentsTable"onpage 361.
17.4.8 lframeconfigsTable
Forthetabledescription,see"lframeconfigsTable"onpage 350.
17.4.9 lfrequencybandsTable
Defaultvalue:0
Defaultvalue:1
Defaultvalue:
LAYER_LIST
Text
(255)
Listoflayers
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
391
17.4.10 lgneighboursTable
17.4.11 lgneighconstraintsTable
17.4.12 llayersTable
Forthetabledescription,see"llayersTable"onpage 351.
17.4.13 lmimoconfigsTable
Forthetabledescription,see"T4GMimoConfigsTable"onpage 361.
17.4.14 lmugtablesTable
17.4.15 lneighboursTable
17.4.16 lneighconstraintsTable
17.4.17 lneighextTable
17.4.18 lneighextconstraintsTable
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
392
17.4.19 lpcidomainsTable
Forthetabledescription,see"lpcidomainsTable"onpage 351.
17.4.20 lpcigroupsTable
Forthetabledescription,see"lpcigroupsTable"onpage 351.
17.4.21 lqualityindicatorsTable
17.4.22 lrepeatersTable
17.4.23 lschedulersTable
17.4.24 lsecondaryantennasTable
17.4.25 lservicesTable
Forthetabledescription,see"T4GServicesTable"onpage 362.Thetabledoesnotcontainthefollowingfields:
DL_ACTIVITY
REQ_AVERAGE_DL_RATE
REQ_AVERAGE_UL_RATE
UL_ACTIVITY
17.4.26 lsmartantennasTable
Forthetabledescription,see"SmartAntennasTable"onpage 357.
17.4.27 lterminalsTable
Forthetabledescription,see"T4GTerminalsTable"onpage 364.
17.4.28 ltpltransmittersTable
17.4.29 ltransmittersTable
17.4.30 ltxslistsTable
17.4.31 ltxslistsnamesTable
17.4.32 luecategoriesTable
Forthetabledescription,see"T4GUECategoriesTable"onpage 364.
393
17.4.33 luneighboursTable
17.4.34 luneighconstraintsTable
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
394
AT320_AM_E2 Chapter18:3GPP2MultiRATDataStructure
395
18 3GPP2MultiRATDataStructure
3GPP2MultiRATAtoll documents can containone orboth3GPP2 technologies:CDMA2000and LTE.Tablesin the 3GPP2
MultiRATtemplateincludethefollowingcategoriesoftables:
"TablesCommontoAllTechnologies"onpage 395
These tables are shared and used by all the technologies. There structures (fields, keys, and relations with other
tables)aresimilartothestructuresofthesetablesinsingletechnologydocuments.
The multiRAT traffic model allows you to define services, terminals, and mobility types, user profiles, and traffic
environmentsforallthreetechnologies.Thesetableshaveamultileveldefinition:atechnologyindependentlevel
andatechnologyspecificlevel.
"CDMA2000specificTables"onpage 400
"LTEspecificTables"onpage 403
Thesetablesarespecifictotechnologies.Therestructuresarethesameasinsingletechnologydocuments.
18.1 TablesCommontoAllTechnologies
18.1.1 antennasTable
Forthetabledescription,see"AntennasTable"onpage 346.
18.1.2 btsequipmentsTable
Forthetabledescription,see"BTSEquipmentsTable"onpage 347.
18.1.3 coordsysTable
Forthetabledescription,see"CoordSysTable"onpage 347.
18.1.4 customfieldsTable
Forthetabledescription,see"CustomFieldsTable"onpage 348.
18.1.5 environmentdefsTable
Forthetabledescription,see"T4GEnvironmentDefsTable"onpage 361.
18.1.6 feederequipmentsTable
Forthetabledescription,see"FeederEquipmentsTable"onpage 349.
18.1.7 internetchprotectTable
Forthetabledescription,see"InterNetChProtectTable"onpage 349.Thistablecontainsthefollowingadditionalfieldinthe
3GPP2multiRATtemplate:
18.1.8 mobilityTable
Figure 18.1onpage 396,showsthemultileveldefinitionofthemultiRATmobilitytypesmodeltables.
V_TECHNO Text(50) Victimtechnology
Defaultvalue:
396
Chapter18:3GPP2MultiRATDataStructure Forsk2013
18.1.9 networksTable
Thenetworkstablecontainsonerecordforeachtechnologyinthedocument.Ineachrecord,onlyparametersrelevantfor
therowstechnologyareused.
Figure 18.1:3GPP2MobilityTypesModel
Defaultvalue:
MEAN_SPEED Float Averagespeed(km/h)
Defaultvalue:
Defaultvalue:False
AMScriterion
Defaultvalue:0
Defaultvalue:0
(0=MinDLLoad,1=MinULLoad,2=Random,3=Sequential)
Defaultvalue:2
DEFAULT_CP Short
Defaultcyclicprefix
Defaultvalue:0
Defaultvalue:0
Defaultvalue:"Cost
Hata"
Defaultvalue:50
Defaultvalue:1
Defaultvalue:130
Defaultvalue:True
Defaultvalue:1
Defaultvalue:0
Defaultvalue:
Defaultvalue:False
397
18.1.10 propagationmodelsTable
Forthetabledescription,see"PropagationModelsTable"onpage 354.
18.1.11 receiversTable
18.1.12 repeaterequipmentsTable
Forthetabledescription,see"RepeaterEquipmentsTable"onpage 355.
18.1.13 servicesTable
Figure 18.2onpage 398,showsthemultileveldefinitionofthemultiRATservicesmodeltables.
Defaultvalue:1
Defaultvalue:1
T
Boolean
Defaultvalue:False
power(%)
Defaultvalue:False
Defaultvalue:2
Defaultvalue:0
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:3.84
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:121
UL_PWC_ON_PILOT Boolean Trueifuplinkpowercontrolisbasedonpilotstarget
Defaultvalue:False
Defaultvalue:18
Defaultvalue:
Defaultvalue:1.5
Defaultvalue:0
Defaultvalue:
398
18.1.14 servicesusageTable
Forthetabledescription,see"T4GServicesUsageTable"onpage 363.
18.1.15 sitesTable
Figure 18.2:3GPP2ServicesModel
Defaultvalue:1
Defaultvalue:
Defaultvalue:
Defaultvalue:
TECHNO_PRIORITY Text(50) Listofsupportedtechnologiesintheorderofpriority
Defaultvalue:
Defaultvalue:1
ALTITUDE Float
Realaltitude
Unit:m
Defaultvalue:
Defaultvalue:
Defaultvalue:256
Defaultvalue:256
399
18.1.16 siteslistsTable
Forthetabledescription,see"SitesListsTable"onpage 357.
18.1.17 siteslistsnamesTable
Forthetabledescription,see"SitesListsNamesTable"onpage 357.
18.1.18 smartantennasmodelsTable
Forthetabledescription,see"SmartAntennasModelsTable"onpage 358.
18.1.19 terminalsTable
Figure 18.3onpage 400,showsthemultileveldefinitionofthemultiRATterminalsmodeltables.
COMMENT_
Text
(255)
Defaultvalue:
EVDO_CES Integer NumberofEVDOCEspercarrier
Defaultvalue:96
Defaultvalue:0
Defaultvalue:0
Defaultvalue:950000
Defaultvalue:950000
Defaultvalue:
Defaultvalue:50
Defaultvalue:
400
18.1.20 tmaequipmentsTable
Forthetabledescription,see"TMAEquipmentsTable"onpage 365.
18.1.21 trafficenvsTable
Forthetabledescription,see"T4GTraficEnvironmentsTable"onpage 364.
18.1.22 unitsTable
Forthetabledescription,see"UnitsTable"onpage 370.
18.1.23 userprofilesTable
Forthetabledescription,see"T4GUserProfilesTable"onpage 365.
18.2 CDMA2000specificTables
Figure 15.1onpage 313,Figure 15.2onpage 314,andFigure 15.3onpage 315depicttheCDMA2000databasestructure.
18.2.1 ccarrierstypeTable
Forthetabledescription,see"CarriersTypeTable"onpage 318.
Figure 18.3:3GPP2TerminalsModel
NAME Text(50) Nameofterminal
Defaultvalue:
401
18.2.2 ccellsTable
Forthetabledescription,see"CDMACellsTable"onpage 318.
18.2.3 cceuseTable
Forthetabledescription,see"CDMAEquipmentsCEsUseTable"onpage 320.
18.2.4 cdlbearerselectTable
Forthetabledescription,see"DLBearersSelectionTable"onpage 322.
18.2.5 cdldorabearersTable
Forthetabledescription,see"DLDORABearersTable"onpage 322.
18.2.6 cdorabearersTable
Forthetabledescription,see"DORABearersTable"onpage 322.
18.2.7 cdorabearersprobaTable
Forthetabledescription,see"DORABearersProbaTable"onpage 322.
18.2.8 cdoratermt2pratiosTable
Forthetabledescription,see"DORATerminalT2PRatiosTable"onpage 323.
18.2.9 cequipmentsTable
Forthetabledescription,see"CDMAEquipmentsTable"onpage 319.
18.2.10 cfrequencybandsTable
18.2.11 cinterfreducfactorsTable
Forthetabledescription,see"InterfReductionFactorsTable"onpage 324.
18.2.12 clneighboursTable
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
402
18.2.13 clneighconstraintsTable
18.2.14 cmobilityTable
Forthetabledescription,see"UMTSMobilityTable"onpage 336.
18.2.15 cneighboursTable
18.2.16 cneighconstraintsTable
18.2.17 cneighextTable
18.2.18 cneighextconstraintsTable
18.2.19 cpnodomainsTable
Forthetabledescription,see"PnCodesDomainsTable"onpage 326.
18.2.20 cpnoforbidpairsTable
18.2.21 cpnogroupsTable
Forthetabledescription,see"PnCodesGroupsTable"onpage 326.
18.2.22 cqualityindicatorsTable
18.2.23 crepeatersTable
18.2.24 csecondaryantennasTable
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
403
18.2.25 cservicequaltablesTable
Forthetabledescription,see"ServiceQualityTablesTable"onpage 329.
18.2.26 cservicesTable
Forthetabledescription,see"UMTSServicesTable"onpage 336.
18.2.27 cservicesqualityTable
Forthetabledescription,see"UMTSServicesQualityTable"onpage 338.
18.2.28 cterminalsTable
Forthetabledescription,see"UMTSTerminalsTable"onpage 338.
18.2.29 ctpltransmittersTable
18.2.30 ctransmittersTable
18.2.31 ctxslistsTable
18.2.32 ctxslistsnamesTable
18.2.33 cuerxequipmentsTable
Forthetabledescription,see"UERxEquipmentsTable"onpage 335.
18.2.34 culbearerselectTable
Forthetabledescription,see"ULBearersSelectionTable"onpage 335.
18.3 LTEspecificTables
Figure 16.1onpage 341,Figure 16.2onpage 342,andFigure 16.3onpage 343depicttheLTEdatabasestructure.
18.3.1 lbearerqualitycurvesTable
Forthetabledescription,see"T4GBearerQualityCurvesTable"onpage 358.
18.3.2 lbearersTable
Forthetabledescription,see"T4GBearersTable"onpage 358.
18.3.3 lbearersrequiredciTable
Forthetabledescription,see"T4GBearersRequiredCITable"onpage 358.
404
18.3.4 lcellsTable
Forthetabledescription,see"T4GCellsTable"onpage 359.
18.3.5 lcchdivgainsTable
Forthetabledescription,see"lcchdivgainsTable"onpage 350.
18.3.6 lcneighboursTable
18.3.7 lcneighconstraintsTable
18.3.8 lequipmentsTable
Forthetabledescription,see"T4GEquipmentsTable"onpage 361.
18.3.9 lframeconfigsTable
Forthetabledescription,see"lframeconfigsTable"onpage 350.
18.3.10 lfrequencybandsTable
18.3.11 llayersTable
Forthetabledescription,see"llayersTable"onpage 351.
18.3.12 lmimoconfigsTable
Forthetabledescription,see"T4GMimoConfigsTable"onpage 361.
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
405
18.3.13 lmugtablesTable
18.3.14 lneighboursTable
18.3.15 lneighconstraintsTable
18.3.16 lneighextTable
18.3.17 lneighextconstraintsTable
18.3.18 lpcidomainsTable
Forthetabledescription,see"lpcidomainsTable"onpage 351.
18.3.19 lpcigroupsTable
Forthetabledescription,see"lpcigroupsTable"onpage 351.
18.3.20 lqualityindicatorsTable
18.3.21 lrepeatersTable
18.3.22 lschedulersTable
18.3.23 lsecondaryantennasTable
18.3.24 lservicesTable
Forthetabledescription,see"T4GServicesTable"onpage 362.Thetabledoesnotcontainthefollowingfields:
DL_ACTIVITY
REQ_AVERAGE_DL_RATE
REQ_AVERAGE_UL_RATE
UL_ACTIVITY
18.3.25 lsmartantennasTable
Forthetabledescription,see"SmartAntennasTable"onpage 357.
18.3.26 lterminalsTable
Forthetabledescription,see"T4GTerminalsTable"onpage 364.
406
18.3.27 ltpltransmittersTable
18.3.28 ltransmittersTable
18.3.29 ltxslistsTable
18.3.30 ltxslistsnamesTable
18.3.31 luecategoriesTable
Forthetabledescription,see"T4GUECategoriesTable"onpage 364.
AT320_AM_E2 Chapter19:TDSCDMADataStructure
407
19 TDSCDMADataStructure
Figure 19.1onpage 407,Figure 19.2onpage 408,andFigure 19.3onpage 409depicttheTDSCDMAdatabasestructure.The
followingsubsectionslistthetablesintheTDSCDMAtemplatedatastructure.
Figure 19.1:TDSCDMATemplate1
408
Chapter19:TDSCDMADataStructure Forsk2013
409
410
AntennasTable
CdmaCellsTable
CustomFieldsTable
SitesTable
TransmittersTable
SitesTable
SUPPORT_NATURE
19.2 AntennasTable
Forantennas.
Defaultvalue:
Defaultvalue:150
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
COMMENT_
Text
(255)
Defaultvalue:
411
19.3 AntennasListsTable
Forantennasbelongingtoantennalists.
19.4 AntennasListsNamesTable
Fornamesofantennalists.
ForNodeBequipment.
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
FMax Double
Unit:MHz
Defaultvalue:
FMin Double
Unit:MHz
Defaultvalue:
GAIN Float
Unit:dBi
Defaultvalue:0
Defaultvalue:
Defaultvalue:
onpage 113.
ANTENNA_NAME Text(50) Firstpartoftheuniquekey.Nameofthelist.
Defaultvalue:
LIST_NAME Text(50) Secondpartoftheuniquekey.Nameoftheantenna.
Defaultvalue:
Defaultvalue:
combiner)
Defaultvalue:0
combiner)
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
412
19.6 CDMACellsTable
Forcells.
Defaultvalue:100
ACTIVE Boolean Cell'sactivity:'Yes'meansthatthecellisactive
Defaultvalue:True
Defaultvalue:0
CARRIER_TYPE Short Carriertype:0=None;1=Master;2=Slave;
Defaultvalue:0
Defaultvalue:
Defaultvalue:
COMMENT_
Text
(255)
Defaultvalue:
E_RISE
Defaultvalue:0
DWPCH_POWER Float PowerontheDwPTStimeslot
Defaultvalue:36
DYN_EDCH_DL_POWER_ALL
OC
Boolean
AllocationofpowerforHSUPADLpower(EAGCH,EHICH):
True=Dynamic;False=Static;
Defaultvalue:False
OC
Boolean AllocationofpowerforHS_SCCH(True=Dynamic,False=Static)
Defaultvalue:True
DYN_HS_SICH_POWER_ALLO
C
Boolean AllocationofpowerforHSSICH(True=Dynamic,False=Static)
Defaultvalue:True
Defaultvalue:True
EDCH_DL_POWER Float
ValueofpowerdedicatedtoEAGCHandEHICHchannelpertimeslot.
Incaseofdynamicallocation,itisthemaximumavailablepower.
Defaultvalue:
HS_SCCH_POWER Float
Defaultvalue:
Defaultvalue:16
Defaultvalue:64
Defaultvalue:0
Defaultvalue:
HSDPA_SCHEDULER_ALGO Short
SchedulingalgousedforHSDPAusers.0=MAXC/I,1=RoundRobin,2 =
ProportionalFair.
Defaultvalue:2
Defaultvalue:0
HSUPA_MAX_USERS Integer MaxnumberofHSUPAusersmanagedsimultaneouslybythescheduler
Defaultvalue:15
LOCKED_SC Boolean FieldusedtofreezeallocatedSCofthecellduringautomaticallocation
Defaultvalue:False
Defaultvalue:
413
19.7 CDMACellsTSTable
Fortimeslots.
Defaultvalue:
Defaultvalue:1000
Defaultvalue:1000
NUM_HS_SCCH Short NumberofHSSCCHchannels
Defaultvalue:5
NUM_HS_SICH Short NumberofHSSICHchannelspercell
Defaultvalue:5
NUM_HSDPA_USERS Integer
NumberofservedHSDPAusersinthecell:calculatedbytheTDSCDMA
simulationalgorithm
Defaultvalue:
NUM_HSUPA_USERS Integer
NumberofservedHSUPAusersinthecell:calculatedbytheTDSCDMA
simulationalgorithm
Defaultvalue:
OTHERS_CCH_POWER Float PowerontheothercommonchannelsforTS0(SCCPCH,FPACH,PICH)
Defaultvalue:0
Defaultvalue:33
Defaultvalue:43
PWR_HEADROOM Float
algorithm)
Defaultvalue:0
REQ_DL_RUS Short Requiredresourceunitsindownlink
Defaultvalue:0
REQ_UL_RUS Short Requiredresourceunitsinuplink
Defaultvalue:0
Defaultvalue:
RSCP_COMP Float PCCPCHRSCPmargintotriggerBatonHandover
Defaultvalue:5
Defaultvalue:150
SC_DOMAIN_NAME Text(50) Scramblingcodedomainname.
Defaultvalue:
SCRAMBLING_CODE Integer Scramblingcode.
Defaultvalue:
TS_CONFIG Integer
Timeslotconfiguration
(1DUDDDDD;2DUUDDDD;3DUUUDDD;4DUUUUDD;5DUUUUUD;
6DUUUUUU;)
Defaultvalue:3
Defaultvalue:
ISE
Defaultvalue:0
BLOCKED Boolean Allowtoblockthetimeslot:'Yes'meansthatthetimeslotisblocked
Defaultvalue:False
Defaultvalue:
DL_ANGULAR_POWERS Binary Angulardistributionofdownlinktransmittedpower
Defaultvalue:
414
Forsiteequipment.
Defaultvalue:
HSDPA_MIN_CODES Short MinimumnumberofHSPDSCHcodes
Defaultvalue:
Defaultvalue:
HSUPA_UL_LOAD Float UplinkloadfactorduetoHSUPAusers
Defaultvalue:
MAX_DL_LOAD Float
Maximumdownlinkloadallowed(percentageofmaxpowerused).
Usedinpowercontrolsimulation
Defaultvalue:75
MAX_UL_LOAD Float
simulation
Defaultvalue:50
OTHERS_CCH_POWER Float Powerontheothercommonchannels
Defaultvalue:200
RU_OVERHEAD Short Overheadduetosignallingchannels
Defaultvalue:0
TIME_SLOT Short Timeslotnumber
Defaultvalue:
TIME_SLOT_TYPE Short Typeoftimeslot(0=R99,1=HSDPA,2=R99+HSDPA)
Defaultvalue:0
TOTAL_POWER Float
Defaultvalue:
UL_LOAD Float
Uplinkcellrloadfactor:manuallyspecifiedbytheuserorcalculatedby
Defaultvalue:
Uplink(Iintra+Iextra)/Iintra:calculatedbytheTDSCDMAsimulation
algorithm
Defaultvalue:
Defaultvalue:
MCJD_FACTOR Float
MulticelljointdetectionfactorforextracellULinterference
cancellation
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
CHANNEL_ELTS_DL Integer Numberofchannelelementsusedfordownlink
Defaultvalue:1
CHANNEL_ELTS_UL Integer Numberofchannelelementsusedforuplink
Defaultvalue:1
Defaultvalue:
SERVICE Text(50) Secondpartoftheuniquekey.Servicename.
Defaultvalue:
415
19.10 CodesRelativityClustersTable
Forscramblingcodeclusters.
19.11 CoordSysTable
CODES_LIST
Text
(255)
Comaseparatedlistofcodesbelongingtothecluster
Defaultvalue:
NAME Text(50) Nameoftheclusterofscramblingcodes
Defaultvalue:
CODE Integer
Defaultvalue:0
DATUM_CODE Double
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
ELLIPS_CODE Integer
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
416
Forfeeders.
PROJ_METHOD Short
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
417
Forfrequencybands.
19.15 HSDPABearersTable
ForHSDPAbearers.
19.16 HSDPABearerSelectTablesTable
ForHSDPAbearerselectiongraphs.
19.17 HSUPABearers
ForHSUPAbearers.
Defaultvalue:1.6
Defaultvalue:0
FREQUENCY Double
Unit:MHz
Defaultvalue:2010
Defaultvalue:0
Defaultvalue:
Defaultvalue:1.28
BEARER_INDEX Short Uniquekeytoaddressbearer
Defaultvalue:1
HSPDSCH_NUM Short NumberofHS_PDSCHchannelsused
Defaultvalue:5
MODULATION Short Modulation:0=QPSK;1=16QAM;
Defaultvalue:0
RLC_PEAK_THROUGHPUT Float PeakRLCthroughput(withoutBLERconsideration)
Defaultvalue:0
Defaultvalue:0
TS_NUM Short Numberoftimeslotsusedpersubframe
Defaultvalue:1
UE_CATEGORY Short AssociatedUEcategory[115]
Defaultvalue:1
Defaultvalue:0
HSPDSCH_ECNT_REQ Float RequriedHSPDSCHEc/Nt
Defaultvalue:5
Defaultvalue:
418
19.18 HSUPABearerSelection
ForHSUPAbearerselectiongraphs.
19.19 HSUPAUECategories
ForHSUPAUEcategories.
BEARER_INDEX Short Indexofthebearer
Defaultvalue:
EPUCH_NUM Short NumberofEPUCHcodesused
Defaultvalue:
MODULATION Short Modulation:0=QPSK;1=16QAM;
Defaultvalue:0
RLC_PEAK_THROUGHPUT Float PeakRLCthroughput(withoutBLER)
Defaultvalue:
Defaultvalue:
TS_NUM Short Numberoftimeslotsusedpersubframe
Defaultvalue:1
UE_CATEGORY Short AssociatedUEcategory
Defaultvalue:1
BEARER_INDEX Short Indexoftheselectedbearer
Defaultvalue:0
EARLY_TERM_TABLE Memo Tablesofprobabilitiesofearliertermination=f(REPEAT_NUM)
Defaultvalue:
EPUCH_ECNT_REQ Float RequiredEPUCHEc/Nt
Defaultvalue:
MAX_NUM_REP Integer Numberofretransmissionstoensureacorrecttransmission
Defaultvalue:1
Defaultvalue:
Defaultvalue:
UL_CRT_MARGIN Float UplinkcontrolmarginforEPUCH
Defaultvalue:
MAX_BLOCK_SIZE Integer MaximumtransportblocksizesupportedforTTI=10ms(bits)
Defaultvalue:
MAX_EPUCH_CODES Short MaximumnumberofEDPDCHcodesforHSUPA
Defaultvalue:
MAX_EPUCH_TS Integer SmallestSpreadingFactorsupported
Defaultvalue:
Defaultvalue:0
UE_CATEGORY Short UEcategoryforHSUPA
Defaultvalue:
UE_CATEGORY_NAME Text(50) NameoftheHSUPAUEcategory
Defaultvalue:
419
Defaultvalue:0
Defaultvalue:0
Defaultvalue:200
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
A
FORCE_HHO Boolean
neighbours
Defaultvalue:False
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
FORCE_HHO Boolean
neighbours
Defaultvalue:False
Defaultvalue:
Defaultvalue:
420
19.26 NetworksTable
STATUS Integer
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
STATUS Integer
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
Defaultvalue:50
Defaultvalue:1
DWPTS_CHIPS_NUMBER Integer DwPTS(TSdedicatedtothepilot)
Defaultvalue:96
EBNT_QUALITY_TARGET Boolean Typeofqualitytarget.True=Eb/Nt,False=C/I
Defaultvalue:True
FRAME_TIME Short Durationofaframeinms
Defaultvalue:10
421
GUARD_PERIOD_CHIPS_NU
MBER
Float Numberofchipsinguardperiod
Defaultvalue:16
HSDPAonly:Ntincludesornotpilot'ssignalforHSSCCH,HSPDSCHand
CPICHforCQIdetermination
Defaultvalue:False
Defaultvalue:130
MIDAMBLE_CHIPS_NUMBER Float Numberofchipsinmidamble
Defaultvalue:144
NAME Text(50)
Defaultvalue:
Defaultvalue:False
PILOT_PROCESSING_GAIN Float PCCPCHProcessingGain
Defaultvalue:13.8
T
Boolean
CellPagingandSynchropowers,ServiceAllowedDLminandmaxTCH
powersareabsolutevalues(False)orrelativetocellpilotpower(True)
Defaultvalue:
PTS_GUARD_PERIOD_CHIPS_
NUMBER
Integer NumberofchipsinthePTSguardperiod
Defaultvalue:96
Text
(255)
Defaultvalue:
SPREADING_FACTOR_MAX Integer Maximumspreadingfactor
Defaultvalue:16
SPREADING_FACTOR_MIN Integer Minimumspreadingfactor
Defaultvalue:1
Defaultvalue:1.28
SUBFRAME_TIME Short Durationofasubframeinms
Defaultvalue:5
Defaultvalue:TD
SCDMA
Defaultvalue:CDMA
TS_DATA_CHIPS_NUMBER Float NumberofdatachipsinaTS
Defaultvalue:704
TS_NUMBER Integer NumberofTSinasubframe
Defaultvalue:7
UPPTS_CHIPS_NUMBER Integer UpPTS(TSdedicatedtothepilot)
Defaultvalue:160
Defaultvalue:
Description
Text
(255)
Userdefined
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
422
19.29 R99BearersTable
Forrelease99bearers.
Defaultvalue:True
MEAS_PARAM Short
5=HSPDSCH_ECNT;
Defaultvalue:1
Defaultvalue:
Defaultvalue:True
Defaultvalue:True
DL_NOMINAL_BIT_RATE Float
Bearernominaldatarateonthedownlink
Unit:kbps
Defaultvalue:9.6
DL_PG Float Downlinkprocessinggain
Defaultvalue:0
NAME Text(50) R99bearername
Defaultvalue:
PTCH_MAX Float MaximumDLtransmitterpowerontrafficchannelforthebearer
Defaultvalue:21
PTCH_MIN Float MinimumDLtransmitterpowerontrafficchannelforthebearer
Defaultvalue:20
TS_DL Short NumberofTSusedforDL
Defaultvalue:1
TS_UL Short NumberofTSusedforUL
Defaultvalue:1
TYPE Short
Bearertype(0:Empty,1:Interactive,2:Conversational,3:Background
,4:Streaming)
Defaultvalue:0
UL_NOMINAL_BIT_RATE Float
Bearernominaldatarateontheuplink
Unit:kbps
Defaultvalue:9.6
UL_PG Float Uplinkprocessinggain
Defaultvalue:0
Defaultvalue:18
Defaultvalue:
Defaultvalue:1.5
Defaultvalue:0
423
Forrepeaters.
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
Defaultvalue:
Defaultvalue:90
Defaultvalue:30
Defaultvalue:12
Defaultvalue:50
Defaultvalue:
Defaultvalue:5
Defaultvalue:1
Defaultvalue:5
Defaultvalue:80
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:1
donorandrepeater
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
424
19.33 SACIGainCDFTable
ForCDFgraphsofsmartantennaC/Igains.
19.34 ScramblingCodesDomainsTable
Fornamesofscramblingcodedomains.
19.35 ScramblingCodesGroupsTable
Forscramblingcodegroupsbelongingtoscramblingcodedomains.
Defaultvalue:25
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
ANGULAR_SPREAD Short ValueoftheaverageangularspreadindB
Defaultvalue:5
CIGAIN_CDF Memo CDFofC/Igainvalues(listofpairs:C/I,cumulatedprobability)
Defaultvalue:
SA_NAME Text(50) NameoftheSmartantenna
Defaultvalue:
Defaultvalue:
DOMAIN_NAME Text(50)
Secondpartoftheuniquekey.Calledgroupingscheme.Setof
scramblingcodegroups.
Defaultvalue:
EXCLUDED
Text
(225)
Defaultvalue:
EXTRA
Text
(225)
Defaultvalue:
FIRST Integer
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
425
Forscramblingcodeallocationconstraints.
Forrelease99performancegraphs.
19.39 ServiceRUsUseTable
Forresourceunitconsumptionsperservice.
NAME Text(50) Firstpartoftheuniquekey.Nameofthescramblingcodegroup
Defaultvalue:
STEP Integer
LAST.
Defaultvalue:1
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
REDT Float Additionalelectricaldowntilt
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
relation
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
426
19.40 SitesTable
Forsites.
DIRECTION Short
Uplinkordownlink
Choicelist:1=DL;2=UL;
Defaultvalue:1
NB_SF1 Short NumberofSF1codesallocatedforDL
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
SERVICE Text(50) Servicename
Defaultvalue:
TS_RANK Short RankforTSallocationinMonteCarlosimulations
Defaultvalue:1
ALTITUDE Float
Realaltitude
Unit:m
Defaultvalue:
Defaultvalue:
COMMENT_
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:50
Defaultvalue:
Defaultvalue:
Defaultvalue:
427
Defaultvalue:
ADAPTIVE_PATTERN_DL Text(50) Downlinkpatternusedtomodelanadaptativesmartantenna
Defaultvalue:
ADAPTIVE_PATTERN_UL Text(50) Uplinkpatternusedtomodelanadaptativesmartantenna
Defaultvalue:
COMMENT_
Text
(255)
AlgorithmusedtotheC/Igaincurves
Defaultvalue:
ELTS_NUMBER Integer Numberofelements
Defaultvalue:4
GEOMETRY_TYPE Integer Geometry1ULA2UCA
Defaultvalue:1
GOB_PATTERN Text(50) Downlinkgridofbeamsname
Defaultvalue:
GOB_PATTERN_UL Text(50) Uplinkgridofbeamsname
Defaultvalue:
INTER_ELTS_DIST Integer Distancebetweenelementsin%ofthewavelength
Defaultvalue:50
MODELLING_TYPE Short
ModellingType:0DedicatedModel,1IdealBeamSteering,2GridOf
Beams,3Statistical
Defaultvalue:0
Defaultvalue:
PROBA_THRESHOLD Integer ProbabilityofhavingmorethanusedC/Igain
Defaultvalue:50
SA_MODEL Text(50) ExternalModelusedtomodelthesmartantenna
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
428
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
ANTDIVGAIN Float
Unit:dB
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
CALC_RADIUS Integer
Unit:m
Defaultvalue:
Unit:m
Defaultvalue:
Defaultvalue:
Defaultvalue:
CARRIERS Text(50) Carriersusedbythetransmitter
Defaultvalue:
Defaultvalue:
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
E_RISE
Defaultvalue:
DWPCH_POWER Float PowerontheDwPTStimeslot
Defaultvalue:
DYN_EDCH_DL_POWER_ALL
OC
Boolean
AllocationofpowerforHSUPADLpower(EAGCH,EHICH):
True=Dynamic;False=Static;
Defaultvalue:
OC
Boolean AllocationofpowerforHS_SCCH(True=Dynamic,False=Static)
Defaultvalue:
DYN_HS_SICH_POWER_ALLO
C
Boolean AllocationofpowerforHSSICH(True=Dynamic,False=Static)
Defaultvalue:
Defaultvalue:
EDCH_DL_POWER Float
ValueofpowerdedicatedtoEAGCHandEHICHchannelpertimeslot.
Incaseofdynamicallocation,itisthemaximumavailablepower.
Defaultvalue:
429
Defaultvalue:
Defaultvalue:
Unit:m
Defaultvalue:
Unit:m
Defaultvalue:
HEIGHT Float
Unit:m
Defaultvalue:
HS_SCCH_POWER Float
ValueofpowerdedicatedtoaHS_SCCHchannel.Incaseofdynamic
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
HSDPA_SCHEDULER_ALGO Short
SchedulingalgousedforHSDPAusers.0=MAXC/I(MAxC/I),1=RR
(RoundRobin),2=PF(ProportionalFair)
Defaultvalue:
Defaultvalue:
HSUPA_MAX_USERS Integer MaxnumberofHSUPAusersmanagedsimultaneouslybythescheduler
Defaultvalue:
transmitter
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
N_FREQUENCY Boolean
Nfrequencymode.'Yes'meansthatthetransmitterhasonemaster
carrierandslavescarriers;otherwiseallitscarriersarestandalone
Defaultvalue:
Defaultvalue:
Defaultvalue:
NUM_HS_SCCH Short NumberofHS_SCCHchannels
Defaultvalue:
NUM_HS_SICH Short NumberofHSSICHchannelspercell
Defaultvalue:
NUM_HSDPA_USERS Integer
NumberofservedHSDPAusersinthecell:calculatedbytheTDSCDMA
simulationalgorithm
Defaultvalue:
430
NUM_HSUPA_USERS Integer
NumberofservedHSUPAusersinthecell:calculatedbytheTDSCDMA
simulationalgorithm
Defaultvalue:
Defaultvalue:
Defaultvalue:3
Defaultvalue:
OTHERS_CCH_POWER Float Powerofcommonchannels(exceptSCH)
Defaultvalue:
Defaultvalue:
Defaultvalue:
PROPAG_MODEL
Text
(255)
Defaultvalue:
PROPAG_MODEL2
Text
(255)
Defaultvalue:
PWR_HEADROOM Float
algorithm)
Defaultvalue:
Defaultvalue:
REQ_DL_RUS Integer Requiredresourceunitsindownlink
Defaultvalue:
REQ_UL_RUS Integer Requiredresourceunitsinuplink
Defaultvalue:
Defaultvalue:
Defaultvalue:
RXLOSSES Float
Unit:dB
Defaultvalue:
SA_NAME Text(50)
Nameoftheassociatedsmartantenna(ifempty,thestandardantenna
isused)
Defaultvalue:
SC_DOMAIN_NAME Text(50) Scramblingcodedomainname
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
TS_CONFIG Float
Timeslotconfiguration(1DUDDDDD2DUUDDDD3DUUUDDD4
DUUUUDD5DUUUUUD6DUUUUUU)
Defaultvalue:
TX_DIVERSITY_CFG Integer
TXdiversityconfiguration
0=NoTXdiversity;1=TXdiv.openloop;2=TXdiv.closedloop
Defaultvalue:
TXLOSSES Float
Unit:dB
Defaultvalue:
ISE
Defaultvalue:
431
Fortransmitters.
Defaultvalue:True
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:
CALC_RADIUS Integer
Unit:m
Defaultvalue:4000
Defaultvalue:
Defaultvalue:50
Defaultvalue:
CELL_SIZE Float
Hexagonradius
Unit:m
Defaultvalue:2000
COMMENT_
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
HEIGHT Float
Unit:m
Defaultvalue:25
Defaultvalue:
Defaultvalue:35000
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
N_FREQUENCY Boolean
Nfrequencymode.'Yes'meansthatthetransmitterhasonemaster
carrierandslavescarriers;otherwiseallitscarriersarestandalone
Defaultvalue:False
Defaultvalue:5
432
19.48 TxsListsTable
19.50 UECategoriesTable
ForHSDPAUEcategories.
Defaultvalue:1
Defaultvalue:1
PROPAG_MODEL
Text
(255)
model
PROPAG_MODEL2
Text
(255)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
SA_NAME Text(50)
Nameoftheassociatedsmartantenna(ifempty,thestandardantenna
isused)
Defaultvalue:
Defaultvalue:
SITE_NAME Text(50)
table)
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
TX_DIVERSITY_CFG Short
TXdiversityconfiguration.1=NoTXdiversity2=TXdiv.openloop3=
TXdiv.closedloop
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
433
ForUEreceptionequipment.
Formobilitytypes.
MAX_BLOCK_SIZE Integer Maximumtransportblocksizesupported(bits)
Defaultvalue:26000
MAX_HSPDSCH_NUM Short MaximumnumberofHSPDSCHchannelsforHSDPA
Defaultvalue:5
MAX_HSPDSCH_TS Short MaximumnumberofHSPDSCHtimeslotsperTTI
Defaultvalue:2
Defaultvalue:0
UE_CATEGORY Short UEcategoryforHSDPA
Defaultvalue:
UE_CATEGORY_NAME Text(50) NameoftheHSDPAUEcategory
Defaultvalue:
Defaultvalue:
DENSITY Float
2
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
DWPCH_QUALITY Float QualitytargetfortheDwPCH(dB)
Defaultvalue:2
DWPCH_RSCP Float MinimumDwPCHRSCP(dBm)
Defaultvalue:100
EDCH_DL_ECNT Float EDCHEc/NttargetforHSUPADLpower(EAGCH,EHICH)
Defaultvalue:12
HSSCCH_ECNT Float HSSCCHEc/NttargetforHSDPA
Defaultvalue:12
HSSICH_ECNT Float HSSICHuplinkEc/NttargetforHSDPA
Defaultvalue:12
Defaultvalue:0
Defaultvalue:
434
Forservices.
RSCP_DROP Float PCCPCHRSCPforcelldropping(BatonHandover)
Defaultvalue:95
RSCP_MIN Short MinimumPCCPCHRSCPforcellselection(dBm)
Defaultvalue:84
Defaultvalue:7
UPPCH_RSCP Float MinimumUpPCHRSCP(dBm)
Defaultvalue:100
ADPCH_ACTIVITY Float ActivityFactorforHSDPAusers
Defaultvalue:0.1
Defaultvalue:0
CARRIER_LIST Text(50) Listofpreferredcarriernumbers
Defaultvalue:
CARRIER_SUPPORT Integer Carriersupporttype:0=Prefered;1=Allowed;
Defaultvalue:0
DL_ACTIVITY Float Activityfactorforcircuitswitchedserviceonthedownlink
Defaultvalue:1
DL_DP Float Packetinterarrivaltime(ms)onthedownlink
Defaultvalue:0
DL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)onthedownlink
Defaultvalue:0
DL_NPC Integer Numberofpacketcallsduringasessiononthedownlink
Defaultvalue:1
DL_PACKET_EFFICIENCY Float Packetefficiencyfactoronthedownlink
Defaultvalue:
DL_SP Integer Packetsize(Bytes)onthedownlink
Defaultvalue:1500
DL_SPC_MAX Float DownlinkmaxPacketcallsize(kBytes)
Defaultvalue:2000
DL_SPC_MIN Float DownlinkminPacketcallsize(kBytes)
Defaultvalue:4
EDPCH_ACTIVITY Float ActivityFactorforHSUPAusers
Defaultvalue:0.1
Defaultvalue:
Defaultvalue:0
R99BEARER Text(50) NameoftheR99Bearer
Defaultvalue:
Defaultvalue:
Defaultvalue:
REQ_MIN_DL_RATE Float RequestedMinimumDownlinkRate(kbps)
Defaultvalue:0
REQ_MIN_UL_RATE Float RequestedMinimumUplinkRate(kbps)
Defaultvalue:0
435
Forrelease99serviceaccessthresholds.
Defaultvalue:0
Defaultvalue:95
TYPE Short Typeofservice(0:circuit;1:packet;2:circuitoverpacket)
Defaultvalue:0
UL_ACTIVITY Float Activityfactorforcircuitswitchedserviceontheuplink
Defaultvalue:1
UL_DP Float Packetinterarrivaltime(ms)ontheuplink
Defaultvalue:0
UL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)ontheuplink
Defaultvalue:0
UL_NPC Integer Numberofpacketcallsduringasessionontheuplink
Defaultvalue:1
UL_PACKET_EFFICIENCY Float Packetefficiencyfactorontheuplink
Defaultvalue:
UL_SP Integer Packetsize(Bytes)ontheuplink
Defaultvalue:1500
UL_SPC_MAX Float UplinkmaxPacketcallsize(kBytes)
Defaultvalue:2000
UL_SPC_MIN Float UplinkminPacketcallsize(kBytes)
Defaultvalue:4
DL_TARGET_QUAL Float Eb/Nttargetonthedownlinkforatypeofmobility
Defaultvalue:0
DL_TGT_QUAL_DIVCLOSED Float QualitytargetondownlinkincaseofclosedloopTXdiversity
Defaultvalue:0
DL_TGT_QUAL_DIVOPEN Float QualitytargetondownlinkincaseofopenloopTXdiversity
Defaultvalue:0
MOBILITY Text(50) Secondpartoftheuniquekey.Typeofmobility
Defaultvalue:
Defaultvalue:
SERVICE Text(50) Firstpartoftheuniquekey.Nameoftheservice
Defaultvalue:
TCH_THRESHOLD_DL Short RSCPTCHtargetondownlinkforatypeofmobility
Defaultvalue:0
TCH_THRESHOLD_UL Short RSCPTCHtargetonuplinkforatypeofmobility
Defaultvalue:0
UL_TARGET_QUAL Float Eb/Nttargetontheuplinkforatypeofmobility
Defaultvalue:0
UL_TGT_QUAL_DIV2RX Float Qualitytargetonuplinkincaseof2RXdiversity
Defaultvalue:0
UL_TGT_QUAL_DIV4RX Float Qualitytargetonuplinkincaseof4RXdiversity
Defaultvalue:0
436
Forterminaltypes.
CALL_DURATION Float
Unit:s
Defaultvalue:
CALL_NUMBER Float
Defaultvalue:0
DL_VOLUME Float
Datavolumetransferredonthedownlinkduringasession(forpacket
switchedservices)
Unit:Kbyte
Defaultvalue:
Defaultvalue:
Defaultvalue:
UL_VOLUME Float
Datavolumetransferredontheuplinkduringasession(forpacket
switchedservices)
Unit:Kbyte
Defaultvalue:
Defaultvalue:
CARRIER_NUMBER Short Numberofcarrierssupportedbytheterminal
Defaultvalue:1
Defaultvalue:0
HSPA_SUPPORT Short HSPAfeaturessupported:0=None;1=HSDPA;2=HSPA
Defaultvalue:0
HSSICH_POWER Float MaximumpoweronHSSICHchannels
Defaultvalue:21
HSUPA_UE_CATEGORY Short HSUPAUEcategory
Defaultvalue:1
Defaultvalue:0
MUD_FACTOR Float
AdvancedReceiverFactortomodelintracellinterferencereductionfor
HSDPAterminalsonly
Defaultvalue:0
Defaultvalue:
Defaultvalue:8
Defaultvalue:21
Defaultvalue:50
Defaultvalue:100
UE_CATEGORY Float CategoryoftheUserEquipmentforHSDPA
Defaultvalue:1
UPPCH_POWER Float PowerontheUpPTStimeslot
Defaultvalue:50
437
19.60 UnitsTable
Defaultvalue:Yes
Defaultvalue:
Defaultvalue:
Defaultvalue:1
GAIN_UNIT Integer
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
438
AT320_AM_E2 Chapter20:WiMAXandWiFiDataStructure
439
20 WiMAXandWiFiDataStructure
Figure 20.1onpage 439,Figure 20.2onpage 440,andFigure 20.3onpage 441depicttheWiMAXBWAdatabasestructure.
ThefollowingsubsectionslistthetablesintheWiMAXBWAtemplatedatastructure.
Figure 20.1:WiMAXBWATemplate1
440
Chapter20:WiMAXandWiFiDataStructure Forsk2013
441
AntennasTable
CustomFieldsTable
FrameConfigurationsTable
Defaultvalue:
DISPLAY_TYPE Integer 0:Fieldismodifiable;1:Fieldisreadonly
Defaultvalue:0
CYCLIC_PREFIX Short Cyclicprefixratio(NULL;0:1/4;1:1/8;2:1/16;4:1/32)
Defaultvalue:
442
FrequencyBandsTable
NetworksTable
SitesTable
TransmittersTable
WCCHDivGainsTable(New)
WCellsTable
Defaultvalue:1
Defaultvalue:0
MAX_BH_RATE_DL Float BackhaulmaximumDLthroughput(kbps)
Defaultvalue:950000
MAX_BH_RATE_UL Float BackhaulmaximumULthroughput(kbps)
Defaultvalue:950000
Defaultvalue:
LAYER_LIST
Text
(255)
Listoflayers
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
EQUIPMENT Text(50)
gainscorrespond
Defaultvalue:
Defaultvalue:1
Defaultvalue:1
MOBILITY Text(50)
correspond
Defaultvalue:
PREAMBLE_DIV_GAIN Float Preamblediversitygain
Defaultvalue:0
CELL_PERMBASE Short CellPermBase
Defaultvalue:0
Defaultvalue:1
Defaultvalue:1
443
WLayersTable(New)
WMimoConfigsTable
WServicesTable
WTerminalsTable
SitesTable
SUPPORT_NATURE
20.2 AntennasTable
Forantennas.
SEGMENT Short Cellsegment
Defaultvalue:0
Defaultvalue:0
MAX_SPEED Float Maximumspeedofmobilesforthislayer
Defaultvalue:300
NAME Text(50) Nameofthenetworklayer
Defaultvalue:
PRIORITY Short Priorityofthenetworklayer
Defaultvalue:0
SELECTION_MARGIN Float
Marginwithrespecttothehighestsignallevelwithinwhichthelayeris
candidateforselectionasserver
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
MIN_SC_UL Integer Minimumnumberofrequiredsubchannelsfortheservice
Defaultvalue:1
Defaultvalue:1
Defaultvalue:1
Defaultvalue:
COMMENT_
Text
(255)
Additionalinformationabouttheantenna
Defaultvalue:
CONSTRUCTOR
Text
(255)
Antennamanufacturername
Defaultvalue:
444
ForBTSequipment.
20.4 CoordSysTable
DIAGRAM Binary
Internalbinaryformatcontainingthedescriptionoftheantenna
horizontalandverticalpatterns
Defaultvalue:
Defaultvalue:
Defaultvalue:
FMax Double
Maximumfrequencyofcreatedantenna
Unit:MHz
Defaultvalue:
FMin Double
Minimumfrequencyofcreatedantenna
Unit:MHz
Defaultvalue:
GAIN Float
Unit:dBi
Defaultvalue:0
NAME Text(50) Nameofantennacreatedinthecurrentproject
Defaultvalue:
Defaultvalue:
onpage 113.
combiner)
Defaultvalue:0
combiner)
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
RHO_FACTOR Short Rhofactor(notused)
Defaultvalue:100
CODE Integer
Defaultvalue:0
DATUM_CODE Double
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
445
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
ELLIPS_CODE Integer
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
PROJ_METHOD Short
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
DISPLAY_TYPE Integer 0:Fieldismodifiable;1:Fieldisreadonly
Defaultvalue:0
446
Forfeeders.
20.7 FrameConfigurationsTable
Forframeconfigurations.
Forfrequencybands.
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
CYCLIC_PREFIX Short Cyclicprefixratio(NULL;0:1/4;1:1/8;2:1/16;4:1/32)
Defaultvalue:
N_FFT Short
Totalnumberofsubcarriersperchannelbandwidthforthisframe
configuration
Defaultvalue:256
NAME Text(50) Nameoftheframeconfiguration
Defaultvalue:"Default
Frame"
PREAMBLE_N_USED Short Thenumberofsubcarriersusedforthepreamble
Defaultvalue:
SEGMENTATION Boolean Iftrue,thefirstDLPUSCzoneissegmented
Defaultvalue:False
UL_SEGMENTATION Boolean Iftrue,thefirstULPUSCzoneissegmented
Defaultvalue:False
ADJ_CHANNEL_PROT Float Protectionagainstinterferingsignalsfromadjacentchannels
Defaultvalue:11
Unit:MHz
Defaultvalue:1
DELTA_CN Integer Numericdifferencebetweentwoadjacentchannels
Defaultvalue:1
DL_FREQUENCY Double
DLfrequencyofthe1stchannel
Unit:MHz
Defaultvalue:
DUPLEXING_METHOD Short
Duplexingmethodusedinthefrequencyband
Choicelist:0=FDD;1=TDD;
Defaultvalue:0
447
Formultiuserdiversitygains.
EXCLUDED_CHANNELS
Text
(255)
Defaultvalue:
FIRST_CHANNEL Integer Numberofthefirstphysicalchannelofthefrequencyband
Defaultvalue:0
GUARD_BAND Float Guardbandbetweencarriers(MHz)
Defaultvalue:0
LAST_CHANNEL Integer Numberofthelastphysicalchannelofthefrequencyband
Defaultvalue:9
Defaultvalue:
SAMPLING_FACTOR Float Ratiobetweenthechannelbandwidthanditssamplingfrequency
Defaultvalue:1
UL_FREQUENCY Double
ULfrequencyofthe1stchannel
Unit:MHz
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
A
MAX_CINR Float C/(I+N)abovewhichnoMUGwillbeapplied.
Defaultvalue:16.8
MOBILITY Text(50) MobilitytypeforwhichtheMUGtableisdefined.
Defaultvalue:
Defaultvalue:
SCHEDULER_NAME Text(30) NameoftheschedulerforwhichtheMUGtableisdefined.
Defaultvalue:
Defaultvalue:1
Defaultvalue:
REASON Integer
448
20.15 NetworksTable
RELATION_TYPE Short Typeoftheneighbourrelation:0=Intracarrier;1=Intercarrier
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
NEIGHBOUR Text(50) Neighbourcellortransmitter
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:1
Defaultvalue:
REASON Integer
Defaultvalue:
Defaultvalue:
449
AMScriterion
(0PreambleC/N;1PreambleC/(I+N))
Defaultvalue:0
BS_SELECTION Short Bestserverselectionmethod:0=Preamblesignallevel;1=PreambleC/N;
Defaultvalue:0
(0=Obsolete,1=Obsolete,2=Random,3=Distributive)
Defaultvalue:2
CYCLIC_PREFIX Short
Cyclicprefixratio
Choicelist:0=1/4;1=1/8;2=1/16;4=1/32;
Defaultvalue:1
Defaultvalue:"Cost
Hata"
Defaultvalue:50
DEFAULT_RTG Float
ReceiveTimeGuard,RTG(TDDonly)
Unit:ms
Defaultvalue:0
DEFAULT_TTG Float
TransmitTimeGuard,TTG(TDDonly)
Unit:ms
Defaultvalue:0
DL_RATIO_FORMAT Short FormatoftheDLratioparameter(0:Percentage;1:Fraction)
Defaultvalue:0
DL_SYM_DURATIONS_NB Short
Numberofsymboldurationsinthedownlinksubframe(includingthe
symboldurationusedforthePreamble)
Defaultvalue:32
DL_UL_RATIO Float
DLsubframesymbolnumber/ULsubframesymbolnumber(TDDonly)
Unit:%
Defaultvalue:66.667
Defaultvalue:1
FIX_DL_OVERHEAD Short DLoverheadexpressedinsymboldurations
Defaultvalue:1
FIX_UL_OVERHEAD Integer ULoverheadexpressedinsymboldurations
Defaultvalue:0
FRAME_DURATION Short
Thelengthofaframe
Choicelist:0=20 ms;1=12.5 ms;2=10 ms;3=8 ms;4=5 ms;5=4 ms;
6=2.5 ms;7=2 ms;
Defaultvalue:4
Defaultvalue:20
Defaultvalue:0
N_DATA Short
Numberofsubcarriersperchannelusedfordatatransfer
(N_USEDpilotsubcarriers)
Defaultvalue:192
N_FFT Short Totalnumberofsubcarriersperchannel
Defaultvalue:256
N_SUBCHANNELS_CH Short Numberofsubchannelsperchannel
Defaultvalue:16
N_USED Short Numberofusedsubcarriersperchannel(N_FFTguardsubcarriers)
Defaultvalue:200
Defaultvalue:
Defaultvalue:1
PZ_SEL_CRITERION Short
Permutationzoneselectioncriterion
(0PreambleC/N;1PreambleC/(I+N))
Defaultvalue:0
Text
(255)
Defaultvalue:
Defaultvalue:IEEE
802.16e
450
20.16 PermutationZonesTable
Forpermutationzones.
Defaultvalue:OFDM
Defaultvalue:121
UL_SYM_DURATIONS_NB Short Numberofsymboldurationsintheuplinksubframe
Defaultvalue:15
VARIABLE_DL_OVERHEAD Float DLoverheadexpressedintramepercentage
Defaultvalue:0
VARIABLE_UL_OVERHEAD Float ULoverheadexpressedintramepercentage
Defaultvalue:0
AUTO_ACTIVATE Boolean Iftrue,thepermutationzoneisactivatedfornewcells
Defaultvalue:False
DIVERSITY_SUPPORT Short Thetypeofantennadiversitysupportedbythepermutationzone
Defaultvalue:1
FRAME_CONFIG Text(50)
Nameoftheframeconfiguration
(fromtheFrameConfigurationstable)
Defaultvalue:
MAX_DISTANCE Float Coveragelimitforthezoneintermsofmaximumdistancefromthecell
Defaultvalue:500000
MAX_SPEED Float Highestuserspeedthatcanusethispermutationzone(km/h)
Defaultvalue:150
N_DATA Short
Numberofsubcarriersperchannelusedfordatatransfer
(N_USEDpilotsubcarriers)
Defaultvalue:192
N_SUBCHANNELS_CH Short Numberofsubchannelsperchannel
Defaultvalue:16
N_USED Short
Numberofusedsubcarriersperchannel
(N_FFTguardsubcarriersDCsubcarrier)
Defaultvalue:200
PRIORITY Short Permutationzonepriority(0:lowest)
Defaultvalue:0
QUALITY_THRESHOLD Float Minimumsignalqualityrequiredtousethiszone(dB)
Defaultvalue:5
SC_GROUPS_SEG0 Short Subchannelgroupsusedbysegment0
Defaultvalue:3
Defaultvalue:12
Defaultvalue:48
SUBCHANNEL_ALLOC_MODE Short
Nameofthesubchannelallocationmode
Choicelist:0=PUSC DL;1=FUSC;2=OFUSC;3=AMC;4=TUSC 1;5=TUSC 2;
6=PUSC UL;7=OPUSC;
Defaultvalue:0
SUBFRAME Short
DownlinkSubframeorUplinkSubframe
Choicelist:0=DL;1=UL;
Defaultvalue:0
ULSC_GROUPS_SEG0
Text
(255)
Uplinksubchannelsbelongingtosegment0ofthecell
Defaultvalue:
ULSC_GROUPS_SEG1
Text
(255)
Defaultvalue:
ULSC_GROUPS_SEG2
Text
(255)
Defaultvalue:
USED_SC_GROUPS Short
ThesecondarysubchannelgroupsusedbythesegmentedDLPUSCzone
(Obsolete)
Defaultvalue:
451
ZONE_ID Short
Zoneidentifier
Choicelist:0to7forDL;0to2forUL;
Defaultvalue:0
Defaultvalue:
Description
Text
(255)
Userdefined
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
CS_QI Boolean
FlagindicatingwhethertheQualityIndicatorisusedforVoice(CS)
services
Defaultvalue:True
MEAS_PARAM Short
Defaultvalue:0
NAME Text(50) NameoftheQualityIndicator
Defaultvalue:
PS_QI Boolean
FlagindicatingwhethertheQualityIndicatorisusedforData(PS)
services
Defaultvalue:True
USE_INTERPOLATION Boolean
FlagindicatingwhethertheQualityIndicatormustbeinterpolatedor
not
Defaultvalue:True
Defaultvalue:
HEIGHT Float HeightofthereceiverUnit:m
Defaultvalue:1.5
LOSS Float Lossesduetoreceiverradioequipment(upanddownlink)Unit:dB
Defaultvalue:0.
NAME Text(50) Nameofthereceiver
Defaultvalue:
452
Forrepeaters.
COMMENT_
Text
(255)
Comments
Defaultvalue:
Defaultvalue:
Defaultvalue:90
Defaultvalue:30
Defaultvalue:12
Defaultvalue:50
Defaultvalue:
Defaultvalue:5
Defaultvalue:1
Defaultvalue:5
Defaultvalue:80
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:1
donorandrepeater
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:25
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
453
Forschedulers.
20.24 SitesTable
Forsites.
Defaultvalue:0
Defaultvalue:
BEARER_SELECTION Short
BearerSelectionCriterion:0BearerIndex;1PeakMACThroughput;
2EffectiveMACThroughput
Defaultvalue:0
Defaultvalue:
QOS_BIAS_FACTOR Float WeightratioforbetterQoS(%)
Defaultvalue:0
SCHEDULING_METHOD Short
0=ProportionalFair;1=ProportionalDemand;2=Biased(QoSClass);3
=MaxAggregateThroughput
Defaultvalue:0
TARGET_THROUGHPUT_DAT
A
Short
0=PeakMACThroughput;1=EffectiveMACThroughput;2=
ApplicationThroughput
Defaultvalue:0
TARGET_THROUGHPUT_VOI
CE
Short
0=PeakMACThroughput;1=EffectiveMACThroughput;2=
ApplicationThroughput
Defaultvalue:0
UL_BW_ALLOCATION Short
ULBandwidthAllocationTarget:0FullBandwidth;1Maintain
Connection;2BestBearer
Defaultvalue:2
ANTENNA Text(50)
Nameoftheantennainstalledonthetransmitter
(fromtheAntennastable)
Defaultvalue:
AZIMUT Float Azimuthoftheantenna
Defaultvalue:0
Defaultvalue:0
REDT Float RemoteElectricaltiltofthesecondaryantenna
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
ALTITUDE Float
Realaltitude(userdefined)
Unit:m
Defaultvalue:
454
COMMENT_
Text
(255)
Additionalinformationaboutthesite
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
MAX_BH_RATE_DL Float BackhaulmaximumDLthroughput(kbps)
Defaultvalue:950000
MAX_BH_RATE_UL Float BackhaulmaximumULthroughput(kbps)
Defaultvalue:950000
Defaultvalue:
Defaultvalue:50
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
BROADCAST_ANTENNA Text(50) Broadcast(main)antennamodelforthesmartantenna
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
Defaultvalue:
SA_MODEL Text(50) Smartantennamodelused
Defaultvalue:
455
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
AMS_THRESHOLD Float CINRthresholdindBtoswitchfromSMtoSTTD/MRC
Defaultvalue:
Antennastable)
Defaultvalue:
Defaultvalue:
Defaultvalue:
CALC_RADIUS Integer
CalculationradiususedtodefineeachtransmittercalculationareaUnit:
m
Defaultvalue:
Unit:m
Defaultvalue:
Defaultvalue:
Defaultvalue:
CELL_SIZE Float Radiusofthecell(schematicallyrepresentedbyanhexagon)Unit:m
Defaultvalue:
CHANNEL_LIST Text(255) Channelnumbersusedbytransmitters
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
456
DL_LOAD Float Downlinktrafficload
Defaultvalue:
E_RISE
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Definesthesubchannel,subcarrier,andpermutationzoneconfiguration
usedatthecell
Defaultvalue:
Defaultvalue:
IDLE_PILOT_POWER_OFFSET Float Pilotpoweroffset=PreamblepowerIdlePilotpower(dB)
Defaultvalue:
LAYER_LIST
Text
(255)
Listoflayers
Defaultvalue:0
Defaultvalue:
MAX_EXT_NEIGHB_NUMBER Integer Maximumnumberofintertechnologyneighbours
Defaultvalue:
MAX_NEIGHB_NUMBER Integer Maximumnumberofintratechnologyneighbours
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
NOISE_FIGURE Float
transmitter
Defaultvalue:
NOISE_RISE_UL Float Uplinkinterferencenoiserise(dB)
Defaultvalue:
NOISE_RISE_UL_SEG Float Uplinknoiseriseforthesegmentedpermutationzone
Defaultvalue:
Defaultvalue:
PI_DOMAIN_NAME Text(50) Nameofthepreambleindexdomain
Defaultvalue:
PI_LIST Text(255) Preambleindexesusedbytransmitters
Defaultvalue:
PI_REUSE_MIN_DIST Float TheminimumreusedistancefortheAFPandpreambleindexallocation
Defaultvalue:
457
Fortransmitters.
PILOT_POWER_OFFSET Float Pilotpoweroffset=PreamblepowerPilotpower(dB)
Defaultvalue:
POWER Float Celloutputpower(dBm)
Defaultvalue:
PREAMBLE_QUALITY_THRES Float RequiredCNRqualityforthepreamblesignal
Defaultvalue:
PROPAG_MODEL
Text
(255)
Defaultvalue:
PROPAG_MODEL2
Text
(255)
Nameofthesecondpropagationmodelusedtocalculateprediction
Defaultvalue:
Defaultvalue:
RXLOSSES Float LossesontheuplinkduetotransmitterradioequipmentUnit:dB
Defaultvalue:
SA_NAME Text(50) Nameoftheassociatedsmartantenna
Defaultvalue:
Defaultvalue:
SEGMENTATION_USAGE Float Segmentationusageratio
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
TRAFFIC_POWER_OFFSET Float Trafficpoweroffset=Preamblepowertrafficpower(dB)
Defaultvalue:
Defaultvalue:
TXLOSSES Float LossesonthedownlinkduetotransmitterradioequipmentUnit:dB
Defaultvalue:
UL_LOAD Float Uplinktrafficload
Defaultvalue:
Defaultvalue:
ISE
Defaultvalue:
WEQUIPMENT Text(50) Cellequipment
Defaultvalue:
Defaultvalue:True
Antennastable)
Defaultvalue:
Defaultvalue:0
458
Defaultvalue:
CALC_RADIUS Integer CalculationradiususedtodefinethecalculationareaUnit:m
Defaultvalue:4000
Unit:m
Defaultvalue:
Defaultvalue:50
Defaultvalue:
CELL_SIZE Float Radiusofthecell(schematicallyrepresentedbyanhexagon)
Defaultvalue:2000
COMMENT_
Text
(255)
Defaultvalue:
DX Float Xcoordinaterelativetothesiteposition
Defaultvalue:0
DY Float Ycoordinaterelativetothesiteposition
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:25
HEXAGON_GROUP Text(50) Groupofhexagonswhichcontainsthistransmitter
Defaultvalue:
Defaultvalue:1
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
NOISE_FIGURE Float
transmitter
Defaultvalue:5
POLARIZATION Text(1) Polarizationoftheantennasinstalledatthetransmitter
Defaultvalue:"V"
PROPAG_MODEL Text(50) Nameofthepropagationmodelusedtocalculateprediction
Defaultvalue:
PROPAG_MODEL2 Text(50) Nameofthesecondpropagationmodelusedtocalculateprediction
Defaultvalue:
REDT Float Remoteelectricaltiltofthemainantenna
Defaultvalue:0
Defaultvalue:0
SA_NAME Text(50) Nameofthesmartantennaassignedtothetransmitter
Defaultvalue:
Defaultvalue:
Defaultvalue:0
459
20.32 TxsListsTable
20.34 UnitsTable
20.35 WBearerQualityCurvesTable
Forbearerperformancegraphs.
SITE_NAME Text(50)
Nameofthesiteatwhichthetransmitterislocated(fromtheSites
table)
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
TXLOSSES Float Lossesonthedownlinkduetotransmitterradioequipment
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:1
GAIN_UNIT Integer
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
460
20.36 WBearersTable
Forbearers.
20.37 WBearersRequiredCITable
Forbearerselectionthresholds.
20.38 WCCHDivGainsTable
Forcontrolchanneldiversitygains.
MOBILITY Text(50) Mobilitytype
Defaultvalue:
QI_CURVE Memo
DLQualityQI=f(MEAS_PARAM)MEAS_PARAMfromQualityIndicators
table
Defaultvalue:
Defaultvalue:
Defaultvalue:
BEARER_INDEX Short Modulationandcodingschemenumber
Defaultvalue:1
CODING_RATE Float Codingrate
Defaultvalue:1
MODULATION Short
Modulationtype
Choicelist:0=BPSK;1=QPSK;2=16QAM;3=64QAM;
Defaultvalue:1
NAME Text(50) Nameoftheradiobearer
Defaultvalue:
SPECTRAL_EFFICIENCY Float Spectralefficiency=PeakMACThroughputperHzUnit:bps/Hz
Defaultvalue:0
BEARERS_REQUIRED_COVERI Memo
C/IrequiredinDLforselectingaradiobearerC/I_Req=
f(Best(BEARER_INDEX))
Defaultvalue:
MOBILITY Text(50) CPEmobility
Defaultvalue:
Defaultvalue:
EQUIPMENT Text(50)
gainscorrespond
Defaultvalue:
Defaultvalue:1
Defaultvalue:1
MOBILITY Text(50)
correspond
Defaultvalue:
PREAMBLE_DIV_GAIN Float Preamblediversitygain
Defaultvalue:0
461
20.39 WCellsTable
Forcells.
AAS_RESULTS Binary UplinkanddownlinkAASresultsfromsimulations
Defaultvalue:
AAS_USAGE Float
Percentationofdownlinktrafficloadsupportedbythesmartantenna
equipment
Defaultvalue:50
ACTIVE Boolean Cell'sactivity.Cellisactiveiftrue.
Defaultvalue:True
AMS_THRESHOLD Float C/(I+N)thresholdforswitchingfromSMtoSTTD/MRC
Defaultvalue:
BSID Text(50) Cellconnexionidentifier
Defaultvalue:
Defaultvalue:
CELL_PERMBASE Short CellPermBase
Defaultvalue:0
CHANNEL Integer Channelnumber
Defaultvalue:0
CHANNEL_STATUS Short Channelallocationstatus(0=Notallocated,1=Allocated,2=Locked)
Defaultvalue:0
COMMENT_
Text
(255)
Defaultvalue:
DL_LOAD Float Downlinkcelltrafficload
Defaultvalue:1
DL_ZONE_PB Integer Downlinkzonepermbase
Defaultvalue:
DL_ZONE_PB_STATUS Short
Downlinkzonepermbaseallocationstatus:0=Notallocated;
1=Allocated;2=Locked;
Defaultvalue:0
E_RISE
Defaultvalue:0
Defaultvalue:
Definesthesubchannel,subcarrier,andpermutationzoneconfiguration
usedatthecell
Defaultvalue:
IDLE_PILOT_POWER_OFFSET Float
Offset(indB)withrespecttothepreamblepowerfordeterminingthe
pilotpowerduringtheemptypartoftheframe
Defaultvalue:10
LOCKED_SEGMENT Short Segmentlockedforautomaticallocationornot:0=Unlocked;1=Locked;
Defaultvalue:0
Defaultvalue:100
MAX_EXT_NEIGHB_NUMBER Integer Maximumnumberofintertechnologyneighboursforthiscell
Defaultvalue:
MAX_NEIGHB_NUMBER Integer Maximumnumberofintratechnologyneighboursforthiscell
Defaultvalue:
Defaultvalue:
Defaultvalue:100
NOISE_RISE_UL Float
Uplinknoiserise(dB).Manuallyspecifiedbytheuserorcalculated
duringsimulations.
Defaultvalue:0
NOISE_RISE_UL_SEG Float Uplinknoiseriseforthesegmentedpermutationzone
Defaultvalue:0
462
20.40 WEnvironmentDefsTable
Defaultvalue:1
Defaultvalue:1
PI_DOMAIN_NAME Text(50) Nameofthepreambleindexdomain
Defaultvalue:
PI_REUSE_MIN_DIST Float TheminimumreusedistancefortheAFPandpreambleindexallocation
Defaultvalue:
PI_STATUS Short Preambleindexstatus(0=Notallocated,1=Allocated,2=Locked)
Defaultvalue:0
PILOT_POWER_OFFSET Float
pilotpowerduringtheloadedpartoftheframe
Defaultvalue:0
POWER Float OutputPowerUnit:dBm
Defaultvalue:43
PREAMBLE_INDEX Integer Preambleindexofthecell
Defaultvalue:0
PREAMBLE_QUALITY_THRES Float RequiredCNRqualityforthepreamblesignal
Defaultvalue:4
RANK Short Zerobasedorderusedbyschedulerforsequentialcellselection
Defaultvalue:
Defaultvalue:
SEGMENT Short Cellsegment
Defaultvalue:0
SEGMENTATION_USAGE Float Percentationofdownlinktrafficloaddedicatedtothesegmentedzone
Defaultvalue:50
TRAFFIC_POWER_OFFSET Float
trafficpower
Defaultvalue:3
TX_ID Text(50) Nameofthetransmittertowhichthecellbelongs
Defaultvalue:
UL_LOAD Float Uplinkcelltrafficload
Defaultvalue:1
Defaultvalue:2
UL_ZONE_PB Integer Uplinkzonepermbase
Defaultvalue:
UL_ZONE_PB_STATUS Short
Uplinkzonepermbaseallocationstatus:0=Notallocated;
1=Allocated;2=Locked
Defaultvalue:0
ISE
Defaultvalue:0
WEQUIPMENT Text(50) Receptionequipmentinstalledatthecell
Defaultvalue:
DENSITY Float
2
Defaultvalue:0
Defaultvalue:
Defaultvalue:
463
20.41 WEquipmentsTable
Forreceptionequipment.
20.42 WLayersTable
Fornetworklayers.
20.43 WMimoConfigsTable
ForMIMOgaingraphs.
Defaultvalue:
NAME Text(50) Nameofthereceptionequipment
Defaultvalue:
Defaultvalue:0
MAX_SPEED Float Maximumspeedofmobilesforthislayer
Defaultvalue:300
NAME Text(50) Nameofthenetworklayer
Defaultvalue:
PRIORITY Short Priorityofthenetworklayer
Defaultvalue:0
SELECTION_MARGIN Float
Marginwithrespecttothehighestsignallevelwithinwhichthelayeris
candidateforselectionasserver
Defaultvalue:0
BEARER_INDEX Short Indexoftheradiobearer
Defaultvalue:1
MAX_BLER Float MaximumvalueofBLERforwhichthegainsareapplicable
Defaultvalue:1
MAX_MIMO_GAIN Memo GraphofmaximumMIMOgainsvs.C/(I+N)
Defaultvalue:
Defaultvalue:1
Defaultvalue:1
MOBILITY Text(50) Usermobility
Defaultvalue:
Defaultvalue:0
STTD_GAIN Float GainthatwillbeappliedtotheCINRinSTTDmode(dB)
Defaultvalue:0
SUBCHANNEL_ALLOC_MODE Short Subchannelallocationmode
Defaultvalue:8
Defaultvalue:0
WEQUIPMENT Text(50) NameoftheequipmenttowhichtheMIMOgainscorrespond
Defaultvalue:
464
20.44 WMobilityTable
Formobilitytypes.
20.45 WPIDomainsTable
Forpreambleindexdomains.
20.46 WPIGroupsTable
Forpreambleindexgroups.
20.47 WServicesTable
Forservices.
Defaultvalue:0
Defaultvalue:
DOMAIN_NAME Text(50) Nameofthepreambleindexdomain
Defaultvalue:
DOMAIN_NAME Text(50) Nameofthepreambleindexdomain
Nullcolumnallowed:
Defaultvalue:
EXCLUDED
Text
(225)
ListofindexestobeexcludedfromtheseriesdefinedbyFIRST,LASTand
Defaultvalue:
EXTRA
Text
(225)
Indexestobeadded.ItisforbiddenforEXTRAandEXLUDEDtohave
Defaultvalue:
FIRST Integer
LAST.
Defaultvalue:0
LAST Integer
LAST.
Defaultvalue:0
NAME Text(50) Nameofthepreambleindexgroupinthedomain
Defaultvalue:
STEP Integer
LAST.
Defaultvalue:1
BODY_LOSS Float Lossesduetotheusersbody(dB)
Defaultvalue:0
Defaultvalue:1
DL_DP Float Packetinterarrivaltime(ms)indownlink
Defaultvalue:0
DL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)indownlink
Defaultvalue:0
DL_HIGHEST_BEARER Float ThehighestbearertoallowedtobeusedforthisserviceinDL
Defaultvalue:8
465
DL_LOWEST_BEARER Short ThelowestbearerallowedtobeusedforthisserviceinDL
Defaultvalue:1
DL_MAXIMUM_LATENCY Float MaximumlatencyinDL(ms)
Defaultvalue:0
DL_MRTR Float
MinimumrequiredtransmissionrateinDL(CommittedInformation
Rate)
Defaultvalue:0
DL_MSTR Float MaximumsustainedtrasmissionrateinDL(MaximumInformationRate)
Defaultvalue:0
DL_NPC Integer Numberofpacketcallsduringasessionindownlink
Defaultvalue:1
DL_SP Integer Packetsize(Bytes)indownlink
Defaultvalue:1500
DL_SPC_MAX Float Downlinkmaximumpacketcallsize(kBytes)
Defaultvalue:2000
DL_SPC_MIN Float Downlinkminimumpacketcallsize(kBytes)
Defaultvalue:4
MAXIMUM_BLOCKING_PRO
BA
Integer Maximumprobabilityofblocking(ordelay)(%)
Defaultvalue:0
MIN_SC_UL Integer Minimumnumberofrequiredsubchannelsfortheservice
Defaultvalue:1
Defaultvalue:
Defaultvalue:0
QOS_CLASS Short
QualityofServiceclass(InorderofprioritydefinedbytheIEEE802.16
standard)
Choicelist:0=UGS;1=rtPS;2=ErtPS;3=nrtPS;4=BestEffort;
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:1
TH_OFFSET Float OffsettoaddtoTH_SCALE_FACTOR
Defaultvalue:0
TH_SCALE_FACTOR Float RatiobetweenapplicationlevelthroughputandMAClayerthroughput
Defaultvalue:95
TYPE Short
Servicetype
Choicelist:0=Voice;1=Data;
Defaultvalue:0
Defaultvalue:1
UL_DP Float Packetinterarrivaltime(ms)inuplink
Defaultvalue:0
UL_DPC Float Readingtime(distance)betweentwopacketcalls(ms)inuplink
Defaultvalue:0
UL_HIGHEST_BEARER Float ThehighestbearertoallowedtobeusedforthisserviceinUL
Defaultvalue:4
UL_LOWEST_BEARER Short ThelowestbearerallowedtobeusedforthisserviceinUL
Defaultvalue:1
UL_MAXIMUM_LATENCY Float MaximumlatencyinUL(ms)
Defaultvalue:0
UL_MRTR Float
MinimumrequiredtransmissionrateinUL(CommittedInformation
Rate)
Defaultvalue:0
UL_MSTR Float MaximumsustainedtrasmissionrateinUL(MaximumInformationRate)
Defaultvalue:0
466
20.48 WServicesUsageTable
20.49 WTerminalsTable
Forterminaltypes.
UL_NPC Integer Numberofpacketcallsduringasessioninuplink
Defaultvalue:1
UL_SP Integer Packetsize(Bytes)inuplink
Defaultvalue:1500
UL_SPC_MAX Float Uplinkmaximumpacketcallsize(kBytes)
Defaultvalue:2000
UL_SPC_MIN Float Uplinkminimumpacketcallsize(kBytes)
Defaultvalue:4
CALL_DURATION Float Averagedurationofacall(forcircuitswitchedservices)Unit:s
Defaultvalue:
CALL_NUMBER Float
Defaultvalue:0
DL_VOLUME Float
switchedservices)Unit:Kbyte
Defaultvalue:
SERVICE Text(50) Service(fromtheServicetable)thatthesubscribercanrequest
Defaultvalue:
TERMINAL Text(50)
Typeofterminal(fromtheTerminaltable)usedbythesubscriberfor
theservice
Defaultvalue:
UL_VOLUME Float
services)Unit:Kbyte
Defaultvalue:
Defaultvalue:
Defaultvalue:
DIVERSITY_SUPPORT Short
Antennadiversitysupport(0=None,1=AAS,2=MIMO,3=
AAS+MIMO)
Defaultvalue:1
GAIN Float Terminalantennagain(dB)
Defaultvalue:0
LOSS Float Terminalantennaloss(dB)
Defaultvalue:0
Defaultvalue:1
Defaultvalue:1
Defaultvalue:
NOISE_FACTOR Float Noisefigureusedtodeterminethethermalnoiseatthereceiver(dB)
Defaultvalue:8
PMAX Float Maximumterminalpowerontrafficchannel(dBm)
Defaultvalue:23
PMIN Float Minimumterminalpowerontrafficchannel(dBm)
Defaultvalue:22
467
20.50 WTraficEnvironmentsTable
20.51 WUserProfilesTable
RX_EQUIP Text(50) Nameofthereceptionequipmentavailableattheterminal
Defaultvalue:
Defaultvalue:1
Defaultvalue:
Defaultvalue:
Defaultvalue:
468
AT320_AM_E2 Chapter21:MicrowaveLinksDataStructure
469
21 MicrowaveLinksDataStructure
ThefollowingsubsectionslistthetablesintheMicrowaveRadioLinkstemplatedatastructure.
CustomFieldsTable
MWBranchingConfigsTable
MWCapacitiesTable
MWEquipmentsTable
MWFamilyModulationsTable
MWFrequenciesTable(New)
DISPLAY_TYPE Integer 0:Free;1:Readonly
Defaultvalue:0
LOS_MIMO Boolean FlagtodefineifthisconfigurationsupportsLOSMIMOantennas
Defaultvalue:False
NUM_RX_ANTENNAS Short Numberofreceivingantennas(forMIMO)
Defaultvalue:1
NUM_TX_ANTENNAS Short Numberoftransmittingantennas(forMIMO)
Defaultvalue:1
ACM_MODE Integer
Adaptivecodingmodulationtype:
0=none;1=Maximumsystemgain;2=MaximumThroughput
Defaultvalue:0
CAPA_TECHNO Short
Capacityconfiguration:
0=Fullpacket;1=Hybrid;2=TDMonly
Defaultvalue:0
FAMILY Text(50) Tablewhichdefinesthelistofmodulationssupportedbyeachfamily
Defaultvalue:
FREQ_BAND Text(50) Frequencybandvalue
Defaultvalue:
MODULATION Text(20) Modulationname
Defaultvalue:
TDM_RATE Float ValueofratereservedforTDMinMbps
Defaultvalue:0
RX_LEVEL_REQUIRED Integer ValuewhichdefinestherequiredreceivedlevelforATPC
Defaultvalue:
LOW_POWER Float Lowpowervaluewhichcanbeusedinlinkproperties
Defaultvalue:
CHANNEL_ID Integer IDofthechannel
Defaultvalue:1
470
Chapter21:MicrowaveLinksDataStructure Forsk2013
MWLinksTable
MWMediumTypesTable(New)
MWMultiHopsLinksTable
MWOperatingModesTable(New)
CHANNEL_RADICAL Text(20) Radicalofthechannel.Subbandprefixandsuffixwillbeappended
Defaultvalue:
FREQ_L Double Valueofthefrequency(MHz)inthelowerhalfband
Defaultvalue:
FREQ_U Double Valueofthefrequency(MHz)intheupperhalfband
Defaultvalue:
SUBBAND Text(50) Nameofaexistingsubbandtowhichthesefrequenciesarerelated
Defaultvalue:
POWER_FLAG_A Short
Typeofpower:
0=RelativetoMax;1=RelativetoStd;2=RelativetoLow;3=Absolute
Defaultvalue:0
POWER_FLAG_B Short
Typeofpower:
Defaultvalue:0
TX_POWER_A Float Absolutetunedpower,notrelativetoequipmentmaximumpower
Defaultvalue:0
TX_POWER_B Float Absolutetunedpower,notrelativetoequipmentmaximumpower
Defaultvalue:0
AIR_LINK_RATE Float ValueofrateinMbps
Defaultvalue:100
CAPA_TECHNO Short
0=Fullpacket,1=Hybrid,2=TDMonly
Defaultvalue:0
NAME Text(20) Nameofthemedium
Defaultvalue:
Defaultvalue:50
IDENT Short
Defaultvalue:100
OTLINK
Text
(120)
Defaultvalue:50
FULL_NAME Text(50)
Stringdescribingthemode:displayedintheGUIwhereverthereisroom
forlongstrings(e.g.AdaptiveCodingModulation)
Defaultvalue:Mode
MODE_ID Integer Numberusedformanagingrelationshipsbetweenrelatedtables
Defaultvalue:
OPERATION_FLAG Short XORofsupportedmode(00=fix,01=withACM)
Defaultvalue:0
SHORT_NAME Text(10)
Stringdescribingthemode:usedfordistinguishingactivemodulations
inalink
Defaultvalue:Mode
471
MWOTLinksTable(New)
MWSubbandsTable
MWTplLinksTable
ACTIVE Boolean Flagtofilterlinks
Defaultvalue:True
COMMENT_
Text
(255)
Comment
Defaultvalue:
EPO_CLASS Text(50) EPOclass
Defaultvalue:
MEDIUM_TYPE Text(20) Mediumtype
Defaultvalue:
NAME
Text
(120)
Nameofthelink
Defaultvalue:
SITE_A Text(50) SiteA
Defaultvalue:
SITE_B Text(50) SiteB
Defaultvalue:
PREFIX_L Text(5) Prefixforformattingchannelinlowersubband
Defaultvalue:
PREFIX_U Text(5) Prefixforformattingchannelinuppersubband
Defaultvalue:
SUFFIX_L Text(5) Suffixforformattingchannelinlowersubband
Defaultvalue:
SUFFIX_U Text(5) Suffixforformattingchannelinuppersubband
Defaultvalue:
ACTIVE_MODULATIONS_A
Text
(100)
Listofmodulationsamongfamilyonesavailableforthatlink(null=All)
Defaultvalue:
ACTIVE_MODULATIONS_B
Text
(100)
Defaultvalue:
ANTENNA2_A Text(50) DiversityantennaonsiteA(antennausedforB>>A,whenAisreceiver)
Defaultvalue:
ANTENNA2_B Text(50) DiversityantennaonsiteB(antennausedforA>>B,whenBisreceiver)
Defaultvalue:
FREQ_SUBBAND Text(50) TypeofchannelisationwithintheselectedfrequencybandforA>>B
Defaultvalue:
FREQ_SUBBAND_B Text(50) TypeofchannelisationwithintheselectedfrequencybandforB>>A
Defaultvalue:
GEOCLIM_FACTOR Double GeoclimaticfactorusedforRecITU530
Defaultvalue:
POWER_FLAG_A Short
Typeofpower:
Defaultvalue:0
POWER_FLAG_B Short
Typeofpower:
Defaultvalue:0
SEPARATION_A Float Distancebetweenantennaanddiversityantenna(siteAreceiver)
Defaultvalue:0
SEPARATION_B Float Distancebetweenantennaanddiversityantenna(siteBreceiver)
Defaultvalue:0
Defaultvalue:0
472
SitesTable
MWLinksTable
USE_STD_POWER_A
USE_STD_POWER_B
MWMultiHopsLinksTable
ORDER_
SitesTable
SUPPORT_NATURE
21.2 CoordSysTable
For theprojection coordinate systemand thedatabases internalcoordinatesystem(thisis thedisplaycoordinatesystem
Defaultvalue:0
Defaultvalue:
CODE Integer
Defaultvalue:0
DATUM_CODE Double
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
ELLIPS_CODE Integer
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:0
473
21.4 MWAntennasTable
Formicrowaveantennas.
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
PROJ_METHOD Short
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:
Defaultvalue:0
Defaultvalue:
Defaultvalue:
DISPLAY_TYPE Integer 0:Free;1:Readonly
Defaultvalue:0
Defaultvalue:
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
DIAMETER Float Diameteroftheantenna
Defaultvalue:5
474
21.5 MWBandsTable
Formicrowavefrequencybands.
21.6 MWBranchingConfigsTable
Formicrowavebranchingconfigurations.
FREQ_BAND Text(50) Frequencybandoftheantenna
Defaultvalue:
GAIN Float Antennagain
Defaultvalue:10
MANUFACTURER Text(50) Manufactureroftheantenna
Defaultvalue:
NAME Text(50) Nameoftheantenna
Defaultvalue:
PATTERN Binary Antennapatterndiagrams
Defaultvalue:
RADOME_LOSS Float Radomelosstotakeintoaccountwhenradomesareusedonlinks
Defaultvalue:0
Theformatofthebinaryfield,PATTERN,isdescribedin"Microwave2DAntennaPattern
Format"onpage 115.
COMMENT_
Text
(255)
Comments
Defaultvalue:
FMAX Double Maximumfrequency
Defaultvalue:200
FMIN Double Minimumfrequency
Defaultvalue:100
Defaultvalue:
FREQ_DIVERSITY Boolean Flagtocheckifthisconfigurationsupportsfrequencydiversity
Defaultvalue:False
HSB Boolean Flagtocheckifthisconfigurationsupportshotstandby
Defaultvalue:False
LOS_MIMO Boolean FlagtodefineifthisconfigurationsupportsLOSMIMOantennas
Defaultvalue:False
NAME Text(50) Branchingconfigurationname
Defaultvalue:
NUM_RX_ANTENNAS Short Numberofreceivingantennas(forMIMO)
Defaultvalue:1
NUM_TX_ANTENNAS Short Numberoftransmittingantennas(forMIMO)
Defaultvalue:1
SPACE_DIVERSITY Boolean Flagtocheckifthisconfigurationsupportsspacediversity
Defaultvalue:False
SYSTEM_CONFIG_M Short Maximumnumberofstandbychannelswhichcanbebranched
Defaultvalue:0
SYSTEM_CONFIG_N Short Maximumnumberofmainchannelswhichcanbebranched
Defaultvalue:1
475
21.7 MWCapacitiesTable
Formicrowavedatarates.
21.8 MWCompatibilitiesTable
Forcompatibilitymappingbetweenequipmentandantennas.
21.9 MWCompatibilitiesGuidesTable
Forcompatibilitymappingbetweenwaveguidesandantennas.
XPIC Boolean Flagtocheckifthisconfigurationsupportscrosspolarcancellation
Defaultvalue:False
ACM_MODE Integer
Adaptivecodingmodulationtype:
0=none;1=Maximumsystemgain;2=MaximumThroughput
Defaultvalue:0
AIR_LINK_RATE Float Datarate
Defaultvalue:0
CAPA_TECHNO Short
Defaultvalue:0
FAMILY Text(50) Tablewhichdefinesthelistofmodulationssupportedbyeachfamily
Defaultvalue:
FREQ_BAND Text(50) Frequencybandvalue
Defaultvalue:
MODULATION Text(20) Modulationname
Defaultvalue:
NAME Text(50) Capacityname
Defaultvalue:
Defaultvalue:
ANTENNA Text(50) Nameoftheantenna
Defaultvalue:
CAPA_TECHNO Short
Defaultvalue:0
COMMENT_
Text
(255)
Comments
Defaultvalue:
EQUIPMENT Text(50) Nameoftheequipment
Defaultvalue:
ANTENNA Text(50) Nameoftheantenna
Defaultvalue:
COMMENT_
Text
(255)
Comments
Defaultvalue:
GUIDE Text(50) Nameofthewaveguide
Defaultvalue:
476
21.10 MWDefaultsCurvesTable
Fordefaultgraphsoftransmissionandreceptionmasks,etc.
21.11 MWEPOTable
Forqualityandavailabilityperformanceobjectives.
BANDWIDTH Float Channelbandwidth
Defaultvalue:0
CURVE_TYPE Short
Thetypeofcurve
Choicelist:0=TX_MASK;1=RX_MASK;2=TtoI;
Defaultvalue:0
FREQ_BAND Text(50) Frequencyband
Defaultvalue:
INTERFERED Text(50)
Defaultvalue:
MANUFACTURER Text(50) Manufacturer
Defaultvalue:
MODULATION Text(20) Modulationused
Defaultvalue:
NAME Text(50) Nameofthecurve
Defaultvalue:
RATE Float Rate(Mbps)
Defaultvalue:1
VALUES_ Memo Curvevalues
Defaultvalue:
A Double
ParameterusedtocalculatetheEPOrequired:
EPO=A*L+B
Defaultvalue:0
B Double
ParameterusedtocalculatetheEPOrequired:
EPO=A*L+B
Defaultvalue:0
COMMENT_
Text
(255)
Comments
Defaultvalue:
EPO_PARAM Text(5) Performanceobjectiveparameter(SESR,BBER,orESR)
Defaultvalue:
EPO_TYPE Text(1) Performanceobjectivetype(yAvailabilityorQuality)
Defaultvalue:
LINK_CLASS Text(50) EPOLinkclass
Defaultvalue:
MAXIMUM_LENGTH Double Maximumlengthoflinkrelatedtoanobjective(km)
Defaultvalue:0
MINIMUM_LENGTH Double Maximumlengthoflinkrelatedtoanobjective(km)
Defaultvalue:0
NAME Text(50) EPOname
Defaultvalue:
RATE_MAX Float Maximumbitrate(Mbps)
Defaultvalue:
RATE_MIN Float Minimumbitrate(Mbps)
Defaultvalue:
REC_UIT Float ITURecommendations
Defaultvalue:1
477
21.12 MWEPOLinkClassTable
ForEPOlinkclasses.
21.13 MWEquipmentsTable
Formicrowaveradios.
COMMENT_
Text
(255)
Comments
Defaultvalue:
LINK_CLASS Text(5) TypeofEPOlinkclass
Defaultvalue:
LINK_SUBCLASS Text(5) TypeofEPOlinksubclass
Defaultvalue:
LMAX Float MaximumlengthofthelinkfortheEPOclass
Defaultvalue:
LMIN Float MinimumlengthofthelinkfortheEPOclass
Defaultvalue:
NAME Text(50) NameoftheEPOclass
Defaultvalue:
ACM_MODE Integer
Optimisationmode:0=None;1=Maxsystemgain;2=Maxthroughput
gain;
Defaultvalue:0
CAPACITY Text(50) Equipmentcapacity
Defaultvalue:1
CHANNEL_SPACING Text(50)
Channelspacingdefinedbythemanufacturerforthiscapactiy/
modulation
Defaultvalue:
CI_MIN_BER3 Float MinimumC/IforBER=1e3
Defaultvalue:
CI_MIN_BER6 Float MinimumC/IforBER=1e6
Defaultvalue:
DFM Memo Dispersivefademargincurve
Defaultvalue:
EMISSION_DESIGNATOR Text(20) Normalizeddesignator
Defaultvalue:
FAMILY Text(50) Familyname
Defaultvalue:
FREQ_BAND Text(50) Frequencybandoftheequipment
Defaultvalue:
HSB_DELAY Float HotStandbycommutationdelaytime
Defaultvalue:0
IFM Float Marginagainstinterference
Defaultvalue:1
KN Float Knparameter
Defaultvalue:0
MIN_PHASE_SIG_DEPTH Memo Minimumsignaturedepth
Defaultvalue:'1e630
1e330'
MIN_PHASE_SIG_WIDTH Memo Minimumsignaturewidth
Defaultvalue:'1e610
1e310'
MODULATION Text(20) Modulationtype
Defaultvalue:16QAM
MTBF Float MeanTimeBeforeFailure
Defaultvalue:1000000
478
NAME Text(50) Nameoftheequipment
Defaultvalue:
NF Float NoiseFigureoftheequipment
Defaultvalue:5
NON_MIN_PHASE_SIG_DEPT
H
Memo Nonminimumsignaturedepth
Defaultvalue:'1e630
1e330'
NON_MIN_PHASE_SIG_WID
TH
Memo Nonminimumsignaturewidth
Defaultvalue:'1e610
1e310'
RX_LEVEL_REQUIRED Integer ValuewhichdefinestherequiredreceivedlevelforATPC
Defaultvalue:
RX_LOSS_PHYS Float Physicalreceiverloss
Defaultvalue:0
RX_OVERFLOW Memo CurvewhichdefinesthethresholdsmaxvalueforanyvalueofBER
Defaultvalue:'1e625
1e320'
RX_PORT_1 Float Receivinglossonportnumber1
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
RX_SELECTIVITY Memo Receiverfilterselectivity
Defaultvalue:
RX_SENSITIVITY Memo BERSensitivitytables
Defaultvalue:1e682
1e390
TI_CURVE Memo T/Icurve
Defaultvalue:
TX_LOSS_PHYS Float Physicaltransmitterloss
Defaultvalue:0
TX_MASK Memo Transmitterspectrummask
Defaultvalue:
TX_PORT_1 Float Transmissionlossonportnumber1
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
479
21.14 MWFamiliesTable
Formicrowaveradiofamilies.
21.15 MWFamilyBandsTable
Forfrequencybandssupportedbymicrowaveradiofamilies.
21.16 MWFamilyBrConfigsTable
Forbranchingconfigurationssupportedbymicrowaveradiofamilies.
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
WITH_EQUALIZER Boolean UsedtocalculateKn
Defaultvalue:False
XPIF Float CrosspolarInterferenceFactor
Defaultvalue:20
COMMENT_
Text
(255)
Comments
Defaultvalue:
MANUFACTURER Text(50) Manufacturername
Defaultvalue:
NAME Text(50) Familyname
Defaultvalue:
ACM_MODE Integer
gain;
Defaultvalue:0
Defaultvalue:
Defaultvalue:
BRANCHING_CONFIG Text(50) Branchingconfigurationname
Defaultvalue:
Defaultvalue:
Defaultvalue:
RX_BRLOSS Float Mainchannelreceptionloss
Defaultvalue:0
480
21.17 MWFamilyChSpacingsTable
Forchannelwidthssupportedbymicrowaveradiofamilies.
21.18 MWFamilyModulationsTable
Formodulationssupportedbymicrowaveradiofamilies.
21.19 MWFrequenciesTable
Formicrowavefrequencies.
RX_STANDBY_LOSS Float Standbychannelreceptionloss
Defaultvalue:0
TX_BRLOSS Float Transmissionloss
Defaultvalue:0
CHANNEL_SPACING Text(50) Channelspacingname
Defaultvalue:
Defaultvalue:
Defaultvalue:
XS Double ChannelspacinginMHz
Defaultvalue:7
ACM_MODE Integer
gain;
Defaultvalue:0
ATPC_MAX Float MaximumsupportedATPCvalue
Defaultvalue:
ATPC_STEP Float ATPCinterval
Defaultvalue:
DISCRETE_POWERS
Text
(255)
Allowedpowervalues
Defaultvalue:
Defaultvalue:
FREQ_BAND Text(50) Frequencybands
Defaultvalue:
LOW_POWER Float Lowpowervaluewhichcanbeusedinlinkproperties
Defaultvalue:
MAX_POWER Float Maximumpower
Defaultvalue:30
MODULATION Text(20) Modulation
Defaultvalue:
STD_POWER Float Standardpower
Defaultvalue:
CHANNEL_ID Integer IDofthechannel
Defaultvalue:1
CHANNEL_RADICAL Text(20) Radicalofthechannel.Subbandprefixandsuffixwillbeappended
Defaultvalue:
481
21.20 MWGuidesTable
Formicrowavewaveguides.
21.21 MWHubsTable
Formicrowavelinkhubs.
21.22 MWIrfsTable
Forinterferencereductionfactorspermicrowaveequipmentpairs.
FREQ_L Double Valueofthefrequency(MHz)inthelowerhalfband
Defaultvalue:
FREQ_U Double Valueofthefrequency(MHz)intheupperhalfband
Defaultvalue:
SUBBAND Text(50) Nameofaexistingsubbandtowhichthesefrequenciesarerelated
Defaultvalue:
FREQ_BAND Text(50) Frequencybandoftheguide
Defaultvalue:
GUIDE_TYPE Integer Typeofguide:0=Cable;1=Elliptic;2=Rectangular;3=Circular;4=Other;
Defaultvalue:0
LOSS_PER_METER Float Linearloss
Defaultvalue:7
MANUFACTURER Text(50) Guidemanufacturer
Defaultvalue:
NAME Text(50) Nameoftheguide
Defaultvalue:
ANTENNA Text(50) Nameofthe(shared)Antenna
Defaultvalue:
AZIMUTH Float AzimuthoftheAntenna
Defaultvalue:0
COMMENT_
Text
(255)
Comments
Defaultvalue:
DOWNTILT Float TiltoftheAntenna
Defaultvalue:0
FREQ_BAND Text(50) Nameofthefrequencyband
Defaultvalue:
HEIGHT Float HeightoftheAntenna
Defaultvalue:30
NAME Text(50) NameoftheHub
Defaultvalue:
PMP_TYPE Short TypeofthePMP:TDAorFDA
Defaultvalue:0
SITE Text(50) Nameofthesite
Defaultvalue:
INTERFERED Text(50) Interferedequipment
Defaultvalue:
482
21.23 MWLinksTable
Formicrowavelinks.
INTERFERER Text(50) Interfererequipment
Defaultvalue:
IRF Memo Listofinterferencefilteringprotections
Defaultvalue:
TheIRFfieldrepresentsalistofpairsofvalues.Eachpairconsistsof:
floatdeltaF:spacinginfrequency
floatprotection:protectionappliedtothisfrequency
ACTIVE Boolean Linkactiveornot
Defaultvalue:True
Text
(100)
ListofmodulationsusedatA
Defaultvalue:
Text
(100)
ListofmodulationsusedatB
Defaultvalue:
ANTENNA_A Text(50) MainantennaatsiteA
Defaultvalue:
ANTENNA_B Text(50) MainantennaatsiteB
Defaultvalue:
ANTENNA2_A Text(50) SecondaryantennaatsiteA
Defaultvalue:
ANTENNA2_B Text(50) SecondaryantennaatsiteB
Defaultvalue:
ATMOS_PRESSURE Float Atmosphericpressureinmbar
Defaultvalue:
ATPC_A Float ATPCatsiteA
Defaultvalue:0
ATPC_B Float ATPCatsiteB
Defaultvalue:0
AZIMUTH_A Float AzimuthatsiteA
Defaultvalue:0
AZIMUTH_B Float AzimuthatsiteB
Defaultvalue:0
BER Double BitErrorRate
Defaultvalue:1e3
BER2 Double SecondBitErrorRatio(i.e.1e6)
Defaultvalue:1e6
BRANCHING_CONFIG_A Text(50) BranchingconfigurationatA
Defaultvalue:
BRANCHING_CONFIG_B Text(50) BranchingconfigurationatB
Defaultvalue:
C_FACTOR Float VigantsBarnettmethod:Cfactor
Defaultvalue:1
CHANNELS_A Text(50) ChannelsusedatsiteA
Defaultvalue:
CHANNELS_B Text(50) ChannelsusedatsiteB
Defaultvalue:
CLIMATE_ZONE Short RainClimateZone
Defaultvalue:4
483
COMMENT_
Text
(255)
Comments
Defaultvalue:
DELTA_POW_A Float GainorlosstomaximumtransmitterpoweratA
Defaultvalue:0
DELTA_POW_B Float GainorlosstomaximumtransmitterpoweratB
Defaultvalue:0
DOWNTILT_A Float DowntiltatsiteA
Defaultvalue:0
DOWNTILT_B Float DowntiltatsiteB
Defaultvalue:0
DX_A Float XcoordinaterelativetothesiteAposition
Defaultvalue:0
DX_B Float XcoordinaterelativetothesiteBposition
Defaultvalue:0
DY_A Float YcoordinaterelativetothesiteAposition
Defaultvalue:0
DY_B Float YcoordinaterelativetothesiteBposition
Defaultvalue:0
ENVTYPE Integer Typeofenvironment
Defaultvalue:0
EPO_CLASS Text(50) EPOClassforthelink
Defaultvalue:
EQUIPMENT_A Text(50) EquipmentatsiteA
Defaultvalue:
EQUIPMENT_B Text(50) EquipmentatsiteB
Defaultvalue:
FREQ_A Double FrequencyatsiteA
Defaultvalue:1
FREQ_B Double FrequencyatsiteB
Defaultvalue:1
FREQ_BAND Text(50) Frequencybandofthelink
Defaultvalue:
FREQ_SUBBAND Text(50) Frequencysubbandofthelink(siteA)
Defaultvalue:
FREQ_SUBBAND_B Text(50) Frequencysubbandofthelink(siteB)
Defaultvalue:
GEOCLIM_FACTOR Double
Defaultvalue:
GUIDE_LG1 Float LengthofGUIDE1
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
GUIDE_USE1 Integer UseofGuide1onsiteA
Defaultvalue:0
GUIDE_USE2 Integer UseofGuide2onsiteB
Defaultvalue:1
Defaultvalue:0
Defaultvalue:1
484
GUIDE1 Text(50) WaveguidewhenAtransmitting
Defaultvalue:
GUIDE2 Text(50) WaveguidewhenBreceiving
Defaultvalue:
GUIDE3 Text(50) WaveguidewhenBtransmitting
Defaultvalue:
GUIDE4 Text(50) WaveguidewhenAreceiving
Defaultvalue:
HEIGHT_A Float HeightatsiteA
Defaultvalue:0
HEIGHT_B Float HeightatsiteB
Defaultvalue:0
KQ_FACTOR Float KQreliabilitymethod:KQFactor
Defaultvalue:
MTTR Float MinimumTimeToRepair
Defaultvalue:0
NAME
Text
(120)
Nameofthemicrowavelink
Defaultvalue:
PARITY_A Integer ParityofsiteA
Defaultvalue:0
PARITY_B Integer ParityofsiteB
Defaultvalue:0
PL Float
Defaultvalue:10
POLARIZATION_A Text(1) PolarizationatsiteA
Defaultvalue:V
POLARIZATION_B Text(1) PolarizationatsiteB
Defaultvalue:V
POWER_FLAG_A Short
Typeofpower:
Defaultvalue:0
POWER_FLAG_B Short
Typeofpower:
Defaultvalue:0
PROFILE Binary Linkprofile
Defaultvalue:
PROPAG_IMODEL Text(50) Propagationmodelusedforinterferencecalculation
Defaultvalue:
PROPAG_MODEL Text(50) Propagationmodel
Defaultvalue:
R001 Float Rainintensityexceededfor0.01%oftime(mm/hr)
Defaultvalue:
RADOME_ON_A Boolean RadomeusedonthefirstantennaatA
Defaultvalue:False
RADOME_ON_B Boolean RadomeusedonthefirstantennaatB
Defaultvalue:False
RADOME2_ON_A Boolean RadomeusedonthesecondantennaatA
Defaultvalue:False
RADOME2_ON_B Boolean RadomeusedonthesecondantennaatB
Defaultvalue:False
RAIN_HEIGHT Float
Defaultvalue:
RAIN_ZONE Short Rainzone
Defaultvalue:4
REFRACTIVITY Float
Defaultvalue:
485
21.24 MWLinkTypesTable
Fortypesofmicrowavelinktrunks.
REFRACTIVITY_KE Float Nunits/km
Defaultvalue:
REPEATER1 Text(50) Firstrepeater(P)
Defaultvalue:
REPEATER2 Text(50) Secondrepeater(Q)
Defaultvalue:
RXLOSS_ATT_A Float ReceptionlossesduetoattenuatorsatA
Defaultvalue:0
RXLOSS_ATT_B Float ReceptionlossesduetoattenuatorsatB
Defaultvalue:0
SEPARATION_A Float DiversityseparationatsiteA
Defaultvalue:0
SEPARATION_B Float DiversityseparationatsiteB
Defaultvalue:0
SHIELDING_FACTOR_A Float
Additionallossduetoanaturalorartificialobstacleinthevicinityofthe
antennaA
Defaultvalue:0
SHIELDING_FACTOR_B Float
Additionallossduetoanaturalorartificialobstacleinthevicinityofthe
antennaB
Defaultvalue:0
SITE_A Text(50) Siteofdeparture(A)
Defaultvalue:
SITE_B Text(50) Siteofarrival(B)
Defaultvalue:
TEMPERATURE Float Temperature
Defaultvalue:
TERRAIN_TYPE Integer Terraintype(Vigants)
Defaultvalue:0
Nullcolumnallowed:
Defaultvalue:0
Nullcolumnallowed:
Defaultvalue:0
TXLOSS_ATT_A Float TransmissionlossesduetoattenuatorsatA
Defaultvalue:0
TXLOSS_ATT_B Float TransmissionlossesduetoattenuatorsatB
Defaultvalue:0
TXLOSS_BRANCHING_A Float TransmissionlossesduetoconnectorsandbranchingatA
Defaultvalue:0
TXLOSS_BRANCHING_B Float TransmissionlossesduetoconnectorsandbranchingatB
Defaultvalue:0
VAPOR Float Vapourdensity(g/cu.m)
Defaultvalue:
BER_SES Double BERses
Defaultvalue:0
BLOCK_SIZE Integer Sizeoftransmittedblocks(numberofbitsperblock)
Defaultvalue:2000
NAME Text(50) Nameofthelinktype
Defaultvalue:
RATE Float Maximumbitrate(Mbps)
Defaultvalue:2
486
21.25 MWManufacturersTable
Formicrowaveequipmentmanufacturers.
21.26 MWMediumTypesTable
Formediumtypes.
21.27 MWModulationsTable
Formodulations.
21.28 MWMultiHopsTable
Formultihoplinks.
SUP_RATE Float Supportedbitrate(Mbps)
Defaultvalue:2
TYPE Short Trunktype:0=PDH;1=SDH;2=IP;
Defaultvalue:0
COMMENT_
Text
(255)
Comments
Defaultvalue:
NAME Text(50) Nameofthemanufacturer
Defaultvalue:
AIR_LINK_RATE Float ValueofrateinMbps
Defaultvalue:100
CAPA_TECHNO Short
0=Fullpacket,1=Hybrid,2=TDMonly
Defaultvalue:0
NAME Text(20) Nameofthemedium
Defaultvalue:
Defaultvalue:50
EB_N0 Memo Eb/Nograph
Defaultvalue:
FULL_NAME
Text
(255)
Comments
Defaultvalue:
NAME Text(20) Modulation
Defaultvalue:
NSTATES Integer Numberofmodulationstates
Defaultvalue:16
COMMENT_
Text
(255)
Comments
Defaultvalue:
EPO_CLASS Text(50) NameoftheEPOclass
Defaultvalue:
NAME Text(50) Nameofthemultihoplink
Defaultvalue:
487
21.29 MWMultiHopsLinksTable
Formicrowavelinksbelongingtomultihops.
21.30 MWOperatingModesTable
21.31 MWOTLinksTable
21.32 MWPMPTable
Formicrowavelinksandhubsbelongingtoapointtomultipointgroup.
IDENT Short
Defaultvalue:100
LINK
Text
(120)
Nameofthelinkbelongingtothemultihop
Defaultvalue:
MULTI_HOP Text(50) Nameofthemultihoplink
Defaultvalue:
OTLINK
Text
(120)
Defaultvalue:50
FULL_NAME Text(50)
Stringdescribingthemode:displayedintheGUIwhereverthereisroom
forlongstrings(e.g.AdaptiveCodingModulation)
Defaultvalue:Mode
MODE_ID Integer Numberusedformanagingrelationshipsbetweenrelatedtables
Defaultvalue:
OPERATION_FLAG Short XORofsupportedmode(00=fix,01=withACM)
Defaultvalue:0
SHORT_NAME Text(10)
Stringdescribingthemode:usedfordistinguishingactivemodulations
inalink
Defaultvalue:Mode
ACTIVE Boolean Flagtofilterlinks
Nullcolumnallowed:
Defaultvalue:True
COMMENT_
Text
(255)
Comment
Defaultvalue:
EPO_CLASS Text(50)
Defaultvalue:
MEDIUM_TYPE Text(20)
Defaultvalue:
NAME
Text
(120)
Defaultvalue:
SITE_A Text(50)
Defaultvalue:
SITE_B Text(50)
Defaultvalue:
HUB Text(50) Nameofthehub
Defaultvalue:
LINK
Text
(120)
Nameofthelink
Defaultvalue:
488
21.33 MWPortsTable
Formicrowaveports.
21.34 MWRepeatersTable
Formicrowaverepeaters.
CHANNEL Short ChannelNumber
Defaultvalue:0
LINK
Text
(120)
Nameofthelink
Defaultvalue:
POLARIZATION Text(1) Signalpolarizationofthischannel
Defaultvalue:H
RX_ATTENUATION Float Rxattenuationlossforthischannel
Defaultvalue:1
RX_PORT Short
NumberoftheportontheRXequipmentwherethechannelis
connected
Defaultvalue:1
STATUS Short Statusofthemicrowaveport(0=main,1=standby,or2=diversity)
Defaultvalue:0
TX_ATTENUATION Float Txattenuationlossforthischannel
Defaultvalue:0
TX_PORT Short
NumberoftheportontheTXequipmentwherethechannelis
connected
Defaultvalue:1
WAY Short WayofthelinkABorBA
Defaultvalue:0
ANTENNA Text(50) Repeaterantenna
Defaultvalue:
ANTENNA_2 Text(50)
UsediftypeisBacktoBackAntenna(fromtheantennatable)(pointto
B)
Defaultvalue:
AZIMUTH_A Float AzimuthoftherepeaterinthedirectionofA
Defaultvalue:0
AZIMUTH_B Float AzimuthoftherepeaterinthedirectionofB
Defaultvalue:0
DX Float Xcoordinaterelativetositeposition
Defaultvalue:0
DY Float Ycoordinaterelativetositeposition
Defaultvalue:0
FREQ_BAND Text(50) Frequencybandoftherepeater
Defaultvalue:
GUIDE Text(50) UsediftypeisBacktoBackAntenna(fromtheguidetable)
Defaultvalue:
HEIGHT Float Heightoftherepeater
Defaultvalue:30
HEIGHT_2 Float Height(pointedtoB)
Defaultvalue:30
LG_GUIDE Float Guidelength
Defaultvalue:0
NAME Text(50) Nameoftherepeater
Defaultvalue:
REPEATER_TYPE Short Typeoftherepeater(ReflectororBacktobackantennas)
Defaultvalue:0
(Reflector)
489
21.35 MWSubbandsTable
Formicrowavefrequencysubbands.
21.36 MWTplLinksTable
Formicrowavelinktemplates.
REVERSE_POLAR Boolean
Iftrue,txpolarizationfromPtoBisnotthesameasfromAtoP(and
resp,B>PisdifferenttoP>A)
Defaultvalue:False
SITE Text(50) Nameoftherepeaterssite
Defaultvalue:
SURFACE Float Repeatersurfacearea(sq.m)
Defaultvalue:5
TILT_A Float TiltoftherepeaterantennainthedirectionofA
Defaultvalue:
TILT_B Float TiltoftherepeaterantennainthedirectionofB
Defaultvalue:
EXCLUDE_L
Text
(250)
Excludedchannelsinthelowerhalfband
Defaultvalue:
EXCLUDE_U
Text
(250)
Excludedchannelsintheupperhalfband
Defaultvalue:
F0 Double Centralfrequency
Defaultvalue:4700
Defaultvalue:
KL Double Lowerhalfbandshift
Defaultvalue:310
KU Double Upperhalfbandshift
Defaultvalue:2
N_MAX Integer Lastchannelnumber
Defaultvalue:10
N_MIN Integer Firstchannelnumber
Defaultvalue:1
NAME Text(50) Nameofthesubband
Defaultvalue:
PREFIX_L Text(5) Prefixforformattingchannelinlowersubband
Defaultvalue:
PREFIX_U Text(5) Prefixforformattingchannelinuppersubband
Defaultvalue:
REC_UIT
Text
(255)
ITURecommendations
Defaultvalue:
STEP Integer Stepsizebetweenfirstandlastchannelnumber
Defaultvalue:1
SUFFIX_L Text(5) Suffixforformattingchannelinlowersubband
Defaultvalue:
SUFFIX_U Text(5) Suffixforformattingchannelinuppersubband
Defaultvalue:
XS Double Interchannelspace
Defaultvalue:28
490
Text
(100)
Defaultvalue:
Text
(100)
Defaultvalue:
ANTENNA_A Text(50) MainantennaatsiteA
Defaultvalue:
ANTENNA_B Text(50) MainantennaatsiteB
Defaultvalue:
ANTENNA2_A Text(50) DiversityantennaonsiteA(antennausedforB>>A,whenAisreceiver)
Defaultvalue:
ANTENNA2_B Text(50) DiversityantennaonsiteB(antennausedforA>>B,whenBisreceiver)
Defaultvalue:
ATMOS_PRESSURE Float Atmosphericpressureinmbar
Defaultvalue:
BER Double BitErrorRate
Defaultvalue:1e3
BER2 Double SecondBitErrorRatio(i.e.1e6)
Defaultvalue:1e6
BRANCHING_CONFIG_A Text(50) BranchingconfigurationatA
Defaultvalue:
BRANCHING_CONFIG_B Text(50) BranchingconfigurationatB
Defaultvalue:
C_FACTOR Float VigantsBarnettmethod:Cfactor
Defaultvalue:1
CLIMATE_ZONE Short RainClimateZone
Defaultvalue:4
ENVTYPE Integer Typeofenvironment
Defaultvalue:0
EPO_CLASS Text(50) EPOClassforthelink
Defaultvalue:
EQUIPMENT_A Text(50) EquipmentatsiteA
Defaultvalue:
EQUIPMENT_B Text(50) EquipmentatsiteB
Defaultvalue:
FREQ_BAND Text(50) Frequencybandofthelink
Defaultvalue:
FREQ_SUBBAND Text(50) TypeofchannelisationwithintheselectedfrequencybandforA>>B
Defaultvalue:
FREQ_SUBBAND_B Text(50) TypeofchannelisationwithintheselectedfrequencybandforB>>A
Defaultvalue:
GEOCLIM_FACTOR Double GeoclimaticfactorusedforRecITU530
Defaultvalue:
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:1
491
Defaultvalue:0
Defaultvalue:1
GUIDE1 Text(50) WaveguidewhenAtransmitting
Defaultvalue:
GUIDE2 Text(50) WaveguidewhenBreceiving
Defaultvalue:
GUIDE3 Text(50) WaveguidewhenBtransmitting
Defaultvalue:
GUIDE4 Text(50) WaveguidewhenAreceiving
Defaultvalue:
HEIGHT_A Float HeightatsiteA
Defaultvalue:0
HEIGHT_B Float HeightatsiteB
Defaultvalue:0
KQ_FACTOR Float KQreliabilitymethod:KQFactor
Defaultvalue:
MTTR Float MinimumTimeToRepair
Defaultvalue:0
NAME
Text
(120)
Nameofthemicrowavelinktemplate
Defaultvalue:
PL Float
Defaultvalue:10
POLARIZATION_A Text(1)
Polarisationofthedescendinglink'siteAsiteB'(thesiteAandsiteB
arerespectivelytransmitterandreceiver)
Defaultvalue:V
POLARIZATION_B Text(1)
Polarisationoftheascendinglink'siteAsiteB'(thesiteAandsiteBare
respectivelyreceiverandtransmitter)
Defaultvalue:V
POWER_FLAG_A Short
Typeofpower:
Defaultvalue:0
POWER_FLAG_B Short
Typeofpower:
Defaultvalue:0
PROPAG_IMODEL Text(50) Propagationmodelusedforinterferencecalculation
Defaultvalue:
PROPAG_MODEL Text(50) Propagationmodel
Defaultvalue:
R001 Float Rainintensityexceededfor0.01%oftime(mm/hr)
Defaultvalue:
RAIN_HEIGHT Float
Defaultvalue:
RAIN_ZONE Short Rainzone
Defaultvalue:4
REFRACTIVITY Float
Defaultvalue:
REFRACTIVITY_KE Float Nunits/km
Defaultvalue:
RXLOSS_ATT_A Float ReceptionlossesduetoattenuatorsatA
Defaultvalue:0
RXLOSS_ATT_B Float ReceptionlossesduetoattenuatorsatB
Defaultvalue:0
SEPARATION_A Float Distancebetweenantennaanddiversityantenna(siteAreceiver)
Defaultvalue:0
SEPARATION_B Float Distancebetweenantennaanddiversityantenna(siteBreceiver)
Defaultvalue:0
492
21.37 NetworksTable
TEMPERATURE Float Temperature
Defaultvalue:
TERRAIN_TYPE Integer Terraintype(Vigants)
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
TXLOSS_ATT_A Float TransmissionlossesduetoattenuatorsatA
Defaultvalue:0
TXLOSS_ATT_B Float TransmissionlossesduetoattenuatorsatB
Defaultvalue:0
TXLOSS_BRANCHING_A Float TransmissionlossesduetoconnectorsandbranchingatA
Defaultvalue:0
TXLOSS_BRANCHING_B Float TransmissionlossesduetoconnectorsandbranchingatB
Defaultvalue:0
VAPOR Float Vapourdensity(g/cu.m)
Defaultvalue:
Defaultvalue:50
Defaultvalue:1
NAME Text(50)
Defaultvalue:
Text
(255)
Defaultvalue:
Defaultvalue:MW
Defaultvalue:FWA
Defaultvalue:
Description
Text
(255)
Userdefined
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
493
21.39 SitesTable
Forsites.
21.42 UnitsTable
ALTITUDE Float
Realaltitude
Unit:m
Defaultvalue:0
COMMENT_
Text
(255)
Defaultvalue:0
Defaultvalue:0
Defaultvalue:0
Defaultvalue:
Defaultvalue:50
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:
Defaultvalue:1
GAIN_UNIT Integer
Defaultvalue:0
Defaultvalue:1
Defaultvalue:0
Defaultvalue:0
494
AT320_AM_E2 Forsk2013
495
AT320_AM_E2 www.forsk.com July2013
HeadOffice
7ruedesBriquetiers
31700Blagnac,France
Tel:+33562747210
Fax:+33562747211
USOffice
200SouthWackerDriveSuite3100
Chicago,IL60606,USA
Tel:+13126744800
Fax:+13126744847
ChinaOffice
Suite302,3/F,WestTower,JiaduCommercialBuilding,
No.66JianzhongRoad,TianheHiTechIndustrialZone,
Guangzhou,510665,P.R.ofChina
Tel:+862085538938 Fax:+862085538285

Atoll 3.2.0 Administrator Manual

Uploaded by

Document Information

Original Description:

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Atoll 3.2.0 Administrator Manual

Uploaded by

Copyright:

Available Formats

Version3.2.

You might also like