gladiator custom design center

April 17, 2023

Gladiator Custom Design Center

Gladiator Essentials April 17, 2023

Options

There are 3 options:

Option 1: Custom Analysis and Report – CAR (Light version of CDC)

Option 2: Custom Design Center – CDC

Option 3: CDC + ADS – enhanced capability with scripting environment

Page 2


Overview

Custom design center

Ability to create new reports in Gladiator

Ability to customize existing reports

Reports can be produced in Excel or HTML files



Page 4

Overview

Two ways to access CDC Icon in Toolbar

Menu Analysis Custom Designer Center


Four items to configure

Data Source

Ability to create devices for Scanner and Phone

Procedures

Ability to create calculations, statistics and Histograms, etc…

Outputs

Ability to create tables, graphs and maps

Layout

Ability to create layouts

Overview


Right click on the Data source node and select New Device

Chose the equipment, technology, and Device type

Data Sources


Data Sources are used as inputs to the report

Data sources can be seen as generic devices from a certain technology and drive test tool

For each data source created, the user will need to specify a device when running the report

System data sources can be used to process system data. It is possible to correlate drive test and system information using both types of data sources

Data Sources


Right click on the Parameter tables node and select New Parameter table

Right click on a parameter table and select one of the options from the menu

Parameter Tables


Parameter Tables are used to create input parameters for the report

Several parameters of different types can be created in a parameter table

Use different parameter tables in order to better organize your parameters. Parameters can be grouped by type, or by functionality within the report

Parameter Tables

Parameters from the same parameter table will be grouped in the report execution GUI


Text – can be used to add any user specified text to the report layout.

Integer – integer numbers that can be used almost anywhere in the report. For example, as a reference value for a KPI.

Float – floating point numbers that can be used almost anywhere in the report. For example, as a threshold for a statistics procedure.

Boolean – A true/false parameter that can be used to control report options. For example, to save or not a map to the workspace. In the report execution GUI it is displayed as a checkbox.

Color – color parameters can be used almost anywhere where a color can be set. For example, to set the color of graphs.

Parameter Types


Date – dates can be used in several ways inside the report. They can be used to filter data from a certain period of time, for example.

Vector – can be used to add user selected vectors to a map

System – can be used to add user selected systems to a map

Map – can be used to select a map area for map zooming

There are also some pre-defined parameters that can be used as information on the report.

Any of the parameters described above can be used by just draging and droping them into any field where a number or expression is required.

Parameter Types


Right click on the Procedures node and select one of the options from the menu

Data Sets


Data sets are where the data will be gathered for processing in the report.

Several types of data sets are available. Each of them will be described in detail in the next slides.

Data sets are always in the first level in the tree view below the procedures node. They are used as input for the procedures below.

Tips for using data sets more effectivelly:

Always think of a data set as a table containing some relevant raw data that is going to be further processed within the report

If you need a report to run for multiple drive test tools, remember to select only gladiator standard tables. They are the ones begining with “G_” and they are always present in files from any drive test tool.

Data Sets


Define the Data source

Preview the data set

Available measuremen

ts

Selected measuremen

ts

Define the order and

properties for the columns

Select measuremen

tsShows query

in SQL

Custom Data Set


A custom data set can be used in order to build a custom table by selecting columns from several original tables.

The available original tables are listed according to the technology and drive test tool selected from the data source.

Many columns from different tables can be combined in a single data set.

Users can change the internal name of the columns to be used within the report by clicking the “properties” button.

The order of the columns can be changed using the up and down arrows.

Custom Data Set


Define the Data source


Available KPIs

Define the thresholds for the KPI

KPI Data Set


KPI data sets can be used to take advantage of several pre-defined KPIs existing in Gladiator.

The KPIs listed depend on the technology of the selected data source.

Some KPIs already provide the final result for the report, no need for further processing!

Some other KPIs, called “optimization” KPIs, provide tables from which the final KPIs can be calculated. These raw tables can be used to draw maps, for instance..

All thresholds can be taken from parameters instead of directly typing the number. This makes the report more flexible, so the user can define the thresholds from the GUI, when running the report.

KPI Data Set


Type the name of a stored procedure,

table or SQL Query


Select the type of SQL

dataset

Define the input

parameters for the

procedure

SQL Data Set


SQL data sets can be used by advanced users in order to directly manipulate tables using SQL server

Three types of SQL data set are available:

Stored procedure – can be used to call a stored procedure from the database. Gladiator will read the input parameters for the procedure and display them in Gladiator. Users can directly type values or drag and drop parameters to the corresponding fields. Even data sources can be dragged and dropped to be used as a File Id input parameter.

Table – selects a whole table from the SQL server. User just needs to type the name of the table (as it is on the SQL database).

Query – User can freely type any SQL query to be executed in the database.

SQL Data Set


Select a ADS script to be

used


Define the input

parameters for the script

ADS Data Set

ADS data set enables any ADS script to be used as a data set, as long as it returns a table.

User can define the input parameters for the ADS script by either typing them directly or draging and droping from parameters node.

Data sources can also be dragged and dropped to be used as File Id.


Select a ADS script to be

used


Define the system data

source

System Data Set

Available measuremen

ts

Selected measuremen

tsSelect measuremen

ts

Define the element

type


System data set can be used in order to manipulate system data inside the report.

In order for a system data set to be created, a system data source must be defined first.

A list of all available parameters for the selected element type will be displayed on the left side of the screen.

They can be selected to the right side in order to create the data set, just like in the custom data set.

The order of the columns can be changed by using the up and down arrows.

System Data Set



Select the tables to be

merged

Merge Data Set

Merge data set enables the user to create a new data set from merging the outputs of any existing procedures or other data sets.

Columns with the same name are merged into one. The other columns will be also added to the data set, but they will just have blank values on the lines where data comes from a table where they don’t exist.



Select two tables to join

Join Data Set

Type the condition to

join

Select one of the return

options


Join data set can be used to join two tables by using one column as reference.

Please note that only two tables can be joined at a time!

The “Where” clause is the condition on which the tables will be joined. Usualy it is just saying to join the tables using a column as reference. The syntax is:

tableA.columnA = tableB.columnB

The name of the columns in the data set will be always like:

tableA_columnA

This is because as both tables can have columns with the same name, you need to know always from which table each column originally came from.

Join Data Set


The line return options are the following:

Return only matching rows – only rows matching the condition on the “where” clause will be returned.

Return all rows from first table – All rows from first table will be returned, but only rows matching the “where” clause will be returned for the second table.

Return all rows from second table - All rows from second table will be returned, but only rows matching the “where” clause will be returned for the first table.

Return all rows from both tables – returns all rows from both tables, regardless of the “where” condition. The rows where the condition is met will be presented first.

Join Data Set


Right click on a data set and select one of the procedures below:

Calculation

Compress

Copy previous

Statistics

Histogram

Joint histogram

ADS script

State machine

Procedures

Note: Procedures are used to process a table from a data set or from other procedures.


Calculation Procedure

Allows to apply filters

Preview Data

Group by option

Create Expression


Calculations allow further customization in the form of functions to be performed on the input table.

Users can further remove columns from the input table or rename them.

Other capabilities include filtering the table based on certain criteria as can be done in Gladiator’s Table view filter feature.

Users also have the power of performing familiar SQL operations such as ‘Group by’ and ‘Top’.

One of the most power features is the ability to completely replace a column with an expression that can include any combination of other column variables, mathematical operators and excel like functions. For example the user can sum up multiple column variables using the sum function, multiply it by number x, and divide result by 100.



User can sort the result table by any column (ascending or descending).

Parameters can be used in the expressions.

Columns can be reorganized using the up and down arrows.



Compress Procedure

Select a type and method for compression


Compress procedure compresses the input table just like a table can be compressed in Gladiator’s workspace.

All Gladiator compression methods are available.

User can also define exceptions and exception groups.

Compression schemes can be saved and loaded. Same compression schemes can be used in Gladiator workspace or Custom Design Center.

Compression is useful when there is a need to compare data that is sampled in different time intervals. Another use is to make data “lighter” for drawing a map.

Compress Procedure


Copy Previous Procedure

Before

Fill null values with previous information


Statistics Procedure

Easy way to calculate Statistics

Select the column from which to calculate the statistics

Insert the “Percentage at value” and “Value at percentage” thresholds. Parameters can be used in these fields.


Histogram Procedure

Histogram

Calculates the count, percentage and cumulative percentage for each range.

Select the column

Select a Color Scheme or type the range

Range values are separated by comma.

Text parameters can be used as range.


Joint Histogram Procedure

Select a Color Scheme or

type the range

Select columns that will be

used

Ability to compare different information in the same Histogram

Very useful for creating 3D graphs


ADS Procedure

Select the ADS script to be

used Type the input parameters

Any ADS procedure can be used to process a data set table as long as it receives and returns a table.

The first parameter must be a table. This is automatically assigned to the data set table.

The other parameters can be either typed directly or dragged and dropped from the parameters node.


State Machine Procedure

Create the states Create the

variables

Create the outputs

Add conditions

Set variables and outputs

Preview the

procedure


State machine procedure can be used to run a state machine on each row of the input table.

For each row the condition will be checked and if true, the following will happen:

State will be changed from the current state to the one specified in “Set state to”.

Variables will be set according to the expressions specified in “Set variables”.

Outputs will be set according to the expresisons specified in “Set outputs”.

The output table will contain all columns from the input table, plus one column for each specified output.

The output values for each row will be included in the corresponding output column.



The conditions will be checked in the order they are displayed. Order can be changed using the up and down arrows.

When a condition is met, the state will be changed and the state machine goes to the next row of the input table. The conditions will start to be checked again from the first one, considering the new state.

The state machine procedure is often used with layer 3 messages in order to perform some call analysis, but it can be used with any other information as well.



Right click on the outputs node and select one of the options below:

Table

Graph

Map

Disk

Outputs are used to present the results of the report.

Any table coming from a data set or procedure can be used in the outputs.

The outputs preview show how the data will be displayed in the layout of the report.

Outputs


Table Output

Allows users to configure table formatting options

Color

Borders

Fonts

User can select which columns will be displayed in the table


Graph Output Types

Select graph type

Available graphs


Graph Output Data Source

Select the source data for the Graph

Select the series and values

Identify the columns to be

used

Graph source

For “line column”

graphs, select which column will be used to draw the line and column


Graph Output Colors

Select the data color

Select background color

Select the Grid color

Information color.

Background color.

Grid color

Colors can be taken from parameter tables.


Graph Output Labels

Configure titles and labels

Configure the interval for the values’ axis

Configure the margins

Insert the titles and label.

User can configure the

range’s interval.

Set the margins


Graph Output Legend

Define Properties for Legend

Location

Size

Margins

Font


Graph Output Fonts

Define font properties for the titles and labels


3D Graph Output

3D properties will be enabled when Pie or 3D graphs are selected

Rotation properties

Perspective properties


Line Graph Output

Line properties will be enabled when Area, Line or Line column graphs are selected

Smoothness

Show data points


Map Output Data source

Identify the data source for the Map.

Possible to insert Data, vectors an System.

Map data source

Data that will be displayed in

the map

Add new data

Remove data

Properties allows to

configure color scheme, icon

size and legend

Layer order


Map Output Options

Output Name.

Configure zoom options

Configure where the legend will be displayed

Configure if legend will display number of samples on each range or not


Map Output Saving Options

Allows exporting to MapInfo.

Possibility to save the map into gladiator workspace.

Boolean parameters can be user in order to define these options. This lets the user choose if he wants maps to be saved or not during report execution.


Right click on the Layouts node and select one of the options below:

HTML Layout

Excel Layout

Layouts are used to organize the outputs in the final report layout.

When report is run, all defined layouts are saved in the selected report folder.

Layouts

HTML layouts can be published on the web.

Excel Layouts can be used when there is a pre-defined Excel template.

Excel Layouts are also useful when data needs to be further manipulated by using Excel formulas.

A report can have several layouts.


HTML Layout

Drag and drop the outputs to the desired position in the layout

Use HTML editor tools in order to create your HTML layout

Freely resize the outputs to set their size in the layout


Users can create the HTML layout directly in Gladiator’s HTML editor or open an existing HTML file to be used as a template.

Ouputs can be easily dragged and dropped to the layout and repositioned or resized at any time.

Simple HTML Layouts can be quickly created within Gladiator.

HTML Layouts are ready to be published on the web.

HTML Layout


Excel Layout

Excel layouts paste the results on an existing Excel file and then saves it on the selected report folder.

Sheet name, row and column can be chosen for each individual output.

Width and height can be configured for pictures (Graphs and Maps)

Identify the template

Select which information will be exported to Excel


Running the Reports

Select a report to run

Set the input parameters

Select the devices

Choose folder and report name


Exercise 1

1. Create a new Data source

Equipment: Agilent

Technology: GSM

Device: Phone

2. Rename it as Phone1


1. Create a new Custom data set in the procedures node and add the following columns from the G_GSMLayer1 table.

Rx Level (Full)

Rx Qual (Full)

2. 2. Create Statistics, Histogram and Joint Histogram procedures with the properties below for each of the columns from the data set.

Statistics

Rx Lev PAV -95, RxQual 4

VAP 95

Histogram

Color scheme GSM_RxLev and GSM_RxQual

Joint histogram

Axis X RxLevel and Axis Y RxQual

Use the same color schemes that were used before

Exercise 2


Exercise 3

1. Create output tables for all those tables created before..

Use the option Border: thin.

Use the color “Light blue sky” for 1st row.

2. Create histogram graphs for all Histograms and Joint histograms created before.

For Histograms use column and line option.

For Joint Histograms use the 3D option.

Use the color “Light blue sky” for the data.

3. Create Output Maps for RxLevel and Rxqual.

RxLevel with scheme GSM_RxLev and icon size 2

RxQual with scheme GSM_RxQual and icon size 2


Exercise 4

1. Crate one Layout using a blank Excel file, use the configuration below.

2. Run the Report.

gladiator custom design center

Documents