Skip to content

Releases

v0.3.0 — epiAlert 0.1.0(L2 预警分级)

Choose a tag to compare

@Rythonme Rythonme released this 16 Nov 01:22

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 check 0 ERROR / 1 WARNING / 0 NOTE(WARNING 为 R 源码中文注释的可移植性提示)。
  • 主仓切片换实现后,816 期基线、上界、连续期数与级别与旧实现逐行一致(最大绝对差 0),56 条信号级别不变,golden 基线未改。
  • CI 每次 push 跑三包的 build / check / 单测与端到端链路。

v0.2.0 · epiIngest(L1 数据接入)

Choose a tag to compare

@Rythonme Rythonme released this 13 Nov 01:48

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 月度发布

Choose a tag to compare

@Rythonme Rythonme released this 10 Nov 16:27

EpiStack v0.1.1 · 2026-11 月度发布(首次公开发布)

体系总体 + 本月任务归档 + 一条可复现的端到端链路,一次公开;后续按月增量更新。

本月交付

  • epi-core/:正式 R 包,版本化契约、地区编码、邻接权重、read_counts() 与质控;40 项单测、6 份 Rd,R CMD check 0 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 · 立项里程碑

Pre-release

Choose a tag to compare

@Rythonme Rythonme released this 10 Nov 16:27

EpiStack v0.1 · 立项里程碑

  • epi-core 正式 R 包:版本化契约 schema、地区编码、邻接权重、read_counts() 与质控
  • 六层端到端最小切片首次跑通(L0 契约 → L6 可复现清单)
  • 本机私有面板端到端验收(数据与结果不公开)
  • 项目进展看板、MIT 许可、CHANGELOG

后续工程化与公开发布见 v0.1.1。