16 · 方法论:格网法(傅熹年论断的可执行化)
编制:小明(建筑设计师)| 版本 v1.0 | 2026-11-20
定位:方法论层。回答「为什么尺寸是这么定出来的」,不回答「这个构件该多大」(后者归 L0 的 91 条 RULES)。
配套代码:engine/grid.py;校验器tools/check_grid.py;反算数据out/格网反算报告.md。
1. 问题:参数化凭什么不是「现代技术套古建」
工程对外一直有一个说法:「这不是用现代技术套古建,而是把古人的设计工具还回去」。
依据是傅熹年的格网法论断——古代建筑是在格网上按比例定位,不是靠尺规逐段量。
但这个说法此前是空的:翻遍全工程,找不到一处用格网法算出来的数、找不到一个能跑的函数、
找不到一次「拟合失败」的记录。它只是专家库里的一行 tag(tools/site_experts.py 傅熹年条)。
本项要做的是把这个空填上,并且必须让它有被打脸的机制——
如果一套方法只能证明自己、不能产生失败样本,它就不是方法,是自我催眠。
2. 文献:傅熹年原书论点(只写查得到的)
据 tools/site_experts.py 已登记的书目与学界公认表述(等级 [已验证·书目+观点],
原书页码逐条未核,见文末待补):
| 书目 | 出处状态 |
|---|---|
| 《中国古代城市规划、建筑群布局及建筑设计方法研究》2001,中国建筑工业出版社 | 书目已核,页码〔页码待补〕 |
| 《中国古代建筑史·元明卷》2001 | 书目已核,页码〔页码待补〕 |
| 《傅熹年建筑史论文集》 | 书目已核,页码〔页码待补〕 |
可确认的论点(转引,非原文逐字):
- 古代建筑设计的实际方法是在格网上按比例定位,不是靠尺规逐段量;平格、地盘格网是设计工具本身。
- 建筑群有模数化的总平面:院落的进深、面阔之间存在网格关系。
本项的立场:这两条是方法论假设,不是已在本工程证实的结论。
下面的算法只检验「现有算例是否与该假设不矛盾」,不宣称证明原书论点。
凡本文出现的数字,均来自本工程算例反算,不是从原书抄来的——原书页码补齐前,不得混引。
3. 算法:显式传格值,而不是搜索格值
3.1 接口(engine/grid.py)
@dataclass(frozen=True)
class GridFit:
ok: bool
unit_mm: float
cells: tuple[float, ...] # 每项格数 k
resid_mm: tuple[float, ...] # 每项残差
max_resid_mm: float
why: str # ok=True 为 "";失败必非空且分类
fit_grid(values_mm, unit_mm, *, max_cells=24, tol_mm=0.5) -> GridFit
fit_best(values_mm, candidates, **kw) -> GridFit
values_mm 构成固定为 bays_mm + [depth_mm, column_height_mm](5 项)。
柱径不参与拟合,只作格值:以柱径为格时,柱径自身 k 恒等于 1、残差恒 0,是无信息量的自证项。
3.2 三条硬约束
- 格数必须是小整数或半整数:
k ∈ {0.5 的整数倍}且k ≤ max_cells。
允许半格是为了容纳「次间 = 明间 × 0.8」这类分数,但绝不允许 k = 11.538 蒙混过去。
- 容差 tol_mm = 0.5:与
README.md母板对表容差一致。不用 1.0——那会让 1mm 级偏差被吞掉。 - 失败必须解释:
why区分resid(残差超容差)与cells(格数超上限)两类,
写清第几项、差多少毫米;绝不返回 None 静默丢弃样本。
3.3 ★ 为什么禁止在函数内部搜索格值(本项最关键的一条)
fit_grid 的 unit_mm 必须由调用方传入,函数自己不得试 100、150、200、250……。
这是实测出来的,不是理论洁癖:
卷棚那组
[2600, 3000, 2600] / 4800 / 2600 / 260(来自presets/siheyuan_juanpeng.json),
以柱径 260 为格是10 / 11.5 / 10 / 18.5 / 10,其中明间k=11.5残差 10.000mm、
进深k=18.5残差 10.000mm,明显不齐。(数据见报告 §二 S2 表)但只要允许试 200mm,立刻变成
13 / 15 / 13 / 24 / 13—— 全部整数、残差 0、max_cells刚好卡在 24 边界。这个「反例」当场消失,整项任务退化成自我证明。
机制已落盘为 --selftest 的 S6 探针,每次跑都打印:
S6 ✓ PROBE overfit_easy=YES cells=(13,15,13,24,13) [探针,不计入通过率]
结论:「能凑出整数」不等于「用了格网」。格值是否有资格,取决于它有没有历史依据,
不取决于它凑不凑得上。因此候选集写死为闭集(见 §3.4),且不得加入 200/250/150。
3.4 候选格值闭集(三选,带出处)
| 候选 | 值 | 出处 |
|---|---|---|
| 柱径 | 各 preset 的 column_dia_mm | 本工程既有模数口径:presets/*.json 的 _meta.modulus_chi 全部以「柱径 = 1」为基准 |
| 整尺 | 320.0 | 清尺 1 尺 = 320mm;《工程做法》以尺计 |
| 整寸 | 32.0 | 清尺 1 寸 = 32mm |
不得新增第四个候选。要加必须先给出文献依据,并在报告里单列一行说明。本项未新增。
3.5 反向测试(--selftest)
判据由交接方给定,不由实现方自定(否则循环论证):
| 判据 | 内容 | 实测 |
|---|---|---|
| S1 | 固定 random.seed(20261119),200 组随机样本 | 200 组 ✓ |
| S2 | 随机值须为浮点毫米且不是任何候选格值的整数/半整数倍 | 异常 0 ✓ |
| S3 | 200 组中 ok=True 必须 0 组 | 0 组 ✓ |
| S4 | 同批插入 20 组已知整格数据,ok=True 必须 20/20 | 20/20 ✓ |
| S5 | why 失败原因分类 resid 与 cells 各至少出现 1 次 | resid 200 / cells 200 ✓ |
| S6(探针,不计入判定) | 卷棚用 unit_mm=200 必须打印 PROBE overfit_easy=YES cells=(13,15,13,24,13) | YES ✓ |
随机性只出现在 --selftest 且 seed 固定;engine/grid.py 内无任何随机。
4. 反算结果(数字全部来自 out/格网反算报告.md)
4.1 样本独立性
报告首行原文:文件 7 · 独立尺度样本 2 · 候选 3。
按 (bays_mm, depth_mm, column_height_mm, column_dia_mm, purlin_count) 五元组去重:
7 个文件 / 2 套独立尺度样本(报告 §一)。
| 样本 | 文件数 | 尺度五元组 |
|---|---|---|
| S1 | 6 | bays=[3200, 3840, 3200] / depth=6400 / 柱高=3200 / 柱径=320 / 檩=5 |
| S2 | 1 | bays=[2600, 3000, 2600] / depth=4800 / 柱高=2600 / 柱径=260 / 檩=5 |
术语说明:这 6 个文件输入尺度参数相同、派生几何不同
(has_fei / tiptou_* / roof_finish 等字段确有差异),故 S1 的「6 个文件」是一套尺度样本的 6 次出现,
不是 6 个独立证据。若按文件数报「6 套通过」,就是一个证据重复 6 次。
4.2 S1:落在格网上(报告 §二 S1)
以柱径 320mm 为格:
| 尺寸项 | 毫米 | 格数 k | 残差 mm |
|---|---|---|---|
| 次间 | 3200 | 10 | 0.000 |
| 明间 | 3840 | 12 | 0.000 |
| 次间 | 3200 | 10 | 0.000 |
| 进深 | 6400 | 20 | 0.000 |
| 柱高 | 3200 | 10 | 0.000 |
整尺 320mm 同样落格(k 同上);整寸 32mm 未落格(k=100, 120, 100, 200, 100,超出 max_cells=24)。fit_best 判定:✓ 落格(柱径)。
4.3 S2:未落在格网上(报告 §二 S2、§三)
以柱径 260mm 为格:
| 尺寸项 | 毫米 | 格数 k | 残差 mm | 判定 |
|---|---|---|---|---|
| 次间 | 2600 | 10 | 0.000 | ✓ |
| 明间 | 3000 | 11.5 | 10.000 | ✗ 残差超 |
| 次间 | 2600 | 10 | 0.000 | ✓ |
| 进深 | 4800 | 18.5 | 10.000 | ✗ 残差超 |
| 柱高 | 2600 | 10 | 0.000 | ✓ |
整尺 320mm 未落格(max_resid=40.000mm,k=8, 9.5, 8, 15, 8);
整寸 32mm 未落格(max_resid=8.000mm,k=81, 94, 81, 150, 81,超格数上限)。fit_best 判定:✗ 全候选失败。
4.4 失败样本诊断(报告 §三)
S2 归 A 类·参数不合规矩,不是 B 类(格网法不适用)。证据:
以柱径 260mm 为格,5 项里 3 项落整/半格(次间 2600mm、次间 2600mm、柱高 2600mm),
另 2 项不落格;同组多数尺寸已按柱径模数取,唯独明间 3000mm 与进深 4800mm 没取齐。
属参数本身不齐——与格网法是否成立无关。
失败样本一个都不删。完整的三候选失败原因已写入报告 §三。
4.5 机器行
MARK grid_files=7 scale_samples=2 candidates=3 pass=1 fail=1
读法:7 个文件、2 套独立尺度样本、3 个候选;1 套落格、1 套未落格。
不是「6/7 通过」——那是重复计数。
5. 局限(这是本文的结论上限,不是脚注)
写成一个可检验命题,而不是「必要不充分」四个字:
命题 P:存在一个有历史依据的格值 M,使该建筑的主要尺寸都落在 M 的整数或半整数倍上。
本文检验的是 P 在 M ∈ {柱径, 整尺, 整寸} 这一有限闭集上是否成立,结果见 §4:
2 套独立尺度样本中,S1 在 M = 柱径(=整尺 320)上成立,S2 在三个候选上均不成立。P 成立不等于「古人以格网设计」成立:若 M 只能在看过数据之后才挑得出,那就只是过拟合。
这就是为什么格值必须是显式传入的闭集、禁止在函数内搜索——S6 探针已证明,
一旦允许试 200mm,S2 那个「真反例」会当场变成完美整格。因此本文的结论上限是:「现有算例与格网法不矛盾,且 M = 柱径这一口径有本工程既有的模数依据」,
不能写成「证明了傅熹年的格网论」。反例(S2 / 卷棚)不推翻 P,只说明「以柱径为格」这一具体 M 不适用于该算例;
经 §4.4 诊断,该样本属 A 类参数不齐,本来就与格网法无关。
待补(不掩盖)
- 傅熹年原书三部的具体页码与章节〔页码待补〕——当前只到「书目 + 学界公认观点」级别。
- 独立尺度样本仅 2 套,其中落格 1 套。样本量不足以做统计推断,
本文只做「一致 / 不一致」的个案判定,不做覆盖率或显著性声明。
- 候选闭集只含 3 个格值。若将来新增(如清尺半尺 160mm),必须先给文献依据并单列说明,
且要重跑 S6 探针确认没有把反例洗白。
6. 与 L0 / L1 分层的关系:为什么不进 91 条 RULES
| 层 | 内容 | 形态 |
|---|---|---|
| L0 条文层 | 91 条尺寸规定,每条有 formula + 出处 + 引擎落点 | 「这个构件该多大」——有可对表的具体尺寸 |
| L1 参数层 | 5 个自变量 + 推导链 | 「输入什么,怎么算」 |
| 方法论层(本文) | 格网法反算:fit_grid / fit_best + 本文件 | 「为什么尺寸是这么定出来的」——程序性知识 |
方法论条目不进 engine/rules.py:那 91 条每条都有 formula(可对表的具体尺寸),
而方法论是程序性知识、没有 formula。塞进去会让 gen_rulebook / check_distill 的语义崩掉
(蒸馏表 R1–R5 的落点校验依赖每条规则都有可定位的公式与出处)。
本层与 L1 的接口只有一条:从 preset 读 5 个尺度参数,反算格数。
不修改任何 L0 规则、不改任何 presets/*.json、不改任何既有几何代码——本项是纯新增。
v1.0 · 2026-11-20 · 编制:小明(建筑设计师)
依据:engine/grid.py、tools/check_grid.py、out/格网反算报告.md、tools/site_experts.py 傅熹年条