OpenTrafficCam/OTAnalytics
GitHub: OpenTrafficCam/OTAnalytics
一款用于对道路用户轨迹数据进行交通流分析、事件检测与统计可视化的开源交通分析工具。
Stars: 24 | Forks: 8
# OTAnalytics
[](https://pypi.org/p/OTAnalytics/)
[](https://github.com/OpenTrafficCam/OTAnalytics/actions/workflows/test.yml?query=tag%3Alatest)
[](https://github.com/OpenTrafficCam/OTAnalytics/actions/workflows/build-release.yml)
OTAnalytics 是 [OpenTrafficCam 框架](https://github.com/OpenTrafficCam) 的核心模块，旨在
对由 [OTVision](https://github.com/OpenTrafficCam/OTVision) 或其他工具
在 [OTCamera](https://github.com/OpenTrafficCam/OTCamera) 或其他摄像机系统录制的视频中跟踪到的道路用户轨迹执行
交通分析。
## 概述
OTAnalytics 提供了分析交通数据的工具，包括：
- 处理道路用户的轨迹数据
- 定义和分析交通流
- 统计分配到各交通流的车辆/道路用户
- 生成事件列表和统计数据
- 可视化交通数据
该应用程序提供多种用户界面：
- 图形化桌面界面（使用 CustomTkinter）
- 用于自动化和批处理的命令行界面
## 安装说明
### 前置条件
- Python 3.12
- [requirements.txt](requirements.txt) 中列出的依赖项
### 从 GitHub Releases 安装（推荐）
安装 OTAnalytics 最简单的方法是从
[GitHub Releases 页面](https://github.com/OpenTrafficCam/OTAnalytics/releases)下载最新版本。
1. 前往 [OTAnalytics Releases 页面](https://github.com/OpenTrafficCam/OTAnalytics/releases)
2. 下载适合您操作系统的最新版本
3. 解压下载的压缩包
4. 按照[用法](#usage)部分中的说明运行应用程序
### 从源码安装 (Linux/macOS)
如果您偏好从源码安装：
1. 克隆仓库：
git clone https://github.com/OpenTrafficCam/OTAnalytics.git
cd OTAnalytics
2. 运行安装脚本：
./install.sh
### 从源码安装 (Windows)
如果您偏好从源码安装：
1. 克隆仓库：
git clone https://github.com/OpenTrafficCam/OTAnalytics.git
cd OTAnalytics
2. 运行安装脚本：
install.cmd
## 用法
### 启动应用程序
#### 桌面 GUI（默认）
在 Linux/macOS 上：
```
./start_gui.sh
```
在 Windows 上：
```
start_gui.cmd
```
#### 命令行界面
在 Linux/macOS 上：
```
./start_gui.sh --cli
```
在 Windows 上：
```
start_gui.cmd --cli
```
### 配置
OTAnalytics 可以通过以下方式进行配置：
1. 命令行参数
2. 配置文件（YAML 格式）
配置选项示例：
- 指定要分析的轨迹文件
- 使用 otflow 文件定义交通流和路段配置
- 配置导出格式和统计时间间隔
- 通过多进程控制并行化
- 包含或排除特定的道路用户类别
## 功能
- **轨迹分析**：处理和分析来自各种数据源的轨迹数据
- **交通流定义**：定义和分析路段之间的交通流
- **统计**：按可配置的时间间隔统计分配到各交通流的道路用户
- **事件检测**：当道路用户穿过指定路段时生成事件列表
- **可视化**：可视化轨迹、交通流和路段
- **导出**：以各种格式导出分析结果
- **过滤**：按道路用户类别和时间过滤轨迹
- **并行化**：使用多个 CPU 核心处理数据
## 文档
有关如何安装和使用 OTAnalytics 的详细说明，请参阅
[官方文档](https://opentrafficcam.org/OTAnalytics)。
- [安装指南](https://opentrafficcam.org/OTAnalytics/installation/)
- [用户界面指南](https://opentrafficcam.org/OTAnalytics/usage-ui/)
## 许可证
本软件采用 [GPL-3.0 License](LICENSE) 授权
## 联系方式
- GitHub: [https://github.com/OpenTrafficCam](https://github.com/OpenTrafficCam)
- Email: [team@opentrafficcam.org](mailto:team@opentrafficcam.org)
标签：Python, 交通分析, 无后门, 计算机视觉, 轨迹分析, 逆向工具