階段ささら桁ノッチ配置計算

正でない蹴上や踏面は明確な invalid_input で失敗し、カットリスト確定前にフォーム検証できます。

単位蹴上と単位踏面を選び、ノッチを墨付けする

別名 unit_rise、riser、riser_height、unit_riser、riser_notch は短いフォームラベル用に同じフィールドへ対応します。run も unit_run、tread、tread_depth、going、unit_going、tread_notch の別名で同様です。ゼロや負の寸法は invalid_input となり課金されません。

蹴上ノッチ・踏面ノッチ・対角・喉厚・レイアウト長の計算方法

エンジンは各段を、垂直辺が単位蹴上・水平辺が単位踏面の直角三角形として扱います。throat はノッチ切断後に残る無垢材で、同じ単位です。経路は純算術で、ネットワーク・乱数シード・壁時計はありません。フィールド riser_notch は rise に等しく、ささら桁上でノッチの蹴上面に墨付けする垂直距離です。tread_notch は run に等しく、踏面に墨付けする水平距離です。この二辺が、板に沿ってノッチを進めるときに差し金にセットする値です。step_diagonal は斜辺、すなわち rise の二乗と run の二乗の和の平方根で、ささら桁に沿った完全な1段マーク間の中心線間隔です。pitch_angle_deg は rise を run で割った逆正接を水平からの度に変換したもので、二引数の逆正接により正の辺で妥当な角になります。板幅 stringer_width も送ると、計算機は notch_depth を rise-run 三角形の直角頂点から斜辺への高さ（rise×run÷step_diagonal）として報告し、throat を stringer_width からそのノッチ深さ引いた値とします。板が狭すぎて throat が正にならない場合は invalid_input で失敗し、不可能な切断を墨付けしないようにします。step_count を正の整数（別名 riser_count、number_of_risers、steps、num_steps）で渡すと、layout_length は step_count×step_diagonal でささら桁に沿った累積墨付け長の目安になります。ペイロードは常に整理済みの rise と run を返し、formula をノッチと対角の恒等式に、method を stringer_notch_layout に設定してクライアント分岐を安定させます。同一入力は常に同一 JSON を生みます。

API の使い方、料金、現場ワークフローと実用上の限界

必須の rise と run を正の有限数または数値文字列として、任意で stringer_width と step_count を含む JSON 本体を送ってください。リフォームアプリ、拾い出しツール、コンフィギュレータ、不動産パイプラインが KIT 残高のもとで安定契約を必要とするときはプリペイド API を使い、成功1件あたり $0.002 です。SDK 作者は riser_notch と tread_notch を切断リストへ写し、step_diagonal、pitch_angle_deg、throat、formula を、材を発注する前にレイアウトを確認する施主や現場監督向けの説明として示せます。