intel/scenescape-cluster-analytics

Scenescape集群分析服务

Scenescape集群分析服务结合DBSCAN（基于密度的空间聚类应用带噪声）算法、几何形状检测和速度模式分类，为Scenescape提供高级目标聚类和运动分析能力。

概述

该服务处理来自Scenescape场景的实时目标检测数据，应用基于机器学习的聚类算法，提供以下核心分析能力：

• 空间聚类：使用可配置参数的DBSCAN算法按空间 proximity 分组目标
• 集群跟踪：通过贪心最近质心匹配，用持久UUID跨帧跟踪集群
• 形状分析：检测圆形、矩形、直线等几何模式并测量尺寸
• 速度分析：分类运动模式并跟踪集群动态变化

核心功能

1. 实时数据处理：对接Scenescape场景的实时目标检测流
2. 灵活参数配置：支持自定义DBSCAN算法的epsilon（邻域半径）、min_samples（最小样本数）等参数
3. 多维度分析：覆盖空间聚类、形状识别、速度模式分类等场景
4. 持久化跟踪：为每个集群分配唯一UUID，实现跨帧连续跟踪

使用场景

• 智能监控：分析监控场景中目标集群的运动模式，识别异常行为
• 交通流量：对道路车辆集群进行聚类，统计流量趋势和运动特征
• 工业监控：跟踪生产环境中设备或人员集群，优化流程或保障安全

配置说明

1. 参数调整：通过环境变量或配置文件设置DBSCAN算法参数（如epsilon、min_samples）
2. 部署指引：
   • 源码构建：参考https://github.com/open-edge-platform/scenescape/blob/main/docs/user-guide/microservices/cluster-analytics/get-started/build-from-source.md
   • 快速启动：遵循https://github.com/open-edge-platform/scenescape/blob/main/docs/user-guide/microservices/cluster-analytics/get-started.md

文档与社区

• 官方文档：
  • https://github.com/open-edge-platform/scenescape/blob/main/docs/user-guide/microservices/cluster-analytics/cluster-analytics.md
  • https://github.com/open-edge-platform/scenescape/blob/main/docs/user-guide/microservices/cluster-analytics/get-started.md
• 问题反馈：通过https://github.com/open-edge-platform/scenescape/issues提交bug、文档问题或功能请求
• 贡献指南：参考https://github.com/open-edge-platform/scenescape/blob/main/CONTRIBUTING.md参与项目贡献

许可证与声明

• 许可证：Scenescape仓库采用https://www.apache.org/licenses/LICENSE-2.0
• 第三方组件：包含的第三方组件源码可通过DockerHub镜像https://hub.docker.com/r/intel/scenescape-sources/tags获取，详情见镜像内的third-party-programs.txt文件
• 免责声明：该镜像仅用于演示，不适合生产环境。若需Ubuntu基础层的扩展安全维护，可参考https://documentation.ubuntu.com/pro-client/en/docs/howtoguides/enable_in_dockerfile/重建镜像。使用FFmpeg或GStreamer时，需自行确认许可要求，Intel不承担相关责任。