G-NetView Pro Manual
1. Introduction
2. App folders
3. Tabs
2.1 MAP
3.2 CELL
3.3 LOG
3.4 CHART
3.5 REPORT
4. Settings
5. Menu
6. Actions
7. Cellfile
Introduction
G-NetView Pro is an Android app for postprocessing and analysis of G-NetTrack logfiles
Using application you can:
– open and analyze G-NetTrack logfiles
– see charts for different measurements
– see measurement statistics
How to use:
1. Load site data – the sites are loaded from cellfile.txt that is in app folder G-NetView/celldata. Put your cellfile in this folder. On app install there is a sample cellfile.
2. Load logfile – select your text logfile to open it. In folder G-NetView/logfiles there is a sample test_logfile.txt.
3. Use buttons to play logfile or select a point to see measurements.
4. In LOG tab you can see measurements for selected point.
5. In CELL tab you can view information for serving or manually selected cell.
6. In CHART tab you can view the measurement charts. Use buttons to move or zoom.
7. In REPORT tab you can see the measurement statistics charts.
IMPORTANT: Please note that to visualize serving and neighbors cell you need to load cellfile with cell locations. There is no magical way to guess exact cell locations.
App folders
There is difference in location for app folders on devices before Android 11 and devices with Android 11 and more.
Before Android 11:
The app folder is [phone storage]/G-NetView
All sub folders for celldata, logfiles, floorplan and report are also in this app folder.
Android 11:
The app folder is
[phone storage]/Android/data/com.gyokovsolutions.gnetviewpro/files/G-NetView
Sub folders for celldata and floorplan are also in this app folder.
Sub folders for logfiles and report are in folder [phone storage]/Documents/G-NetView
Tabs
There are five tabs with different information – MAP, CELL, LOG, CHART . The information displayed on each tab is
3.1 MAP Tab
MAP tab shows the network basestations and logfile measurement points. The controls on this tab are:
– Tab selector – for changing tabs. Tabs can also be changed via horizontally sliding
– Thematic map drop down menu – when logfile is loaded, the thematic maps can be changed via this menu. You have to wait till the thematic map is redrawn.
– Move Forward button – for moving in forward direction through logfile measurements
– Move Backwards button – for moving backwards through logfile measurements
– Play/Pause – for automatically moving forward through logfile measurements
– Legend – changes automatically based on the selected themeatic map
– Floorplan selector – available only when floorplans are loaded
3.2 CELL Tab
CELL tab shows following information:
– first row – information about number of cells cellfile.
– selected cell information – shows information about currently selected cell. Cell can be selected from map (when click on cellname or middle of cell line).
3.3 LOG tab
LOG tab shows information about currently selected measurement point.
Additionally the following values are calculated (when cell data is available and loaded before the logfile is loaded):
– serving distance – the distance between serving cell and measurement point
– serving bearing – the absolute value of the angle between serving cell azimuth and line between serving cell and measurement point – usually this angle is 0-90 degrees. Bigger values usually indicate swapped feeders on a site.
– serving antenna height – the height of the antenna on the serving cell
3.4 CHART tab
Here chart representation of different measurement entities are visible.
3.5 Report tab
In this tab the measurement statistics presented as histogram charts are visible.
Settings
Map View
– Map type
– Show Traffic
– Show Buildings
– Show Inddor
Cell Data
– Load only sites in view – adjust the map view before loading site data in order to filter the loaded cells. Use this when you have a big number of cells in your cellfile
– Show Cell Names
– Cell Size
– Cells Font Size
– Cell Thickness
– Neighbor Cell Line thickness
Log Data
– Point Size
– Serving Cell Line thickness
– Serving Cell Font Size
– Log Reduction Factor m- Use this to reduce the number of measurement points. If it is set to 10, every 10th measurement point will be loaded.
Cell Visibility
Check or uncheck different technologies and layers cells to show or hide them on the map. Screen orientation
Settings are activated via Menu – Settings. There are several group of settings, which are related to different app features:
Menu buttons
Tabs button
Changes the tabs. Tabs can be changed also by sliding.
Step backward button
When logfile is opened it changes measurement points in backward direction
Step forward button
When logfile is opened it changes measurement points in forward direction
Play/Pause button
When logfile is opened it plays/pauses measurements
Actions
Load Site Data
Loads the data from cellfile containing cell information. The file is cellfile.txt in folder G-NetView/celldata
Load Logfile
Loads the selected logfile. There is a sample logfile in folder G-NetView/celldata. Several logfiles can be added if they are opened one after another.
Close Logs
Closes the opened logfiles.
Load Floorplan
Load floorplan from image files located in \floorplan folder. Index file index.txt describing edge locations also should be present in the folder
How to load floorplans:
1. In folder G_NetView/floorplan put the floorplan images and create text index file (index.txt) with rows for each image and following content (tab delimited)
imagename longitudeSW latitudeSW longitudeNE latitudeNE
where SW and NE are South – West corner and North – East corner.
example:
1-floor.png 23.378626 42.660569 23.381324 42.662407
2. Go to Menu – Load Floorplan. The floorplans will be shown on map and for each floorplan a kml file will be created to be used with Google Earth. Notice that you have to change the image location tag <href> if you copy kml file and intend to use it on your computer.
Here you can download floorplan sample.
Settings
Opens the settings page.
Help
Opens G-NetView Pro manual.
Exit
Exits the app.
Cellfile
If you have cell information you can create a cellfile and view the sites on the map. In order to do this create cellfile and put it into folder G_NetView/celldata. Two types of cellfiles can be used:
The cellfile format is tab delimited text file with following columns:
– tab delimited text cellfile
– clf file
Recommended format is tab delimited text cellfile since it suppports more features (azimuth, layers, height etc…)
Tab delimited text cellfile
The cellfile should be named cellfile.txtCELLNAME – name of the cell – you can put anything here
LAT – latitude in decimal format
LONG – longitude in decimal format
LAC – LAC of the cell – number
CELLID – CELLID of the cell – number
AZIMUTH – azimuth of the antenna – number. If you put 360, the cell will be shown as circle. If you want to change the size of the circle put values > 360. Then the circle radius will be value-360.
TECH – technology – 2G, 3G or 4G
NODE – for GSM is empty, for 3G is RNC and for 4G is eNodeB ID – this column is mandatory only for 4G. For 3G you can skip it if “LAC-CELLID” is unique
Optionally you can add the following columns. If you add them you can use this cellfile also with other tools on the site like G-NetTrack and G-NetEarth:
– HEIGHT – antenna height in meters
– TILT – antenna tilt in degrees – positive values are for downtilt and negative for uptilt
– HORIZBEAM – horizontal beamwidth of the antenna
– VERTBEAM – vertical beamwidth of the antenna
– PSC – primary scrambling code – for 3G only
– LAYER – up to 4 (1,2,3,4 ) layers per technology (2G/3G/4G) – with layer information you can make your map view show different cell layers with different colors. Use 1 for lower layer and 4 for higher layer. For example for operator with GSM900/1800, 4 UMTS frequencies and 2 LTE frequencies it will be: GSM900 – 1, GSM1800 – 2, UMTS F1 – 1, UMTS F2 – 2, UMTS F3 – 3, UMTS F4 – 4, LTE F1 – 1, LTE F2 – 2
– INFO – Whatever is written there will be displayed in NEI tab when the cell is serving cell. Use semicolon “;” for new row.
Here is a sample cellfile.
CLF cellfile
CLF cellfile is a format used with some network monitoring tools. It is a semicolon (;) delimited text file. The cellfile should be named cellfile.clf or [MCC][MNC].clf like 28401.clf.
If you want to use clf format for cellfile make sure that there is no cellfile.txt in the cellfile folder, cause then it will be used as cellfile.
The current supported format is clf 3.3.0.
| MCCMNC | Network code MCC and MNC 5 or 6 digits decimal. Field is used for query. |
| CID | Cell ID 5 decimal digits with leading zeros for GSM, CDMA and UMTS. For LTE the ECI (E-UTRAN Cell ID) is used in decimal. Field is used for query. |
| LAC | Location Area Code decimal 5 digits with leading zeros. TAC for LTE, but is not used for query, but for 2G and 3G. |
| RNC | Not really used. Use 0 or -1 if unkown |
| LAT | Latitude coordinate in decimal WGS 84. Use point as decimal delimiter! |
| LON | Longitude coordinate in decimal WGS 84. Use point as decimal delimiter! |
| POS-RAT | Accuracy of the site coordinates. Use -1 for the exact position. |
| DESC | Cell description. Put any text for describing the cell here, but avoid characters like ; or ” or ‘ |
| SYS | Radio system: 0: unknown 1: GSM 2: CDMA 3: 3G / UMTS 4: LTE |
| LABEL | Short label with up to 8 characters to identify the cell in the map or log file |
| AZI | Azimuth of the cell in degrees. Only integer values are used. -1: unknown 0-359: azimuth in degrees 360: omni directional |
| HEIGHT | Antenna height above ground level of the cell in metres. -1: unknown 0-999: use point as decimal delimiter |
| BW | Beamwidth of the antenna. -1: unknown 0-360: beamwidth in degrees. Only integer values are used. |
Here is a sample clf cellfile