@kensnzk/koyu 0.5.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.
Files changed (61) hide show
  1. package/.github/workflows/ci.yml +16 -0
  2. package/.zenodo.json +20 -0
  3. package/CITATION.cff +26 -0
  4. package/LICENSE +73 -0
  5. package/NOTICE +2 -0
  6. package/README.ja.md +71 -0
  7. package/README.md +72 -0
  8. package/docs/decisions/0001-notation-v0.md +29 -0
  9. package/docs/decisions/0002-height-and-offsets.md +27 -0
  10. package/docs/decisions/0003-uncounted-divisions.md +36 -0
  11. package/docs/decisions/0004-typical-floors.md +21 -0
  12. package/docs/decisions/0005-zones-and-unions.md +23 -0
  13. package/docs/decisions/0006-voids-and-light.md +31 -0
  14. package/docs/decisions/0007-semi-outdoor-air.md +27 -0
  15. package/docs/decisions/0008-vocabulary-and-level-attr.md +23 -0
  16. package/docs/decisions/0009-site-and-exterior.md +29 -0
  17. package/docs/ifc-coverage.md +82 -0
  18. package/docs/ifcx-notes.md +25 -0
  19. package/docs/img/house-L1.svg +80 -0
  20. package/docs/img/house-L2.svg +53 -0
  21. package/docs/img/mansion-L1.svg +113 -0
  22. package/docs/img/mansion-L10.svg +111 -0
  23. package/docs/img/mansion-L5.svg +160 -0
  24. package/docs/img/office-L1.svg +116 -0
  25. package/docs/img/office-L2.svg +109 -0
  26. package/docs/img/two-rooms.svg +39 -0
  27. package/docs/log/2026-07-22.md +13 -0
  28. package/docs/log/2026-07-23.md +51 -0
  29. package/docs/roadmap.md +55 -0
  30. package/docs/writing-architecture.md +119 -0
  31. package/examples/comparison/README.md +38 -0
  32. package/examples/comparison/gen-ifc4.ts +133 -0
  33. package/examples/comparison/gen-ifcx.ts +134 -0
  34. package/examples/comparison/two-rooms.ifc +152 -0
  35. package/examples/comparison/two-rooms.ifcx +1030 -0
  36. package/examples/comparison/validate-ifc.ts +33 -0
  37. package/examples/house.muro +89 -0
  38. package/examples/mansion.muro +187 -0
  39. package/examples/office.muro +110 -0
  40. package/examples/two-rooms.canonical.json +111 -0
  41. package/examples/two-rooms.muro +22 -0
  42. package/package.json +33 -0
  43. package/spec/notation-v0.md +164 -0
  44. package/spec/vocabulary.md +62 -0
  45. package/src/check.ts +302 -0
  46. package/src/cli.ts +281 -0
  47. package/src/graph.ts +306 -0
  48. package/src/index.ts +8 -0
  49. package/src/light.ts +66 -0
  50. package/src/model.ts +367 -0
  51. package/src/parse.ts +512 -0
  52. package/src/plan.ts +334 -0
  53. package/src/site.ts +82 -0
  54. package/test/core.test.ts +171 -0
  55. package/test/design2.test.ts +97 -0
  56. package/test/house.test.ts +74 -0
  57. package/test/mansion.test.ts +99 -0
  58. package/test/office.test.ts +71 -0
  59. package/test/uncounted.test.ts +120 -0
  60. package/test/vertical.test.ts +75 -0
  61. package/tsconfig.json +13 -0
@@ -0,0 +1,55 @@
1
+ # koyu ロードマップ
2
+
3
+ 原稿 (writing-architecture.md) の「最初の一手と、その先」を行程に切ったもの。Linear の koyu プロジェクトのマイルストーンと対応する: https://linear.app/munipersonal/project/koyu-2789f588a03a/overview
4
+
5
+ これは探求であり、締切は設けない。各段の終わりにあるのは日付ではなく分水嶺の問いで、答えられたら次へ進む。
6
+
7
+ ## M0 素振り — 二室一扉 (2026-07-22 ひと通り)
8
+
9
+ IFCXのサンプルを読み (ifcx-notes.md)、二つの室とその間の扉一つを自分の記法で書いた。空間の同一性・境界の帰属・接続・パスの切り方はここで決まり (decisions/0001)、記法の書き比べと決定は spec/notation-v0.md に残した。最小ツール (パーサ・整合チェック・グラフ問合せ・平面SVG生成・正準JSON) が動き、テスト14本とCI設定がある。分水嶺の問い「数十行で四つの決定が言葉になるか」には、なった、と答えられる。残: IFC5 alphaビューアでのレイヤー合成の実見。
10
+
11
+ ## M1 一フロア〜複数フロア — 曖昧さへの正対 (2026-07-23 前半済)
12
+
13
+ 一住戸〜一フロア以上を書き、IfcSpaceが実務で機能しにくかった当の曖昧さに定義を与える段。位置づけをここで明確にした: **このデータの解像度は基本計画レベルである。** 垂れ壁や建具詳細を表現しないのは省略ではなく抽象度の選択であり、計画初期にBIMが重すぎるという既存の弱点の裏側こそがこの記述の主戦場になる。使い勝手の参照点はVectorworks的な軽さ。
14
+
15
+ 前半 (済): 2フロアのオフィス (廊下+複数室+コア) を約100行で記述。分節を「数える分節」(室・境界) と「数えない分節」(`area`=室内の床材切替等、`seg`=壁材の途中変更) に二分し、後者は面積・室数・グラフに影響しない隔離則を敷いた (ADR-0003)。通り芯オフセット (`X1+3200`)、複数レベル、高さ方向の一貫性 — BIMが3Dであることで暗黙に担保していたもの — を「宣言された不変量 (天井高+上階slab ≤ 階高) と自動チェック」に置き換えた (ADR-0002)。床は書かず垂直隣接は導出、例外 (`type:stair` / `type:shaft`) だけ宣言。`levels` コマンドがテキストの矩計。避難の問い「2階執務室から外へ扉4枚 (階段経由、EVは通れない)」に即答できる。
16
+
17
+ 後半 (進行中): 10階建て内廊下型集合住宅43戸 (1F共用部・2〜9F基準階・10F PH・屋上、EV1基+屋外階段) を159行で記述 (2026-07-23)。基準階の反復は「一度だけ書く」機構 — レベルの等差宣言・パスのスパン展開 (/L2..L9/A)・垂直積層のstack宣言 (ADR-0004) — が吸収し、159行が90空間・244境界・10フロアに展開される。屋外階段は半屋外の初出 (上階は手すり壁で外気に接し、地上階はopenで外部へ)。「9階の住戸から地上まで扉2枚 (玄関+階段防火戸)」に即答できる。
18
+
19
+ 続き (2026-07-23 後半): 間取り・L字・吹抜け・採光を一気に通した。Aタイプ住戸に間取り (L字LDK・洋室・水回り・玄関廊下) を書き、`zone` (数える集約 — 幾何なし・面積は配下の合計・use継承) で住戸の言葉を保った (ADR-0005)。吹抜けは `type:void` の垂直境界 = 高さ不変量の宣言的免除で、オフィスのエントランスを2層吹抜けに (ADR-0006)。例外階はスパン分割で新記法なしに書ける。`light` コマンドが住居系居室の1/7採光を粗く判定し、54㎡住戸の開口不足を実際に指摘した — 最初の法規クエリ。集合住宅は183行→114空間・316境界、テスト56本。
20
+
21
+ 続き2 (2026-07-23 深夜): 半屋外・語彙の台帳・開き勝手・メゾネット・部分吹抜けを通した。半屋外は宣言ではなく導出 — 外部に対しopenまたはair:1 (手すり等、遮蔽しない物) の境界を持つ空間 (ADR-0007。kindにrailを足す案はIFC参照で棄却: IfcRailingは要素であり、境界関係はPhysical/Virtualしか言わない)。属性の付け方は語彙の台帳 (spec/vocabulary.md) を契約に (ADR-0008)。開き勝手はhinge/swing。メゾネットは「パスの第一義は集計の階層」— level:属性で階を明示し、ゾーンが階を跨ぐ (examples/house.muro)。部分吹抜けは被覆率で不変量免除を制御 (ADR-0006追記)。Aタイプにバルコニー追加、採光はバルコニー越し0.7掛け。テスト63本。
22
+
23
+ 残: 外部の分節 (/outを地上・上空・道路側・隣地側に — 延焼ライン・斜線への足がかり)、屋根の有無 (半屋外の細分)、建具語彙 (開き戸/引き戸)。分水嶺: これらを書き切っても記法が破綻しないか — 現時点で破綻の兆候なし。
24
+
25
+ ## M1.5 直交からの最初の逸脱 — 斜め (判断: 見送り)
26
+
27
+ 2026-07-23 判断: 雁行・セットバック・コアの振れといった「斜めに見える大半」は矩形の合併とオフセットで書ける。真の非直交は、共有辺・外周・重なりを支える矩形の区間代数を多角形クリッピングに全面書き換えることを意味し、「簡単なら」の範囲を超える。曲線と同じ「扱わないこと」側に寄せ、実案件の平面が矩形合併で書けなくなった時に多角形領域として一括で設計する。
28
+
29
+ ## M2 一棟 — グラフへの問い
30
+
31
+ 一棟を書き、グラフに問いを投げる。この室からこの室まで扉をいくつ通るか、防火区画をまたがずに外へ出られるか、共用と専有の面積比はいくつか。**部材のモデルなら抽出作業が要る問いに、何もせず答えられるかどうかが、オントロジーとしての分水嶺** (原稿)。避難・面積・区画・動線が同じ記述の異なる読み方になることを確かめる。
32
+
33
+ ## M3 平面図 — 実務の言語への翻訳
34
+
35
+ 素描 (M0のSVG) を図面に近づける。寸法線、通り芯記号、建具の作図表現、縮尺。平面図が生成できれば人に見せられ、実務の言語に翻訳できる。生成が一意でないこと (同じ構成から複数の形が出ること) をここで実際に確かめる。
36
+
37
+ ## M4 版管理とレビュー
38
+
39
+ テキストであることの帰結を回収する。差分を「この室が広がった」という構成の言葉で表示するdiffツール、Pull Requestによる設計レビューの試行、コミットごとに整合と法則を確かめるCI (芽は .github/workflows/ci.yml と `koyu check` にある)。
40
+
41
+ ## M5 IFC取り込み — コーパスの獲得
42
+
43
+ 一方向・非可逆のIFC→koyu変換を書く。往復互換は最初から捨てる。BIM/IFC系のツールはThatOpenのOSS (web-ifc, @thatopen/components) を使う。コーパスの最初の候補は手元の IFC_samples/ にあるBLCJサンプル (RC造3000㎡・S造1000㎡)。IfcSpaceが書き出されていないモデルから空間をどう復元するかが、おそらく本当の難所。参照リポジトリをクローンする場合は ~/Documents/github に置く。
44
+
45
+ ## 横断: IFCカバレッジの運用 (2026-07-23〜)
46
+
47
+ IFC4建築系コアを鏡にして、書けるもの・まだ書けないもの・方針として書かないものを [docs/ifc-coverage.md](ifc-coverage.md) で管理する。未対応 (○)・部分対応 (◐) はLinearの別プロジェクト [koyu × IFC カバレッジ](https://linear.app/munipersonal/project/koyu-ifc-カバレッジ-c97cdb2fdc18) のIssue (概念クラスタ単位、15件) と対応。実装や決定が動いたら表を先に直し、Issueを閉じる。当面の優先はP2の4件: 敷地とその境界 (MUN-149 ✔ 2026-07-23済)、外部空間の分節 (MUN-150 ✔ 同)、外構 (MUN-151)、立ち上がり・パラペット (MUN-152)。149/150はADR-0009 — /outの分節 (road:幅員)、地上外部空間のタイル、zone site:1の宣言/導出照合、`site`コマンド (敷地面積・接道・建蔽率・容積率)。戸建例のL1平面は配置図兼用になった。
48
+
49
+ ## 地平 (マイルストーンにしない遠景)
50
+
51
+ デジタルツイン (実測を設計の上に重ねる一枚のレイヤー)、都市 (数百行の軽さでCityGML・歩行空間ネットワーク・不動産IDと同じ層に載る)、フィジカルAI (空間グラフ+通行可能性+意味がそのまま行動の地図になる)。いずれも原稿の「地平」の節が原典。M2のグラフが答えられるようになったとき、最初の接続実験を選ぶ。
52
+
53
+ ## 扱わないこと (再掲)
54
+
55
+ オーサリングツールは作らない。往復互換は捨てる。曲面と自由形状は対象外。設計意図の記録はデータではなくプロンプトの側。事業化は当面目的にしない。
@@ -0,0 +1,119 @@
1
+ # 建築を書く
2
+
3
+ ## 主張
4
+
5
+ 建築が扱っているのは、壁や床や天井そのものではなく、それらが生み出す空間です。ところが建築のデータは、図面からCAD、BIMに至るまで、一貫して「建てるべき物」の記述であり続けてきました。物のデータは繰り返しデジタル化されましたが、建築そのもの、すなわち空間の構成は、いまだに機械可読になっていません。
6
+
7
+ 本稿の提案は、空間を一次要素とするテキストを建築の原本とし、形はそこから必要に応じて生成する、という転回です。これはBIMの改良ではありません。記述する対象を、建築物から建築へ取り替えることです。対象が替わると、建物一棟のデータは数百行に縮みます。そして履歴の管理、設計のレビュー、法規の検証、デジタルツイン、都市との接続が、別々に取り組むべき課題ではなく、同じ一つの土台から自然に導かれる帰結になります。
8
+
9
+ ## 前提と用語
10
+
11
+ BIM(Building Information Modeling)は、建物の三次元形状と属性情報を一体で扱う手法です。実務ではRevitやArchicadといったオーサリングツール(設計者がモデルを作成するソフトウェア)が中心にあり、モデルの実体は各ツールの独自データベースの中にあります。
12
+
13
+ IFC(Industry Foundation Classes)はbuildingSMARTが策定する交換用のオープン標準です。標準的なシリアライズ形式(SPF)は行番号でエンティティを相互参照するため、モデルを書き出し直すだけでファイル全体の差分が壊れます。現在開発中の次世代規格IFC5は、IFCXという形式でJSONを採用し、後述するOpenUSDと概念を共有します。
14
+
15
+ IfcSpaceは、IFCにおいて室や領域を表すエンティティです。規格上は存在しますが、多くの現場では部材が囲んだ結果として導かれる二次的な情報として扱われ、書き出されないことも珍しくありません。
16
+
17
+ OpenUSDは、もともと映像制作のために作られたシーン記述の枠組みで、composition(合成)と呼ばれる仕組みを中核に持ちます。複数のレイヤーを重ね、上のレイヤーが下のレイヤーの値を非破壊的に上書きする。現在のIFCに相当する概念はありません。
18
+
19
+ オントロジーは、ある領域に何が存在し、それらがどういう関係にあるかを形式的に定義したものです。本稿の主題は、建築において何を「存在するもの」として数えるか、という問いそのものです。
20
+
21
+ なお日本語は、建築と建築物を区別します。建築物は建築基準法上のカテゴリであり、物としての対象です。IFCもCityGMLも、規格の名が示すとおり(IfcBuilding)、この側のオントロジーです。建築の側、すなわち空間の分節・接続・序列は、そこに含まれていません。
22
+
23
+ ## 問題設定 — 表現が原本になった
24
+
25
+ 平面図は、本来は構成の記述です。線と記号が空間の切り方と繋がり方を伝え、読み手は頭の中で空間を再構成します。図面の内容とは、この「読み」のことでした。
26
+
27
+ デジタル化の歴史は、この読みを一度も捉えていません。CADは図面の線を捉えましたが、意味は紙の時代と同じく読み手の頭に残りました。BIMは意味を持たせましたが、意味を取り付けた先は三次元の部材ソリッドでした。空間は、部材が囲んだ結果として後から導くものになりました。IfcSpaceが規格に存在しながら実務で二級市民であり続けているのは、この順序の帰結です。三十年かけて、物の表現ばかりが精緻になり、読みは誰もデジタル化していません。
28
+
29
+ 形を原本にしたことの症状は、三つの形で現れています。第一に、データがツールに閉じます。原本がオーサリングツールの独自データベースにある限り、モデルにできることはそのツールのUIとAPIが許す範囲に限られます。第二に、版が管理できません。差分が壊れる形式の上では、どのファイルを最新とみなすかという人の運用でしか版を扱えず、実務のCDE(共通データ環境)も突き詰めればその運用の器です。第三に、外の世界と繋がりません。オントロジーも、デジタルツインも、都市データも、必要としているのは空間とトポロジーと意味であって、ソリッドではありません。部材の集合からそれらを毎回抽出し直すことが、接続のたびに個別の統合作業を発生させています。
30
+
31
+ ここでIFC5に触れておく必要があります。IFCXはテキスト(JSON)を採り、compositionを持ちます。形式の問題は、標準の側で解かれつつあります。しかしその形式が運ぶ中身は、依然として建築物のオントロジーです。形式の刷新は、対象の取り替えではありません。空いているのはこちら側です。
32
+
33
+ ## 転回 — 空間が一次、壁は境界
34
+
35
+ データの一次要素を空間にします。室、ゾーン、外部の領域。壁はそれ自体が独立した物ではなく、二つの空間の境界という関係として持ちます。開口は境界に開いた接続です。
36
+
37
+ こうすると建築のデータは自然にグラフになります。節点が空間、辺が接続。境界には厚み・仕様・耐火や遮音といった性能が属性として乗ります。骨格はグリッドとレベルが与え、各要素は人間の読める階層パスで名指されます。設計で問われる「この室とこの室は繋がっているか」「この境界は耐火か」「ここからここまで扉をいくつ通るか」が、変換なしにそのまgraphへの問いになります。
38
+
39
+ 構成のほとんどは二次元で決まります。平面の割り付け、隣接、動線。そこにレベルと高さ、吹抜けや階をまたぐ関係といった空間方向の記述が乗る。これで直交グリッドの建物は決まります。重要なのは、これが新しい抽象化ではないことです。図面が数百年運んできた抽象度そのものを、紙から機械可読なテキストへ移すだけです。実務の成果物が今なお図面であり、確認申請が図面で行われているのは、建築の決定がこの抽象度でなされているからです。
40
+
41
+ 意味の与え方は、巨大なクラス階層ではなく語彙にします。数十のコア型と、開かれた語彙。拡張はスキーマ改訂ではなく語彙の追加で済ませます。これがCityGML、不動産ID、センサ、ネットワークデータと接続する際の受け口になります。
42
+
43
+ OpenUSDからは機構だけを借ります。パス名前空間を背骨にし、レイヤーを非破壊的に重ねる。意匠・構造・設備の統合も、設計案の分岐も、竣工後の実測との突き合わせも、すべて「レイヤーを重ねる」という同じ操作になります。
44
+
45
+ ## ジオメトリは生成物
46
+
47
+ ソースに形は持ちません。三次元は、必要になった時にルールベースで生成します。順序としては、まず平面図、その後に三次元です。
48
+
49
+ ここが最大の分岐点です。IFCが重く、差分が読めないのは、ビルド成果物を原本として配っているからです。ソースと成果物を分ければ、テキストは劇的に短くなり、差分は座標の羅列ではなく「この室が広がった」という言葉になります。
50
+
51
+ 生成は一意ではありません。同じ構成から複数の形が出ます。それは欠陥ではなく、これが導出ではなく生成だということの表れです。構成が同じなら、形の違いは建築の同一性を損ないません。
52
+
53
+ 設計基準はひとつに固定します。LLMが一つのコンテキストで読み切り、正しく部分編集できるか。この基準から、テキストネイティブであること、参照が人間の読める階層パスであること、単一の巨大ファイルではなく小さなファイルの集合であること、単位と座標系を先頭で一度だけ宣言することが、すべて決まります。
54
+
55
+ ## なぜ今か
56
+
57
+ この着想自体は新しくありません。USDが建築の視野に入った頃から、同じ方向は見えていました。しかし当時は、テキストであることの価値の半分が空手形でした。テキストを読み書きする主体が人間しかいなかったからです。
58
+
59
+ いまは条件が三つ揃っています。第一に、LLMがテキストの読み手であり書き手になりました。数百行の建築は一つのコンテキストに収まり、エージェントは構成を直接編集できます。第二に、エージェントコーディングが道具の値段を変えました。パーサ、生成器、ビューア、diffツールといった周辺一式が、個人の余暇で作れる規模になりました。第三に、標準の側が方向を検証してくれています。IFC5とOpenUSDの合流は、テキストとcompositionという選択が正しいことの傍証です。ただし前述のとおり、彼らが取り替えないもの、すなわち記述の対象こそが、ここでの主題です。
60
+
61
+ ## 地平
62
+
63
+ ### 版管理、そしてプロジェクトマネジメント
64
+
65
+ 建築がテキストになると、gitがそのまま効きます。履歴、ブランチ、マージ。設計レビューはPull Requestになり、差分は構成の言葉で読めます。整合性や法規のチェックは、コミットのたびに自動で回るCIになります。
66
+
67
+ その先にあるのがプロジェクトマネジメントの変化です。現在の建築プロジェクトの情報管理は、ファイル名と日付と人の運用でできています。版がデータの側に入ると、誰がいつ何を変えたかは自明になり、変更の承認はマージになり、設計案の比較はブランチの比較になります。管理のために存在していた作業の大半が、データの性質に吸収されます。
68
+
69
+ ### デジタルツイン
70
+
71
+ センサも人流もBEMSも、測っているのは空間の状態であって、壁の状態ではありません。空間が一次要素であれば、実測は別システムではなく、設計の上に重ねる一枚のレイヤーになります。竣工は履歴の終わりではなく続きになり、維持管理も改修も同じ履歴の上を流れます。
72
+
73
+ ### 都市
74
+
75
+ 建物が数百行の軽いデータになると、都市スケールに載ります。三次元ソリッドは重すぎて載りませんが、空間と接続と意味なら載る。CityGML、歩行空間ネットワーク、不動産IDと同じ層で扱え、建物の内と外を貫く一貫したシミュレーションが、この軽さの上で初めて現実的になります。
76
+
77
+ ### フィジカルAI
78
+
79
+ ロボットや身体を持つエージェントが屋内で行動するために必要なのは、壁のソリッドではなく、空間のグラフと通行可能性と意味です。どこが部屋で、どこを通れて、どこが立入禁止か。空間を一次要素とする建築のデータは、そのまま行動の地図になります。建築とフィジカルAIの接続に、変換層は要らなくなります。
80
+
81
+ ## 難所
82
+
83
+ 構造と設備は、空間ではなく物が主役です。柱、梁、ダクト、盤。空間を一次にしたモデルは意匠と計画の側に強く、構造と設備は物を持つ別のレイヤーとして重ねることになります。空間だけで建築のすべてが表現できるとは考えません。
84
+
85
+ 空間の境界が曖昧な場所も残ります。吹抜け、半屋外、外部空間。IfcSpaceが実務で機能しにくい理由の一つもここにあり、この定義は逃げずに決めるべき設計判断です。
86
+
87
+ 粒度も自明ではありません。室で切るのか、ゾーンで切るのか、両方を持つのか。決めなければ動きません。
88
+
89
+ ## 扱わないこと
90
+
91
+ オーサリングツールは作りません。形を作る機能で既存ツールと競うことに意味はなく、この主張はデータの側にあります。
92
+
93
+ 往復互換は捨てます。IFCが肥大化したのは、どのツールが吐いたものも失わずに戻せることを要求されたからです。ただし一方向・非可逆のIFC取り込みは書きます。データのない形式はただの構文だからです。
94
+
95
+ 曲面と自由形状は対象外です。直交グリッドで足りる建物に絞ります。
96
+
97
+ 設計意図の記録は中心に置きません。なぜその寸法にしたかという判断の理由は、エージェントとの対話、すなわちプロンプトの側に属します。データが持つのは構成と意味です。
98
+
99
+ 事業化も当面の目的にしません。これは探求です。
100
+
101
+ ## 最初の一手と、その先
102
+
103
+ 手を動かす範囲は小さくて構いません。
104
+
105
+ IFC5のalphaとして公開されているIFCXのサンプルを読み、ビューアで見ます。乗るためではなく、テキストとcompositionという同じ道具立てで他人がこの問題をどう解いたかを見るためです。そのうえで、二つの室とその間の扉一つだけを、自分の記法で書いてみます。建物ですらありません。それでも、空間の同一性をどう与えるか、境界をどちらの空間に属させるか、接続をどう表すか、パスをどう切るかが、この数十行で全部決まります。記法はここで生まれます。
106
+
107
+ その先は段階として見えています。一フロアを書けば、吹抜けや半屋外や粒度という曖昧さに正面からぶつかります。一棟を書けば、グラフに問いを投げられるようになります。この室からこの室まで扉をいくつ通るか、防火区画をまたがずに外へ出られるか、共用と専有の面積比はいくつか。部材のモデルなら抽出作業が要る問いに、何もせず答えられるかどうかが、オントロジーとしての分水嶺です。答えられれば、避難も面積も区画も動線も、同じ記述の異なる読み方になります。平面図が生成できれば、実務の言語に翻訳でき、人に見せられるようになります。版管理は、テキストであることの帰結としてほぼ自動で付いてきます。IFCの取り込みは、コーパスを得るためにこの途中のどこかで行います。都市との接続とフィジカルAIは、その向こうです。
108
+
109
+ 見えてくるはずのことは一つです。建物一棟が、数百行で書けてしまう。建築は思っているより小さい。その感触が出れば、この主張は伝わります。
110
+
111
+ ## 参照
112
+
113
+ - buildingSMART / IFC5-development: https://github.com/buildingSMART/IFC5-development/
114
+ - IFC5 alpha ビューア: https://ifc5.technical.buildingsmart.org/viewer/
115
+ - IfcOpenShell のバージョン管理に関する議論(OSArch): https://community.osarch.org/discussion/3386/addressing-some-core-ifcopenshell-issues
116
+
117
+ ---
118
+
119
+ 著者: Ken Shinozaki。本文書は [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.ja) で提供します。この主張の実装が koyu ([README](../README.md)) です。
@@ -0,0 +1,38 @@
1
+ # 同じ二室一扉を三つの世界で書く
2
+
3
+ examples/two-rooms.muro と同じ場面 — 3.6m×4.5mの室二つ、界壁の扉、玄関 — を、IFC4 (SPF) と IFCX (IFC5 alpha) でも作った。記述の対象を「建築物 (物)」から「建築 (空間)」に取り替えると何が起きるかを、行数とバイト数と答えられる問いで見るための比較である。
4
+
5
+ | 形式 | 主語 | 行数 | サイズ |
6
+ |---|---|---|---|
7
+ | koyu DSL (原本) | 空間と境界 | 22 | 0.6 KB |
8
+ | koyu 正準JSON (機械形式) | 同上 | 111 | 1.6 KB |
9
+ | IFC4 手書き最小 (two-rooms.ifc) | 部材 | 152 | 7.3 KB |
10
+ | IFCX alpha (two-rooms.ifcx) | 部材 + メッシュ同梱 | 1,031 | 20 KB |
11
+
12
+ 参考として、IFC5-development の hello-wall は壁1枚+窓2つの場面で .ifc が79KB、.ifcx が43KBある (オーサリングツール経由の現実的な出力)。BLCJ級の実務モデルなら数十MBになる。
13
+
14
+ ## IFC4版で起きること (two-rooms.ifc)
15
+
16
+ 152行は徹底的にごまかした理想化最小である。プロパティセット・材料・スタイル・OwnerHistory・接合処理を全部落とし、形状は矩形押し出しのみ、名前はASCIIのみ。それでもこの量になるのは、壁5枚・開口2・扉2をそれぞれ物として置き、プロファイル→押し出し→形状表現→配置の階段を要素ごとに登る必要があるからだ。空間はIfcSpaceとして2つ入れ、IfcRelSpaceBoundaryを8本手で張ったが、境界の接続ジオメトリは省略した — 実務の書き出しで最も欠落しやすいのがまさにここで、IfcSpace自体が書き出されないことも珍しくない。
17
+
18
+ 「aから外へ扉をいくつ通るか」に答えるには、Space→RelSpaceBoundary→Wall→RelVoids→Opening→RelFills→Door と5段の関係を辿った上で、なお「その扉がどの空間とどの空間を繋ぐか」はデータに無いため幾何から推定することになる。koyuでは `npm run koyu -- doors examples/two-rooms.muro /L1/a /out` が即答する (2枚)。
19
+
20
+ 検証は ThatOpen の web-ifc で行った (`npx tsx examples/comparison/validate-ifc.ts examples/comparison/two-rooms.ifc`)。IfcWall×5 / IfcSpace×2 / IfcDoor×2 / IfcOpeningElement×2 / IfcRelSpaceBoundary×8 が読め、ブーリアン込みで7つのメッシュが組み上がる。
21
+
22
+ ## IFCX版で起きること (two-rooms.ifcx)
23
+
24
+ hello-wall.ifcx の流儀 (UUIDパス、childrenによる階層、bsi::ifc::classによる分類、usd::usdgeom::meshの同梱) に倣って生成した。1,031行のうち72%がメッシュ座標である。形式はJSONになり、レイヤー合成という強力な機構を得たが (hello-wallでは631バイトの差分レイヤーで耐火性能を足せる)、場面の原本がビルド成果物 (メッシュ) を抱えて肥大する構造は変わらない。主語も依然IfcWallだ。なお開口のブーリアンは省略し扉を壁の子の箱として置いた近似であり、alpha仕様への厳密な準拠は保証しない。https://ifc5.technical.buildingsmart.org/viewer/ にドロップすれば見られるはずである。
25
+
26
+ ## 読み取るべきこと
27
+
28
+ 同じ場面の情報量の桁が 0.6KB / 7.3KB / 20KB と並ぶのは、形式の巧拙ではなく主語の違いによる。IFC4もIFCXも形が原本なので任意の形状を運べるが、構成 (どの空間がどう繋がるか) は関係の網から掘り出すか幾何から推定するしかない。koyuは構成が原本なのでグラフへの問いとdiffと生成が無料になるが、形は直交グリッドの生成規則が届く範囲しか出せない。これは対称なトレードオフではない — 設計の決定は構成の側でなされ、形は決定の帰結だからだ、というのがこの探求の賭けである (docs/writing-architecture.md)。
29
+
30
+ ## 再現
31
+
32
+ ```sh
33
+ npx tsx examples/comparison/gen-ifc4.ts > examples/comparison/two-rooms.ifc
34
+ npx tsx examples/comparison/gen-ifcx.ts > examples/comparison/two-rooms.ifcx
35
+ npx tsx examples/comparison/validate-ifc.ts examples/comparison/two-rooms.ifc
36
+ ```
37
+
38
+ UUIDとGUIDは名前から決定的に導いているので、生成し直しても差分は出ない。
@@ -0,0 +1,133 @@
1
+ // 二室一扉を「最小の手書き相当」IFC4 (SPF) として生成する。
2
+ // 比較のための理想化であり実務品質ではない: プロパティセット・材料・スタイル・
3
+ // 接合処理・OwnerHistoryを持たず、形状は矩形押し出しのみ。実務のBIMツール出力は
4
+ // これの1〜2桁上の量になる (hello-wall.ifc は壁1枚+窓2つで79KB)。
5
+ // 実行: npx tsx examples/comparison/gen-ifc4.ts > examples/comparison/two-rooms.ifc
6
+
7
+ import { createHash } from "node:crypto";
8
+
9
+ const lines: string[] = [];
10
+ let n = 0;
11
+ function e(text: string): string {
12
+ n++;
13
+ lines.push(`#${n}=${text};`);
14
+ return `#${n}`;
15
+ }
16
+ function fmt(v: number): string {
17
+ return Number.isInteger(v) ? `${v}.` : `${v}`;
18
+ }
19
+
20
+ // IFC GUID (22文字, base64風)。名前から決定的に作る
21
+ const ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_$";
22
+ function guid(name: string): string {
23
+ const h = createHash("md5").update(`koyu:${name}`).digest();
24
+ let out = ALPHABET[h[0]! % 4]!;
25
+ for (let i = 1; i < 22; i++) out += ALPHABET[h[i % 16]! * (i + 7) % 64]!;
26
+ return out;
27
+ }
28
+
29
+ // ---- 基盤 ----
30
+ const origin3 = e("IFCCARTESIANPOINT((0.,0.,0.))");
31
+ const dirZ = e("IFCDIRECTION((0.,0.,1.))");
32
+ const axis0 = e(`IFCAXIS2PLACEMENT3D(${origin3},$,$)`);
33
+ const ctx = e(`IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,1.0E-5,${axis0},$)`);
34
+ const uLen = e("IFCSIUNIT(*,.LENGTHUNIT.,.MILLI.,.METRE.)");
35
+ const uArea = e("IFCSIUNIT(*,.AREAUNIT.,$,.SQUARE_METRE.)");
36
+ const uVol = e("IFCSIUNIT(*,.VOLUMEUNIT.,$,.CUBIC_METRE.)");
37
+ const uAng = e("IFCSIUNIT(*,.PLANEANGLEUNIT.,$,.RADIAN.)");
38
+ const units = e(`IFCUNITASSIGNMENT((${uLen},${uArea},${uVol},${uAng}))`);
39
+ const project = e(`IFCPROJECT('${guid("project")}',$,'Two rooms one door',$,$,$,$,(${ctx}),${units})`);
40
+
41
+ const lpSite = e(`IFCLOCALPLACEMENT($,${axis0})`);
42
+ const lpBldg = e(`IFCLOCALPLACEMENT(${lpSite},${axis0})`);
43
+ const lpStorey = e(`IFCLOCALPLACEMENT(${lpBldg},${axis0})`);
44
+ const site = e(`IFCSITE('${guid("site")}',$,'Site',$,$,${lpSite},$,$,.ELEMENT.,$,$,$,$,$)`);
45
+ const bldg = e(`IFCBUILDING('${guid("building")}',$,'Building',$,$,${lpBldg},$,$,.ELEMENT.,$,$,$)`);
46
+ const storey = e(`IFCBUILDINGSTOREY('${guid("storey")}',$,'L1',$,$,${lpStorey},$,$,.ELEMENT.,0.)`);
47
+ e(`IFCRELAGGREGATES('${guid("rel-p-s")}',$,$,$,${project},(${site}))`);
48
+ e(`IFCRELAGGREGATES('${guid("rel-s-b")}',$,$,$,${site},(${bldg}))`);
49
+ e(`IFCRELAGGREGATES('${guid("rel-b-st")}',$,$,$,${bldg},(${storey}))`);
50
+
51
+ // ---- 矩形押し出しの箱 ----
52
+ function box(cx: number, cy: number, xdim: number, ydim: number, z1: number, depth: number): string {
53
+ const p2 = e(`IFCCARTESIANPOINT((${fmt(cx)},${fmt(cy)}))`);
54
+ const ax2 = e(`IFCAXIS2PLACEMENT2D(${p2},$)`);
55
+ const prof = e(`IFCRECTANGLEPROFILEDEF(.AREA.,$,${ax2},${fmt(xdim)},${fmt(ydim)})`);
56
+ const p3 = e(`IFCCARTESIANPOINT((0.,0.,${fmt(z1)}))`);
57
+ const pos = e(`IFCAXIS2PLACEMENT3D(${p3},$,$)`);
58
+ const solid = e(`IFCEXTRUDEDAREASOLID(${prof},${pos},${dirZ},${fmt(depth)})`);
59
+ const shape = e(`IFCSHAPEREPRESENTATION(${ctx},'Body','SweptSolid',(${solid}))`);
60
+ return e(`IFCPRODUCTDEFINITIONSHAPE($,$,(${shape}))`);
61
+ }
62
+ function lp(): string {
63
+ return e(`IFCLOCALPLACEMENT(${lpStorey},${axis0})`);
64
+ }
65
+
66
+ // ---- 壁 5枚 (壁芯は koyu の grid と同じ。外周150, 界壁120, 高さ2400) ----
67
+ const H = 2400;
68
+ function wall(name: string, cx: number, cy: number, xd: number, yd: number): string {
69
+ return e(`IFCWALL('${guid(name)}',$,'${name}',$,$,${lp()},${box(cx, cy, xd, yd, 0, H)},$,$)`);
70
+ }
71
+ const wN = wall("W_N", 3600, 4500, 7350, 150);
72
+ const wS = wall("W_S", 3600, 0, 7350, 150);
73
+ const wW = wall("W_W", 0, 2250, 150, 4350);
74
+ const wE = wall("W_E", 7200, 2250, 150, 4350);
75
+ const wP = wall("W_P", 3600, 2250, 120, 4350);
76
+
77
+ // ---- 開口 2つと扉 2枚 ----
78
+ function opening(name: string, cx: number, cy: number, xd: number, yd: number, h: number): string {
79
+ return e(
80
+ `IFCOPENINGELEMENT('${guid(name)}',$,'${name}',$,$,${lp()},${box(cx, cy, xd, yd, 0, h)},$,.OPENING.)`,
81
+ );
82
+ }
83
+ function door(name: string, cx: number, cy: number, xd: number, yd: number, h: number, w: number): string {
84
+ return e(
85
+ `IFCDOOR('${guid(name)}',$,'${name}',$,$,${lp()},${box(cx, cy, xd, yd, 0, h)},$,${fmt(h)},${fmt(w)},$,$,$)`,
86
+ );
87
+ }
88
+ const o1 = opening("O_1", 3600, 2250, 130, 780, 2000); // 界壁の開口
89
+ const d1 = door("D_1", 3600, 2250, 60, 780, 2000, 780);
90
+ e(`IFCRELVOIDSELEMENT('${guid("void-1")}',$,$,$,${wP},${o1})`);
91
+ e(`IFCRELFILLSELEMENT('${guid("fill-1")}',$,$,$,${o1},${d1})`);
92
+ const o2 = opening("O_2", 5400, 0, 900, 160, 2100); // 玄関の開口
93
+ const d2 = door("D_2", 5400, 0, 900, 60, 2100, 900);
94
+ e(`IFCRELVOIDSELEMENT('${guid("void-2")}',$,$,$,${wS},${o2})`);
95
+ e(`IFCRELFILLSELEMENT('${guid("fill-2")}',$,$,$,${o2},${d2})`);
96
+
97
+ // ---- 空間 2つ (IFCでは部材と同格の一要素。書き出されない現場も多い) ----
98
+ function space(name: string, long: string, cx: number): string {
99
+ return e(
100
+ `IFCSPACE('${guid(name)}',$,'${name}',$,$,${lp()},${box(cx, 2250, 3600, 4500, 0, H)},'${long}',.ELEMENT.,.SPACE.,$)`,
101
+ );
102
+ }
103
+ const spA = space("a", "Room A", 1800);
104
+ const spB = space("b", "Room B", 5400);
105
+ e(`IFCRELAGGREGATES('${guid("rel-st-sp")}',$,$,$,${storey},(${spA},${spB}))`);
106
+ e(
107
+ `IFCRELCONTAINEDINSPATIALSTRUCTURE('${guid("rel-cont")}',$,$,$,(${wN},${wS},${wW},${wE},${wP},${d1},${d2}),${storey})`,
108
+ );
109
+
110
+ // ---- 空間境界 8本 (接続ジオメトリは省略。実務ではここが最も欠落しやすい) ----
111
+ const sb: Array<[string, string, string, string]> = [
112
+ ["sb-a-n", spA, wN, ".EXTERNAL."],
113
+ ["sb-a-s", spA, wS, ".EXTERNAL."],
114
+ ["sb-a-w", spA, wW, ".EXTERNAL."],
115
+ ["sb-a-p", spA, wP, ".INTERNAL."],
116
+ ["sb-b-n", spB, wN, ".EXTERNAL."],
117
+ ["sb-b-s", spB, wS, ".EXTERNAL."],
118
+ ["sb-b-e", spB, wE, ".EXTERNAL."],
119
+ ["sb-b-p", spB, wP, ".INTERNAL."],
120
+ ];
121
+ for (const [name, sp, el, flag] of sb) {
122
+ e(`IFCRELSPACEBOUNDARY('${guid(name)}',$,$,$,${sp},${el},$,.PHYSICAL.,${flag})`);
123
+ }
124
+
125
+ // ---- 出力 ----
126
+ const header = `ISO-10303-21;
127
+ HEADER;
128
+ FILE_DESCRIPTION(('ViewDefinition [CoordinationView]'),'2;1');
129
+ FILE_NAME('two-rooms.ifc','2026-07-22T00:00:00',('ken'),('koyu'),'koyu gen-ifc4','koyu gen-ifc4','');
130
+ FILE_SCHEMA(('IFC4'));
131
+ ENDSEC;
132
+ DATA;`;
133
+ process.stdout.write(header + "\n" + lines.join("\n") + "\nENDSEC;\nEND-ISO-10303-21;\n");
@@ -0,0 +1,134 @@
1
+ // 二室一扉を IFCX (IFC5 alpha) として生成する。
2
+ // buildingSMART/IFC5-development の hello-wall.ifcx の流儀に倣う:
3
+ // UUIDパス + children による階層、usd::usdgeom::mesh によるメッシュ同梱、
4
+ // bsi::ifc::class による分類。開口のブーリアンは省略し (hello-wallではType側の
5
+ // Voidで表現される)、扉は壁の子の箱として置いた理想化である点に注意。
6
+ // 実行: npx tsx examples/comparison/gen-ifcx.ts > examples/comparison/two-rooms.ifcx
7
+
8
+ import { createHash } from "node:crypto";
9
+
10
+ function uuid(name: string): string {
11
+ const h = createHash("md5").update(`koyu:${name}`).digest("hex");
12
+ return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20, 32)}`;
13
+ }
14
+
15
+ /** 直方体メッシュ (単位: m)。8頂点・12三角形 */
16
+ function boxMesh(x1: number, y1: number, z1: number, x2: number, y2: number, z2: number) {
17
+ const m = (v: number) => v / 1000;
18
+ const p = [
19
+ [m(x1), m(y1), m(z1)], [m(x2), m(y1), m(z1)], [m(x2), m(y2), m(z1)], [m(x1), m(y2), m(z1)],
20
+ [m(x1), m(y1), m(z2)], [m(x2), m(y1), m(z2)], [m(x2), m(y2), m(z2)], [m(x1), m(y2), m(z2)],
21
+ ];
22
+ const f = [
23
+ 0, 2, 1, 0, 3, 2, // 底
24
+ 4, 5, 6, 4, 6, 7, // 天
25
+ 0, 1, 5, 0, 5, 4,
26
+ 1, 2, 6, 1, 6, 5,
27
+ 2, 3, 7, 2, 7, 6,
28
+ 3, 0, 4, 3, 4, 7,
29
+ ];
30
+ return { faceVertexIndices: f, points: p };
31
+ }
32
+
33
+ type Node = {
34
+ path: string;
35
+ children?: Record<string, string>;
36
+ inherits?: Record<string, string>;
37
+ attributes?: Record<string, unknown>;
38
+ };
39
+ const data: Node[] = [];
40
+
41
+ function cls(code: string) {
42
+ return {
43
+ "bsi::ifc::class": {
44
+ code,
45
+ uri: `https://identifier.buildingsmart.org/uri/buildingsmart/ifc/4.3/class/${code}`,
46
+ },
47
+ };
48
+ }
49
+
50
+ /** 要素 = クラス属性 + Bodyメッシュ子 (+さらに子要素) */
51
+ function element(
52
+ name: string,
53
+ code: string,
54
+ mesh: ReturnType<typeof boxMesh>,
55
+ color: [number, number, number],
56
+ extraChildren: Record<string, string> = {},
57
+ ): string {
58
+ const id = uuid(name);
59
+ const bodyId = uuid(`${name}/Body`);
60
+ data.push({
61
+ path: id,
62
+ children: { Body: bodyId, ...extraChildren },
63
+ attributes: cls(code),
64
+ });
65
+ data.push({
66
+ path: bodyId,
67
+ attributes: {
68
+ "usd::usdgeom::mesh": mesh,
69
+ "bsi::ifc::presentation::diffuseColor": color,
70
+ "bsi::ifc::presentation::opacity": code === "IfcSpace" ? 0.3 : 1,
71
+ },
72
+ });
73
+ return id;
74
+ }
75
+
76
+ const GRAY: [number, number, number] = [0.55, 0.55, 0.55];
77
+ const WOOD: [number, number, number] = [0.72, 0.55, 0.35];
78
+ const AIR: [number, number, number] = [0.85, 0.9, 1.0];
79
+ const H = 2400;
80
+
81
+ // 扉 (壁の子)
82
+ const d1 = element("Door_1", "IfcDoor", boxMesh(3570, 1860, 0, 3630, 2640, 2000), WOOD);
83
+ const d2 = element("Door_2", "IfcDoor", boxMesh(4950, -30, 0, 5850, 30, 2100), WOOD);
84
+
85
+ // 壁 5枚 (壁芯はkoyuのgridと同じ。外周150・界壁120)
86
+ const wN = element("Wall_N", "IfcWall", boxMesh(-75, 4425, 0, 7275, 4575, H), GRAY);
87
+ const wS = element("Wall_S", "IfcWall", boxMesh(-75, -75, 0, 7275, 75, H), GRAY, { Door_2: d2 });
88
+ const wW = element("Wall_W", "IfcWall", boxMesh(-75, 75, 0, 75, 4425, H), GRAY);
89
+ const wE = element("Wall_E", "IfcWall", boxMesh(7125, 75, 0, 7275, 4425, H), GRAY);
90
+ const wP = element("Wall_P", "IfcWall", boxMesh(3540, 75, 0, 3660, 4425, H), GRAY, { Door_1: d1 });
91
+
92
+ // 空間 2つ
93
+ const spA = element("Space_a", "IfcSpace", boxMesh(0, 0, 0, 3600, 4500, H), AIR);
94
+ const spB = element("Space_b", "IfcSpace", boxMesh(3600, 0, 0, 7200, 4500, H), AIR);
95
+
96
+ // 階層 (hello-wallと同じく root → Project → Site → Building → Storey → 要素)
97
+ const storey = uuid("storey");
98
+ data.unshift(
99
+ { path: uuid("root"), children: { Two_Rooms_Project: uuid("project") } },
100
+ { path: uuid("project"), children: { Site: uuid("site") }, attributes: cls("IfcProject") },
101
+ { path: uuid("site"), children: { Building: uuid("building") }, attributes: cls("IfcSite") },
102
+ { path: uuid("building"), children: { L1: storey }, attributes: cls("IfcBuilding") },
103
+ {
104
+ path: storey,
105
+ children: {
106
+ Space_a: spA,
107
+ Space_b: spB,
108
+ Wall_N: wN,
109
+ Wall_S: wS,
110
+ Wall_W: wW,
111
+ Wall_E: wE,
112
+ Wall_P: wP,
113
+ },
114
+ attributes: cls("IfcBuildingStorey"),
115
+ },
116
+ );
117
+
118
+ const file = {
119
+ header: {
120
+ id: "koyu/examples/comparison/two-rooms.ifcx",
121
+ ifcxVersion: "ifcx_alpha",
122
+ dataVersion: "1.0.0",
123
+ author: "shinozaki.ken.141@gmail.com",
124
+ timestamp: "2026-07-22",
125
+ },
126
+ imports: [
127
+ { uri: "https://ifcx.dev/@standards.buildingsmart.org/ifc/core/ifc@v5a.ifcx" },
128
+ { uri: "https://ifcx.dev/@standards.buildingsmart.org/ifc/core/prop@v5a.ifcx" },
129
+ { uri: "https://ifcx.dev/@openusd.org/usd@v1.ifcx" },
130
+ ],
131
+ schemas: {},
132
+ data,
133
+ };
134
+ process.stdout.write(JSON.stringify(file, null, 2) + "\n");