Repository navigation
Releases
v0.3.0 — epiAlert 0.1.0(L2 预警分级)
L2 预警层 epiAlert 0.1.0:把「什么算异常」从脚本里抽出来,做成可单独安装的一层。
安装
install.packages(
"https://github.com/Rythonme/EpiStack/releases/download/v0.3.0/epiAlert_0.1.0.tar.gz",
repos = NULL, type = "source"
)
library(epiAlert)这一版能做什么
alert_counts()一站式:契约表 → 季节性基线 → 单侧上界 → 四级信号 → 按地区汇总。- 四种基线方法:
seasonal(同季节窗口对数正态上界)、pooled(不分季节,年度默认)、moving(最近若干期均值加 k 倍标准差)、poisson(单侧泊松上分位);默认按时间粒度自动选择。 - 评估范围可选:
assess = "all"逐期回溯(默认)、"latest"只评最新周期、或指定年份。 - 分级两条线并看:连续超限期数与超出倍数。阈值用
alert_rules()改写、存成 JSON 随项目走。 - 输出控制台摘要、CSV(信号清单 + 地区汇总)或单文件 HTML 预警单。
口径说明
基线只用评估期之前、且只取更早年份的同期观测,本期不进入自己的基线——回溯评估不会越评越平。
周期编号与 epiCore::epi_period() 同口径。Imports 只有 stats 与 utils。
验收
- 包单测 86 项全通过;
R CMD check0 ERROR / 1 WARNING / 0 NOTE(WARNING 为 R 源码中文注释的可移植性提示)。 - 主仓切片换实现后,816 期基线、上界、连续期数与级别与旧实现逐行一致(最大绝对差 0),56 条信号级别不变,golden 基线未改。
- CI 每次 push 跑三包的 build / check / 单测与端到端链路。
v0.2.0 · epiIngest(L1 数据接入)
L1 落地:epiIngest 0.2.0
EpiStack 的第二层。把「数据怎么进来」做扎实:多源读取 → 规则化质控 → 统一契约,下游一行不改。
安装
install.packages(
"https://github.com/Rythonme/EpiStack/releases/download/v0.2.0/epiIngest_0.2.0.tar.gz",
repos = NULL, type = "source"
)
library(epiIngest)纯 R,无需 Rtools。生成契约需要 epiCore(0.1.0 已发布),只读 + 质控不需要。
可选后端按需安装:readxl(Excel)、DBI(数据库)、terra(栅格)、openssl(脱敏哈希);
缺包时 epi_ingest_capabilities() 会明确告诉你缺哪个,不会静默降级。
这一版有什么
- 读取:CSV / TSV / 任意分隔符、UTF-8 / GBK / BOM 自动识别、目录多文件按列名对齐合并;
$data只放契约列,$raw保留原始列,$meta记编码 / 分隔符 / md5 / 转换失败数。 - 质控:声明式规则(必填、唯一键、数值范围、未来日期、日期断档、地区白名单、MAD/IQR、跨字段),
error 剔除 / warn 保留并标记,逐行留痕到行号;规则可存成 JSON 随项目走;
全局ingest_on_warn("drop" | "error")切换口径。 - 报告:控制台 / CSV(含逐行明细)/ 单文件 HTML,无外部资源、可离线打开、可直接发给数据提供方。
- 血缘:
ingest_lineage()记文件 md5、规则哈希、行数变化、包版本,可写 JSON 归档。 - 脱敏:加盐 SHA-256 假名(同盐同编码恒等,可纵向合并,无盐不可反查)+ 可选日期平移。
- 适配器:Excel / 数据库 / HTTP 接口 / 栅格 zonal 统计;HTTP 用 base R 实现,自带 JSON 解析。
验收
| 项目 | 结果 |
|---|---|
| 包单测 | 96 PASS / 0 FAIL |
R CMD check |
0 ERROR / 1 WARNING(中文注释可移植性)/ 0 NOTE |
| 契约等价性 | 与 epiCore::read_counts() 同输入逐位一致;切片 4161 → 4159 行,剩余行一致 |
| golden 冒烟 | 37 PASS / 0 FAIL,基线未改 |
主仓同步:L1 thin → formal,垂直切片改用 ingest_counts(),新增 ingest_l1 流水线阶段。
v0.1.1 · 2026-11 月度发布
EpiStack v0.1.1 · 2026-11 月度发布(首次公开发布)
体系总体 + 本月任务归档 + 一条可复现的端到端链路,一次公开;后续按月增量更新。
本月交付
- epi-core/:正式 R 包,版本化契约、地区编码、邻接权重、
read_counts()与质控;40 项单测、6 份 Rd,R CMD check0 ERROR - 端到端切片:
vertical_slice/run_e2e.R一条命令贯穿 L0 契约 → L6 可复现清单 - 主仓编排:
pipeline.R声明式 L0–L6 分层计划、md5 指纹缓存、统一 manifest、仅含合成数据的报告站 - 质量闸门:
tests/smoke_e2e.R契约 golden 基线,37 PASS / 0 FAIL - CI:
R-CMD-check.yaml+nightly-e2e.yml(隐私守卫 + Pages) - 逐月更新机制:ROADMAP.md 12 个月状态表与更新 SOP;本月任务归档 与月度模板
隐私约定
公开仓库不含任何真实监测数据。所有示例与 CI 默认使用 demo/make_demo_data.R 生成的纯合成面板(31 个 D01–D31 地区、固定种子),不对应任何真实行政区;本机私有面板通过不入库的配置接入,数据与结果不公开,站点发布带隐私守卫。
快速开始
git clone https://github.com/Rythonme/EpiStack.git
cd EpiStack
Rscript pipeline.R --check
零第三方依赖、断网可跑;Rscript case_hfrs_real/run_hfrs.R 可单独跑模拟面板全链路。
演示结果(纯模拟数据)
合成切片:4159 行契约、注入暴发 6 周全中、Moran I = 0.441 (p = 0.031)、CI = −0.067。
模拟面板:651 行、Moran I = 0.406 (p = 0.003)、多年累积 I = 0.858 (p = 0.001)、CI = −0.113;月度演示 1116 行 / 372 地区-期 / 11 条信号。
完整细节见 本月归档 与 CHANGELOG.md。
联网安装 epiCore(无需 clone 整个仓库)
install.packages("https://github.com/Rythonme/EpiStack/releases/download/v0.1.1/epiCore_0.1.0.tar.gz",
repos = NULL, type = "source")
library(epiCore)零第三方依赖、纯 R 无需 Rtools、版本固定可复现(R 4.6.0 / Windows 已从公网实测)。
开发版:remotes::install_github("Rythonme/EpiStack", subdir = "epi-core", ref = "v0.1.1")
(Windows 先执行 Sys.setenv(TAR = "internal"),因为仓库含中文文件名);或
pak::pkg_install("github::Rythonme/EpiStack/epi-core@v0.1.1")。详见 epi-core/README.md。
v0.1 · 立项里程碑
EpiStack v0.1 · 立项里程碑
epi-core正式 R 包:版本化契约 schema、地区编码、邻接权重、read_counts()与质控- 六层端到端最小切片首次跑通(L0 契约 → L6 可复现清单)
- 本机私有面板端到端验收(数据与结果不公开)
- 项目进展看板、MIT 许可、CHANGELOG
后续工程化与公开发布见 v0.1.1。