diff --git a/src/Driving_Accident_Video_Recognition/main.py b/src/Driving_Accident_Video_Recognition/main.py index 8419e7e63b..af6586c286 100644 --- a/src/Driving_Accident_Video_Recognition/main.py +++ b/src/Driving_Accident_Video_Recognition/main.py @@ -1,111 +1,215 @@ """ 主程序:驾驶事故视频识别工具(优化版) -优化点:性能提速+灵活配置+规范日志+新增人和小车识别提示 +优化点说明: +1. 性能提速:跳过重复依赖检查、缓存环境变量减少属性查找、简化检测器初始化逻辑 +2. 灵活配置:支持命令行动态调整检测源/置信度/日志级别/语言,无需修改配置文件 +3. 规范日志:替换print为logging模块,支持分级输出(DEBUG/INFO/WARNING),便于调试和生产环境使用 +4. 交互优化:新增人和小车识别提示,明确告知用户当前模型支持的识别类别 +5. 健壮性提升:参数合法性校验、异常捕获并分级输出、兼容不同运行路径 """ -import sys -import os -import argparse -import logging # 新增:日志模块(替代print,支持分级输出) +# 系统内置模块:基础功能支撑 +import sys # 系统路径、退出等核心操作 +import os # 环境变量、文件路径等操作系统交互 +import argparse # 命令行参数解析工具 +import logging # 日志模块(替代print,支持分级输出、格式化、持久化等) + +# 自定义模块/配置:项目核心配置和工具 from config import ( - REQUIRED_PACKAGES, PYPI_MIRROR, DETECTION_SOURCE, - CONFIDENCE_THRESHOLD, ACCIDENT_CLASSES # 新增:引入识别类别配置 + REQUIRED_PACKAGES, # 项目必需的依赖包列表(如ultralytics/opencv-python等) + PYPI_MIRROR, # PyPI镜像源(国内默认清华镜像,提速依赖安装) + DETECTION_SOURCE, # 默认检测源(0=本地摄像头,也可传视频文件路径) + CONFIDENCE_THRESHOLD, # 默认检测置信度阈值(过滤低置信度的识别结果) + ACCIDENT_CLASSES # 事故识别核心类别(0=人,2=小车,7=卡车等) ) -from utils.dependencies import install_dependencies -from core.detector import AccidentDetector +from utils.dependencies import install_dependencies # 依赖自动安装工具函数 +from core.detector import AccidentDetector # 事故检测器核心类(封装YOLO模型、检测逻辑) -# -------------------------- 新增1:日志初始化(替代print,更灵活) -------------------------- +# -------------------------- 核心工具函数1:日志初始化(替代print,更专业、灵活) -------------------------- def init_logger(): + """ + 初始化日志系统(核心作用:统一日志格式、支持分级输出) + 返回值: + logger: 配置好的日志实例,可调用logger.info/debug/warning/error输出不同级别日志 + 日志格式:时间戳 - 日志级别 - 日志内容(例如:2025-12-22 10:00:00 - INFO - 启动程序) + """ + # 创建日志器实例,命名为"AccidentDetection"(便于多模块日志区分) logger = logging.getLogger("AccidentDetection") + # 设置默认日志级别为INFO(低于INFO的日志不会输出,如DEBUG) logger.setLevel(logging.INFO) - # 控制台输出格式:时间+日志级别+内容 - formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s") + + # 避免重复添加处理器(多次调用该函数时防止日志重复输出) + if logger.handlers: + return logger + + # 定义日志输出格式:时间+级别+内容 + formatter = logging.Formatter( + "%(asctime)s - %(levelname)s - %(message)s", # 格式字符串 + datefmt="%Y-%m-%d %H:%M:%S" # 时间格式(可读性更强) + ) + + # 创建控制台处理器(日志输出到终端) console_handler = logging.StreamHandler() - console_handler.setFormatter(formatter) + console_handler.setFormatter(formatter) # 绑定格式 + + # 将处理器添加到日志器 logger.addHandler(console_handler) + return logger -# -------------------------- 新增2:优化命令行参数(更灵活的配置) -------------------------- +# -------------------------- 核心工具函数2:命令行参数解析(灵活配置,无需改代码) -------------------------- def parse_args(logger): + """ + 解析命令行参数(核心作用:让用户通过命令行动态配置参数,提升工具灵活性) + 参数: + logger: 日志实例(用于输出参数校验警告) + 返回值: + args: 解析后的参数对象,可通过args.xxx访问具体参数 + """ + # 创建参数解析器,添加工具描述(--help时显示) parser = argparse.ArgumentParser(description="驾驶事故视频识别工具(支持动态配置)") - # 基础参数:检测源、语言 - parser.add_argument("--source", "-s", default=DETECTION_SOURCE, - help=f"检测源(0=摄像头/视频路径,默认:{DETECTION_SOURCE})") - parser.add_argument("--language", "-l", default="zh", choices=["zh", "en"], - help="标注语言(zh=中文/en=英文,默认:zh)") - # 新增:性能/配置参数(无需改config.py,直接命令行调整) - parser.add_argument("--skip-deps", "-sd", action="store_true", default=False, - help="跳过依赖检查(已安装依赖时用,提速)") - parser.add_argument("--conf", "-c", type=float, default=CONFIDENCE_THRESHOLD, - help=f"检测置信度阈值(0-1,默认:{CONFIDENCE_THRESHOLD})") - # 新增:日志级别(调试/正常模式切换) - parser.add_argument("--log-level", "-ll", default="INFO", choices=["DEBUG", "INFO", "WARNING"], - help="日志级别(DEBUG=调试/INFO=正常/WARNING=仅警告,默认:INFO)") + # 1. 基础配置参数:检测源(摄像头/视频文件) + parser.add_argument( + "--source", "-s", # 参数名(长/短格式) + default=DETECTION_SOURCE, # 默认值(从config.py读取) + help=f"检测源(0=本地摄像头/视频文件绝对路径,默认值:{DETECTION_SOURCE})" + ) + + # 2. 界面配置参数:标注语言(中文/英文) + parser.add_argument( + "--language", "-l", + default="zh", # 默认中文 + choices=["zh", "en"], # 限制可选值(避免无效输入) + help="标注语言(zh=中文/en=英文,默认:zh)" + ) + + # 3. 性能优化参数:跳过依赖检查(已安装依赖时提速) + parser.add_argument( + "--skip-deps", "-sd", + action="store_true", # 无需传值,加该参数则为True + default=False, + help="跳过依赖检查(已确认安装所有依赖时使用,可大幅提升启动速度)" + ) + + # 4. 检测精度参数:置信度阈值(过滤低置信度结果) + parser.add_argument( + "--conf", "-c", + type=float, # 参数类型(浮点型) + default=CONFIDENCE_THRESHOLD, + help=f"检测置信度阈值(范围0-1,值越高越严格,默认:{CONFIDENCE_THRESHOLD})" + ) + + # 5. 调试配置参数:日志级别(控制输出详细程度) + parser.add_argument( + "--log-level", "-ll", + default="INFO", # 默认只输出INFO及以上级别 + choices=["DEBUG", "INFO", "WARNING"], # 可选级别 + help="日志级别(DEBUG=调试模式/INFO=正常模式/WARNING=仅警告,默认:INFO)" + ) + + # 解析命令行传入的参数 args = parser.parse_args() - # 校验参数合法性(新增:避免无效输入) + + # 关键校验:置信度阈值合法性(必须在0-1之间) if not (0 < args.conf <= 1): - logger.warning(f"置信度{args.conf}无效,自动使用默认值{CONFIDENCE_THRESHOLD}") + # 输出警告日志,自动回退到默认值 + logger.warning(f"输入的置信度{args.conf}无效(需0