intel/scenescape-analytics repository overview

⁠Scenescape's Analytics Service

The Analytics Microservice computes region, tripwire, and sensor analytics for objects tracked in a Scenescape scene, and publishes the resulting detections and events for downstream consumers.

⁠Overview

The Analytics service consumes unregulated tracked-object messages published by the Scene Controller (or any upstream Tracker) on scenescape/data/scene/{scene_id}/{thing_type}, together with raw sensor readings on scenescape/data/sensor/{sensor_id}. It correlates those inputs and publishes:

• Regulated (rate-controlled) detections aggregating all object categories into a single message per scene.
• Region and tripwire events, including enter/exit detection and dwell-time tracking.
• Sensor-correlated object state, tagging tracked objects with readings from environmental and attribute sensors located inside their measurement area.

The Scene Controller itself performs no sensor correlation, regulated output, or region/tripwire event publishing in any mode — that functionality is owned exclusively by this service.

⁠Documentation

• Overview

  • Overview and Architecture⁠: A high-level introduction.

• API Reference

  • API Reference⁠: Comprehensive reference for the request/response and event-based communication endpoints.

⁠Community

To report a bug, file a documentation issue, or submit a feature request, please open a GitHub issue⁠.

⁠Contributing

We welcome contributions! Check out our Contributing Guide⁠ to get started.

⁠Supported versions

• 2026.2.0

⁠License

Scenescape repository is licensed under APACHE 2.0 LICENSE⁠.

⁠Sources and Third Party Notices

This distribution includes components licensed under copyleft licenses. The complete corresponding source code for these components is provided in a separate Sources Docker image available on DockerHub intel/scenescape-sources⁠.

See third-party-programs.txt file in the Scenescape Sources Docker image for details on included components and licenses.

⁠Disclaimers

This container image is intended for demo purposes only and not intended for production use. To receive expanded security maintenance from Canonical on the Ubuntu base layer, you may follow the how-to guide to enable Ubuntu Pro in a Dockerfile⁠ which will require the image to be rebuilt.

Depending on your deployment, Scenescape may utilize FFmpeg and/or GStreamer.

FFmpeg is an open source project licensed under LGPL and GPL. See FFmpeg License and Legal Considerations⁠. You are solely responsible for determining if your use of FFmpeg requires any additional licenses. Intel is not responsible for obtaining any such licenses, nor liable for any licensing fees due, in connection with your use of FFmpeg.

GStreamer is an open source framework licensed under LGPL. See Licensing your applications and plugins for use with GStreamer⁠. You are solely responsible for determining if your use of GStreamer requires any additional licenses. Intel is not responsible for obtaining any such licenses, nor liable for any licensing fees due, in connection with your use of GStreamer.