63
Gladiator Custom Design Center Training

G-Station 5.x - Custom Design Center

Embed Size (px)

DESCRIPTION

gladiator report generation

Citation preview

Page 1: G-Station 5.x - Custom Design Center

Gladiator Custom Design Center Training

Page 2: G-Station 5.x - Custom Design Center

Custom Design Center

Page 204/21/2023

OverviewCustom design center

Ability to create new reports in Gladiator

Ability to customize existing reports

Reports can be produced inExcel or HTML files

Page 3: G-Station 5.x - Custom Design Center

Custom Design Center

Page 304/21/2023

Overview

Three ways to access CDC

Icon in Toolbar

From MenuTools Custom Designer Center

F10 shortcut key

Page 4: G-Station 5.x - Custom Design Center

Custom Design Center

Page 404/21/2023

Main menu

Allows ability to manage CDC reports such as:

Open: allow user to open a existing report.

Create new: enable user to create a new report.

Delete: allow user to delete a existing report.

Copy: enable user to make a copy of the report and assign a new name to it.

Rename: allow user to rename the report.

Import/Export: enables user to import or export a report and share them across different machines.

Overview

Page 5: G-Station 5.x - Custom Design Center

Custom Design Center

Page 504/21/2023

Five items to configure

Data Source

To create devices for Scanner and Phone

Parameter Tables

To create input parameters for the report

Procedures

To create calculations, statistics and

Histograms, etc…

Outputs

To create tables, graphs and map

Layout

To create layouts

Overview

Page 6: G-Station 5.x - Custom Design Center

Custom Design Center

Page 604/21/2023

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

Page 7: G-Station 5.x - Custom Design Center

Custom Design Center

Page 704/21/2023

Right click on the Data source node and select New Device

Choose the equipment, technology, and Device type

Data Sources

Page 8: G-Station 5.x - Custom Design Center

Custom Design Center

Page 804/21/2023

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 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

Page 9: G-Station 5.x - Custom Design Center

Custom Design Center

Page 904/21/2023

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

Page 10: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1004/21/2023

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

Page 11: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1104/21/2023

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

Polygon – can be used to filter data by a specific region. The polygon for the desired area must be created in advance

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 dropping them into any field where a number or expression is required.

Parameter Types

Page 12: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1204/21/2023

Data sets represent the information that will be gathered for processing in the report.

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

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

Datasets can comprise of any of standard frame of (Tables starting with “G_”) or any other table in the workspace

Data Sets

Page 13: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1304/21/2023

To create a Data set

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

Data Sets

Page 14: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1404/21/2023

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

Page 15: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1504/21/2023

Define the Data source

Preview the data set

Available measuremen

ts

Selected measuremen

ts

Define the order and

properties for the columns

Select measuremen

ts Shows query in SQL

Custom Data Set

Save the preview table to

the Result

node in open

Workspace

Page 16: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1604/21/2023

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, hence 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

Page 17: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1704/21/2023

Define the Data source

Preview the data set

Available KPIs

Define the thresholds for

the KPI

KPI Data Set

Page 18: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1804/21/2023

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

Page 19: G-Station 5.x - Custom Design Center

Custom Design Center

Page 1904/21/2023

Type the name of a stored procedure,

table or SQL Query

Preview the data set

Select the type of SQL

dataset

Define the input

parameters for the

procedure

SQL Data Set

Page 20: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2004/21/2023

Select a ADS script to be

used

Preview the data set

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 dropping from parameters node.

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

Define the input

parameters for the

script. Drag and drop.

Page 21: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2104/21/2023

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

Page 22: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2204/21/2023

Select a ADS script to be

used

Preview the data set

Define the system data

source

System Data Set

Available measuremen

ts

Selected measuremen

tsSelect measuremen

ts

Define the element

type

Page 23: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2304/21/2023

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. The two procedures are merged veritically.

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 the procedures to be merged

Preview the data set

Page 24: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2404/21/2023

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

Note that only two tables can be joined at a time

The “Where” clause is the condition on which the tables will be joined and it can be generated by choosing culoms for each table and setting the codition.

Join Data Set

Page 25: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2504/21/2023

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

Page 26: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2604/21/2023

Preview the data set

Select tables to join

Join Data Set

Select one of the return

options

Page 27: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2704/21/2023

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

Parsing vectors

Procedures

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

Page 28: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2804/21/2023

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’.

Calculation Procedure

Page 29: G-Station 5.x - Custom Design Center

Custom Design Center

Page 2904/21/2023

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.

Calculation Procedure Cont.

Page 30: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3004/21/2023

Calculation Procedure

Allows to apply filters

Create Expression

Group by option

Page 31: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3104/21/2023

Compress procedure compresses the input table identical to the way a table can be compressed in Gladiator’s workspace.

All Gladiator compression methods are available.

User can also define exceptions and exception groups.

Parameters can also be used to specify bin size.

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

Page 32: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3204/21/2023

Compress Procedure

Select a type and method

for compression

Page 33: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3304/21/2023

Copy Previous Procedure

Before

Fill null values with previous information

Page 34: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3404/21/2023

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.

Page 35: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3504/21/2023

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.

Page 36: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3604/21/2023

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

Page 37: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3704/21/2023

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.

Page 38: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3804/21/2023

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.

State Machine Procedure

Page 39: G-Station 5.x - Custom Design Center

Custom Design Center

Page 3904/21/2023

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.

State Machine Procedure

Page 40: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4004/21/2023

State Machine Procedure

Create the states Create the

variables

Create the outputs

Add conditions

Set variables and outputs

Preview the

procedure

Page 41: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4104/21/2023

Parsing vector procedure

Certain drive test tools report entries in rows as vector entries

Since these rows are not parsed, the data cannot be used for display in any of the Gladiator views.

A CDC procedure was developed to parse this data. It allows the following functionality:

Parsing of data using two different methods: By column or by row

Parsing using different parsing rules depending on the type of data

User can specify invalid values to be omitted from the parsing procedure

Page 42: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4204/21/2023

Parsing vector procedure

Specify columns to be parsedSpecify

delimiter

Specify vector

indexes to parse

Specify invalid

values to be

replacedSpecify parsing method:

By column or by row

Page 43: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4304/21/2023

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

Table

Graph

Map

Disk

Output group

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

Page 44: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4404/21/2023

Table Output

Allows users to configure table formatting options

Color

Borders

Fonts

User can select which columns will be displayed in the table

Page 45: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4504/21/2023

Graph Output Types

Select graph type

Available graphs

Page 46: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4604/21/2023

Graph Output Data Source

Select the source data for the Graph

Select the series and values

Graph source

For “line column”

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

Identify the columns to be

used

Page 47: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4704/21/2023

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.

Page 48: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4804/21/2023

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

Page 49: G-Station 5.x - Custom Design Center

Custom Design Center

Page 4904/21/2023

Graph Output Legend

Define Properties for Legend

Location

Size

Margins

Font

Page 50: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5004/21/2023

Graph Output Fonts

Define font properties for the titles and labels

Page 51: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5104/21/2023

3D Graph Output

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

Rotation properties

Perspective properties

Page 52: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5204/21/2023

Line Graph Output

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

Smoothness

Show data points

Page 53: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5304/21/2023

Map Output Data Source

Map data source

Layer order: Use arrows to assign layer order. Higher elements will

be on top

System and vector layers are parameter

s

Click on ‘+’ icon to add

Data, System and Vector

layers to map.

Properties allows to

configure color scheme, icon

size and legend

Page 54: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5404/21/2023

Map Output Options

Output Name.

Configure zoom options

Configure where the legend will be displayed

Configure if legend will display and position

Page 55: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5504/21/2023

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.

Page 56: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5604/21/2023

Map Legend separate output

If desired the legend can be created as child output.

Hence can be placed conveniently outside of the map in layouts.

Page 57: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5704/21/2023

Output Group

Allows Outputs to be grouped

Allows user to toggle whether a group will be included in report using a condition.

Boolean parameters are used to define these options.

Page 58: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5804/21/2023

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

HTML Layout

Excel Layout

HTML block

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.

HTML block is an HTML layout that can be placed within the parent HTML layout and allows the user to control under what conditions it will be shown.

Page 59: G-Station 5.x - Custom Design Center

Custom Design Center

Page 5904/21/2023

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

Page 60: G-Station 5.x - Custom Design Center

Custom Design Center

Page 6004/21/2023

HTML Layout

Drag and drop the outputs to

the desired position in the

layout

Use HTML editor tools in order to create

your HTML

Freely resize the outputs to set their size in the layout

Page 61: G-Station 5.x - Custom Design Center

Custom Design Center

Page 6104/21/2023

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

Page 62: G-Station 5.x - Custom Design Center

Custom Design Center

Page 6204/21/2023

HTML block

HTML blocks are grouped outputs that are added to the main HTML layout.

If outputs do not produce any data the user can choose to have the block omitted from the main HTML layout

Can specify to show block if all outputs have data or at least one

Drag and drop to main layout when finished creating HTML block

Create an HTML block as you would an HTML layout

Page 63: G-Station 5.x - Custom Design Center

Custom Design Center

Page 6304/21/2023

Running the Reports

Select a report to run

Set the input parameters

Select the devices

Choose folder and report

name