BuildingData → Speckle Export
概要
BuildingData を Speckle Collection に変換し、Speckle 公式コネクタ経由で Speckle ストリームへ送信するためのラッパーを生成します。v5.5.0 から 一方向 Export 専用 (Speckle → BuildingData の Import は退避済)。
- グループ: 5. Export
- ニックネーム:
MBP→Spk - Exposure: Primary
- v5.5.0 新規 (v5.0.0 系の試作版から全面刷新)
機能
- 全 Layout カテゴリを 個別 DataObject 化 (小梁・孫梁・スラブも 1 本 / 1 枚ずつ独立)
parent_instance_idフィールドで親子関係を追跡 (集約しない方針)- v5.5.0
Justification/Revit_Family_Type/Design_Phaseを properties に保持 - v5.5.0
Restraint_Code/End_Release_*_Codeも解析関連 properties として送信 - Send で 0 上書き禁止: 解析モード等で値が不要でも、原値は properties に必ず保持
- Material 物性 (E / G / Poisson / Fy / Fu / Fc) を Catalog_Material から伝播
- Speckle 公式 Connector for Rhino 8 (Yak 経由 install 必須) との連携
入力パラメータ
| パラメータ名 | 型 | 説明 |
|---|---|---|
| BuildingData | Generic | 変換対象データ |
| Sanitize | Integer | サニタイズレベル (0=なし / 1=軽量 / 2=厳格) |
| Mode | Integer | Export モード (0=Hybrid / 1=Analytical only / 2=Physical only) |
| Target | Integer | 送信先 (0=Speckle Cloud / 1=Local) |
出力パラメータ
| パラメータ名 | 型 | 説明 |
|---|---|---|
| Speckle | Generic | Speckle Collection ラッパー (公式コネクタの Send コンポーネントに直結) |
| Report | String | マッピングサマリ |
| Log | String[] | 警告とスキップ項目 |
| Stats | String | カテゴリ別出力数 |
| Properties | Generic | プロパティ送信ペイロード (デバッグ用) |
Analytical / Physical モード分離
Design_Phase (v5.5.0) によって推奨 Mode が切り替わります:
| Design_Phase | 推奨 Mode | 理由 |
|---|---|---|
SchematicDesign / AnalysisIteration | Analytical only | 解析中はトポロジー固定で繰返し送受信 |
Converged / PhysicalDetailing | Hybrid or Physical | 解析収束後に物理情報を追加し Revit へ一方向送信 |
詳細はリポジトリ同梱の Specification_Analytical_Physical_v1.md を参照。
注意点
- Speckle Connector for Rhino 8 (
Speckle.Connectors.Rhino8) の事前 install が必須 - Speckle SDK は v3.x を使用 (v2 は完全削除済、ロールバック不可)
- Send 結果は
Comp_I09 Diff & Approvalを通った Approved 状態のものに限定する運用を推奨 (AI Downstream warning)
関連
Comp_I09_DiffApproval— 承認ゲート (AI 編集経由の場合)Comp_E07_STBridge_Export— 国内構造解析ソフト向け- MCP API 仕様 — Speckle 連携 tools (将来対応予定)