WCells, User Guide v1.0 - RFOPT

Download WCells, User Guide v1.0 - RFOPT

Post on 28-Oct-2014

272 views

Category:

Documents

4 download

Embed Size (px)

TRANSCRIPT

<p>WCELLS.mbx v1.0</p> <p>WCELLS.MBX v1.0 USER GUIDE UMTS</p> <p>Copyright RF Optimization Tools, 2011 All rights reserved</p> <p>WCELLS.mbx v1.0</p> <p>CONTENTS1. 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-&gt;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-&gt;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-&gt;3G neighbors .......................... 28</p> <p>WCELLS.mbx v1.0</p> <p>1</p> <p>1. Introduction1.1. PurposeWCELLS.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-&gt;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 &amp; customization). The main graphic tables support UMTS, GSM, CDMA and LTE technologies, however, features of WCELLS v1.0 support UMTS technology only.</p> <p>WCELLS.mbx v1.0</p> <p>2</p> <p>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-&gt;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-&gt;3G neighbors, RNC) 10. Deleting of all cells</p> <p>WCELLS.mbx v1.0</p> <p>3</p> <p>1.2. Intended usersThis Map Basic application, WCELLS.mbx version 1.0, is intended to be used by personnel involved in mobile telephony, primarily: a) Cell Planning RF Engineers, dealing with PSC and neighbor relations planning (UMTS), b) RF Optimization Engineers, dealing with presentation, analysis and troubleshooting of mobile networks, c) all other personnel, involved in geographical distribution of the sites in any mobile telephony network.</p> <p>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.</p> <p>WCELLS.mbx v1.0</p> <p>4</p> <p>1.3 Main data/graphic tablesThe main table containing information of all cells (UMTS, GSM, CDMA, LTE) is T00_WCELLS. Additional tables are derived from T00_WCELLS according to Layers concept of Mapinfo. Different layers contain cells of different RAN Technologies and frequency ranges, for example for UMTS cells, 3 tables are generated, T01_WCELLS, T02_WCELLS and T03_WCELLS, containing cells of three frequency ranges. This facilitates independent usage of individual layers within Mapinfo / WCELLS. User can define frequency range of group of UMTS cells before importing cell data from a text file, by giving appropriate value (1,2,3) to the field F34_UMTS_BANDNO. The table T00_WCELLS contains data and graphic information. Graphic information is hidden (invisible by Mapinfo Browser). Insertion of new cells into WCELLS is described in Chapter 2.1. Manual insertion of new records in Browser is not correct method of creation of new cells (lacking graphic information). Manual editing of some fields of T00_WCELLS (Longitude, Latitude, Dir, Antenna_size, Ant_BW), although not recommended, is allowed and after redrawing of affected cell/group of cells (Chapter 2.11) would lead to correct displaying. Changing table structure (adding/removing/changing fields) of any of WCELLS tables is not allowed. Manual editing can be used, for example, to set globally Ant_BW of all cells to desired constant value, using Mapinfo option Update Column. Before such global editing, it is highly recommended to backup the table T00_WCELLS, in case of undesired results. *** In the following sections, the term field will be applied in the context of T00_WCELLS table if not designated otherwise. A detailed description of T00_WCELLS structure is given in Appendix I.</p> <p>WCELLS.mbx v1.0</p> <p>5</p> <p>1.4. Presentation of cells in Mapinfo, using WCELLS.mbxThe graphic presentation of a cell in WCELLS.mbx consists of a Mapinfo region in shape of circle (omni cell) or part of circle (sector cell), whose center is located at the pair of coordinates (Longitude, Latitude), the orientation reflects the chosen Azimuth, width of a sector can correspond to Horizontal Antenna Beam Width, and the size of a sector would be according to chosen antenna Size, on the map.</p> <p>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</p> <p>WCELLS.mbx v1.0</p> <p>6</p> <p>Figure 1. Example of UMTS and GSM cell presentation in WCELLS (in this case, 3 UMTS and 3 GSM cells, co-sited)</p> <p>Figure 2. Example of color coding: Inactive (DISABLED) UMTS cells are shown GREY, Active (ENABLED) are BLUE, according to F19_STATE field</p> <p>WCELLS.mbx v1.0</p> <p>7</p> <p>1.5. Installation and Concept of Application DirectoryThe initial folder of WCELLS.mbx application is chosen by user during installation, and will be referred in the following text as Application Directory. It is recommended to choose a hard drive location with enough space. It is compulsory to choose a location where the user has all read/write rights, which is essential for WCELLS.mbx functionality. This location cannot be changed afterwards (of course, a new installation is another option). Installation consists of simple copying/pasting of the following 6 files from installation folder into Application Directory:</p> <p>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</p> <p>WCELLS.mbx v1.0</p> <p>8</p> <p>1.6. Concept of PROJECTS</p> <p>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.</p> <p>WCELLS.mbx v1.0</p> <p>9</p> <p>2. Quick startSTEP1: 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).</p> <p>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.</p> <p>WCELLS.mbx v1.0</p> <p>10</p> <p>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.</p> <p>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.</p> <p>WCELLS.mbx v1.0</p> <p>11</p> <p>2.1 Quick Start - Generation of cells Mapinfo objects from txt file informationSTEP2: 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)</p> <p>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 -&gt; Project Setup and Maintenance -&gt; Import Cells from Text File</p> <p>WCELLS.mbx v1.0</p> <p>12</p> <p>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.</p> <p>Figure 4. Map window after importing 3 UMTS cells (1 site ) from template file.</p> <p>WCELLS.mbx v1.0</p> <p>13</p> <p>TROUBLESHOOTING: Usual issue is that the input text file is not according to required format. Example 1:</p> <p>meaning that field F34_UMTS_BANDNO should be 1,2,3, the other values are not accepted.</p> <p>WCELLS.mbx v1.0</p> <p>14</p> <p>2.2 Quick Start - Cell coloring according to operational stateSTEP3: Import operational state from *.xls and see ENABLED and DISABLED cells First, we have to provide *.xls file with...</p>