Stera.Net 0.1.0

Stera.Net

.NET bindings for stera — a structural engineering calculation library specialized for Japanese building design (linear static analysis, allowable stress design and story judgment for steel structures, Route 1–2). The core is written in Rust and bundled as a native library; this package is a thin, dependency-free wrapper (no Rhino/Grasshopper required).

日本の建築構造設計（S造ルート1-2 の一貫計算）に特化した構造計算ライブラリ stera の .NET バインディング。コアは Rust 製で、ネイティブライブラリ（win-x64 / linux-x64 / osx-arm64 / osx-x64）をパッケージに同梱しています。Rhino / Grasshopper には依存しません（Grasshopper プラグイン SteraGh はこのパッケージの上に作られています）。

インストール

dotnet add package Stera.Net

使い方（片持ち梁の解析）

単位は内部で N・mm 系固定（長さ mm、力 N、応力度 N/mm²）。

using Stera.Net;
using Stera.Net.Model;

var model = new SteraModel
{
    Nodes =
    {
        new Node { Id = "N1", X = 0, Y = 0, Z = 0 },
        new Node { Id = "N2", X = 3000, Y = 0, Z = 0 },
    },
    Materials = { new Material { Id = "S", Kind = MaterialKind.Steel, E = 205000.0, G = 79000.0 } },
    // 断面性能は寸法から Rust 側で算定できる（H-300x150x6.5x9）
    Sections = { SteraClient.SectionFromDetail("SEC", SectionDetail.HShape(300, 150, 6.5, 9)) },
    Members =
    {
        new Member { Id = "G1", Type = "beam", NodeI = "N1", NodeJ = "N2", Section = "SEC", Material = "S" },
    },
    Supports = { Support.FixedAt("N1") },
    LoadCases =
    {
        new LoadCase { Id = "P", Loads = { Load.Nodal("N2", new[] { 0.0, 0.0, -10000.0, 0.0, 0.0, 0.0 }) } },
    },
};

var result = SteraClient.Analyze(model);
var tip = result.Case("P")!.Displacements["N2"];  // [ux, uy, uz, rx, ry, rz]
Console.WriteLine($"tip deflection = {tip[2]} mm");

一貫計算（荷重生成 → 解析 → 断面検定 → 層判定）は SteraClient.Run(model, options)。RunOptions で自重・地震（Ai 分布）・風（告示1454号）・標準組合せ・ルート判定を指定し、結果は SteraReport（検定比・層間変形角・Rs・Re 等）で読み取れます。

主な構成:

• SteraClient — Version() / Analyze() / Run() / SectionFromDetail()
• Stera.Net.Model / Stera.Net.Options — モデル・実行オプションの DTO（JSON 契約は Rust 側と round-trip テストで担保）
• Stera.Net.Build.ModelBuilder — 座標ベースの組立（節点マージ・ID 採番・荷重スナップ・剛床自動生成）
• Stera.Net.Report.SteraReport — 帳票リーダー（遅延パース）

対応環境

• TFM: net8.0 / net7.0 / netstandard2.0（.NET Framework 4.8 ホスト対応）
• ネイティブ: runtimes/{win-x64, linux-x64, osx-arm64, osx-x64}/native を同梱。特殊なホスト環境では環境変数 STERA_FFI_PATH でライブラリの場所を明示できます

ライセンス

MIT