modify: 删除隐私文件
This commit is contained in:
148
readme.md
148
readme.md
@@ -1,148 +0,0 @@
|
||||
# TrafficSafeAnalyzer
|
||||
|
||||
一个基于 Streamlit 的交通安全分析系统,支持事故数据分析、预测模型、异常检测和策略评估。
|
||||
|
||||
## 功能
|
||||
|
||||
- 加载和清洗事故与策略数据(Excel 格式)
|
||||
- 使用 ARIMA、KNN、GLM、SVR 等模型预测事故趋势
|
||||
- 检测异常事故点
|
||||
- 评估交通策略效果并提供推荐
|
||||
|
||||
## 安装步骤
|
||||
|
||||
### 前提条件
|
||||
|
||||
- Python 3.8+
|
||||
- Git
|
||||
- 可选:Docker(用于容器化部署)
|
||||
|
||||
### 安装
|
||||
|
||||
1. 克隆仓库:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/tongnian0613/TrafficSafeAnalyzer.git
|
||||
cd TrafficSafeAnalyzer
|
||||
```
|
||||
|
||||
2. 创建虚拟环境(推荐):
|
||||
|
||||
```bash
|
||||
conda create -n trafficsa python=3.12 -y
|
||||
conda activate trafficsa
|
||||
pip install -r requirements.txt
|
||||
streamlit run app.py
|
||||
```
|
||||
|
||||
3. 安装依赖:
|
||||
|
||||
(1) 基本安装(必需依赖)
|
||||
|
||||
```bash
|
||||
pip install streamlit pandas numpy matplotlib plotly scikit-learn statsmodels scipy
|
||||
```
|
||||
|
||||
(2) 完整安装(包含所有可选依赖)
|
||||
|
||||
```bash
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
(3) 或者手动安装可选依赖
|
||||
|
||||
```bash
|
||||
pip install streamlit-autorefresh openpyxl xlrd cryptography
|
||||
```
|
||||
|
||||
(4) 运行应用:
|
||||
|
||||
```bash
|
||||
streamlit run app.py
|
||||
```
|
||||
|
||||
## 依赖项
|
||||
|
||||
列于 `requirements.txt`:
|
||||
|
||||
```txt
|
||||
streamlit>=1.20.0
|
||||
pandas>=1.3.0
|
||||
numpy>=1.21.0
|
||||
matplotlib>=3.4.0
|
||||
plotly>=5.0.0
|
||||
scikit-learn>=1.0.0
|
||||
statsmodels>=0.13.0
|
||||
scipy>=1.7.0
|
||||
streamlit-autorefresh>=0.1.5
|
||||
python-dateutil>=2.8.2
|
||||
pytz>=2021.3
|
||||
openpyxl>=3.0.9
|
||||
xlrd>=2.0.1
|
||||
cryptography>=3.4.7
|
||||
openai>=2.0.0
|
||||
```
|
||||
|
||||
## 配置参数
|
||||
|
||||
- **数据文件**:上传事故数据(`accident_file`)和策略数据(`strategy_file`),格式为 Excel
|
||||
- **环境变量**(可选):
|
||||
- `LOG_LEVEL=DEBUG`:启用详细日志
|
||||
- 示例:`export LOG_LEVEL=DEBUG`(Linux/macOS)或 `set LOG_LEVEL=DEBUG`(Windows)
|
||||
|
||||
## 输入输出格式
|
||||
|
||||
### 输入
|
||||
- **事故数据 Excel**:需包含 `事故时间`、`所在街道`、`事故类型` 列
|
||||
- **策略数据 Excel**:需包含 `发布时间`、`交通策略类型` 列
|
||||
|
||||
### 输出
|
||||
- **预测结果**:CSV 文件(例如 `arima_forecast.csv`)
|
||||
- **图表**:HTML 文件(例如 `overview_series.html`)
|
||||
- **策略推荐**:文本文件(`recommendation.txt`)
|
||||
|
||||
## 调用示例
|
||||
|
||||
运行 Streamlit 应用:
|
||||
```bash
|
||||
streamlit run app.py
|
||||
```
|
||||
|
||||
访问 http://localhost:8501,上传数据文件并交互分析。
|
||||
|
||||
## 常见问题排查
|
||||
|
||||
**问题**:`ModuleNotFoundError: No module named 'streamlit'`
|
||||
**解决**:运行 `pip install -r requirements.txt` 或检查 Python 环境
|
||||
|
||||
**问题**:数据加载失败
|
||||
**解决**:确保 Excel 文件格式正确,检查列名是否匹配
|
||||
|
||||
**问题**:`NameError: name 'strategy_metrics' is not defined`
|
||||
**解决**:确保 `strategy_metrics` 函数定义在 `app.py` 中,且位于 `run_streamlit_app` 函数内
|
||||
|
||||
## 日志分析
|
||||
|
||||
- **日志文件**:`logs/app.log`(需在代码中配置 logging 模块)
|
||||
- **查看日志**:`tail -f logs/app.log`
|
||||
- **常见错误**:
|
||||
- `ValueError`:检查输入数据格式
|
||||
- `ConnectionError`:验证网络连接或文件路径
|
||||
|
||||
## 升级说明
|
||||
|
||||
- **当前版本**:v1.0.0
|
||||
- **升级步骤**:
|
||||
1. 备份数据和配置文件
|
||||
2. 拉取最新代码:`git pull origin main`
|
||||
3. 更新依赖:`pip install -r requirements.txt --upgrade`
|
||||
4. 重启应用:`streamlit run app.py`
|
||||
|
||||
参考 `CHANGELOG.md` 查看版本变更详情。
|
||||
|
||||
## 许可证
|
||||
|
||||
MIT License - 详见 LICENSE 文件。
|
||||
|
||||
[](https://github.com/tongnian0613/TrafficSafeAnalyzer/LICENSE)
|
||||
[](https://travis-ci.org/tongnian0613/repo)
|
||||
Reference in New Issue
Block a user