Events

What is an event?

Every message sent by a device to AI-Dash PRO is an event.

The events can be:

• Non Periodic: Events sent by a device when a sensor detect a situation of interest. E.g. people counting sensors detect a person walking under the door. (A.k.a Triggered events)

  • Threshold based: Non periodic events sent when a threshold is breached.
• Periodic: Events sent by a device without the detection of a situation of interest. E.g. occupancy sensors generate periodic events to communicate the current occupancy of the area under analysis.

AI-Dash PRO is able to receive all type the events sent by all the plugins delivered by A.I.Tech.

Event types

As discussed in the Basic Concept, each plugin allows you to configure virtual sensors of different types (e.g. crossing line, sterile zone, ). Each type of virtual sensors can produce events of different types.

Current plugins

Plugins	Type of event
AI-Retail	Counting, Aggregate, Crowd, Overcrowd, Heatmap, Background, Occupancy, Overoccupancy
AI-Retail3	Counting, Aggregate, Crowd, Overcrowd
AI-People	Counting, Aggregate
AI-Crowd	Crowd
AI-Overcrowd	Overcrowd
AI-Heat	Heatmap, Background
AI-Occupancy	Occupancy
AI-Overoccupancy	Overoccupancy
AI-Biodeep	Bio, Digital_Signage
AI-FaceDetect	Face
AI-Security	Sterile_Zone, Crossing_Line, Intrusion_Pro, Loitering, Lost, Fire, Smoke
AI-Security3	Sterile_Zone, Crossing_Line, Intrusion_Pro, Loitering, Lost
AI-Intrusion	Sterile_Zone, Crossing_Line
AI-IntrusionPRO	Sterile_Zone, Crossing_Line, Intrusion_Pro
AI-Loitering	Loitering
AI-Lost	Lost
AI-Fire	Fire
AI-Smoke	Smoke
AI-Traffic	Road, Traffic_Density, High_Speed, Wrong_Way, Congestion, Pedestrian, Stopped_Vehicle
AI-Road3D	Road, Traffic_Density, High_Speed
AI-Incident	Wrong_Way, Congestion, Pedestrian, Stopped_Vehicle
AI-Parking	Parking_Lot, Parking_Spot_Change, Parking_Spot_Occupancy
AI-Spill	Spill
AI-Panic	Panic
AI-ATM	Loitering, Overcrowd

Plugins deprecated

Plugins	Type of event
AI-Bio	Bio
AI-Biolight	Bio
AI-Road	Road

Event and Images

Except for Heatmap events, all the periodic events do not sent images.

Type of event	Image	Periodic
Counting	Optional
Aggregate	Optional
Crowd	None	✓
Overcrowd	Optional
Heatmap	Mandatory	✓
Background	Mandatory	✓
Occupancy	None	✓
Overoccupancy	Optional
Bio	Optional
Digital_Signage	None
Face	Optional
Sterile_Zone	Optional
Crossing_Line	Optional
Intrusion_Pro	Optional
Loitering	Optional
Lost	Optional
Fire	Optional
Smoke	Optional
Road	Optional
Traffic_Density	None	✓
High_Speed	Optional
Wrong_Way	Optional
Congestion	Optional
Pedestrian	Optional
Stopped_Vehicle	Optional
Parking_Lot	Optional	✓
Parking_Spot_Change	Optional
Parking_Spot_Occupancy	None	✓
Spill	Optional
Panic	Optional

Test Events

All the plugins delivered by A.I. Tech allow to send Test Events that can be used to check if a device is able to communicate with AI-Dash PRO.

Go to the Getting Started tutorial to learn how to use Test Events.

If the Test Event is not received by AI-Dash PRO read Where is my device?

Still_Alive events

All A.I. Tech plugins, every 60 seconds, send Still_Alive events to AI-Dash PRO to inform it that they are active.

Events Representation

A event is trasmitted from the Plugin to AI-Dash PRO as a JSON string. An example is:

{"event_id": 1, "event_type": "Aggregate", "timestamp": "1445943225" , "id_source": "AIPeopleCamera", "sensor_id":1, "sensor_name": "Ingresso", "mac_address": "000c297785aa", "message": "Aggregate", "description": "Aggregate"}

Generic Metadata

Test

{"mac_address": "000c297785aa", "event_id": 1111, "message": "Test", "id_source": "191.1", "event_type": "Test", "timestamp": "1508399997", "description": "Test", "sensor_id": 1, "sensor_name": "Test", "dash_id": "default"}

Counting

The event is dispatched whenever at least one person passes through the counting sensor.

Example:

{"event_id": 1, "event_type": "Counting", "timestamp": "1445943225" , "id_source": "AIPeopleCamera", "sensor_id":1, "sensor_name": "Ingresso", "message": "Counting", "description": "Counting", "people_number": 1, "num_stripes": 5, "active_stripes":[0,1,1,1,0], "actual_count":54, "line":{"x1":0.1, "y1":0.3, "x2":0.3, "y2":0.5}}

---

Aggregate (Threshold based)

Similar to Counting but generated when a counting threshold is exceeded on the plugin (see the AI-People manual).

Example:

{"event_id": 1, "event_type": "Aggregate", "timestamp": "1445943225" , "id_source": "AIPeopleCamera", "sensor_id":1, "sensor_name": "Ingresso", "message": "Aggregate", "description": "Aggregate", "people_number": 1, "num_stripes": 5, "active_stripes":[0,1,1,1,0], ""actual_count":54, "line":{"x1":0.1, "y1":0.3, "x2":0.3, "y2":0.5}}

---

Crowd (Periodic)

Example:

{"event_id": 1, "event_type": "Crowd", "timestamp": "1445943225" , "id_source": "AICrowdCamera", "sensor_id":1, "sensor_name": "Crowd_Area", "message": "Crowd", "description": "Crowd", "people_number": 2, "period": 1, "points":[{"x":0.0, "y":0.0}, {"x":0.0, "y":1.0}, {"x":1.0, "y":1.0}, {"x":1.0, "y":0.0}]}

---

Overcrowd (Threshold based)

Similar to Crowd but generated when a threshold is exceeded (see the AI-Retail manual).

Example:

{"event_id": 1, "event_type": "Overcrowd", "timestamp": "1445943225" , "id_source": "AIOvercrowdCamera", "sensor_id":1, "sensor_name": "Overcrowd_Area", "message": "Overcrowd", "description": "Overcrowd", "people_number": 25, "points":[{"x":0.0, "y":0.0}, {"x":0.0, "y":1.0}, {"x":1.0, "y":1.0}, {"x":1.0, "y":0.0}]}

---

Heatmap (Periodic)

The event consists of two events with images:

• Heatmap: grayscale image where each pixel represents heat in a range [0 - 255].
• Background: current background image where to apply the heatmap image.

The two events have different periods. Typically, the background image is sent less frequently than the heatmap image.

ATTENTION: Heatmap events cannot be sent without images, therefore if AI-Dash PRO has been configured to not receive images, this event will not be received.

Heatmap

Example:

{"dash_id": "default", "event_id": 0, "id_source": "Device", "event_type": "Heatmap", "sensor_name": "", "timestamp": "1507494256", "axia_event_enum_type": 5, "period": 60, "mac_address": "b827eb17613f"}

Background

Example:

{"dash_id": "default", "event_id": 0, "id_source": "Device", "event_type": "Background", "sensor_name": "", "timestamp": "1507493596", "axia_event_enum_type": 6, "period": 60, "mac_address": "b827eb17613f"}

---

Occupancy (Periodic)

Example:

{"event_id": 1, "event_type": "Occupancy", "timestamp": "1445943225" , "id_source": "AIOccupancyCamera", "sensor_id":1, "sensor_name": "Occupancy_Area", "message": "Occupancy", "description": "Occupancy", "occupancy": 20, "period": 1}

---

Overoccupancy (Threshold based)

Similar to Occupancy but generated upon exceeding a given threshold on the plugin (see the AI-Retail manual).

Example:

{"event_id": 1, "event_type": "Overoccupancy", "timestamp": "1445943225" , "id_source": "AIOveroccupancyCamera", "sensor_id":1, "sensor_name": "Overoccupancy_Area", "message": "Overoccupancy", "description": "Overoccupancy", "occupancy": 20}

---

Bio

Example:

{"event_id": 1, "event_type": "Bio", "timestamp": "1445943225" , "id_source": "AIBioCamera", "sensor_id":1, "sensor_name": "Bio_Area", "message": "Bio", "description": "Bio", "face":{"persistence_time": 25, "gender": "male", "age":"adult", "roi_x":0.1, "roi_y":0.2, "roi_width":0.5, "roi_height":0.5}}

---

Digital_Signage

Example:

{"event_id": 1, "event_type": "Digital_Signage", "timestamp": "1445943225" , "id_source": "AIBioCamera", "sensor_id":1, "sensor_name": "Bio_Area", "message": "Digital_Signage", "description": "Digital_Signage", "gender": "male", "age":"adult"}

---

Face

The event is generated for each face detected by the plugin in the scene.

Example:

{"event_id": 1, "event_type": "Face", "timestamp": "1445943225" , "id_source": "AIFacedetectCamera", "sensor_id":1, "sensor_name": "Face_Area", "message": "Face", "description": "Face", "face":{"roi_x":0.1, "roi_y":0.2, "roi_width":0.5, "roi_height":0.5}}

---

Sterile_Zone

If the sterile zone is configured as a level sensor the possible values for the type are in [START_INTRUSION, CONTINUOUS_INTRUSION, END_INTRUSION], otherwise the only possible value is INTRUSION.

• INTRUSION: indicates that an intrusion has been detected in an impulsive sensor.
• START_INTRUSION: indicates that an intrusion has been just detected in a level sensor.
• CONTINUOUS_INTRUSION: indicates that an intrusion already detected is continuing in a level sensor.
• END_INTRUSION: indicates that an intrusion already detected in a level sensor is finished.

Example:

{"event_id": 1, "event_type": "Sterile_Zone", "timestamp": "1445943225" , "id_source": "AIIntrusionCamera", "sensor_id":1, "sensor_name": "Sterile_Area", "message": "Sterile_Zone", "description": "Sterile_Zone", "sterile_zone_type": "INTRUSION", "points":[{"x":0.0, "y":0.0}, {"x":0.0, "y":1.0}, {"x":1.0, "y":1.0}, {"x":1.0, "y":0.0}], "object": {"top_left_x":0.1, "top_left_y":0.2, "width":0.5, "height":0.5}}

---

Crossing_Line

Example:

{"event_id": 1, "event_type": "Crossing_Line", "timestamp": "1445943225" , "id_source": "AIIntrusionCamera", "sensor_id":1, "sensor_name": "Highway", "message": "Crossing_Line", "description": "Crossing_Line", "line":{"x1":0.1, "y1":0.3, "x2":0.3, "y2":0.5}, "object": {"top_left_x":0.1, "top_left_y":0.2, "width":0.5, "height":0.5}}

---

Intrusion_Pro

Example:

{"event_id": 1, "event_type": "Intrusion_Pro", "timestamp": "1445943225" , "id_source": "AIIntrusion_ProCamera", "sensor_id":1, "sensor_name": "Intrusion_Pro_Area", "message": "Intrusion_Pro", "description": "Intrusion_Pro", "object": {"top_left_x":0.1, "top_left_y":0.2, "width":0.5, "height":0.5}}

---

Loitering

Example:

{"event_id": 1, "event_type": "Loitering", "timestamp": "1445943225" , "id_source": "AILoiteringCamera", "sensor_id":1, "sensor_name": "Loitering_Area", "message": "Loitering", "description": "Loitering", "object": {"top_left_x":0.1, "top_left_y":0.2, "width":0.5, "height":0.5}}

---

Lost

Example:

{"event_id": 1, "event_type": "Lost", "timestamp": "1445943225" , "id_source": "AILostCamera", "sensor_id":1, "sensor_name": "Lost_Area", "message": "Lost", "description": "Lost", "object": {"top_left_x":0.1, "top_left_y":0.2, "width":0.5, "height":0.5}}

---

Fire

Example:

{"event_id": 1, "event_type": "Fire", "timestamp": "1445943225" , "id_source": "AIFireCamera", "sensor_id":1, "sensor_name": "Fire_Area", "message": "Fire", "description": "Fire", "object": {"top_left_x":0.1, "top_left_y":0.2, "width":0.5, "height":0.5}}

---

Smoke

Example:

{"event_id": 1, "event_type": "Smoke", "timestamp": "1445943225" , "id_source": "AISmokeCamera", "sensor_id":1, "sensor_name": "Smoke_Area", "message": "Smoke", "description": "Smoke", "points":[{"x":0.0, "y":0.0}, {"x":0.0, "y":1.0}, {"x":1.0, "y":1.0}, {"x":1.0, "y":0.0}], "object": {"top_left_x":0.1, "top_left_y":0.2, "width":0.5, "height":0.5}}

---

Road

L'evento è inviato per ogni veicolo che attraversa il sensore di analisi del traffico.

Example:

{"gmtoff": 7200, "id_source": "AI-Road3D", "timestamp": "1585575943", "event_type": "Road", "vehicle_model": "unknown", "event_id": 49, "description": "Road", "message": "Road", "average_speed": 34, "sensor_id": 1, "timezone": "CEST", "sensor_name": "S1", "frame_timestamp": 1585575943042684, "time_span_us": 0, "mac_address": "000c29249be4", "vehicle_type": "CAR", "average_color_y": 131, "average_color_u": 122, "average_color_v": 135, "vehicle_make": "unknown", "object_id": 679, "n_times_seen": 2, "object": {"width": 0.20000000000000001, "top_left_y": 0.46388888888888891, "top_left_x": 0.36093750000000002, "height": 0.20555555555555555}}

---

Traffic_Density (Periodic)

The event is sent periodically to collect traffic density information in the traffic analysis sensor.

Example:

{"id_source": "AI-Road3D", "description": "Traffic_Density", "frame_timestamp": 1585574272983927, "sensor_id": 1, "event_type": "Traffic_Density", "timestamp": "1585574272", "event_id": 6, "mac_address": "000c29249be4", "sensor_name": "S1", "message": "Traffic_Density", "occupancy": 0, "gmtoff": 7200, "timezone": "CEST", "period": 60}

---

High_Speed

The event is sent for each vehicle that passes through the traffic analysis sensor with a speed higher than the limit set by the user.

Example:

{"gmtoff": 7200, "id_source": "AI-Road3D", "n_times_seen": 2, "timestamp": "1585577559", "event_type": "High_Speed", "event_id": 151, "description": "High_Speed", "message": "High_Speed", "average_speed": 95, "sensor_id": 1, "timezone": "CEST", "sensor_name": "S1", "frame_timestamp": 1585577558845264, "mac_address": "000c29249be4", "time_span_us": 0, "speed_limit": 30, "object": {"width": 0.46562500000000001, "top_left_y": 0.17499999999999999, "top_left_x": 0.0, "height": 0.45000000000000001}}

---

Wrong_Way

The event is sent for each vehicle that passes through the traffic analysis sensor in the wrong direction.

Example:

{"time_span_us": 1535478, "sensor_name": "S1", "id_source": "AI-Incident", "object": {"top_left_x": 0.4296875, "top_left_y": 0.28611111111111109, "height": 0.24166666666666667, "width": 0.15312500000000001}, "timezone": "CEST", "event_id": 858, "message": "Wrong_Way", "frame_timestamp": 1585583432807257, "event_type": "Wrong_Way", "mac_address": "000c29249be4", "gmtoff": 7200, "timestamp": "1585583432", "description": "Wrong_Way", "sensor_id": 1, "n_times_seen": 48}

---

Congestion

The event is dispatched whenever congestion is detected on the road.

Example:

{"id_source": "AI-Incident", "message": "Congestion", "timezone": "CEST", "frame_timestamp": 1585648596226960, "event_type": "Congestion", "timestamp": "1585648596", "gmtoff": 7200, "event_id": 263, "sensor_id": 1, "sensor_name": "S1", "description": "Congestion", "mac_address": "000c29249be4"}

---

Pedestrian

The event is sent for each pedestrian detected by the plugin in the traffic monitoring sensor.

Example:

{"id_source": "AI-Incident", "message": "Pedestrian", "timezone": "CEST", "frame_timestamp": 1585650121773833, "event_type": "Pedestrian", "timestamp": "1585650121", "gmtoff": 7200, "event_id": 649, "sensor_id": 3, "sensor_name": "S3", "description": "Pedestrian", "mac_address": "000c29249be4", "object": {"top_left_y": 0.65555555555555556, "top_left_x": 0.32187500000000002, "width": 0.053124999999999999, "height": 0.20555555555555555}}

---

Stopped_Vehicle

The event is sent for each stationary vehicle detected by the plugin in the traffic monitoring sensor.

Example:

{"id_source": "AI-Incident", "message": "Stopped_Vehicle", "timezone": "CEST", "frame_timestamp": 1585650130098319, "event_type": "Stopped_Vehicle", "timestamp": "1585650130", "gmtoff": 7200, "event_id": 651, "sensor_id": 3, "sensor_name": "S3", "description": "Stopped_Vehicle", "mac_address": "000c29249be4", "object": {"top_left_y": 0.21666666666666667, "top_left_x": 0.3359375, "width": 0.082812499999999997, "height": 0.11388888888888889}}

---

Parking_Lot

The event is dispatched in two situations:

• periodically, to notify the number of free places and the number of places occupied
• on an event basis, when the parking status changes, notifying the update on the number of free or occupied slot The sensor isn't available for AI-Dash PRO but only for third party systems.

Example:

{"event_id": 1, "event_type": "Parking_Lot", "timestamp": "1445943225" , "id_source": "ParkingDevice", "sensor_id":15000, "sensor_name": "ParkingDevice", "message": "Parking_Lot", "description": "Parking_Lot", "all_spots": 12, "busy_spots":4, "period": 60}

---

Parking_Spot_Change

Event representing the status of a place. The event is sent only when the state of the specific spot changes.

Example:

{"event_id": 1, "event_type": "Parking_Spot_Change", "timestamp": "1445943225" , "id_source": "ParkingDevice", "sensor_id":1, "sensor_name": "S2", "message": "Parking_Spot_Change", "description": "Parking_Spot_Change", "state": "BUSY", "period": 60}

---

Parking_Spot_Occupancy (Periodic)

Event representing the average occupation of a parking spot in a given period of time. The time interval can be configurated during the configuration phase (by default every 5 minutes).

Example:

{"event_id": 1, "event_type": "Parking_Spot_Occupancy", "timestamp": "1445943225" , "id_source": "ParkingDevice", "sensor_id":1, "sensor_name": "S2", "message": "Parking_Spot_Occupancy", "description": "Parking_Spot_Occupancy", "occupancy": 100, "period": 60}

---

Spill

The event is sent for each fall detected in the sensor.

Example:

{"event_type": "Spill", "id_source": "SpillDevice", "timestamp": "1585659574", "event_id": 8, "sensor_id": 1, "description": "Spill", "timezone": "CEST", "sensor_name": "Spill Sensor", "message": "Spill", "frame_timestamp": 1585659574080636, "mac_address": "000c2999ad75", "gmtoff": 7200}

---

Panic

The event is sent for each panic situation detected in the region of interest.

Example:

{"id_source": "PanicDevice", "event_type": "Panic", "sensor_name": "S1", "timestamp": "1585659810", "event_id": 6, "message": "Panic", "mac_address": "000c2999ad75", "description": "Panic", "sensor_id": 1, "frame_timestamp": 1585659810044992, "gmtoff": 7200, "timezone": "CEST"}