用 Python 构建一个小区居民出行聚集数据统计与小型聚集场景病菌传播风险模拟系统用于说明「如何让出行与聚集数据变成可解释的公共健康风险提示」。一、实际应用场景描述在社区公共卫生、基层疾控与健康管理课程中出行与聚集分析常用于- 小区居民日常出行模式统计- 社区活动、广场舞、棋牌室等小型聚集场景监测- 传染病防控演练与风险评估- 健康管理课程中的流行病学建模教学案例典型数据包括- 居民 ID脱敏- 出行时间、地点- 聚集人数规模- 停留时长分钟但在现实中- 只有“有人聚集”的定性信息- 不清楚聚集密度与持续时间- 无法量化传播风险等级二、引入痛点当前常见问题1. 数据不可量化只记“人多”不记“多到什么程度”2. 风险不可见不知道哪些场景更危险3. 缺乏模拟能力难以评估不同管控措施的效果痛点总结缺少一个可量化、可模拟、非诊断性的聚集传播风险评估工具。三、核心逻辑讲解工程建模视角⚠️ 说明以下为工程风险模型不等同于流行病学或疾控标准。核心输入字段 含义location 聚集地点crowd_size 聚集人数duration_min 停留时长density 人均面积㎡/人越小越密工程风险公式示例聚集风险 人数 × log(停留时长) × (1 / 人均面积)传播风险 聚集风险 × 场景权重场景权重示例场景 权重棋牌室 1.5电梯 1.8广场活动 1.0社区超市 1.2四、Python 核心代码模块化 清晰注释1️⃣ 数据结构定义models.py小区居民出行与聚集数据结构import mathclass GatheringEvent:def __init__(self, location, crowd_size, duration_min, density, scene_type):self.location locationself.crowd crowd_sizeself.duration duration_minself.density densityself.scene scene_type2️⃣ 聚集风险计算模块risk.py聚集场景病菌传播风险计算SCENE_WEIGHT {mahjong: 1.5,elevator: 1.8,square: 1.0,market: 1.2}def gathering_risk(event: GatheringEvent):base event.crowd * math.log(event.duration) * (1 / event.density)weight SCENE_WEIGHT.get(event.scene, 1.0)return round(base * weight, 2)3️⃣ 风险分级与提醒模块advisor.py传播风险分级与公共健康提醒def risk_level(score):if score 20:return 低风险elif score 50:return 中风险else:return 高风险def public_health_advice(level, location):advice_map {低风险: f{location} 聚集风险较低建议保持通风与适度分散。,中风险: f{location} 存在传播风险建议缩短停留时间并佩戴口罩。,高风险: f{location} 传播风险较高建议减少聚集或暂停活动。}return advice_map.get(level)4️⃣ 主程序main.pyfrom models import GatheringEventfrom risk import gathering_riskfrom advisor import risk_level, public_health_adviceif __name__ __main__:event GatheringEvent(location社区棋牌室,crowd_size12,duration_min90,density1.2,scene_typemahjong)risk_score gathering_risk(event)level risk_level(risk_score)print(f聚集传播风险指数{risk_score})print(f风险等级{level})print(公共健康提醒, public_health_advice(level, event.location))五、README.md# Community Gathering Risk Simulator小区聚集传播风险模拟工具## 项目定位本工具用于教学与技术演示展示如何统计小区居民出行聚集数据模拟小型聚集场景的病菌传播风险。⚠️ 本项目不构成流行病学结论仅用于工程建模练习。## 功能- 聚集场景数据建模- 传播风险指数计算- 风险分级与公共健康提醒## 使用方式bashpython main.py## 依赖- Python 3.8## 适用人群- 全栈开发者- 社区公共卫生 / 疾控工程师- 健康管理课程讲师六、使用说明User Guide1. 构造GatheringEvent 聚集场景数据2. 使用gathering_risk 计算传播风险3. 调用risk_level 与public_health_advice 获取提醒4. 可扩展为- 多场景批量模拟- 不同管控措施对比限流、通风、缩短时长- 社区级聚集风险热力图七、核心知识点卡片去营销化 知识点 1传播风险是“人 × 时间 × 空间”的函数工程上必须联合建模。 知识点 2模拟不是预测模型用于评估“相对风险”不是精确传染人数。 知识点 3建议要具体到场景“棋牌室限流”比“少聚集”更有执行力。八、总结中立立场✅ 本程序展示了一个通用、可扩展的社区聚集风险评估模型✅ 强调出行聚集数据 → 风险模拟 → 可解释提醒的工程闭环✅ 非常适合用于公共卫生教学、社区管理、技术博客利用AI解决实际问题如果你觉得这个工具好用欢迎关注长安牧笛