Panna3d

Appearance

BuildingData → Speckle Export ​

BuildingData to Speckle icon

概要 ​

BuildingData を Speckle Collection に変換し、Speckle 公式コネクタ経由で Speckle プロジェクトへ送信するためのラッパーを生成します。v5.5.0 から 一方向 Export 専用 (Speckle → BuildingData の Import は退避済)。

v5.6.0 からはサテライトプラグイン MakeBuildingPro.Speckle.gha に分離されており、本体 .gha は Speckle 非依存です（Speckle Connector 未インストールでも MakeBuildingPro 本体はロード可能。本コンポーネントによる Export 時のみ Connector が必要）。

  • グループ: 5. Export
  • ニックネーム: MBP→Spk
  • Exposure: Primary
  • v5.5.0 新規 (v5.0.0 系の試作版から全面刷新) / v5.6.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 上書き禁止: Analytical 等の lossy モードで値が不要でも、原値は properties に必ず保持（「0 として復元」しない）
  • Material 物性 (E / G / Poisson / Fy / Fu / Fc) を Catalog_Material から伝播（Analytical 変換経路）
  • Is_Void=true（欠けベイ表現）の部材は変換対象外
  • 交点移動（Grid_Nodes）に Send の全部材が追随（v5.9.0）
  • Speckle 公式 Connector for Rhino 8 (Yak 経由 install 必須) との連携。未インストール時はエラーメッセージを表示（本体プラグインは影響を受けません）

入力パラメータ ​

パラメータ名型デフォルト説明
BuildingDataGeneric—変換対象データ
SanitizeInteger0サニタイズレベル (0=Full: 全データ送信 / 1=Light: Notes・CustomProperties を除去 / 2=Strict: さらに Building_Metadata の機密フィールドも除去)。省略可
ModeInteger0Export モード (0=Viewer: Web Viewer 視覚化向け / 1=Analytical: GSA・ETABS 等の解析連携向け、軸線＋荷重抽出 / 2=Physical: Revit・Tekla 等の BIM 連携向け、実体＋全 Offset 適用)。省略可
TargetInteger0Analytical ターゲット (Mode=Analytical のときのみ機能): 0=Generic (共通スキーマのみ) / 1=ETABS (CSI) / 2=GSA (Arup) / 3=SAP2000 (CSI) / 4=MidasIGen。省略可 (v5.6.0 追加)

出力パラメータ ​

パラメータ名型説明
SpeckleGenericSpeckle Collection ラッパー (公式コネクタの Publish コンポーネントの Collection 入力に直結)
ReportStringマッピングサマリ
LogString[]警告とスキップ項目
StatsStringカテゴリ別出力数
PropertiesGenericプロパティ送信ペイロード (公式 Publish の Properties 入力に接続すると、プロジェクト/建物/スキーマ情報がルートに保持される)

Analytical / Physical モード分離 ​

Design_Phase (v5.5.0) によって推奨 Mode が切り替わります:

Design_Phase推奨 Mode理由
SchematicDesign / AnalysisIterationAnalytical (1)解析中はトポロジー固定で繰返し送受信
Converged / PhysicalDetailingPhysical (2)解析収束後に物理情報を付加し Revit へ一方向送信
（フェーズ問わず表示確認）Viewer (0・既定)Web Viewer での視覚化向け

詳細はリポジトリ同梱の Specification_Analytical_Physical_v1.md を参照。

v5.9.0 / v5.10.0: 交点移動（Grid_Nodes）への追随 ​

  • グリッド交点の移動（Grid_Nodes、交点オフセット・方式A）に Send の全部材が追随します。 座標解決層（Speckle GridResolver）で交点オフセットを合成するため、Physical / Analytical いずれの変換経路でも移動後の実座標で DataObject が生成されます
  • 床面部材（小梁・孫梁・スラブ・片持ちスラブ・マット基礎・開口）も v5.10.0 から追随します （移動区画は実 4 隅で変換。3D モデルと同一の 4 隅を共有し、Analytical の解析軸線も節点整合）
  • Grid_Nodes の原値は mbp_grid_nodes_json プロパティとして送信されます（v5.10.0。未使用時は非出力）
  • Analytical モードは従来どおり基礎 4 種のジオメトリを送らず支持条件として注入します。 スキップした件数は Warning として表示されます（v5.10.0。基礎の形状は Mode=0/2 で送信）
  • Grid_Nodes 未使用のデータでは出力は従来と同一です
  • lossy モードでも原値は properties に保持する方針は従来どおりです

注意点 ​

  • Speckle Connector for Rhino 8 (Speckle.Connectors.Rhino8) の事前 install が必須（Export 時のみ。本体プラグインのロードには不要 — v5.6.0）
  • Speckle SDK は v3.x を使用 (v2 は完全削除済、ロールバック不可)
  • Send 結果は Comp_I09 Diff & Approval を通った Approved 状態のものに限定する運用を推奨 (AI Downstream warning)

更新履歴 ​

バージョン変更点
v5.5.0新規公開（一方向 Export 専用化・全 Layout の個別 DataObject 化・parent_instance_id による親子追跡・Sanitize / Mode 入力）
v5.6.0サテライト分離: 本コンポーネントを MakeBuildingPro.Speckle.gha に移設し、本体 .gha を Speckle 非依存化（Connector 未インストールでも本体はロード可能）。Target 入力を追加（Mode=Analytical 時のターゲット別マッピング。ETABS が第一連携先）
v5.7.0Is_Void=true（欠けベイ）の部材は変換対象外（非整形対応 方式D）。出力形式の変更なし
v5.9.0交点移動（Grid_Nodes）に Send の全部材が追随（GridResolver への交点オフセット合成。Physical / Analytical 両経路）
v5.10.0床面部材（小梁・孫梁・スラブ・片持ちスラブ・マット基礎・開口）が交点移動に追随（移動区画は実 4 隅で変換。未移動データは出力不変）。Grid_Nodes 原値を mbp_grid_nodes_json として送信（未使用時は非出力）。Analytical モードで基礎ジオメトリをスキップした件数を Warning 表示

関連 ​