Академический Документы
Профессиональный Документы
Культура Документы
WCELLS.mbx v1.0
CONTENTS
1. Introduction ..................................................................................................................... 1 1.1.Purpose...................................................................................................................... 1 1.2. Intended users .......................................................................................................... 3 1.3 Main data/graphic tables ........................................................................................... 4 1.4. Presentation of cells in Mapinfo, using WCELLS.mbx .......................................... 5 1.5. Installation and Concept of Application Directory .................................................. 7 1.6. Concept of PROJECTS ............................................................................................ 8 2. Quick start ....................................................................................................................... 9 2.1 Quick Start - Generation of cells Mapinfo objects from txt file information ........ 11 2.2 Quick Start - Cell coloring according to operational state..................................... 14 2.3 Quick Start - Cell Information after selection........................................................ 15 2.4 Quick Start - Cell Search ........................................................................................ 16 2.5 Quick Start - Highlight of Neighbors (3G->3G)..................................................... 17 2.6 Quick Start - Highlight of cells with given value of PSC (Primary Scrambling Code) ............................................................................................................................. 18 2.7 Quick Start - Changing cell size ............................................................................. 19 2.8 Quick Start - Changing cell width ......................................................................... 20 2.9 Quick Start - Importing/Updating of basic UMTS network parameters from *.xls files (PSC, operational state, 3G->3G neighbors, RNC) ............................................. 21 2.10 Quick Start - Deleting of all cells (per Technology or all) .................................. 22 2.11 Quick Start Redrawing cells ............................................................................. 23 2.12 Quick Start Toggling labels .............................................................................. 23 Appendix I - Format of table T00_WCELLS (main graphic table)............................. 24 Appendix II required format of TXT file with UMTS/GSM/LTE/CDMA cells data to be imported into T00_WCELLS table .......................................................................... 26 Appendix III required format of XLS file with PSC, operationalState and RNC ..... 27 Appendix IV required format of XLS file with 3G->3G neighbors .......................... 28
WCELLS.mbx v1.0
1. Introduction
1.1. Purpose
WCELLS.mbx 1.0 is an advanced MapBasic application that can be used as visualization tool for presenting cells belonging to mobile telephony networks on the map, as well as some accompanying information. WCELLS.mbx 1.0 relies on Mapinfo as the main software application (minimum version is Mapinfo 6.0). The input information (list of cells with geographical information, network parameters and 3G->3G neighbors) are *.txt and *.xls formatted files. The outputs are graphic objects in Mapinfo (regions in the shape of cells/sectors, colored according to values of input information or accompanied by corresponding labels). The main idea is to help mobile telephony personnel in decision making, by presenting information in visual rather than tabular form. The main goal is portability (independence of the information source) and flexibility (easy updating & customization). The main graphic tables support UMTS, GSM, CDMA and LTE technologies, however, features of WCELLS v1.0 support UMTS technology only.
WCELLS.mbx v1.0
WCELLS v1.0 - Summary of Features: 01. Generation of cells Mapinfo objects from txt file information 02. Cell coloring according to operational state 03. Cell Information after selection 04. Cell Search 05. Highlight of Neighbors (3G->3G) 06. Highlight of cells with given value of PSC (Primary Scrambling Code) 07. Changing cell size 08. Changing cell width 09. Importing/Updating of basic UMTS network parameters from *.xls files (PSC, operational state, 3G->3G neighbors, RNC) 10. Deleting of all cells
WCELLS.mbx v1.0
WCELLS.mbx is a handy visualization tool, user-friendly, easy-to-use application, even for users not experienced in Mapinfo. For an experienced user, WCELLS.mbx speeds up significantly decision making process related to most frequent daily activities of Mobile Telephony Engineering. WCELLS.mbx does not guaranty any Optimization result. Author denies any responsibility for any damage that users might have as the consequence of decisions based upon usage of this tool. WCELLS.mbx is not related to any particular vendor. Any similarity in terminology with any particular manufacturer of mobile telephony equipment is coincidental and not intentional. The author reserves the right to change this program anytime without notice. This program is subject to copyright laws and it is exclusive property of author of the program, all rights reserved. Any altering, reverse engineering or similar activity would be treated illegal and is punishable by law.
WCELLS.mbx v1.0
WCELLS.mbx v1.0
In WCELLS v1.0, a default (recommended) coloring scheme is applied. The following rules of default color coding are applied to UMTS cells: - BLUE - GREY - YELLOW - GREEN - RED = ACTIVE (ENABLED) cell = HALTED (DISABLED) cell = highlighted cell (having a chosen parameter value, e.g. PSC; serving cell, when displaying neighbor relations, etc.) = neighbor of the selected cell = neighbor of the selected cell with the same PSC value
WCELLS.mbx v1.0
Figure 1. Example of UMTS and GSM cell presentation in WCELLS (in this case, 3 UMTS and 3 GSM cells, co-sited)
Figure 2. Example of color coding: Inactive (DISABLED) UMTS cells are shown GREY, Active (ENABLED) are BLUE, according to F19_STATE field
WCELLS.mbx v1.0
WCELLS_v1.0.MBX wcells01.dll DriveInfoApp.exe SerialNumber.txt Projects.TAB Projects.DAT Apart from the above, user has to provide the existence of C:\TEMP folder and read/write rights in that directory. The following 3 files have to be copied there: SerialNumber.txt WCELLS_Licence.txt DriveInfoApp.exe (from installation directory) License file (user specific) Reader of Hard Drive Identification
WCELLS.mbx v1.0
Users can have various mobile networks to deal with, WCELLS.mbx can present and manipulate only one of them at a time. In order to keep all data in an organized way, a concept of Projects in introduced. WCELLS v1.0 supports one project only. Project is a set of data belonging to one mobile network (eventually having multiple technologies). Every Project has a unique name and is located in a separate file folder, which we will refer to as Project Directory. Project Directory name is combination of number (provided by WCELLS.mbx) and generic name (defined by user). Example: for the first project to be created and a generic name TEST, the folder name would be 01_TEST. Project Directory is located in Application Directory (provided automatically by WCELLS.mbx). Project Directory has subfolders with strict names, given by WCELLS.mbx and not to be changed by user. If changed, the functionality of WCELLS.mbx would be reduced or completely nullified. Names, location, field structure and contents of Mapinfo files created by WCELLS.mbx are not to be changed manually by user, unless explicitly specified.
WCELLS.mbx v1.0
2. Quick start
STEP1: Creation of our first Project The program WCELLS.mbx can be started: a) by Double-Clicking on it in Windows Explorer or b) from Mapinfo, applying the following sequence of commands: Tools, Run MapBasic program, select and open WCELLS.mbx (similar: Ctrl-U). A window Creating a new Project will pop up and user is instructed to provide a new generic name for a Project, e.g. TEST (WCELLS will add number 01 to Project Directory name).
After creation of the first Project, a Welcome message will come up, and the user will be offered to accept the terms of usage. The user is normally expected to click I AGREE, meaning that he/she accepts the agreement and is then allowed to continue. As the result of this, a new Drop-down menu will become visible at the far right of the Mapinfo menu structure. The menu name is UMTS-Cells Choosing this menu would result in Drop-down options described in the chapters to come.
WCELLS.mbx v1.0
10
Also, a Map window would become visible, its name changed to WCELLS v1.0 TEST, corresponding to generic name of open project. Two Button Pads would become visible: General and UMTS.
Figure 3. Mapinfo windows after starting WCELLS v6.0 for the first time Finally, Message window will show up, where all the activities will be accompanied by appropriate messages.
WCELLS.mbx v1.0
11
2.1 Quick Start - Generation of cells Mapinfo objects from txt file information
STEP2: Creation of WCELLS graphic presentation of UMTS Cells The next step in our Quick Start would be to generate new cells from *.txt file. We would need beforehand to provide *.txt file, according to required format. The template of required TAB separated file can be found in Installation folder: \WCELLS_TXT_TEMPLATES\NewCells_UMTS.txt. For the first time, you may just use this file for your first project. Alternatively, simply open this file using Excel and fill up information for new cells below the first row that contains field names (1 row per cell). For UMTS cells, field F01_RANTECH should be UMTS. This and other compulsory fields to be filled up are:
F01_RANTECH F02_CELL, F03_SITE, F04_LON, F05_LAT, F06_AZIMUTH, F13_ANT_BW_HOR F18_ANT_GSIZE F34_UMTS_BANDNO (radio access network technology, default = UMTS) (cell name, i.e. sector name) (site name) (longitude) (latitude) (azimuth) (horizontal antenna bandwidth, default = 65) (antenna size in Map window, unit = 100m, default = 5) (band, i.e. carrier number, default = 1)
The remaining fields can be left as unknown or they can be filled up with more useful information, if known. Now, when *.txt file is ready, we can use the following menu option: UMTS Cells -> Project Setup and Maintenance -> Import Cells from Text File
WCELLS.mbx v1.0
12
From Dialog, chose UMTS radio button, Only new, All per carrier field and click OK, then chose your file (you can import the template file for testing purposes, having 6 UMTS cells, 2 sites). As the result, new cells should be created and program would create separate layers and tables, per technology, (UMTS, GSM, LTE, CDMA layers), some of them would be empty.
Figure 4. Map window after importing 3 UMTS cells (1 site ) from template file.
WCELLS.mbx v1.0
13
TROUBLESHOOTING: Usual issue is that the input text file is not according to required format. Example 1:
meaning that field F34_UMTS_BANDNO should be 1,2,3, the other values are not accepted.
WCELLS.mbx v1.0
14
Figure 5. UMTS Cell coloring according to operational state : blue (enabled) and grey (disabled)
WCELLS.mbx v1.0
15
This window can be moved around by clicking the mouse on it and holding it while moving. Most operations on cells are executed after cell selection.
WCELLS.mbx v1.0
16
User is offered a dialog window with two options. Cell name can be selected from a ListBox (1) or can be edited in a TextBox (2). The elements of ListBox are all existing UMTS cells. The result of this operation is that the Map Window will be centered around chosen UMTS cell.
WCELLS.mbx v1.0
17
Figure 6. Highlighting 3G->3G neighbors of selected cell Coloring back can be done using button from button pad General.
WCELLS.mbx v1.0
18
2.6 Quick Start - Highlight of cells with given value of PSC (Primary Scrambling Code)
STEP7: Import primary scrambling code from *.xls and highlight UMTS with chosen value of PSC. First, we have to provide *.xls file with the required format. A template file can be found in installation directory\WCELLS_XLS_TEMPLATES\ INPUT01 PARAMETERS - UMTS.xls. Conditions: TAB = UtranCell Primary scrambling code field name: primaryScramblingCode When *.xls file is ready, we can use the following menu option: UMTS Cells -> Import -> UMTS: Import Scrambling Code (SC) from XLS File Then, a file should be chosen and open. The successful import is ended with the following message displayed in Message window: ===Import of SC ended === Next step is to click on button on UMTS button pad. A window will be open and user can define a value of PSC (0511). All cells on current Map window having chosen value of PSC would be highlighted (colored yellow). Message window will read the number of cells found with chosen value and their cell names.
WCELLS.mbx v1.0
19
Figure 9. Example of changing size of UMTS cells (before and after the change)
WCELLS.mbx v1.0
20
Figure 10. Example of changing width of UMTS cells (before and after the change)
WCELLS.mbx v1.0
21
2.9 Quick Start - Importing/Updating of basic UMTS network parameters from *.xls files (PSC, operational state, 3G->3G neighbors, RNC)
Some of import/update features are already described in previous chapters (import of PSC, operational state, 3G->3G neighbors). For import of RNC information, xls file format should be as follows (same Template file): Conditions: TAB = UtranCell Cell field name = UtranCell RNC field name = RNC
Figure 12. Cell info UMTS after importing PSC and RNC
WCELLS.mbx v1.0
22
WCELLS.mbx v1.0
23
Labels are initially set according to carrier 1 (table T01_WCELLS), next click set labels to carrier 2 (table T02_WCELLS), the next one to carrier 3 (table T03_WCELLS). Clicking on button remove all UMTS labels.
WCELLS.mbx v1.0
24
F02_CELL F03_SITE F04_LON F05_LAT F06_AZIMUTH F07_ANT_HEIGHT F08_GND_HEIGHT F09_MECH_TILT F10_ELEC_TILT F11_CELL_TYPE F12_ANT_TYPE F13_ANT_BW_HOR F14_ANT_BW_VER F15_SITE_NAME F16_NOTE F17_CI F18_ANT_GSIZE F19_STATE F20_AUX F21_GSM_BCCH F22_GSM_BSIC F23_GSM_HSN F24_GSM_LAC F25_GSM_BSC F26_GSM_FBAND F27_GSM_BANDNO F28_GSM_AUX F29_GSM_AUX
Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(40) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20)
x x x x x
x x
x x x
WCELLS.mbx v1.0 F30_GSM_AUX F31_UMTS_SC F32_UMTS_RNC F33_UMTS_FBAND F34_UMTS_BANDNO F35_UMTS_AUX F36_UMTS_AUX F37_UMTS_AUX F38_UMTS_AUX F39_UMTS_AUX F40_UMTS_AUX F41_LTE_CODE F42_LTE_MME F43_LTE_FBAND F44_LTE_BANDNO F45_LTE_CSG F46_LTE_PLMN F47_LTE_PCI F48_LTE_AC F49_LTE_TA F50_LTE_AUX Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) Char(20) GSM Auxiliary UMTS Scrambling Code UMTS Radio Network Controller UMTS Frequency Band UMTS Frequency Band Number UMTS Auxiliary UMTS Auxiliary UMTS Auxiliary UMTS Auxiliary UMTS Auxiliary UMTS Auxiliary LTE Code LTE MME LTE Frequency Band LTE Frequency Band Number LTE CSG LTE PLMN LTE PCI LTE AC LTE TA LTE Auxiliary
25
WCELLS.mbx v1.0
26
Appendix II required format of TXT file with UMTS/GSM/LTE/CDMA cells data to be imported into T00_WCELLS table
Text file with cells information should be a TAB separated file with heather row containing names of the fields. All 50 fields are the same as in the table T00_WCELLS (already given in Appendix I).
An example of correct TXT file with UMTS cells information is provided in directory 04_IMPORT_TXT, after project initialization. ***
WCELLS.mbx v1.0
27
Appendix III required format of XLS file with PSC, operationalState and RNC
Excel file with UMTS information about SC, operational state and RNC should have data in TAB = UtranCell, first row should contain field names , and the following field names are compulsory: primaryScramblingCode, operationalState and RNC, like on the picture below.
WCELLS.mbx v1.0
28
Field COUNTER must contain the number of existing 3G->3G neighbors of the UtranCell CELL.