Skip to content

Measure Vehicle Speed

Measures the speed of vehicles in a video stream and alerts you if they exceed a configurable speed limit.

The query detects vehicles and calculates their speed by measuring the time it takes for them to travel a specified distance between two lines drawn on the video frame. The real-world distance between these lines must be set manually.

Real-world distance

The real-world distance between the two lines is used to calculate the speed of vehicles. This distance must be set manually and should be based on the actual distance between the two lines.

Prerequisites

Setup

  1. Select a video from your workspace Click Set up New Query.

  2. Select Measure Vehicle Speed from the list of query types.

1. Query Name

Give your query a name to better identify it. A description can also be added (optional).

2. Crossing Line 1

Videos

The thumbnail image of the previously chosen video is displayed here.

Time interval

Time interval

Select a time frame for the analytics to run, depending on the type of video selected:

  • Earliest: Run the query from the time shown (set during video registration as the beginning timestamp of the video).
  • Latest: Run the query until the time shown (set during video registration as the end timestamp of the video).
  • Given Date: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Live: Analysis is run live, continously.
  • Interval: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Set interval to: Choose from the presets below to run the query on a given time inmterval.

Object types

Select one or multiple object types you want to search for - Bus, Car and Truck are selected by default. Select a category, then click the dropdown menu to see the list of available object types for the selected object category.

Object types

  • Minimum confidence: The minimum confidence level required for an object to be detected. The higher the confidence level, the more certain the system is that the object is of the selected type. The confidence level ranges from 0 to 1, with 1 being the highest confidence level.

Add attribute (optional)

Object attributes

Some object types may have additional attributes available for filtering, such as helmet and gender for Person objects. You can select any number of them to further filter your results; For instance, adding the nohelmet attribute to Person objects will filter detections so that only people not wearing helmets will show up in the Query results.

  1. Click the +Attribute button.
  2. Select an attribute from the list.
  3. Tick the checkbox of the respective attribute to toggle filtering - i.e. whether to look for people with helmets or without them.
  4. You can keep adding additional attributes if the object type allows them. Click the X button to remove an attribute.
  • Attribute aggregation type:
    • Logical AND: The query will return results that match all selected attributes.
    • Logical OR: The query will return results that match any of the selected attributes.

Line cross filter

Draw the first line on the video frame for distance calculation.

Left-click on the camera thumbnail to begin drawing the line; left-click again to finish drawing. Select from the options below the canvas to select the facing direction.

  • More cross one firing (in milliseconds, 1000 by default): The minimum time between two objects crossing the line to trigger an alert.

  • Use bottom reference point: Choose either the center or the bottom of the bounding box as a reference point to determine whether the object is within the ROI.

  • Maximum number of parallel tracks at the same time (50 by default): The maximum number of tracks that can be processed simultaneously. Increasing this number may improve the accuracy of the results but also the processing time.

  • Aggregation interval length (in milliseconds, 5000 by default): The time interval for aggregating the results.

3. Crossing Line 2

Videos

The thumbnail image of the previously chosen video is displayed here.

Time interval

Time interval

Select a time frame for the analytics to run, depending on the type of video selected:

  • Earliest: Run the query from the time shown (set during video registration as the beginning timestamp of the video).
  • Latest: Run the query until the time shown (set during video registration as the end timestamp of the video).
  • Given Date: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Live: Analysis is run live, continously.
  • Interval: You can select a custom start and end date and time to run the query on. Type the desired date and time or select them by clicking the calendar icon.
  • Set interval to: Choose from the presets below to run the query on a given time inmterval.

Object types

Select one or multiple object types you want to search for - Bus, Car and Truck are selected by default. Select a category, then click the dropdown menu to see the list of available object types for the selected object category.

Object types

  • Minimum confidence: The minimum confidence level required for an object to be detected. The higher the confidence level, the more certain the system is that the object is of the selected type. The confidence level ranges from 0 to 1, with 1 being the highest confidence level.

Add attribute (optional)

Object attributes

Some object types may have additional attributes available for filtering, such as helmet and gender for Person objects. You can select any number of them to further filter your results; For instance, adding the nohelmet attribute to Person objects will filter detections so that only people not wearing helmets will show up in the Query results.

  1. Click the +Attribute button.
  2. Select an attribute from the list.
  3. Tick the checkbox of the respective attribute to toggle filtering - i.e. whether to look for people with helmets or without them.
  4. You can keep adding additional attributes if the object type allows them. Click the X button to remove an attribute.
  • Attribute aggregation type:
    • Logical AND: The query will return results that match all selected attributes.
    • Logical OR: The query will return results that match any of the selected attributes.

Line cross filter

Draw the second line on the video frame for distance calculation.

Left-click on the camera thumbnail to begin drawing the line; left-click again to finish drawing. Select from the options below the canvas to select the facing direction.

  • More cross one firing (in milliseconds, 1000 by default): The minimum time between two objects crossing the line to trigger an alert.

  • Use bottom reference point: Choose either the center or the bottom of the bounding box as a reference point to determine whether the object is within the ROI.

  • Maximum number of parallel tracks at the same time (50 by default): The maximum number of tracks that can be processed simultaneously. Increasing this number may improve the accuracy of the results but also the processing time.

  • Aggregation interval length (in milliseconds, 5000 by default): The time interval for aggregating the results.

Results

All done - Clicking Save & Run will immediately start the analysis and opens the Result screen of this query. Alternatively, clicking Save & Exit saves the query without running it.