Skip to content

Engine

zdem_dfn.engine

ZDEM DFN 引擎 — 兼容门面（facade）。

v1.1 起引擎拆分为职责单一的下层模块，本文件保留为兼容层：

  • zdem_dfn.config 全局常量与开关（运行时覆盖的唯一入口）
  • zdem_dfn.geometry 纯几何算法（距离 / 裁剪 / 求交）
  • zdem_dfn.dfn 随机裂隙网络生成
  • zdem_dfn.io ini_xyr.dat 解析与带标签输出
  • zdem_dfn.sampling 颗粒-裂隙采样与分组
  • zdem_dfn.plotting 预览图渲染
  • zdem_dfn.main 批处理编排 + CLI

兼容契约（长期承诺）：本模块按“v1.0 单体 engine.py 曾暴露的完整公开面” 维护 re-export，即下列名称从 zdem_dfn.engine 导入永远可用：

  • 全部 config 常量（CROP_* / ENABLE_* / SOURCE_FILENAME / TARGET_FILENAME / TARGET_DIRECTORIES / FRACTURE_SETS / PROB_* 及类型别名）
  • geometry 全部函数，含历史私有名 _compute_outcode 与 OUTCODE 常量（INSIDE / LEFT / RIGHT / BOTTOM / TOP）—— tests/test_geometry.py 依赖它们
  • io 全部函数（parse_particle_file / compute_reference_stats / output_tagged_coordinates / avg_diameter_of）
  • generate_dfn_network / generate_preview_plot / 采样函数
  • main / run_batch（随版本演进增加新参数，但旧签名始终接受）

移除任何一个 re-export 前必须先在 CHANGELOG 中声明 major 版本弃用。

旧代码 from zdem_dfn.engine import X 继续可用。 注意：运行时覆盖配置请赋值 zdem_dfn.config.XXX（对 engine 属性赋值 不会传播到下层模块）；或直接用 CLI 参数 python -m zdem_dfn --dirs ...。