KPI Dashboard workspace

The Key Performance Indicators (KPI) dashboard displays mainly a set of KPI “widgets”.

A widget hosts a graphical representation of a specific KPI.

Different graphical representations can be used, depending on the nature of each KPI (→ KPI Widgets).

The main four areas of the KPI Dashboard can be described as follows (see the respective markers A, B, C, D):

Indicators GUI Area

A

Upper Bar

B

Search Bar

C

Widgets Toolbar

D

Widgets Workspace
Items Description

Click the PTV Optima logo to access three shortcuts:

  • SITEMAP: A hierarchy of links reproducing the main workspaces available on the GUI:

  • FORECAST: A red dashed square is drawn for a few seconds around the FORECAST MONITOR widget:

    Through the FORECAST MONITOR you can start or stop the simulation and choose the simulation engine by clicking on the "three dots" icon (yellow square).

  • DOCUMENTATION: The Optima Help Center, hosting the user assistance information you may need to use the product.

Click the OptimaCompanion icon to access the chatbox.

Companion is the intelligent assistant based on a Generative Artificial Intelligence engine, fed with Optima documentation material.

Tip:  This icon is only visible if the tag <hasChatbot>= true. See → Global configurations for more details.

 
Placeholder for customer logo.

Detection and Control KPI list.

The red bubble shows the number of active alerts associated through the Optima Detection and Control module (→ Optima Detection and Control (ODC)).

Click the bell icon to access the list of alerts (→ KPI alerts).

Administration area

Click to:

  • Clear the user settings.
  • Change language (of the User interface).
  • Log out.

Calendar area

It displays the date in local format.

If you click on a date, you can associate a day type to a specific set of dates (or to a single date).

See → Associate a day type to a date (to a set of dates).

Connection area

Click to check the connection status (→ Setting a connection between maps) between two or more maps:

  • No connection available.
  • Connection available.
  • Sending data to the connected map.
  • Receiving data from the connected map.

Through the Search Bar you can search for traffic model elements stored in the system.

You can use specific commands for a detailed search or for performing operations by using an appropriated syntax.

The main syntax expressions are as follows:

  • item
  • command item [{idno|Id} = value]
  • Layer : item
Command items Description

command

The values for this parameter are: add, show, open, etc.

item

The values for this parameter, which is related to the Traffic Data Model items, are: Map, Node, Street, Link, Centroid, Event, etc.

idno

Numeric identifier associated with the item.
Id Alpha-numeric identifier associated with the item.
= Equal sign.
value Value associated with the item in the current configuration.

Examples:

Command expressions Description
Map It opens a new map.
show Nodes idno=1 It opens a new map with details related to the Nodes layer, focusing on a Node identified by idno=1.
add Events It opens a new map with an Events layer.

Layer: KPI

 It opens the current map with a KPI layer added to the list of the active layers.

From the collapsible Widgets Toolbar

you can choose several operations.

Icon Description

Push up the widgets.

If the current widgets are too scattered in the Widgets Workspace area, you can group them.

Add a KPI widget.

Delete all KPI widgets. A pop-up window opens to confirm the choice.
Open or close the collapsible toolbar.

Several operations are available to manage KPI instances and KPI widgets.

  1. Open the KPI Dashboard.

  2. Click an empty space of the Widgets Workspace (mouse hover on an empty space and the symbol appears).

    The ADD KPI WIDGET pop-up window opens.

  3. Click Create new KPI.

  4. Run the procedure → Adding a KPI.

    Tip:  The KPI added is listed in the KPIs frame.

You can add a KPI widget to the KPI Dashboard, starting from a list of preset KPIs.

Important:  A specific KPI can be associated with different widgets. A selected widget can also host different KPIs.

  1. Open the KPI DASHBOARD.

  2. Click an empty space of the workspace (mouse hover on an empty space and the symbol appears).

    The ADD KPI WIDGET pop-up window opens.

  3. In the WIDGET NAME text area, insert the name of the new KPI widget.

  4. The KPIS area lists the available KPI.

    Tip:  If the list hosts a high number of items, you can use the search engine to find the right KPI.

  5. Select one or more KPIs.

  6. According to the selection expressed in the previous step, in the WIDGETS area you can select the available widgets.

    Tip:   In the WIDGETS list you can select ONLY the widget types that are compatible with the nature of the KPIs (at least one) selected in step 5.

  7. Click SAVE.

The KPI Dashboard opens and the new widget is added.

Tip:  You can also select a widget in the WIDGETS area. According to your selection, only a subset of compatible KPIs are now selectable in the KPIS area.

Important:  If you close the browser window containing the Control Room Dashboard, all browser instances containing the associated KPI widgets are automatically closed.

Topics in this section