KPI templates

Optima provides a wide set of KPI templates.

A KPI template defines in an abstract way a KPI for a given KPI provider, specifying all default behaviors and the associated constraints.

Important: KPI templates cannot be created through either APIs or by the Traffic Supervisor GUI.

A KPI template is defined by the following attributes:

KPI Attribute Required Description

template_id

YES

Integer type.

Unique identifier of the template.

name

YES

String type.

Name of the template.

query

YES

String type.

Preset query common to all the KPIs associated to the template.

editable

YES

Boolean type.

true: the KPI instance derived from the KPI template is editable.
false: Not editable.

enabled

YES

Boolean type.

true: The KPI instance is enabled to be computed.
false: Not enabled.

improvingDirection

YES

String type.

To understand if the current KPI value is better than the previous value, it is important to state if it is increasing (the higher value is better) or decreasing (the lower value is better).

Possible values:

INCREASING: the computed value is better if it is high.
DECREASING: the computed value is better if it is low.

category

Sting type.

It contains a string to specify the category of the template.

A category is associated with a specific icon displayed on the GUI. An unknown category is associated with a default icon.

Category	Icon
QUALITY
KPI
PUT
ML Forecast
HARMONIZER
FLOW
QUEUE
SPEED
TRAVEL TIME

computationTypeCode

YES

String type.

It describes how the KPI is calculated according to a specific template.

Two are the possible values:

TRIGGERED: the KPI instance is calculated according to the data coming from the provider.
SCHEDULED: the KPI instance is calculated according to a schedule, independently of any providers.

dynamicAttributes

A list of attributes that are used to fill the query (JSON format).

See → Dynamic attributes associated to KPI Templates.

defaultSchedule

Integer type.

A default value to schedule the KPI computation.

This attribute, expressed in seconds, MUST BE set if:

computationTypeCode=SCHEDULED

Take care of the constraint:

defaultSchedule>= minSchedule

minSchedule

Integer type.

A base value to schedule the KPI computation.

This attribute, expressed in seconds, MUST BE set if:

computationTypeCode=SCHEDULED

Take care of the constraint:

minSchedule<=defaultSchedule

AffectedLinks or AffectedStreets

JSON object.

{
...
    "affectedLinks": [
        {
            "tail": <link_tail>,
            "idno": <link_idno>,
            "order": <link_order>
        }
...
}

The attributes of the object are:

tail:Integer referencing the tail node.

idno: Integer referencing the link (or street) idno.

order: Integer representing the order of the link (or street).

Example:

{
...
    ],
    "affectedLinks":[
        {
            "tail":3119676,
            "idno":3503373,
            "order":1
        },
        {
            "tail":2788659,
            "idno":3503359,
            "order":2
        }
    ]
...
}

AffectedLineRoute or AffectedStops

JSON object.

{
...
    "affectedLines": [
        {
            "idno": <lines_idno>,
            "order": <lines_order>
        }
...
}

The attributes of the object are:

idno: Integer referencing the lines (or stop) idno.

order: Integer representing the order of the line (or stop).

Example:

{
...
    ],
    "affectedLine":[
        {
            "idno":3503111,
            "order":1
        },
        {
            "idno":3503222,
            "order":2
        }
    ]
...
}

For every KPI template, the set of values is established by product.

Important: Some settings can be driven by the network context.

Runs in Delay - Provider: Optima Public Transport

Percentage of Public Transport runs with a delay.

The KPI is calculated to return a percentage number [0-100] corresponding to the total number of runs that have a delay greater than zero with respect to the total running runs.

Attribute	Value
ID	1
Provider ID	optima-put
Entity	LINE_ROUTE
Type	Number
Category	PUT
Minimum	0
Maximum	100
Improving Direction	DECREASING
Unit	%
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	10, 60
Minimum Schedule	60
Default Schedule	Not applicable

Aggregate Delay - Provider: Optima Public Transport

Sum of the delays, measured in minutes, of all active runs referring to the next stops.

The KPI is calculated to return the overall delay of the Public Transport system as a sum of all delays in reaching the next stops of all running runs.

Attribute	Value
ID	2
Provider ID	optima-put
Entity	LINE_ROUTE
Type	Number
Category	PUT
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Average Delay - Provider: Optima Public Transport

Average delay, measured in minutes, referring to the next stops for all the active runs.

The KPI is calculated to return the average delay of the Public Transport system as an average of all delays in reaching the next stops of all running runs.

Attribute	Value
ID	3
Provider ID	optima-put
Entity	LINE_ROUTE
Type	Number
Category	PUT
Minimum	0
Maximum	Not specified.
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Maximum Delay - Provider: Optima Public Transport

Maximum delay, measured in minutes, referring to the next stops for all the active runs.

The KPI is calculated to return the maximum delay of the Public Transport system as the maximum delay in reaching the next stops of all running runs.

Attribute	Value
ID	4
Provider ID	optima-put
Entity	LINE_ROUTE
Type	Number
Category	PUT
Minimum	0
Maximum	Not specified.
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Aggregate Delay on Stop - Provider: Optima Public Transport

Sum of the delays of all the active runs referring either to a specified stop or to all of them.

The KPI is calculated to return the aggregation of all delays for a given stop or for all active runs passing through it.

Attribute	Value
ID	5
Provider ID	optima-put
Entity	STOP
Type	Number
Category	PUT
Minimum	0
Maximum	Not specified.
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Average Delay on Stop - Provider: Optima Public Transport

Average of the delays of all the active runs referring either to a specified stop or to all of them.

The KPI is calculated to return the average of all delays, for a given stop or for all active runs passing through it.

Attribute	Value
ID	6
Provider ID	optima-put
Entity	STOP
Type	Number
Category	PUT
Minimum	0
Maximum	Not specified.
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable.

Maximum Delay on Stop - Provider: Optima Public Transport

Maximum delay of all the active runs referring either to a specified stop or to all of them.

The KPI is calculated to return the maximum delay of all the active runs referring to specified stops.

Attribute	Value
ID	7
Provider ID	optima-put
Entity	STOP
Type	Number
Category	PUT
Minimum	0
Maximum	Not specified.
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Percentage Monitored Runs - Provider: Optima Public Transport

Percentage of monitored vehicles with respect to the total of running ones.

The KPI is calculated to return the share of vehicles which have provided their position in the latest PuT vehicle real-time feed, with respect to the total of vehicles currently circulating (live plus by schedule).

Attribute	Value
ID	8
Provider ID	optima-put
Entity	LINE_ROUTE
Type	Number
Category	PUT
Minimum	0
Maximum	100
Improving Direction	INCREASING
Unit	%
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	0.5, 0.9
Minimum Schedule	60
Default Schedule	Not applicable

Average User Speed - Provider: Short-Term Forecast

Average user speed as simulated by the Short-Term Forecast (STF) engine all over the selected network.

The KPI is calculated by handling the average speed of all users as a weighted average of the simulated speeds, with weights set to the corresponding number of simulated vehicles.

If the number of simulated vehicles is missing in the network selection, the average of the model speeds is automatically set.

The KPI is calculated for the specified forecast horizon and considering only equivalent vehicles.

Attribute	Value
ID	9
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	SPEED
Minimum	0
Maximum	130
Improving Direction	INCREASING
Unit	Km/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 100
Minimum Schedule	60
Default Schedule	Not applicable

Average Network Speed - Provider: Short-Term Forecast

Average speed on the network as simulated by the Short-Term Forecast (STF) engine all over the selected network.

The KPI is calculated by handling the average speed of all links as a weighted average of the simulated speeds, which are computed as a ratio between the travel times spent by users to travel the links and the link lengths, with weights set to the amount of simulated flow on the links.

If the number of simulated vehicles is 0 in the network selection, the weighted average of the link speeds (freeflow, possibly modified by events) is automatically set, with weights set to the link length.

The KPI is calculated for the specified forecast horizon and considering only equivalent vehicles.

Attribute	Value
ID	10
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	SPEED
Minimum	0
Maximum	130
Improving Direction	INCREASING
Unit	Km/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 100
Minimum Schedule	60
Default Schedule	Not applicable

Number of Vehicles on the Network - Provider: Short-Term Forecast

Number of vehicles in the network.

Attribute	Value
ID	11
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	Flow
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Veh
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Network Vehicle Output - Provider: Short-Term Forecast

Network vehicle output, measured as the average flow (veh/h) which leaves the network during the interval.

The KPI is calculated as the average flow (veh/h) which leaves the network and enters any of the destination connectors during the interval.

Attribute	Value
ID	12
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	INCREASING
Unit	Veh
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Network Vehicle Input - Provider: Short-Term Forecast

Network vehicle input, measured as the average flow (veh/h) which enters the network during the interval.

The KPI is calculated as the average flow (veh/h) which enters the network and leaves any of the origin connectors during the interval.

Attribute	Value
ID	13
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	INCREASING
Unit	Veh
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Total Travel Time - Provider: Short-Term Forecast

Total travel time, measured in hours, calculated as cumulative travel time on any set of streets.

The KPI is calculated by taking, for each single street, the product between:

The number of vehicles (input flow on the street).
The travel time of the vehicles in the interval of results for the selected forecast distance.

Attribute	Value
ID	14
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	TRAVEL TIME
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Veh - h/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Production - Provider: Short-Term Forecast

Vehicle production for the selected set of links. It is computed as the entry flow on the specified links during the selected interval multiplied by the link lengths.

Attribute	Value
ID	15
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Hourly flow * link length
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Harmonizer: Average Speed Detections - Provider: Optima Harmonizer

Average speed detections, measured in Km/h.

The KPI is calculated considering, for the selected streets, the average of the harmonized speeds in the specified interval.

The harmonized values of speed considered are the values with the starting instant of validity falling within the interval.

Attribute	Value
ID	16
Provider ID	optima-harmonizer
Entity	STREET
Type	Number
Category	SPEED
Minimum	0
Maximum	130
Improving Direction	INCREASING
Unit	Km/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 100
Minimum Schedule	60
Default Schedule	Not applicable

Harmonizer: Average Flow Detections - Provider: Optima Harmonizer

Average flow detections, measured in Veh/h.

The KPI is calculated by considering, for the selected streets, the average of the harmonized flows in the specified interval.

The harmonized values of flow considered are the values with the starting instant of validity falling within the interval.

Attribute	Value
ID	17
Provider ID	optima-harmonizer
Entity	STREET
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	INCREASING
Unit	Veh/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Harmonizer: Count Speed Detections - Provider: Optima Harmonizer

Number of active speed detections.

The KPI is calculated considering, for the selected streets, the number of the harmonized measurements in the specified interval.

For example, considering that the Harmonizer is running every 5 minutes, if the interval is set to 15 minutes, for every street you can count up to 3 harmonized measures.

The harmonized values of speed considered are the values with the starting instant of validity falling into the interval.

Attribute	Value
ID	18
Provider ID	optima-harmonizer
Entity	STREET
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	INCREASING
Unit	Adimensional
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Harmonizer: Count Flow Detections - Provider: Optima Harmonizer

Number of active flow detections.

The KPI is calculated by considering, for the selected streets, the number of the harmonized measurements in the specified interval.

For example, considering that the Harmonizer is run every 5 minutes, if the interval is set to 15 minutes, you can count up to 3 harmonized measurements for every street .

The harmonized values of flow considered are the values with the starting instant of validity falling within the interval.

Attribute	Value
ID	19
Provider ID	optima-harmonizer
Entity	STREET
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	INCREASING
Unit	Adimensional
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Model Forecast Quality from Base (Flow) - Provider: Short-Term Forecast

Attribute	Value
ID	20
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	QUALITY
Minimum	0
Maximum	10
Improving Direction	DECREASING
Unit	SQRT(veh/h)
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	5, 10
Minimum Schedule	60
Default Schedule	Not applicable

Model Forecast Quality (Flow) - Provider: Short-Term Forecast

It is an indicator of how accurate the forecast made for the current flow in the past at varying forecast distances is.

The KPI is calculated as the GEH between the harmonized traffic measurements (flow) of the flow at the current moment and past forecasts.

Attribute	Value
ID	21
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	QUALITY
Minimum	0
Maximum	10
Improving Direction	DECREASING
Unit	SQRT(veh/h)
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	5, 10
Minimum Schedule	60
Default Schedule	Not applicable

Machine Learning Forecast Quality (Flow) - Provider: Optima Machine Learning Forecast Quality

Quality indicator of the Machine Learning forecast vs the measured flow.

Attribute	Value
ID	23
Provider ID	machine- learning-forecast-geh
Entity	STREET
Type	Number
Category	QUALITY
Minimum	0
Maximum	10
Improving Direction	DECREASING
Unit	SQRT(veh/h)
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	5, 10
Minimum Schedule	60
Default Schedule	Not applicable

Average User Speed - Provider: Optima Planning

Average user speed as simulated by the Optima Planning engine all over the selected network.

The KPI is calculated by handling the average speed of all users as a weighted average of the simulated speeds, with weights set to the corresponding number of simulated vehicles.

If the number of simulated vehicles is missing in the network selection, the average of the model speeds is automatically set.

Attribute	Value
ID	24
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	SPEED
Minimum	0
Maximum	130
Improving Direction	INCREASING
Unit	Km/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 100
Minimum Schedule	60
Default Schedule	Not applicable

Average Network Speed - Provider: Optima Planning

Average speed on the network as simulated by the Optima Planning engine all over the selected network.

The KPI is calculated by handling the average speed of all links as a weighted average of the simulated speeds, which is computed as a ratio between the travel times spent by users to travel the links and the link lengths, with weights set to the amount of the simulated flow on the links.

If the number of simulated vehicles is 0 in the network selection, it is set to the weighted average of the link speeds (freeflow, possibly modified by events), with weights set to the link length.

Attribute	Value
ID	25
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	SPEED
Minimum	0
Maximum	130
Improving Direction	INCREASING
Unit	Km/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 100
Minimum Schedule	60
Default Schedule	Not applicable

Number of Vehicles on the Network - Provider: Optima Planning

Number of vehicles in the network, measured as the simulated average number of vehicles on all the links of the network.

The KPI is calculated as the simulated average number of vehicles of all the links of the network. This equals to taking a snapshot of the network during an instant of the reference interval and to counting the number of vehicles in the snapshot; the average number comes from averaging the numbers for every instant within the interval.

Attribute	Value
ID	26
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	QUEUE
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Veh
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Network Vehicle Output - Provider: Optima Planning

Network vehicle output, measured as the average flow (veh/h) which leaves the network during the interval.

The KPI is calculated as the average flow (veh/h) which leaves the network and enters any of the destination connectors during the interval.

Attribute	Value
ID	27
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	INCREASING
Unit	Veh
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Network Vehicle Input - Provider: Optima Planning

Network vehicle input, measured as the average flow (veh/h) which enters the network during the interval.

The KPI is calculated as the average flow (veh/h) which enters the network and leaves any of the origin connectors during the interval.

Attribute	Value
ID	28
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	INCREASING
Unit	Veh
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	Not applicable
Minimum Schedule	60
Default Schedule	Not applicable

Total Travel Time - Provider: Optima Planning

Total travel time, measured in hours, calculated as cumulative travel time on any set of links.

The KPI is calculated by taking, for each link, the product between:

The number of vehicles (input flow on the link).
The travel time spent by the vehicles.

Attribute	Value
ID	29
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	TRAVEL TIME
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Veh/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25,75
Minimum Schedule	60
Default Schedule	Not applicable

Production - Provider: Optima Planning

Vehicle production for the selected set of links. It is computed as the entry flow on the specified links during the selected interval multiplied by the link lengths.

Attribute	Value
ID	30
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	FLOW
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Hourly flow * link length
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25,75
Minimum Schedule	60
Default Schedule	Not applicable

PTV Optima Micro: Travel Times - Provider: Optima Micro

Travel time, measured in minutes, associated with a path or area.

The KPI is calculated along a path or summed up from all the links of an area according to Optima Micro results.

It is only applicable within an Optima Micro subnetwork.

Attribute	Value
ID	31
Provider ID	optima-micro
Entity	LINK
Type	Number
Category	MICRO
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25,75
Minimum Schedule	300 seconds
Default Schedule	Not applicable

PTV Optima Micro: Total Vehicle Times - Provider: Optima Micro

Total vehicle time, measured in hours, spent on a path or area.

The KPI is calculated considering the total time spent by all vehicles along a path or on all links of an area, according to Optima Micro results.

It is only applicable within an Optima Micro subnetwork.

Attribute	Value
ID	32
Provider ID	optima-micro
Entity	LINK
Type	Number
Category	MICRO
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25,75
Minimum Schedule	300 seconds
Default Schedule	Not applicable

Path Travel Time - Provider: Short-Term Forecast

Average travel time, measured in minutes, spent by vehicles on the selected path of the network.

The KPI is calculated as the sum of the travel times of every link along the path, as estimated by PTV Optima.

If the space-time trajectory of the vehicle along the path falls inside a result time interval, the used travel time is interpolated between the instantaneous travel times computed at the start and end times of the simulation intervals.

Attribute	Value
ID	33
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	TRAVEL TIME
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

Path Travel Time - Provider: Optima Planning

Average travel time, measured in minutes, spent by vehicles on the selected path of the network.

The KPI is calculated as the sum of the travel times of every link along the path, as estimated by PTV Optima.

Attribute	Value
ID	34
Provider ID	optima-planning
Entity	LINK
Type	Number
Category	TRAVEL TIME
Minimum	0
Maximum	Not specified
Improving Direction	DECREASING
Unit	Minutes
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	25, 75
Minimum Schedule	60
Default Schedule	Not applicable

ML Forecast: Congestion Index - Provider: Machine Learning Forecast

The Congestion index is a percentage.

It can vary from 0 to infinity. The lower the index, the better.

Index=0 means that the network speed coincides on every street with its free flow speed.

The KPI is calculated considering the % of additional time for traveling through the network streets.

Attribute	Value
ID	35
Provider ID	machine-learning-forecast
Entity	STREET
Type	Number
Category	ML Forecast
Minimum	0
Maximum	300
Improving Direction	DECREASING
Unit	%
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 200
Minimum Schedule	60
Default Schedule	Not applicable

ML Forecast: Traffic Jam - Provider: Machine Learning Forecast

Total length of queues, measured in [Km].

The KPI is calculated as the total length of streets whose average speed is lower than 50% of their free flow speed.

Attribute	Value
ID	36
Provider ID	machine-learning-forecast
Entity	STREET
Type	Number
Category	ML Forecast
Minimum	0
Maximum	500
Improving Direction	DECREASING
Unit	Km
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 200
Minimum Schedule	60
Default Schedule	Not applicable

ML Forecast: Network Congestion Share - Provider: Machine Learning Forecast

Network congestion share is a percentage.

It can vary from 0 to 100%. The lower the index, the better.

Index=0 means that the network speed coincides on every street with its free flow speed.

The KPI is calculated as the % of streets whose average speed is lower than 50% of their free flow speed.

Attribute	Value
ID	37
Provider ID	machine-learning-forecast
Entity	STREET
Type	Number
Category	ML Forecast
Minimum	0
Maximum	300
Improving Direction	DECREASING
Unit	%
Editable	true
Durable Point	false
Point Duration	300
Enabled	true
Quality Threshold	50, 200
Minimum Schedule	60
Default Schedule	Not applicable

Harmonizer: Congestion Index - Provider: Optima Harmonizer

Congestion index is a percentage.

It can vary from 0 to infinity. The lower the index, the better.

Index=0 means that the network speed coincides on every street with its free flow speed.

The KPI is calculated considering the % of additional time for traveling through the network streets.

Attribute	Value
ID	38
Provider ID	optima-harmonizer
Entity	STREET
Type	Number
Category	HARMONIZER
Minimum	0
Maximum	300
Improving Direction	DECREASING
Unit	%
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 200
Minimum Schedule	300
Default Schedule	TRIGGERED

Harmonizer: Traffic Jam - Provider: Optima Harmonizer

Total length of queues, measured in [Km].

The KPI is calculated as the total length of streets whose average speed is lower than 50% of their free flow speed.

Attribute	Value
ID	39
Provider ID	optima-harmonizer
Entity	STREET
Type	Number
Category	HARMONIZER
Minimum	0
Maximum	500
Improving Direction	DECREASING
Unit	Km
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 200
Minimum Schedule	60
Default Schedule	Not applicable

Harmonizer: Network Congestion Share - Provider: Optima Harmonizer

The network congestion share is a percentage.

It can vary from 0 to 100%. The lower the index, the better.

Index=0 means that the network speed coincides on every street with its free flow speed.

The KPI is calculated as the % of streets whose average speed is lower than 50% of their free flow speed.

Attribute	Value
ID	40
Provider ID	optima-harmonizer
Entity	STREET
Type	Number
Category	HARMONIZER
Minimum	0
Maximum	300
Improving Direction	DECREASING
Unit	Km
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 200
Minimum Schedule	60
Default Schedule	Not applicable

Percentage of Links below Error Threshold (Flow) - Provider: Short-Term Forecast

Percentage of links for which the Model Forecast Quality (Flow) is below the threshold specified in the template's attributes.

Attribute	Value
ID	41
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	KPI
Minimum	0
Maximum	100
Improving Direction	INCREASING
Unit	%
Editable	true
Durable Point	true
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 80
Minimum Schedule	300
Default Schedule	Not applicable

Model Forecast Quality from Base (Speed) - Provider: Short-Term Forecast

It is an indicator of how close the measurement of the current speed is to the average estimate made for the current day-type.

The KPI is calculated as the relative error between the harmonized traffic measurements (speed) of the current speed and the estimate for the offline simulation of the current day-type.

Attribute	Value
ID	42
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	QUALITY
Minimum	0
Maximum	1
Improving Direction	DECREASING
Unit	Adimensional
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	0.2, 0.4
Minimum Schedule	60
Default Schedule	Not applicable

Model Forecast Quality (Speed) - Provider: Short-Term Forecast

It is an indicator of how accurate the forecast made for the current speed in the past at varying forecast distances is.

The KPI is calculated as the relative error between the harmonized traffic measurements (speed) of speeds at the current moment and past forecasts.

Attribute	Value
ID	43
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	QUALITY
Minimum	0
Maximum	1
Improving Direction	DECREASING
Unit	Adimensional
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	0.2, 0.4
Minimum Schedule	60
Default Schedule	Not applicable

Machine Learning Forecast Quality (Speed) - Provider: Optima Machine Learning Forecast Quality

Quality indicator of the Machine Learning forecast vs the measured speed.

Attribute	Value
ID	44
Provider ID	machine-learning-forecast-quality
Entity	STREET
Type	Number
Category	QUALITY
Minimum	0
Maximum	1
Improving Direction	DECREASING
Unit	Adimensional
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	0.2, 0.4
Minimum Schedule	60
Default Schedule	Not applicable

Percentage of Links below Error Threshold (Speed) - Provider: Short-Term Forecast

Percentage of links for which the Model Forecast Quality (Speed) is below the threshold specified in the template's attributes.

Attribute	Value
ID	45
Provider ID	Short-Term Forecast
Entity	LINK
Type	Number
Category	KPI
Minimum	0
Maximum	100
Improving Direction	INCREASING
Unit	%
Editable	true
Durable Point	true
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 80
Minimum Schedule	300
Default Schedule	Not applicable

ML Forecast: Percentage of Streets below Error Threshold (Speed) - Provider: Optima Machine Learning Forecast

The percentage of streets below the error threshold, measured as the relative error of the forecast speed (at the given forecast distance) versus the measured speed.

Attribute	Value
ID	46
Provider ID	machine-learning-forecast
Entity	STREET
Type	Number
Category	KPI
Minimum	0
Maximum	100
Improving Direction	INCREASING
Unit	%
Editable	true
Durable Point	true
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 80
Minimum Schedule	300 seconds
Default Schedule	300 seconds

ML Forecast: Percentage of Streets below Error Threshold (Flow) - Provider: Optima Machine Learning Forecast

The percentage of streets below the error threshold, measured as the GEH of the forecast flow (at the given forecast distance) versus the measured flow.

Attribute	Value
ID	47
Provider ID	machine-learning-forecast
Entity	STREET
Type	Number
Category	KPI
Minimum	0
Maximum	100
Improving Direction	INCREASING
Unit	%
Editable	true
Durable Point	true
Point Duration	300 seconds
Enabled	true
Quality Threshold	50, 80
Minimum Schedule	300 seconds
Default Schedule	300 seconds

Total Emissions - Provider: None

Amount of total emissions over the selected network, calculated every hour (g/km/h). The KPI is calculated through the sum of a selected pollutant over time interval and the length of every affected street.

The pollutant type can be selected from the list:

Particulate matter (10μm)
Particulate matter (2.5μm)
Nitrogen dioxide (no2)
Ozone (o3)
Sulfur dioxide (so2)
Carbon monoxide (co)

Attribute	Value
ID	48
Provider ID	None
Entity	STREET
Type	Number
Category	EMISSIONS
Minimum	0
Maximum	N.A.
Improving Direction	DECREASING
Unit	g/km/h
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	N.A.
Minimum Schedule	60 seconds
Default Schedule	300 seconds

PTV Optima Micro:Total Emissions - Provider: Optima Micro

Amount of total emissions over the selected network (g). The KPI is calculated through the sum of a selected pollutant over the affected links and the time of the Optima Micro simulation.

The pollutant type can be selected from the list:

Carbone dioxide (co2)
Carbon monoxide (co)
Nitrogen monoxide (nox)
Particulates
Fuel consumption

Attribute	Value
ID	49
Provider ID	Optima Micro
Entity	LINK
Type	Number
Category	Micro
Minimum	0
Maximum	N.A.
Improving Direction	DECREASING
Unit	g
Editable	true
Durable Point	false
Point Duration	300 seconds
Enabled	true
Quality Threshold	N.A.
Minimum Schedule	60 seconds
Default Schedule	300 seconds