Focus Analyzer

Desktop User Guide

V2.0

Mar. 2021

www.sanworl.com
[email protected]
Focus Analyzer Desktop User Guide

Contents
1. Introduction .......................................................................................................................................... 5
2. Installation ............................................................................................................................................ 6
3. Focus Analyzer ...................................................................................................................................... 7
3.1. Analyzer Desktop ............................................................................................................................... 7
3.1.1. Main Toolbar ............................................................................................................................... 8
3.1.2. Appearance ................................................................................................................................. 9
3.2. Analyzer Windows Service ............................................................................................................... 10
4. Preferences ......................................................................................................................................... 11
4.1. General............................................................................................................................................. 11
4.2. File Storage....................................................................................................................................... 12
4.3. Cluster .............................................................................................................................................. 13
4.4. Measurement Database .................................................................................................................. 14
4.5. PCAP ................................................................................................................................................. 15
4.6. Email................................................................................................................................................. 16
4.7. Package ............................................................................................................................................ 17
4.8 Features ............................................................................................................................................ 17
5. Import Data ......................................................................................................................................... 18
5.1. Import Drive Test Data ..................................................................................................................... 18
5.1.1. Import Text Format ................................................................................................................... 20
5.1.2. Import TEMS FMT ..................................................................................................................... 21
5.5. Import Cell Configuration ................................................................................................................ 22
5.6. Import GIS Data................................................................................................................................ 23
6. Workspace .......................................................................................................................................... 24
6.1. Main Toolbar .................................................................................................................................... 26
6.1.1 Save and Display Profiles ........................................................................................................... 26
6.1.2 Toolbar Buttons ......................................................................................................................... 27
6.2. Data Tree .......................................................................................................................................... 28
6.2.1. Dataset ...................................................................................................................................... 28
6.2.2. Cell Configuration ..................................................................................................................... 34
6.2.3. GIS ............................................................................................................................................. 35
6.3. File / Device Explorer ....................................................................................................................... 36
6.4. Message View .................................................................................................................................. 39

Sanworl Studio, LLC © 2020-2021 1

Focus Analyzer Desktop User Guide

6.5. Table View ........................................................................................................................................ 41

6.6. Map View ......................................................................................................................................... 43
6.6.1 Hotkeys ...................................................................................................................................... 45
6.6.2 Dataset-Cell Spider Links ............................................................................................................ 46
6.6.3 Cell Radius Analysis .................................................................................................................... 47
6.6.4 Terrain Profiler ........................................................................................................................... 48
6.6.5 Geo Region ................................................................................................................................. 49
6.6.6 GIS Map ...................................................................................................................................... 50
6.6.7 Data Density ............................................................................................................................... 51
6.6.8 View Options .............................................................................................................................. 52
6.7. Time Chart ........................................................................................................................................ 53
6.8. Correlation Chart ............................................................................................................................. 54
6.9. Aggregation Chart ............................................................................................................................ 55
6.10. Pivot View ...................................................................................................................................... 57
6.11. Cell Coverage View......................................................................................................................... 58
6.12. Focus View ..................................................................................................................................... 59
6.13. Point Detail..................................................................................................................................... 60
6.14. Instant Chart .................................................................................................................................. 61
6.16. Media Player .................................................................................................................................. 62
6.17. Report Viewer ................................................................................................................................ 63
6.18. Dashboard Viewer.......................................................................................................................... 64
6.19. Indoor Map Rectifier ...................................................................................................................... 65
6.20. Playback Tool ................................................................................................................................. 66
7. Customization with Builders ............................................................................................................... 67
7.1. Analysis Engine Builder .................................................................................................................... 67
7.1.1 General Examples ...................................................................................................................... 68
7.1.2 Output Result with Unique Key ................................................................................................. 69
7.1.3 Script Debugger.......................................................................................................................... 70
7.2. Metric Group Builder ....................................................................................................................... 71
7.3. OLAP Cube Builder ........................................................................................................................... 72
8. Automation Task Builder..................................................................................................................... 73
8.1 Import ............................................................................................................................................... 73
8.2 FTP Monitor ...................................................................................................................................... 75

Sanworl Studio, LLC © 2020-2021 2

Focus Analyzer Desktop User Guide

8.3 Data Source ....................................................................................................................................... 76

8.4 Report Template ............................................................................................................................... 77
8.5 Output Scheduler .............................................................................................................................. 78
8.6 Output Location ................................................................................................................................ 79
8.7 Notification ....................................................................................................................................... 80
8.8 Database Purge & Vacuum ............................................................................................................... 81
9. Report Template Builder ..................................................................................................................... 82
9.1 General Tips ...................................................................................................................................... 84
9.2 Additional Settings ............................................................................................................................ 85
9.3 Report Item: Single Aggregation ....................................................................................................... 86
9.3.1 Single Metric Aggregation .......................................................................................................... 87
9.3.2 Event Time Offset Aggregation .................................................................................................. 88
9.3.3 % of Area .................................................................................................................................... 89
9.4 Report Item: Aggregation Chart........................................................................................................ 90
9.5 Report Item: Statistical Table ............................................................................................................ 92
9.6 Report Item: Pivot Table ................................................................................................................... 93
9.7 Report Item: Map View ..................................................................................................................... 94
9.8 Report Item: Map View – Delta Map ................................................................................................ 95
9.9 Report Item: Time Chart ................................................................................................................... 96
9.10 Report Item: Time Table ................................................................................................................. 97
9.11 Report Item: Correlation Chart ....................................................................................................... 98
9.12 Report Item: Cell Configuration Parameter .................................................................................... 99
9.13 Report Item: File/Device Statistical Table ..................................................................................... 100
9.14 Report Item: Constant .................................................................................................................. 101
9.15 Report Item: Loop/LoopKey .......................................................................................................... 102
9.16 Report Item: Profile Hyperlink ...................................................................................................... 103
10. Dashboard Builder ........................................................................................................................ 104
11. Configuration Management.......................................................................................................... 105
12. Tools .............................................................................................................................................. 106
12.1. Dataset Management .................................................................................................................. 106
12.2. Raw Data Repository .................................................................................................................... 107
12.3. Plotband Management ................................................................................................................ 108
12.4. Vendor’s Parameter Mapping ...................................................................................................... 109

Sanworl Studio, LLC © 2020-2021 3

Focus Analyzer Desktop User Guide

13. Specific Topic................................................................................................................................. 110

13.1. Indoor Map and Data ................................................................................................................... 110
13.1.1. Indoor Map Rectifier ............................................................................................................. 111

Sanworl Studio, LLC © 2020-2021 4

Focus Analyzer Desktop User Guide

1. Introduction
This document provides descriptions of features with guidance on the usage of the features within the
Focus Analyzer desktop application. Your access to functions and features will depend on your license.

Focus Analyzer, built on the FocusOne platform, is a scalable post-processing solution for wireless
network drive tests, offering comprehensive features for analyzing performance and troubleshooting
network issues, with customizable reporting and automation.

Focus Analyzer can be configured to run as a Windows desktop application (Analyzer Desktop), it can
run as Windows Service to provide unattended data processing service (Analyzer Service), or it can be
hosted in Windows IIS to provide web service (Analyzer Web). Analyzer Desktop and Analyzer Web can
run in a standalone machine. It can also be setup as a computer cluster with up to 255 nodes for
distributed processing and massive parallelism.

Setting up a computer cluster is simple with the Cluster Central Database options in the Preferences
dialog. For any Analyzer Desktop, Analyzer Web, or Analyzer Services installation node, if you select the
same Cluster Central Database, you will automatically connect to the same computer cluster from any of
the clients. Any node in the cluster can connect to or disconnect from the computer cluster at any time.

Each node in the cluster has its own measurement database for data import. If data import is done in
the “Public” environment, that set of data will be marked “Public” and available for any other nodes in
the cluster. The working environment for Analyzer Services is always “Public”. All the public data in the
entire cluster will logically be handled as one database to any node.

Sanworl Studio, LLC © 2020-2021 5

Focus Analyzer Desktop User Guide

With Analyzer Desktop, you can perform operations by:

• Pressing toolbar buttons

• Right-click mouse to bring up context menu and select a menu
• Drag-n-drop: press & hold the mouse at an item, move and then release the mouse in the target
area

It is strongly recommended to move the mouse and hover on each toolbar button to read the brief
description of its functionality. You can also press toolbar button to open Help file for information.

For any technical request or request a demo, please contact [email protected] or visit our website
at Sanworl.com.

2. Installation
Focus Analyzer Desktop is a Windows desktop application. If installed at the default location, the
application folder will be “C:\Program Files\Sanworl Studio\Focus Analyzer\” and the executable file is
“FocusAnalyzer.exe”. As part of the installation routine, a shortcut to the executable file will be placed in
Windows Start menu and on the desktop.

The installation routine will check for the prerequisite supporting software and install the following
software if they are missing.

• Microsoft .Net Framework 4.8

• PostgreSQL database server
• Visual Studio C++ 2013 Runtime Environment for a third-party component

Make sure you read the Quick Startup Guide that may be included in the ZIP file containing the
installation package, or up on the Sanworl documentation website. This document contains important
notes on the topic of installation.

When configuring PostgreSQL, if you do not use the recommended password and port as specified in the
installation instructions, you must configure database access within Focus Analyzer.

To configure PostgreSQL server to be accessed remotely, which is a must if you will setup computer
cluster, the following must be verified:

1. “listen_adresses” is equal to ‘*’ in PostgreSQL configuration file

“…\<Version>\data\postgresql.conf”
2. “host all all 0.0.0.0/0 md5” exists in PostgreSQL configuration file
“...\<Version>\data\pg_hba.conf”
3. Firewall allows the inbound connection to the PostgreSQL listening port.

Please refer to the PostgreSQL documentation at https://www.postgresql.org/docs/current/client-

authentication.html for more information.

Sanworl Studio, LLC © 2020-2021 6

Focus Analyzer Desktop User Guide

3. Focus Analyzer
3.1. Analyzer Desktop

To start the application, go to the Windows program list and select “Focus Analyzer -> Focus
Analyzer” or select the desktop shortcut “ Focus Analyzer” to open the Focus Analyzer main window
frame.

By default some tabbed windows will be shown:

• On the Right side: Task Status and Automation Tasks
• On the Left side: Workspace that is the main window for data manipulation and visualization

In the toolbar, there is combo box “Environment” that may contain two options: Private and Public. If
the cluster option in Preferences dialog is not selected, there will be no “Public” option. The
Environment setting controls access to configurations and datasets.

If “Private” is selected, you will be able to access or modify only the configurations located in your local
machine and the datasets that are marked as “Private” in your local database. Refer to Dataset
Management for how to mark a dataset as “Private” or “Public”.

If “Public” exists and is selected, you will be able to access not only the configuration located in your
local machine, but also the shared configuration in the cluster central database. Similarly, you will have
access to “Public” datasets in your local database as well as all datasets that are marked “Public” across
all nodes in the computer cluster. In Dataset Tree Settings, you can further specify Data Location to
Local Public, All Public, or Public data of a remote cluster node.

Any configurations you create, either in “Private” environment or in “Public” environment, will always
be marked initially as “Private” and saved in your local machine. If you want to share your configuration
with the cluster, you will need to switch to “Public” environment and upload those configurations for
sharing in Configuration Management dialog.

Sanworl Studio, LLC © 2020-2021 7

Focus Analyzer Desktop User Guide

3.1.1. Main Toolbar

On the main toolbar chose the Environment as either Private and/or Public.

The following choice of options may be available or grayed out depending on your licensed features.

Help
Appearance
Preferences
Tools
Schema Viewer
Configuration Management
Dashboard Builder
Report Template Builder
Automation Task Builder
Customization Builder
Import Data

Some of the toolbar buttons contains dropdown menus (examples shown below) which will be
described later.

Sanworl Studio, LLC © 2020-2021 8

Focus Analyzer Desktop User Guide

3.1.2. Appearance

Customize your favorite color palate for the application with the “Appearance” toolbar button .

Sanworl Studio, LLC © 2020-2021 9

Focus Analyzer Desktop User Guide

3.2. Analyzer Windows Service

The Analyzer Windows Service provides unattended data processing service, running Automation Tasks
and providing data service for Analyzer Desktop and Analyzer Web. It shall not run in the same
computer as Analyzer Desktop or Analyzer Web.

If you are licensed for using the Analyzer Server , go to the Window’s program list, select

“Focus Analyzer-> Focus Analyzer Cluster Node Config” to open Focus Analyzer main windows for
cluster node. The application window will open and appear as the desktop application.

To configure, select the main toolbar button to bring up Preferences dialog and configure all the
necessary settings.

When the Preferences settings are saved and the window is closed, a Windows service with service
name “FocusNodeService” and description “Focus Analyzer Cluster Node Service” will be started. This
service will be automatically restarted for every computer reboot.

Sanworl Studio, LLC © 2020-2021 10

Focus Analyzer Desktop User Guide

4. Preferences
Press the main toolbar button to bring up Preferences dialog. When running this application for the
first time, this dialog will appear automatically.

4.1. General

• Max. # of threads for parallelism

Internally, many operations will be divided into small tasks and run in parallel to increase
performance. Setting the “maximum number of threads” parameter will limit the degree of
parallelism to balance the memory usage, resource overhead and performance. If set 0, the
application will determine the maximum number automatically by the number of cores that the
computer system has.

• Dataset Nth Listing Count

When viewing measures, this impacts the level to which the best count is shown, for example
when set to 3:

• Distance Unit
Metric or English.
• Max. Number of Items in Most Recent Used
Set the maximum number of accessed measure selections which the dataset tree remembers
for quick access in the Most Recent Used list.

Sanworl Studio, LLC © 2020-2021 11

Focus Analyzer Desktop User Guide

• Max. Sector Coverage (km)

The maximum area where searches and other functions will search, relative to the current data
area.

• Ribbon Style
Select different ribbon style. This will only affect the windows with ribbon toolbar like Report
Template Builder, Dashboard, Map View, etc.

• Google Map API Key

Google Map will be used in Map View. A valid API key will ensure terrain profile and geocode
lookup (address lookup) work properly.

4.2. File Storage

• Local folder for system configuration

Private configuration such as Analysis Scripts, OLAP cubes, Report Templates, Dashboards, and
View Profiles will be saved as files in this folder.
• Local folder for user data (processed data)
Private GIS data and part of imported measurement data will be saved in this folder. It is
recommended to set this folder in a disk that has large capacity and fast read/write access.
• Local folder for operation log
Most critical application operations and error messages will be logged and saved to application
log files. There are three log levels to choose: Regular, Moderate and Complete with respect to
log detail.
• Local folder for temporary file
The application will generate temporary files during data import. The temporary files will be
deleted after import. Setting this folder in a fast read/write disk will increase import speed.

Sanworl Studio, LLC © 2020-2021 12

Focus Analyzer Desktop User Guide

• Raw data repository (Measurement data, GIS, Cell Configuration, etc.)

During drive test data import, there is an option to archive the source files to the raw data
repository folder. You can select to re-process those files later in Dataset tree.

4.3. Cluster

Refer to the Introduction of this document for additional information about clusters.

To setup a computer cluster, you shall setup the Cluster Central Database. If there is no existing cluster
central database, press icon on this Preferences page to create one.

Sanworl Studio, LLC © 2020-2021 13

Focus Analyzer Desktop User Guide

4.4. Measurement Database

Focus Analyzer uses PostgreSQL database server for storing measurement data. You can use the same
database server as Cluster Central Database server or use a different server.

With the growth of data in the application database, implementing table partitions will improve overall
performance. Select how frequent the table partition shall be created, from daily to yearly.

Using the “Show/select active folder…” option, you can also select which folder to use for new data
(new databases, new table partitions).

If “Auto-define new active folder if out of disk space” is checked, and the free space of the current active
disk is under threshold (default 20GB), the application will automatically pick a disk, if available, with
largest free space, create active folders in that disk, and direct PostgreSQL to create table partitions and
store any newly imported data in those folders.

As a general guideline, the data folder shall be selected in disk with big capacity while index folder shall
be in a disk with fast access.

Sanworl Studio, LLC © 2020-2021 14

Focus Analyzer Desktop User Guide

4.5. PCAP

Those preferences are consistent with Wireshark’s preferences. Please check the Wireshark manual for
details (https://www.wireshark.org/). Focus Analyzer will configure Wireshark with those preferences
when the application sends requests to Wireshark to process data. Focus Analyzer communicates with
an open source Windows Service which invokes Wireshark functions.

Sanworl Studio, LLC © 2020-2021 15

Focus Analyzer Desktop User Guide

4.6. Email

Focus Analyzer can run many tasks, such as report generation, script execution and OLAP cube
processing, in the background. Once those tasks are completed, Focus Analyzer can send notification or
report output by email. In this dialog, you can configure email outgoing server. To set up, you will need
to have access to an SMTP server. This link provides some information about using Office 365 SMTAP
server.

Sanworl Studio, LLC © 2020-2021 16

Focus Analyzer Desktop User Guide

4.7. Package

Focus Analyzer is highly customizable. End-users can create many customized configurations, such as
specific analysis scripts, OLAP cubes, report templates, dashboards, etc., and those configurations can
be compressed into a zip file and shared with others as a “package”.

Focus Analyzer includes some default packages. Refer to Configuration Management for how to create
new package. Click on Import to browse to the package and add it to the application. Packages may be
enabled/disabled or controlled by licensing.

4.8 Features

This is a read only list of the features that are enabled based on your license level:

Sanworl Studio, LLC © 2020-2021 17

Focus Analyzer Desktop User Guide

5. Import Data
5.1. Import Drive Test Data

Select menu “Import Dataset” under main toolbar button to bring up the following dialog.

As of this writing, Focus Analyzer supports the following data formats. (Contact Sanworl to get the latest
list of file formats supported.)
• Azenqos log file (.azm)
• Nemo log file (.nmf)
• PCTel Scanner (.dtr)
• TEMS FMT (*.fmt)
• Text Format (any text format)

• PCAP format (.pcap, .pcap.gz, .pcapng, .pcapng.gz, .cap)

Refer to Vendor’s Parameter Mapping for the list of parameters and their mapping to Focus Analyzer’s
metric.

Files can be packaged together in zip or 7zip files. E.g. you can package many NMF files into one zip file.

Choose the Data Type for processing of data or select the “Auto-Detected” option in the Data Type drop
down list and the application will determine the type during import.

The “Metric Import Config” allows you to choose which messages you want to parse from the input
data. By default, all messages will be read. Change the time binning settings via these same Import
Config parameters.

If you select data type “Text Format”, you can import any text file according to specific text format
definition. Refer to Import Text Format for detail.

Sanworl Studio, LLC © 2020-2021 18

Focus Analyzer Desktop User Guide

In the “Options” tab, choose how you want timestamps to be adjusted, or choose no time zone
adjustment.

If “Suffix name of parent folder to file” is checked, the name of the immediate parent folder of the file
will be appended to the original file name and construct a new file name. This provides an option to
differentiate the files with same name but in different folders.

Set “File Flag” and “File Sub-flag” to label the drive test data so that the data can be searched/organized
by those flags.

If “Archive files to Raw Data Repository” is checked, the drive test data files will be compressed to zip
files and saved in the repository folder defined in Preference dialog. Make necessary selection and press
the “Start Import” icon to import data. The import task will run in background and the import status
is displayed in Task Mgt & Status tab.

The imported data will be listed under Dataset Tree in Workspace. If you are in a “Public” environment,
the imported data will be marked “Public” and accessible to all other nodes in the cluster. Otherwise, it
will be marked “Private”. However, you can convert “Private” data to “Public” data in Dataset
Management dialog.

Sanworl Studio, LLC © 2020-2021 19

Focus Analyzer Desktop User Guide

5.1.1. Import Text Format

If you select data type “Text Format” in Import Drive Test Data dialog, the following toolbar will appear.

Select a definition from the combo box to import the text files with the format and parameter mapping
defined by the selected definition.

You can also check the checkbox “Determine Text Format by File Name” to import multiple text files that
are in different text formats. Their format and parameter mapping will be determined by their file
names. For example, the format definition “RSCP” will be used to import the file with name “RSCP.txt”.
Be aware that you shall archive those text files to a zip file and each text file will be imported as a
frame in the same file/device.

Press button (shown above) or select submenu “Dataset Text Format Definition” in Main toolbar to
bring up the following dialog to define text format.

Press toolbar button “ Load Sample File” to load a sample text file and populate the source columns.
For source column with timestamp and GPS position, you shall select their target parameters from
combo box and define the format on the right panel. For other source columns, the target parameter
name will be copied from the source column, but you can edit to different name.

For date and time format, refer to https://docs.microsoft.com/en-us/dotnet/standard/base-

types/custom-date-and-time-format-strings.

For GPS Lat/Lon format,

Decimal Degree: 32.30642° N 122.61458° W or +32.30642, -122.61458

Degree° Decimal Minute': 32° 18.385' N 122° 36.875' W
Degree° Minute' Decimal Second": 32° 18' 23.1" N 122° 36' 52.5" W

Sanworl Studio, LLC © 2020-2021 20

Focus Analyzer Desktop User Guide

5.1.2. Import TEMS FMT

Select data type “TEMS FMT” in Import Drive Test Data dialog to import FMT files exported by TEMS
Investigation.

Refer to Vendor’s Parameter Mapping for the list of FMT IEs and their mapping to Focus Analyzer’s
metrics.

When you prepare FMT files:

1. De-select “Message Type”, “Message Hexadecimal string”, “Message ID” to reduce the output
file size.
2. Zip the FMT file to save disk space.
3. It is recommended to include “Event”.
4. It is recommended to include “Latitude”, “Longitude”.
5. If a FMT IE has both “num” and “text” export option, you shall select “num” option. For
example, select “eMBMS Area Type (Num)” instead of “eMBMS Area Type (Text)”.
6. Always select Metric unit. For example, select “Altitude (m)” instead of “Altitiude (ft)”.
7. You can select to export data of “All” devices or from a particular “MS”.

As shown on left, select default hierarchy “Device_label” and

you will have imported data grouped by device label.

Due to lack of information, L3 message in FMT file will not be imported.

Sanworl Studio, LLC © 2020-2021 21

Focus Analyzer Desktop User Guide

5.5. Import Cell Configuration

Select menu “Import Cell Configuration” under main toolbar button to bring up the following dialog.

Focus Analyzer supports tabular or comma delimited text format. You can select a single text file that
contains all cell configuration or separate files that each contains site, sector, and carrier, respectively.
Specify the number of header rows in the file so that Analyzer knows which rows the data begin on.
Mapping between columns in source files and internal cell configuration parameters must be defined
before import. The mapping can be saved as a Column Mapping to use again for future imports.

To build or edit mapping between source columns and internal parameters:

1. Select source file by pressing icon . Once file is selected, the columns in the file will be listed
in the tree on left side
2. Press icon in the “Column Mapping” combo box to define a new mapping name, or select an
existing mapping from the combo box. If selecting an existing mapping, the mapping between
the source columns and internal parameters will be shown in the spreadsheet on right.
3. Drag column name from left tree and drop to internal parameter on right, this will map the
column to that parameter. If there is no predefined internal parameter that a column can be
mapped, you can simply drop that column to the target parameter category, a new internal
parameter will be created automatically and mapped to that column.
4. For each technology, the “Expected Value” is a string which indicates which technology the
group of parameters are for, especially if the file contains cell information for multiple
technologies.
5. Press icon in the “Column Mapping” combo box to save.

Define a cell configuration name in “Cell Config. Name” text box, then create or select Geo area name in
the “Geo Area” comb box, then press toolbar button to import. The imported cell configuration will
be listed under Cell Configuration Tree in Workspace.

Sanworl Studio, LLC © 2020-2021 22

Focus Analyzer Desktop User Guide

5.6. Import GIS Data

Select menu “Import GIS” under main toolbar button to bring up the following dialog.

You can import user-defined region (UDR) files, indoor floor prints, or GIS map to a Geo Area. A Geo
Area is logically a category that is defined by user to group information.

• The UDR files to import shall be originally created in Map View and exported by Focus
Analyzer.
• Indoor floor print can be any image file. After imported, it can be rectified to GIS in Indoor
Map Rectifier.
• GIS Map shall be Vector Map in most common format such as ESRI Shapefile, MapInfo TAB
and MIF.MID.

All the imported GIS data will be listed under GIS Tree in Workspace.

Sanworl Studio, LLC © 2020-2021 23

Focus Analyzer Desktop User Guide

6. Workspace
Workspace is the main window for data manipulation and visualization. It contains two portions: Data
tree tabs, also called “Data Panel”, on left and one or more workspaces which contain various Views on
right.

Data Trees:

• Dataset • GIS Data

• Cell •

Views:

• Spotlight • Correlation Chart

• File / Device Explorer • Aggregation Chart
• Cell Coverage View • Pivot View
• Point Detail • Media Player
• Instant Chart • Indoor Map Rectifier
• Message View • Report Viewer
• Map View • Dashboard Viewer
• Table View • Time Chart

Sanworl Studio, LLC © 2020-2021 24

Focus Analyzer Desktop User Guide

Multiple workspaces can be created, and multiple views can be

opened at the same time in a Workspace. By default, those views will
overlap to each other. By drag-and-dropping the tab of the view, you
can dock it to any desire area, make it float, or overlap with others.
This allows us to relocate the view.

To resize a view, move the cursor to the border of the view. Once
the cursor turns to resize arrow, press & hold & move the mouse to
resize the view.

Anything displayed in Workspace can be saved as a view profile which can be applied to different
dataset in the future. See toolbar section below for instructions to manipulate a view profile. There are
multiple levels of profile views. In each individual view, you can create its own view profile within the
larger profile.

All time-sequence views can be played back continuously at a specific speed and synchronized for cross-
reference.

You can save the “Workspace Image”, where the Workspace Image is the current view and open
dataset. For example, if you opened a dataset, and you have time sequence and statistical views
opened, docked, floating, or in any combination or number, saving the “Workspace Image” as a name
allows you to select that name later to open the same dataset and configuration of views and data.

Sanworl Studio, LLC © 2020-2021 25

Focus Analyzer Desktop User Guide

6.1. Main Toolbar

6.1.1 Save and Display Profiles

You can display data in many views, arrange the view’s location and size, then save as a view “profile”.
Later, you can apply different data to this profile and get the same kind of views and layout in one click.
If you have more than one workspace, only the views in the active workspace will be saved.

Create the set of views that you prefer, then choose to save the profile using the save icons in the right
side of the profile field. For example, in this case you defined a profile called “Profile_Test_LTE1”, which
provides a map view of the drive route, a time series showing LTE Best RSSI, and a message view:

Now this profile can be applied to other relevant datasets (in this case, LTE data to view RSSI).

View Profile:

To apply different dataset data to an existing profile, choose the profile name you wish to apply, then
select context menu “Apply Workspace Profile” in Data Tree - Dataset or select a dataset node in Data
Tree - Dataset, then press icon in the combo box.

The same operation can be applied to all other views such as Pivot
View and Aggregation Chart.

You can press toolbar button to create more than one workspace, and each workspace can contain
multiple views. You can apply different view profile to different workspace. Click at a workspace to make
it active. Function of most toolbar buttons will take effect in the active workspace.

Sanworl Studio, LLC © 2020-2021 26

Focus Analyzer Desktop User Guide

6.1.2 Toolbar Buttons

The following buttons are available in the tool bar of the view panel.

Help
Close all views
Compact View layout
Dashboard
Report View
Indoor Map Rectifier
Media Player
Correlation View
Time Chart
Table View

Map View
Message View
Instant Chart
Point Detail
Aggregation Chart
Pivot View
Cell Coverage View
Spotlight
Synchronize All Views
Playback Toolbar
Create New Workspace

Sanworl Studio, LLC © 2020-2021 27

Focus Analyzer Desktop User Guide

6.2. Data Tree

6.2.1. Dataset

Drive test data imported by “Import Drive Test Data” will be

organized in a tree view.

To operate the tree view:

• Right-click mouse at a node of the tree to bring up the
relevant context menu. The most important context menu
is “Show/Hide Data Tree” of a dataset node. Select that
menu to make data elements available for manipulation.
• Left-click mouse and hold at a node to enable drag-n-drop
operation. You can drag a data element (a tree node) from
tree view and drop to a view for visualization.

6.2.1.1 Toolbar

File / Device Explorer provides more functions for filtering

Create Demo Dataset
List only the dataset collected within current view port in Map View
Switch between dataset hierarchy definition and dataset listing
Show data tree for the selected dataset node
Refresh dataset tree view
Show/Hide settings panel

Sanworl Studio, LLC © 2020-2021 28

Focus Analyzer Desktop User Guide

6.2.1.2 Settings

The upper Settings panel, which is access by Click on “Settings” to view the upper Settings panel, which
contains parameters that affect how and what dataset is listed in the tree view. To refresh the dataset
tree view based on the above settings, press toolbar button . The following settings will affect how
and what data will be visualized in various view.

• Data Access
- Private: local private data
- Local Public: public data in local machine only
- All Public: public data in the computer cluster
- <IP Address>: public data in a remote cluster node
• Geo Boundary
- Only the files collected in the specific geo boundary will be
listed in Dataset tree. Refer to Map View for how to create UDR.
• Dataset
- Dataset is a group of data that is defined in importing drive test
data
• Default
- Choose default display elements for the dataset, for sectors,
UDR, and indoor map
• Data Hierarchy
- Included under the “Default” set of parameters, set the
hierarchy of dataset using device attributes or timestamp. Press
icon to edit or define.
• Device Filter
- By condition Expression: press icon to edit or define.
- By timestamp
• Data Filter
- Dataset can be filtered by certain condition expression, event timestamp, sector coverage, or
UDR and attributes for the UDR.

Sanworl Studio, LLC © 2020-2021 29

Focus Analyzer Desktop User Guide

6.2.1.3. Context Menu

Right-click mouse at a node in Dataset tree to bring up context menu.

• Dataset Overview: Display overview of the dataset,

including table partition information, table size,
file count, device types, etc.
Rename: Rename the dataset
Delete: Delete the dataset. This is a permanent
action.
Generate Report: Produce report using data
from this dataset
• Explorer: Selected This context menu is for files/devices selected
in the File / Device Explorer.

First, you shall list certain files/devices in File /

Device Explorer by either of the following:
• Press toolbar button to open File /
Device Explorer, then drag a dataset
node in the tree view and drop to the
explorer
• Right-click mouse at a dataset node in
the tree view, select menu “List in
Device Explorer”

In File / Device Explorer, you can select one or

more files/devices, then come back to this tree
view and right-click mouse at tree node
“Explorer: Selected” to bring up this context
menu.

The functionality of each menu is identical to

that of “Data Elements” described later.

• Explorer: All in View This context menu is for all files/devices that
are currently listed in File / Device Explorer. The
Same as above
list could be a list after certain filtering.

Sanworl Studio, LLC © 2020-2021 30

Focus Analyzer Desktop User Guide

• Data Elements Show/Hide Data Tree: show or hide the

available data elements for the selected dataset
node.

*** Without this data tree, you will not be

able to access the information such as Analysis
Scripts, OLAP Cubes, and Measurement
Metrics. You must show this data tree before
selecting data for display ***

List In File / Device Explorer: list all files/devices

belong to the selected dataset node in File /
Device Explorer

Apply Workspace Profile: composite the data

of the selected dataset node and display in the
views defined by the workspace profile.

Show In …: apply the view profile of the target

view to the selected dataset node.

Cleanup Derived Data: The Derived Data comes

from Analysis Scripts and OLAP cubes. In some
cases you may need to remove derived data for
output consistency.

Download Source Files: download all the

source files associated to the selected dataset
node from Raw Data Repository

• OLAP Cube Once a OLAP cube is created in OLAP Cube

Builder, it will be listed under “Cube: User-
defined”.

All other “Cube: …” nodes listed are either

default OLAP Cubes or the cubes defined in a
configuration package. Those cubes are read-
only.

Generate Result: process OLAP cube in

background and save result to Cube Database

Sanworl Studio, LLC © 2020-2021 31

Focus Analyzer Desktop User Guide

• OLAP Cube: Measure OLAP cube contains dimensions and measures.

Depending on how the OLAP cube is created, it
could contain the following dimensions:
• Device Attributes
• UDR Attributes
• Cell Configuration parameters
• Timestamp
• Unique value of any metric
• Plotband

Both dimensions and measures can be drag-n-

dropped to Aggregation Chart and Pivot View.

• Metric Group Refer to Metric Group Builder

Similar to that of OLAP Cube
• Analysis Script Refer to Analysis Engine Builder
Similar to that of OLAP Cube
• Metric Metrics are listed under Metric Group, Analysis
Script, and Measurement Frame. The context
menu for those metrics is the same.

Drag-n-drop the metric to various views.

Context menu “Show In Map View – State

Along Drive Route” is to show the metric value
in every GPS marker (in dataset tree
Measure->Common->GPS->Marker). If there is
no value collected at a GPS marker, the value
collected earlier will be carried over for display.

Context menu “Show In Map View – Delta

Metric” is to show generate delta map for the
selected metric with a metric that has been
displayed in Map View.

To generate a delta map, you shall pick first

metric and select context menu “Show In Map
View – Geo Binning” with “Location Grid”
binning type, then pick second metric and
select context menu “Show In Map View – Delta
Metric”. The delta value between these two
metrics could either be negative and positive,
you shall pick a relative plot band accordingly.

Sanworl Studio, LLC © 2020-2021 32

Focus Analyzer Desktop User Guide

• Metric – Nth Listing For the frame with values sorted by a metric,
under each metric, there is Nth listing. You can
select its context menu to increase/decrease
Nth list so that you can access more/less sorted
metric value.

• Measurement Frame Via right click contact menu, you can send the
entire frame message to Message View.

• Layer 3 Information Element This Information Element (IE) tree view will be
visible when Layer 3 and PCAP frame is
selected.

There is context menu for each information

element. You can also drag an element and
drop it to various view for display.

Search function is provided for finding an

element in the tree.

Sanworl Studio, LLC © 2020-2021 33

Focus Analyzer Desktop User Guide

6.2.2. Cell Configuration

This tree view lists the Cell configuration imported by “Import Cell Configuration” .

The imported cell configuration will be listed as “[geo area name]

-> [cell configuration name] -> BASE”. Along with “BASE”, the
sector groups that are created in Map View will also be listed.

Under the “BASE” or a sector group, all the sites and sectors of a
site will be listed. The detailed information of a cell site will be
displayed in the lower spreadsheet area “Cell Site Viewer” when
you click at that cell site. You can use this area to edit
parameters, and then click Save to apply your changes.

A context menu and drag-n-drop operation are available in this

view. For example, you can right click on a BASE and choose to
edit all the cells, or zoom to center based on this cell.

Sanworl Studio, LLC © 2020-2021 34

Focus Analyzer Desktop User Guide

6.2.3. GIS

This tree view lists GIS data imported by “Import GIS Data”.

The imported GIS data will be listed under three

categories: Indoor Map, Vector Map and UDR.

Context menu and drag-n-drop operation are available

in this view.

For Indoor Map, you can select context menu “Geo

Rectify” to rectify the floor print to GIS by drag-n-drop
in Map View. You must Geo Rectify an indoor image
so that the coordinates of the edges of the image are
known, for proper display on a map.

For the Vector Map, you can select context menu

“Extract Polygon and Save as UDR” to extract the
vector area features including its attributes contained
in the map to UDR file. The UDR can be used for
reporting, data filtering, etc. the same as the UDR you
create manually in Map View.

Sanworl Studio, LLC © 2020-2021 35

Focus Analyzer Desktop User Guide

6.3. File / Device Explorer

The “File / Device Explorer” provides functions to organize and filter data based on various attributes.
For example, you can list all files in the dataset where devices are meeting some criteria, such as a
failure criteria of dropped calls. The list of files and data can be shown based on device attributes. You
can filter the dataset based on the statistical data and narrow down to a small number of file/devices
that contain only the desired information. After you pick “Explorer: Selected” or “Explorer: All in View” in
dataset tree, you can work on those specific data in various views including dashboard and report
generation.

Press Dataset toolbar button to open the File / Device Explorer, select context menu “List in Device
Explorer” of a dataset node in Dataset Tree, or drag-n-drop that dataset node over to the File / Device
Explorer space. You can also select from context menu “For Event Info: Drill Down to Device” of a cell in
Pivot View to populate the following view.

If no profile is selected in the toolbar combo box, only file name and device
index of each individual file/device of the selected dataset will be listed in the
view.

Sanworl Studio, LLC © 2020-2021 36

Focus Analyzer Desktop User Guide

Right-click at a column header or a cell will pop up the corresponding context

menu. You can color the cell value, bring up Filter Editor to build an advanced
filter expression, or sort a column, hide a column, group list by a column, etc.

To define a profile, press toolbar button to bring up the following Profile

Editor. In the top portion, select which Device Attribute columns to view in the
File / Device Explorer.

In Dataset tree, if the tree is not already showing, select context menu “Show/Hide Data Tree” to make
data elements available for the target dataset node, then drag the desired data element and drop to the
editor → define aggregation and condition for the file/device to be listed in the File / Device Explorer →
press toolbar button “ Apply” to apply the profile to the selected dataset. Once the result is listed in
the view, you can create custom columns through toolbar button , build filter expression, hide a
column, group the list by a column, or color the column value. Press the save button inside the
combo box to save the view as a view profile.

Sanworl Studio, LLC © 2020-2021 37

Focus Analyzer Desktop User Guide

Under the dropdown of toolbar button , you can open specific view
and apply the profiles of that view to the selected files/devices in this
explorer.

Sanworl Studio, LLC © 2020-2021 38

Focus Analyzer Desktop User Guide

6.4. Message View

Press Workspace toolbar button to open the Message View. In Dataset tree, select the context menu
item “Show/Hide Data Tree” to make data elements available for the target dataset node. Next, select
the context menu “Show In Message View” of a frame, or drag-n-drop that frame to the Message View
window to list its messages in time sequences in the view. Multiple frames can be displayed in the view.

Please be aware that for displaying PCAP frame to Message

View, you shall expand the dataset tree view and drag-n-
drop a “PCAP” frame in a single file/device to the view, as
shown on left. (Composite breakdown view of PCAP data is
currently not supported.)

Message View contains four panes: Message List, Message Flow Chart and PCAP Stream (show/hide by
toolbar button ), and Message Detail View. When a message in Message List or Message Flow Chart
is clicked, its detail information will be displayed in Message Detail View.

Sanworl Studio, LLC © 2020-2021 39

Focus Analyzer Desktop User Guide

From the context menu of a Layer 3 message in Message List, you

can select a start message and end message so that the message
flow between them can be drawn in Message Flow Chart.

From the context menu of a PCAP message in Message List, you can
select menu “Follow” to follow a stream and decode that stream in
PCAP Stream View.

You can also set a message as a reference time. Messages can be

marked for easy retrieval and browsing later.

In Message Flow Chart, you can define a configuration to determine a message flow, press toolbar
button or to automatically search for marked rows one by one, starting from the selected message
throughout the entire message sequences.

In Message Detail View that displays a Layer 3/PCAP message, right-click at

an information element to popup the context menu, you can send that
information element directly to Table View, Time Chart or Map View to
display.

Sanworl Studio, LLC © 2020-2021 40

Focus Analyzer Desktop User Guide

6.5. Table View

Press Workspace toolbar button to open Table View. In Dataset tree, select context menu
“Show/Hide Data Tree” to make data elements available for the target dataset node, select context
menu “Show In Table View” of a metric or drag-n-drop that metric to the view to display data.

Right-click mouse at a row/cell or column header to bring up context menu.

The following is the description for some special toolbar buttons:

Click at a column and send all the data that is displayed in the
column to Time Chart. You can filter the data before sending.

If a flag is selected, the data will be marked with that flag in

Time Chart.

Same as above, this will send the data to Map View

Sanworl Studio, LLC © 2020-2021 41

Focus Analyzer Desktop User Guide

Many options are available in the context

menu for applying coloring and icon sets.
Default assignments of an icon to a range is
based on data and percentiles, like how MS
Excel functions.

The display can be saved as view profile and

applied to different data.

Sanworl Studio, LLC © 2020-2021 42

Focus Analyzer Desktop User Guide

6.6. Map View

Press Workspace toolbar button to open a Map View. In Dataset tree, select context menu
“Show/Hide Data Tree” to make data elements available for the target dataset node, select context
menu “Show In Map View” of a metric or drag-n-drop that to the view for display. Drive test data, cell
configuration and GIS data including UDR, elevation Map, vector map and raster image can be displayed
in Map View.

By changing the grid size in View Option toolbar, you can split the map view into
many sub-views, each sub-view can display its own data. In this way, for example with 1x2 you can see
two maps.

Sanworl Studio, LLC © 2020-2021 43

Focus Analyzer Desktop User Guide

In Map view, other than data visualization, there are more functions:

• Creation of UDR and Geo boundary used for data filtering

• Creation of Sector Group used for data filtering
• Terrain Profiler
• Address lookup
• Distance measurement
• Dataset-Cell Spider Links
• Cell radius analysis
• View Options
• Indoor Map and Data display

You can right-click mouse at map area to bring up context menu.

The display can be saved as view profile and applied to different data.

Sanworl Studio, LLC © 2020-2021 44

Focus Analyzer Desktop User Guide

6.6.1 Hotkeys

Enable/Disable Tooltip: Ctrl + T

Clean up display: Ctrl + U

Increase data icon size: Ctrl + Shift + D

Decrease data icon size: Ctrl + D

Metric display displacement: Ctrl + O

Data Label: Ctrl + L

Dynamical Geo Binning: Ctrl + Y

Increase sector icon size: Ctrl + Shift + C

Decrease sector icon size: Ctrl + C

Spider: Ctrl + S

Cell Radius Analysis: Ctrl + R

Ruler: Ctrl + M

Terrain Profiler: Ctrl + P

Go To Address: Ctrl + G

Find Address: Ctrl + A

Sanworl Studio, LLC © 2020-2021 45

Focus Analyzer Desktop User Guide

6.6.2 Dataset-Cell Spider Links

In Map View, press toolbar button “ Spider” under menu “ Dataset-Cell Analysis” to turn on
“Spider” mode. In this mode, mouse-click at data will generate the links between this data location and
the cell sectors that cover this location. The color of the links can be defined in Map View Option.

Besides, mouse-click at a cell sector will generate sector coverage links pointing to all data location
where this sector has coverage. The color of the links is consistent with the fill color of the sector icon.
Click at same sector again to toggle the display of coverage links.

Under “ Base On” menu shown on left,

you can select by what information to
determine the links between dataset and
cell sectors.

Normally, if mouse-click at a data location,

the technology of cell sector to analyze will
be determined by the nature of data, for
example, if you click at “WCDMA Cell RSSI-> RSSI Best #1”, the links to WCDMA cell sectors will be built.
However, if the data is “Data Throughput” which has no indication of technology, you can manually pick
the technology to analyze, otherwise, you will not get any spider links from data to cell sectors.

‘”Max. Distance (m)” sets the maximum distance for considering the links between data and cell
sectors.

Press toolbar button “ ” to clean up all spider links.

Sanworl Studio, LLC © 2020-2021 46

Focus Analyzer Desktop User Guide

6.6.3 Cell Radius Analysis

In Map View, press toolbar button “ Radius” under menu “ Dataset-Cell Analysis” to turn on “Cell
Radius” analysis mode. In this mode, mouse-click at a cell sector will generate the followings:

• Gray circles indicate distance.

• Blue pie indicates sector azimuth and beam width.
• Color data points indicate the coverage of the sector.

Under menu “ Options” shown below, you can configure how to perform cell radius analysis.

Based on the technology of the sector you click, the data

of the correcsponding metric defined in the technology
combo box will be displayed.

If you select “Top 1 Sector” analysis mode, only the data

at the location where the selected sector is top 1 server
will be displayed. On the other hand, if you select “Sector
Coverage” analysis mode, then data at any location where
the selected sector covers will be displayed.

Click at same sector again to toggle the display, press “ Exit Analysis” to exit, or press toolbar button
“ ” to clean up all analysis display.

Sanworl Studio, LLC © 2020-2021 47

Focus Analyzer Desktop User Guide

6.6.4 Terrain Profiler

In Map View, press toolbar button “ Terrain Profiler” under menu “ Tools” to make “Terrain
Profiler” visible on bottom.

Click at a location and hold the mouse to another location, the terrain along the path will be displayed.
To adjust the path, click at the small rectangle on one end of path and hold the mouse, you can move
the path to different location.

Press toolbar button “ Erase” to clean up all the paths.

Sanworl Studio, LLC © 2020-2021 48

Focus Analyzer Desktop User Guide

6.6.5 Geo Region

You can draw shapes in Map View and save those shapes as user-defined region (UDR). All UDR will be
listed in GIS tree under “UDR” node and can be drag-n-drop to Map View for display.

UDR can be used in the following cases:

• UDR with one rectangle shape can be used as Geo boundary to narrow the dataset listing in
Dataset tree Setting panel to the data collected within that geo region.
• UDR with multiple shapes (Polygon, rectangle, or Ellipse) can be used as a filter in Dataset tree
Setting panel, so that only the data collected within the regions will be displayed in views.
• Attributes of UDR can be considered as dimension for data aggregation in Aggregation Chart,
Pivot View, and OLAP Cube.
• UDR can be used to aggregate metric data and displayed in Map View by selecting context menu
in Dataset Tree.

In the toolbar of Map View under menu “ Geo Region”, you can press button for Rectangle
drawing tool, for Ellipse drawing tool and for Polygon drawing tool.

• For drawing rectangle and ellipse, left-click mouse, hold and drag to draw the shape, release the
mouse to complete the drawing.
• For drawing polygon, left-click mouse and release, move mouse to next location and repeat,
right-click mouse to finalize the drawing.

You can click at a shape to make it focused and selected. Press toolbar button to select Edit tool,
then you can click at a shape and edit its appearance. If you want to edit the
attributes of the shape, you shall firstly save those shape as UDR. Right-click
mouse at any area in Map view, select context menu “UDR->Save as New UDR
File” or “UDR->Selected Region->Save As New UDR File”.

You can create new attribute for the shape by press toolbar button or
remove one by . You can edit the global region attribute by . The global
attributes are the default attributes for every shape in the UDR file. Those
attributes can be considered as dimension in Aggregation Chart, Pivot View,
and OLAP Cube.

If you intend to create Geo boundary for dataset listing filtering, you shall select rectangle drawing tool
and draw only one rectangle. After done, right-click mouse at any area in Map view, select context menu
“UDR->Selected Region->Save Selected Rectangle As Geo Boundary”. The new Geo Boundary will be
listed in Dataset tree Setting panel.

Sanworl Studio, LLC © 2020-2021 49

Focus Analyzer Desktop User Guide

6.6.6 GIS Map

You can import GIS vector map in Import GIS Data and display the map in Map View. Most common
vector map formats such as ESRI Shapefile, MapInfo TAB and MIF.MID are supported. The imported
maps will be listed in GIS Tree under “Vector Map” node and can be drag-n-drop to Map View for
display.

When the vector map is displayed, you can press toolbar button “ Pick Feature”, then mouse-click at
the vector map display to find the detail information of the feature (area, railroad, highway, etc.). If the
feature is an area, the area will be highlighted. You can right click at any area in Map view, select context
menu “UDR->Make Highlighted Area as Geo Region” to turn it into a shape. Repeat the same steps to
turn more area into shapes, right click and select context menu “UDR->Save As New UDR File” or
“UDR->Selected Region->Save As New UDR File” to save it as UDR and it will be listed in GIS tree under
“UDR” node.

You can simply press toolbar button “ Extract Polygon” to find all areas in vector map and turn to
polygons, then right click and select context menu to save as new UDR. The same function is also
available in GIS Tree using context menu of a vector map.

Sanworl Studio, LLC © 2020-2021 50

Focus Analyzer Desktop User Guide

6.6.7 Data Density

Right-click at a dataset node in Data Tree, select context menu “Show Data Density in Map View”, a
heatmap will be generated and displayed. The color indicates the density of the data in a location, in
another word, indicates the number of samples in a location.

In toolbar, you can select to display by:

• “Boundary” - use the geo bounding rectangle of the data in a file to calculate the overlap of files,
density indicates number of files. If the bounding rectangle of two files has overlap, density in
the overlapped area will be 2.
• “Drive Route” - density indicates number of samples. The “Thickness” indicates the effective
area (in meter) of a sample, if the effective area of three samples has overlap, density in the
overlapped area will be 3.

You can select a plot band to color the density.

Sanworl Studio, LLC © 2020-2021 51

Focus Analyzer Desktop User Guide

6.6.8 View Options

Display in Map View can be adjusted by configuring the view options. In Map View, press toolbar button
“ View Options” under menu “ View Options” to bring up the following View Option dialog.

Sanworl Studio, LLC © 2020-2021 52

Focus Analyzer Desktop User Guide

6.7. Time Chart

Press Workspace toolbar button to open a Time Chart. In Dataset tree, select context menu
“Show/Hide Data Tree” to make data elements available for the target dataset node, then select the
context menu “Show In Time Chart” of a metric or drag-n-drop that metric to the view for display.

You can create multiple chart areas, display multiple metrics in the same chart area. The event
information of analysis script will always be displayed as symbols on the lower part of the chart area.
You can press toolbar button to modify the overall appearance.

You can right-click mouse to bring up a context menu.

For the displayed time series, you can perform the following analyses

• Filtering , based on a range of values

• Binning , by aggregating values based on a temporal bin size
• Moving average , based on a period of time
• Statistics

The display can be saved as an Analysis view and applied to different data.

Sanworl Studio, LLC © 2020-2021 53

Focus Analyzer Desktop User Guide

6.8. Correlation Chart

Press Workspace toolbar button to open a Correlation Chart. In Dataset tree, select context menu
“Show/Hide Data Tree” to make data elements available for the target dataset node, drag-n-drop the
first metric to the view as X-Value, then drag-n-drop the second metric to the view as Y-Value. This will
display the correlation chart between these two metrics.

Press toolbar button to modify the overall appearance. Use the mouse right-click to bring up the
context menu.

For the displayed correlation chart, you can perform the following analyses

• Area analysis
• Curve fitting
• Aggregation Curve

The display can be saved as an Analysis view and applied to different data.

Sanworl Studio, LLC © 2020-2021 54

Focus Analyzer Desktop User Guide

6.9. Aggregation Chart

Press Workspace toolbar button to open an Aggregation Chart.

The Aggregation Chart allows 1 or more chart areas based on the Split Views
selection.

Click within a chart area, then press toolbar button to bring up Aggregation Chart Profile Editor to
define what to display in that view. In the Dataset tree, select context menu “Show/Hide Data Tree” to
make data elements available for the target dataset node, then drag-n-drop metrics to the editor as a
measure. Define an X-value (dimension) and at least one “measure” as Y-value in the spreadsheet.

Modify the appearance of a chart in “View Option” tab in Profile Editor or right-click mouse at a chart
area to bring up context menu.

Sanworl Studio, LLC © 2020-2021 55

Focus Analyzer Desktop User Guide

To edit profile of another chart, simple click at the chart and all the corresponding properties of the
chart will be restored in Profile Editor. Press toolbar button will refresh the chart with current
properties.

The display can be saved as an Analysis view profile and applied to different data.

Sanworl Studio, LLC © 2020-2021 56

Focus Analyzer Desktop User Guide

6.10. Pivot View

Press Workspace toolbar button to open a Pivot View. With the Pivot view, slice-n-dice data freely with
multiple dimensions and measures, load data from pre-processed OLAP cubes or on-the-fly processing, and drill
down into the data.

Click within a chart area, then press toolbar button to bring up Pivot View Profile Editor to define
what to display in that chart. In Dataset tree, select context menu “Show/Hide Data Tree” to make data
elements available for the target dataset node, then drag-n-drop metrics to the editor as a measure.
You shall define at least one “measure” and one “dimension” in the spreadsheet, then click Apply.

In the view spreadsheet, right-click mouse at a row/cell or column header to bring up the context menu.

For a cell in the result view, it has context menu “For Event Info: Drill Down to Device”. This provides the
function to list all file/devices that contribute to the value of the selected cell to File / Device Explorer.

The display can be saved as an Analysis view profile and applied to different data.

Sanworl Studio, LLC © 2020-2021 57

Focus Analyzer Desktop User Guide

6.11. Cell Coverage View

Press Workspace toolbar button to open the Cell Coverage View. The Cell Coverage view provides
statistics and measures based on selection of specific cells in list. Data is shown for the selected cells, to focus on
specific sites and statistics.

Click on the chart area, then press toolbar button to bring up the Cell Coverage Profile Editor to
define what to display in this chart. In the Dataset tree, select context menu “Show/Hide Data Tree” to
make data elements available for the target dataset node, then drag-n-drop metrics to the editor as a
measure. You shall define at least one “measure” in the spreadsheet, select cell configuration for
lookup, and select cell configuration attributes for display.

Select one or more cell site in the spreadsheet which will highlight the corresponding cell icon in Map
View if the cell configuration is displayed in the Map View. Also, the corresponding cell site listed in Cell
Tree will be made visible and expanded.

The display can be saved as an Analysis view profile and applied to different data.

Sanworl Studio, LLC © 2020-2021 58

Focus Analyzer Desktop User Guide

6.12. Focus View

Press Workspace toolbar button to open a Focus View, choose a template, then drag-n-drop a
dataset node in Dataset Tree to the view for display.

The template for Focus View is created using the Report Template Builder. Press the edit button next to
the Template name to access the Report Builder. The only difference from a regular template is that
you can add hyperlinks to a cell in the template. The hyperlink links to a Workspace View Profile.

Once you drag-n-drop a dataset node to the view and the result is displayed, you can click on the
hyperlink to apply the source data to the pre-linked workspace view profile.

Sanworl Studio, LLC © 2020-2021 59

Focus Analyzer Desktop User Guide

6.13. Point Detail

Press Workspace toolbar button to open Point Detail View.

Press icon in the profile combo box

to define a new profile.

To display detail message in a

geolocation or a timestamp, you shall
send metric to Map View, Table View or
Time Chart, then click at a location in
Map View or a timestamp in Table View
or Time Chart, the desired information
at that timestamp or close to that
timestamp will be displayed in the
spreadsheet.

Workspace toolbar button shall be

pressed to enable the synchronization
among various views. Without the
synchronization, you will not get detail
message when clicking at other views.

Sanworl Studio, LLC © 2020-2021 60

Focus Analyzer Desktop User Guide

6.14. Instant Chart

Press Workspace toolbar button to open Instant Chart.

You can select several metrics from a metric group for

instant charting.

Similar to the Point Detail discussed above, to draw the

metric value in chart for a geolocation or a timestamp, you
shall send metric to Map View, Table View or Time Chart,
then click at a location in Map View or timestamp in Table
View or Time Chart.

Workspace toolbar button shall be pressed to enable

the synchronization among various views. Without the
synchronization, you will not get instant chart when
clicking at other views.

Sanworl Studio, LLC © 2020-2021 61

Focus Analyzer Desktop User Guide

6.16. Media Player

Press Workspace toolbar button to open Media Player.

Media Player works with RTP data found in the dataset. You shall select “RTP Stream” analysis in the
analysis tree, then drag a frame from a device file in Dataset Tree and drop to PCAP View. Note: PCAP
view may not be available.

In “RTP Streams” spreadsheet, select a stream, then press toolbar button . Focus Analyzer will extract
RTP stream payload from PCAP file and visualize it in Media Player (shown above). You can select to play
the forward stream or the reverse stream or play the combined stream.

Sanworl Studio, LLC © 2020-2021 62

Focus Analyzer Desktop User Guide

6.17. Report Viewer

Press Workspace toolbar button to open the Report View.

In Dataset Tree , you can select the context menu item “Generate Report” for a dataset node to bring up
Report Generator (shown below). You can configure data filter, select options and target report
templates (from the built in Report Template Builder). You may also select to generate report on a
specific sheet, or an area defined as a print area in a sheet. To generate the report, press button
“Generate”. The report will be generated in background. When the report generation is done, you will
be notified via email or text message and desktop notification message as well.

The option defined above is default settings that could be overwritten by the definition of each report
item. If option “Single Site Report” is checked, for every cell site contained in the cell configuration
picked in “Default->Section” option, a report will be generated purely based on the data in its cover area
where this sector is the serving sector.

Sanworl Studio, LLC © 2020-2021 63

Focus Analyzer Desktop User Guide

6.18. Dashboard Viewer

Press Workspace toolbar button to open Dashboard Viewer, select a template in the combo box,
then drag-n-drop a dataset node in Dataset Tree to the view for display.

Dashboard templates are built in Dashboard Builder. The same template can be used for both Desktop
Client and Focus Analyzer Web application. However, the map dashboard item is valid only in the web
dashboard viewer.

To define a map view in the template, you shall select “Map View” button in the toolbar, then assign a
metric as a measure for the map.

It is strongly recommended to use OLAP cube as data source for much faster data loading.

Sanworl Studio, LLC © 2020-2021 64

Focus Analyzer Desktop User Guide

6.19. Indoor Map Rectifier

Press Workspace toolbar button to open the following dialog, then drag an indoor map in GIS Tree
and drop to the view.

The original indoor map will be displayed on the left view while the ongoing rectified indoor map on the
right. Three colored pins indicate three corners of the image. Drag individual pins to the desired
location in both views to rectify the corresponding pixel position to GIS location, then press Apply. You
can continue moving the pins around as needed to adjust location exactly.

After an indoor map is rectified, all drive test data associated with this map will be automatically
rectified and displayed in Map View, and you can switch back and forth between indoor display and
outdoor display. If the indoor map has not been rectified, the map and its associated data can only be
displayed in indoor mode.

Sanworl Studio, LLC © 2020-2021 65

Focus Analyzer Desktop User Guide

6.20. Playback Tool

Press Workspace toolbar button to open the data playback tool.

The Playback tool allows you to traverse through a set of walk or drive data based on chronological
order and speed. The playback can be applied to multiple views. For example, show a measure in the
Map View and data in a Table View, then Playback the data and watch the pin on map move while rows
in table are browsed.

Sanworl Studio, LLC © 2020-2021 66

Focus Analyzer Desktop User Guide

7. Customization with Builders

7.1. Analysis Engine Builder

Select the menu item “Analysis Engine Builder” under the Main Window toolbar button to open
the Analysis Engine Builder.

Analysis Engine Builder provides a powerful approach to derive new events and metrics by
implementing algorithms with any complexity in a C# program language.

To create an analysis script, you shall:

• Create parameters by drag-n-drop data element from “Data” or “Constant” tree on left panel to
the spreadsheet in “Parameter” tab and assign parameter names. Those parameters will be
referred in code editor to represent the corresponding data at a timestamp.
• Create metrics in “Metric” tab. Those metrics will hold output value at each timestamp.
• Create event types in “Event” tab.

You will write code in Main Editor and if needed, define global variables, and write functions in Global
Variables & Functions editor

Press toolbar button to bring up “Microsoft online C# programming Guide”, which is a good tutorial
for how to program in C#.

After the script is created, it will be listed in Dataset Tree. To execute the script, select the context menu
“Generate Result” in Dataset Tree to execute the script in background.

The code in Main Editor can be seem as body of a function, while parameters in tab “Parameter” are
function arguments, metrics in Tab “Metric” and events in tab “Event” are output of the function. This
function will be executed sequentially once for every timestamp.

Sanworl Studio, LLC © 2020-2021 67

Focus Analyzer Desktop User Guide

7.1.1 General Examples

For example, you have defined p1, p2, and p3 parameters in “Parameter” spreadsheet, m1 and m2 in
“Metric” spreadsheet.

Code in Main Editor,

m1 = p1 + p2 + p3;
if (p1 > -10)
{
m2 = p1;
}
In the above example, the script will produce metric “m1” that sums up p1, p2 and p3 at each
timestamp. It will also produce metric “m2” when the parameter p1 at a timestamp is greater than -10;

If you want to generate event on certain condition, you can define event “e1” in “Event” spreadsheet,
then modify the code to

m1 = p1 + p2 + p3;
if (p1 > -10)
{
m2 = p1;
AddEvent(Event.e1);
}

At this time, you shall call a built-in function “AddEvent” to add event e1 if p1 is greater than -10. Refer
to “References” tree on the left panel for more built-in functions. When you refer to an event in the
code, you shall start with “Event.”, event e1 will be referred as “Event.e1”.

In case p1 does not have value at a specific timestamp, both m1 and m2 will return no value. You can
always check whether a parameter has value or not by checking its property HasValue and modify the
code to the following:

m1 = (p1.HasValue?p1:0) + (p2.HasValue?p2:0) + (p3.HasValue?p3:0);

if (p1.HasValue && p1 > -10)
{
m2 = p1;
AddEvent(Event.e1);
}

Now, m1 will return value if any one of the parameters has value. In case you want to divide p1 by 10
and assign to m2, you shall modify the code as following:

m2 = p1.Value/10f;

You shall use its property Value in the equation, Otherwise, when saving script, you will get syntax error
like “Cannot implicitly convert type 'int?' to 'int'. An explicit conversion exists (are you missing a cast?)”.

Sanworl Studio, LLC © 2020-2021 68

Focus Analyzer Desktop User Guide

7.1.2 Output Result with Unique Key

You can find the build-in demo script “Demo Script WCDMA Coverage” for this example.
For scanner data, you can define a List parameter by drag-n-drop metric
like the one indicated by red rectangle to “Parameter” spreadsheet shown
below.

Once the “Occurrence” is set to “All”, the parameter is a list. Refer to Microsoft Document for example
on List. The most common use of the list are:

ecnoArray.Count //get the count of the list

ecnoArray[0] //get the first element of the list,

for(int m=0; m< ecnoArray.Count; ++m) { //iterate the list for each element
var ecno = ecnoArray[m];
}

If you want to output metric result for each UARFCN, you shall check “Output Metric Result for Each
Unique Key” on the toolbar and select a key, in this example, “UARFCN” is selected.

Instead of assigning value to metric like “m1 = 10;” if the above option is not checked, you shall assign
value to metric like “m1[currentUARFCN] = 10;”, where currentUARFCN is the variable that hold the
value of UARFCN.

If you want to output Event result for each UARFCN, check “Output Event Result for Each Unique Key as
Metric” in “Event” spreadsheet, you will need to add event by calling function
“AddEvent(currentUARFCN, Event.e1)” instead of “AddEvent(Event.e1)” described in the general
example, ;”, where currentUARFCN is the variable that hold the value of UARFCN.

Sanworl Studio, LLC © 2020-2021 69

Focus Analyzer Desktop User Guide

7.1.3 Script Debugger

With Script Debugger, you will be able to trace the runtime environment of the script execution. That
runtime environment includes the runtime value of the parameters and metrics at a timestamp. Script
Debugger is a useful tool for identifying your coding defects and verifying whether your algorithm works
as expected.

To enable the script execution to stop at the location where you want to check for the runtime
environment, you shall insert a built-in function call “CheckPoint();” in your code. The runtime
environment will be displayed on the left panel at a check point.

Press toolbar button “ Start Debugging” to start debugging, “ Abort” to stop. The check box “Pause
at CheckPoint” shall be checked so that the script execution will be stopped at that location. After you
exam the runtime environment, press “ Run to Next” to continue the script execution and stop at the
next check point. If you want to continue the script executing to the next check point at a specific
timestamp, select a timestamp in the dropdown combo box from submenu “ Set Next CheckPoint
Timestamp”.

To open Script Debugger, select context menu “ Generate Result with Script Debugger” in Dataset
Tree. However, the context menu will be enabled only on the following conditions:

1. Select “Private” Environment in Main toolbar

2. Select a dataset hierarchy with “file_name” and “device_index” as the last two levels. You can
simply select “[Default]” dataset hierarchy in Dataset panel.
3. Expand the dataset tree to the last level which is “device_index” level, right-click at the script
you want to debug, then select the context menu to open Script Debugger.

Sanworl Studio, LLC © 2020-2021 70

Focus Analyzer Desktop User Guide

7.2. Metric Group Builder

Select the menu “Metric Group Builder” under Main Window toolbar button to open Metric
Group Builder.

The purpose of this builder is to organize a few metrics from different message frames into a single table
in database, so that those metrics can be easily accessed by third-party tools. For example, you may
want to use a third-party tool such as Tableau to display data from Focus Analyzer.

Sanworl Studio, LLC © 2020-2021 71

Focus Analyzer Desktop User Guide

7.3. OLAP Cube Builder

Online Analytical Processing (OLAP) is a means of analyzing and organizing data. OLAP cubes are
multidimensional arrays of data, and can provide a way to optimize and speed up the access to data.

Select the menu “OLAP Cube Builder” under Main Window toolbar button to open OLAP Cube
Builder.

After the OLAP cube is defined, it will be listed in Dataset Tree. To process the cube, you shall select the
context menu “Generate Result” in Dataset Tree to process the OLAP cube in background. OLAP cube
can be used in various views described in context menu of Dataset Tree. It can be also used for reporting
and dashboards.

Sanworl Studio, LLC © 2020-2021 72

Focus Analyzer Desktop User Guide

8. Automation Task Builder

Press the Main Window toolbar button to open Automation Task Builder.

The created automation tasks will be listed in Automation Task window (tab on upper left side of
application). You can activate or de-activate a task in that window. Once a task is activated, it will run in
background to import data, generate reports, or purge unwanted data.

For Focus Analyzer running in a cluster as a Windows service node, its primary function is to run those
automation tasks in background to provide unattended data processing.

8.1 Import

The options to trigger the import of data:

• Real-time monitor file for import: Immediately after a data file is completely copied to the
monitored folder, it will be imported.
• Start import daily at: Once a day at the specified time, the application will start importing all
files found in the monitored folder.
▪ Folder to monitor: Specify the folder to be monitored looking for data files.
▪ Folder for imported file: Once a data file has been successfully imported by Focus, it will be
relocated to this folder.
▪ Folder for problematic files: If any file cannot be imported successfully, it will be relocated to
this folder.

Sanworl Studio, LLC © 2020-2021 73

Focus Analyzer Desktop User Guide

▪ Use subfolder as target dataset name: For example, if the folder to monitor is set to
“d:\monitor\” and the data files are in folder “d:\monitor\myDataset\”, the folder “myDataset”
will be used as dataset name of those files. If dataset “myDataset” does not exist, it will be
created automatically.
▪ Specific dataset name: pick an existing dataset or manually create a new dataset
▪ Use subfolder name to determine data type: For example, if the folder to monitor is set to
“d:\monitor\” and the data files are in folder “d:\monitor\nemo\”, the subfolder name “nemo”
indicates Nemo parser shall be invoked to import those files and error shall be given if any file is
not a Nemo file. Current supported folder names are “nemo”, “pctel” and “azq”.
If “Use subfolder as target dataset name” is selected, the folder path shall be defined as
“d:\monitor\myDataset\nemo”.
▪ Specific data type: Pick a data type that will be imported.
▪ Suffix name of parent folder to file: For example, if selected, the file
“d:\monitor\myDataset\nemo\folder1\folder2\data.nmf” will appear as file
“folder1_folder2_data” after imported.
▪ Metric import configuration: Pick a metric import configuration. These configurations allow you
to filter data so that only the parameters you require are imported, potentially reducing
processing time and saving storage space. You can also set the time bin value (in seconds) for
binning of data.
▪ Import Cell configuration under folder “cellconfig” using mapping: For example, if selected and
there is cell configuration file under folder “d:\monitor\cellconfig\”, the file will be imported as
cell configuration using the selected mapping.
▪ Import GIS data under folder “UDR”, “GisMap”, or “IndoorMap”: For example, if selected and
there is GIS data file under folder “d:\monitor\udr\”, “d:\monitor\GisMap\”, or
“d:\monitor\IndoorMap\”, the file will be imported automatically.
▪ Automatically extract GIS area features and save as UDR: For example, if selected and there is
GIS vector file under folder “d:\monitor\GisMap\”, the file will be imported, and the area
features in this file will be extracted and saved as UDR.
▪ Save source file to repository folder, use the file flag/subflag as folder/subfolder: If selected,
the source files will be saved to the repository folder specified in Preference dialog.
▪ File flag/file subflag: Set additional flags to tag the imported files. Later, those flags can be used
to build dataset hierarchy or filter in Device Explorer.

Sanworl Studio, LLC © 2020-2021 74

Focus Analyzer Desktop User Guide

8.2 FTP Monitor

Focus Analyzer can check an FTP folder and automatically download files under that folder to the
monitored local folder. Then, the application will import the downloaded files immediately or at a
specified time by seeing the files in the Import Monitored Folder parameters, which are defined in
“Import” tab.

▪ Check FTP folder for files and download to the monitored local folder every (minutes): If
selected, the application will check FTP folder and download files in the specified interval.
Select or define FTP login, then pick FTP folder to monitor.
After files in FTP folder are downloaded, the application will either delete them or relocate them to
another FTP folder.

Sanworl Studio, LLC © 2020-2021 75

Focus Analyzer Desktop User Guide

8.3 Data Source

If option “Report” is checked at the top of the Automation Task Builder window, tabs for reporting
options including tab “DataSource” will be enabled for editing.

You can select an existing dataset on the left panel, then select a dataset hierarchy node on the right as
the data source for reporting.

Or you can press the toolbar button “Show Listing Profile” to bring up the dataset hierarchy definition
on the right, then select a hierarchy level as data source. The report will be generated for each dataset
node in that level.

On the left panel, you can select default dataset settings and data filter for reporting. Refer to Dataset
tree for detail.

Sanworl Studio, LLC © 2020-2021 76

Focus Analyzer Desktop User Guide

8.4 Report Template

In the tab “Report Template”, you can select one or more report templates

Reports are defined in the Report Template Builder.

Sanworl Studio, LLC © 2020-2021 77

Focus Analyzer Desktop User Guide

8.5 Output Scheduler

The reporting can be scheduled to trigger at a specific time and in selected interval.

You can select to trigger reporting Hourly, Daily, Weekly, Monthly, or in Every user-defined interval. You
can also select trigger option “After import”. In this case, reporting will then be triggered when no-
more-file-to-be-imported is detected after the specific wait period.

In option “Data to Report”, you can select what data to be reported based on data time stamp.

The options in section “Output Folder/File Naming” are options for creating file name of output files.

Sanworl Studio, LLC © 2020-2021 78

Focus Analyzer Desktop User Guide

8.6 Output Location

In tab “Output Location”, you define where to deliver the report output.

Output is always created as Excel format, and you can also select PDF and HTML as output format. The
report output can be saved in a local folder or uploaded to an FTP folder. If the FTP folder is setup to be
accessible by a web site, the report output will then be immediately viewable in the web site.

The report output can also be sent to a list of recipients via email or text message. Email settings are
configured in the Preferences Email settings.

Sanworl Studio, LLC © 2020-2021 79

Focus Analyzer Desktop User Guide

8.7 Notification

Automation task will run continuously and unattended. Especially when the task is running in the cluster
node where Focus Analyzer run as Windows service with no user interface, a status notification is
critical.

Here you have option to receive the notification by email or text message, with one daily notification at
the specific time or multiple notifications daily in a period. If a notification is not received at the
expected time, then you can look into the system to confirm the automation tasks are running as
expected and resolve any problems.

The notification normally contains statistical information of file import and report generation activity.

Sanworl Studio, LLC © 2020-2021 80

Focus Analyzer Desktop User Guide

8.8 Database Purge & Vacuum

To access the tab “Dataset Purge & vacuum”, the option “Data Purging” shall be selected on the top
section of the Automation Task Builder screen.

Select which dataset and the age of data to purge & vacuum, and the trigger schedule.

Make an important note that the Purging and Vacuuming of data is a permanent action. Once the
data is deleted it can not be restored. The creation of a Data Purging Automation Task does not mean
data will be deleted. Deletion will only occur if the Automation Task is turned on, and the trigger event
happens.

Sanworl Studio, LLC © 2020-2021 81

Focus Analyzer Desktop User Guide

9. Report Template Builder

Press Main Window toolbar button to open the Report Template Builder. The Report Template
Builder is where you create and design reports. The templates are then used when generating both
reports and Focus Views.

All user-created report templates are listed in “Report” tab on the left. You can double-click your mouse
on a template name to open it in the spreadsheet for viewing and editing. All available data elements
that can be drag-n-dropped to the spreadsheet are listed in “Metrics” tab. For faster reporting, it is
strongly recommended to make use of OLAP Cubes.

Right-click your mouse at a cell to bring up the following context menu. That
cell is now the focus for the editing and inserting of report items.

Click “Define/Edit Report Item” to bring up the “Configuration” dialog (shown

below), where you can select a report item and drag-n-drop metric from
“Metrics” tab.

Sanworl Studio, LLC © 2020-2021 82

Focus Analyzer Desktop User Guide

Define the report item and parameters as you see fit. Click Apply in the upper right to apply the
selections and settings to the cell with the current focus (i.e., selection).

To remove a report item from the spreadsheet, right-click mouse at a cell and select context menu
“Remove Report Item”.

The following report items are provided for building a flexible and powerful report template.

• Single Aggregation
• Aggregation Chart
• Statistical Table
• Pivot Table
• Map View
• Time Chart
• Time Table
• Correlation Chart
• Cell Configuration Parameter
• File/Device Statistical Table
• Constant
• Loop
• LoopKey
• Profile Hyperlink

In Report Viewer, you can apply data to a template, view the output, and even edit and modify the
output.

Sanworl Studio, LLC © 2020-2021 83

Focus Analyzer Desktop User Guide

9.1 General Tips

While editing and building your report, the operation on the spreadsheet is quite like that of MS Excel.

1. define formula with functions comparable to Excel’s to produce result that are not
generated by Focus Analyzer reporting.
2. format cell.
3. Design chart appearance or create chart with data generated by reporting.

While the report configuration dialog is opened, you can click on any cell that has a defined Report Item,
the settings for that Report Item will be shown in the configuration dialog. Edit the definition as
needed, including changing the type of Report Item, and press “Apply” to update the definition for that
cell location.

In addition, you can apply the current definition to other empty (no Report Item) cells. Click on another
empty cell to place the focus selection on that cell, and press “Apply” to create a new report item.
Following these same steps has the added value of providing a way to copy and paste definitions from
one cell to another.

Sanworl Studio, LLC © 2020-2021 84

Focus Analyzer Desktop User Guide

9.2 Additional Settings

“Additional Settings” is available for most report items. In “Additional Settings” tab, if you check
“Overwrite default data filter”, you can define data filter in the same manner as the data filter in Dataset
Tree. This data filter will be applied to filter the data source, rather than the default data filter defined at
the Dataset Workspace. Refer to Report View for how to define default data filter.

In addition to the data filter, you can define a device attribute filter.

If the checkbox “Refer to Dataset in Workspace” is checked, the existing device attribute value in the
dataset selected in Dataset tree in Workspace will be available for selection. If unchecked, you can
choose the values here.

The Additional Settings will be available for many report items.

Sanworl Studio, LLC © 2020-2021 85

Focus Analyzer Desktop User Guide

9.3 Report Item: Single Aggregation

Right-click your mouse at the target cell in the spreadsheet → select the context menu “Define/Edit
Report Item” to bring up the configuration dialog → select Report Item “Single Aggregation” from the
combo box on the top toolbar.

There are three options for generating single aggregation.

• Single Metric Aggregation

• Event Time Offset Aggregation
• % of Area

Sanworl Studio, LLC © 2020-2021 86

Focus Analyzer Desktop User Guide

9.3.1 Single Metric Aggregation

To define a single metric aggregation,

1. select the “Metrics” tab on the left pane, browse to the desired metric,
2. drag-n-drop that metric to the Single metric aggregation text box,
3. pick the aggregation method,
4. if a filter is needed, drag-n-drop one or more metrics to “Condition Expression” spreadsheet,
select logical operator and define a value. If value of the metric can be looked up, you can press
icon on right to bring up lookup dialog foe selection.
5. press the “Apply” button to complete the definition.

Using Nemo data as an example, to get number of MO call connection success,

1. select Nemo Event “CAC: Call connect success” in the Step 1,

2. select attribute “Call direction” of Event “CAA: Call attempt” and

lookup value “[1]: MO” in Step 4.

The condition express defined in Step 4 will guarantee that only

call connection success which “Call direction” is equal to “MO” will
be counted.

The same approach can be applied to

any aggregation of data with a filtering
by itself or by other metric data.

To generate a percentage, select aggregation method such as “% Above” and

a threshold value.

Sanworl Studio, LLC © 2020-2021 87

Focus Analyzer Desktop User Guide

9.3.2 Event Time Offset Aggregation

This option provides a way to calculate aggregation of time offset between two events. Using Nemo
data as an example, to find out the maximum call connection establishment time,

• Select start event “CAA: Call attempt”.

• Select end event “CAC: Call connect success”.
• Select aggregation method “Max”.

If it is necessary, you can add condition expression to filter the data such as considering only MO call.
You can use the same condition expression as filter for both Start Event and End Event, or you can
uncheck “User same condition expression …” to define condition expression separately.

To find out the percentage of calls with connection establishment time longer than x seconds,

1. make sure you select “Second” as time unit.

2. Select aggregation method “% Above” and set the value to x which is
10 seconds shown on left.

Sanworl Studio, LLC © 2020-2021 88

Focus Analyzer Desktop User Guide

9.3.3 % of Area

This option is to generate a coverage percentage of the area that meets all the conditions defined in
Condition Expression spreadsheet. The metric data will firstly be aggregated by Geo grid location with
the defined bin size, then checked if all conditions are met. The percentage will be the number of grids
with value that meet all conditions over all grids.

For example, the grid size (meter) “50” indicates the size of square grid is 50x50 meters, if you collect
data in area with 1 km by 1 km, you will have 400 grids. The data collected within each grid will be
aggregated and produce one value, this value will be evaluated by the condition expressions. The
number of grids that meet the condition expression over total number of grids will be the result.

Please be aware that selecting different grid binning size will produce different coverage percentage.

Sanworl Studio, LLC © 2020-2021 89

Focus Analyzer Desktop User Guide

9.4 Report Item: Aggregation Chart

Right-click your mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report
Item” to bring up the configuration dialog → select Report Item “Aggregation Chart” from the combo
box on the top toolbar.

For the X value, you can select from the dropdown list:

• Time
Pick time interval in “Additional Setting” as argument
• Cell Sector
Pick cell configuration in “Additional Setting” column → pick cell parameter in “Attribute”
column as the parameter argument
• Device Attribute
Pick device attribute in “Additional Setting” as argument
• Plotband
Pick Plotband in “Additional Setting” as argument
• UDR
Pick UDR in “Additional Setting” column → pick area attribute in “Attribute” column as
argument
• Event Type
The distinct event description of an event metric defined in the “Measure” spreadsheet as the
argument

For the Y value, drag-n-drop a metric from “Metric” tab to the “Measure” spreadsheet, pick aggregation
method (for some aggregation method such as “% below”, a percentage value is needed in “Option”
column), and display type (option of Value, PDF and CDF).

If you like to generate the chart base on an OLAP Cube, you shall drag-n-drop a dimension of cube to be
the X value and measures to the “Measure” spreadsheet.

Sanworl Studio, LLC © 2020-2021 90

Focus Analyzer Desktop User Guide

You can select view options such as order by and palette in the “View Options” tab.

For “Additional Settings”, refer to Additional Settings

Press “Apply” to complete the definition. In the Report Builder spreadsheet, a chart frame will be
created. You can click at the frame to active it and drag the corner to resize it. Two new toolbar groups
“Design” and “Layout” will also appear after the chart frame is activated. Combined with the right-click
context menu, you can further design the chart.

The output of this report item is like the display in user interface Aggregation Chart.

Sanworl Studio, LLC © 2020-2021 91

Focus Analyzer Desktop User Guide

9.5 Report Item: Statistical Table

Right-click your mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report
Item” to bring up the configuration dialog → select Report Item “Statistical Table” from the combo box
on the top toolbar.

The definition of a statistical table is similar to that of Aggregation Chart, but you can define more than
one dimension.

There are additional options that can tune the output:

• Auto-insert cells for result

If the statistical table is not the last report item in the sheet, you may want to check this option
so that the reporting engine will automatically insert rows for the output and will not overwrite
other output in the sheet.
• Write Series/dimension titles in the first row
If this option is checked, the titles defined in “Dimension” and “Measure” spreadsheet will be
written in the first row, and the data will be written starting from the second row. Otherwise, it
will start from the first row.
• Copy cell format for the result
The cells in the definition row can be formatted, and this formatting will be automatically copied
to all rows of the statistical table.
• Limit PDF/CDF to per row dimension
Dimensions can be defined in Column or Row. If the option is checked, PDF/CDF will be
calculated only for the dimensions that are in Row location.
• Column space between output
The output columns can be separated by the specified number of columns. If the number is 1
and the first output column is in Column A, the second column will be in Column C and so on.

Sanworl Studio, LLC © 2020-2021 92

Focus Analyzer Desktop User Guide

9.6 Report Item: Pivot Table

Right-click mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report Item”
to bring up the configuration dialog → select Report Item “Pivot Table” from the combo box on the top
toolbar.

The definition of statistical table is like that of Statistical Table, but with more options in the vertical tab
“Pivot Table”.

For “Additional Settings”, refer to Additional Settings

The output of this report item is like the display in user interface Pivot View.

Sanworl Studio, LLC © 2020-2021 93

Focus Analyzer Desktop User Guide

9.7 Report Item: Map View

Right-click your mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report
Item” to bring up the configuration dialog → select Report Item “Map View” from the combo box on the
top toolbar.

You can drag-n-drop metric to the spreadsheet, then pick one of the following display types:

• Drive Route
• Distance Binning
• Grid Binning
• Sector Statistic: Aggregate the metric data based on sector coverage, and color the sector icon
per selected plot band.
• UDR Statistic: Aggregate the metric data based on UDR region, and color the region per selected
plot band.
The cell configuration and UDR used for calculating statistical value will be defined in the Report
Generation dialog. Refer to Report Viewer.

In the “View Settings” tab, there are many options for tuning the map view appearance.

Press “Apply” to complete the definition. In the Report Builder spreadsheet, a map frame will be
created. You can click on the frame to active it and drag the corner to resize it.

The output of this report item is like the display in user interface Map View.

Sanworl Studio, LLC © 2020-2021 94

Focus Analyzer Desktop User Guide

9.8 Report Item: Map View – Delta Map

Right-click your mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report
Item” to bring up the configuration dialog → select Report Item “Map View – Delta Map” from the
combo box on the top toolbar.

This report item must be defined in the cell right after report
item “Map view”, as shown on left. One and only one metric
shall be defined in “Map View” and its display type must be
“Grid Binning”.

The result delta map will be the different between the metric
defined in “Map View” and the metric defined in this report
item. The Plotband selected will be used to color the delta
value.

Sanworl Studio, LLC © 2020-2021 95

Focus Analyzer Desktop User Guide

9.9 Report Item: Time Chart

Right-click mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report Item”
to bring up the configuration dialog → select Report Item “Time Chart” from the combo box on the top
toolbar.

Drag-n-drop a metric from “Metric” tab to the spreadsheet and select chart type, the configure view
options to tune the chart appearance.

For “Additional Settings”, refer to Additional Settings.

Press “Apply” to complete the definition. In the Report Builder spreadsheet, a chart frame will be
created. You can click on the frame to active it and drag the corner to resize it.

The output of this report item is like the display in user interface Time Chart.

Sanworl Studio, LLC © 2020-2021 96

Focus Analyzer Desktop User Guide

9.10 Report Item: Time Table

Right-click mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report Item”
to bring up the configuration dialog → select Report Item “Time Table” from the combo box on the top
toolbar.

Drag-n-drop a metric from “Metric” tab to the spreadsheet. If any analysis event is drag-n-dropped to be
used as output, you can check “List only message around Events …” which will output only the messages
at the timestamp within the range of the events.

For “Additional Settings”, refer to Additional Settings.

The output of this report item is like the display in user interface Table View.

Sanworl Studio, LLC © 2020-2021 97

Focus Analyzer Desktop User Guide

9.11 Report Item: Correlation Chart

Right-click your mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report
Item” to bring up the configuration dialog → select Report Item “Correlation Chart” from the combo box
on the top toolbar.

Drag-n-drop a metric from “Metric” tab and define as X value or Y value. Other than the correlation
chart, you can include fitting curve, aggregation curve and area analysis in the output.

For “Additional Settings”, refer to Additional Settings.

The output of this report item is like the display in user interface Correlation Chart.

Sanworl Studio, LLC © 2020-2021 98

Focus Analyzer Desktop User Guide

9.12 Report Item: Cell Configuration Parameter

Right-click mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report Item”
to bring up the configuration dialog → select Report Item “Cell Configuration Parameter” from the
combo box on the top toolbar.

To be able to drag-n-drop a cell parameter to spreadsheet on right, pick an existing cell configuration as
reference.

This report item is essential for single site reporting which generates one report output for every cell
site. This report item will list the parameter of the target cell site.

Sanworl Studio, LLC © 2020-2021 99

Focus Analyzer Desktop User Guide

9.13 Report Item: File/Device Statistical Table

Right-click mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report Item”
to bring up the configuration dialog → select Report Item “File/Device Statistical Table” from the combo
box on the top toolbar.

Other than a metric, you can drag-n-drop device attributes to this spreadsheet. In addition, you can set
conditions for filter files, so that only the files where its attribute and metric data meet all the defined
conditions will be output.

Sanworl Studio, LLC © 2020-2021 100

Focus Analyzer Desktop User Guide

9.14 Report Item: Constant

Right-click mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report Item”
to bring up the configuration dialog → select Report Item “Constant” from the combo box on the top
toolbar.

There are three type of constant value:

• Dataset Name

• Reporting Time
• Constant Value: These type of constant values are normally used in analysis script coding and
building custom metrics.

Sanworl Studio, LLC © 2020-2021 101

Focus Analyzer Desktop User Guide

9.15 Report Item: Loop/LoopKey

Right-click your mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report
Item” to bring up the configuration dialog → select Report Item “Loop” or “LoopKey” from the combo
box on the top toolbar.

This report item is to define a looping report generation on a specific cell range. There are three
categories of “Loop by” parameter: Device Attribute, UDR Polygon, and Metric Key.

As an example, you can select metric key “LTE Cell-> EARFCN/PCI” as loop by parameter and pick Rank 1
which is equivalent to “Best #1” in the Dataset tree, then select “Vertical (Multi-rows)” and define the
row range between row 5 and row 27 which is vertically 23 rows from the current definition row. With
this, when generating a report, each EARFCN/PCI combination in the dataset will be used as a filter to
filter data and output the result. The output will be placed vertically one by one, and the corresponding
EARFCN/PCI value will be written in the cell with “LoopKey” definition.

If you select “Horizontal (Range by Rows x Cols)”, you will also need to define “# of column from current
to right” so that the report will be looped for each cell range (rows x cols) and place the result
horizontally one by one.

Sanworl Studio, LLC © 2020-2021 102

Focus Analyzer Desktop User Guide

9.16 Report Item: Profile Hyperlink

Right-click mouse at the target cell in the spreadsheet → select context menu “Define/Edit Report Item”
to bring up the configuration dialog → select Report Item “Profile Hyperlink” from the combo box on the
top toolbar.

The profile hyperlink provides a one-click shortcut for applying a dataset to the associated Workspace
view profile. However, this shortcut is valid only when the report is generated in Focus View.

The hyperlink can be applied to the cell with an existing report item or text.

Sanworl Studio, LLC © 2020-2021 103

Focus Analyzer Desktop User Guide

10. Dashboard Builder

Press the Main Window toolbar button to open Dashboard Builder.

First, create or select a data source by pressing toolbar button . In the popup editor (shown below),
drag-n-drop data element from left tree to right spreadsheet. Define both dimensions and measures,
then press toolbar button to add the data source to the dashboard designer and display on the left. It
is strongly recommended to use OLAP Cubes for faster data loading.

In the dashboard designer, you can select from toolbar button to create Pivot, Grid, Chart, etc. and
adjust its location and size, then define the data item for the view by drag-n-drop the field defined in
data source to the “Data Items” pane in the middle.

In Dashboard Viewer, you can view the dashboard with real data.

Sanworl Studio, LLC © 2020-2021 104

Focus Analyzer Desktop User Guide

11. Configuration Management

Press Main Window toolbar button to open the following dialog.

In this dialog, you can upload your private configuration/data to the Cluster Central Database for sharing
or download the shared configuration to local machine and make it to be your private configuration so
that you can modify.

The private configurations are listed on the left pane, and the shared configurations are listed on the
right. You can drag-n-drop a configuration from left to right which will upload it for sharing, while from
right to left which will download it from central database to your local machine.

Some of configuration may depend on other configurations, for example, a report template could
depend on some analysis scripts. To check if any shared configuration has dependency issues like
missing a dependent configuration, press toolbar button “ Check Integrity” to perform the checking.
Press toolbar button “ Auto Upload” to automatically upload all dependent configurations from your
private configuration to Central Database so that the integrity of all shared configurations has been well
preserved.

Sanworl Studio, LLC © 2020-2021 105

Focus Analyzer Desktop User Guide

12. Tools
12.1. Dataset Management

Select menu “ Dataset Management” on the Main Window toolbar to open the following dialog:

This dialog provides the overview of the computer cluster and the datasets in each cluster node. You can
delete or rename a dataset resided in any node. You can also mark a dataset to be public or private.

Sanworl Studio, LLC © 2020-2021 106

Focus Analyzer Desktop User Guide

12.2. Raw Data Repository

Select menu “ Raw Data Repository” under Main Window toolbar button to open the following
dialog.

The raw data repository is a folder that archives raw data files after imported, and only if during import
you choose option to “Archive files to Raw Data Repository”. In this dialog, you can browse raw data
repository in any cluster node and download or delete them.

Sanworl Studio, LLC © 2020-2021 107

Focus Analyzer Desktop User Guide

12.3. Plotband Management

Select menu “ Plotband Management” under Main Window toolbar button to open the following
dialog.

The following types of Plot bands are available: Discrete, Heatmap, and Range. You can define new plot
bands for all the types.

This dialog can also be opened in Dataset Tree when you select context menu “Edit Plotband:…” of a
metric. Press the toolbar button “ Select & Exit” in this dialog to assign a selected Plotband to the
metric.

When define Range type of plot bands, the value in column “From (Inclusive)” is equivalent to “greater
than and equal to”, the value in column “To (Exclusive)” is equivalent to “less than”.

Sanworl Studio, LLC © 2020-2021 108

Focus Analyzer Desktop User Guide

12.4. Vendor’s Parameter Mapping

Select menu “ Vendor’s Parameter Mapping” under Main Window toolbar button to open the
following dialog.

This dialog lists the supported vendor’s data formats and the mapping between vendor’s parameters
and Focus Analyzer’s metrics.

Sanworl Studio, LLC © 2020-2021 109

Focus Analyzer Desktop User Guide

13. Specific Topic

13.1. Indoor Map and Data

Focus Analyzer can import Nemo indoor map and data. After the date file imported, the indoor map will
be imported and listed under “Indoor Map” tree node in GIS data tree.

If Nemo data contains indoor map and its geo reference is specified in *.tab file, you can display the data
with indoor map in both Outdoor Mode (shown below on left) and Indoor Mode (shown below on right).
You can switch between these two Mode by right-click context menu “Indoor Mode” shown below.

If Nemo file does not contain georeferenced indoor map or the georeferenced is not in geographics
coordinate system, the indoor map will be simply imported as an image. At this situation, you will be
able to display data only in Indoor Mode (shown above on right). However, Focus Analyzer provides
Indoor Map Rectifier to manually geo reference an indoor map by drag-n-drop.

To display indoor map in Map View, you can drag-n-drop from GIS
data tree, or select context menu “Show Indoor Map In Map View”
of the file in Dataset tree. You may need to select “[Default]”
dataset hierarchy which defines “file_name” and “device_index” as
the last two levels, so that you can access the specified context
menu.

Sanworl Studio, LLC © 2020-2021 110

Focus Analyzer Desktop User Guide

13.1.1. Indoor Map Rectifier

Press toolbar “ ” on Workspace window or select context menu “Geo Rectify” in GIS data tree to bring
up “Indoor Map Rectifier”.

The original image is displayed on left, on the right is map view. both sides have two pins with
corresponding colors. Drag-n-drop the pin to stretch the image to the desire geo location. Initially three
pins on Map View are docked on the top-left corner, after you relocate the pins, you shall press toolbar
button “ Apply” to display the image on Map View. press toolbar button “ Save” to finalize the
rectification.

Sanworl Studio, LLC © 2020-2021 111