@kensnzk/koyu 0.5.0 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +43 -11
- package/README.md +51 -11
- package/dist/check.d.ts +34 -0
- package/dist/check.d.ts.map +1 -0
- package/dist/check.js +500 -0
- package/dist/check.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +319 -0
- package/dist/cli.js.map +1 -0
- package/dist/diff.d.ts +90 -0
- package/dist/diff.d.ts.map +1 -0
- package/dist/diff.js +522 -0
- package/dist/diff.js.map +1 -0
- package/dist/graph.d.ts +81 -0
- package/dist/graph.d.ts.map +1 -0
- package/dist/graph.js +328 -0
- package/dist/graph.js.map +1 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +10 -0
- package/dist/index.js.map +1 -0
- package/dist/light.d.ts +15 -0
- package/dist/light.d.ts.map +1 -0
- package/dist/light.js +55 -0
- package/dist/light.js.map +1 -0
- package/dist/mcp.d.ts +3 -0
- package/dist/mcp.d.ts.map +1 -0
- package/dist/mcp.js +354 -0
- package/dist/mcp.js.map +1 -0
- package/dist/model.d.ts +264 -0
- package/dist/model.d.ts.map +1 -0
- package/dist/model.js +361 -0
- package/dist/model.js.map +1 -0
- package/dist/parse-file.d.ts +9 -0
- package/dist/parse-file.d.ts.map +1 -0
- package/dist/parse-file.js +22 -0
- package/dist/parse-file.js.map +1 -0
- package/dist/parse.d.ts +16 -0
- package/dist/parse.d.ts.map +1 -0
- package/dist/parse.js +922 -0
- package/dist/parse.js.map +1 -0
- package/dist/plan.d.ts +8 -0
- package/dist/plan.d.ts.map +1 -0
- package/dist/plan.js +267 -0
- package/dist/plan.js.map +1 -0
- package/dist/site.d.ts +24 -0
- package/dist/site.d.ts.map +1 -0
- package/dist/site.js +53 -0
- package/dist/site.js.map +1 -0
- package/examples/comparison/README.md +16 -1
- package/examples/comparison/gen-ifc4.ts +1 -1
- package/examples/comparison/gen-ifcx.ts +2 -2
- package/examples/comparison/two-rooms.ifcx +1 -1
- package/examples/house/L1.muro +16 -0
- package/examples/house/L2.muro +19 -0
- package/examples/house/assets.muro +9 -0
- package/examples/house/main.muro +27 -0
- package/examples/house/site.muro +31 -0
- package/examples/house.muro +1 -1
- package/examples/mansion.muro +1 -1
- package/examples/office.muro +1 -1
- package/examples/steps/01-one-room.muro +4 -0
- package/examples/steps/02-two-rooms.muro +5 -0
- package/examples/steps/03-door.muro +9 -0
- package/examples/steps/04-exterior.muro +15 -0
- package/examples/steps/05-two-storeys.muro +27 -0
- package/examples/steps/06-finished.muro +30 -0
- package/examples/steps/README.md +25 -0
- package/examples/tower/L1.muro +80 -0
- package/examples/tower/L11.muro +47 -0
- package/examples/tower/L2.muro +69 -0
- package/examples/tower/L3.muro +28 -0
- package/examples/tower/assets.muro +13 -0
- package/examples/tower/main.muro +37 -0
- package/examples/tower/site-geometry.muro +7 -0
- package/examples/tower/site.muro +33 -0
- package/examples/tower/typical.muro +124 -0
- package/examples/two-rooms.canonical.json +5 -2
- package/examples/two-rooms.muro +6 -5
- package/package.json +28 -2
- package/src/check.ts +352 -63
- package/src/cli.ts +76 -11
- package/src/diff.ts +608 -0
- package/src/graph.ts +90 -10
- package/src/index.ts +14 -2
- package/src/mcp.ts +390 -0
- package/src/model.ts +260 -55
- package/src/parse-file.ts +28 -0
- package/src/parse.ts +562 -44
- package/src/plan.ts +33 -4
- package/src/site.ts +13 -5
- package/.github/workflows/ci.yml +0 -16
- package/.zenodo.json +0 -20
- package/CITATION.cff +0 -26
- package/docs/decisions/0001-notation-v0.md +0 -29
- package/docs/decisions/0002-height-and-offsets.md +0 -27
- package/docs/decisions/0003-uncounted-divisions.md +0 -36
- package/docs/decisions/0004-typical-floors.md +0 -21
- package/docs/decisions/0005-zones-and-unions.md +0 -23
- package/docs/decisions/0006-voids-and-light.md +0 -31
- package/docs/decisions/0007-semi-outdoor-air.md +0 -27
- package/docs/decisions/0008-vocabulary-and-level-attr.md +0 -23
- package/docs/decisions/0009-site-and-exterior.md +0 -29
- package/docs/ifc-coverage.md +0 -82
- package/docs/ifcx-notes.md +0 -25
- package/docs/img/house-L1.svg +0 -80
- package/docs/img/house-L2.svg +0 -53
- package/docs/img/mansion-L1.svg +0 -113
- package/docs/img/mansion-L10.svg +0 -111
- package/docs/img/mansion-L5.svg +0 -160
- package/docs/img/office-L1.svg +0 -116
- package/docs/img/office-L2.svg +0 -109
- package/docs/img/two-rooms.svg +0 -39
- package/docs/log/2026-07-22.md +0 -13
- package/docs/log/2026-07-23.md +0 -51
- package/docs/roadmap.md +0 -55
- package/docs/writing-architecture.md +0 -119
- package/spec/notation-v0.md +0 -164
- package/spec/vocabulary.md +0 -62
- package/test/core.test.ts +0 -171
- package/test/design2.test.ts +0 -97
- package/test/house.test.ts +0 -74
- package/test/mansion.test.ts +0 -99
- package/test/office.test.ts +0 -71
- package/test/uncounted.test.ts +0 -120
- package/test/vertical.test.ts +0 -75
- package/tsconfig.json +0 -13
package/src/plan.ts
CHANGED
|
@@ -34,11 +34,16 @@ export function svgPlan(model: Model, opts: PlanOptions = {}): string {
|
|
|
34
34
|
);
|
|
35
35
|
if (rooms.length === 0) throw new Error(`レベル ${level} に領域を持つ空間がありません`);
|
|
36
36
|
|
|
37
|
+
// 敷地形状 (ADR-0011) は最下階の平面 (配置図兼用) に敷地境界線として描く
|
|
38
|
+
const lowest = Object.values(model.levels).sort((a, b) => a.z - b.z)[0]?.name;
|
|
39
|
+
const sitePolys = level === lowest ? [...model.polygons.values()] : [];
|
|
40
|
+
|
|
37
41
|
const allRects = rooms.flatMap((s) => s.rects);
|
|
38
|
-
const
|
|
39
|
-
const
|
|
40
|
-
const
|
|
41
|
-
const
|
|
42
|
+
const polyPts = sitePolys.flatMap((p) => p.points);
|
|
43
|
+
const minX = Math.min(...allRects.map((r) => r.x1), ...polyPts.map((p) => p.x));
|
|
44
|
+
const maxX = Math.max(...allRects.map((r) => r.x2), ...polyPts.map((p) => p.x));
|
|
45
|
+
const minY = Math.min(...allRects.map((r) => r.y1), ...polyPts.map((p) => p.y));
|
|
46
|
+
const maxY = Math.max(...allRects.map((r) => r.y2), ...polyPts.map((p) => p.y));
|
|
42
47
|
|
|
43
48
|
const M = 84; // 余白 px (通り芯記号ぶん)
|
|
44
49
|
const W = (maxX - minX) * scale + M * 2;
|
|
@@ -52,6 +57,14 @@ export function svgPlan(model: Model, opts: PlanOptions = {}): string {
|
|
|
52
57
|
);
|
|
53
58
|
parts.push(`<rect width="${W}" height="${H}" fill="${PAPER}"/>`);
|
|
54
59
|
|
|
60
|
+
// 敷地境界線 (一点二点鎖線 — 作図慣習)。形は生成しない: 書かれた所与の形をそのまま引く
|
|
61
|
+
for (const poly of sitePolys) {
|
|
62
|
+
const d = poly.points.map((pt, i) => `${i === 0 ? "M" : "L"} ${sx(pt.x)} ${sy(pt.y)}`).join(" ");
|
|
63
|
+
parts.push(
|
|
64
|
+
`<path d="${d} Z" fill="none" stroke="#8a8171" stroke-width="1.1" stroke-dasharray="14 3 2.5 3 2.5 3"/>`,
|
|
65
|
+
);
|
|
66
|
+
}
|
|
67
|
+
|
|
55
68
|
// 空間の面 (合併の各矩形。同色・輪郭なしなのでL字は一体に見える)
|
|
56
69
|
// 半屋外 (外部にopen/railで接する空間) は淡く塗り分け、屋外であることが図から読めるように
|
|
57
70
|
for (const s of rooms) {
|
|
@@ -313,6 +326,22 @@ function doorSwing(
|
|
|
313
326
|
along = { x: 0, y: fromNorth ? -1 : 1 };
|
|
314
327
|
inward = { x: c.x > cx ? 1 : -1, y: 0 };
|
|
315
328
|
}
|
|
329
|
+
// 引き戸・自動ドア (style:sliding / style:auto — アセット語彙): 開き軌跡ではなく
|
|
330
|
+
// 吊元側の控え (戸袋側) にパネルを描く
|
|
331
|
+
const style = o.attrs["style"];
|
|
332
|
+
if (style === "sliding" || style === "auto") {
|
|
333
|
+
const off = 110; // 壁面からの控え mm
|
|
334
|
+
const s1 = {
|
|
335
|
+
x: hinge.x - along.x * o.w + inward.x * off,
|
|
336
|
+
y: hinge.y - along.y * o.w + inward.y * off,
|
|
337
|
+
};
|
|
338
|
+
const s2 = { x: hinge.x + inward.x * off, y: hinge.y + inward.y * off };
|
|
339
|
+
return (
|
|
340
|
+
`<line x1="${sx(s1.x)}" y1="${sy(s1.y)}" x2="${sx(s2.x)}" y2="${sy(s2.y)}" stroke="${INK}" stroke-width="2"/>` +
|
|
341
|
+
`<line x1="${sx(s2.x)}" y1="${sy(s2.y)}" x2="${sx(hinge.x)}" y2="${sy(hinge.y)}" stroke="${INK}" stroke-width="0.7"/>`
|
|
342
|
+
);
|
|
343
|
+
}
|
|
344
|
+
|
|
316
345
|
const leafEnd = { x: hinge.x + inward.x * o.w, y: hinge.y + inward.y * o.w };
|
|
317
346
|
const gapEnd = { x: hinge.x + along.x * o.w, y: hinge.y + along.y * o.w };
|
|
318
347
|
|
package/src/site.ts
CHANGED
|
@@ -7,8 +7,10 @@ import { segmentLength, segmentsFor } from "./graph.js";
|
|
|
7
7
|
import {
|
|
8
8
|
areaM2,
|
|
9
9
|
isSemiOutdoor,
|
|
10
|
+
polygonAreaM2,
|
|
10
11
|
unionAreaM2,
|
|
11
12
|
type Model,
|
|
13
|
+
type SitePolygon,
|
|
12
14
|
type Space,
|
|
13
15
|
type Zone,
|
|
14
16
|
} from "./model.js";
|
|
@@ -23,9 +25,11 @@ export interface RoadFrontage {
|
|
|
23
25
|
|
|
24
26
|
export interface SiteReport {
|
|
25
27
|
siteZone?: Zone;
|
|
28
|
+
/** 敷地形状 (polygon宣言 — ADR-0011)。あるとき導出面積はこの多角形から出る */
|
|
29
|
+
polygon?: SitePolygon;
|
|
26
30
|
/** 宣言された敷地面積 m² (zoneのarea:属性 — 測量値) */
|
|
27
31
|
declaredArea?: number;
|
|
28
|
-
/** 導出された敷地面積 m² (
|
|
32
|
+
/** 導出された敷地面積 m² (敷地形状があれば多角形、なければ敷地内空間+建物水平投影の合併) */
|
|
29
33
|
derivedArea: number;
|
|
30
34
|
/** 建築面積 m² (屋内空間の水平投影の合併 — 庇・バルコニーの算入は粗い) */
|
|
31
35
|
footprint: number;
|
|
@@ -48,10 +52,13 @@ export function siteReport(model: Model): SiteReport {
|
|
|
48
52
|
? spaces.filter((s) => s.path.startsWith(siteZone.path + "/") && s.rects.length > 0)
|
|
49
53
|
: [];
|
|
50
54
|
|
|
51
|
-
const
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
+
const polygon = siteZone ? model.polygons.get(siteZone.path) : undefined;
|
|
56
|
+
const derivedArea = polygon
|
|
57
|
+
? Math.round(polygonAreaM2(polygon.points) * 100) / 100
|
|
58
|
+
: unionAreaM2([
|
|
59
|
+
...siteChildren.flatMap((s) => s.rects),
|
|
60
|
+
...indoor.flatMap((s) => s.rects),
|
|
61
|
+
]);
|
|
55
62
|
const footprint = unionAreaM2(indoor.flatMap((s) => s.rects));
|
|
56
63
|
const totalFloor =
|
|
57
64
|
Math.round(indoor.reduce((sum, s) => sum + (areaM2(s) ?? 0), 0) * 100) / 100;
|
|
@@ -73,6 +80,7 @@ export function siteReport(model: Model): SiteReport {
|
|
|
73
80
|
|
|
74
81
|
return {
|
|
75
82
|
...(siteZone ? { siteZone } : {}),
|
|
83
|
+
...(polygon ? { polygon } : {}),
|
|
76
84
|
...(typeof declared === "number" ? { declaredArea: declared } : {}),
|
|
77
85
|
derivedArea,
|
|
78
86
|
footprint,
|
package/.github/workflows/ci.yml
DELETED
|
@@ -1,16 +0,0 @@
|
|
|
1
|
-
# コミットのたびに構成の整合と法則を自動で確かめる。
|
|
2
|
-
# 「整合性や法規のチェックは、コミットのたびに自動で回るCIになります」(docs/writing-architecture.md)
|
|
3
|
-
name: ci
|
|
4
|
-
on: [push, pull_request]
|
|
5
|
-
jobs:
|
|
6
|
-
test:
|
|
7
|
-
runs-on: ubuntu-latest
|
|
8
|
-
steps:
|
|
9
|
-
- uses: actions/checkout@v4
|
|
10
|
-
- uses: actions/setup-node@v4
|
|
11
|
-
with:
|
|
12
|
-
node-version: 22
|
|
13
|
-
- run: npm ci
|
|
14
|
-
- run: npm run typecheck
|
|
15
|
-
- run: npm test
|
|
16
|
-
- run: npm run check:examples
|
package/.zenodo.json
DELETED
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"title": "koyu (戸牖) — a space-first, text-native notation for architecture",
|
|
3
|
-
"description": "An exploration of text-native architectural description with space as the primary element: walls are boundaries between spaces, openings are connections, form is generated rather than authored. A whole building in a few hundred lines. 空間を一次要素とするテキストネイティブ建築記述の探求。",
|
|
4
|
-
"creators": [
|
|
5
|
-
{
|
|
6
|
-
"name": "Shinozaki, Ken"
|
|
7
|
-
}
|
|
8
|
-
],
|
|
9
|
-
"license": "Apache-2.0",
|
|
10
|
-
"keywords": [
|
|
11
|
-
"architecture",
|
|
12
|
-
"BIM",
|
|
13
|
-
"IFC",
|
|
14
|
-
"ontology",
|
|
15
|
-
"spatial description",
|
|
16
|
-
"text-native",
|
|
17
|
-
"DSL"
|
|
18
|
-
],
|
|
19
|
-
"upload_type": "software"
|
|
20
|
-
}
|
package/CITATION.cff
DELETED
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
cff-version: 1.2.0
|
|
2
|
-
message: "この探求を参照する場合は、以下の情報で引用してください。"
|
|
3
|
-
title: "koyu (戸牖) — a space-first, text-native notation for architecture"
|
|
4
|
-
authors:
|
|
5
|
-
- family-names: "Shinozaki"
|
|
6
|
-
given-names: "Ken"
|
|
7
|
-
email: "shinozaki.ken.141@gmail.com"
|
|
8
|
-
version: "0.5.0"
|
|
9
|
-
date-released: "2026-07-23"
|
|
10
|
-
license: "Apache-2.0"
|
|
11
|
-
repository-code: "https://github.com/kensnzk/koyu"
|
|
12
|
-
keywords:
|
|
13
|
-
- architecture
|
|
14
|
-
- BIM
|
|
15
|
-
- IFC
|
|
16
|
-
- ontology
|
|
17
|
-
- spatial-description
|
|
18
|
-
- text-native
|
|
19
|
-
- DSL
|
|
20
|
-
abstract: >-
|
|
21
|
-
空間を一次要素とするテキストを建築の原本とし、形はそこから生成する。
|
|
22
|
-
壁は二つの空間の境界という関係、開口は境界に開いた接続。
|
|
23
|
-
建物一棟を数百行で書く記法とツール群の探求。
|
|
24
|
-
Writing architecture, not buildings: a text-native, space-first
|
|
25
|
-
notation where walls are boundaries between spaces and form is
|
|
26
|
-
generated, not authored.
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
# ADR-0001: 記法v0 — 空間一次のDSLと正準JSON
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-22 / 状態: 採用 (素振り段階の決定。M1で再訪してよいが、覆すときはこの文書を更新する)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
原稿 (docs/writing-architecture.md) の最初の一手として、二つの室とその間の扉一つだけを自分の記法で書いた。原稿が予告したとおり、この数十行を書くには「空間の同一性をどう与えるか」「境界をどちらの空間に属させるか」「接続をどう表すか」「パスをどう切るか」を決めざるを得ず、記法はここで生まれた。
|
|
8
|
-
|
|
9
|
-
## 決定
|
|
10
|
-
|
|
11
|
-
**1. 空間の同一性は人間可読の階層パスに与える。** `/L1/a` がその空間の名であり同一性である。UUIDは持たない。LLMが一つのコンテキストで読み切り部分編集できること、diffが構成の言葉で読めることを、機械的な同一性の頑健さより優先する。改名は履歴上の出来事としてgitに残る。IFCのGUIDなど外部の同一性が必要になったら `id:` 属性を載せるレイヤーとして後置する。
|
|
12
|
-
|
|
13
|
-
**2. 境界はどちらの空間にも属させない。** `boundary` は二つの空間パスを結ぶ第一級の関係であり、壁とはこの関係に乗る属性 (厚み・仕様・耐火・遮音) である。壁をどちらかの室の所有物にすると、反対側の室から見た記述が二重になるか非対称になる。関係として持てば、グラフの辺がそのまま得られる。
|
|
14
|
-
|
|
15
|
-
**3. 接続は境界上の開口として表す。** `door` / `window` は境界の字下げ行に書く。垂れ壁のない開放的な分節は `type:open` の境界とし、扉ゼロで通行できる。これにより「一体空間の中の分節」(リビングとダイニングなど) が、壁のある境界と同じ語彙で書ける。
|
|
16
|
-
|
|
17
|
-
**4. パスは /レベル/空間 で切る。** パスの先頭セグメントがレベル名ならその階に属する。外部のようにレベルに属さない空間はサイト直下 (`/out`) に置く。粒度 (室の下位のゾーン、室の上位の住戸) はパスの階層で表せる見込みだが、M1まで判断を保留する。
|
|
18
|
-
|
|
19
|
-
**5. author形式は独自DSL、機械形式は正準JSONの二層構成。** 人とLLMが読み書きする原本は一行一文のDSL。合成 (レイヤー重ね)・diffの土台・外部ツール接続は `koyu json` が吐く正準JSONで行う。書き比べと評価は spec/notation-v0.md にある。
|
|
20
|
-
|
|
21
|
-
**6. 形は生成物。** 壁芯線分は空間の割付から導出され、ソースには書かれない。壁厚は芯振り分け、面積は壁芯算定。「壁を置く」操作はこのデータのどこにも存在しない。
|
|
22
|
-
|
|
23
|
-
## 代替案
|
|
24
|
-
|
|
25
|
-
UUID主キー (IFCXの選択) は可読性とLLM編集性を損なうため退けた。壁を物として持つこと (BIMの選択) は記述対象の取り替えという主題そのものの放棄になる。YAMLをauthor形式にする案は、DSLの密度とJSONの機械性の中間にあって決め手を欠いた。
|
|
26
|
-
|
|
27
|
-
## 帰結と代償
|
|
28
|
-
|
|
29
|
-
DSLはエディタ支援が無く文法の保守が要る。文法を「一行一文 + key:value + 字下げ開口」から増やさないことで抑える。v0の領域は矩形ひとつでありL字型の室が書けない — M1の一フロアで必ずぶつかるので、そこで多角形または複数矩形を決める。開き勝手は記述せず「先に書いた空間側へ開く」という描画規約に逃げた — 建具語彙とともに再訪する。
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
# ADR-0002: 高さ方向の一貫性と、通り芯からのオフセット
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.1)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
一フロアを超えて複数レベルを書くと、BIMが「3Dであること」によって暗黙に担保していた課題が表に出る。壁や床が幾何として存在すれば、階高と天井高とスラブの関係は形の整合として自然に成立し、食い込みは目に見える。空間一次のテキストにはその暗黙の担保が無い。どう置き換えるかを決める必要があった。
|
|
8
|
-
|
|
9
|
-
あわせて位置づけをはっきりさせる。**このデータの解像度は計画初期 — 基本計画レベル — である。** 垂れ壁や建具詳細は表現しない。それは省略ではなく抽象度の選択であり、まさにこの解像度に対して既存BIMは重すぎた (計画初期にBIMが使われない最大の理由)。目指す使い勝手の参照点はVectorworks的な軽さで、ただし原本は図形ではなく構成である。
|
|
10
|
-
|
|
11
|
-
## 決定
|
|
12
|
-
|
|
13
|
-
**1. 暗黙の3Dを、宣言された不変量と検査に置き換える。** レベルが `z` (FL高さ)・`h` (基準天井高)・`slab` (その階の床組み厚 = 下階天井面から自階FLまで: スラブ+懐+仕上) を宣言し、check が不変量「下階空間の天井高 + 上階slab ≤ 階高」を検査する。超えれば食い込みエラー。等号でなく不等号にしたのは、天井懐に余りのある設計 (下がり天井) が正当だからで、余り寸法は `levels` コマンド — テキストの矩計 — が見える化する。
|
|
14
|
-
|
|
15
|
-
**2. 床は書かない。** 垂直の隣接は平面の重なりと隣接レベルから導出され、境界の既定は床 (slab) である。書くのは例外 — 床が繋がる場所 — だけ: `type:stair` (階段、扉0枚で通行可)、`type:shaft` (EV等、空間として連続するが人は通れない)。将来の吹抜けは `type:void` (床が無い=ひとつの空間が階をまたぐ) としてここに加わる予定。水平の境界は全宣言 (書かなければ警告) なのに対し垂直は既定+例外宣言と非対称なのは、水平の分節が設計判断そのものであるのに対し、床の存在は階という概念の既定だからである。
|
|
16
|
-
|
|
17
|
-
**3. 通り芯からのオフセットは `X2+600` と書く。** 座標を直接書く記法は採らない。芯からの寸法で語ることで通り芯の言語を保ったまま、芯に載らない壁 (コアの間仕切り、水回りのブース壁など) が書ける。
|
|
18
|
-
|
|
19
|
-
**4. EVシャフトを通行不可としたのは避難の問いに正直であるため。** `doors /L1/ev /L2/ev` は4枚 (階段迂回) と答える。エレベーターは避難経路ではない。
|
|
20
|
-
|
|
21
|
-
## 代替案
|
|
22
|
-
|
|
23
|
-
三次元を生成して幾何干渉で検査する案は、検査が生成物の側に移り、エラーが構成の言葉 (「食い込む」) ではなく形の言葉 (メッシュ交差) になるため退けた。原本の検査は原本の言語で行う。空間ごとに床レベル・天井レベルを書く案は冗長で、既定 (レベルの宣言) + 例外 (h属性) で足りる。slabを境界ごとに書く案は、9割が同じ値の反復になりノイズになる。
|
|
24
|
-
|
|
25
|
-
## 帰結と代償
|
|
26
|
-
|
|
27
|
-
段差床・スキップフロアはレベルを増やして書くことになる (中2階 = 別レベル)。メゾネットと吹抜けは type:void の設計と同時に再訪する。構面の通層 (上下階で壁が揃っているか) はまだ検査していない — 揃っていない構成も計画としては正当なため、警告ではなく問い (クエリ) として提供するのが筋だろう。斜め壁は直交からの最初の逸脱として、多角形領域と同時に設計する。
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
# ADR-0003: 数える分節と数えない分節
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.1)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
同じ室の中で床材が変わる。同じ境界なのに途中から壁材が変わる。これをどう書くか。最初の案は「仕様が変わるところには分節が潜んでいる — 空間を割れ」だったが、これは要求に合わないと判明した。**室は面積計算の単位である。** 執務室は執務室として一室で扱いたい。採光・排煙・収容人員・貸室面積 — 面積にまつわる計算はすべて室を単位に走る。土間があるからといってホールが二室になってはならない。
|
|
8
|
-
|
|
9
|
-
## 決定
|
|
10
|
-
|
|
11
|
-
**分節には二種類ある、と認める。数える分節と、数えない分節である。**
|
|
12
|
-
|
|
13
|
-
数える分節は室と境界だ。面積表に一行として載り、室数に数えられ、グラフの節点と辺になる。垂れ壁のない分節でも、面積や動線の上で別の単位なら `type:open` の境界で割る — これは今まで通り。
|
|
14
|
-
|
|
15
|
-
数えない分節は、室に従属する領域 (`area`) と、境界に従属する区間 (`seg`) である。字下げで親に付き、属性の上書きだけを運ぶ:
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
space /L1/hall hall X1..X2 Y1..Y2 name:エントランスホール floor:フローリング
|
|
19
|
-
area X1..X1+1800 Y1..Y2 name:土間 floor:モルタル
|
|
20
|
-
|
|
21
|
-
boundary /L1/office /L1/corridor t:120 spec:LGS
|
|
22
|
-
door w:900
|
|
23
|
-
seg at:0.75 w:3600 spec:ガラスパーティション
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
**隔離則: 数えない分節は、面積・室数・グラフに一切影響しない。** ホールは土間があっても40.96㎡の一室であり、doorsの答えも隣接も変わらない。これはテストで恒久的に保証する (test/uncounted.test.ts)。segの位置は開口と同じ流儀 (at, w, edge) をとる。
|
|
27
|
-
|
|
28
|
-
使い分けのリトマス試験は二つ。**「面積表に一行として現れてほしいか?」** — 欲しければ space、要らなければ area。**「そこを通れるかが問題になるか?」** — なるなら boundary/opening、ならないなら seg。
|
|
29
|
-
|
|
30
|
-
## 代替案
|
|
31
|
-
|
|
32
|
-
空間を割ってパス階層で束ねる案 (/L1/hall/doma + /L1/hall/main) は、室の同一性と面積単位を壊すため退けた。割る操作はこのデータでは安いが、安いからといって単位が変わってよいことにはならない。属性値を領域つきの複合値にする案 (floor: [{rect, material}]) は、同じ内容の形式化が弱いだけの版である。実施設計まで先送りする案 (基本計画と割り切って捨てる) は、土間や延焼ラインの仕様変化のように基本計画レベルで意味を持つ例がある以上、粗すぎる。
|
|
33
|
-
|
|
34
|
-
## 帰結と代償
|
|
35
|
-
|
|
36
|
-
物の記述への滑り戻りを防ぐ防波堤が「幾何を持たせない」から「**構成に影響させない (隔離則)**」に移った。area/segは幾何 (範囲) を持つ — だが構成 (グラフ・面積・室数) からは見えない。この線は今後も試される: areaに面積の内訳を答えさせたくなったら (仕上げ数量など)、それは構成の問いではなく生成物の問いとして実装する。境界の仕様が変わる場所の多くは実際には向こう側の分節 (廊下の相手が受付から執務に変わる等) や外部の分節 (延焼ライン → /outを割る) であり、segはその残余のための最後の道具である — 迷ったらまず「向こう側に分節が潜んでいないか」を疑うのが正しい順序。areaの重なりは現状未定義 (警告もしない)。必要が出たらレイヤー的な later-wins を明文化する。
|
|
@@ -1,21 +0,0 @@
|
|
|
1
|
-
# ADR-0004: 基準階は一度だけ書く — レベル範囲・スパン展開・stack
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.2)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
10階建ての集合住宅を書くと、反復が初めて現れる。2〜9Fの基準階は同じ割付であり、8回複製すれば書けるが、それは設計基準「LLMが一つのコンテキストで読み切り、正しく部分編集できるか」を壊す。基準階の一つの変更が8箇所の編集になり、diffは8倍に膨れ、「この住戸が広がった」という一言で読めなくなる。原本に複製を持たないことは、テキストであることと同じくらい本質的だった。
|
|
8
|
-
|
|
9
|
-
## 決定
|
|
10
|
-
|
|
11
|
-
三つの機構を足す。**レベルの等差宣言** `level L3..L9 6700 pitch:2900 h:2400 slab:500` は7つのレベルを一度に宣言する。**パスのスパン展開** `/L2..L9/A` は、宣言済みレベルのz順の並びとして解決され、その行が各レベルへ展開される — 一行の中の複数パスは同じスパンでなければならず、同じ階に揃って展開される (`boundary /L2..L9/A /L2..L9/corridor` はA|廊下を8フロアぶん張る)。字下げの開口・area・segも展開先の全てに付く。**stack宣言** `stack ev L1..L10 type:shaft` は垂直に積層する空間列を宣言し、連続するレベル対に垂直境界を張る。
|
|
12
|
-
|
|
13
|
-
DSLは「基準階は一つ」という意図を保持し、機械形式 (正準JSON) は展開後を持つ。原本のdiffは基準階の一行の変更として読める — 159行の原本が90空間・244境界に展開される集合住宅で、界壁の仕様変更は1行のdiffである。
|
|
14
|
-
|
|
15
|
-
## 代替案
|
|
16
|
-
|
|
17
|
-
8回書く案は上記の通り編集の局所性を壊す。composition (レイヤー参照) で基準階レイヤーを8回重ねる案は、OpenUSD/IFCXの流儀に忠実で機械形式側の将来実装とも整合するが、DSLの一読性を今失う理由がない。スパン展開はcompositionの前借りであり、正準JSON側で参照レイヤーに正規化する道は塞いでいない。
|
|
18
|
-
|
|
19
|
-
## 帰結と代償
|
|
20
|
-
|
|
21
|
-
**例外階がまだ書けない。** 8Fだけ間取りが違う、5Fに吹抜けが抜ける — スパンから特定階を除く記法 (except) か、展開後への上書きが要る。これは吹抜け (`type:void` — 基準階の床が一部抜ける) と同根の問題であり、同時に設計する。スパンはパスのレベル段 (先頭セグメント) にしか使えず、連番のみ。stackの端点レベルは宣言済みである必要がある (levelを先に書く)。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
# ADR-0005: 間取りの粒度 — ゾーンとL字の合併
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.3)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
住戸の中の間取りを書くと、粒度の二層性が本格化する。住戸は面積計算・分譲・管理の単位であり続けたいが、間取りを書けば室が一次要素になる。両方が同時に「数える単位」でありたい。あわせて、L字のLDKのような非矩形の室が初めて必要になった。
|
|
8
|
-
|
|
9
|
-
## 決定
|
|
10
|
-
|
|
11
|
-
**1. ゾーン = 数える集約。** `zone /L2..L9/A name:Aタイプ use:exclusive` は幾何を持たない宣言で、パス接頭辞で室を束ねる。ゾーンの面積は配下の室の合計として導出され (壁芯で室が住戸を敷き詰めるので住戸壁芯面積に一致する)、`use` などの属性は配下の室へ継承される (室自身の宣言が勝つ)。空間の階層パスがそのまま集計の階層になる — 「共用と専有の面積比」は住戸を間取りに割った後も1行も変えずに答えられる。
|
|
12
|
-
|
|
13
|
-
**2. 粒度は混在してよい。** 集合住宅の例ではAタイプだけを間取りまで書き、B〜Eは住戸一室のまま。基本計画の進行に合わせて、詳細化した住戸から順に割っていける。ゾーンがあるから、割っても集計の言葉 (Aタイプ 34.8㎡) は壊れない。
|
|
14
|
-
|
|
15
|
-
**3. L字は矩形の合併。** 領域は `+` で複数書ける: `space .../ldk ldk X1+2600..X2 Y1..Y2-1800 + X1..X1+2600 Y1..Y1+1400`。面積は合計、壁は合併の外周と共有辺から導出され、共線の外周は一本にマージされる (掃き出し窓が2矩形をまたぐS面に普通に置ける)。同一ペアがL字で2辺接する場合 (LDK|洋室)、扉は `edge:` で辺を選ぶ。
|
|
16
|
-
|
|
17
|
-
## 代替案
|
|
18
|
-
|
|
19
|
-
住戸を空間のままにして間取りをarea (数えない分節) で書く案は、室が通行と面積の単位である以上不可 (寝室の扉が書けない)。多角形を直接書く案は、直交グリッドの言語 (通り芯とオフセット) を捨てて頂点列に落ちるため退けた — 矩形の合併は骨格の言葉を保ったまま同じ形状クラスを覆う。
|
|
20
|
-
|
|
21
|
-
## 帰結と代償
|
|
22
|
-
|
|
23
|
-
矩形合併は直交形状しか作れない (これは方針: 曲線・斜めは対象外)。合併の矩形同士の重なりはエラーとし、面積の二重算入を防ぐ。ゾーンの入れ子 (棟>住戸>室) はパス上は自然に書けるが、集計の重複規則はまだ決めていない。
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
# ADR-0006: 吹抜け — 床の不在も境界で書く。採光は最初の法規クエリ
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.3)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
吹抜けは空間一次のモデルにとって試金石だった。物のモデルなら「床スラブに穴を開ける」操作だが、ここには床がそもそも書かれていない (levelのslabが既定)。書かれていないものの不在をどう書くか。
|
|
8
|
-
|
|
9
|
-
## 決定
|
|
10
|
-
|
|
11
|
-
**1. 吹抜けは垂直境界 `type:void` で書く。** 上階に `type:void` の空間 (吹抜けの領域) を置き、下階の空間と `boundary /L1/hall /L2/void type:void` で結ぶ。床は既定・接続 (stair) は例外・不在 (void) も例外、という同じ文法に収まる。
|
|
12
|
-
|
|
13
|
-
**2. void境界は高さ不変量の宣言的な免除である。** 下階の空間は `h:6700` のように階をまたぐ天井高を宣言でき、通常なら「上階に食い込む」エラーになるところを、void境界が免除する。免除は暗黙ではなく宣言 — void境界を消せばエラーが戻る (テストで保証)。BIMが幾何の穴で暗黙に表現するものを、ここでは「不在の宣言とその帰結の検査」で持つ。
|
|
14
|
-
|
|
15
|
-
**3. voidの空間は数えない・通れない。** 床面積に算入せず (吹抜けは床面積不算入 — 法規と一致)、通行不可 (落ちないため)。平面図では作図慣習どおり破線の対角線で描く。
|
|
16
|
-
|
|
17
|
-
**4. 例外階は新しい記法なしで書ける。** 「8Fだけ違う」はスパンを割ればよい: `/L2..L7/` と `/L9..L9/`… ではなく `/L2..L7/A` の行と L8 個別の行に分ける。展開の機構がそのまま例外を許す。専用の except 糖衣は、実例が要求するまで足さない。
|
|
18
|
-
|
|
19
|
-
**5. 採光は `light` コマンド — 法規検証の芽の第一号。** 住居系の居室 (unit/room/ldk/bedroom/living) について窓面積/床面積 ≥ 1/7 を判定する。採光補正係数を掛けない甘い早期警報であり、基本計画の解像度に合わせた割り切りを明記する。実際、54㎡のEタイプが1面の掃き出し窓では1/7に足りないことをこの検査が指摘し、東面の窓が足された — 構成の記述から法規の帰結が「何もせず」出てくる最初の実例。
|
|
20
|
-
|
|
21
|
-
## 代替案
|
|
22
|
-
|
|
23
|
-
吹抜けを「下階の空間が上のレベルにもrectを持つ」多層空間として書く案は、空間とレベルの1対1対応 (パス=/レベル/名前) を壊す。スラブを明示的に書いて穴を開ける案は、物の記述への回帰。メゾネット (住戸内階段で2層) は多層空間の方が素直かもしれず、void+stairの組で書けるかを次に試す。
|
|
24
|
-
|
|
25
|
-
## 帰結と代償
|
|
26
|
-
|
|
27
|
-
採光の補正係数・隣地距離・開口の方位は扱っていない — /outの分節 (道路側・隣地側) が入った時に精度を上げる。
|
|
28
|
-
|
|
29
|
-
## 追記 (同日夜): 部分吹抜けの規則
|
|
30
|
-
|
|
31
|
-
部分吹抜けを正式に定義した。**下階の空間の天井高は階高内に収めたまま、吹抜け部分の高さは導出とする** — 天井高が一様である前提と衝突しない。void境界による高さ不変量の免除は「吹抜けが下階空間の平面を全て覆う場合 (被覆率≥99%)」に限り、部分吹抜けで階をまたぐ天井高を宣言するとcheckが被覆率つきでエラーにする (examples/house.muro のLDK上部が実例、被覆1/3)。下階の平面図には吹抜け範囲を破線+「上部吹抜け」で表示する (作図慣習)。バルコニー越し採光の0.7掛けもこの日に追加 (ADR-0007)。
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
# ADR-0007: 半屋外は導出する — 遮蔽性はair属性、kindにrailを入れない
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.4)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
屋外階段が平面図で屋外に見えない、という指摘から始まった。原因は描画ではなくデータにある: 手すりを `spec:手すり壁` のwallとして書いており、「囲う壁」と「囲わない手すり」の区別をデータが持っていなかった。仕様が書かれていないものは描き分けられない。
|
|
8
|
-
|
|
9
|
-
最初の実装案は境界kindに `rail` を足すことだった。これは途中で棄却した — **IFCを参照すると、IfcRailingは要素クラスであり、空間境界の関係 (IfcRelSpaceBoundary) が言うのは Physical/Virtual と Internal/External だけである。** kindに物の名を入れ始めると、明日は curtainwall、fence、hedge… と増殖し、退けたはずのクラス階層を関係の側で再発明することになる。
|
|
10
|
-
|
|
11
|
-
## 決定
|
|
12
|
-
|
|
13
|
-
**1. kindは関係のトポロジーだけ (wall/open + 垂直)。物の名はspec語彙。** 手すりは `boundary A /out t:120 spec:手すり air:1` — wallである (扉がないから通れないのはwallの既定)。specは自由語彙でツールは解釈しない。
|
|
14
|
-
|
|
15
|
-
**2. 解釈される性質は `air:1` (遮蔽しない) の一語だけ足す。** 通行可能性はkindが言い、遮蔽性はairが言う。直交する二軸を混ぜない。
|
|
16
|
-
|
|
17
|
-
**3. 半屋外は宣言ではなく導出する。** 外部 (type:exterior) に対して open または air:1 の境界を持つ空間が半屋外である。バルコニー・屋外階段・ルーフテラスは、手すりを正しく書けば自動的に半屋外になる。
|
|
18
|
-
|
|
19
|
-
**4. 導出の帰結。** statsでは半屋外を床面積合計から別掲し (算入条件は法規細部のため)、ゾーン面積 (専有面積) からも除く。lightは半屋外越しの窓を0.7掛け (縁側補正に倣う粗い値)。平面図ではair境界を細実線で描く — 壁の黒帯と描き分けることで、囲われていないことが図から読める。「仕様かデザインか」への答え: データが仕様を持ち、描画はそれに従う。
|
|
20
|
-
|
|
21
|
-
## 代替案
|
|
22
|
-
|
|
23
|
-
kindにrailを足す案 (上述、実装後に棄却)。空間に `outdoor:1` を宣言する案は、境界を正しく書けば導出できる情報の二重宣言であり、矛盾の置き場になる。
|
|
24
|
-
|
|
25
|
-
## 帰結と代償
|
|
26
|
-
|
|
27
|
-
airは遮蔽の有無だけを言う二値で、開放率 (欄干の透過度) や防風・防雨の程度は持たない — 基本計画の解像度。屋根の有無 (半屋外のうち庇下か吹きさらしか) は未分節で、日影・斜線を扱う時に再訪する。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
# ADR-0008: 語彙の台帳と、パス=集計の階層
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.4)
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
開き勝手をどう書くかという問いは、掘ると「要素ごとの属性の付け方をどうルール化するか」という問いだった。属性が場当たりに増えると、同じ意味に別の語が使われ、どれをツールが解釈するのか分からなくなる — 開かれた語彙の「開き方」に規則が要る。あわせてメゾネット (階を跨ぐ住戸) がゾーンのパス接頭辞と衝突する問題があった。
|
|
8
|
-
|
|
9
|
-
## 決定
|
|
10
|
-
|
|
11
|
-
**1. 語彙の台帳 (spec/vocabulary.md) を契約とする。** 規則は五つ: kindは関係のトポロジーだけ / 物の名はspec語彙 (ツールは解釈しない) / 解釈される属性は台帳に載せ、変えるときはADRを書く / 単位はmm・位置は0..1・キーは小文字英字 / 継承と上書きの規則 (use: zone→space、floor: space→area、spec: boundary→seg) を明文化する。自由な k:v はいつでも書けるが、意味が定まったら台帳に追記して育てる。台帳は一つ。
|
|
12
|
-
|
|
13
|
-
**2. 開き勝手は解釈される属性の実例として `hinge` と `swing` で書く。** `hinge:W/E` (水平線分) / `hinge:N/S` (垂直線分) が吊元、`swing:a/b` が開く側 (境界のどちらの空間へ)。既定は始端側・a側で、書かなければ今まで通り。checkが線分の向きとhingeの軸の整合を検査し、平面図が従う。
|
|
14
|
-
|
|
15
|
-
**3. パスの第一義は集計の階層である。** レベルは既定でパス先頭セグメントから読むが、階を跨ぐくくり (メゾネット住戸・吹抜けを含む一体空間の親) は `level:` 属性で階を明示し、パスは所属 (どの住戸か) を言う。`zone /home` の下に `space /home/ldk ... level:L1` と `space /home/bed1 ... level:L2` が並び、住戸=ゾーンが階を跨いで束ねられる (examples/house.muro)。
|
|
16
|
-
|
|
17
|
-
## 代替案
|
|
18
|
-
|
|
19
|
-
開き勝手を `door-l` / `door-r` のような開口kindの増殖で書く案は、ADR-0007と同じ理由で退けた (kindはトポロジー、性質は属性)。メゾネットのために「多層空間」(一つのspaceが複数レベルにrectを持つ) を導入する案は、空間とレベルの対応を壊し、高さ検査と平面図の前提を複雑にする — ゾーンが既に「束ねる」道具なので、束ねる側で解くのが筋。
|
|
20
|
-
|
|
21
|
-
## 帰結と代償
|
|
22
|
-
|
|
23
|
-
台帳の規律は自己申告であり、CIは未知の属性を警告しない (自由語彙を守るため)。将来、台帳との突き合わせを `check --strict` のような任意検査にすることはあり得る。hinge/swingは平面表現の語であり、建具表 (開き戸/引き戸/折れ戸の別) はまだ持たない — 実施へ向かう情報としてsegやレイヤーの側に置く選択肢を残す。
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
# ADR-0009: 敷地と外部の分節 — 外もまた空間である
|
|
2
|
-
|
|
3
|
-
日付: 2026-07-23 / 状態: 採用 (v0.5) / 対応Issue: MUN-149, MUN-150
|
|
4
|
-
|
|
5
|
-
## 文脈
|
|
6
|
-
|
|
7
|
-
/out は一枚岩の外部で、どの外部に面するかが言えなかった。延焼ライン (隣地側だけ仕様が変わる)、接道、屋外階段の「地上」の意味、いずれもこの分節を待っていた。IFCではIfcSite・IfcExternalSpatialElementにあたるが、敷地境界線そのものはIFCにも一次エンティティが無い — 空間一次が素直に勝てる場所である。
|
|
8
|
-
|
|
9
|
-
## 決定
|
|
10
|
-
|
|
11
|
-
**1. /out は複数のexterior空間に割れる。** `space /out/road exterior name:南側道路 road:6000` — 方角・性格ごとに割り、粒度は自由 (一枚岩のままでも良い — 既存例は無修正で有効)。道路は `road:幅員` の解釈属性で印す。上階の外壁は方角別のexteriorに `edge:` で面する。
|
|
12
|
-
|
|
13
|
-
**2. 地上の外部空間 (庭・通路) はL1上の実在の空間として建物の周りをタイルする。** 領域を持つので、建物との重なりはエラーとして検証され、室との境界線分は矩形同士から正確に導出される。GL/FLの段差はv0では無視 (測地・高さ基準はMUN-159で再訪)。「地上」の意味はこの空間たちが担う — 屋外階段や玄関はここへ開き、避難は庭を通って門扉から道路へ抜ける (「寝室から道路まで扉3枚」)。
|
|
14
|
-
|
|
15
|
-
**3. 敷地 = site:1 属性を持つゾーン。** `zone /site name:敷地 site:1 area:126.24` — 幾何を持たない集約という原則を保ちつつ、宣言面積 (測量値) を属性に持ち、`site` コマンドが導出面積 (敷地内空間+建物投影の合併) と突き合わせる。高さ不変量と同じ「宣言+検査」のパターン。
|
|
16
|
-
|
|
17
|
-
**4. 敷地の数字は導出する。** `site` コマンドが敷地面積 (宣言/導出の照合)・接道 (敷地空間と道路の境界線分長 — 建物外壁が道路に面する分は数えない)・建築面積 (屋内空間の水平投影の合併)・建蔽率・容積率を返す。基本計画のボリューム検討の数字が、構成を書けば出てくる。
|
|
18
|
-
|
|
19
|
-
**5. 塀・門扉は境界の語彙で書く。** 塀 = `t:120 spec:ブロック塀 air:1 h:1200` (物はspec、外気は遮らない)、門扉 = その境界の door。外構 (MUN-151) の語彙の入口。
|
|
20
|
-
|
|
21
|
-
**6. 庇下の導出。** 採光の半屋外係数0.7は「上に空間がある半屋外 (バルコニー下・庇下)」にだけ適用し、上が開いた半屋外 (庭・最上階バルコニー) は1.0とする。屋根の有無すら宣言ではなく、上階の空間の重なりから導出する。
|
|
22
|
-
|
|
23
|
-
## 代替案
|
|
24
|
-
|
|
25
|
-
敷地を専用の第4要素 (site) として幾何ごと導入する案は、空間・境界・ゾーンの三つ組で足りるのに要素を増やす。外部をレベルごとに割る案 (地上/2F上空/…) は無限の分節を招く — 地上性は敷地空間が、方角性は/outの分節が、それぞれ一度だけ担えば足りる。
|
|
26
|
-
|
|
27
|
-
## 帰結と代償
|
|
28
|
-
|
|
29
|
-
敷地空間のタイルは規律を要する (宣言/導出の照合が破れを警告する)。建築面積の算入 (庇・バルコニーの1m/2m規則) は粗いまま。延焼ラインの実計算は距離幾何が要るため未実装 — ただし「どの隣地に面するか」はこの分節で言えるようになった (足がかり完了)。傾斜地・GL段差は未対応。集合住宅の例の/out分節への移行は必要になった時に行う (一枚岩の/outも引き続き有効)。
|
package/docs/ifc-coverage.md
DELETED
|
@@ -1,82 +0,0 @@
|
|
|
1
|
-
# IFCカバレッジ — IFC4建築系コアとの照合表
|
|
2
|
-
|
|
3
|
-
IFC4のスキーマを鏡にして、koyuが何を書けるか・何をまだ書けないか・何を方針として書かないかを管理する台帳。原本はこのファイルで、未対応 (○) と部分対応 (◐) はLinearの別プロジェクト [koyu × IFC カバレッジ] のIssueと対応する。更新の作法: 実装や決定が動いたらこの表を先に直し、対応Issueを閉じる。
|
|
4
|
-
|
|
5
|
-
記号: **●** 対応 (書ける・解釈される) / **◐** 部分対応 (書けるが解釈が浅い) / **○** 未対応 (計画 — Issueあり) / **—** 方針として対象外 (理由を明記)
|
|
6
|
-
|
|
7
|
-
## 規模の見取り図 (概算)
|
|
8
|
-
|
|
9
|
-
web-ifc同梱スキーマ (IFC2x3/4/4x3統合) のエンティティ約1,140のうち、幾何・形状表現系が約250、構造解析系が約45、設備系が約150、土木系 (4x3) が約50、関係 (IfcRel*) が約60。**幾何表現の層 — IFCの物量の中核 — を「形は生成物」の方針が丸ごと原本から追放している**ことが、koyuが小さい理由の骨格である。残る建築系コア (空間構造・建築要素・属性・数量) がこの表の主戦場になる。
|
|
10
|
-
|
|
11
|
-
## A. 空間構造 (Spatial Structure)
|
|
12
|
-
|
|
13
|
-
| IFC | 状態 | koyuでの対応 |
|
|
14
|
-
|---|---|---|
|
|
15
|
-
| IfcProject / IfcBuilding / IfcBuildingStorey | ● | name宣言・パス階層・level宣言 (z/h/slab、範囲宣言)。矩計は`levels` |
|
|
16
|
-
| IfcSpace | ● | space — 二次的存在から一次要素への格上げが主題そのもの |
|
|
17
|
-
| IfcSpatialZone / IfcZone | ● | zone (数える集約 — ADR-0005)。階を跨ぐくくりはlevel:属性 (ADR-0008) |
|
|
18
|
-
| IfcSite (敷地) | ◐ | zone site:1 + 地上の外部空間 (庭・通路) がL1上で建物をタイル (ADR-0009)。敷地面積は宣言/導出を照合、接道・建蔽率・容積率は `site` が導出。残: GL/FL段差・測量座標 (MUN-159)、建築面積の算入細則 (MUN-158) |
|
|
19
|
-
| IfcExternalSpatialElement (外部空間) | ● | /outは方角・性格ごとの複数exterior空間に割れる (道路は road:幅員)。粒度自由・一枚岩も有効。延焼ラインの実計算は距離幾何が要るため残 (MUN-157系) |
|
|
20
|
-
| IfcRelAggregates (空間分解) | ● | パス階層そのもの |
|
|
21
|
-
|
|
22
|
-
## B. 空間境界 (Space Boundaries)
|
|
23
|
-
|
|
24
|
-
| IFC | 状態 | koyuでの対応 |
|
|
25
|
-
|---|---|---|
|
|
26
|
-
| IfcRelSpaceBoundary (PHYSICAL/VIRTUAL) | ● | boundary kind wall/open。IFCでは付随的な関係が、ここでは一次のグラフの辺 |
|
|
27
|
-
| 同 (INTERNAL/EXTERNAL) | ● | 宣言でなく導出 (相手がexteriorか)。半屋外もopen/air:1から導出 (ADR-0007) |
|
|
28
|
-
| 2nd Level境界 (熱計算粒度) | — | 省エネ計算の粒度は当面対象外。必要になったら生成物側で導出 |
|
|
29
|
-
|
|
30
|
-
## C. 建築要素 (Shared Building Elements)
|
|
31
|
-
|
|
32
|
-
| IFC | 状態 | koyuでの対応 |
|
|
33
|
-
|---|---|---|
|
|
34
|
-
| IfcWall / IfcWallStandardCase | ● | 壁=境界の属性 (t/spec/fire/sound)。壁を置く操作は存在しない |
|
|
35
|
-
| IfcRailing | ● | spec語彙 + air:1 (ADR-0007 — kindに物の名を入れない) |
|
|
36
|
-
| IfcSlab (床) | ● | 書かない — levelのslabが既定。不在はvoid境界 (ADR-0006) |
|
|
37
|
-
| IfcSlab.ROOF / IfcRoof (屋根) | ○ | Rレベル (上限面) のみ。庇・勾配・パラペット、半屋外の屋根有無 (庇下/吹きさらし)。→ Issue「屋根」 |
|
|
38
|
-
| IfcDoor / IfcWindow | ◐ | opening (w/h/at/sill) + 開き勝手hinge/swing。建具の型 (開き戸/引戸/折戸)・防火設備の別・建具表は未。→ Issue「建具語彙」 |
|
|
39
|
-
| IfcOpeningElement / RelVoids / RelFills | ● | 開口は境界の字下げ。ブーリアンは存在しない (形が無いので) |
|
|
40
|
-
| IfcStair / IfcStairFlight / IfcRamp | ◐ | 空間 (type:stair) + 垂直境界 (type:stair) として動線は書ける。段数・蹴上げ・踏面が階高から成立するかの検査、スロープ勾配は未。→ Issue「階段・スロープの成立検査」 |
|
|
41
|
-
| IfcColumn / IfcBeam / IfcMember | ○ | 方針は「構造は物の別レイヤー」だが、柱型の室内への出っ張りは基本計画に効く。最小記述を検討。→ Issue「柱・梁の最小記述」 |
|
|
42
|
-
| IfcCurtainWall | ◐ | spec語彙で書ける (解釈なし)。大開口はwindow/segでも書ける |
|
|
43
|
-
| IfcCovering (床仕上げ) | ◐ | floor属性 + area (数えない分節)。天井 (下がり天井マップ・仕上表) は未。→ Issue「天井と仕上げ」 |
|
|
44
|
-
| IfcBuildingElementProxy | ◐ | 自由語彙 (type/spec) で運べる |
|
|
45
|
-
|
|
46
|
-
## D. バルコニー・立ち上がり (問い: 床の延長か?)
|
|
47
|
-
|
|
48
|
-
IFC4にバルコニー専用エンティティは無い (実務はIfcSlab+IfcRailing+外部IfcSpaceの組合せ)。koyuの答え: **バルコニーは床の延長ではなく空間である** — そもそも床は原本に書かれないので、「床の延長か」という問いは物の言語に属する。空間として書き (半屋外は導出)、床は生成物。手すり・立ち上がりの高さは境界のh属性が持つ (`spec:手すり air:1 h:1100`)。ただし「RC立ち上がり1200+笠木手摺」のような**鉛直方向の複合プロファイル**は未対応 — windowのsill/h、腰壁、立ち上がりを統一する語彙が要る。→ Issue「立ち上がり・パラペット (境界の鉛直プロファイル)」
|
|
49
|
-
|
|
50
|
-
## E. 属性・分類・材料・数量
|
|
51
|
-
|
|
52
|
-
| IFC | 状態 | koyuでの対応 |
|
|
53
|
-
|---|---|---|
|
|
54
|
-
| IfcPropertySet / IfcProperty | ● | 開かれたk:v属性 + 語彙の台帳が契約 (ADR-0008) |
|
|
55
|
-
| IfcElementQuantity (数量) | ◐ | 数量は宣言せず導出 (stats/light)。壁芯固定 — 内法・容積対象・区画面積の規約は未。→ Issue「面積規約」 |
|
|
56
|
-
| IfcClassification (外部分類) | ○ | 台帳と外部辞書 (bSDD/Uniclass/日本の室用途コード) の橋。→ Issue「外部分類への参照」 |
|
|
57
|
-
| IfcMaterial / IfcMaterialLayerSet | ◐ | specは名前だけ。層構成は実施の情報 — 後段レイヤー (composition) の最初の実験台候補。→ Issue「材料の層構成」 |
|
|
58
|
-
| IfcGrid | ● | grid宣言 (通り芯+オフセット) |
|
|
59
|
-
| IfcOwnerHistory | ● | 持たない — gitが履歴 (原稿の主張どおり) |
|
|
60
|
-
|
|
61
|
-
## F. 敷地の外・都市
|
|
62
|
-
|
|
63
|
-
| IFC | 状態 | koyuでの対応 |
|
|
64
|
-
|---|---|---|
|
|
65
|
-
| IfcGeographicElement (外構) | ○ | アプローチ・駐車場・植栽・舗装。外部空間の分節+外構語彙。→ Issue「外構」 |
|
|
66
|
-
| IfcMapConversion / IfcProjectedCRS (測地) | ○ | 真北・測地座標。採光/日影の方位、CityGML/PLATEAU接続の前提。→ Issue「測地座標と真北」 |
|
|
67
|
-
| IFC4x3土木 (道路・鉄道・橋梁・トンネル 約50) | — | 対象外 (建築に絞る) |
|
|
68
|
-
|
|
69
|
-
## G. 方針として対象外 (原稿「扱わないこと」の帰結)
|
|
70
|
-
|
|
71
|
-
| IFC領域 | 理由 |
|
|
72
|
-
|---|---|
|
|
73
|
-
| 幾何・形状表現 (約250エンティティ) | 形は生成物。原本に形を持たないことが主題 |
|
|
74
|
-
| 構造解析系 (IfcStructural* 約45) | 構造は物の別レイヤー (柱・梁の最小記述のみ検討 — C参照) |
|
|
75
|
-
| 設備系 (約150) | 当面対象外。PS/EV/機械室は空間として既に書ける。EVかご寸法等の語彙は Issue「昇降機の語彙」に軽く積む |
|
|
76
|
-
| プロセス・コスト (IfcTask/IfcCostItem等) | 探求の範囲外 |
|
|
77
|
-
| 資産管理・センサ (IfcAsset/IfcSensor等) | 地平 (デジタルツイン) — 実測レイヤーの設計時に再訪 |
|
|
78
|
-
| スタイル・表示 (IfcStyledItem等) | 描画はツールの仕事。原本は構成 |
|
|
79
|
-
|
|
80
|
-
## 対応の思想 (要約)
|
|
81
|
-
|
|
82
|
-
IFCの「エンティティ」は、koyuでは三つのどれかに落ちる: **構造として解釈される少数の語** (kind/解釈属性 — 台帳の★)、**開かれた語彙の値** (spec/type — IfcRailingやIfcCurtainWallはここ)、**導出される生成物** (数量・幾何・内外の別)。エンティティを増やさずにカバレッジを広げるのがこの設計の賭けであり、この表はその検算である。
|
package/docs/ifcx-notes.md
DELETED
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
# IFCX読解メモ
|
|
2
|
-
|
|
3
|
-
2026-07-22。buildingSMART/IFC5-development を読んだ記録。乗るためではなく、テキストとcompositionという同じ道具立てで他人がこの問題をどう解いたかを見るため (docs/writing-architecture.md「最初の一手」)。
|
|
4
|
-
|
|
5
|
-
## ファイルの解剖
|
|
6
|
-
|
|
7
|
-
.ifcx は素のJSONで、`header` (id・ifcxVersion "ifcx_alpha"・author・timestamp)、`imports` (他レイヤーのURI参照、integrityハッシュ付き)、`schemas` (属性の型定義)、`data` (ノードのフラットな配列) の四部からなる。ノードは `{ path, children?, inherits?, attributes? }` だけの小さな構造で、`children` が名前→UUIDの辞書として階層を張り、`inherits` がUSDのreference相当としてプロトタイプ (例: 窓インスタンス→windowType) を参照する。スキーマは `bsi::ifc::prop::FireRating` のように名前空間で切られた語彙として宣言される。TypeSpecによる形式定義が schema/ifcx.tsp にあり、実装より先に読むならここが最短。
|
|
8
|
-
|
|
9
|
-
## 合成 (composition) の実際
|
|
10
|
-
|
|
11
|
-
同じ path のノードを複数書くと重なり合う。hello-wall.ifcx 自身が一つのファイル内でこれをやっており (同じUUIDに三つのエントリが customdata・class・prop を別々に載せる)、ファイル間でも同じ機構で上書きできる。hello-wall-add-specific-fire-rating.ifcx はわずか631バイトのレイヤーで、UUID直指しと `uuid/My_Project/My_Site/My_Building/My_Storey/Wall/Window_001` という深いパス指しの両方で FireRating を足してみせる。**差分レイヤーがこの軽さで書けることが composition の価値のすべてで、ここは借りるべき機構である。**
|
|
12
|
-
|
|
13
|
-
## 観察 — 何が変わり、何が変わっていないか
|
|
14
|
-
|
|
15
|
-
hello-wall は壁一枚と窓二つの場面で、.ifcx が43KB、元の .ifc (SPF) が79KB ある。43KBの大半は `usd::usdgeom::mesh` の頂点座標列、つまりビルド成果物がソースに同梱されている分である。My_Space というノードは存在し、Boundary_Wall / Boundary_Window を子に持つ点は面白い (IfcRelSpaceBoundary の系譜) が、その境界自体が Body メッシュを持つ物の記述であり、場面の主語はあくまで IfcWall。**形式はテキストとcompositionに刷新されたが、記述の対象は建築物のままである。空いているのはこちら側、という原稿の見立てはファイルを読んでも変わらなかった。**
|
|
16
|
-
|
|
17
|
-
規模感の対比として: 壁一枚+窓二つがIFCXで43KB、koyuの二室一扉は22行 (0.7KB) で書けて平面図とグラフ問合せまで出る。場面が同一ではないので厳密な比較ではないが、記述対象を物から空間に替えると桁が変わることの感触には十分。
|
|
18
|
-
|
|
19
|
-
## 借りるもの / 借りないもの
|
|
20
|
-
|
|
21
|
-
借りるのは、パス名前空間を背骨にしたレイヤーの非破壊的な重ね合わせ、名前空間つき語彙 (`bsi::ifc::prop::…` の形式)、imports による外部レイヤー参照の発想。借りないのは、UUIDを主キーにした同一性 (koyuは人間可読パス。IFC GUIDは取り込み時に属性レイヤーで後置する)、メッシュの同梱 (形は生成物)、そして建築物のオントロジーそのもの。
|
|
22
|
-
|
|
23
|
-
## 手元の参照
|
|
24
|
-
|
|
25
|
-
クローンは作業環境の ~/work/ref/IFC5-development に置いた (Macでクローンする場合は `git clone https://github.com/buildingSMART/IFC5-development ~/Documents/github/IFC5-development`)。閲覧は https://ifc5.technical.buildingsmart.org/viewer/ で、examples/Hello Wall/ の .ifcx を複数枚ドロップするとレイヤー合成が確認できる。仕様の実体は schema/ifcx.tsp、例のFAQは Examples_FAQ.md。
|