ST-Bridge 形式（.stb / .xml）

ST-Bridge（XML, 2.0 系）で読み込み・書き出しができ、他社の一貫計算プログラムや BIM ツールとモデルを受け渡すための入出力経路として機能します。

GUI からの操作

• ファイル選択ダイアログの拡張子フィルタは .stb / .xml。
• ST-Bridge 読込は .ovika プロジェクトとは別系統であり、読み込んでもプロジェクトの保存先パスは設定されません（新規モデルとして開く扱い）。保存するとネイティブの .ovika として保存されます。
• 書き出しは ST-Bridge 2.0.2 標準スキーマ準拠の 1 形式のみです（他ソフトとの相互運用が目的のため独自方言は用いません）。完全一致の保存にはネイティブの .ovika を使います。

対応バージョン

• ST-Bridge 2.0 系のみを受け付けます（ルート要素 ST_BRIDGE の version 属性が 2. で始まること）。
• 1.x 系や ST-Bridge でない XML は読み込みエラーになります。
• ファイルの文字コードは、BOM 付き UTF-8・UTF-8・Shift_JIS（Windows-31J）の順に判定します。

対応範囲（意味的往復を保証するサブセット）

読み込み・書き出しの対象は、import → export → 再 import でモデルが意味的に一致する範囲に限定しています。

要素ごとの詳細な変換状況（取り込み／書き出し／往復・備考）は、 ST-Bridge 要素別 変換状況一覧を参照してください。

非対応（対象外）

非対応項目は入出力の対象外です。取り込み時の扱いは、ST-Bridge 要素別変換状況一覧を参照してください。

• 剛域・製作情報などの詳細属性。
• 解析結果・SEPIKA 独自の解析／設計属性。ST-Bridge の対象外で、保持には .ovika を使います。

未対応の要素（StbFooting・StbPile など）を含む、取り込み時にデータを欠落させる要素は、取りこぼしを無言で捨てず ImportReport の warnings （Rust API では report.warnings）として通知します。手動リストにない新要素・ベンダー拡張も、部材グループ・ 断面の直属子であれば要素名で通知します。GUI の「ST-Bridge 読込」は警告があれば「⚠️ 取り込み時の注意」として表示します。

属性の扱いの報告

要素の警告とは別に、属性の単位でも、ファイルに存在したものをどう扱ったかをすべて報告します。 取り込みの報告 ImportReport.attributes に、要素名・属性名ごとの出現件数と、そのうち 取り込んだ件数を持ちます。1 件も取り込まなかった属性は report.dropped_attributes() で取得できます。 属性の未取り込みは warnings には積まず、attributes とログで報告します。

無視リストは持ちません。 guid や app_name のように解析へ用いない属性も「取り込まなかった属性」として現れますが、 どの属性がどう扱われたかを利用者が漏れなく追えることを優先しています。 リストを持たない副次的な利点として、取り込みの実装を増やせば報告も自動的に追随するため、 一覧の更新漏れが起きません。

GUI の「ST-Bridge 読込」では、扱いの全量を下ドックの「ログ」タブへ出します。 読込直後のメッセージには「取り込まなかった属性が N 種類あります」という要約だけを出します。 実ファイルでは属性の種類が数十になり、そのまま並べると読めなくなるためです。

同じ属性でも文脈により扱いが分かれることがあります。 たとえば 1 つの断面に図形要素が複数ある場合、最初の図形だけを採るため 2 つ目以降の寸法属性は 参照しません。 このときログには「N 件中 M 件を取り込み」と出ます。

支点の自動設定（取り込み時）

ST-Bridge は境界条件（支点）を持たないため、支点が 1 つもないモデルを取り込んだ ときは、そのままでは解析できません。そこで取り込み時に、最下レベル（Z 最小、 許容差 1 mm）で柱脚が取り付く節点をピン支点（並進 3 自由度を拘束・回転自由）に 自動設定します（柱脚ピンの仮定。基礎の回転拘束を期待しない安全側の既定）。この支点自動設定に限り、柱脚候補を鉛直な 2 節点線材（部材軸の鉛直成分が大きい部材）で判定し、 柱が取り付かず梁だけが取り付く最下レベル節点（地中梁の中間節点など）は支点にしません。 最下レベルに柱脚が特定できない場合に限り、解析可能性を優先して最下レベルの全節点を ピン支点にフォールバックします。設定した内容は ImportReport の通知（notes）で知らせ、 モデルタブ→境界条件で変更できます。すでに拘束を持つモデルはそのまま尊重し、何もしません。

断面用途の取り込み

主架構線材の設計用途は、断面に保持する FrameSectionUse（Girder・Column・Brace）を正とします。 ST-Bridge の StbColumn・StbGirder・StbBrace の部材コンテナから用途を割り当て、部材の角度・鉛直性・断面符号から柱・梁・ブレースを推定しません。 したがって、部材の角度にかかわらず StbGirder は大梁として扱います。

ElementKind は解析定式化、FrameSectionUse は設計用途を表します。主架構の ElementKind::Beam には Girder または Column、 ElementKind::Brace には Brace を割り当てます。不整合または用途不明の断面は、角度で補正せず取り込みをエラーにします。 二次部材は SecondaryMemberKind（小梁 Beam・間柱 Post）を正とし、二次部材から FrameSectionUse は決めません。小梁・間柱が参照する断面は frame_use=None でも構わず、同一断面を主架構と共有する場合を含め、frame_use の値だけを理由に二次部材を拒否しません。

断面の符号と階（取り込み）

ST-Bridge は断面を guid で識別しており、同じ符号の断面を階ごとに別の定義として持ちます。 そのため 1 つのファイルに name="C1" の StbSecColumn_S が、floor="1"・floor="2"・floor="3" と 3 つ並ぶことは正常な状態です。

SEPIKA の断面は符号と階の組で識別するため、この構造を そのまま取り込めます。 断面の floor 属性は文字列としてそのまま保持し、階（StbStory）への参照としては扱いません。 ST-Bridge の floor は自由文字列で、階への id 参照を持たないためです。 実際、断面の階名が 1・R・PHR で StbStory の名称が 1FL・RFL・PHRFL というように 食い違うファイルや、断面の階名に対応する StbStory が存在しないファイルがあります。

符号＋階が重複する断面定義は、取り込みの段階で次のように解決します。

• 断面性能・断面形状・材料が完全に一致する定義は、1 件へ統合する。統合した件数は ImportReport の通知（notes）で知らせる
• いずれかが食い違う定義は、符号へ連番を付けて（b3 → b3#2）別の断面として残す。 符号を変えた内容は ImportReport の警告で知らせる

材料も一致の判定に含めるのは、材料は断面が持ち、違う材料を割り当てるならそれは 別の断面だからです。材料だけが違う定義を 1 件へまとめると、片方の材料が無言で消えます。

食い違う定義を捨てずに残すのは、利用者が書いた断面定義を無言で消さないためです。 連番を付けた時点で符号＋階は一意になるので、モデル側の制約とも矛盾しません。

階を持たない断面定義（floor 属性のない StbSecBeam_S など）が複数あり、内容も同一である場合は 1 件へ統合されます。 小梁の断面定義が同じ内容で何件も並ぶファイルは実際にあるため、この統合で断面一覧が実態に近づきます。

断面表現（書き出し）

書き出しは ST-Bridge 2.0.2 標準スキーマ準拠の 1 形式のみです。内部モデルのパラメトリック断面形状 （Section.shape）を対応する標準要素＋形鋼ライブラリ（StbSecSteel）へ写像します。

断面ごとの書き出し先と、取り込み・書き出し・往復の詳細は、ST-Bridge 要素別 変換状況一覧を参照してください。

材料の物性値まで含めた完全一致での往復が必要な場合は .ovika を使います。

開発者向け: ライブラリ API（Rust）

#![allow(unused)]
fn main() {
use sepika_io::stbridge::{import_stbridge, import_stbridge_with_report, export_stbridge};

// 読み込み: ST-Bridge XML 文字列 → 内部モデル
let xml = std::fs::read_to_string("model.stb")?;
let model = import_stbridge(&xml)?;

// 読み込み（欠落の報告つき）: 未対応要素のスキップ・断面欠落・参照解決失敗などを警告として得る
let (model, report) = import_stbridge_with_report(&xml)?;
if !report.is_clean() {
    for w in &report.warnings {
        eprintln!("警告: {w}");
    }
}

// 書き出し: 内部モデル → 標準 ST-Bridge 2.0.2 XML 文字列
let xml = export_stbridge(&model)?;
std::fs::write("model.stb", xml)?;
}