Beruflich Dokumente
Kultur Dokumente
Synchronization
Guide
Version 3.8
www.actix.com
Documentation Version: R-Asset-v3.8, October 2007
The content of this manual is provided for information only, is subject to change without notice,
and should not be construed as a commitment by Actix. Actix assumes no responsibility or liability
for any errors or inaccuracies that appear in this documentation.
Trademark Notice
Radioplan is a registered trademark of Actix GmbH in the European Union.
Actix and the Actix logo are trademarks of Actix Ltd.
All other product or brand names are trademarks or registered trademarks of their respective
holders.
Contact:
Actix GmbH Actix Ltd
Altmarkt 10 200, Hammersmith Road
D-01067 Dresden Hammersmith
Germany London, W6 7DL
tel.: +49 (0) 351 404 29 – 0 United Kingdom
fax: +49 (0) 351 404 29 – 50 www.actix.com
e-mail: sales@actix.com
www.actix.com
www.actix.com
Contents
1 INTRODUCTION .........................................................................................5
www.actix.com
5.2 DATA EXPORT TO ASSET ..................................................................................26
5.2.1 XML File Changes When Exporting the Network Configuration ....................26
5.2.2 Asset Prediction File Changes When Exporting Tuned Radioplan
Predictions..........................................................................................27
5.3 DEFAULT OPTIMIZATION SETTINGS ......................................................................28
5.4 CONFIGURATION FILE ASSETIMPORTMODULE.INI .........................................................29
5.5 CONFIGURATION FILE ANTENNAGROUPS.INI ..............................................................35
6 ABBREVIATIONS ...................................................................................... 37
7 REFERENCES .......................................................................................... 37
www.actix.com
Actix Radioplan Asset Synchronization Guide Introduction 5
1 Introduction
This document describes the Asset (Import and) Synchronization Module, the part of the
Actix Radioplan software for the automated data exchange with the Asset3G Radio
Planning Tool (a part of the ENTERPRISE suite by Aircom International,
www.aircominternational.com).
It includes the following processes:
• Import creates a new Radioplan project from a set of Asset XML files, map data
and predictions (see chapter 2);
the supported Asset file formats are described in chapter 4;
• Export modifies a set of Asset XML files with Radioplan data or modifies Asset
predictions by tuned Radioplan pathloss data (see chapter 3).
A reference of the Asset Synchronization main functions, configuration, and customization
options is provided in chapter 5. Moreover, a detailed tabular overview of the imported
parameters and their mapping to Radioplan parameters is provided in the Annex
“Parameter mapping during project data import”.
www.actix.com
Actix Radioplan Asset Synchronization Guide Introduction 6
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Import Process 7
• traffic data
• pathloss predictions
• Project name (optional): The name for the newly imported project.
The project name can also be modified in the readily imported Radioplan project.
• Asset XML index file: The index XML file (typically INDEX001.xml) must be
specified, which references further XML files containing the network configuration
data including antennas, sites, cells etc. and their properties (refer to chapter 4).
• Loss calculation: If the respective boxes are checked, the XML index file shall
also reference a feeder list XML file (typically FEEDER-LIST001.xml) and a GSM-
specific cell equipment list XML file (typically CELL-EQUIP-LIST001.xml),
respectively.
The contained information on feeder- and equipment-specific losses will be used to
calculate the Cable Losses of the corresponding cells in the Radioplan project (refer
to section 5.1.6).
• DTM index: The index.txt file for the heights (i.e. Digital Terrain Model (DTM))
data files.
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Import Process 8
• Clutter index (optional): The index.txt file for the clutter data files.
• Pathloss folder: The directory that contains the pathloss prediction files (may be
in subdirectories).
It is only required if the Asset XML files do not reference the prediction filenames
including the complete absolute pathname.
Therefore, when importing Asset 6.0 XML data, the Pathloss folder is mandatory.
(See also sections 4.14 and 5.1.10 for more information.)
• Import only this pathloss resolution: The user can define which pathloss
resolution should be used during the import if pathloss files with different
resolutions are available.
• Filter Polygon (optional): By selecting a filter polygon, the user can restrict the
amount of imported data. Cell data and matrices are only loaded if they are
located inside the selected polygon.
If the user does not select a filter polygon, a rectangle surrounding the site
locations by 10km is chosen by default.
The entries in the Import Asset Project dialog can be pre-configured in the
assetimportmodule.ini configuration file (refer to section 5.4).
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Import Process 9
After clicking OK in the Import Asset Project dialog, the Coordinate Systems dialog is
shown, which shall be used to select valid projection and display coordinate systems,
Fig. 2-2.
The Projection Coordinate System is the one used for the internal representation of the
project. All raster data loaded during the import process (e.g. DEM matrices) are assumed
to be in these projection coordinates. The display coordinate system might be needed if
the site locations are given in a different coordinate system.
Both coordinate systems can be pre-configured in the assetimportmodule.ini
configuration file (refer to section 5.4). If non-zero EPSG identifiers are specified there, the
Coordinate Systems dialog can also be suppressed by a further assetimportmodule.ini
parameter.
In the Radioplan user interface, the Coordinate Systems can be also inspected by the
menu entry View Æ Projection… .
After clicking OK in the Coordinate Systems dialog, the specified Asset data is imported
into Radioplan as a new project.
The main steps of this process are logged in the Messages tab of the Radioplan Message
window.
As the result, the new Actix Radioplan project is opened and can then be used for
comparing and synchronizing the network setup with drive test measurements including
pathloss tuning as well as for automated network optimization.
For more information, please refer to [R-UG] as well as to the Actix Radioplan
Measurement Module [R-Meas] and the Actix Radioplan ACP [R-ACP].
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Import Process 10
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Export Process 11
• the network configuration, which may have been modified as a result of network
optimization using the Radioplan ACP;
• the tuned pathloss data, which may result from pathloss tuning in Radioplan.
Figure 3-1 Export Asset Project dialog: XML index file selection
The original XML files will be saved as with additional extension “.bak”. If such backup files
already exist, the new, updated files will be saved with additional extension “.new” and a
warning message is displayed in the Radioplan message window.
With the option “Partial XML export” only those parameters will be exported into Asset XML
files that really have changed. This export compares the original XML files with the
Radioplan project and exports only the changed parameters to new Asset XML files.
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Export Process 12
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Export Process 13
There are two options, how to determine the Asset pathloss files.
The option to Update only imported unmasked files is subject to the following conditions:
• The directory that contains the unmasked Asset prediction files is specified in the
Asset Pathloss Folder field in this dialog.
• The mapping of the Radioplan pathloss matrices to the Asset prediction files is
based on the Asset prediction filenames, which are stored as Custom Parameters
in the respective Radioplan cells as a result of the Asset Import Process.
Thereby, any files with masked predictions for the same cells are neither modified nor
deleted.
The option to Determine files from XML is subject to the following condition.
• Like for the Asset Import Process, the XML files are needed. The entire set of XML
files is referenced by the Asset XML index file (typically INDEX001.xml) (see also
section 2.2). It must be selected in the box below the option.
• The mapping of the Radioplan pathloss matrices to the Asset prediction files is
based on the cell names in Radioplan and in the Asset XML files as well as on the
prediction folder name defined in the Asset XML files.
Note that the cell names in projects of different systems (e.g. GSM and UMTS)
might differ, leading to the fact that cross-technology updates might fail.
• If a directory is specified in the Asset Pathloss Folder field, any prediction folder
name defined in the Asset XML files is ignored and the Asset prediction files to be
updated (or deleted) are searched in the given directory.
Thereby, the corresponding unmasked predictions are updated and all masked predictions
are deleted.
By clicking OK in the Export Tuned Pathloss Predictions dialog, eventually after browsing
and matching the prediction files, the Tune Asset Predictions dialog is opened, Figure 3-5.
www.actix.com
Actix Radioplan Asset Synchronization Guide Asset Export Process 14
It lists all identified actions based on the defined settings – associated with the information
described in Table 3-1.
www.actix.com
Actix Radioplan Asset Synchronization Guide File Format Specifications 15
The XML export from Asset can be done by the following steps:
In the Prediction tab of the opened … Options dialog, the option Export
Prediction Filenames shall be enabled, e.g. Fig. 4-1 for UMTS.
Thus, the exported XML files will reference the prediction files that
correspond to the contained cells.
Fig. 4-1 Export Prediction Filenames option in the UMTS Cell Options dialog
www.actix.com
Actix Radioplan Asset Synchronization Guide File Format Specifications 16
It contains the geographic information of the sites, coordinates of the site locations, and
the their height above ground.
www.actix.com
Actix Radioplan Asset Synchronization Guide File Format Specifications 17
Whether to import it or not, can be specified in the Import Asset Project dialog (refer to
section 2.2).
It contains the assignment of cells to sites as well as cell antenna parameters (orientation,
tilt) and further GSM parameters.
It contains the assignment of transmitters to sites including the Node B key as well as
transmitter information like antenna coordinates, height, azimuth, downtilt, and antenna
type.
www.actix.com
Actix Radioplan Asset Synchronization Guide File Format Specifications 18
It contains the assignment of cells to transmitters as well as the power values, MHA use,
feeder attenuations for DL and UL of a cell and further UTRAN parameters like SC, carrier
etc.
Whether to import it or not, can be specified in the Import Asset Project dialog (refer to
section 2.2).
www.actix.com
Actix Radioplan Asset Synchronization Guide File Format Specifications 19
• a version tag: “Traffic File V2” and “Traffic File V3” are supported;
If the prediction filenames are referenced in the exported Asset XML data, then the
Radioplan Asset import can directly identify the according pathloss file for each cell.
Especially in case of an Asset pathloss directory with e.g. thousands of pathloss files this is
very important for a the speed of the import.
www.actix.com
Actix Radioplan Asset Synchronization Guide File Format Specifications 20
Alternatively (but not recommended), the Radioplan Asset import can try to automatically
detect the prediction files corresponding to the cells in the exported Asset XML data
according to the following rules:
• The import of pathloss files starts with the preferred format, unmasked or masked,
(as defined in the AssetImportModule.ini configuration file) and with the highest
possible resolution (smallest pixel size).
In this option, Radioplan has to read the header of all pathloss files located in the Pathloss
directory. Since this can be very time-consuming and the system may find a lot of obsolete
matrices, it is not recommend to use this option.
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 21
• Otherwise, i.e. if no or zero EPSG identifiers are defined in the configuration file,
the coordinate systems are taken from the Coordinate Systems dialog in the
import process (refer to section 2.2).
For more information on coordinate systems in Radioplan, please refer to [R-UG].
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 22
HCS:
Table 5-1 Mapping examples for Asset antenna pattern names to Radioplan antenna families
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 23
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 24
In any case, if one type of prediction is not available for a cell, the other type is still
imported as an alternative.
Pathloss data from Asset 6 can also be imported through an Asset API. That requires the
installation of an additional DLL by Aircom International Ltd. (Please contact
support.dresden@actix.com for further information.)
When importing Asset 6 pathloss data using the Asset interface for accessing the
predictions, the following rules apply:
• The Pathloss folder must have been specified in the Import Asset Project dialog,
even if the prediction filenames are contained in the exported Asset XML files. The
reason is that the XML files do not contain the complete absolute pathname of the
prediction files.
• For either prediction type, unmasked or masked, if a correction pathloss file *.plc
is available, this file is imported. Otherwise, the corresponding *.pl pathloss file is
imported.
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 25
• Otherwise, if a menu.txt file is available in the folder of the clutter index.txt file,
i.e. the clutter class names are taken from that file.
Clutter class codes from 0 to 255 are supported. Any value higher than 255 is set to 255.
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 26
• Azimuth
• (Mechanical) Tilt
If the XML file set is different from the one used for the
Asset import process, the results are undefined.
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 27
• The pathloss data is weighted over the horizontal angle in relation to the main
beam of the antenna. The angular weighting function is illustrated in Figure 5-1.
• If not all cells’ pathloss matrices at the site are tuned, then also the untuned
Radioplan pathloss matrices of the other cells are considered.
• Areas where the Radioplan pathloss matrices are not defined (e.g. due to clipping)
are set to “nodata”.
1.2
1+cos(Δ) 1
0.8
Weighting Factor
0.6
0.4
0.2
0
-200 -150 -100 -50 0 50 100 150 200
Angle [deg]
With Asset 6, an API provides other applications access to the Asset pathloss predictions.
That requires the installation of an additional DLL by Aircom International Ltd.
If tuned Radioplan predictions are exported based on that, the *.plc files of the
corresponding unmasked Asset predictions are overwritten.
Thus, the tuned predictions are also made available in Asset.
Please contact support.dresden@actix.com for further information.
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 28
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 29
Parameter Description
[GENERAL]
Customer Identifier for a customized version of the
assetimportmodule.ini file. Default is “generic”.
DefaultProjectName The default project name to be displayed in the
Import Asset Project dialog.
DefaultDtmIndexFile
The default paths for the DEM/DTM matrix, the
DefaultClutterIndexFile clutter matrix, the pathloss folder, and the traffic
DefaultPathlossFolder matrix to be displayed in the Import Asset Project
dialog.
DefaultTrafficFile
allowFeederImport The default settings for enabling the Feeder List and
Cell equipment List import for the Loss Calculation,
allowCellEquipmentImport
respectively, to be displayed in the Import Asset
Project dialog.
SimulationAreaBorder If no Filter Polygon is specified in the Import Asset
Project dialog, the Simulation Area of the imported
project is defined as a rectangle with a certain
distance around all imported sites. This distance in
[meter] can be specified by the
SimulationAreaBorder. The default is 10000 m.
[GENERAL]
Customer = "generic"
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 30
Parameter Description
[CoordinateSystems]
The available EPSG coordinate systems are defined in the wkt.ini in the
\configuration\coordinatesystems subdirectory of the Radioplan configuration
folder (refer to section 5.4).
DefaultProjection_EPSG The EPSG identifier for the default projection
coordinate system.
If not defined or set to 0, the user must select the
appropriate coordinate system in the Coordinate
System dialog of the Asset Import Process.
DefaultDisplay_EPSG The EPSG identifier for the default display
coordinate system.
If not defined or set to 0, the user may select the
appropriate coordinate system in the Coordinate
System dialog of the Asset Import Process.
ShowCoordinateSystemDialog The Coordinate Systems dialog is only shown after
confirming the Import Asset Project dialog if:
- ShowCoordinateSystemDialog is set to 1
or
- either DefaultProjection_EPSG or
DefaultDisplay_EPSG is not defined or set to
zero.
Otherwise, the Coordinate Systems dialog is
suppressed.
[CoordinateSystems]
; EPSG value of the preset projection coordinate system
DefaultProjection_EPSG = 0
; Allow the user to modify coordinate systems during project import or update
ShowCoordinateSystemDialog = 1
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 31
Parameter Description
[Pathloss]
PreferMaskedPredictions If set to 1, the import of masked predictions (i.e.
including the antenna pattern influence) is
preferred.
Otherwise, the import of unmasked predictions
(i.e. as for an isotropic antenna) is preferred.
If not defined, 0 is applied as default.
FilterByModelID If set to 1, then, in the absence of the prediction
filenames in the XML files, the import function tries
to assign the pathloss to the corresponding cells
based on the propagation models.
However, it is highly recommended to export the
XML files including the prediction filenames.
If not defined, 0 is applied as default.
UseOnlySmallestResolution If set to 1, then, if the XML files contain prediction
lists with possibly several different pixel
resolutions, only referenced predictions with the
smallest resolution are imported.
If not defined, 0 is applied as default.
ForcePredictionList If set to 1, the import of the XML files is aborted, if
they do not contain prediction lists.
If not defined, 0 is applied as default.
UsePathlossResolution The default settings for the Import only this
pathloss resolution option – to be displayed in the
Import Asset Project dialog.
If UsePathlossResolution is set to 1, then only the
PathlossResolution
predictions with the pixel size defined by
PathlossResolution [in meter] are imported.
If not defined, 0 is applied as default.
AllowTunedMatrixExport If set to 1, the export of tuned unmasked pathloss
matrices and thereby the removal of existing
masked predictions is enabled.
If not defined, 0 is applied as default.
[Pathloss]
;; 0 or 1; defaults to 0
;; if the value is 0 unmasked predictions are preferred
PreferMaskedPredictions = 0
;; 0 or 1; defaults to 1
;; (Try to) load pathloss by model
;; This option is only used if XML does not contain prediction lists
FilterByModelID = 1
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 32
ForcePredictionList = 0
Parameter Description
[ClutterClasses]
The order of the listed parameters is not important.
If this section is empty, the import process try to load clutter classes from a menu
file.
class<n>_name The name of clutter class <n>.
class<n>_db The Pathloss offset for clutter class <n>.
[ClutterClasses]
;; clutter classes and clutter specific pathloss offsets.
;; The order is not important.
;; If this section is empty the import and update processes
;; try to load clutter classes from a menu file.
;class1_name = High Density Urban
;class2_name = Commercial / Industrial
;class3_name = Residential with Trees
;class4_name = Residential with Few Trees
;class6_name = Grass / Agriculture
;class7_name = Open
;class8_name = Seawater
;class9_name = Transportation
;class10_name = Airport
;class13_name = Forested / Dense Vegetation
;class14_name = Marsh / Wetland
;class15_name = Water
;class1_db = 25
;class2_db = 15
;class3_db = 22
;class4_db = 18
;class6_db = 10
;class7_db = 7
;class8_db = 0
;class9_db = 5
;class10_db = 25
;class13_db = 15
;class14_db = 10
;class15_db = 0
Parameter Description
[AntennaGroups]
This parameter group allows an automatic definition of alternative antenna groups
for antenna type optimization.
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 33
Parameter Description
CreateAutomaticAntennaGroups If set to 1, antenna groups are defined
automatically during import based on the
definitions in the AntennaGroups.ini file, which
is then required and has to be in the same folder
like the configuration file
assetimportmodule.ini .
Parameter Description
[DefaultOptConstraints] Optimization constraints are taken from
customized Asset fields - with the following
settings as default (and without those settings
with Radioplan defaults from
defaultparameters.ini ).
OPT.MechanicalTiltReconfigurable
OPT.MechanicalTiltRangeMax_deg
OPT.MechanicalTiltRangeMin_deg
Optimization parameters in Cell Settings Æ
OPT.TiltStepSize_deg Optimization tab
OPT.MechanicalTiltShared
OPT.ElectricalTiltReconfigurable
OPT.ElectricalTiltRangeMax_deg
OPT.ElectricalTiltRangeMin_deg
OPT.ElectricalTiltShared
OPT.RemoteElectricalTiltInstalled
OPT.AzimuthReconfigurable
OPT.AzimuthRangeMax_deg
The PowerRange parameters may refer to
OPT.AzimuthRangeMin_deg either system: UMTS, CDMA, GSM, iDEN, or
WiMAX;
OPT.AzimuthStepSize_deg
e.g. OPT.PowerRangeMax_UMTS_dBm
OPT.AzimuthShared
OPT.PowerReconfigurable
OPT.PowerRangeMax_*_dBm The AntennaGroup parameters must refer a
valid Alternative Antenna Group, which is
OPT.PowerRangeMin_*_dBm defined in the Antenna Settings.
OPT.PowerStepSize_dB
OPT.AntennaTypeReconfigurable
OPT.AntennaGroup1
OPT.AntennaGroup2
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 34
Parameter Description
OPT.AntennaGroup3
OPT.AntennaGroup4
OPT.AntennaGroup5
OPT.MaxUsersPerCell
OPT.SiteReconfigurable Optimization parameters in Site Settings
OPT.SiteRemovable
Valid SiteStatus strings are “Existent”,
OPT.SiteStatus “Planned for Acquisition”, or “Not Existent”.
OPT.AzimuthLockedBetweenCells Valid SiteCandidateGroup strings are
“Group 01”, “Group 02”, …, or “Group 10”.
OPT.SiteCandidateGroup
; CELL CONSTRAINTS
;OPT.MechanicalTiltReconfigurable = 1
;OPT.MechanicalTiltRangeMax_deg = 15
;OPT.MechanicalTiltRangeMin_deg = 0
;OPT.TiltStepSize_deg = 1
;OPT.MechanicalTiltShared = 1
;OPT.ElectricalTiltReconfigurable = 1
;OPT.ElectricalTiltRangeMax_deg = 15
;OPT.ElectricalTiltRangeMin_deg = 0
;OPT.ElectricalTiltShared = 1
;OPT.RemoteElectricalTiltInstalled = 1
;OPT.AzimuthReconfigurable = 1
;OPT.AzimuthRangeMax_deg = 360
;OPT.AzimuthRangeMin_deg = 0
;OPT.AzimuthStepSize_deg = 10
;OPT.AzimuthShared = 1
;OPT.PowerReconfigurable = 1
; Power parameter names may refer to { UMTS; CDMA; GSM; iDEN; WiMAX }
;OPT.PowerRangeMax_UMTS_dBm = 33
;OPT.PowerRangeMin_UMTS_dBm = 30
;OPT.PowerStepSize_dB = 1
;OPT.AntennaTypeReconfigurable = 0
; AntennaGroup* shall refer to a string defined as Alternative Antenna Group in the
Antenna Settings.
;OPT.AntennaGroup1
;OPT.AntennaGroup2
;OPT.AntennaGroup3
;OPT.AntennaGroup4
;OPT.AntennaGroup5
;OPT.MaxUsersPerCell = 20
; SITE CONSTRAINTS
;OPT.SiteReconfigurable = 1
;OPT.SiteRemovable = 0
; Valid site states are { "Existent"; "Planned for Acquisition"; "Not Existent" }
;OPT.SiteStatus = Existent
;OPT.AzimuthLockedBetweenCells = 0
; Valid groups are { "Group 01"; "Group 02"; ...; "Group 10"}
;OPT.SiteCandidateGroup = Group 01
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 35
Parameter Description
[AntennaGroups]
<Radioplan antenna ID> Line-wise each antenna name (“ID”) in
= Radioplan can be assigned to one antenna
< Radioplan antenna group name > group.
www.actix.com
Actix Radioplan Asset Synchronization Guide Main Functions, Configuration and Customization 36
www.actix.com
Actix Radioplan Asset Synchronization Guide Abbreviations 37
6 Abbreviations
7 References
[R-UG] Actix Radioplan. User Guide. Version 3.8. Actix GmbH, Dresden,
Germany, October 2007.
www.actix.com
Actix Radioplan Asset Synchronization Guide References 38
www.actix.com