# Forestry Operations Lite — ヘルプ

## データ設定ヒント

### DEM / DSM/DTM データ

- DEM は汎用データか、地形解析を行う箇所のデータを選択してください。
- DSM データは、地表データの DEM データ設定と範囲を同じくするデータを選んでください。
- DSM データを選択することで流量推測における流出係数・流速係数がDSMを基に自動計算されます。

### TIF / ZIP の配置

パターン | 操作
--- | ---
単体 TIF | そのままファイルを選択
ZIP 1 枚（TIF 入り） | ZIP を直接選択
複数 ZIP 結合 | 同一地域の複数 ZIP を 1 つのフォルダに配置し、そのフォルダを選択。 親フォルダに `merged_<フォルダ名>.tif` が自動生成されます。
結合済み TIF の再利用 | 生成された `merged_*.tif` を直接選択することで再結合を省けます。

## パラメータ設定ヒント

### 斜面安定（無限斜面モデル）

無限斜面モデルで斜面安定指数（FS）を算出します。
FS は傾斜角・内部摩擦角・粘着力・土壌深度・飽和率から計算されます。
FS < 1.0：崩壊危険　/ FS < FS閾値：要注意
いずれのパラメータも「硬い層までの表土」の性質を入力します。

パラメータ | 目安・現場での確認方法
--- | ---
内部摩擦角 φ' 表土粒子の噛み合わせ | 現場で土を手に取り握って確認。 ・握ると形が残るが水を含むとドロッと崩れる → φ 20〜28° （細かい砂・粘土質・雨後に表面が流れた跡のある斜面） ・握ると固まるが砕ける → φ 30〜35° （一般的な杉・檜植林地の山土・壌土） ・握っても形にならずざらざらする → φ 38°〜 （礫・岩屑混じり・尾根筋・岩盤に近い層）
粘着力 c' 表土の粘り・団結力 | ・砂質で根系の浅い若齢林 → 0 kPa ・礫混じり壌土・中齢林 → 5 kPa ・有機質を含む粘性土 → 10〜20 kPa
土壌深度 z 表土の厚さ | バックホウや鉄芯で掘削・刺込み、層の変わり目（色・硬さ・粒径が変わる箇所）まで計測。 硬い層が滑り面の候補となります。
飽和率 m | ・0.5 = 半分濡れた状態（平常時） ・0.9 = 大雨後の状態
FS 閾値 | 1.5 以下を危険、2.5 以下を要注意など、基準を変えて分布の変化を確認。 現場試験値がある場合はそちらを優先してください。

### 沢地形（TWI）

TWI（地形湿潤指数）= ln(A / tan(β)) で湿潤帯を識別します。
値が大きいほど水が集まりやすい谷・低地を示します。

パラメータ | 考え方
--- | ---
TWI 閾値 | 設定値以下を乾燥地形としてフィルタリング。 8.0 にすると湿りやすい谷部を中心に抽出。値を上げると乾燥地とみなす箇所が増え、 湿潤地が拾えなくなります。
最小集水面積 | 小さい水みちを除外する下限サイズ。小さい値ほど細かい沢地形も検出されます。

### 流向方式（Valley/TWI 専用）

TWI と沢ゾーンを計算するときの水の流し方を3方式から選べます。 この選択は沢地形（TWI）のみに効き、流量推測は常に D8 です。
「沢の線のくっきりさ」と「湿り分布の正確さ」のトレードオフになります。

D8（単一最急） | D∞（Tarboton） | MFD（多方向）
--- | --- | ---
水を1マスにだけ流す。沢が細い1本線でくっきり出るが、TWI面に縦縞のアーティファクトが出る。 | 隣接2マスに分けて流す。縞が出ず沢の線もそこそこ残る中間型。 | 下り方向すべてに分配。最もなめらかな湿り分布。沢は谷底に沿うが太く曖昧。
用途：水が集まる危険筋の特定（崩れやすい筋・道で避ける筋）。 | 用途：線も残しつつ縞のない面が欲しいとき。 | 用途：沢地形を面として正確に（湿り・災害リスク面）。

数値の目安（上図と同じサンプルDEM・2m・沢の量を揃えた場合：解析対象 72 ha）

方式 | TWI 閾値の目安 | 抽出された沢面積 | 占有率（対 72 ha）
--- | --- | --- | ---
D8 | 約 5.2 | 2.01 ha | 2.8%
D∞ | 約 5.4 | 2.21 ha | 3.1%
MFD | 約 5.9 | 2.87 ha | 4.0%

読み方：占有率が小さく線が細い方式（D8）＝「危険な筋」を指し示す。 占有率が大きく面が太い方式（MFD）＝「沢地形そのもの」を面で表す。

集水のスケールが方式で変わるため、同じ沢の量にするのに必要な TWI 閾値が方式ごとにズレます。 方式を切り替えたら上の TWI 閾値 を再調整してください（例：D8 で 5.2 → MFD なら 5.9 前後）。

上の3枚は各方式の挙動の違いを示す説明用の描画例であり、プラグインの成果物ではありません。 違いを示すためだけにサンプルDEM（2mリサンプル）で描画したものです。 実際の出力（`twi.tif`・`valley_zones.gpkg`）は解析を実行して生成されます。

### 流量推測（修正合理式・到達時間考慮）

修正合理式＋到達時間（Tc）ルーティングで流量を推定します。
`Q = (1/360) × C × i × A_eff　　A_eff = A × min(1, T/Tc)`
継続時間 T が Tc より短い集水域は流量が抑制されます。

パラメータ | 考え方
--- | ---
i_peak（最大降雨強度） | 50 mm/h で「1時間 50mm の豪雨」を想定
流出係数 C | 0.8 なら雨の約 8 割が地表流として計算されます
総降水量 | 100 mm で降り始めから終わりまで合計 100 mm のケース
継続時間 T | 6 h で 6 時間続く降雨として平均流量・総流量を計算
流速係数 | 林地 0.3 / 草地 0.6 / 舗装面 1.5 m/s が目安。 DSM/DTM を設定した場合、流出係数・流速係数は樹冠高さから自動計算。

## 出力ファイル一覧

ファイル名 | 内容
--- | ---
`twi.tif` | 排水・湧水・ぬかるみ（地形湿潤指数）
`stability_fs.tif` | 斜面安定性（FS ラスタ）
`integrated_risk_index.tif` | 総合リスク指標（0〜6）
`integrated_high_risk.gpkg` | 重点箇所ポリゴン
`valley_zones.gpkg` | 沢形状・集水地形ベクター
`flow_peak.tif` | ピーク流量 Qp [m³/s]
`flow_mean.tif` | 平均流量 Qm [m³/s]
`flow_vtotal.tif` | 総流量体積 V [m³]

## 機能説明

### 斜面安定

無限斜面モデルによる安定性係数 FS を算出。FS < 1.0 で崩壊リスク、FS < 1.5 で注意域。 土質パラメータ（φ・c・γ）と地形勾配・土層深から計算。

### 沢地形

DEM から集水地形・沢筋を抽出したベクターデータ。 路網や作業道計画での水系との干渉確認に使用。

### 湿潤地形

地形湿潤指数（TWI）ラスタ。値が高いほど水が集まりやすく排水不良・ 地盤軟弱・ぬかるみリスクが高い。

### 流量推測

修正合理式（Q = CiA/360）による各セルのピーク・平均流量と総流量体積を推計。 DSM 設定時は樹冠高から流出係数を地点ごとに可変。

### 総合リスク

FS・TWI・流量ピークを統合した加算型リスク指標（0〜6）。 複数の危険因子が重なる箇所を「重点箇所」ポリゴンで抽出。

Forestry Operations Lite | Developed by Avid Tree Work