intel/scenescape-cluster-analytics repository overview

⁠Scenescape's Cluster Analytics Service

The Cluster Analytics service provides advanced object clustering and movement analysis capabilities for Scenescape using DBSCAN (Density-Based Spatial Clustering of Applications with Noise) algorithm combined with geometric shape detection and velocity pattern classification.

⁠Overview

This service processes real-time object detection data from Scenescape scenes, applies machine learning-based clustering algorithms, and provides comprehensive analytics including:

• Spatial Clustering: Groups objects by proximity using DBSCAN algorithm with user-configurable parameters
• Cluster Tracking: Tracks clusters across frames with persistent UUIDs via greedy nearest-centroid matching
• Shape Analysis: Detects geometric patterns (circle, rectangle, line, irregular) with size measurements
• Velocity Analysis: Classifies movement patterns and tracks cluster dynamics

⁠Documentation

• Overview

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

• Getting Started

  • Get Started⁠: Step-by-step guide to getting started with the microservice.

• Deployment

  • How to Build from Source⁠: Step-by-step guide to building from source.

⁠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.