#moonbit-radiation

#项目定位

• 预估多层屏蔽体的窄束透射和散射积累影响；
• 运行可复现的光子输运实验，观察相互作用、能量沉积和边界穿越；
• 扫描能量、厚度、材料和源项，比较候选工程方案；
• 生成剂量、深度剂量、统计置信区间和机器可读报告。

#核心能力

• 解析计算：指数衰减、HVL/TVL、线性与质量衰减系数、Broder/Taylor 风格积累、多层屏蔽和反平方缩放。
• 蒙特卡洛输运：Woodcock/delta tracking、光电效应、Compton 散射、对生成、能量截止、批次 SEM 和可选历史记录。
• 源与几何：单能和离散能谱、Co-60/Cs-137 预设、铅/铁/混凝土/水/空气材料、平板层、孔径、圆柱和射线盒相交。
• 工程后处理：层内能量沉积、剂量换算、深度剂量曲线、网格计分、设计搜索、敏感性和不确定度传播。
• 统计与质量：在线统计量、95% 置信区间、直方图、方差缩减辅助、能量平衡、概率守恒和输入审计。
• 生产工作流：确定性任务分片、检查点恢复、独立重复实验、资源预算、校准、质量门禁和发布清单。
• 三维场与仪器：网格梯度/拉普拉斯/剖面分析、检测器响应与死时间修正、ROI、峰值和 MDA 估算。
• 输出：文本、Markdown、CSV 报告，以及可序列化的结构化结果。

#快速开始

#环境

moon version --all
moon update
moon check --target all --deny-warn
moon test --target native --deny-warn

#使用库

moon add Zjfzjf666/radiation@0.2.2

let source = @lib.cobalt_60_pencil_source()
let layers = @lib.lead_concrete_wall(5.0, 20.0)
let options = @lib.TransportOptions::defaults(source, layers)
options.histories = 10000
options.batches = 20
let result = @lib.run_transport(options)
let report = @lib.audit_transport(result)

#CLI

moon run src/main --target native

• 窄束解析透射率与积累修正后的透射率；
• Monte Carlo 透射率、SEM 和终止状态计数；
• 平均沉积能量、质量门禁结果和 3 条示例历史。

#架构

src/lib/
├── types, database, prng, physics, mc     基础数据、材料数据、随机数与传统 MC API
├── geometry, geometry_shapes, spectrum     平板层、几何相交、源项和能谱
├── advanced_physics, transport             截面分解、Compton 与扩展输运核心
├── statistics, validation, audit           统计量、输入校验与质量审计
├── mesh, scoring, field_dose, engineering 计分、能量平衡、剂量和设计分析
├── energy_analysis, sensitivity             能量响应、敏感性和参数扫描
├── variance_reduction, sampling_tools       抽样与方差缩减辅助
├── reporting, result_analysis, event_statistics 结果、事件和报告后处理
├── production_types, numerical_methods       生产数据模型与数值算法
├── source_library, detector_response         源项调度、谱响应、ROI 与死时间
├── job_orchestration, workload_planning      分片、检查点、重复实验与资源规划
├── field_analysis, field_metrics             三维网格投影、梯度、阈值和体积统计
├── calibration_pipeline, quality_validation  校准诊断、验证用例与质量门禁
├── reporting_extended, data_exports           CSV、Markdown 和运行清单导出
├── presets, workflows, material_tools         可复现预设与工程工作流
└── compatibility, uncertainty_models          旧 API 适配与不确定度模型

src/main/                                    CLI 演示程序

#基准

#测试与边界覆盖

• 空层、零厚度、负厚度、越界定位、平行射线和退化几何；
• 空谱、重复谱线、零概率、极端能量、能量截止和非整除批次；
• Compton 能量守恒、概率归一化、输运终止计数和虚拟碰撞计分；
• 能量平衡、层内沉积、深度剂量、统计置信区间和不确定度传播；
• CSV/Markdown 输出、旧 API 兼容转换、材料排序和响应曲线单调性；
• 三维网格边界、谱 ROI、能量标定、时间窗口、任务分片、检查点和质量门禁。

moon fmt --check
moon check --deny-warn
moon test --target native --deny-warn

#CI 与发布

moon version --all
moonc -v  # CI 拒绝低于 v0.10.9 的编译器
moon update
moon check --target all --deny-warn
moon build --target all --deny-warn
moon test --target all --deny-warn
moon fmt --check
moon info

#许可证