Add display

[tigroo]

Changes

• IoT3 SDK:
  • mobility add helpers on quadtree
• examples:
  • display: create the server and the log and the mqtt readers

Close #568

Close #369

Test

How to test

1. Create a log file with 1 CAM + 1 CPM with 1 perceived object (Toulouse area):

mkdir -p /tmp/logs
cat > /tmp/logs/its.log << 'EOF'
{"message_type":"cam","origin":"self","version":"2.4.0","source_uuid":"car_001","timestamp":1784727122140,"message":{"protocol_version":1,"station_id":555,"generation_delta_time":64291,"basic_container":{"station_type":5,"reference_position":{"latitude":436004000,"longitude":14500000,"position_confidence_ellipse":{"semi_major":10,"semi_minor":50,"semi_major_orientation":1},"altitude":{"value":14750,"confidence":1}}},"high_frequency_container":{"basic_vehicle_container_high_frequency":{"heading":{"value":1800,"confidence":2},"speed":{"value":144,"confidence":3},"drive_direction":0,"vehicle_length":{"value":40,"confidence":0},"vehicle_width":20,"longitudinal_acceleration":{"value":10,"confidence":2},"curvature":{"value":11,"confidence":4},"curvature_calculation_mode":0,"yaw_rate":{"value":562,"confidence":2}}}}}
{"type":"cpm","origin":"self","version":"2.2.0","source_uuid":"car_001","timestamp":1784727122141,"message":{"protocol_version":1,"station_id":555,"management_container":{"reference_position":{"latitude":436004000,"longitude":14500000,"position_confidence_ellipse":{"semi_major":10,"semi_minor":50,"semi_major_orientation":1},"altitude":{"value":14750,"confidence":1}}},"perceived_object_container":[{"object_id":1,"position":{"x_coordinate":{"value":500},"y_coordinate":{"value":-200},"confidence":{"position_confidence_ellipse":{"semi_major_confidence":20,"semi_minor_confidence":30,"semi_major_orientation":1}}}}]}}
EOF

2. Execute the 3 display example binaries following the documentation into the README file.

Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.15s
     Running `target/debug/examples/display_log_reader /tmp/logs 26 /tmp/display.db`
INFO [libits::client::logger] Logger ready on stdout
📂 Input directory: /tmp/logs
📊 Zoom level: 26
🗄️  Database: /tmp/display.db

📂 Scanning directory: /tmp/logs
   Found 1 log file(s)
🗄️  Opening database: /tmp/display.db
📖 Parsing at zoom level 26...

  📄 Processing: /tmp/logs/its.log

✅ Parsing complete:
   - Files processed: 1
   - Messages stored: 3
   - Messages skipped (no position): 0
   - Duplicates skipped: 0
   - Errors: 0
   - Database: /tmp/display.db
📊 Database Statistics
   Database: /tmp/display.db
   Total unique quadtiles: 2
   Total messages: 3

📅 Days with data: 1
   2025-03-17 : 3 messages

📨 Message types:
   cam : 1 messages
   cpm : 1 messages
   cpm po : 1 messages

🔝 Top 10 quadkeys (global):
Quadkey                       Count Mean Confidence    Type(s)
----------------------------------------------------------------------
12022203022221313333211031          2             0.0    cam,cpm
12022203022221313333300331          1            25.0     cpm po

Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.12s
     Running `target/debug/examples/display_mqtt_reader --config examples/config.ini`
INFO [libits::client::logger] Logger ready on stdout
INFO [libits::transport::mqtt] Transport: standard MQTT; TLS enabled
🔌 Connecting to MQTT broker: test.mosquitto.org:8886
   Client ID: com_app_its-client-1
   Topics: ["#"]
   Zoom level: 18
   Database: examples/display.db
✅ Subscribed to topics
📡 Listening for messages...
JSON parse error on topic Ahoydtu_Kraftwerk120240107/version: trailing characters at line 1 column 4
...

Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.17s
     Running `target/debug/examples/display_server --config examples/config.ini`
INFO [libits::client::logger] Logger ready on stdout
📊 Database Statistics
   Database: /tmp/display.db
   Total unique quadtiles: 2
   Total messages: 3

📅 Days with data: 1
   2025-03-17 : 3 messages

📨 Message types:
   cam : 1 messages
   cpm : 1 messages
   cpm po : 1 messages

🔝 Top 10 quadkeys (global):
Quadkey                       Count Mean Confidence    Type(s)
----------------------------------------------------------------------
12022203022221313333211031          2             0.0    cam,cpm
12022203022221313333300331          1            25.0     cpm po

🚀 Server running on http://0.0.0.0:3000 (DB: /tmp/display.db)
📍 Open your browser and navigate to the URL above

Select the date (DAY) 2026-07-22. You should see 1 CAM and 1 CPM with 1 PO (3 messages).

3. Publish another CAM + CPM from nearby (slightly different location):

docker run -it --rm eclipse-mosquitto mosquitto_pub -h test.mosquitto.org -p 8886 -t default/outQueue/v2x/cam/car_002/1/2/0/2/2/2/0/3/0/2/2/2/2/1/3/1/3/3/3/3/1/1/3/3/2/2 --tls-version tlsv1.2 --capath /etc/ssl/certs/ -m '{"message_type":"cam","origin":"self","version":"2.4.0","source_uuid":"car_002","timestamp":1784727122142,"message":{"protocol_version":1,"station_id":666,"generation_delta_time":64291,"basic_container":{"station_type":5,"reference_position":{"latitude":436005000,"longitude":14501000,"position_confidence_ellipse":{"semi_major":10,"semi_minor":50,"semi_major_orientation":1},"altitude":{"value":14750,"confidence":1}}},"high_frequency_container":{"basic_vehicle_container_high_frequency":{"heading":{"value":1800,"confidence":2},"speed":{"value":144,"confidence":3},"drive_direction":0,"vehicle_length":{"value":40,"confidence":0},"vehicle_width":20,"longitudinal_acceleration":{"value":10,"confidence":2},"curvature":{"value":11,"confidence":4},"curvature_calculation_mode":0,"yaw_rate":{"value":562,"confidence":2}}}}}'
docker run -it --rm eclipse-mosquitto mosquitto_pub -h test.mosquitto.org -p 8886 -t default/outQueue/v2x/cpm/car_002/1/2/0/2/2/2/0/3/0/2/2/2/2/1/3/1/3/3/3/3/1/1/3/3/2/2 --tls-version tlsv1.2 --capath /etc/ssl/certs/ -m '{"type":"cpm","origin":"self","version":"2.2.0","source_uuid":"car_002","timestamp":1784727122143,"message":{"protocol_version":1,"station_id":666,"management_container":{"reference_position":{"latitude":436005000,"longitude":14501000,"position_confidence_ellipse":{"semi_major":10,"semi_minor":50,"semi_major_orientation":1},"altitude":{"value":14750,"confidence":1}}},"perceived_object_container":[{"object_id":1,"position":{"x_coordinate":{"value":500},"y_coordinate":{"value":-200},"confidence":{"position_confidence_ellipse":{"semi_major_confidence":20,"semi_minor_confidence":30,"semi_major_orientation":1}}}}]}}'

NB: if a huge traffic is on the broker, you may retry to be served.

Refresh the map - you should now see 2 CAMs and 2 CPMs with 1 PO at different locations (6 messages).