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

ST-Bridge（XML, 2.0 系）で読み込み・書き出しができ、構造計算や BIM のモデルを受け渡すための入出力経路として機能します。

単一リップ溝形は、有限正の H/B/C/t [mm]、t < C < H/2、t < B/2 を満たさない場合、内部編集・書き出し時に断面ID・符号・寸法と原因を表示して拒否します。 上下リップの接触・重複、ウェブとリップの接触・重複、非有限の派生性能も対象です。 自動C切詰め・微小隙間補完・閉断面Jへの読み替え・0質量化は行いません。 寸法と総断面性能を参照してください。正式なリップ溝形タグの取り込みは未対応です。

組立BOXの読み込み

組立BOXは外高さA、外幅B、左右の板厚t1、上下の板厚t2をmmで指定します。 取り込む断面が参照する組立BOXは、部材がまだ割り当てられていない断面も含め、次を検査します。

• A・B・t1・t2がすべて存在し、有限の正値であること。
• 内法高さA−2×t2、内法幅B−2×t1が有限の正値であること。

正常な組立BOXは、同厚・異厚とも左右と上下の板厚を保持した角R=0の鋭角断面として取り込みます。 板厚差が微小でも丸め・平均による置き換えは行いません。CFTの充填鋼管にも同じ条件を適用します。 同じ符号・階・用途でも上下板厚が異なる断面と部材の参照先を区別し、OVIKA保存・再読み込みでも保持します。 どの取込断面からも参照されないライブラリ内だけの定義は、寸法不正だけでは読み込みを止めません。 圧延BOXの条件は別です。

断面積・断面二次モーメント・材料別重量は両板厚で算定します。 異厚のねじり定数・せん断性能とCFT等価剛性は理由付き未算定です。 入力の受理は、これらを必要とする解析・検定の成功を保証しません。 組立BOXの断面諸量を参照してください。

診断には形鋼名、参照断面の識別情報、不足・不正な属性と入力値、停止理由を表示します。 該当部材や断面を除いて読み込み成功にはしません。 失敗した読み込みによって、現在開いているモデル・結果・保存先は置き換わりません。

GUI からの操作

「ファイル」メニューの書き出しボタン直下には、操作前に次の説明を表示します。

ST-Bridge書き出しは開発中です。一部の形状・属性・断面性能を正しく出力できない場合があります。出力内容は利用先で確認してください。モデルの保存にはOVIKAを使用してください。

• ファイル選択ダイアログの拡張子フィルタは .stb / .xml。
• ST-Bridge 読込は .ovika プロジェクトとは別系統であり、読み込んでもプロジェクトの保存先パスは設定されません（新規モデルとして開く扱い）。保存するとネイティブの .ovika として保存されます。
• 書き出しは ST-Bridge 2.0.2 の標準要素を用いる1形式です。全断面・部材の標準適合は未完了で、RC梁の配筋入力不足と一部ブレースの出力には制約があります。受け渡し先での検証を確認し、完全一致の保存にはネイティブの .ovika を使います。

対応バージョン

• ST-Bridge 2.0 系のみを受け付けます（ルート要素 ST_BRIDGE の version 属性が 2. で始まること）。
• 要素の名前空間は https://www.building-smart.or.jp/dl に限定します。同じURIなら既定名前空間と接頭辞付きの記述を同じものとして扱います。名前空間なし・異なるURI・未宣言の接頭辞は拒否します。属性の接頭辞を外して標準属性へ読み替えることはありません。
• 1.x 系や ST-Bridge でない XML は読み込みエラーになります。
• 読み取る ID 定義・参照は、XML の数値文字列として 0〜4294967295 の整数を検査します。負数・小数・範囲外・数値でない値は項目と理由を付けて拒否し、取り込み全体を失敗させます。節点境界列の不正 ID も捨てません。標準節点 ID の書出しなど、個別の正整数条件は別途適用します。
• 柱・大梁・ブレース・小梁・間柱は、端部節点と断面の参照先が実在することを要求します。床・壁も指定された境界節点と断面の参照先が実在しなければ、理由を示して取り込み全体を拒否します。参照先の欠落を部材の省略や断面リンクの解除で処理しません。床・壁の断面参照の省略など、既存の未指定入力の扱いは要素別変換状況を参照してください。
• STBで表現できる情報はすべて適切に出力し、対応表現がない形状等だけを近似する方針です。未割当断面や必須属性の欠落を許容する方針ではありません。主架構部材・ブレース・小梁・間柱に断面未割当がある場合、必須の断面参照を出力できないため書き出し全体を拒否します。診断の部材区分・内部ID・二次部材名を確認し、適切な実在断面を明示的に割り当てて再出力してください。拒否時は出力先を作成せず、既存ファイルも上書きしません。未割当をダミー部材へ変更したり、架空の断面・材料を補ったりはしません。断面が割当済みで形状が未設定の場合は、従来の出力を維持します。
• ファイルの文字コードは、BOM 付き UTF-8・UTF-8・Shift_JIS（Windows-31J）の順に判定します。

標準入力と保存の範囲

断面系列と数値ID

断面は、採用名前空間・具体的な断面系列・元の数値IDの組で識別します。 例えば StbSecColumn_RC:1、StbSecColumn_S:1、StbSecBeam_RC:1 は別の定義です。 同じ系列の 1 と 01 は同じ数値IDなので、形状・材料・強度が同じでも重複定義として拒否します。 断面の符号・階・形状が一致することは、部材から参照する系列を変更する理由にはなりません。

部材の種類と kind_structure から要求する系列を決めます（系列対応表）。 要求系列に参照先がなく、別系列だけに同じ数値IDがある場合も、取り込み全体を拒否します。 診断には元部材の要素名・ID・kind_structure・要求系列・id_section と理由を示します。 kind_structure の欠落・不正値・未対応の構造種別は区別し、別系列や既定断面へ結びません。 床・壁の断面参照自体の省略は、要素別変換状況に示す未割当の扱いを維持します。 取り込み失敗時は、現在のモデル・Undo履歴・解析結果の世代を変更しません。

断面からの強度指定も同じ入力識別に結びます。別系列に同じIDがあっても、柱のFc30を梁のFc24へ取り違えません。 以下の強度優先順位、配筋、原階と材料参照節点、任意物性の扱いは共通です。 この入力識別はST-Bridge読込用です。ネイティブモデルとOVIKAの断面参照・強度指定は、保存・再読込・内部の再採番後も保持します。 元の外部断面IDをOVIKAへ永続保存する契約ではありません。

ST-Bridge 2.0.2のXSDは具体的断面系列ごとに19個の key を定義していますが、keyref はありません。 XSDへの適合と、部材が正しい断面・強度へ結び付くことは別に確認する必要があります。 本機能は全文XSD検証器ではなく、全形状・全標準要素への対応を意味しません。 出典：公式2.0.2 XSD、 公式仕様説明書の本文64頁§5.2.1補足10、68頁§5.3.1、73頁§5.4.1補足16、75頁§5.5.1、77頁§5.6.1。

原階と強度指定の保持

原階の元 ID/GUID・名称・height・kind・id_dependence・strength_concrete・明示節点列を保存し、 節点の元 ID/GUID も再出力します。内部の連番 ID は交換形式の ID とは別に扱います。 新規の階・構造節点は編集時に既存と衝突しない正整数 ID を保持し、並べ替えや undo/redo で変わりません。 標準節点 ID がまだ無いネイティブモデルでは、最初の成功編集時に既存構造節点の ID も保存します。 初回の削除でも残存節点の標準 ID を保持し、拒否された編集は ID を追加しません。undo は編集前の保存状態へ戻します。 未保存の既存階も、階追加・変更・削除の前に標準 ID を保存するため、中間階を削除しても残存階の標準 ID は変わりません。 原階が未初期化のネイティブモデルでは、節点側と階側の所属指定を合わせた、その時点の標準出力所属を初回階編集でも保持します。 同じ階への重複はまとめ、二つの階への所属指定が競合する場合は両方を保持して多重所属を診断します。 準備計算で推定した解析所属や生成した剛床代表節点を、元の明示所属へ合算しません。

コンクリートの強度指定と省略状態は、部材・断面・原階・共通ごとに保持します。 採用値を元属性へ補完して保存しないため、再出力で省略の優先順位が変わりません。

標準強度の解決と編集

コンクリートのFcは 部材 → 断面 → 指定節点の明示原階 → 共通 の順に採用します。 上位属性が存在しても未知名・空文字・非正値・非有限値なら未解決とし、下位の既知値へ迂回しません。 全指定の欠落も未解決です。原階の参照は次の節点で決まり、近傍階・平均標高・準備計算の解析所属では代用しません。

原階に異なるFcが競合する場合、上位の部材・断面で確定していれば材料は解決できます。 材料の採用元と、原階の所属・依存関係の診断は別に確認します。

鉄筋は、各部位の strength_* があればその指定を採用し、省略時だけ対応する D_* と 共通の StbReinforcementStrengthList の D/strength を照合します。 主筋・副主筋・帯筋・あばら筋・腹筋・巾止筋、位置別指定をそれぞれ保持します。 径や強度の欠落をD13・SD345で補完しません。同径の競合と未知名は理由を示して解析を停止します。 位置別の各指定が解けても、現行計算で一つの主筋・せん断補強筋・内蔵鋼材へ縮約できない強度は解析に採用できません。 高強度鉄筋のgrade読取りと、各検定式の適用範囲は別です。

StbCommon の project_name・app_name・app_version、任意の strength_concrete と径別リストを保存します。 共通子要素の出力順は径別リスト、適用条件リストの順です。RC/SRC梁・柱の原配筋と ApplyConditionsList は省略を含めて保存し、役割・位置・適用の対応を参照します。 説明図中の concrete_strength は標準属性 strength_concrete の別名として受け付けません。

準備計算の「STB強度指定と採用元」で、元指定の有無、共通・原階・部材・断面・鉄筋部位の指定と採用結果を確認・編集します。 チェックを外すと元属性を省略し、チェックを入れた空欄は明示された空文字として未解決になります。 通常の材料テーブルの名称変更は表示名の変更であり、保存された標準gradeやFc・Fyを変更しません。 Fc数値の意図的な変更は、その材料を採る元明示指定へ反映します。E・ν・密度の編集では元強度指定・省略を変えません。 断面への明示材料割当は、その断面の強度を変更します。主材料・主筋・せん断補強筋・SRC内蔵鉄骨を別々に指定できます。S断面の主材料は鋼材、RC・SRC・CFT断面の主材料はコンクリートです。鋼材割当を解除した場合は、必須の鋼材強度が未解決になり、旧gradeへ戻りません。上位の部材Fc指定があれば部材の採用値はそのままです。 標準鋼材gradeの編集は、Sの主材料・二次部材の鋼材・SRC内蔵鋼の実採用材料にも反映します。明示材料割当がある場合は、その材料の数値を採用し、標準gradeによる採用と区別します。明示割当だけの操作で別の既定材料を追加しません。 鉄筋や鋼材のFy数値を編集した場合は、その数値を採用し、元の標準gradeとは区別します。標準gradeで編集後の数値を表せない場合はSTB出力を理由付きで拒否します。独自の標準gradeを生成せず、任意物性の保存にはOVIKAを使います。 明示材料の物性を採る結果には「明示材料指定」を表示し、標準gradeからの解決と区別します。 任意の明示鉄筋物性と標準gradeの数値が一致しない場合は、ネイティブ保存と標準書出しを区別し、標準で表せない出力を拒否します。

ST-Bridge強度名の解決とE・ν・密度の既定復元は別の処理です。 認識済みgradeの強度を採用した後、明示物性を持たない材料にSEPIKAの標準材料既定値を与えます。 CFT鋼管も認識済みの標準鋼材名からE・ν・密度を復元します。SN400Bの鋼管密度は7.85 t/m³で、同じ文書内の通常鋼断面の有無には依存しません。主材料は充填コンクリート、鋼管は別の材料として扱います。 ST-Bridgeに存在しない独自材料表は追加しません。任意物性を含む完全保存には .ovika を使います。 長さmm・角度deg・強度N/mm²を保持します。

強度の入出力制限

床の元幾何を再結合して出力する機能はありません。取り付く壁版や配筋全体にも既存の出力制限があります。 材料を対象にしたXMLの適合が、建物全体の標準適合を保証するわけではありません。

出典: buildingSMART Japan「ST-Bridge XML仕様説明書 ver.2.0.2」2022-06-15、§2.4（本文11頁）、 §3.2–3.2.4（本文18–24頁、優先順20頁）、§4.4.1（本文57–58頁）、§6.2.5（補足4頁）。 採用対象の仕様説明書、 公式配布入口。標準属性・子要素順序は2.0.2 XSDによります。

読み込みは、ST-Bridge 2.0.2の標準要素・属性のうち、要素別変換状況に示す対応範囲を対象とします。旧独自の材料表 StbMaterial、物性を直接記す StbSecRaw、独自の id_material 系参照は読み取りません。標準にない属性名や異なる階層の属性を、標準入力の代わりに採用しません。

標準の StbExtensions・StbCalData・StbAnaMaterial が存在すること自体を旧形式の判定には使いません。これらの全情報を取り込めるという意味ではありません。標準ルート直下の StbExtensions 内も要素の名前空間を検査しますが、内容をモデルや強度指定として取り込みません。読込時のXSD全文検証や旧形式の専用判定・移行は行いません。

書き出しには現在も StbSecRaw への出力がありますが、その出力を再読込できる保証はありません。書き出しの制限を含む完全なモデル保存にはOVIKAを使用してください。内部の任意断面性能・材料物性・強度指定とその編集、OVIKAの保存・再読込・再採番は、ST-Bridge入力の対応範囲とは別に保持します。

要素ごとの詳細な変換状況（取り込み／書き出し／往復・備考）は、 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 と共通のアプリ情報は保存し、それ以外の未対応の guid は「取り込まなかった属性」として現れますが、 どの属性がどう扱われたかを利用者が漏れなく追えることを優先しています。 リストを持たない副次的な利点として、取り込みの実装を増やせば報告も自動的に追随するため、 一覧の更新漏れが起きません。

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の部材から断面への参照は、採用名前空間・具体的な断面系列・数値IDで解決します。guid や符号・階は、この参照識別の代わりには使いません。 同じ符号の断面を階ごとに異なる数値IDの定義として持つことができます。 そのため 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 が存在しないファイルがあります。

異なる数値IDの断面定義を取り込むとき、符号＋階が重複する場合は次のように解決します。 同一系列の同じ数値ID（1 と 01 を含む）の重複は、この統合処理の対象ではなく取り込みエラーです。

• 同一の具体的な断面系列内で、断面性能・断面形状・材料と、強度・配筋の元指定がすべて一致する定義に限り、1 件へ統合する。統合した件数は ImportReport の通知（notes）で知らせる
• 別系列の定義や、上記のいずれかが食い違う定義は、符号へ連番を付けて（b3 → b3#2）別の断面として残す。同名同形状でも、別系列を1件へまとめない。 符号を変えた内容は ImportReport の警告で知らせる

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

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

階を持たない断面定義（floor 属性のない StbSecBeam_S など）も、異なる数値IDで、同一具体系列・同一符号かつ断面性能・形状・材料・強度と配筋の元指定がすべて一致する場合に限り、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)?;
}