TEMS Discovery Device 10.0 User Guide
TEMS Discovery Device 10.0 User Guide
2 Overview 17
2.1 Main Window......................................................................................................17
2.1.1 Data List and Progress Log Panel.....................................................................18
2.1.2 Data Explorer Panel..........................................................................................18
2.1.3 Synchronizable and Summary View Panel......................................................18
2.2 Menu Bar.............................................................................................................19
2.2.1 File Menu..........................................................................................................19
2.2.2 Views Menu......................................................................................................19
2.2.3 Tools Menu.......................................................................................................20
2.2.4 Configuration Menu.........................................................................................20
2.2.5 Statistic Menu...................................................................................................21
2.2.6 Help Menu........................................................................................................21
2.3 Main Toolbar.......................................................................................................22
iv User's Guide
4.2.8.2 Google Earth View Options......................................................148
4.2.8.3 Download GIS Data – Google Map..........................................148
4.2.9 Bing Map........................................................................................................150
4.2.9.1 Bing Map Toolbar.....................................................................151
4.2.9.2 Download GIS Data – Bing Map..............................................151
4.2.10 Wave View.....................................................................................................152
4.3 Legend View.....................................................................................................154
4.4 Summary Data Views........................................................................................156
4.4.1 Histogram.......................................................................................................156
4.4.1.1 Histogram Toolbar....................................................................157
4.4.1.2 Histogram View Options...........................................................158
4.4.2 Batch PDF View.............................................................................................160
4.4.3 Problem Summary View................................................................................160
4.4.4 Sector Statistics View.....................................................................................163
4.4.5 Multi-dimension Statistic View......................................................................164
5 Tools 167
5.1 Script Builder....................................................................................................168
5.1.1 Script Editor & Private Functions Editor.......................................................169
5.1.2 Data Object: Metric List.................................................................................170
5.1.3 Data Object: RRC IEs.....................................................................................171
5.1.4 Data Object: Threshold...................................................................................172
5.1.5 Built-in Flags..................................................................................................173
5.1.5.1 CONDITION_FLAG................................................................173
5.1.5.2 TARGET_VALUE....................................................................173
5.1.5.3 EVENT......................................................................................173
5.1.5.4 EVENT_TIMESTAMP.............................................................174
5.1.5.5 EVENT_TYPE..........................................................................174
5.1.5.6 MESSAGE................................................................................174
5.1.5.7 MESSAGE_INDEX..................................................................175
5.1.5.8 EOF...........................................................................................175
5.1.5.9 TIMESTAMP............................................................................175
5.1.5.10 LOG_FILE_NAME...................................................................175
5.1.5.11 IS_NEMO_DATA....................................................................176
5.1.5.12 IS_TEMS_DATA......................................................................176
5.1.5.13 IS_QVOICE_DATA.................................................................176
5.1.5.14 IS_QVOICE_MASTER............................................................176
5.1.5.15 IS_QVOICE_SLAVE...............................................................177
5.1.5.16 IS_JDSU_DATA.......................................................................177
5.1.5.17 QVOICE_MASTER_END_TIMESTAMP..............................177
5.1.5.18 QVOICE_SLAVE_END_TIMESTAMP..................................177
5.1.5.19 TIMESTAMP_START_OF_FILE............................................177
5.1.6 Built-in User-defined Functions.....................................................................178
5.1.6.1 ClearAllEvents..........................................................................178
5.1.6.2 ClearEvent:................................................................................179
5.1.6.3 ReplaceEvent:............................................................................179
5.1.6.4 AddEvent...................................................................................180
5.1.6.5 AssignMetricValue....................................................................180
5.1.6.6 ReplaceMetricValue..................................................................181
5.1.6.7 GetLatLon.................................................................................181
5.1.6.8 IsValueValidStatic....................................................................182
vi User's Guide
5.2.3.5 Define Multi-series Chart.........................................................216
5.2.3.6 Define Chart Skeleton...............................................................218
5.2.3.7 Define Statistic Data..................................................................220
5.2.3.8 Define Tabular List...................................................................222
5.2.3.9 Define Correlation Chart...........................................................222
5.2.3.10 Options of Repetition in Report................................................225
5.2.4 Generating Microsoft Office Word Report....................................................229
5.2.4.1 Requirement..............................................................................229
5.2.4.2 MS-Word reporting template....................................................229
5.2.4.3 Sample Word Report Template.................................................233
5.2.5 Generate Report From Report Template........................................................233
5.2.6 Available Chart Types....................................................................................236
5.2.6.1 Column Charts...........................................................................236
5.2.6.2 Bar Charts..................................................................................237
5.2.6.3 Line Charts................................................................................237
5.2.6.4 Pie Charts..................................................................................239
5.2.6.5 XY (Scatter) Charts...................................................................239
5.2.6.6 Area Charts................................................................................240
5.2.6.7 Doughnut Charts.......................................................................241
5.2.6.8 Radar Charts..............................................................................241
5.2.6.9 Bubble Charts............................................................................242
5.2.6.10 Stock Charts..............................................................................242
5.2.6.11 Cylinder, Cone, or Pyramid Charts...........................................243
5.3 ADP Management.............................................................................................244
5.3.1 ADP Step1: File Monitor................................................................................245
5.3.2 ADP Step2: Output Data Source....................................................................249
5.3.3 ADP Step3: Output Scheduler........................................................................250
5.3.4 ADP Step4: Output Type................................................................................252
5.4 Plug-in Manager................................................................................................253
5.5 Neighbor List Analyzer.....................................................................................254
5.6 Antenna Pattern Viewer.....................................................................................255
5.7 Batch Printing....................................................................................................256
5.8 Print Queue........................................................................................................257
5.9 Signaling Message Browser..............................................................................258
5.10 Parameter Mapping...........................................................................................260
5.11 Log File Database Browser...............................................................................261
5.12 Log File Database Cleanup................................................................................262
5.13 Measurement Data Cleanup...............................................................................263
6 Statistic 265
6.1 Cube Management.............................................................................................266
6.2 Cube Creator.....................................................................................................267
6.3 Statistic Browser................................................................................................269
6.3.1.1 Statistic Data Cube View – Grid...............................................271
6.3.1.2 Statistic Data Cube View – Map...............................................272
6.3.1.3 Statistic Data Cube View – Chart.............................................273
6.3.1.4 File/Device Drilldown...............................................................273
6.4 Statistic Dashboard............................................................................................275
6.5 Statistic Dashboard Builder...............................................................................276
6.5.1.1 Dashboard Builder Toolbars.....................................................281
8 Appendix 379
8.1 Event List in Pre-defined Scripts.......................................................................379
8.1.1 CDMA_Events...............................................................................................379
8.1.2 EVDO_Events_Logbased...............................................................................381
8.1.3 GSM_WCDMA_Events.................................................................................382
8.1.4 LTE_Events....................................................................................................388
8.1.5 Nemo_Events.................................................................................................389
8.1.6 QVoice_Markers............................................................................................390
8.1.7 TEMS_Collectors_Events..............................................................................398
8.2 Enabling FILESTREAM in SQL Server 2008 R2.............................................404
Index 409
AMERICAS
+1.800.522.9670 Hours of Operation: 8:00 AM - 7:00 PM
EUROPE, MIDDLE EAST, AND AFRICA
+46.10.492.5005 Hours of Operation: 8:30 AM - 5:00 PM
RUSSIA, CIS COUNTRIES AND MONGOLIA
+7.495.777.0085 Hours of Operation: 9:00 AM - 5:30 PM (Moscow Time)
Email: [email protected]
ASIA PACIFIC
+60.3.5021.5202 Hours of Operation: 8:30 AM - 5:00 PM
CHINA
+86.10.65666088 Hours of Operation: 9:00 AM - 5:00 PM
Email: [email protected]
INDIA
+91.98.80500500 Hours of Operation: 9:30 AM - 6:30 PM
In the Welcome to TEMS Discovery dialog, select one of the demo documents and open it
to immediately explore TEMS Discovery's features. If you close the Welcome dialog, you can
still select a demo document from the Document List window in the left panel.
The Document List is docked in the upper section of the left panel, and the Project List is
docked in the lower section. If the layout you see is not similar to the one shown above, look at
the strip at the far left border for the vertically-displayed tags Document List and/or Project
List. You can hover your mouse over any of the tags, and the window will slide out. Then,
click the Pin button at the top-right corner to dock that window.
Next, you can go through the following topics to preview some of TEMS Discovery's functions:
System Requirements
Terminology
Open Demo Document
Open Demo Project
Create Projects from Scratch
Get Your Algorithm Working
Generate Reports As You Wish
2 Getting Started
1.3 System Requirements
NOTE: In a 64-bit windows operating system, the error dialog Google Update
installation failed with error 0x80040714 may appear. Currently, there is no
solution for this issue.
Bing Map 3D Plug-in (optional). This component is needed for TEMS Discovery's
integrated Bing Map Viewer. It can be downloaded from:
http://www.bing.com/maps/Help/VE3DInstall/Default.aspx?action=install&mkt=e n-us
Java Runtime Environment (optional). Google Earth and Bing Map require the
Java Runtime Environment (JRE). You can download the 32-bit installation package
from:
http://javadl.sun.com/webapps/download/AutoDL?BundleId=29226.
NOTE: Even for a 64-bit operating system, TEMS Discovery still requires a 32-bit Java
Runtime Environment.
4 8 24 48
data processing data processing data processing data processing
Configuration threads threads threads threads
Base Server HP ProLiant HP ProLiant HP ProLiant HP ProLiant
ML370 G6 Small ML370 G6 Small DL580 G7 Server DL580 G7 Server
Form Factor Form Factor
Tower Server Tower Server
Processor 1 X Intel® Xeon® 2 X Intel® Xeon® 2 X 10-Core 4 X 8-Core Intel®
Processor Processors E5649 Intel® Xeon® Xeon® Processors
E5649 (6 core, (6 core, Processors E7- E7-4830
2.53 GHz, 12MB 2.53 GHz, 12MB 4850 (2.13GHz, 24MB
L3, 80W) L3, 80W) (2.00GHz, 24MB Cache, 105W)
Cache, 130W)
Storage P410i/512 BBWC P410i/512 BBWC P410i/512 BBWC P410i/512 BBWC
Controller
Total Memory HP 64GB PC3- HP 64GB PC3- HP 128GB PC3- HP 128GB PC3-
8500R 4x16GB 8500R 4x16GB 10600R 16x8GB 10600R 16x8GB
4Rank Memory 4Rank Memory
Log file 650MB per hour 1GB per hour 2.8GB per hour
processing
capacity (avg.)
4 Getting Started
4 8 24 48
data processing data processing data processing data processing
Configuration threads threads threads threads
Database size DB_SIZE (GB) = DB_SIZE (GB) = DB_SIZE (GB) =
1.625 X 2.5 X 7X
Total_Hours_Per Total_Hours_Per Total_Hours_Per
_Day X _Day X _Day X
Total_Days Total_Days Total_Days
If there are more than 8 drives, then additional drive cages/enclosures and storage
controllers are required.
Each drive cage will hold 8 drives.
4 8 24 48
data processing data processing data processing data processing
Configuration threads threads threads threads
Drive Cage/ HP 8-Bay Small Form Factor Drive HP D2700 Disk Enclosure – It will hold
Enclosure Cage 25 SFF SAS drives.
Additional HP SAS Expander Card or
Controller HP Smart Array P812 controller HP Smart Array P812 controller
Project. A project is a placeholder used to organize the processed data from a geographic
region. Mixing data collected from two distant regions in a project will result in substantial
distortion of the display on Map Views; however, multiple projects can be created for a given
region. All the data in TEMS Discovery is structurally organized, and, unlike competing tools
that require you to load raw log data in every new session, TEMS Discovery loads the data
once and saves the processed data permanently until it is removed.
GIS Data and Geo Area. GIS data used in TEMS Discovery includes vector data, raster
images, and terrain elevation data. Data from the same geographic region is grouped into a
geo area that can be referred to by one or more projects. GIS data is optional, but can be
very helpful for troubleshooting.
Dataset. A dataset is created by importing one or more raw drive test files. All of the
processed data is organized according to certain attributes, including the original file names,
device names, mobile IDs, labels, etc. Multiple datasets can be created under a project to
organize the data collected from different time frames, optimization phases, vendors, sub-geo
regions, or any other attributes. Newly collected data can be appended onto any existing dataset
or project.
Composite Dataset. Processed data from one or more datasets of a project can be logically
combined into composite datasets. A typical practice is to group the processed data by one of
their attributes, such as mobile IDs or functional labels (long call, short call, PS call, etc.), and
then generate one composite dataset for each of the groups.
Coverage Maps. Coverage maps are the prediction data from RF planning and design tools.
Any prediction data in a format similar to raster images or terrain elevation data supported by
TEMS Discovery can be imported. The imported data can then be used for both background
display and to create prediction vs. measurement delta metrics.
View Layout. A view layout is a configuration setting that describes the organization of
various data views. The user can open a project with one of the saved view layouts.
Analysis Set. An analysis set is a set of view layouts that includes precise configuration
settings that describe the specific names of the metrics to be displayed in a given view. The user
can send an entire set of metrics defined in an analysis set from a selected data source with a
single click.
6 Getting Started
1.5 Data Archive vs. Export vs. Sharing
View Arrangement. One of TEMS Discovery's special features is its moveable window views.
This feature allows you to arrange the layout of the views to best suit your presentation needs.
Each view can be locked, hidden, or even dragged to another monitor as a floating window.
Any view can be enabled or disabled by clicking the related toolbar buttons, or by selecting a
sub-menu under Views. By default, the newly enabled view overlaps an existing view. To
rearrange a view, simply move the mouse to the view title, left-click, and drag the view to the
target position on the screen. To overlap two views, simply drag one view to the title of the
other view.
Creating Sub-Views. To further break down the primary view windows, TEMS Discovery
enables users to create sub-views that help organize data by placing it into smaller groups.
To divide the Map View, Time Chart, Histogram, or Correlation View into several
smaller views, click the Table Size button on the view’s toolbar.
Using Drag-and-Drop. To display any metric in any view, the user can drag-and-drop the
metric from the Data Explorer into the target view.
Dual-mode Toolbar Buttons. Toolbar buttons containing both "+" and "-" signs are dual-
mode buttons. Left-clicking performs the opposite function as right-clicking (e.g., left-
clicking zooms in and right-clicking zooms out).
Samples of dual-mode toolbar buttons: , , and
8 Getting Started
DemoDocument_WCDMA. A demonstration of TEMS Discovery's rich data
visualization and flexible view arrangement, and a demonstration of the
synchronization of all views.
To open a demo document, double-click on any of the three documents, or, if right-
clicking, select Open from the context menu. The following screen will appear if you open
the demo document DemoDocument_WCDMA.
You can expand the tree view in the Data Explorer and view data from the top level,
Dataset, to the lowest level, Metric. Right-clicking each level will bring up its
corresponding context menu. The data objects in those levels can be also dragged- and-
dropped to the windows located on the right side of the window.
After you send data to the windows, select Save from the File menu, or click the Save button
on the toolbar to save the current workspace as a TEMS Discovery document. The saved
document will then be listed in the Document List. A document named Last is created by
default to save the last workspace so the user can always restore the most recent environment.
10 Getting Started
1.9 Walk-U-Through
Walk-U-Through is a TEMS Discovery wizard that walks through some of the most
common tasks.
You can navigate these tasks by clicking the Back button or the Forward button . Then,
click the name of the task that you want to perform (next to the red arrow ).
You can also access the Walk-U-Through tasks from the dropdown menu next to the
Next button.
In general, you can follow the tasks one by one, from importing data through analyzing data and
generating reports, or you can jump to any task by using a shortcut.
1. Import GIS
See Import GIS Data for more information about importing GIS data (terrain elevation,
raster images, vector files, etc.). You can also access the Import GIS Data task from the
File menu or by clicking the Data Import button on the Main Window toolbar.
2. Create/Edit Project
See Project List for more information about creating a new project or editing an
existing project. You can also access the Create/Edit Project task from the Project List
context menu.
3. Import Drive Test Data
See Import Drive Test Data for more information. You can also access the Import Drive
Test Data task from the File menu or by clicking the Data Import
button on the Main Window toolbar.
4. Import Network Configuration
See Import Network Configuration for more information. You can also access the
Import Network Configuration task from the File menu or by clicking the Data
Import button on the Main Window toolbar.
5. Edit Device Attributes
See Device Attribute Assignment for more information.
6. Create Composite Dataset
See Composite Dataset for more information about creating one or more
composite datasets.
12 Getting Started
1.10 Creating Projects from Scratch
Once you have familiarized yourself with the functions and capabilities of TEMS Discovery,
you can start to create a new project.
1. Prepare Data
Depending on your needs, you may import network cell configuration, antenna, and GIS
data, in addition to the drive test data to be processed. TEMS Discovery can directly
process compressed files with a *.zip extension.
The current release of TEMS Discovery supports the following data:
Drive test data:
TEMS Investigation log files
TEMS Automatic log files
TEMS Pocket log files
QVoice Symphony log files
Nemo log files (.dt, .fs, .nmf files)
LGE LTE DM (LLDM) files
ZK Cell Test files
Flexible delimited text files.
Cell configuration. See Import Network Configuration for more information.
Antenna data. See Import Antenna Data for more information.
GIS data. See Import GIS Data for more information.
5. Open Project
Refer to Demo Project for how to open a project.
14 Getting Started
1.11 Get Your Algorithm Working
The Script Builder is one of the unique and advanced features that TEMS Discovery offers. It
enables you to easily create your own definitions of events/alerts or derive custom metrics
(such as event counters, time delays, or composite metrics) based on any decoded information
elements, including all Layer 3 information elements. The algorithms can then be shared with
peers or standardized across an organization.
The Script Builder is designed for RF engineers who do not specialize in software development
but who know basic C programming syntax, as well as software developers who can take
advantage of C# programming language and Microsoft .Net library.
TEMS Discovery provides several sample scripts in the program; referring to them can help
you learn how to create your own scripts.
fill in the metric attributes in any cell. From the Metric List tab, you can drag-and-drop any
information elements to the spreadsheet and select one of the metric attributes (e.g., sample
count, mean, maximum, minimum, standard deviation, multiple user-defined percentiles,
elapsed time, distance, etc.). The modified spreadsheet can then be saved as a TEMS
Discovery report template. With these templates, you can drag-and-drop a “mobile” or a
“composite” dataset to the template; TEMS Discovery will then automatically fill in the
specific metric data and generate a final report.
The remainder of this manual covers the TEMS Discovery working environment. The topics
provided are:
Overview
Data List and Progress Log
Main Project Windows
Tools
Configuration and Settings
16 Getting Started
2 Overview
TEMS Discovery is built around a dockable workspace to achieve its clear and intuitive user
interface. All windows, such as Map View, Messages View, Time Chart, and most of the
configuration dialogs can function as either docked or overlapping tabs.
The Document List, Project List, GIS List, Task Manager, and Message Log each has an auto-
hide feature that allows them to be hidden, while preserving valuable information on screen.
Enable or disable the auto-hide feature by clicking the Pin buttons ( or ) at the top right
corner of each window.
TEMS Discovery uses a drag-and-drop mechanism that allows you to perform many tasks
through direct manipulation. For example, during run time, the windows can be rearranged to a
preferred layout by simply dragging-and-dropping them. The layout can then be saved as an
XML file so that the application can restore its screen layout whenever needed.
The TEMS Discovery Main Window can be divided into multiple panels:
The left panel contains the Data List and Progress Log.
The right panel contains one or more project workspaces. Each project
workspace can contain multiple views.
Table View
Point Detail View
Instant Chart
Google Earth
Bing Map
Wave View
Legend View
18
2.2 Menu Bar
The Menu Bar on the Main Window includes the menus described below.
Open Demo Document. Open one of the TEMS Discovery demo documents.
Save. Open the Save dialog, which has options to save the opened data (can be multi-project) as a
TEMS Discovery document, to save the view layout, and to save the opened data as an analysis set. See
Save & Restore Working Environment for more information.
Walk-U-Through. Access a TEMS Discovery wizard that walks through some of the most
common usage tasks. See Walk-U-Through for more information.
Import. Open a data-specific Import dialog for importing external data to TEMS Discovery. See Import
Data for more information.
General Page Setup. Access page setup for general printing and PDF file generation.
Batch Printing Page Setup. Access page setup for batch printing.
Exit. Close the application.
Bing Map. Turn on Bing Map. See Bing Map for more information.
Maps. Display the Map View for the active project. See Map View for more information.
Time-series Chart. Display the Time-series Chart for the active project. See Time Chart for more
information.
Metric Correlation. Display the Correlation View for the active project. See Metric Correlation for
more information.
Messages. Display the Messages View for the active project. See the Messages View for more
information.
Table View. Display the Table View for the active project. See Table View for more information.
Point Detail. Display the Point Details for the active project. See Point Detail View for more
information.
Instant Chart. Display the Instant Chart for the active project. See Instant Chart for more
information.
Wave View. Display the Wave View for the active project. See Wave View for more information.
Synchronize Views by Mouse Moving. Synchronize all views listed above by moving the
mouse.
Synchronize Views by Mouse Clicking. Synchronize all views listed above by clicking the
mouse.
Histogram. Display the Histogram for the active project. See Histogram for more information.
Multi-dimension Statistic View. Display the Multi-dimension Statistic View for the active
project. See Multi-dimension Statistic View for more information.
Sector Statistic View. Display the Sector Statistics View for the active project. See Sector
Statistics View for more information.
Problem Summary View. Display the Problem Summary View, based on Problem Sets created by the
Report Template Builder.
Report Template Builder/ Problem Set Builder. Open the Report Template Builder.
Log File Browser. Open the Log File Database Browser dialog.
User Defined Parameters. Open the User Defined Parameters dialog for editing threshold
settings. These thresholds can be used in conjunction with the Script Builder.
Dynamic Composite Dataset Settings. Open the Dynamic Composite Dataset Settings dialog to
define rules for automatically creating a composite dataset.
Batch Configuration. Open the Batch Configurations dialog for generating summaries to PDF.
Event Set Filter Configuration. Open the Event Set Filter Configuration dialog for creating
event set filters.
Message Coloring. Assign colors to signaling messages for display in the Messages View. See
Message Coloring for more information.
Messages View KeyInfo Settings. Define a set of information to be displayed in the KeyInfo
column in the Messages View. See Messages View KeyInfo Settings for more information.
Point Detail Settings. Define a set of information to be tracked for a particular data point. See Point
Detail Settings for more information.
Instant Chart Component Content. Define component content for the Instant Chart. See
Instant Chart Component Content for more information
20
UDR Project/Dataset Matching. Define UDR project/dataset matching for data import. See UDR
Project Mapping for more information.
Device Attribute Assignment Template. Define a device attribute assignment template for data
import. See Device Attribute Assignment for more information.
Wireless Operator Lookup Table. Lookup Operator based on MNC/MCC, SID ot OperatorID. In
Script Builder, you can call built-in function GetOperatorByMncMcc(),GetOperatorBySid(), or
GetOperatorByOperatorId() to fetch the operator name. . See Wireless Operator Lookup Table for more
information.
Data Networking. Register the local TEMS Discovery to be a TEMS Discovery server. See Data
Networking for more information.
Email Templates. Create and maintain email templates. See
Email Template for more information.
Options. Maintain system options.
Report Template Builder. Open the Report Template Builder, where a Statistic Report template can be
built.
Cube Data Scope Configurations. Open the Cube Data Scope Configurations , where geo
center, data scope (projects) to be associated with a cube, and scheduler are selected.
Statistic Data Cleanup. Clean up statistic data.
Default GIS Builder. Build the default GIS list for cube processing.
Default Network Configuration Builder. Build the default network configuration list for cube
processing.
Database User Management. Manage database users.
Database User Access Permission. Grant database access permissions for user groups.
Measurement Data Server List. Display the Measurement Data Server List associated with the
statistic database.
Enterprise License Information. Display TEMS Discovery Enterprise license information.
Multimedia Presentation. In addition to the built-in multimedia, you can set up a hyperlink to the
multimedia presentation index file located in your own server accessible by TEMS Discovery, so that you
can maintain your own multimedia and present them in TEMS Discovery video player.
Save Project Data. See Save & Restore Working Environment for more information.
Walk-U-Through. Walk through some of the most common usage tasks. See Walk-U-Through for
more information.
Data Import. See Import Data for more information.
Report Template/Problem Set Builder. See Report Template Builder for more information.
Plot Band Editor. See Plot Band Definition for more information.
Sector Statistic View. See Sector Statistics View for more information.
Problem Summary View. See Problem Summary View for more information.
Multi-dimension Statistic View. See Multi-dimension Statistic View for more information.
Synchronize Views By Mouse Moving. See Synchronizable Views for more information.
22
3 Data List and Progress Log
This section describes the display windows that are created when the application starts.
Help.
TEMS Discovery provides a multi-user environment. Different users in the same computer can
have their own private data folder, hidden from others. Projects created by a user will be visible
only to their owner (these are listed under the Private Data tree node in the tree view).
However, the computer administrator has the right to control who else has permission to access
a particular user's private data folder.
The Public Data folder is for sharing data among all users. Users can upload their private
data to the public data folder, or download data to their private data folder for manipulation.
This Public Data folder can be a network folder. Please see Measurement Data Storage
Options for information about setting up a Public Data folder.
Additionally, TEMS Discovery can connect to remote computers that are also running TEMS
Discovery and share data with those computers’ active users. In the tree view, a remote
computer will be indicated with its IP address and FTP port number. See Data Networking for
more information.
The Project List is the data portal. The listed projects can be opened to a workspace with
certain pre-configured view layouts and/or with pre-defined analysis sets.
Right-clicking at the tree node shown above will bring up the following dialog for defining
date range, so that only the file/devices which are processed or collected within that date range
will be listed.
Other than the above date filtering, for each dataset, only up to a certain number of
file/devices can be listed. You can select the context menu “Modify Max. Number Of Files
To Be Listed For Each Dataset” to modify this maximum number.
To be more specific, you can manually select the file/device to be listed from the following
dialog which can be brought by selecting contaxt menu “Select File/Device For Listing”.
Help.
Archived Project
De-Archive. De-archive the selected project archive.
The de-archived project will be listed under the Private
Data tree node.
Remove. Permanently remove the selected project
archive from the disk.
Project Root
New Project. Create a new project.
Unpack Project. Unpack a TEMS Discovery
packed project.
Pack Project for Sharing. The entire project can be packed to a .ZIP file for archiving or sharing. This packed
project can be unpacked through the context menu described above.
Unpack Dataset. Unpack a dataset that was packed from TEMS Discovery.
Upload. Upload the selected project to a TEMS Discovery peer or public data folder. If a project with the same name
exists in the TEMS Discovery peer or public data folder, the project will be overwritten.
Dataset
File/Device Grouping By. Mobile data can be
grouped by its File name, Device, ESN, IMEI,
Label, and Mobile ID, or by any user-defined
attributes. See Device Attribute Assignment for
more information.
Global Edit Device Attributes. Globally edit the
attributes of all the devices in the selected dataset. See
Device Attribute Assignment for more information.
Open Project. Open the selected project to
workspace and restore the last workspace layout.
Open With View Layout. Open the selected
project to workspace and construct a pre-
configured view layout. See Save & Restore
Working Environment for more information.
Send to Problem Summary View. Bring up a
dialog for selecting a problem set template (which can
be defined in the Report Template Builder) to generate
a report of the problem from the selected dataset, and
then display the problem report in the Problem
Summary View.
Generate Report. Generate a report from the selected dataset based on the pre-defined report template, and send
the result to Report Excel Viewer. See Report Template Builder for more information.
Pilot Pollution Analyzer. Run Pilot Pollution analysis on the selected dataset.
GSM Interference Matrix. Generate a GSM Interference Matrix on the selected dataset.
Archive. Archive the selected dataset. The archived dataset will then be listed in the Archive tree node.
Mobile
Open Project. Open the selected project to
workspace and restore the last workspace layout.
Open Project With View Layout. Open the selected
project to workspace and construct a pre- configured
view layout. See Save & Restore Working Environment
for more information.
Send to Problem Summary View. Bring up a
dialog for selecting a problem set template (which can
be defined in the Report Template Builder) to generate
a report of problem from the selected device, and then
display the problem report in the Problem Summary
View.
Generate Report. Generate a report from the selected dataset based on the pre-defined report template,
and send the results to the Report Excel Viewer.
Pilot Pollution Analyzer. Run Pilot Pollution analysis on the selected dataset.
GSM Interference Matrix. Generate a GSM Interference Matrix on the selected dataset.
Send to Summary PDF View. Bring up a dialog for selecting a summary view option to generate a summary
PDF from the selected device, and then display the PDF in Batch PDF View.
Open Analysis Set. Open the selected project to workspace and load the data pre-defined in analysis sets. See
Save & Restore Working Environment for more information.
View/Edit Device Attributes. View and edit the selected mobile's device information. See Device
Attribute Assignment for more information.
Delete. Permanently delete the selected mobile from the disk.
Upload. Upload the selected mobile to a TEMS Discovery peer or a public data folder. If the project
exists in the remote TEMS Discovery peer or public data folder, this mobile data will be added to that project;
otherwise, a new project will be created as well.
Geo area. The Geo area combo box lists the available geo areas created by importing GIS
data. Once a geo area is selected, all the maps under that geo area will be listed under Default
GIS combo box.
A geo area can be associated to a project, so that all the maps under that geo area will be listed
in the Data Explorer–GIS List and available for display in the Map View.
Geo center. Once a geo area is selected, the center of the selected geo area will be used as
the geo center of the project.
Because Map View is based on Azimuth Equidistance projection, an appropriate geo center is
crucial. If you select a geo area for the project, the geo center will be automatically determined
from the selected geo area, otherwise, the geo center will be determined from the first data
(drive test data, cell configuration, or maps, etc.) to be displayed in the Map View. You have the
option to clean up the current geo center and
Default maps for display and report. You have the option to select multiple maps so that
they will be always displayed in the Map View when it is opened or when it is part of output
such as Excel, PDF, or paper printing.
Default UDR. You have the option to select multiple UDRs so that they will be always
displayed in the Map View when it is opened or when it is part of output such as Excel, PDF,
or paper printing.
Default print area (UDR bounding rectangle). TEMS Discovery provides several
features such as Reporting, Batch Printing, and Batch PDF View to output data in the Map
View. Instead of leaving TEMS Discovery to automatically determine output area, you can
create a UDR in the Map View and select that UDR as the output boundary.
Cluster UDR mapping for reporting. In this spreadsheet, you can create indexes for
cluster UDRs. When you create the report template in the Report Template Builder, you can
select an index in Report Options so that only the data collected in the corresponding UDR
will be considered for reporting.
The default cell configuration defined here will be used for generating Cell ID frames and Map
View reports (if prompted to include cell configuration in the report template), as well as other
functions that require the presence of a cell configuration.
You have the option of selecting a default cell configuration so that it will be always displayed
in the Map View when it is opened, or you can choose to just restore the last displayed cell
configuration.
To add or edit a TEMS Discovery peer, click the Add or Edit button to bring up the
Add/Edit Remote Data Server dialog.
Unpack UDR.
Help.
Help.
Help.
4.1.1 Dataset
The Dataset tab displays drive test data in three logical groups:
Archive. Datasets that have been compressed and stored in the disk as .ZIP files to
save space.
Composite. Multiple datasets/mobiles that have been combined to construct
logical datasets/mobiles.
Datasets. Drive test data that has been processed (binned) from the source data. The
hierarchy of the data is: Dataset > Mobile Group > Mobile > Frame > Metric.
Except for the archives, each group is in a tree view layout that can be drilled down to the
metric level.
Delta. Generate Delta/special-type grid-binned metrics. See Delta/Special -type Grid-binned Metrics
for more information.
Unpack. Unpack a TEMS Discovery packed dataset.
Help.
You can change the color scheme by selecting a new set of favorite colors for certain
modifiable tree notes. See Color Scheme Options for more information.
The On-fly Composite option allows the user to create dynamical composite dataset based
on multiple device attribute. This option is only available when database is selected for
measurement data storage.
The Data Filters option is different from the Listing Filters (Non-Composite) option. The Data
Filters option will not affect the dataset listing in the Data Explorer, but it will affect what data
can be analyzed and displayed. In another words, if a metric is dragged-and- dropped to any
view, only the data within the filtering region covered by the sector group and meeting the
conditions will be displayed.
Sector group. If a sector group is selected, only the data at the location that is
covered by the sectors in the sector group will be considered. See Cells in Map View
for information about defining a sector group.
Condition. If one or multiple condition expressions are selected, the data to be
considered must also meet the condition. Click the Browse button to open the Script
Builder, where you can define or edit a condition expression. See the Script Builder
section for more information.
Binning Method
TEMS Discovery provides two algorithms, by route distance and by location
grid, for geo-location binning. If you choose to use route distance binning, the data
within the distance of the defined binning size will be binned, whereas if you choose
to use location grid binning, the data within the square area of defined binning size
will be binned.
Binning Type
The default binning type is by the nature of data. TEMS Discovery has pre- defined
binning type for each metric by its nature, for example, use LAVG (linear average for
Ec/Io, etc.). However, you can select user-defined option and select one of binning
type for all the data to be geo-binned. The selectable binning types are: AVG, LAVG,
MIN, MAX, COUNT, SUM, FIRST and LAST.
The Listing Filters option is different from the Data Filters option. The Listing Filters option
will not directly affect the statistics of displayed data. However, it does directly affect whether
a project, dataset, file/device, or metric will be displayed under the Data Explorer tree view.
Please be advised that these options will not affect the listing of composite dataset.
Problem Sets. You can select a problem set as a filter to list only the datasets or
devices that have the problem defined in the problem set. Be sure to click the Refresh
button to refresh the Dataset tree view after any change to the selection of problem
sets. This option only affects the dataset listing in the Data Explorer.
Favorite. The Frame or Metric can be added to or removed from the favorite group
through its pop-up menu. The collection of these Frames and Metrics can be named and
saved to a favorite group. The Favorite combo box lists all available favorite groups.
Once a favorite group is selected from the combo box, only the Frames or Metrics that
belong to the group will be listed in the tree view. This option only affects the dataset
listing in the Data Explorer.
Date filter by. You can search the dataset within a certain period based on its
processing date or collection date. You will need to click the Refresh button to
refresh the dataset tree view after any change to the date criteria. This option only
affects the dataset listing in the Data Explorer.
You can also select context menu shown below
to bring up the following dialog for defining date range for listing, so that only the
file/devices which are processed or collected within that date range will be listed.
To be more specific, you can also manually select the file/device to be listed from the
following dialog which can be brought by selecting contaxt menu “Select File/Device For
Listing”.
You can search the dataset tree for any label that contains the specified search text. You can
search only for File/Device name, or if you also want to search the script results, check the
option Automatically generate script result if needed.
NOTE: The process of searching the script results may take some time, and you will not be able
to cancel the process once it starts.
Modify
Dynamic
Composite
Dataset
Scope. Open
the Modify
Dynamic
Composite
Dataset Scope
dialog. See
Modify
Dynamic
Composite
Dataset Scope.
Create/Edit
Dynamic
Composite
Dataset. Open
the Create/Edit
Dynamic
Composite
Dataset dialog.
See Dynamic
Composite
Dataset Settings.
Delete
Composite
Dataset.
Delete the
selected
composite
dataset.
Global Edit
Device
Attributes/Ti
me Offset.
Globally edit
the attributes of
all the devices
that are
members of the
selected
composite
dataset. See
Device
Open Analysis Set. Construct a new view layout and load data from the selected composite dataset based on
the pre-defined analysis sets.
Send to Problem Summary View. Select a problem set template (which can be defined in the Report
Template Builder) to generate a report of the problem from the selected composite dataset, and then display the
problem report in the Problem Summary View.
Send to Batch PDF View. Load data from the selected composite dataset and display a summary PDF based
on the pre-defined configuration in Batch PDF View.
Send to Map View. Load data from the selected composite dataset based on the pre-defined
configuration to the Map View.
Send to Messages View. Load data from the selected composite dataset based on the pre-defined
configuration to the Messages View.
Send to Time Chart. Load data from the selected composite dataset based on the pre-defined
configuration to the Time Chart.
Send to Correlation View. Load data from the selected composite dataset based on the pre-defined
configuration to the Correlation View.
Send to Histogram. Load data from the selected composite dataset based on the pre-defined
configuration to the Histogram.
Send to Sector Statistics View. Load data from the selected composite dataset based on the pre- defined
configuration to the Sector Statistics View.
Send to Multi-dimension Statistic View. Load data from the selected composite dataset based on the pre-
defined configuration to the Multi-dimension Statistic View.
Send to Table View. Load data from the selected composite dataset based on the pre-defined
configuration to the Table View.
Export to MapInfo Mif/Mid file with Table View Configuration. Export data from the selected
composite dataset based on the pre-defined Table View configuration to MapInfo Mif/Mid files.
Export to Excel with Table View Configuration. Export data from the selected composite dataset
based on the pre-defined Table View configuration to an Excel file.
Export to ASCII file in ZIP with Table View Configuration. Export data from the selected composite dataset
based on the pre-defined Table View configuration to ASCII files and compresses them to a ZIP file.
Generate Report. Generate a report from the selected composite dataset based on the pre-defined report
template, and send the result to Excel.
Pilot Pollution Analysis. Run Pilot Pollution analysis on the selected composite dataset.
GSM Interference Matrix. Generate a GSM Interference Matrix on the selected composite dataset.
Batch Printing. Print data based on the pre-defined configuration to a printer or PDF. See Batch
Printing.
Clean Up Derived Data. Clean up the data that is not generated from data importing, thus releasing disk
Copy Text of Selected Label. Copy the text of the selected tree node to the Clipboard, so that you can paste
the text to an external tool such as Notepad or Excel for any purpose.
Send to Multi-dimension Statistic View. Load data from the selected dataset based on the pre-defined
configuration to the Multi-dimension Statistic View.
Generate Report. Generate a report from the selected dataset based on the pre-defined report template,
and send the result to Excel.
Pilot Pollution Analyzer. Run Pilot Pollution analysis on the selected dataset.
GSM Interference Matrix. Generate a GSM Interference Matrix on the selected dataset.
Archive. Archive the selected dataset. The archived dataset will then be listed under the Archive tree node.
Pack Dataset for Sharing. Export the selected dataset to a ZIP file for archiving or sharing.
Clean Up Derived Data. Clean up the data that is not generated from data importing, thus releasing disk space.
Send to Table View. Load data from the selected mobile group based on the pre-defined configuration to the
Table View.
Export to MapInfo Mif/Mid file with Table View Configuration. Export data from the selected mobile
group based on the pre-defined Table View configuration to MapInfo Mif/Mid files.
Export to Excel file with Table View Configuration. Export data from the selected mobile group based on
the pre-defined Table View configuration to Excel files.
Export to ASCII file in ZIP with Table View Configuration. Export data from the selected mobile group
based on the pre-defined Table View configuration to ASCII files and compress them to a ZIP file.
Generate Report. Generate a report from the selected mobile group based on the pre-defined report template
and send the result to Excel.
Pilot Pollution Analysis. Run Pilot Pollution analysis on the selected mobile group.
GSM Interference Matrix. Generate a GSM Interference Matrix on the selected mobile group.
Global Edit Device Attributes/Time Offset. Globally edit the attributes of all the devices that are
members of the selected mobile group. See Device Attribute Assignment.
Archive. Archive the selected mobile group. The archived mobile can then be listed under the Archive
tree node.
Clean Up Derived Data. Clean up the data that is not generated from data importing, thus releasing disk space.
Copy Text of Selected Label. Copy the text of the selected tree node to the Clipboard, so that you can paste
the text to an external tool such as Notepad or Excel for any purpose.
Send to Correlation View. Load data from the selected mobile based on the pre-defined configuration to the
Correlation View.
Send to Histogram. Load data from the selected mobile based on the pre-defined configuration to the
Histogram.
Send to Sector Statistics View. Load data from the selected mobile based on the pre-defined
configuration to the Sector Statistics View.
Send to Multi-dimension Statistic View. Load data from the selected mobile based on the pre-defined
configuration to the Multi-dimension Statistic View.
Send to Table View. Load data from the selected mobile based on the pre-defined configuration to the Table
View.
Export to MapInfo Mif/Mid file with Table View Configuration. Export data from the selected mobile
based on the pre-defined Table View configuration to MapInfo Mif/Mid files.
Export to Excel file with Table View Configuration. Export data from the selected mobile based on the
pre-defined Table View configuration to Excel files.
Export to ASCII file in ZIP with Table View Configuration. Export data from the selected mobile
based on the pre-defined Table View configuration to ASCII files and compress them to a ZIP file.
Generate Report. Generate a report from the selected mobile based on the pre-defined report template and send
the result to Excel.
Pilot Pollution Analysis. Run Pilot Pollution analysis on the selected mobile.
GSM Interference Matrix. Generate a GSM Interference Matrix on the selected mobile.
Batch Printing. Print data based on the pre-defined configuration to a printer or PDF. See Batch
Printing.
View/Edit Device Attributes/Time Offset. View and edit the selected mobile's device information. See
Device Attribute Assignment.
Archive. Archive the selected mobile. The archived mobile can then be listed under the Archive tree node.
Send to Messages View. Execute the selected script and display the result in the Messages View.
Copy Text of Selected Label. Copy the text of the selected tree node to the Clipboard, so that you can paste the
text to an external tool such as Notepad or Excel for any purpose.
Generate Sector Statistics Report. Execute the script and generate a Sector Statistics Report for the
selected metric to a text file.
Export to Single Text File. Execute the script and export the selected metric to a text file.
Export to Text File per Sector. Execute the script and export the selected metric to a text file per sector.
Export to Google Earth KML/KMZ File. Execute the script and export events of the selected metric to a
Google Earth KML or KMZ file.
Export to MapInfo MIF/MID File. Execute the script and export events of the selected metric to a
MapInfo MIF/MID file.
Export to Vertical Mapper GRD File. Not applicable.
Edit Plot Band. Open the Plot Band Definition dialog and edit the plot band for the selected metric.
Copy Text of Selected Label. Copy the text of the selected tree node to the Clipboard, so that you can paste the
text to an external tool such as Notepad or Excel for any purpose.
Generate Sector Statistics Report. Generate a Sector Statistics Report for the selected metric to a text file.
Export to Single Text File. Export the selected metric to a text file.
Export to Text File per Sector. Export the selected metric to a text file per sector.
Export to Google Earth KML/KMZ file. Export the selected metric to a KML/KMZ file that can be
displayed in Google Earth or any other tools that support KML/KMZ files.
Export to MapInfo MIF/MID File. Execute the selected metric to a MapInfo MIF/MID file.
Export to Vertical Mapper GRD File. Execute the selected metric to a Vertical Mapper GRD file.
Export to GPX (GPS Exchange Format) File. Execute the selected metric (Route in GPS Position) to a GPX
(GPS exchange format) file. This file can be imported into any software applications that support common GPS
data format to describe the drive test route.
Edit Plot Band. Open the Plot Band Definition dialog and edit the plot band for the selected metric.
Copy Text of Selected Label. Copy the text of the selected tree node to the Clipboard, so that you can paste the
text to an external tool such as Notepad or Excel for any purpose.
By Drag-and-Drop
To make the best use of the file/device grouping function, group data by a particular
attribute, and then drag-and-drop a group of data from the tree view on the left to the list
view on the right.
creating a new composite dataset, saving the dataset, saving the dataset under a different
name, or renaming or deleting the dataset.
You can limit the rules of a dynamic composite dataset so that they apply to a limited number
of datasets and/or a certain date range, and then save it as a named scoped dynamic
composite dataset. You can create unlimited scoped dynamic composite datasets from a base
dynamic composite dataset.
To form a dataset group, drag-and-drop one or more datasets from the tree view on the left to
the list view on the right. The grouped dataset will be listed in the Data Explorer– Dataset List
with a prefix of <Group>. The operations for this dataset are similar to those for a regular
dataset.
Sector Group. You can select some particular sectors and form a sector group with a name.
This sector group can be highlighted in the Map View for viewing, or used to filter drive test
data for analyzing.
Sector Filter Expression. The Sector Filter Expression is a logical expression that is
constructed from the cell site, sector, and carrier parameters. It is used to search sectors that
meet a user-defined condition. You can also save the searched sector as a
Help.
4.1.2.2.1 Scenario
Edit View options. Open the Cell
Configuration View Options dialog.
The data structure used as the view
options is based on the "Base" version
of the selected cell configuration.
Pack Scenario for Sharing. Pack the selected scenario to a ZIP file. This ZIP file can be shared with peers
and unpacked to other projects.
Save As. Save the selected scenario version as a new scenario version.
Pack Scenario for Sharing. Pack the selected scenario to a ZIP file. This ZIP file can be shared with peers
and unpacked to other projects.
Export Version to TEMS Investigation XML Cell File. Export the selected scenario version to a TEMS
Investigation XML cell file.
Export Version to Google Earth KML/KMZ File. Export the selected scenario version to a KML/KMZ file
that can be displayed in Google Earth or any other tools that support KML/KMZ files.
Clone. Clone the selected cell site and bring up the Cell
Site Properties for editing.
4.1.3.1.4 Images/Maps
TEMS Discovery can import GIS data to a user-defined geo area. This user-defined geo area
can be assigned to a geo area property of a project (see GIS List and Project Properties for
more information). As shown below, the geo area property of the current project is
Demo_Geo, and three maps have been imported to this geo area.
The Add Sources From File button allows you to add new WMS sources from an
external text file generated by the Global Mapper, a third-party tool. This tool can be
accessed from your Global Mapper Application Data.
After the selections are made, TEMS Discovery will automatically download the most
appropriate layer and save it under the specified geo area with the specified name. This
newly created geo area/geo map will be listed in the GIS List.
Download In Data Explorer
Once the data to download is defined, TEMS Discovery will automatically download the most
appropriate layer for display while zooming in and out in the Map View window.
This way, an overview of the data can be viewed while zoomed out, and more data details will
become available as you zoom in. This data can be saved in full resolution to the TEMS
Discovery internal format by choosing Save As from the Data Explorer– GIS List context
menu.
For information to be listed in the KeyInfo column, you can define many KeyInfo
settings and select one of the settings from the KeyInfo Settings combo box.
Click the KeyInfo Settings button to access the Messages View KeyInfo Settings dialog.
To format a particular message with color, click the Layer 3 Message Coloring button to
launch the Message Coloring settings dialog and choose a color for that
message.
Copy All Summary. Copy all messages in the spreadsheet to the Clipboard, from which they
can be pasted to a text editor outside of TEMS Discovery.
Export Summary to Text
Export all messages displayed in the spreadsheet to a tab-delimited text file.
Export all messages, including their decoded detail information, to a text file.
Search Forward. Find the next message containing the text phrase defined in the text box.
Search Backward. Find the previous message containing the text phrase defined in the text
box.
Filter. Apply a filter and display only the messages whose KeyInfo contains the text phrase
defined in the text box.
Filtering per Selected Layer 3 Message Type. Apply a filter and display only the
messages selected by the user in the spreadsheet.
Remove Filter. Remove the filter and display all loaded messages.
Help.
A message cycle can be built from (and only from) the Layer 3 signaling messages listed in
the message summary view on the left panel, based on the user-defined message cycle
configuration.
Display Message Flow Containing the Selected Message. Display the message cycle that
contains the message currently selected in the message summary spreadsheet.
or Display Previous or Next Message Flow. Display the previous or next message cycle,
starting from the cycle start time shown beneath the toolbar. This cycle start time will be
automatically updated after a message cycle is built and displayed.
Copy Diagram. Copy the displayed diagram to the Clipboard for pasting to any external
application.
Save as Image. Save the displayed diagram as an image file.
Set Cycle Start Time. Manually select a Layer 3 signaling message in the message
summary spreadsheet and click this button to set a specific start time for building a new message
cycle.
Combo OnlineMap. List the available online map data source that you have been licensed.
box
Draw GIS in Grayscale. Display the GIS image in grayscale
Layer/View Option. Open the Map View Options dialog. See Layer/View Options.
Turn On/Off Subview Synchronization Mode. Synchronize all Map sub-views created by
Home View. Reset the current view port to a pre-defined Home View. To define the Home View,
right-click on the Map View and choose Set as Home View from the pop-up menu.
Reset.
Reset all Map Views to the view port that covers
bounding rectangle of the user-selected loaded d in
that view. If the Auto-Reset option is selected, view
port will be automatically reset at each time drag-and-
drop new data to that view.
Edit Neighbor List. Edit the neighbor list for the serving sector picked by . You need to
select what kind of neighbor to add or remove from the dropdown menu.
Cell Site Icon Size. Left-click to enlarge the cell site icon. Right-click to reduce the cell site icon.
Cell Site Label. Shortcut for site/label display options. See Cell Configuration View Options.
View Antenna Pattern. Click a sector to view its antenna pattern. See Antenna Pattern
Viewer.
Measurement Tool:
1. With this tool activated, measure distance by pressing and holding the left mouse button
to draw a path.
2. Click on a path to select it.
3. If a path is selected, press and holding one end of the path to modify it.
4. Delete a path by double-clicking it.
5. Right-clicking the screen will bring up a a pop-up menu with the following options:
Clear This Path. Remove the selected path.
Clear All Paths. Clear all paths.
Terrain Path Profile:
1. Display the terrain path profile in the lower panel of Map View by left-clicking and
holding to draw a path. See Terrain Profile.
UDR Selector:
1. Left-click a UDR to select it. Once the UDR is selected, a number of small black
squares will appear around the UDR.
2. Once the UDR is selected, left-click and hold its point to modify the selected UDR.
3. Right-clicking the screen will bring up the following pop-up menu.
Property
Edit the properties of the selected UDR.
Bring to front
Bring the selected UDR to the front of other UDRs.
Send to back
Send the selected UDR to the back of other UDRs.
User-defined Regions
The next level of the pop-up menu contains: New, Save, Save as, and Close. The drawn UDR can be
saved to a named GIS area, or saved as a new GIS area. The displayed GIS area can be closed
(removed from view).
UDR Drawing:
1. Select the shape from the dropdown menu: polygon (free), polygon (left/right click),
rectangle, or ellipse. Draw the UDR, as desired.
2. Left-click a UDR to select it. Once the UDR is selected, a number of small black
squares will appear around the UDR.
3. Once the UDR is selected, left-click and hold its point to modify the selected UDR.
4. Right-clicking the screen will bring up the same pop-up menu described above for the UDR
Selector.
Vector Feature Selector:
1. To use this tool, the terrain vector data must be displayed in the Map View. By left- clicking a
location on the map, a list of available area features will be listed in the pop- up menu. You
can pick an area feature to highlight.
2. Right-clicking the screen will bring up a pop-up menu with the following options:
Add the highlighted area to UDR. Add the highlighted area feature to UDR. By
switching the mouse mode to ( ), you can manipulate the newly added UDR as a
user-drawn UDR, and save it to a GIS area.
Clear the area highlighting. Clear the area highlighting.
Help.
Context Menu
Right-clicking the screen and selecting Network Configuration from the context menu will
bring up a pop-up menu with the following options:
Remove Data Point to Sector Links. When playing back drive test data, the ray
lines linking the data points to their appropriate serving sectors can be kept
permanently. Choose this menu to remove those lines.
Remove Curves. Remove one or all curves from the Map View.
Display Metric
To display a dataset in the Map View, drag-and-drop the data object from the Data Explorer
into the Map View, or right-click on the data object and choose Send to Map View from the
pop-up menu.
Modify Appearance
Multiple metrics can be displayed side by side in the Map View with certain screen offsets.
Use the tools provided in the toolbar ( , , , ) to adjust the appearance of the metrics
in the Map View and to obtain the best visual effects. See Map View Toolbar for more
information.
Click the Dataset Route Direction button to display black arrows indicating the
drive test direction.
You can also assign a plot band to the metric so that it is displayed in different colors. See
Data Explorer for more information on how to assign a plot band to a metric.
Context Menu
Right-clicking the screen and selecting Network Configuration from the context menu will
bring up the following menu:
Freeze NL Display. Keep the current NL display
(ray lines) permanent.
Remove Display of Cell Sites. Remove a version of cell sites from the screen.
Save highlighted sectors as group. To highlight sectors, click the Sector Selector/De-Selector
button.
Flag sectors by group. Highlight the sectors with flags in the sector group.
Flag sectors by filter. Search sectors based on the filter defined and highlight the sectors found with flags.
Subset display mode: toggle sector group. In subset display mode, only the selected number of
sector groups will be displayed in the Map View. Select this menu to toggle the display of the selected sector
group in the Map View.
Modify Appearance
Multiple versions of cell sites can be displayed side-by-side in the Map View.
The icon size can be enlarged or reduced by left-clicking or right-clicking the Cell Site Icon
Size button on the toolbar.
Clicking the Layer/View Option button on the toolbar will bring up the Map View
Options dialog. In the Cell Configuration tab, you can modify the options for displaying
cell/sector labels.
The dropdown toolbar at the Cell Site Label button provides a shortcut for selecting label
display options.
Edit Cell/Sector
To edit or view the properties of a cell site or sector, click the Cell Site Property button on the
toolbar to activate the Edit Cell Site/Sector tool; then left-click on a cell site or
sector in the Map View to display the Properties of Cell Site dialog. Edit the properties
and save. See Edit Cell/Sector Parameters for more information.
Neighbor List
TEMS Discovery provides direct operations to graphically edit the neighbor list. Click the
NL Serving Sector Selector button on the toolbar to activate the Pick
Serving Sector tool. Then, click on a sector to pick that sector as the serving sector for
editing the neighbor list. If the serving sector has neighbors, ray lines will link the serving
sector to its neighbors.
Before editing the neighbor list, click the Edit Neighbor List button on the toolbar to
activate the Edit Neighbor List tool. Then, to add a neighbor sector for the serving sector, select
the appropriate properties from the dropdown buttons and left-click the sector. To remove a
sector from the neighbor list, right-click the sector.
Click the Neighbor List IntelliSense button on the toolbar to activate the Neighbor
List IntelliSense Tool. When this tool is active and the cursor is passed over a sector with a
neighbor list, ray lines that link the sector to its neighbors will appear. You can modify the
color of the lines in the Cell Configuration tab in the Map View Options dialog. To freeze the
ray lines for the current serving sector, right-click and choose Network Configuration >
Freeze NL Display from the context menu. To remove a frozen neighbor list display, right-
click the serving sector and choose Network Configuration > Remove Selected NL
Display. Choosing Remove All NL Display will remove all neighbor list displays from
screen.
Context Menus
Right-clicking the screen and selecting Maps from the context menu will bring up a pop-
up menu with the following options:
Remove GIS Image/Maps Layers. Remove one or all GIS image/map layers
from the display.
Remove GIS Image/Maps Packages. Remove one or all GIS image/map
packages from the display.
Right-clicking the screen and selecting User Defined Region from the context menu will
bring up a pop-up menu with the following options:
New. Create a new UDR.
Save. Save the opened UDR.
Save As. Save the opened UDR as a new UDR.
Close. Close the opened UDR.
Display Metric
To display GIS data in the Map View, drag-and-drop the GIS data object from the Data
Explorer–GIS List into the Map View, or right-click on the GIS data object and select Send to
Map View from the pop-up menu.
Modify Appearance
Clicking the Layer/View Option button on the toolbar will bring up the Map View
Options dialog. In the Vertical Display tab, you can modify the options for displaying terrain
elevation. In the Vector Display tab, you can modify the options for displaying vector
information. In the Layer Control tab, you can modify the Z-order of each layer and its
opacity. However, vector layers will always be on the top of raster image layers.
UDR
UDR can be applied to filter metric data. You can only create, edit, or delete UDR in the Map
View by utilizing the tools provided in the toolbar ( , , and ), combined with the pop-up
menu described above. See Map View Toolbar for how to use these toolbar buttons to draw
UDRs, edit UDRs, and pick area features from a vector layer.
Select the Settings option to bring up the Cell Radius Analysis configuration dialog,
where you can define what to analyze and how it is to be displayed.
To define metrics for analysis for different technologies, you can drag-and-drop any available
metric from the tree view on the left to the spreadsheet on the right. Those defined metrics
will be displayed in the Map View if the corresponding sector with the same technology is
selected.
Once you click a sector on the Map View, the following indicators will be displayed (the entire
display can be turned on or off from Legend View).
A red circle. If you have defined the cell radius for this sector (see the Cell
Configuration Editor for how to add a new cell radius parameter and assign a value
for each sector), that cell radius will be used. Otherwise, the default cell radius
defined in the configuration dialog will be used to draw this circle.
Concentric circles. Circles with the step size defined in the Cell Radius
Analysis configuration dialog will be drawn as distance indicators.
is displayed in the Map View, data from the same device will be used for analysis. Otherwise,
you can simply drag-and-drop any metric from the desired device in the Data Explorer to the
Map View to define the reference data source.
The Profile Options tab allows you to change the start and end positions. The viewable height
can also be adjusted by manually entering the desired height.
The LOS Options tab allows you to define the height of the starting position, which is
represented by a vertical dotted line on the left side of the profile window. You also have the
option of whether to consider the earth's curve and the atmospheric correction.
Select whether to display the water level in the 3D display, and change the water level down or
up.
Display the 3D View Properties dialog, where you can configure the 3D view settings. These
include vertical exaggeration, water display, background color, and 3D vector display.
The contents of the 3D View window always reflect what is visible in 2D Map View. This
means that as you pan and zoom around the 2D Map View, the contents of the 3D View
window will pan and zoom around as well.
Sector Pie Shape. There are two options for displaying a sector: fixed pie with user-
defined width and pie with width per antenna beamwidth.
Sector/Carrier Label Display. The Sector/Carrier Label will always be visible if the Show
option is selected. To hide the Site Label, select Hide. The Smart labeling option allows the
application to display site labels only if the site label does not overlap any other labels within
the defined bounding rectangle.
The font for the label can be modified by clicking Font and selecting it from the dialog.
Neighbor List Display. If you select the Neighbor List IntelliSense Tool ( ) or Pick
Serving Sector Tool ( ), when the cursor is passed over sectors, the ray lines linking the
serving sector to its neighbors will be displayed in different colors. The color of the lines, which
can be modified here, indicates the relationship between the serving sector and its neighbor.
Shader Options. To view terrain elevation data, you can choose several algorithms from
the dropdown menu to color and shade the loaded elevation data. Selecting the Select built-
in shader as default radio button will allow you to choose from the following algorithms:
Atlas Shader. The Atlas Shader is the default shader, and generally provides good
results for any loaded elevation data.
Color Ramp Shader. The Color Ramp Shader displays ramps of color: blue for low
elevations to red for the highest elevations.
Daylight Shader. The Daylight Shader colors all elevations the same shade and is
only useful while Hill Shading is enabled.
When using this shader, you may customize the following options:
Surface Color: sets the calculated surface intensity color.
When using this option, select a plot band from the dropdown menu, and the current
configurations for that plot band will appear in the frame below. To change the
configurations, click Edit and the following window will appear:
Water Display. The Water Level setting controls the level at which water is displayed. The
default is set at an elevation of 0 meters above sea level. Use this to simulate different flood
and sea level change scenarios.
The Water Transparency setting controls the clarity of the water displayed if configured to show
water. Clearer water allows more underlying reliefs to show through, while opaque water allows
none.
Render. This section contains the settings for which types of vector features (areas, lines,
points, or labels) will be displayed when loaded. You can use these settings to turn off an
entire class of features all at once. For a finer degree of control, see the Feature Filter
section described below.
Scale threshold to hide labels. This setting controls how much de-cluttering of displayed
vector data is done. This is useful when you have a large of amount of vector data loaded. For
example, if you have all of the roads for an entire state loaded at once, you can slide the detail
slider to hide minor roads until you have zoomed in sufficiently on the data. The default setting
(Low) will display all vector data regardless of zoom scale. This setting does not affect the
display of raster or elevation datasets.
Feature Filter. This section allows you to select which specific area, line, and point
feature types to display. By default, all feature types are displayed.
If you select the Spider Movement Tool ( ), when the cursor is passed over a sector, ray
lines linking the data point to its serving sector will be displayed in different colors. The color
of the ray line indicates the role of the serving sector at this data point. The properties can be
modified in the Sector vs. Data Point display options.
Layers Tree View. In the Layers tree view on the left, the higher level indicates the view
index in multiple Map Views; the lower level lists all loaded GIS, dataset, and network
configuration layers in that view. You can select a layer by clicking on its name. For the GIS
layer, its current Display Options and Metadata are displayed in the tab controls on the right
side.
To hide a layer, uncheck the layer by clearing the checkbox before its name in the tree view, or
click the Close Selected Layer button on the toolbar to unload that layer from the Map
View.
To change the drawing order of a selected layer, use the and buttons to move the layer
up and down. The first layer in the tree view will be drawn on top of the other layers.
The Color Intensity setting controls whether the displayed pixels are lightened or
darkened before being displayed. It may be useful to lighten or darken raster overlays
to see overlaying vector data more clearly.
The Translucency setting controls the degree that you can see through the layer
underneath the selected layer. The default setting Opaque means that you cannot
see through the overlay at all. Settings closer to Transparent let you see through
the overlay and blend overlapping data.
Selecting Transparent will make a particular color transparent, making it possible to
see through a layer to the layers underneath. For example, when viewing a DRG on
top of a DOQ, making the white in the DRG transparent makes it possible to see much
of the DOQ underneath. Clicking Set Transparent Color allows you to select the
color that will be transparent in the selected overlay(s) as well as save the palette for
palette-based files to a color palette (.pal) file.
Interpolate removes jagged edges by making a subtle transition between pixels.
Turning off this option maintains the hard edges of the pixels as they are rasterized.
Selecting Texture Map will drape a 2D raster overlay over loaded 3D elevation
overlays. Turning on Texture Map will let the overlay use any available data from
the underlying elevation layers to determine how to color the DRG or DOQ; the result
is a shaded relief map.
Selecting Auto-Clip Collar automatically removes the collar from loaded raster data.
It is typically used to remove the white border around a DRG or the small black collar
around a 3.75 minute DOQQ. This allows you to seamlessly view a collection of
adjacent DRG or DOQ files.
Selecting Automatically adjust contrast will automatically adjust the display
contrast.
Metadata. The Metadata tab displays metadata for the selected layer.
The Misc. tab provides options for controlling the display of the legend and GIS
elements .
Legend
Modify the legend font.
Control the legend contents:
Turn the sample count display on/off.
Turn the % distribution display on/off.
4.2.2.10.1 Copy
Copies the current display in screen resolution to the Clipboard; once it has been copied,
it can be pasted outside of TEMS Discovery.
Save Configuration. Save the currently displayed metric and its location as a configuration.
Save Configuration As. Save the current metric configuration as a new configuration.
Delete Selected Configuration.
Restore Plot Band of Curves. Metric data can be associated to a curve as a plot band; in other
words, the color of a data point in that curve will be determined by the plot band of the metric data.
Restore Plot Band of Curves will remove this association.
Edit Plot Band. Edit the plot band of a curve.
Hide Selected Floating Legend. The plot band of a curve can be displayed graphically as a
floating legend. Select this option to hide the display of the selected floating legend.
Page Setup. Page setup for printout or PDF generation.
Print / Generate PDF. See Create Output.
The following pop-up menu will appear if metric data is dragged-and-dropped into the
Correlation View:
Replace Metric in X Axis. Replace the metric in the X-axis with
the dragged metric.
Replace Metric In Y Axis. Replace the metric in the Y-axis with
the dragged metric.
Copy. Copy the current display to the Clipboard to paste it outside of TEMS Discovery.
Generate Image File. See Generate Image File for more information.
In Table View, you can either click the scroll bar or press arrow keys to move the display up
and down. If you click a cell to make it active and then use the arrow key to move the display
up and down, TEMS Discovery will skip the blank cells and jump right to the previous/next
valid cell.
If you set the option Generate statistic data along with Table View to true in Options,
the statistic report of the metric will displayed in addition to measurement data.
Combo List the available configurations. Each configuration defines the collection of metrics to be loaded
box and in which spreadsheet to load them. When sending/dragging a file/device to Table View with a
configuration selected, the currently defined data filtering options will be applied.
Save Configuration. Save the currently displayed metric and its location as a configuration.
Save Configuration As. Save the current metric configuration as a new configuration.
Export to MapInfo MIF/MID. Export the displayed metric data to MapInfo Mif/Mid files.
Remove Current Sheet. Remove the current active spreadsheet and its partner (Metric and
Statistic spreadsheets).
If you click the Config Panel button , you will change the window to the one shown
below. Then, you can click the Sub-view Size button to create new layouts or edit
existing layouts by dragging-and-dropping Instant Chart component content from the left
panel to the right panel.
The Edit Content button is a shortcut that opens the Instant Chart Component Content
dialog for editing the selected component content on the left panel.
Save Configuration As. Save As the current layout configuration with another name.
Help.
To change the display color of metric data, you can edit the plot band of that metric. To change
the cell site radius, you can change the icon size for each technology in Cell Configuration
View Options.
In the current version of TEMS Discovery, the data object in the Data Explorer can be
displayed in Google Earth only, not in Google Map/Satellite/Terrain options. However, you can
export the display in Google Earth to a KML file and upload that exported KML file to a web
server that can be accessed by public, then click the button on the toolbar to link that KML
file. By doing this, the display will always exist in all Google map styles.
Where. Enter a postal address, and then click the Find icon to find the address on the map.
Find
Download GIS Data. See Download Online GIS Data Source for more information.
Link to KML/KMZ Network File. Link a network KML or KMZ file, and display it in Google
Earth.
Load GoogleEarth KML/KMZ. Export the current display to a KML or KMZ file.
Save as GeoTIFF. Save the current display as a GeoTiff file with geo-projection
information.
Save as GIS Package. Save the current display as a TEMS Discovery GIS package file that
will be listed in the Data Explorer–GIS List.
Print. Print the current display. See Create Output.
Page Setup.
Remove Network Links. Remove the network link of KML or KMZ file display.
Help.
To access the Google Earth View options dialog, click the Display Options button on
the toolbar. Check the desired options.
Save as GeoTiff. This option allows you to save the displayed images (maps, satellite,
terrain) as a geo-referenced GeoTiff file, which can be opened with another third party tool, or
imported into TEMS Discovery and displayed on Map View.
To change the display color of metric data, you can edit the plot band definition of that metric.
To change the cell site radius, you can change the icon size for each technology in Cell
Configuration View Options.
Move To. Enter latitude and longitude coordinates, and then click the Move To icon to find the
Move location on the map.
To
Download GIS Data. See Download Online GIS Data Source for more information.
Save As GeoTIFF. Save the current display as a GeoTiff file with geo-projection information.
Save As GIS Package. Save the current display as a TEMS Discovery GIS package file that will
be listed in the Data Explorer–GIS List.
Print. Print the current display. See Create Output.
Page Setup.
Cell Site Radius. Define the cell site radius (in meters) for display.
Help.
Select All. Select all plot bands so that all data will be displayed in the
Time Chart.
4.4.1 Histogram
The Histogram View is for graphical display of metric data showing the proportion of data
that falls into each specific plot band. To display data in the Histogram, drag-and- drop the
metric data object from the Data Explorer into the Histogram View, or right- click the metric
data object and choose Send to Histogram from the pop-up menu.
The graphical display of metric data can be shown as a bar graph, a 2D pie chart, or a 3D pie
chart; all options can be freely converted from one to the other.
Save Configuration As. Save the current metric configuration as a new configuration.
View Option. Open the Histogram View Option dialog. See Histogram View Options for
more information.
Pointer. Change the cursor to a pointer. Right-clicking the screen will bring up the following pop-
up menu:
Copy Statistic Data. Copy the current display statistic data to the Clipboard to paste it outside
of TEMS Discovery.
Page Setup. Page setup for printout or PDF generation.
Print / Generate PDF. See Create Output.
Generate Image File. See Generate Image File for more information.
Cell Merger Tool. Left-click, hold, and move the mouse to draw a rectangle to select the cells to be
merged. Release the cursor to merge the cells into a single cell spanning multiple columns and rows.
Split Merged Cell in Horizontal Direction. Click the cell created with the Cell Merger tool to
split it horizontally.
Split Merged Cell in Vertical Direction. Click the cell created with the Cell Merger tool to
split it vertically.
Refresh Display to Apply Current Data Filters. Apply the new data filtering defined in the
Data Explorer and refresh the display.
Cleanup. Clean up the display.
Help.
Label tab
General. Select whether to display PDF, CDF, and/or top label on bar/pie. (The font
for the label can be modified.)
Title Legend. Select what to display in the title – dataset name, mobile name,
and/or frame name.
Statistic Attribute Options. Select the statistic attributes to be listed.
PDF Bar Chart Style. Select a flat or 3D image.
Bar Chart Extended Label. Select additional information to display – Count,
PDF%, and/or CDF% (other than the plot band displayed at the bottom of the bar
chart).
Bar Chart Background Fill. The background of bar chart can be in filled as a
gradient to visually enhance presentation. You can define the start and end colors,
and the fill angle. Click the color bar to select a color.
Pie Chart Background Fill. The background of the bar chart can be in-filled as a
gradient to visually enhance presentation. You can define the start and end colors, and
the fill angle. Click the color bar to select a color.
Bar Color Pool. The color(s) of the bar chart can be picked from this color pool.
Click the color bar to select a color.
Chart frame background color. Select the background color for the chart
frame.
Click the color bar to select a color.
Legend background color. Select the background color for the legend.
Click the color bar to select a color.
The Problem Summary View lists the problem summary of devices based on pre- defined
problem sets (see Report Template Builder for how to define problem sets). If a device has
problems, its background color will be orange. Otherwise, the background color of the rows will
be displayed in the normal alternating, shaded format.
You can send a set of devices from the Project List or Data Explorer either by dragging-and-
dropping them into Problem Summary View or by selecting them from the context menu. All
of the devices will be listed with the number of the problems and their detail problem
information in a tabular format.
Click the Problem Only filter button on the toolbar to list the devices with problems, or
select a different problem set definition from the combo box to refine the list. You
Analyze. Analyze the selected problem (selected cell) if the problem has an associated
Analysis Set defined in the Script Builder.
Save to File. Save the problem summary to a text file.
Create Composite Dataset. Create a composite dataset from the devices listed in the
spreadsheet.
Generate Report. Generate a report from the devices listed in the spreadsheet.
The Sector Statistics View displays a metric per sector binning; its functions are
similar to those of the Table View. To display data in the Sector Statistics View, drag- and-
drop the metric data object from the Data Explorer into the Sector Statistics View, or right-
click the metric data object and choose Send to Sector Statistics View from the pop-up
menu.
Save Configuration. Save the currently displayed metric and its location as a configuration.
Save Configuration As. Save the current metric configuration as a new configuration.
Cleanup.
Export to Text File. Export the displayed statistic data to a tab-delimited text file.
Remove Columns. Delete the selected column and its corresponding statistic data from spreadsheet.
Help.
Cleanup Grid.
168
5.1.1 Script Editor & Private Functions Editor
TEMS Discovery provides the Script Editor and the Private Functions Editor. The
Script Editor is used to implement algorithms; the Private Functions Editor is used to
create procedures that can be used only by the script.
Paste.
Undo.
Redo.
Search.
Next. Search next.
Replace. Search and replace.
Size. Left-click or right-click mouse to enlarge or reduce font size.
Collapse. Collapse definitions.
Expand. Expand all definitions.
Split V. Split the editor to 50-50 in the vertical direction, or remove the vertical splitter.
Split H. Split the editor to 50-50 in the horizontal direction, or remove the horizontal splitter.
170
5.1.3 Data Object: RRC IEs
The RRC IEs tab lists all available "terminal" WCDMA RRC information elements (IEs).
These IEs can be dragged-and-dropped into the spreadsheet on the right to define an Alias,
which will be used as a variable in the script.
When a script is executed, TEMS Discovery will automatically search for the values from
all RRC signaling messages containing the IEs defined.
172
5.1.5 Built-in Flags
5.1.5.1 CONDITION_FLAG
A pre-defined variable that is used to hold the result of a condition expression. This flag is valid
only for the Condition Expression script type.
Example:
CONDITION_FLAG = EcIo>-10 && EcIo<-5;
Where:
EcIo is a user-defined alias in the spreadsheet
5.1.5.2 TARGET_VALUE:
A pre-defined variable that is used to hold the result of a global parameter. This flag is valid
only for the Global Parameter script type.
Example:
TARGET_VALUE = EcIo+5;
Where:
EcIo is a user-defined alias in the spreadsheet
5.1.5.3 EVENT:
A qualifier that is used to describe an event type defined in the spreadsheet.
Example:
EVENT_TYPE = EVENT.Call_Drop;
Where:
Call_Drop is a user-defined event in the spreadsheet.
Example:
EVENT_TIMESTAMP[EVENT.Call_Drop] = TIMESTAMP-3000; //backward 3
second
Where:
Call_Drop is a user-defined event in the spreadsheet.
TIMESTAMP is a pre-defined variable in milliseconds.
Remarks:
By doing this, the timestamp of an event can be manually adjusted.
5.1.5.5 EVENT_TYPE:
A collection that is used to store one or many events in the current computing iteration.
Example:
EVENT_TYPE = EVENT.Call_Drop;
Where:
Call_Drop is a user-defined event in the spreadsheet
Remarks:
Each time you call 'EVENT_TYPE = EVENT.<specific event>;' the specified event type will
be added to the collection.
Related Functions:
ClearAllEvents(), ClearEvent(), ReplaceEvent()
5.1.5.6 MESSAGE:
A pre-defined variable that represents an additional message of the current computing
iteration.
Example:
MESSAGE += string.Format(""Current EcIo value: {0}"", EcIo);
Where:
EcIo is a user-defined alias in the spreadsheet.
174
5.1.5.7 MESSAGE_INDEX:
A pre-defined variable that represents the index of the currently computing iteration.
Example:
MESSAGE_INDEX = MESSAGE_INDEX-10;
Remarks:
You can modify this variable so that the next computing iteration can go to a particular index.
5.1.5.8 EOF:
A pre-defined variable (Boolean) that indicates whether the current iteration is the end of file.
Example:
if(EOF)
{
//do something
}
5.1.5.9 TIMESTAMP:
A pre-defined variable that represents the time stamp (in millisecond) of current
computing iteration.
Example:
TIMESTAMP= TIMESTAMP-3000; //backward 3 second
Remarks:
By doing this, the timestamp of the result can be manually adjusted.
5.1.5.10 LOG_FILE_NAME:
A pre-defined variable that represents the log file name of the currently computing
iteration.
Example:
MESSAGE += ""Drive test data log file: ""+ LOG_FILE_NAME;
Example:
if(IS_NEMO_DATA)
{
//do something
}
5.1.5.12 IS_TEMS_DATA:
A pre-defined variable that indicates whether the current drive test data was collected by
TEMS.
Example:
if(IS_TEMS_DATA)
{
//do something
}
5.1.5.13 IS_QVOICE_DATA:
A pre-defined variable that indicates whether the current drive test data was collected by
QVoice.
Example:
if(IS_QVOICE_DATA)
{
//do something
}
5.1.5.14 IS_QVOICE_MASTER:
A pre-defined variable that indicates whether the current drive test data is QVoice master
data.
Example:
if(IS_QVOICE_MASTER)
{
//do something
}
176
5.1.5.15 IS_QVOICE_SLAVE:
A pre-defined variable that indicates whether the current drive test data is QVoice slave data.
Example:
if(IS_QVOICE_SLAVE)
{
//do something
}
5.1.5.16 IS_JDSU_DATA:
A pre-defined variable that indicates whether the current drive test data was collected by
JSDU.
Example:
if(IS_JDSU_DATA)
{
//do something
}
5.1.5.17 QVOICE_MASTER_END_TIMESTAMP:
A pre-defined variable that represents the end timestamp (in milliseconds) of QVoice master
data.
5.1.5.18 QVOICE_SLAVE_END_TIMESTAMP:
A pre-defined variable that represents the end timestamp (in milliseconds) of QVoice slave
data.
5.1.5.19 TIMESTAMP_START_OF_FILE:
A pre-defined variable that represents the start timestamp (in milliseconds) of the log file.
5.1.6.1 ClearAllEvents:
Clear all events in the specified message index.
Syntax:
void ClearAllEvents(object oMessageIndex)
oMessageIndex: message index
Example:
ClearAllEvents(MESSAGE_INDEX-2);
178
5.1.6.2 ClearEvent:
Remove a specific event in the specified message index.
Syntax:
void ClearEvent(object oMessageIndex, object oEventType)
oMessageIndex: message index
oEventType: event type to be removed
Example:
ClearEvent(MESSAGE_INDEX-2, EVENT.Drop_Call);
Where:
Call_Drop is a user-defined event in the spreadsheet.
5.1.6.3 ReplaceEvent:
Replace a specific event in the specified message index with another event.
Syntax:
void ReplaceEvent(object oMessageIndex, object oOrigEventType,
object oNewEventType)
oMessageIndex: message index
oOrigEventType: event type to be replaced
oNewEventType: new event type
Example:
//replace EVENT.Drop_Call with EVENT.Call_Release
ReplaceEvent(MESSAGE_INDEX-2, EVENT.Drop_Call,
EVENT.Call_Release);
Where:
Call_Drop and Call_Release are user-defined events in the
spreadsheet.
Syntax:
void AddEvent(object oMessageIndex, object oEventType)
oMessageIndex: message index
oEventType: event type to add
Example:
//Add EVENT.Drop_Call
AddEvent(MESSAGE_INDEX-2, EVENT.Drop_Call);
Where:
Call_Drop is a user-defined event in the spreadsheet.
5.1.6.5 AssignMetricValue:
Assign a value to a specific metric in the specified message index.
Syntax:
void AssignMetricValue(object oMessageIndex, string
szMetricName, object oValue)
oMessageIndex: message index
szMetricName: target metric name
oValue: value to assign
Example:
AssignMetricValue(MESSAGE_INDEX-2, Metric_EcIo, -10);
Where:
Metric_EcIo is a user-defined metric in the spreadsheet.
180
5.1.6.6 ReplaceMetricValue:
Replace the value of a specific metric within a certain message range from one to another.
Syntax:
bool ReplaceMetricValue(object oStartIndex, object oEndIndex,
string szMetricName, object oValueOrig, object oValueNew)
oStartIndex: start index of the message range
oEndIndex: start index of the message range
szMetricName: target metric name
oValueOrig: original metric value
oValueNew: new metric value
return true if metric valus has been successfully replaced,
otherwise, return false.
Example:
AssignMetricValue(MESSAGE_INDEX-2, Metric_EcIo, -10);
Where:
Metric_EcIo is a user-defined metric in the spreadsheet.
5.1.6.7 GetLatLon:
Get the geo position at the specfied timestamp.
Syntax:
void GetLatLon(object oTimestampInMs, out double dLat, out
double dLon)
oTimestampInMs: timestamp
dLat: latitude
dLon: longitude
Example:
double dLat, dLon;
GetLatLon(TIMESTAMP, out dLat, out dLon);
Syntax:
bool IsValueValidStatic(object oVal)
oVal: value to check
return true if the value is valid, otherwise, return false;
Example:
if( IsValueValidStatic(oValue))
{
//do somthing
}
5.1.6.9 IsValueValid:
Check whether a value is valid.
Syntax:
bool IsValueValid(object oVal)
oVal: value to check
return true if the value is valid, otherwise, return false;
Example:
if( IsValueValid(oValue))
{
//do somthing
}
5.1.6.10 GetDeviceAttribute:
Get the value of a specified device attribute.
Syntax:
string GetDeviceAttribute(string szAttribute)
szAttribute: name of device attribute
return value of the specified device attribute
Example:
string szIMEI = GetDeviceAttribute("IMEI");
182
5.1.6.11 SetDeviceAttribute:
Set the value of a specified device attribute.
Syntax:
void SetDeviceAttribute(string szAttribute, string szValue)
szAttribute: name of device attribute
szValue: value of the device attribute
Example:
SetDeviceAttribute("Operator", "TEMS");
5.1.6.12 GetWcdmaUarfcnIndex:
Get the index of a specified UARFCN.
Syntax:
int GetWcdmaUarfcnIndex(object oUARFCN)
oUARFCN: UARFCN
return index of the specified UARFCN
Example:
int iIndex = GetWcdmaUarfcnIndex(4085);
Remarks:
Each WCDMA UARFCN will be assigned a unique integer automatically by TEMS Discovery
during data import.
5.1.6.13 ElementNotContain:
Return elements in an array list that do not exist in another array list.
Syntax:
string ElementNotContain(ArrayList sourceList, ArrayList
targetList)
sourceList: array list
targetList: array list
return a comma delimited string that represents the elements of
array list sourceList which do not exist in array list
targetList.
Example:
string szMissing = ElementNotContain(sourceList, targetList);
Syntax:
ArrayList ElementMissing(ArrayList sourceList, ArrayList
targetList)
sourceList: array list
targetList: array list
return array list that represents the elements of array list
sourceList which do not exist in array list targetList.
Example:
ArrayList alMissing = ElementMissing(sourceList, targetList);
5.1.6.15 FindPairValue:
Find index of a given value in a specified array list; then return the value of the element in the
same index of another array list.
Syntax:
float FindPairValue(float key, ArrayList sourceList, ArrayList
targetList)
float: the value of element in sourceList
sourceList: array list
targetList: array list
return the paired value of the element in another array list.
Example:
float fEcIo = FindPairValue(218, alPSCList, alEcIoList)
5.1.6.16 MaxOfArrayList:
Find the maximum value of the specified array list.
Syntax:
float MaxOfArrayList(ArrayList al)
al: array list
return the maximum value of the specified array list
184
5.1.6.17 CountOfArrayList:
Find the count of the specified array list.
Syntax:
int CountOfArrayList(ArrayList al)
al: array list
return the count of the specified array list
5.1.6.18 IsIdentical:
Check whether two array lists are exactly identical, including their sequences of
elements.
Syntax:
bool IsIdentical(ArrayList al1, ArrayList al2)
al1: array list
al2: array list
return true if two array lists are identical, otherwise, return
false
5.1.6.19 IsIdenticalIgnoreOrder:
Check whether two array lists are identical, ignoring the sequence of elements.
Syntax:
bool IsIdenticalIgnoreOrder(ArrayList al1, ArrayList al2)
al1: array list
al2: array list
return true if two array lists are identical, otherwise, return
false
5.1.6.20 IsIdenticalFloatArray:
Check whether two float array lists are exactly indentical, including their sequence.
Syntax:
bool IsIdenticalFloatArray(ArrayList al1, ArrayList al2)
al1: float array list
al2: float array list
return true if two array lists are identical, otherwise, return
false
Syntax:
string GetDisplayString(ArrayList alValue)
alValue: array list
5.1.6.22 ArrayListContains:
Check whether an array list contains the specified value.
Syntax:
bool ArrayListContains(ArrayList arrData, object targetVal)
arrData: array list
targetVal: value to check
Example:
if(ArrayListContains(alPSCList, 218))
{
//do something
}
5.1.6.23 ArrayListIndexOf:
Get the index of the specified value in an array list.
Syntax:
int ArrayListIndexOf(ArrayList arrData, object targetVal)
arrData: array list
targetVal: target value
Example:
int index = ArrayListIndexOf(alPSCList, 218);
5.1.6.24 SameMemberInt:
Check whether two integer array lists are indentical, ignoring their sequences.
Syntax:
bool SameMemberInt(ArrayList al1, ArrayList al2)
al1: integer array list
al2: integer array list
return true if two array lists are identical, otherwise, return
false
186
5.1.6.25 ConvertToInt:
Convert a float array list to an integer array list.
Syntax:
ArrayList ConvertToInt(ArrayList alFloat)
alFloat: float array list
return integer array list.
5.1.6.26 ConvertToDateString:
Convert a timestamp (in milliseconds) to date string such as MM/dd/YYYY.
Syntax:
string ConvertToDateString(object oTimestampIsMs)
oTimestampIsMs: time stamp in millisecond
return date string.
Example:
string szDate = ConvertToDateString(TIMESTAMP);
5.1.6.27 ConvertToTimeString:
Convert a timestamp (in milliseconds) to a time string such as HH:mm:ss.fff.
Syntax:
string ConvertToTimeString(object oTimestampIsMs)
oTimestampIsMs: time stamp is millisecond
return time string.
Example:
string szTime = ConvertToTimeString(TIMESTAMP);
Syntax:
string ConvertToDateTimeString(object oTimestampIsMs)
oTimestampIsMs: time stamp is millisecond
return date time string.
Example:
string szDateTime = ConvertToDateTimeString(TIMESTAMP);
5.1.6.29 ExtractNumericValue:
Extract a numeric value from a string that contains numbers.
Syntax:
float ExtractNumericValue(string szString)
szString: a string that contains numbers
return float value.
Example:
float fVal = ExtractNumericValue(""Call Duration: 300.5 ms"");
fVal will be 300.5.
188
5.1.6.30 GetSectorParameter:
Get a sector parameter value.
Syntax:
string GetSectorParameter(string szSiteId, string szSectorId,
string szTech, string szParmName)
szSiteId: site ID
szSectorId: sector ID
szTech: technology flag (available flags: CDMA, EVDO, GSM,
WCDMA, TD, LTE)
szParmName: sector parameter name
return the value of the specified sector parameter.
Example:
string szAngle = GetSectorParameter(SiteID,SectorID,"",
"Azimuth");
string szLtePCI= GetSectorParameter(SiteID, SectorID, "LTE",
"PCI");
string szLtePCI= GetSectorParameter(Sector_SiteID, "LTE",
"PCI");
Where:
SiteID is alias of [!Mid].[Common].[Cell ID - LTE].[Site ID].[Sort By: Signal
Strength].[Top #1] defined in Alias spreadsheet
SectorID is alias of [!Mid].[Common].[Cell ID - LTE].[Sector ID].[Sort By: Signal
Strength].[Top #1] defined in Alias spreadsheet
Sector_SiteID is alias of [!Mid].[Common].[Cell ID - LTE].[Serving Sector] defined in Alias
spreadsheet
Syntax:
string[] GetSectorParameters(string szKey1, string szKey2,
string szTech, double dLatitude, double dLongitude, string[]
arrParmName)
szKey1: first key of the sector. It is PN for CDMA and
EVDO, BSIC for GSM, PSC for WCDMA, CPI for TD, and PCI for LTE.
szKey2: second key of the sector. It is BCCH for
GSM,UARFCN for WCDMA and TD, and EARFCN for LTE. Pass ""null""
(DON'T include quotation marks) if this key is unknown.
szTech: technology flag (available flags: CDMA, EVDO, GSM,
WCDMA, TD, LTE)
dLatitude: latitude of the sector detected.
dLongitude: longitude of the sector detected.
arrParmName: list of sector parameter names
return the list of value corresponding to the specified list of
sector parameters.
Example:
if(IsValueValid(Psc)
{
string szUarfcn=null;
if(IsValueValid(Uarfcn))
szUarfcn=Uarfcn.ToString();
string[] arrResults = GetSectorParameters(Psc.ToString(),
szUarfcn, "WCDMA", dLat, dLon,
new string[]{"Latitude", "Longitude", "Azimuth",
"Antenna_Type"});
double dSectorLat, dSectorLon;
int iSectorAzimuth;
bool bSectorLocationOK = false;
if(double.TryParse(arrResults[0], out dSectorLat) &&
double.TryParse(arrResults[1], out dSectorLon))
bSectorLocationOK = true;
int.TryParse(arrResults[2], out iSectorAzimuth);
string szAntennaType = arrResults[3];
}
Where:
Psc is alias of [!M].[WCDMA].[WCDMA Cell
Measurements].[Categorized PSC:A1]
Uarfen is alias of [!M].[WCDMA].[WCDMA Cell
Measurements].[Categorized UARFCN_DL:A1]
dLat is the alias of [!M].[Common].[GPS Position].[Latitude]
dLon is the alias of [!M].[Common].[GPS Position].[Longitude]
190
5.1.6.32 GetOperatorByMncMcc:
Get operator name from the lookup table (accessible from menu Configuration-
>Wireless Operator Lookup Table) by MNC and MCC
Syntax:
string GetOperatorByMncMcc(object MNC, object MCC)
MNC: MNC value
MCC: MCC value
return operator name.
Example:
string szOperator = GetOperatorByMncMcc(123, 321);
5.1.6.33 GetOperatorBySid:
Get operator name from the lookup table (accessible from menu Configuration-
>Wireless Operator Lookup Table) by SID
Syntax:
string GetOperatorBySid(object SID)
SID: SID value
return operator name.
Example:
string szOperator = GetOperatorBySid(123);
5.1.6.34 GetOperatorByOperatorId:
Get operator name from the lookup table (accessible from menu Configuration-
>Wireless Operator Lookup Table) by SID
Syntax:
string GetOperatorBySid(object SID)
SID: SID value
return operator name.
Example:
string szOperator = GetOperatorBySid(123);
5.1.6.35 TimeDiff:
Return the time difference of two messages in second
Syntax:
double TimeDiff(double msg1, double msg2)
msg1: the alias of first message
msg2: the alias of second message
return time difference in second.
Example:
double dDiff = TimeDiff(msg1, msg2);
double dDiff = TimeDiff(msg1, msg2, 1);
192
5.1.7 Built-in Math Function
http://msdn2.microsoft.com/en-us/library/system.math.aspx
All variable types may be tested for valid values using IsValidValue(MyVariable). It will
return false for both null and empty values.
Strings may be tested with String.IsNullOrEmpty(MyString). It will return true for both null
and empty values.
194
5.1.11 Programming in C# Language
The Script Builder uses a subset of C# programming language. For more detailed information
about C#, refer to the online resource:
http://msdn2.microsoft.com/en-us/library/default.aspx.
This section describes basic programming concepts that apply to script building and
provides an example.
5.1.11.1 Statements
The sequence of a script’s execution is controlled by statements, which are executed for their
effect and do not have values. All C# statements end in a semicolon (;).
#region
#region lets you specify a block of code that you can expand or collapse when using the
outlining feature of the Script Editor. A #region block must be terminated with a
#endregion directive.
#region a loop statements
for(int i=0; i<50; i++)
{
statement 1;
statement 2;
}
#endregion
In the script, you can declare a variable by using its type and a given name:
int i; // create an integer
To initialize the variable, you can give it a value or use the new operator:
int j=5; // create an integer and set its value to 5
To define a function that does not return a value, specify a return type of void.
void bar()
{
//do work ...
}
196
5.1.11.7 Using the return statement
The return statement exits a function. It is necessary for any function that returns a value.
int foo()
{
return 5; //necessary to get the value out of the
function
}
Also, notice in this example that the else clause is optional. We can omit the else
clause if no actions will be taken if the expression is false.
if ( val > 5 )
{
//do work ...
}
//continue other works
5.1.11.9 Iterations
Iteration statements provide the means to execute a block of code multiple times.
198
The above example works for every value of i from 0 to 9. The do/while loop can work in
almost the same way:
int i=0;
do{
//do work ...
i++;
} while ( i < 10 );
The only difference between the while loop and the do/while loop is that a do/while loop is
always executed at least once. The while loop evaluates the Boolean expression before entering
the block of code. The do/while loop evaluates the Boolean expression only after executing the
block of code the first time.
Arithmetic Operators
The standard mathematical operators in C# are:
+ Addition
- Subtraction
* Multiplication
/ Division
% Modulus
++ Increment
-- Decrement
Boolean Operators
C# supports the usual logical operators:
&& Logical AND
|| Logical OR
! Logical NOT
All of these work in the same way. They compare two values of the same type and return a
Boolean value:
if( a == b )
//do work ...
200
5.1.12 Example
6. Write Script
if( TxPw > -5 )
TxPw_TooHigh = TxPw;
7. Save Script
Click the Save button to save the script. If the coding has an error, an output window
will appear and list all errors. The errors must be corrected before the script can be saved.
202
8. Run Script
From the Data Explorer, drag-and-drop the script into any view to generate the output metric.
204
Report Template Editor. For directly generating the final report or defining the
report template. To edit the report format or color, it is recommended that you use
Microsoft Office Excel.
Save. Save the information in the spreadsheet as the final report or report template.
Help.
Report Date. Place a tag for reporting the date when the report is generated. Report
Options. Place a tag for reporting the report options. See Report Options. Name of
Data. Place a tag for reporting the file name of data.
Date Of Dataset. Place a tag for reporting the date range of the dataset from which the report is
generated.
Start Collection Time. Place a tag to report the start collection time of data.
End Collection Time. Place a tag to report the end collection time of data.
Collection Duration – hh:mm:ss. Place a tag to report the collection duration in the format of
hours:minutes:seconds.
Collection Duration – minutes. Place a tag for reporting the collection duration in the format of minutes.
Cluster Name. Place a tag to report the name of the cluster.
206
File Detail (All). Place a series of tags to list file details of all data.
File Detail – Device. Place tags to list the device description of each file in the data.
File Detail – Name. Place tags to list the name of each file in the data.
File Detail – Duration. Place tags to list the duration of each file in the data.
File Detail – Gap. Place tags to list the time gap of each file in the data.
File Detail – Start Time. Place tags to list the start time of each file in the data.
File Detail – End Time. Place tags to list the end time of each file in the data.
File Detail – <Device Attribute>. Place tags to list specific device attributes of each file in the data.
Cross-referencing among different sheets is supported in each format, but VBA macros are
supported only as follows:
Excel 97-2003 xls report template. Can contain VBA macros, but the maximum
worksheet size is 65536 rows by 256 columns.
Excel 2007/2010 xlsx report template. Maximum worksheet size is 1048576 rows
by 16384 columns. Cannot contain VBA macros.
Excel 2007/2010 macro-enabled xlsm report template. Maximum worksheet size is
1048576 rows by 16384 columns. Can contain VBA macros.
However, the Report Template Builder cannot edit an Excel 2007/2010 Macro-
Enabled xlsm file. You will need to open a report template (xls or xlsx) in Excel, add
macros as needed, and then save the file as an Excel macro-Enabled xlsm file.
208
5.2.3.1 Metric List
All TEMS Discovery supported metrics and user-defined events and metrics are listed in the
Metric List tree view. You can drag-and-drop any of the metrics (except for Layer 3 message
information elements) into the Report Editor.
NOTE: If you need to define a report from a Layer 3 message IE, define an advanced metric by
using the Script Builder and define the report using that advanced metric. See the Script
Builder for how to define an advanced metric.
When you drop an item into the Report Editor, the Report Options dialog will pop up.
Report Types
Chart. Defines a specific TEMS Discovery chart. See Define Single Chart and
Define Multi-series Chart.
Correlation Chart. Defines a correlation chart between a pair of metrics. See
Define Correlation Chart.
Correlation Key. Defines a correlated metric to generate a chart or statistic data.
See Define Single Chart and Define Multi-series Chart.
Map View. Defines a Map View report.
Multi-dimension Statistic View. Defines a Multi-dimension Statistics report.
Name. Places the name of the dragged item into the target cell.
Single Value. Differentiates between a Chart and a Statistic Data report. This type
of report definition produces one final value.
210
SetGlobal. Defines a global value (a single value or an array of value) generated from
a metric's data. This global value can be retrieved by the GetGlobal flag. Be aware that
SetGlobal must be defined after GetGlobalFlag in the report template. In other words, if
the GetGlobal flag is defined in row number 10, the corresponding SetGlobal flag must
be defined in a row number that is greater than 10.
Statistic Data. Defines a Statistic Data report. See Define Statistic Data.
Tabular. Defines a Tabular data report. See Define Tabular List.
Trend Chart. Defines a Trend Chart report. See Define Trend Chart for details.
Descriptives
Count. Count of the data points.
Duration. The time span of the first data collected to the last data collected.
Linear Average. Linear average of the data points.
Mean. Mean of the data points.
Max. Maximum value of the data points.
Min. Minimum value of the data points.
Mode. Mode of the data points.
Percentage. Percentage of the data points that are within the range defined or
over/below a defined threshold. A threshold or a range must be defined if this report
type is selected.
Standard Deviation. Standard deviation of the data points.
Sum. Summation of the value of the data points.
Unique Count. Count of unique values of the data points.
Variance. Variance of the data points.
X-Percentile. Value of the data point that is in the specified percentage – the
percentage must be defined.
212
5.2.3.3 Define Trend Chart
Defining a trend chart is similar to defining a regular chart, except that you can select
periodicity — Hourly, Daily, Weekly, and Monthly — for the trend report.
214
The report template shown above will result in a final report similar the one shown below. The
H and I columns of the spreadsheet are generated by TEMS Discovery and are used by
Microsoft Office Excel to generate the chart. Do not delete or hide this data.
For example, if you want to create a chart to visualize the linear average of the Peak Ec/Io of
each serving sector, this metric can be correlated with Common > Cell ID - cdma2000 >
Sector ID > Sort By: Signal Strength > Top 1. Drag-and-drop that metric from the Metric
List into the Correlation cell, as shown below.
For the example shown above, you can even elect to sort the Peak Ec/Io in Ascending or
Descending order so that the chart can be better visualized. If you further define a # of
Bands (for example, 5), only the stronger or weaker 5 serving sectors will be shown in the
chart.
Of course, you can elect to correlate with any other metrics, and, by combining those
charting options, you can produce a rich report just by dragging-and-dropping data.
216
The report template shown above will result in a final report similar to the one shown here:
The chart type for different series can be set to different types. This way, one series can be
plotted as the xlColumn type and the other can be plotted as the xlLine type. However, the
mixed chart type can only be defined to a 2D chart type. If you define a mixed 3D chart type,
or one to the 2D type and another to the 3-D type, all the series will be plotted to the chart
type of the first series.
For this skeleton, you need to at least manually define the starting cell label of X values and Y
values, along with the # of Bands. Cross referencing is allowed, but the format of the reference
should be as such: 'Sheet Name'!M24. Be sure to place an exclamation mark (!) after the sheet
name. The following is an example of a well-defined chart skeleton.
218
The report template shown above will result in a final report similar to the one shown here:
Figure 1
Cell B2 (the cell that the metric is dropped into) defines the metric information, Cell B3
defines what to compute, and, by default, Cell B4 defines where the starting cell is to place the
range. If you don't want the range to be listed, clear the cell. You can list other metrics side-by-
side by defining another Statistic Data report in the C column; however, all of the metrics must
have the same plot band definition.
Following is the final report generated:
Figure 2
220
Simply generating statistic data per its own plot band is not enough. More desirable
information is the correlation between two metrics. In Figure 1, you can drag-and-drop another
metric to Cell B5 and define it as the correlation metric. For example, you can drag-and-drop
Common > Cell ID - cdma2000 > Sector ID > Sort By: Signal Strength > Top 1 into Cell
B5, as shown below.
Figure 3
Be aware that if you define other metrics side-by-side, all of these metrics must have the
same correlation defined. In this example, Cell C5 must be the same as Cell B5. The final
report generated from the above example is shown below:
Figure 4
The above example lists the linear average of Ec/Io and Io of each sector’s coverage. To
correlate with Cell ID - <technology> under the Common tree node, scanner data and its
corresponding cell configuration must all be imported to the same project.
222
Following is the sample output expected for a final report:
The final template may look something like this. The content above the chart space is automatically
filled by TEMS Discovery and will not appear in the final report output. Experienced users may
further edit the contents of those cells to alter the final output.
224
5.2.3.10 Options of Repetition in Report
In cases where you need to generate a report with repetitive information (e.g., for each cluster
UDR), you can define the report type and descriptive in a block of cells in the report template as
usual, and then provide repetition options in the first cell immediately under the definition
block. TEMS Discovery can then automatically repeat the report generation of the definition
block for each available cluster UDR in the data source.
To access the following dialog, right-click at the first cell immediately under the definition
block on which you intend to repeat, and select Repetition in Report from the context
menu.
Repetition Flag. Repetition flag is a user-defined flag that will be placed in any cell
of the definition block as a placeholder. During report generation, this placeholder will
be replaced with the value of the Repetition Key. Select Repetition Flag from the right-
click context menu, and place the flag at the desired location. If the flag will be placed
inside any text, including online script, embrace the flag with braces, like this:
"{{RepeatFlag}ServingSector}"
Polygon attribute. A cluster UDR can contain a number of polygons, and each
polygon can be assigned to a number of attributes. Those attributes can be utilized
as a repetition key for reporting. For more information about creating UDRs and
assigning attributes to polygons, see GIS in Map View.
For this repetition type, select a default geo region in the Report Generation dialog
so that the definition block will be reported on polygon regions with each unique
attribute defined in this default geo region.
226
Device attribute. Select this option to make TEMS Discovery repeatedly report
on each available device attributes in the data source. You can also enter a list of
attribute values to limit the reporting scope, using commas as delimiters to
separate the values. Device attributes will normally be taken from drive test data.
For information about creating new device attributes, see Device Attribute
Assignment.
Metric. Select this option to make TEMS Discovery repeatedly report on each
distinct value of the specific metric key in the data source.
Unique ID (represents number of data rows). The number of rows that will
be occupied by the results of report types such as Statistic Data, Multi- dimension
Statistic Data, and Tabular is dynamic and unknown in the design stage. However,
you can assign a unique global ID (on the Additional Options tab in Report
Options) for any of these report types, and refer to this unique ID in repetition
definition. In this way, you can define the number of repetitions of a block to be
the same as the number of data rows generated.
The most useful usage case is to define cross-references to the results of report
types. For example, we defined Multi-dimension Statistic with unique ID "ABC"
in sheet "Events", as shown below.
In another sheet which must be a sheet not in front of the above sheet, we created
a formula "=IF(Events!B4<>"",Events!B4,"")" in Cell B4 (it doesn’t have to be in
Cell B4) that refers to Cell B4 in the above sheet, "Events."
228
Then, we defined repetition to repeat Row 4 for the number of times that is
represented by the unique ID "ABC" in sheet "Events". As a result, Row 4 will be
repeated by the same number of times as the number of data rows generated for
the defined Multi-dimension Statistic, and each row will be calculated
corresponding to each data row of the multi-dimension statistic data.
5.2.4.1 Requirement
Microsoft Office Word 2007 or current
TEMS Discovery report template (Microsoft Office Excel file .XLSX format) for
word report.
MS-Word report template (.Docx) based to on the TEMS Discovery .XLSX
format report template.
To include this chart in the MS-Word report, add a line with text ‘{chart: Agg. Active
Ec/Io (db)} ‘.
230
Here the correlation chart ID is ‘RxPowerCorrelationChart’. To include this chart to
Ms-Word report, add line with text ‘{Image: RxPowerCorrelationChart.jpg}’.
Map View – provide a unique ID to the map object in the TEMS Discovery
excel report template. See the figure below.
{Image:ImageName}
232
5.2.4.3 Sample Word Report Template
From Walk-U-Through
1. Go to the step Generate Report.
2. Select the target project from the combo box.
3. Select the target data.
4. Click the Generate Report button.
5. The report will be displayed in Microsoft Excel/MS-Word.
Before the report can be generated from the template, the following Report Generation dialog
will open:
Collection Date. You can report all the data in the selected dataset/mobile, or you
can report only on the data collected from a specified start date to a specified end
date.
Data Filtering
234
Sector Group. You can report data from all sector groups, or you can select a
particular sector group.
Condition. You can select one or multiple condition expressions on which to
filter data points, so that only the data points satisfying the condition expressions
will be computed. See Script Builder for how to define a condition expression.
Default Geo Region. You can report only the data that falls within a selected geo
region. In Project Properties, you can assign a cluster index for those UDRs created
in the Map View. If you selected Consider data only in cluster region index and
given an index (see Report Options) in the report template, the target data will be
filtered by those indexed cluster UDRs. If you do not define cluster region filtering
for some data, that data will be filtered by the default geo region selected in this
dialog.
Generate sector report from sector group. By identifying a sector group, you
can force TEMS Discovery to generate a report on that sector group only.
Save report as an Excel file (and Word file if template exists). You can use
the Windows browser to save the report to an Excel file in a target folder, and if the
paired Word report template exists, the output Word file will be saved in the same
folder.
Open generated report in Excel/Word. This option will cause the report to be
automatically opened when the generation process is finished.
Generate report only on sheet index. By providing a sheet index, you can
force TEMS Discovery to generate a report on that particular sheet only.
After all options have been selected, select a report template and click Generate
Report. The final report can also be saved to a file.
If an Excel template has a paied Word template, in another word, has the Word template with
the same file name, an indicator “*Paired Word template exists” will be display in the header of
the tree view after Excel template selected.
The final report generated will be in the same Excel format as the report template. If you
select a report template with the extension xls, the final report will have an extension of xls,
and the same to extension xlsx. In addition, if the paired Word template exists, a final Word
report will be generated in the same target folder.
Stacked Column. This type of chart shows the relationship of individual items to
the whole, comparing the contribution of each value to a total across categories. It is
also available with a 3-D visual effect.
100% Stacked Column. This type of chart compares the percentage each value
contributes to a total across categories. It is also available with a 3-D visual effect.
3-D Column. This type of chart compares data points along two axes. For
example, in the following 3-D chart, you can compare four quarters of sales
performance in Europe with the performance of two other divisions.
NOTE: Data points are individual values plotted in a chart and represented by bars,
columns, lines, pie or doughnut slices, dots, and various other shapes called data
markers. Data markers of the same color constitute a data series.
236
5.2.6.2 Bar Charts
A bar chart illustrates comparisons among individual items. Bar charts have the following
chart sub-types:
Clustered Bar. This type of chart compares values across categories. It is also
available with a 3-D visual effect. In the following chart, categories are organized
vertically, and values horizontally, to place focus on comparing the values.
Stacked Bar. This type of chart show the relationship of individual items to the
whole. It is also available with a 3-D visual effect.
100 % Stacked Bar. This type of chart compares the percentage each value
contributes to a total across categories. It is also available with a 3-D visual effect.
Stacked Line. This type of chart displays the trend of the contribution of each value
over time or categories. It is also available with markers displayed at each data value.
238
5.2.6.4 Pie Charts
A pie chart shows the size of items that make up a data series (data series: Related data points
that are plotted in a chart. Each data series in a chart has a unique color or pattern and is
represented in the chart legend. You can plot one or more data series in a chart. Pie charts have
only one data series.), proportional to the sum of the items. It always shows only one data
series and is useful when you want to emphasize a significant element in the data. Pie charts
have the following chart sub-types:
Pie. This type of chart displays the contribution of each value to a total. It is also
available with a 3-D visual effect, as shown in the following chart.
Exploded Pie. This type of chart displays the contribution of each value to a total
while emphasizing individual values. It is also available with a 3-D visual effect.
Pie of Pie. This is a pie chart with user-defined values extracted and combined into a
second pie. For example, to make small slices easier to see, you can group them
together as one item in a pie chart and then break down that item in a smaller pie or bar
chart next to the main chart.
Bar of Pie. This is a pie chart with user-defined values extracted and combined into a
stacked bar. More information
Scatter with Data Points Connected by Lines. This type of chart can be
displayed with or without straight or smoothed connecting lines between data points.
These lines can be displayed with or without markers.
Stacked Area. This type of chart displays the trend of the contribution of each
value over time or categories. It is also available with a 3-D visual effect.
100% Stacked Area. This chart type displays the trend of the percentage each value
contributes over time or categories. It is also available with a 3-D visual effect.
240
5.2.6.7 Doughnut Charts
Like a pie chart, a doughnut chart shows the relationship of parts to a whole; however, it can
contain more than one data series (data series: Related data points that are plotted in a chart.
Each data series in a chart has a unique color or pattern and is represented in the chart legend.
You can plot one or more data series in a chart. Pie charts have only one data series.). Doughnut
charts have the following chart sub-types:
Doughnut. This type of chart displays data in rings, where each ring represents a data
series. For example, in the following chart, the inner ring represents gas tax revenues,
and the outer ring represents property tax revenues.
Exploded Doughnut. This chart type is like an exploded pie chart, but it can
contain more than one data series.
Filled Radar. In this type of chart, the area covered by a data series is filled with
a color.
The following bubble chart shows that Company A has the most products and the greatest
market share, but not the highest sales.
242
Volume-High-Low-Close. This type of chart requires four series of values in the
correct order (volume, high, low, and then close). The following stock chart measures
volume using two value axes: one for the columns that measure volume, and the other
for the stock prices.
Bar, Stacked Bar, or 100% Stacked Bar. The bars in these types of chart are
represented by cylindrical, conical, or pyramid shapes.
3-D Column. The 3-D columns in this type of chart are represented by
cylindrical, conical, or pyramid shapes.
You can create a new ADP task by clicking the New Task button on the toolbar and following the
wizard steps.
ADP tasks can be defined in the following ways:
A purely file monitoring task that monitors file folders to import and processes the
data files into TEMS Discovery.
A purely output generating task that generates output (pdf and/or report) from
project/datasets.
A dual file monitoring and output task.
The Tasks tab on the ADP Management window lists the created ADP tasks in a table with
the following columns and functions:
Task Name. Shows the name of the task.
Status. Shows the status of the task (e.g., Active or Inactive).
Start/Stop button . Starts or stops a task.
Edit/View button . Edits or views a task definition.
244
Task Description. Shows a description of the task.
The Log tab shows the logging information for the ADP tasks.
To configure ADP to achieve distributed data processing, click the Networking button on the
toolbar to access the Data Networking dialog. To distribute the created tasks
by this computer, this computer will serve as the Dispatcher and maintain a list of
computers that are available to process data. See Data Networking for more
information.
If you are creating a new ADP task for purely output purposes, you can skip this step by
clicking the Next button.
The table lists all the file folders to be monitored by this ADP task.
To add a new file folder to be monitored by this ADP task, click the Add button
on the toolbar.
To remove a file folder from the table, select the row to be removed and then click
the Remove button on the toolbar.
If UETR or PCAP is selected, the following more options will be shown below.
FTP Additional Info. Used to display additional information for the FTP monitor
folder.
246
Set up Monitored Folder (Project Root Folder) and Sub-folders
In order to monitor multiple projects and multiple datasets automatically, it is recommended
that the monitored folder be set up according to the following structure:
<Monitored Folder>
<Sub folder 1 for Project 1>
<Sub-sub folder 1 for Dataset 1>
<Drive Test *.log files>
.....
<Sub-sub folder n for Dataset n>
...
<Sub folder n for Project n>
If no project sub-folders are under the monitored folder, TEMS Discovery will create the
following default project and default datasets:
_ADP_Created_Project_From_Folder_<Monitored Folder>
_ADP_Created_DataSet
Also, TEMS Discovery will automatically create the following two sub-folders after
execution of an ADP task:
Imported. Log files that are successfully processed will be moved to this folder.
FailedToImported. Log files that are not successfully processed will be moved to
this folder.
You should never manually place any log files to be processed under the Imported or the
FailedToImported folders.
Additional Settings
Task can be distributed across distributed network. If you would like to utilize
processing resources from other computers on the same network to help process new
monitored data files when this computer is busy, turn this option on.
Member of Distributed Network. If you want to add or modify the distributed network information,
click this button to access the necessary dialog.
Email template. If you want TEMS Discovery to send task status by email to the email
recipients defined by the Email Template, turn this option on.
FTP Setting. If you have selected FTP as the Host type, clicking the button in the Browse
column will bring you to the FTP Setting window.
NOTE: You can put any text notes here for your own reference purpose.
248
Select the Select a folder to be monitored or the Select a backup folder radio button
before selecting a folder to be monitored or selecting a backup folder from the folder browser
by highlighting the folder.
When you click OK, TEMS Discovery will try to connect to the FTP server with the
information you provided and check whether at least one set of project/dataset folders is
available under the Project root folder being monitored.
This window has two tree views showing projects and datasets that can be selected as the
output data source.
The left side tree view shows the current project and dataset folders under the monitored
Project Root Folder of this task. The right side tree view shows the output from the existing
projects/datasets. When you select/unselect a tree node on one tree, TEMS Discovery will
automatically select or unselect the corresponding node on the other tree if there is one on the
other tree.
Download & Show monitored FTP project/dataset names. If you have an FTP folder
to be monitored by this task, enable this checkbox (it is unchecked by default). If your computer
is connected to the network and you want to make a specific tree node selection, checking this
option will direct TEMS Discovery to connect to the FTP server and download the current
project and dataset subfolder names from the monitored FTP folder. (If the network or the FTP
server is slow and/or the folder has many subfolders, it could take a while for Discovery to
download all the information.)
250
define a more flexible date range by defining the number of hours to look back from the check
time.
Once an ADP task with an output option set is activated and TEMS Discovery keeps running
on the computer, TEMS Discovery will try to generate the output based on the settings every
day at the Check time. TEMS Discovery will keep track of which days’ data have been
processed for output. If you stop and restart a task that has generated some output for some
days, TEMS Discovery will ask whether you want to re-generate the output from the Start date.
In this window, you can specify whether you want the output data to be sent to Batch PDF files
and/or Report files.
You can specify the output folder, and you also have the option to send the output file to the
email recipients specified in the Email Template.
If you want to edit the batch configuration, click the Edit button, which will bring you to the
Batch Configurations dialog. For more information, see Batch Configuration.
252
5.4 Plug-in Manager
This feature allows you to view more detailed information about plug-ins that TEMS
Discovery recognizes.
The Plug-in Browser can be accessed from the Tools menu on the Main Window.
254
5.6 Antenna Pattern Viewer
This feature provides a view of the radiation pattern of the imported antenna files.
The Antenna Viewer window can be accessed from the Tools menu on the Main Window.
256
5.8 Print Queue
In addition to Batch Printing, TEMS Discovery allows the user to define a print job by
specifically picking a metric from the Data Explorer of an open project and selecting the
visualization of data. This eliminates the process of defining the Batch Configuration, as is
required by the Batch Printing task.
The Print Queue dialog can be accessed by clicking the Print Queue button on the Dataset
toolbar or from the Dataset right-click context menus.
NOTE: If the label of an IE starts with "<number>" or "[number]", it indicates that the
number specified is a possible numeric value of its upper level IE.
The Signaling Message Browser can be accessed from the Tools menu on the Main Window or by
clicking the Layer 3/RRC IE Browser button on the Messages View.
Uncheck All.
Search Global. Search for an IE that contains the text phrase defined in the text box,
Global starting from the current selected tree node to the end of the tree view.
258
Search Local. Search for an IE that contains the text phrase defined in the text box, only from
Local the current selected tree node and its child nodes.
Stop. Cancel the search.
Help.
The possible values of a metric are listed in the TEMS Discovery Metric List. Each possible
value contains two parts, a numeric value used internally and a text value for display.
In Script Builder, if you define the data type of this metric to be float in the Alias spreadsheet,
the numeric value of this metric will be reported; otherwise, the text value will be reported.
260
5.11 Log File Database Browser
This feature provides the functionality to browse the log files and download selected log files
from the database. An Excel-like spreadsheet is provided for easy filtering and sorting.
262
5.13 Measurement Data Cleanup
This feature provides the functionality needed to clean up the measurement
database.
Use the Specific Data tab to select a specific project and delete the data for the
specified dates.
Or, use the Scheduler tab to set up the scheduler to clean up data automatically.
NOTE: The TEMS Discovery Statistic feature incorporates the concept of OLAP “cubes.”
An OLAP cube is a set of data, organized in a way that facilitates non- predetermined
queries for aggregated information, or, in other words, online analytical processing.
OLAP is one of the computer-based techniques for analyzing business data that are
collectively called “business intelligence.” (http://en.wikipedia.org/wiki/OLAP_cube)
You can create a new cube by clicking the New button on the toolbar to bring up the cube
creator dialog. After the cube is created, its default status will be set to “Inactive”. You will
need to click the Process All Cubes button to activate it, so that the imported drive test
data can be extracted and stored in the statistic database according to the definition of the cube.
266
6.2 Cube Creator
The dialog illustrated below allows you to define how measurement data will be extracted and
what data will be stored into the statistic database.
This dialog is accessed by clicking the New button on the Statistic Cube Management
dialog.
To build measurement group for a cube, you can drag-and-drop the desired metric from the
Metric List on the left to the Measurement Group spreadsheet on the right.
To build the dimension of the cube, you can drag-and-drop the desired metric from the Metric
List, or the desired device attribute from the Device Attributes tab, or the desired cell attribute
from the Cell Attributes tab to the Dimension spreadsheet.
To apply condition filtering, you can select one or many condition expressions from
“Condition” sheet. Only the data meeting all selected conditions will be sent to statistic
database.
UDR & Area | UDR Global Attributes tab UDR & Area – UDR Groups tab
To enable calculation of area bin statistics, check the Calculate Area Statistics box and
define a minimum area size, in meters. TEMS Discovery will automatically generate the
statistic data for the area with bin sizes in multiples of the defined minimum area size. For
example, if the minimum area size is 100, TEMS Discovery will calculate data for bin sizes of
200, 400, 800, 1600, and up to 12800 meters.
NOTE: Once the cube definition has been modified, all statistic data associated with this
cube will be DELETED.
If data like UDR or network configuration refered by a cube has been modified, the
data of the cube processed before will be kept intact. However, you can force TD to
reprocess all data to reflect the change.
268
6.3 Statistic Browser
With the Cube Viewer, you can browse statistic data in various presentations.
The Statistic Data Cube View dialog is accessed by selecting Statistic Browser from the
Statistic menu on the Main Window.
You can 1) select the desired presentation type tab – Grid, Chart, or Map; 2) select the desired
cube objects by clicking the checkboxes on the Objects tab; 3) click the Refresh button to
present the data in the selected view.
You can simply change the data scope to apply the same presentation to different data source.
by Dimension:
Once a dimension is
checked, the available
values for that dimension
will be listed in the lower
pane. You can select any
one of them as a filter.
by Date:
You can also filter data
based on the time range.
270
6.3.1.1 Statistic Data Cube View – Grid
File/Device Drilldown. Bring up the File/Device List. Then, double-click any of the cells in the grid
to list the contributed file/device in the dialog. Each row in the spreadsheet lists the processed
file/device and the location (data source) of that file/device. See File/Device Drilldown .
Help.
Unzoom. Undo the last zoom action. Clicking the Reset button will clear the history of
previous zoom actions.
Define Statistic Data Area. Only the statistic data in the defined area with Geo center defined in
“Cube Data Scope Configurations” will be loaded and displayed in Map View. This
area can also be defined in options
272
Refresh Data. Apply the new data selection and refresh the display.
Clean. Clean up the display.
UDR Polygon Selector.
Data Label. Display value of data points in the screen.
Save. Save all the currently displayed views, or save an individual view as an image.
Remote Servers. The Remote Data Sharing Servers dialog lists all remote servers that can be
accessed for peer-to-peer data sharing. If you want to download the listed file/device, make sure the
according server (data source) is in your remote server list.
Problem Summary View. Send all files or multiple selected files to Problem Summary View
Analysis Set. Open analysis set to analyze all files or multiple selected files.
Composite. Create new composite dataset from all files or multiple selected files, or add all files or
multiple selected files to an existing composite dataset.
Download. If TEMS Discovery detects that the data source is located in a remote server, it will
download the selected file/device and list the data in the Project List with the same data structure as
that in the remote server.
Pack. If TEMS Discovery detects that the data source is located in the local machine, rather
than downloading measurement data from a remote server, it will pack the selected file/device to a
zip file for sharing.
274
6.4 Statistic Dashboard
The Statistic Dashboard is the user interface that presents statistic data in the way predefined
in the Dashboard Builder.
The Statistic Dashboard is accessed by selecting Dashboard from the Statistic menu on the
Main Window.
You can simply change the data scope to apply the same dashboard template to different data
source.
All available dashboard templates are listed in the Templates tab on the left pane. You can
delete or edit those templates.
To start creating a new template, click the Prepare for New button , which will clean up
all assignments in the views on the right pane. Switch to the Cubes tab, select a cube, and then
make the desired selections.
276
Pivot Grid View
For the Pivot Grid view display, you can select one or more measurements and dimensions in
the Object tab, apply a filter in the Filters tab, and then click the Assign button on the
Pivot Grid tab to assign the definition string to the target grid view.
Map Options
Color shows UDR statistic data. To use this option, you must select one UDR
attribute as a dimension in the Objects tab. This option directs TEMS Discovery to
draw the UDR polygon with the selected attribute, calculate the statistic data of each
polygon, and then fill the polygon with the color determined by the plot band
definition.
Include Cell Sites. Based on the boundaries of the statistic data, this option directs
TEMS Discovery to search the default network configuration list, locate all the cell
sites within the boundary, and draw those cell sites in the Map View.
Include GIS map from group. Based on the boundaries of the statistic data, this
option directs TEMS Discovery to search the selected default GIS group, locate all
the GIS data within the boundary, and draw that GIS data in the Map View.
UDR as print area. This option selects a list of UDRs as a fixed print area. TEMS
Discovery will determine the bounding rectangle of the selected UDRs and adjust
the view port of the Map View accordingly.
278
Miscellaneous Options
Map View/Chart Title. Enter the text of your choice to define a title for the Map
View or Chart.
Font. Select the font for the text.
Chart type. For Charts, select the chart type.
Layout
Use the options on the Layout tab to define the view layout.
280
6.5.1.1 Dashboard Builder Toolbars
Prepare for New. Prepare for a new assignment. This cleans up all existing assignments and prepares
for creation of a new template.
Save. Save the template.
Help.
Move Field Down. In Grid view, you can move a measurement or dimension field up or down to
change the order of the field in the grid.
Move Field Up. In Grid view, you can move a measurement or dimension field up or down to
change the order of the field in the grid.
Cell Span.
Horizontal Split.
Vertical Split.
Currently, TEMS Discovery provides four types of statistic reporting: Chart, Map View,
Single value (the result is a single value), and Tabular.
A right-click at the spreadsheet will bring up the context menu described below.
282
Remove Chart. Remove the chart definition and clean up the
chart area.
Remove Map View. Remove the Map View definition and
clean up the view area.
Repetition in Report. Define repetition options in the report
template. See Options of Repetition in Report.
Repetition Flag. Define a repetition flag in the cell as a
placeholder. This placeholder will be replaced with the value of the
repetition key when the report is generated.
Chart Skeleton. Define a Chart Skeleton.
284
Tabular: Generate a tabular
286
6.6.1 Generate Statistic Report From Report Template
The Statistic Report Generation dialog is accessed by selecting Report Generation
from the Statistic menu on the Main Window.
The process is similar to that described for generating a report from the Report Template
Builder for Measurement Data. Time and dimension filters can be applied.
You can simply change the data scope to apply the same report template to different data
source.
288
6.8 Statistic Data Cleanup
The Statistic Data Cleanup function cleans up the selected data from the statistic
database.
The function is accessed by selecting Statistic Data Cleanup from the Statistic menu on
the Main Window.
Specific Data
Use the Specific Data tab to select data to be purged from the database.
Date Range
Use the Date Range tab to identify data to be purged from the database by date.
Drag-and-drop the desired maps from the list of available GIS maps on the left pane into the
list of default GIS maps on the right pane.
If no GIS map group exists, a dialog will pop up to ask whether a new one should be created.
You can also click the Add button on the toolbar to create a new map group. More than
one GIS map can be added to a group.
290
6.10 Default Network Configuration Builder
The Default Network Configuration Builder function allows you to select a network
configuration from the existing list and build a default network configuration list. In the
Dashboard, Cube Viewer, and Report Generator, based on the bounding rectangle of the
statistic data, TEMS Discovery will determine what cell sites to be displayed in the view from
this default network configuration list.
This function is accessed by selecting Default Network Configuration Builder from the
Statistic menu on the Main Window.
Drag-and-drop the desired configuration from the list of available network configurations on
the left pane into the list of default network configurations on the right pane.
NOTE: The existing networking configuration lists are collected from measurement data
projects. See Import Network Configuration for more information.
NOTE: Prior to using this feature, the user will need to configure the default statistic database
in the Statistic Database dialog, providing the correct user name and password.
The Statistic Database dialog is accessed by selecting Configuration |
Options | Statistic Database from the Main Window.
292
Delete. Delete the selected user (or user group).
Save. Save the user group.
Help.
Use the checkboxes in the three panels on the Database User Access Permission window
to limit user group access according to:
Specific cubes
The data in specific projects
Device attributes in specific files/devices.
Help.
294
6.13 Measurement Data Server List
The Measurement Data Server List is a list of servers that contain measurement data
that contributes to the current statistic database.
If the IP address of a server that processes measurement data and provides statistic data has
been modified, you will need to update the information in this dialog.
The Measurement Data Server List is accessed by selecting Measurement Data
Server List from the Statistic menu on the Main Window.
Help.
296
7 Configuration and Settings
The following sections describe the interface for TEMS Discovery configuration and
settings.
Configuration Management
Metric Frame Import Configuration
Generic Text DT Data Import Configuration
Data Networking
ADP Management
Email Templates
Batch Configuration
Message Coloring
Messages View KeyInfo Settings
Point Detail Settings
Instant Chart Configuration
Options
If you turn on the Automatically update from the FTP server before generating
Reports option, TEMS Discovery will automatically update your TEMS Discovery
configurations based on the latest published configurations on the specified FTP server before
generating reports or before generating output by the ADP tasks.
Once an FTP server is set up, you can use the action buttons on the Configuration
Management toolbar to publish the selected configurations to the FTP server or to make
updates if new published configuration files are available on the FTP server.
To publish configurations to the FTP server, select the configuration tree nodes to be
published, and then click the Publish button on the Configuration Management
toolbar.
To update configurations from the FTP server, simply click the Update button on
the Configuration Management toolbar, and TEMS Discovery will automatically
check the specified FTP server's folder, download any new configuration files, and
import them into TEMS Discovery.
Content Editable. The exported content will be totally open for modification.
Content View-only. The exported content can be viewed only and cannot be
modified.
Content Hidden. The exported content cannot be viewed and will totally hidden from
the GUI.
Content Password Protected. The exported content will be protected from view
and modification. However, by providing the correct password, the user can
deprotect the content and both view the content and make modifications.
Usage/Content Password Protected. The exported content cannot be viewed or
modified. However, by providing the correct password, the user can use it but will not
be able to deprotect the content.
Update. Update the TEMS Discovery configuration from the FTP server.
Help.
Exit.
Update.
Publish.
Help.
Exit.
To define a user-defined metric group from scratch, follow the steps below:
1. Click the Browse button to locate the delimited text file you intend to
import.
TEMS Discovery will display the first few lines of the selected file in the Partial
Preview tab, and populate the Source Column/TD Metric Name in the
Configuration tab. The names in Source Column/TD Metric Name are simply
copied from the column headers of the selected text file. Since the TD Metric
If the data source contains a special value that indicates an exception, you can put that
value in the Exception Val column, or if you want to exclude a range of values, you can
define that range in the Exception >=" and "Exception <= columns. TEMS Discovery
will not import the exception value, but will set it to No Data.
integer Similar to the data type float.
text Assign this data type if the data source is text.
Save As. Save the current metric group configuration under a new name.
Help.
Save As. Save the current metric import configuration under a new name.
Help.
Save As. Save the currently displayed plot band as a new plot band.
Generator. Generate a new plot band definition from scratch. This option will bring up the Plot Band
Auto Generator.
Insert Band. Insert a band to the spreadsheet.
Help.
Settings. The plot band definition will always include the first band that is from the
minimum and the last band that is up to the maximum. You need to define the second
band and the second-to-last band. For the middle bands, you can define the number of
bands and the step.
Colors. Define the color of the first and last bands, respectively, by clicking
Color of first band and Color of last band. For the rest of the bands, after
defining the start and end colors, the colors will be generated automatically.
Click Generate, and the plot bands will be generated automatically and the
spreadsheet will be populated.
Two steps are required for creating and using a user-defined parameter:
Create a threshold set.
Create an alias in a script for the user-defined parameter. These
steps are described below.
3. Find the UDP name (the Compact Name defined when you created the
threshold), drag it into the Alias list, and give it an alias.
4. Use the alias in your script.
Save As. Save the current threshold settings under a new name.
Help.
Each attribute listed on the Attributes tab can be Each problem set listed on the Problem Sets
selected to be used with comma separated tab can be checked with a minimum value to be
values to construct the dynamic dataset. used to construct the dynamic dataset.
If you enter specific key values for the metric under the Options of current metric section,
separated by commas, TEMS Discovery will generate output only for the metrics that have the
specified key values. Otherwise, the metric for each key value will be output.
You can define or select a map group so that all the metrics with the same group name are
displayed in the same Map View. Otherwise, each metric will be displayed in the Map View
alone.
Drag-and-drop any Script Event from the tree view on the left into the spreadsheet on the
right.
You can add as many events as you need, and you can modify the Before Time and
After Time for each event.
Typing directly into the Event column in the spreadsheet is not recommended because if you
make a syntax error, that event will not be used in the filter.
Drag-and-drop an element from the tree view into the spreadsheet on the Signaling
Message tab in the right panel. Click the cell in the Color column to choose a color. You
can associate a message or a channel with color. If color is associated to a channel, all
messages in that channel will be displayed in the same color in the Messages View.
Or, you can manually type keywords into the spreadsheet on the Case-sensitive Keyword
tab and associate a color. When building the Messages View, TEMS Discovery will check
whether the key information of a message contains any defined keywords, one-by-one, from
the first row to the last. If found, the background color of the row on the Messages View will
be colored accordingly. The order of the keywords in the spreadsheet will affect the coloring.
Click the Save button to save the color settings after any modification.
Save As. Save the current Instant Chart configuration under another name.
Help.
NOTE: TEMS Discovery peers must run in the same local network. In other words, TEMS
Discovery cannot connect to TEMS Discovery peers through a router.
Make myself visible to peers. Check this option and provide the requested
authentication information to make TEMS Discovery visible to other TEMS Discovery peers
running on remote computers.
Authentication Methods. To verify the identity of users who attempt access, use the
settings in this section to authenticate users and thus prevent unauthorized users from
establishing a TEMS Discovery TCP connection.
Anonymous access. Select this option to allow users to establish an
anonymous connection. Your server logs on the user with an anonymous or guest
account.
Basic authentication. Select this option to enable the Basic authentication
method for TEMS Discovery peers.
Important: Basic authentication results in the transmission of passwords across the
network in an unencrypted form. It is possible for a third party equipped with a network
monitoring tool to intercept usernames and passwords.
Integrated Windows authentication. Integrated Windows authentication uses a
cryptographic exchange to confirm the identity of the user. TEMS Discovery, serving
as a data sharing server, will require that the user be a Windows user of the computer
that hosts this instance of TEMS Discovery. (Please see Windows operating system
Help for more information on how to add a user to a computer.)
Once all servers are set up and PC1~PC4 are running TEMS Discovery Professional as
described above, you can:
1. Create two mapped network folders.
These two mapped network folders will be accessible by all PCs with a common drive
and folder name (e.g., x:\monitored_folder, y:\private_data_folder). These folders can
be physically in one server or in separate servers.
Shared Source Folder. Drive test data to be processed is placed in this
folder. When the ADP task is created in the dispatcher, this folder will be
configured to be monitored.
Shared Private Folder. This folder will hold the processed data. For all
PCs, set this folder as a Private Data folder in the Options dialog
(Configuration | Options | Data Storage).
2. Set each of the Processing Servers (PC2~PC4) as Can be a member (Data
Networking dialog).
3. Set PC1 as Dispatcher (Data Networking dialog).
4. Add Processing Servers (PC2~PC4) as members of a distributed network to
Dispatcher PC1 (Data Networking dialog).
5. Create an ADP task in Dispatcher PC1 to monitor the Shared Source folder.
6. Start the ADP task from Dispatcher PC1.
This distributed processing system (DPS) will act once new log files arrive in the
Shared Source Folder.
Each available global UDR can be used to match against one project and dataset.
A predefined default project named _No_UDR_Matched_Project will be used as the target
project and _UDR_Match_Default_Dataset will be used as the target dataset if:
You selected the Use global UDR specified project/dataset option when the data
was imported.
No project and/or dataset name was specified for a global UDR and a drive test
overlaps, or the drive test data doesn't overlap with any global UDRs.
User-defined Attributes
Users can define any number of attributes and assign values to them. These attributes can then
be used to group data for display or to identify data for reporting.
The device attributes assignment can be saved as a template, and it can be configured to
automatically assign device attributes at the time drive test data is imported. (See Import Drive
Test Data and ADP Management for more information.)
With conditional editing, you can define a condition that checks for certain text phrases in the
file name. You can include the wildcard (*) in the text phrase to create more flexible condition
checking.
Time Offset
Time offset is a special device attribute that can be set to artificially offset the data
collection time. This is extremely useful if you want to synchronize messages from
different devices.
If Zip all attachment to single file with name is checked, all the attached data or
reports will be compressed to a single ZIP file, under a user-defined name.
Enable Multi Threading Processing. When importing multiple drive test data
files, TEMS Discovery can create multiple threads with one thread for each imported
file. The number of threads will equal the number of processors the computer has
(dual-core computers have two processors, and quad-core computer have four).
However, the more threads that are created by TEMS Discovery, the more memory
will be consumed. The computer must have sufficient memory to support this
function; otherwise, the multi-threading processing feature will only slow down
processing.
You can also use this option to turn off multi-threading processing.
Text Font. Define the font for the TEMS Discovery application. Clicking the
Text Font cell in the Value column will bring up the dialog to define a font.
Text Color. Define the color of the font by clicking the Text Color cell in the
Value column, and then selecting a color.
Max. Sector-Point Link Distance (km). Define the maximum distance of sector
coverage. This value will affect all the functions that associate the drive test data
point and sector.
Sector Filtering Based On. In the Data Explorer, a sector group can be
selected to filter the data points. There are two options for filtering:
All: A data point will be picked if it is covered by any of the sector in this
sector group.
Top 1: A data point will be picked only if the Top 1 serving sector at this geo
location is in this sector group.
WiMAX Default Version. Select the WiMAX default version for decoding.
### [W] the home page for the video. NOT REQUIRED
### [B] video file base. Shall only define one [B]. REQUIRED
### List all video files one by one, using the following format
### [C] Category of the video
### [D] Description of the video
### [H] Hyperlink to the video file
[W]
http://nqlweb.tems.net/TEMS_Discovery/DiscoveryGE/Video/VideoHom
e.htm
[B] http://www.ascom.com/en/index
[C] Introduction
[D] TEMS Discovery
[H] tems-flash-discovery.htm
[C] Introduction
QVoice: CDMA Scanner Processing Cutoff Ec/Io (-28 to -15 dB). When
importing QVoice CDMA scanner data, ignore the PNs with Ec/Io values weaker
than the cutoff specified here.
Max. Allowable Time Interval for GPS Interpolation (1 to 600 sec.). If the
time interval of two good GPS positions is longer than this maximum allowable time
interval, no GPS interpolation will be performed for the messages captured in this time
period. In other words, those messages will not be visualized in the Map View.
Generate Statistic Data Along with Table View. If set to True, statistical data of
the metric will be calculated and displayed in a separate sheet. If the statistical data is
not needed, set to False for better user interface performance.
Sampling of PCAP ACK Message Within (ms) (-1 for no sampling). A log
file could contain millions of PCAP ACK messages, which not only increase data
processing time, but also consume huge memory. Those ACK messages can be safely
skipped. TD can sample ACK message in user-defined time interval, or if -1 is set,
will not perform sampling.
Max. Number of Files To Be Listed For Each Dataset (0 for no limit). Limit
the number of file/device to be listed for each dataset for performance purpose. If set to
0, all file/devices will be listed.
GIS: Default Font Character Set. If GIS vector data contains certain non-
Unicode characters, the display may not proper. This option will allow the user to
define the proper character set which will take effect after restarting TD.
Max Cube Process Interval in Miutes. The interval for processing cubes.
Statistic Browser: Latitude range for Map View display (degree). Define the
area for browser to load statistic data. The geo center of this area is defined in “Cube
Data Scope Configurations”.
Folder Configuration
The user can specify a dedicate folder to storing system configuration files and
temprary data as well.
As a general guideline, the system data folder shall be in local machine, and the temp file
folder shall be located in a fast drive that has plenty of free space, and try to avoid C drive.
Use Flat File for data storage. This option is the default. If desired, you can
select one folder for Private data and another for Public data. For TEMS Discovery
Enterprise, the default data storage is SQL server.
Use MS SQL Server for data storage. With this option, you should install at least
MS SQL Server Enterprise 2008 R2. After the SQL server installation is done, check
the Pick a local SQL Servers to list available SQL servers in the local area network.
You can select one of the SQL servers and the database for TEMS Discovery will be
automatically created. You can also type in a remote SQL server and connect to an
existing remote database.
You can make the selection for Private Database and/or Public Database, then click
Save and exit from the dialog. TEMS Discovery will be restarted to reflect the
change.
If the SQL server you have picked is in a remote server, you will need to configure the
path for database data as below.
Temp file folder for SQL data transfer. (UNC path, Mandatory if SQL server
is in remote machine). When you run TEMS Discovery Enterprise and connect to
the SQL server in a remote server, you must provide the path to the temporary folder
that will be used for TEMS Discovery to dump text files for the remote SQL server to
perform data transfer.
NOTE: Microsoft SQL Server 2008 R2 Enterprise version with Analysis Service must be
accessible from the user’s computer in order to use this dialog.
Temp file folder for SQL BulkInsert. (must be UNC path in remote server if
database in in remote server). When you run TEMS Discovery Enterprise and connect to
the SQL server in a remote server, you must provide the path to the temporary folder that will
be used for TEMS Discovery to dump text files for the remote SQL server to perform
BulkInsert.
NOTE: Microsoft SQL Server 2008 R2 Enterprise version with FILESTREAM enabled must
be accessible from the user’s computer in order to use this dialog. Please see Enabling
FILESTREAM in SQL Server 2008 R2 for more information.
The Log Files dialog is reached by selecting Configuration | Options | Log Files from the
Main Window.
The Color Scheme options allow you to associate one color for each data type displayed in
the tree view. Clicking on a cell in the Color column will bring up a dialog in which you can
choose a color.
As an option, you can check Use System Color instead of this color scheme to
apply one color for all data types.
Clicking the Import Drive Test Data button in the Walk-U-Through wizard
toolbar.
Once you click Import, the task will be placed into the task queue for scheduling, and its
status will be indicated in the Task Window. After the data is imported, it will be listed in the
Project List and the Data Explorer.
Currently, TEMS Discovery supports the import of Ericsson UETR files. You can select one or
more UETR files and import those files into the selected project and dataset.
You can adjust UETR messages by defining your time zone.
After a UETR file is imported, it will be listed under the selected dataset with its sub- network
name as the file name and IMSI as the device name. If you want to view how the UETR
message is aligned with the drive test data, you can drag-and-drop the corresponding UETR
message frames (in red color) from the drive test data listing to the Messages View. Then,
TEMS Discovery will only display the UETR messages within the time span of the drive test
data.
TEMS Discovery can import network configuration files of the following formats:
TEMS .cel or .xml files for GSM and WCDMA. These files can be imported
directly without requiring additional mapping by the user.
ACTIX™ cellref. These files can be imported directly without requiring
additional mapping by the user.
ASSET™ .xml files for GSM and WCDMA. These files can be imported
directly without requiring additional mapping by the user.
ATOLL™ .xml files. These files can be imported directly without requiring
additional mapping by the user.
Ericsson Bulk CM files. These files can be imported directly without requiring
additional mapping by the user.
Text delimited files. Any text delimited file can be imported, although a first- time
parameter mapping must be done by the user. Afterward, the mapping configuration
can be saved and shared across multiple users for future import.
Additional information, other than the information required/preferred above, can also be included in
the file and imported into TEMS Discovery.
Site12 Site12_O 120.9552 -40.8872 0.2 360 360 Repeate r 16761 40422 62 0 0 0 60 85
The format of longitude and latitude can also be like E 120.9445, N 40.88181, using N, S, E, or
W instead of the + or – signs.
Target project and Scenario Name. To associate a new name to the network
configuration, select or enter a new project name in Target Project, then select or enter a new
scenario name in Scenario Name.
Mapping Configuration. The mapping can be saved as a mapping configuration that can
be reused to import network configurations of the same data format.
There are two options:
Existing. Select and apply an existing mapping configuration from the dropdown
menu in the Mapping Configuration panel; changes made to the mapping
configuration will be saved.
Save as new. Build a new mapping configuration and save.
To delete any mapping configurations, select a mapping configuration from the
dropdown menu and click Delete.
After you have selected the files and clicked the Import button, the task will be placed into the
task queue for scheduling and its status will be indicated in the Task Window. After the data
is imported, the imported file will be displayed in the Antenna Pattern Viewer, and can be
assigned to a sector parameter in the Cell Configuration Editor.
NAME 420
FREQUENCY 455
H_WIDTH 360
V_WIDTH 7
FRONT_TO_BACK 0
TILT ELECTRICAL
gain 9.2 dBI
Polarization VERTICAL
Comment
HORIZONTAL 360
0 0.2
1 0.2
2 0.2
...
353 0.2
354 0.2
355 0.2
356 0.2
357 0.2
358 0.2
359 0.2
VERTICAL 360
0 0
1 0.5
2 1.4
3 2.6
....
354 8.2
355 5.1
356 2.9
357 1.4
358 0.5
359 0
You can select multiple GIS data files in various formats, then select or enter a new geo folder
in the field, and click Import. The import task will be placed into the task queue for scheduling,
and its status will be indicated in the Task Window. After the data is imported, the imported
data will be listed in the GIS List and the GIS/Coverage Map tab in the Data Explorer.
As a reference, the following is a partial list of spatial data products and formats that can be
imported into TEMS Discovery. However, it is strongly recommended to attempt import of any
GIS data, even if it is not known whether that format is supported.
USGS Digital Line Graph, Optional Format (DLG-O)
USGS Digital Line Graph, Spatial Data Transfer Standard Format (DLG/SDTS)
USGS Digital Elevation Model (DEM)
USGS Digital Elevation Model, Spatial Data Transfer Standard Format
(DEM/SDTS)
USGS Digital Elevation Model, GeoTIFF Format
USGS Digital Raster Graphic (DRG)
USGS Digital Orthophoto Quads (DOQ), Native USGS Format
USGS Digital Orthophoto Quads (DOQ), GeoTIFF Format
The procedure for importing a coverage map is similar to that of importing GIS data.
Save TEMS Discovery Document. Multiple projects and display data can be
opened and shown in multiple views, then saved as a TEMS Discovery document.
All data, including the view layout, will be saved. To open a TEMS Discovery
document, select from the list in Document List
Save View Layout. The current view layout can be saved and restored for any
project by right-clicking the target project in the Project List and selecting Open
View Layout from the context menu.
Save Analysis Set. Save the current view layout, along with the type of data
currently displayed as an Analysis Set. This analysis set can then be applied to any
mobile data by right-clicking a target mobile in the Project List or Data Explorer–
Dataset and selecting Open Analysis Set from the context menu. It can also be
selected when opening a project/device in the Walk-U-Through wizard.
NOTE: Since TEMS Discovery is not intended for network planning purposes, its editing
capacity is limited. TEMS Discovery does not provide the functions to add or remove
new cell sites or sectors, but does allow a user to modify parameter values or to
add/remove parameters (see Edit Cell Configuration and Edit Cell/Sector Parameters
for more information).
The Cell Configuration Editor contains four spreadsheets of information for cell sites, sectors,
technology, and the neighbor list. You cannot add or delete cell sites or sectors, but you can
modify the values of the parameters and add new parameters. In
Copy the Selection to Clipboard. Copy the text in the selected cell to the Clipboard.
Paste to the Specified Cell. Paste the text into the selected cell.
Search Text. Bring up the Search dialog to search text in the spreadsheet.
Help.
Highlight in Map View. Put a red flag in the site that is selected in the spreadsheet.
Save as Sector Group. Save the sectors listed in the spreadsheet as a sector group with name.
Remove Selected Column. Remove the selected parameter from the spreadsheet.
Shift the Selected Cells to Left. Move the selected neighbor to the left.
Shift the Selected Cells to Right. Move the selected neighbor to the right.
Remove the Selected Cells. Remove the selected neighbor from the list.
To search for a particular sector, create an expression containing the parameters of the
Cell Site, Sector, or Carrier, in the respective “Expression for” window.
Drag-and-drop the parameter name from the list on the left side into the corresponding editor on
the right side. The supported concatenation operators, logical operators, and arithmetic
operators are listed on the far right. Click one of the buttons and the corresponding operator will
be placed in the active editor.
The expressions can be saved with a name, after which the expression name will be listed in the
Data Explorer–Cells tab under the target scenario in cell configuration. You can use this
expression to search for sectors and highlight them in the Map View. The sectors can be saved
into a sector group, which can then be used to filter drive test data.
This dialog contains multiple sheets containing information on the Site, Sector, Carrier and
Neighbor List. You can modify the value of the parameters and save them permanently. You
can also export the information to an Excel file.
Using the Add Column or Remove Column buttons on the toolbar, you can also
add or remove a sector of the cell site, or add or remove a carrier of the cell site.
Drag-and-drop a parameter from the tree view on the left side into the Logic pane on the right
side. For each parameter, define its range in the spreadsheet. Multiple parameters can be
dragged into Logic pane, and their levels can be modified by dragging-and-dropping them to
the desired level. All configurations can be saved with a name.
From Data Explorer–Cells, right-click a scenario version and select Apply Grouping
Logic from the menu. The name of the configuration and the logical display of cell
configuration will refresh and be grouped as defined, as shown below:
You can select a cell configuration and generate a neighbor list work order based on two
versions. After the work order is generated, click Save to File to save the result to an Excel
file or a tab-delimited text file.
which is the aggregation method pre-defined in TEMS Discovery by the nature of the data.
However, you have the option to overwrite this default aggregation method by selecting any
other from the combo box. The available binning types are: AVG, LAVG, MIN, MAX,
COUNT, SUM, FIRST, and LAST.
After you select a base metric in the right panel, go to the combo box labeled Delta with: and
select the option to generate delta with another metric, with coverage map (see Import Coverage
Map), or with None. If None is selected, TEMS Discovery will actually perform geo-location
binning for the selected base metric with the selected binning type. You can also add an offset
to the result of each bin so that you can create more meaningful metrics.
Best EcNo. The strongest EcNo (dB) recorded for the serving cell across all bins in
which the respective serving cell and secondary cell were seen together.
Best RSCP. The strongest RSCP (dBm) recorded for the serving cell across all bins in
which the respective serving cell and secondary cell were seen together.
DL interference. The mean downlink interference reported by the scanner
across all bins in which the respective serving cell and secondary cell were seen
together.
Max d. The maximum distance (meters) reported between the measured BIN and the
secondary cell, across all bins in which the respective serving cell and secondary cell
were seen together.
Distance between cells. The distance (meters) between the serving cell and the
respective secondary cell.
Too many servers event count. The number of Too many server events was
triggered across all bins in which the respective serving cell and secondary cell were
seen together. The definition for Too many server can be configured as shown in
user interface.
Distance samples. The number of distance measurement samples were
recorded in which the respective serving cell and secondary cell were seen
together.
d < 1000, 1000 < d < 5000, d > 5000
Distance, km. The distance between the serving cell and the suspected cell
C/I Average. The C/I average of all bins in which the respective serving cell and
suspected cell were seen together.
C/I Std_Dev. The C/I standard deviation of all bins in which the respective
serving cell and suspected cell were seen together.
C/I Worst. The worst C/I of all bins in which the respective serving cell and
suspected cell were seen together.
Sample Count. The count of all bins in which the respective serving cell and
suspected cell were seen together.
Bad Count (C/I). The count of the bins in which the respective serving cell and
suspected cell were seen together and C/I is less then threshold.
Bad Count (C/A). The count of the bins in which the respective serving cell and
suspected cell were seen together and C/I is less then threshold.
ITR C/I. Interference traffic rate
ITR C/I, %. The lost traffic percentage for serving sector due to co-channel
interference.
ITR C/A, %. The lost traffic percentage for serving sector due to adjacent
channel interference.
8.1.1 CDMA_Events
Event Category Event Description
Call Ending Call Drop
MT Call Drop
MO Call Drop
Call Network Release
MT Call Network Release
MO Call Network Release
Call Mobile Release
MT Call Mobile Release
MO Call Mobile Release
On Incoming Call @ EOF
On Outgoing Call @ EOF
On Call @ EOF
Call Setup Results On Incoming Call Setup @ EOF
Call Setup OK
Outgoing Call OK
Call Fail
Outgoing Call Fail
Incoming Call Fail
Incoming Call OK
Outgoing Call Setup Failure
Call Setup Failure
On Incoming Call @ SOF
CDMA Search Window SRCH_W_N too small
CDMA Soft Handoff Consecutive Handoff Direction
Soft Handoff Complete
Soft Handoff 2-Way
Soft Handoff 3-Way
Soft Handoff 4-Way
Soft Handoff 5-Way
Soft Handoff 6-Way
Soft Handoff Failed
EVDO_Handoff EVDO Single Server
EVDO 2-Way Softer
EVDO 2-Way Soft
EVDO 3-Way Softer-Softer
EVDO 3-Way Soft-Softer
EVDO 3-Way Soft
EVDO 4-Way Soft
EVDO 4-Way 2 Softer
380
Not Categorized Events
On Incoming PS Call Setup @ EOF
On Outgoing CS Call Setup @ EOF
Outgoing PS Call Fail
PS Call Fail
Outgoing PS Call OK
PS Call OK
Incoming PS Call Fail
Incoming PS Call OK
Outgoing PS Call Setup Failure
CS Call Setup Failure
PS Call Setup Failure
EV-DO to 1xRTT
1xRTT to EV-DO
Supplemental Channel Assignment
Entering 1x Traffic Mode
Entering 1x Idle Mode
Dedicated_SOF
On Call at Start of File
On Incoming CS Call @ SOF
On Incoming PS Call @ SOF
On Outgoing CS Call @ SOF
Access Probe
Access Probe Retry
Origination Message
Page Response Message
Base Ack-to-Access Request
ECAM Received
BaseAckFTC
MSAckRTC
Call Blocked
8.1.2 EVDO_Events_Logbased
Event Category Event Description
N/A EVDO Access Failure EVDO
Access Success EVDO
Acquisition Failure EVDO
Acquisition Success EVDO
Connection Failure EVDO
Connection Success
EVDO Connection - Access HO
EVDO Connection - User Abort
EVDO AT Close
EVDO AN Close
EVDO Abnormal Release
8.1.3 GSM_WCDMA_Events
Event Category Event Description
.Common Entering WCDMA Dedicated Mode
Entering GSM Idle Mode
Entering WCDMA Idle Mode
Dedicated Mode at SOF
Paging Answered
Attach and Detach PS Attach Failure
PS Attached
PS Detach Failure
Network-initiated PS Detach
UE-initiated PS Detach
Channel Type Switching R99-to-HS Switching
Cell_FACH-to-Cell_DCH
Cell_FACH-to-Cell_DCH Failed
HSPA Mode Entered
HS-to-R99 Switching R99
PS Mode Entered Entering
Cell_DCH Failed to Enter
Cell_DCH Transition to
Cell_FACH
Dedicated Channel Not Allocated
Data Transfer Ready
Data Transfer Request with Cell Update
Data Transfer Request with E4a
Compressed Mode Entering Compressed Mode
Leaving Compressed Mode
Dropped on Compressed Mode
Critical RF Conditions Lack of Dominant Pilot
Pilot Pollution Alert
Poor Active Set Pilot Quality
Strong DL Interference Alert
Weak Pilot Alert
GMM Service GMM Service Request
MO GMM Request for PDP Deactivation
MT GMM Request for PDP Deactivation
GPRS Packet Access GPRS Packet DL Transfer Done
GPRS Packet Access Failure GPRS
Packet Access Success
GPRS Packet Access Retry
GSM RR Setup GSM Channel Request Failure
GSM Channel Request Success
GSM Channel Request Retry
Idle Procedures Registration Failure
Registration Success
382
Event Category Event Description
IRAT Entering GSM from WCDMA
Entering WCDMA from GSM
Measurement Report Events e1a - Above Reporting Range
e1b - Below Reporting Range
e1c - Nonactive Better than Active
e1d - Change of Best Cell
e1e - Above Abs Threshold
e1f - Below Abs Threshold
e2a - Change of Best Frequency
e2b - (Q @ Own F<Thr1) & (Q @ Other F>Thr2)
e2c - Q @ Other F > Threshold
e2d - Q @ Own F < Threshold e2e
- Q @ Other F < Threshold e2f -
Q @ Own F > Threshold
e3a - (Q @ Own F<Thr1) & (Q @ Other RAT>Thr2)
e3b - Q @ Other RAT < Threshold
e3c - Q @ Other RAT > Threshold
e3d - Q @ Other RAT - Best Cell Change e4a
- RLC Buffer Above Threshold
e4b - RLC Buffer Below Threshold e5a -
CRC Errors Above Threshold e6a - UE
TX Power Above Threshold e6b - UE
TX Power Below Threshold e6c - UE
TX Power Hits Minimum e6d - UE TX
Power Hits Maximum
e6e - RSSI Hits Dynamic Receiver Range e6f
- Rx-Tx Time Difference > Threshold e6g -
Rx-Tx Time Difference < Threshold
Consecutive e1a~c Requests
Missing Neighbor Alerts Missing Neighbor Alert
Mobility Location Update Failure
Location Update Success
Routing Area Update Failure
Routing Area Update Success
PDP Activation PDP Context Activation Failure
PDP Context Activated
PDP Context Activation Request
PDP Deactivation PDP Abnormal Deactivation Request
PDP Context Deactivation Failure PDP
Regular Deactivation Request
PDP Context Deactivated
RRC Release RRC Connection Release
RRC Setup RRC Connection Setup Fail RRC
Connection Setup Rejected RRC
Connection Request Retry
RRC Connection Setup OK
RRC State Transition Cell_PCH-to-Cell_FACH
Cell_DCH-to-Cell_PCH
Cell_DCH-to-Cell_FACH
Cell_DCH-to-URA_PCH
Cell_FACH-to-Cell_PCH
384
Not Categorized Events
MO CS Call Abnormal Release
MT CS Call Dropped
MT CS Call On-Call @ EOF
MT CS Call NW Release (Normal Cause)
MT CS Call MS Release (Normal Cause)
MT CS Call Abnormal Release
Re-established CS Call Dropped
Re-established CS Call On-Call @ EOF
Re-established CS Call NW Release (Normal Cause)
Re-established CS Call MS Release (Normal Cause)
Re-established CS Call Abnormal Release
GSM CS Call Dropped
GSM On-Call @ EOF
GSM Call - Low Speech Quality
GSM Call MS Release (Normal Cause)
GSM Call NW Release (Normal Cause)
MO GSM Call Dropped
MO GSM On-Call @ EOF
MO GSM Call MS Release (Normal Cause)
MO GSM Call NW Release (Normal Cause)
MT GSM CS Call Dropped
MT GSM On-Call @ EOF
MT GSM Call MS Release (Normal Cause)
MT GSM Call NW Release (Normal Cause)
MO PS Call Dropped
MO PS Call On-Call @ EOF
MO PS Call NW Release (Normal Cause)
MO PS Call MS Release (Normal Cause)
MO PS Call Abnormal Release
MT PS Call Dropped
MT PS Call On-Call @ EOF
MT PS Call NW Release (Normal Cause)
MT PS Call MS Release (Normal Cause)
MT PS Call Abnormal Release
PS Call Dropped
PS Call On-Call @ EOF
PS Call NW Release (Normal Cause)
PS Call MS Release (Normal Cause)
PS Call Abnormal Release
Re-established PS Call Dropped
Re-established PS Call @ EOF
Re-established PS Call NW Release (Normal Cause)
Re-established PS Call UE Release (Normal Cause)
CS Call Re-establishment Retry
386
Not Categorized Events
MO PS Call Setup EOF
MO PS Call Setup Failure
MO PS Call Setup Success
MT PS Call Setup EOF
MT PS Call Setup Failure
MT PS Call Setup Success
On PS Call at Start of File
PS Call Setup EOF
PS Call Setup Failure
PS Call Setup Success
PS Call Re-establishment @ EOF
PS Call Re-establishment Failure
PS Call Re-establishment Success
CS Call Setup Start
MO CS Call Setup Start
MT CS Call Setup Start
On CS Call Setup at Start of File
CS Call Re-establishment Attempt
GSM Call Setup Start
WCDMA-to-GSM Redirected Call Setup Start
MO GSM Call Setup Start
MT GSM Call Setup Start
On GSM Call Setup at Start of File
GSM Call Re-establishment Attempt
MO PS Call Setup Start
MT PS Call Setup Start
On PS Call Setup at Start of File
PS Call Setup Start
PS Call Re-establishment Attempt
GSM Intercell Handover Failure
GSM Intercell Handover
GSM Intracell Handover Failure
GSM Intracell Handover
UMTS IFHO Attempt
UMTS IFHO Fail
UMTS IFHO OK
Radio Link Addition Failure
Radio Link Addition
Radio Link Addition (partial)
Radio Link Removal Failure
Radio Link Removal
Radio Link Removal (partial)
Radio Link Replacement Failure
Radio Link Replacement
8.1.4 LTE_Events
Event Category Event Description
LTE Attach LTE Attach Request
LTE Attach OK
LTE Attach Accepted
LTE Attach Rejected
LTE Attach Failed
LTE Detach LTE UE-initiated Detach Accepted
LTE UE-initiated Detach Completed
LTE EUTRA Reporting LTE RRC A1 Event
Events LTE RRC A2 Event
LTE RRC A3 Event
LTE RRC A4 Event
LTE RRC A5 Event
LTE Consecutive A3 Events
LTE Handover LTE Intra-frequency Handover Failed
LTE Intra-frequency Handover OK LTE
Inter-frequency Handover Failed LTE
Inter-frequency Handover OK
LTE InterRAT Reporting LTE RRC B1 Event
Events LTE RRC B2 Event
LTE Misc. Rejects and LTE Authentication reject
Failures LTE Service reject
LTE Bearer resource allocation reject LTE
Bearer resource modification reject LTE
PDN connectivity reject
LTE PDN disconnect reject
LTE Authentication failure
LTE Activate dedicated EPS bearer context reject LTE
Activate default EPS bearer context reject
LTE Modify EPS bearer context reject
LTE RRC Connection LTE RRC Connection Request
388
Event Category Event Description
LTE RRC Connection Complete
LTE RRC Connection Setup LTE
RRC Connection Fail
LTE RRC Connection Reject
LTE RRC Connection Release
LTE RRC LTE RRC Reestablishment Request LTE
Reestablishment RRC Connection Reestablishment LTE
RRC Reestablishment Reject
LTE Tracking Area LTE Tracking area update complete
Update LTE Tracking area update accept LTE
Tracking area update reject
LTE Tracking area update failed
8.1.5 Nemo_Events
Event Category Event Description
External application launch APP: External application launch
Call attempt CAA: Call attempt
Call connect success CAC: Call connect success
Call disconnect CAD: Call disconnect
Call failed CAF: Call failed
Incoming call CAI: Incoming call
Cell reselection CREL: Cell reselection
Data connection attempt DAA: Data connection attempt
Data connection success DAC: Data connection success
Data disconnect DAD: Data disconnect
Data connection failed DAF: Data connection failed
Data channel request DCHR: Data channel request
Data transfer completed DCOMP: Data transfer completed
Data transfer request DREQ: Data transfer request
Data stream status DSS: Data stream status
GPRS attach attempt GAA: GPRS attach attempt
GPRS attach connected GAC: GPRS attach connected
GPRS detach GAD: GPRS detach
GPRS attach failed GAF: GPRS attach failed
Handover/handoff attempt HOA: Handover/handoff attempt
Handover/handoff fail HOF: Handover/handoff fail
Handover/handoff success HOS: Handover/handoff success
Lock info LOCK: Lock info
Location update attempt LUA: Location update attempt
Location update fail LUF: Location update fail
Location update accepted LUS: Location update accepted
Measurement event information MEI: Measurement event information
Message sending/receiving attempt MSGA: Message sending/receiving attempt
Message sending/receiving failed MSGF: Message sending/receiving failed
8.1.6 QVoice_Markers
Marker Category Marker Description
Marker-Cell Reselection Cell Reselection
Marker-ETSI ETSI Marker
ETSI Invalid
ETSI ATD
ETSI ROFPCC
ETSI SOFPCC
ETSI FSYN
ETSI ROLPCC
ETSI ROFALPCC
ETSI ROAFSA
ETSI SOFG
ETSI ROPA250HELO
ETSI ROPA250EOM
ETSI POPRETR
ETSI PCFS
390
Marker Category Marker Description
ETSI SOLPCC (customer creation) ETSI
ROHALPCC (customer creation) ETSI
TCPRTD
ETSI conformity
ETSI VT_CALL_ACCEPTED
ETSI VT_AUDIO_CONNECTED
ETSI VT_VIDEO_CONNCETED
ETSI SPEECH_DELAY_SENT
ETSI SPEECH_DELAY_RECEIVED
ETSI VT_VIDEO_DELAY_SENT ETSI
VT_VIDEO_DELAY_RECEIVED
Marker-FTP FTP public 2 DL Start
FTP public 2 UL Start
FTP 2 DL Start
FTP 2 UL Start FTP
public DL Start FTP
public UL Start
FTP Downlink START
FTP Uplink START
FTP STOP
FTP public STOP
FTP CONNECT FTP
DISCONNECT
FTP public 3 DL Start
FTP public 3 UL Start
FTP 3 DL Start
FTP 3 UL Start
Marker-GPRS Attachment AttchRequest
AttachAccept
AttachComplete
AttachReject
DetachRequest
DetachAccept
Marker-GPRS PDP Context Activate PDP Context Request
Activate PDP Context Accept
Activate PDP Context Reject
Deactivate PDP Context Request
Deactivate PDP Context Accept Ras
Connect Start
Ras Connect Success Ras
Disconnect Start Ras
Disconnect Success
Ras Disconnect Completed
Ras Timeout
Ras Connection Lost
Marker-GPRS RAU RAUpdateRequest
RAUpdateAccept
RAUpdateComplete
RAUpdateReject
Marker-GPRS TBF Open Downlink
Open Uplink
Close Downlink
392
Marker Category Marker Description
MOC SystemRelease
MOC UserRelease
Marker-Pause Pause Start
Pause End
Marker-PING PING Start
PING STOP
PING High Resolution STOP
PING Start HR
Marker-POP3 POP3 Start Delete
POP3 Start Get
POP3 STOP
Marker-RRC State RRC State Idle
RRC State Connecting
RRC State Cell_DCH
RRC State Cell_FACH
RRC State Cell_PCH
URA_PCH
RRC State Out of zone
Marker-SMS SMS Start
SMS Start Old
SMS STOP
Marker-SMTP SMTP Start
SMTP STOP
Marker-Speech Unknown
Speech sample Start
Speech sample Stop
Evaluated part Start
Evaluated part STOP
Marker-STREAM STREAM STOP
Stream Overall Marker
QuickTime (QT) START
Real Media (RM) START
Windows Media (WM) START
MPEG-4 using QT START
3GPP using QT START
Marker-UDP UDP Downlink Start
UPD Uplink Start
UDP STOP
Marker-URA Update URA Update Marker
Marker-User Master
Slave
Marker-VT Video VT Video Unknown
VT Video First received frame
VT Video Last received frame
VT Video First received frame of training sequence
Marker-WAP WAP 2 Start
WAP Start
WAP STOP
Marker-WS WSP/HTTP Redirect M_SEND_REQ
WSP/HTTP Redirect M_SEND_CONF
394
Marker Category Marker Description
Not Acceptable
Proxy Authentication Required
Request Timeout
Conflict
Gone
Length Required
Precondition Failed Request
Entity Too Large Request
URI Too Large
Unsupported Media Type
Requested Range Not Satisfiable
Expectation Failed
Internal Server Error
Not Implemented Bad
Gateway Service
Unavailable Gateway
Timeout
HTTP Version Not Supported
WDP Error Receive failed WDP
Error Send failed
WDP Error Open failed
WDP Error not opened WDP
Error Out of memory
WDP Error Unhandled exception occured in the upper layer
WTP Error Abort
Marker-WS WTP Error Invalid Tid WTP
Error Unknown Ack WTP
Error Unknown PDU WTP
Error TPI Error WTP Error
Timeout
WTP Error result timeout
WTP Error result retry WTP
Hold-on acknowledge
WTP Error Maximum of invoke requests exceeded
WTP Error Memory allocation error
WTP Error Illegal Data
WTP Error Segmentation and Reassembly is disabled WTP
Abort unknown
WTP Abort protocol error
WTP Abort invalid tid
WTP Abort not implemented cl2
WTP Abort not implemented sar
WTP Abort not implemented uack
WTP Abort WTP version zero WTP
Abort cap temp exceeded WTP
Abort no response
WTP Abort message too large
WSP Abort protocol error WSP
Abort disconnect
WSP Abort suspend
WSP Abort resume WSP
Abort congestion
WSP Abort connect error
396
Not Categorized Markers
VT MOC Setup
VT MOC Connect
VT MOC ConnectFail
VT MOC Disconnect
VT MOC Release
VT MOC ReleaseError
VT MOC Break
VT MOC CallError
VT MOC SystemRelease
VT MOC UserRelease
VT MTC Dial
VT MTC Setup
VT MTC Connect
VT MTC ConnectFail
VT MTC Disconnect
VT MTC Release
VT MTC ReleaseError
VT MTC Break
VT MTC CallError
VT MTC SystemRelease
VT MTC UserRelease
VoIP MOC Dial (SIP Invite)
VoIP MOC Connect (SIP Invite OK)
VoIP MOC ConnectFail (Timeout)
VoIP MOC Disconnect (SIP Bye)
VoIP MOC Release (SIP Bye OK)
VoIP MOC ReleaseError (SIP Bye NOK or Timeout)
VoIP MOC Break
VoIP MOC CallError (SIP Invite NOK)
VoIP MOC SystemRelease
VoIP MOC UserRelease
VoIP MTC Dial (SIP Invite)
VoIP MTC Connect (SIP Invite OK)
VoIP MTC ConnectFail
VoIP MTC Disconnect (SIP Bye)
VoIP MTC Release
VoIP MTC ReleaseError (SIP Bye NOK or Timeout)
VoIP MTC Break
VoIP MTC CallError (SIP Invite NOK)
VoIP MTC SystemRelease
VoIP MTC UserRelease
398
Event Category Event Description
EV-DO Access Success
Attach and Detach PS Attach
PS Attach Failure
PS Detach
Call Ending Call End
Dropped Call
Call Setup Results Blocked Call
Call Established
Call Setup
Call Start Call Attempt
Call Attempt Retry
Call Initiation
CDMA Handoff Others Hard Handoff
Idle Handoff
Idle Handoff To Analog
Idle Handoff To CDMA
Idle Handoff To EV-DO
Traffic Handoff To Analog
Traffic Handoff To CDMA
Traffic Handoff To EV-DO
CDMA Soft Handoff Soft Handoff 2-Way
Soft Handoff 3-Way
Soft Handoff 4-Way
Soft Handoff 5-Way
Soft Handoff 6-Way
Soft Handoff Complete
Channel Type Switching Channel Switch R4 to R5 Channel
Switch R4 to R5 Failure Channel
Switch R5 to R4 Channel Switch
R5 to R4 Failure
PS Channel Type Switch Complete
PS Channel Type Switch Failure
Connection EV-DO Connection Failure
EV-DO Connection Success
EV-DO Session Failure
EV-DO Session Success
DCH Rate Switching PS RAB Channel Rate Switch Complete PS
RAB Channel Rate Switch Failure
EVDO_Handoff EV-DO Handoff 1 Active
EV-DO Handoff 2 Actives
EV-DO Handoff 3 Actives
EV-DO Handoff 4 Actives
EV-DO Handoff 5 Actives
EV-DO Handoff 6 Actives
Handover Handover Intracell
Handover Intracell Failure
Handover
Handover Failure
Handover From GAN
Handover From GAN Failure
Handover To GAN
400
Not Categorized Events
DNS Host Name Resolution Failure
DNS Host Name Resolution Time
Email Receive End
Email Receive Error
Email Receive Start
Email Send End
Email Send Error
Email Send Start
FTP Download Data Transfer Cutoff
FTP Download Data Transfer Time
FTP Download End
FTP Download Error
FTP Download IP Service Access Failure
FTP Download IP Service Setup Time
FTP Download Mean Data Rate
FTP Download Service Not Accessible
FTP Download Setup Time
FTP Download Start
FTP Upload Data Transfer Cutoff
FTP Upload Data Transfer Time
FTP Upload End
FTP Upload Error
FTP Upload IP Service Access Failure
FTP Upload IP Service Setup Time
FTP Upload Mean Data Rate
FTP Upload Service Not Accessible
FTP Upload Setup Time
FTP Upload Start
HTTP Data Transfer Cutoff
HTTP Data Transfer Time
HTTP End
HTTP Error
HTTP IP Service Access Failure
HTTP IP Service Setup Time
HTTP Mean Data Rate
HTTP Service Not Accessible
HTTP Setup Time
HTTP Start
MMS Receive Data Transfer Cutoff
MMS Receive Data Transfer Time
MMS Receive End
MMS Receive Error
MMS Receive Start
MMS Retrieval Failure
402
Not Categorized Events
WAP Activation Time
WAP End
WAP Error
WAP Page Data Transfer Cutoff
WAP Page Data Transfer Time
WAP Page Mean Data Rate
WAP Page Request Failure
WAP Page Request Time
WAP Portal Access Time
WAP Portal Not Accessible
WAP Site Access Time
WAP Site Not Accessible
WAP Start
Cell Change Order From UTRAN
Cell Change Order From UTRAN Failure
Cell Change Order To UTRAN
Cell Change Order To UTRAN Failure
Cell Reselection From UTRAN
Cell Reselection To UTRAN
Compressed Mode Entered
Compressed Mode Exited
Handover From UTRAN
Handover From UTRAN Failure
Handover To UTRAN
Handover To UTRAN Failure
Baton Handover
Baton Handover Failure
Hard Handover
Hard Handover Failure
Inter-frequency Handover
Inter-frequency Handover Failure
Radio Link Addition
Radio Link Addition Failure
Radio Link Removal
Radio Link Removal Failure
Radio Link Replacement
Radio Link Replacement Failure
3. In the SQL Server Configuration Manager snap-in, locate the instance of SQL Server
on which you want to enable FILESTREAM.
4. Right-click the instance, and select Properties from the context menu. The SQL Server
Properties dialog will be displayed.
404
User's Guide Appendix
5. Go to the FILESTREAM tab. Make the settings described below, and then click
Apply.
6. In SQL Server Management Studio, click New Query to display the Query
Editor.
7. In the Query Editor, enter the following Transact-SQL code:
8. Click Execute.
9. Restart the SQL Server service.
406
User's Guide Appendix
Index I
Images/Maps 76
A Intellectual Property Protection 300
Add Sources From File 80
Add SQL Server – Log Files Database K
337 KeyInfo Settings 84
Add SQL Server – Statistic Database KeyInfo Settings 316
336 Keywords 315
Antenna Pattern Data 352
API 358 L
Attributes 324
Label Display Options 95
C Layer 3 Information Elements 209
Legend display options 118 Listing
Calculate Area Statistics 268 Filters 46
Cell Configuration Editor 361
Cell Site Icon Size 95 Coverage M
Map Import 357
Message Flow Diagram 84
D
N
Data Filters 44
Database Browser 261 Neighbor List IntelliSense Tool 96
Database Cleanup 263
Database License Information 296 O
Dataset Route Direction 94 Default
Statistic Database 335 Detail View OLAP Cube Concept 265
84 Online GIS Data Sources 80
Direction 94
Display Cell Sites 95 P
Pick Serving Sector Tool 96 Plot
E Band Auto Generator 308
Edit Neighbor List Tool 96
Embed condition filter 212 R
Export Options 300 Remove Cell Sites from Display 96
Render settings 112
F Repetition in Report 225
Filtering Options 44 Repetition Key 206, 283
Route Direction 94
Functions Editor 169
S
G
Script Editor 169
GetGlobal flag 206
Search Script Results 47, 48
GIS data files 354 GIS
Sector Coverage tool 97 Sector
Data Sources 80
Selector tool 97 SetGlobal flag
GIS element display options 118
206
Global Mapper 80
Spatial Data Products and Formats 354
Spider Movement tool 115
H Spider Movement Tool 94
Handover Matrix 358 Statistic Dashboard 275
HO Matrix 358 Statistic Data Cube View 269
V
Vector Map Detail Loading 112
410