<aside> 🆕

v1.21.0（2026.10.09）追加のコンポーネントです（OpenSees > Pile）。

v1.21.0（2026.10.10）の更新: 入力 B（支点）を省略できるようにしました（柱を杭に直接接合する支点の無い建物）。柱と杭の接合部（PileList の joint）の位置はフーチングなしの杭 1 本（d = 0 なら杭頭 = 柱脚の節点）です。

</aside>

概要

上部構造と杭の一体モデルを作ります。これまで杭を線材で入れ，地盤ばねを 1 つずつ手で入れていた一体解析を自動でモデル化します。上部構造の Elastic Analysis の入力（R, IJ, B, spring, joint, E, poi, A, Iy, Iz, J, l_vec, F, FX, FY, f）をつなぐと，杭の位置に杭・地盤ばね・フーチングを加えた一体モデルを出力し，そのまま Elastic Analysis（長期・X・Y）につなぎます。結果は Pile (杭) の PileFrameCheck で検定します。

地盤（SoilData）・杭リスト（PileList）・杭の点のユーザーテキストは分離モデル（PileHorizontal・PileCapacity・PileFooting）と同じです。

杭: 梁要素（要素の長さ ≤ mesh, 既定 0.5 m。杭の部分と地層の境界で分割）。断面は杭リストの各部分の換算断面（A = Ae, I = Ie, E）。
地盤ばね: 各節点に水平ばね kh·B·l（kh = α·ξ·E0·B^(−3/4)，PileHorizontal と同じ）。節点の真下 1 mm の固定点とのばね要素（2 方向に同じ値）。
杭先端の鉛直ばね: 工法の式の Kv = a·Ae·E/L から杭体の伸縮を除いた値（a が 1 程度以上なら先端を鉛直に固定とみなす）。先端の水平・回転は杭リストの先端の条件。
フーチング: 剛体として，基礎梁の節点から杭頭（d 下）までを剛な要素でつなぐ。フーチングに杭の配置（2x1@1500 など）があれば杭を 1 本ずつ，それ以外は n 本をまとめた 1 本の杭（A, I, ばねを n 倍）。杭頭は固定（固定度 0 の杭はピン）。
支点: 既定（keepB = false）ですべて外し，建物を杭だけで支えます（壁式の基礎梁の下の連続した支点なども外れます）。keepB = true なら杭の位置の節点の支点だけ外します。
荷重: 長期の F に wf（フーチングなどの重さ）を鉛直に，地震時の FX・FY に基礎の水平力 k·(wf + W·n/Σn)（k = k0(1 − Hk/40)Z）を加えます。根入れによる低減 α < 1 のときは (1 − α)(Q1 + k·ΣW)·n/Σn を逆向きに加えます。

杭の点の高さ

杭の点は基礎梁の天端などに置いても構いません。平面の位置が同じ解析モデルの節点のうち，支点の節点・高さの近い節点（壁式の線材置換モデルでは基礎梁のせいの中心の平均の高さの節点）に自動で合わせ，杭頭はその節点から d 下にします（d = 杭頭〜その節点の高さ）。合わせた点は report と計算書の「注意」に書きます。

入力・出力

入力データは以下の通りです（説明は Grasshopper のツールチップと同じ）。

layer : Rhino layers of the pile points (plan position of a foundation beam node; the height may differ). User text: pile, footing, soil, top, d, n, wf, name（Pile (杭) を参照）
soil : soil data (output soil of SoilData, or a csv file path)
piles : pile list (output piles of PileList, or a csv file path). Footings with a pile layout: each pile is modeled
R, IJ, B, spring, joint, E, poi, A, Iy, Iz, J, l_vec : the input of Elastic Analysis of the superstructure
F : long-term nodal loads (wf of the pile points is added as −Pz)
FX, FY : seismic loads of the X / Y case (the horizontal force of the foundation is added)