terrain-hydrology
Skill3 starsChanged yesterdayApache-2.0View on GitHub
標高のラスタ (DEM) から、窪地の処理、流向 (D8)、集水面積、流出点 (ダム、観測所、河口) の流域界、河道網、HAND (最寄りの川からの高さ) を求める。流域を分析の単位にするとき、浸水の分析に地形の特徴量を作るとき、公表された集水面積と突き合わせるときに使う。雨から流量への変換 (流出の計算)、水位や氾濫の計算、確率雨量は扱わない。
1 other project uses a version of this.
Adopted by
Most recently taken up by
- muend/geoai-skillstheir own version, first seen Nov 1, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- muend/geoai-skills★ 39same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository56 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/AGENTS.mdAGENTS.md
- analysis-reportingSkill
- analysis-unit-designSkill
- analysis-visualizeSkill
- anomaly-detectionSkill
- areal-interpolationSkill
- causal-designSkill
- causal-estimationSkill
- clustering-analysisSkill
- cross-validation-designSkill
- data-quality-auditSkill
- dataset-discoverySkill
- data-variable-semanticsSkill
- dimensionality-reductionSkill
- eda-and-baselineSkill
- experiment-designSkill
- frontend-designSkill
- grid-risk-mappingSkill
- image-segmentationSkill
- land-cover-costSkill
- leakage-auditSkill
- location-privacySkill
- model-explanationSkill
- natural-japaneseSkill
- noise-ceiling-analysisSkill
- observation-bias-auditSkill
- poi-insightsSkill
- point-pattern-analysisSkill
- raster-cost-distanceSkill
- raster-data-integrationSkill
- research-paper-writingSkill
- research-question-generationSkill
- robustness-analysisSkill
- sar-change-detectionSkill
- spatial-accessibility-analysisSkill
- spatial-autocorrelationSkill
- spatial-data-integrationSkill
- spatial-data-modelingSkill
- spatial-feature-engineeringSkill
- spatial-gnnSkill
- spatial-interpolationSkill
- spatial-network-analysisSkill
- spatial-optimizationSkill
- spatial-process-modelingSkill
- spatial-sampling-designSkill
- spatial-weights-designSkill
- spatiotemporal-modelingSkill
- stop-describing-uiSkill
- street-imagery-inspectionSkill
- time-series-forecastingSkill
- trajectory-predictionSkill
- travel-time-reliabilitySkill
- uncertainty-estimationSkill
- web-design-guidelinesSkill
- yomiyasuSkill
The file
Files
terrain-hydrology
雨が地表をどう流れて、どこに集まるかを、標高だけから決める。答えは、DEM の種類と範囲、窪地の扱い、流向の規則、流出点の置き方で変わる。どれも黙って違う答えを出すので、決めたことと数えたことを書く。
このスキルが答えるのは、「この DEM の上で、各セルの水はどちらへ流れ、どれだけの面積から水が集まり、ある点に集まる流域はどこか、各セルは最寄りの川から何 m 高いか」まで。降った雨が何時間後に何 m³/s 流れるか (流出)、川の水位、氾濫の広がり、何年に一度の雨かは、このスキルの外。
| reference | 読むとき | 中身 |
| pitfalls | DEM を切り出す前、いつも (手順 1〜6 の前) | 落とし穴と罠。DSM と DTM、範囲の端で切れる流域、閉じた盆地、流向の規則、流出点の寄せ方、CRS、pyflwdir と whitebox の罠 |
| validation | 結果を公表値や別の道具と照合するとき (手順 8 の前) | 答えの分かる合成の地形、壊すと落ちることの確認、whitebox との照合、相模川の 3 ダムの集水面積との照合、メモリと時間 |
| tools | 使う道具 (pyflwdir、Whitebox) を選ぶとき、入れるとき | pyflwdir、Whitebox Workflows (whitebox_next_gen)、旧 WhiteboxTools のライセンス、版、呼び方、選んだ理由 |
手順
- DEM の種類を確かめる。DSM (建物や木の上の高さ) か、DTM (地面の高さ) か。DSM は、山地の流域界にはおおむね使えるが、市街地では建物が流れを堰き止め、道路の溝を消す。市街地の流れや HAND には DTM を使う。DEM の版、解像度、作られた時期を書く。
- 範囲を、求めたい流域より十分広く切る。流域が範囲の端にかかると、端の外の面積は数えられず、面積は小さく出る。
scripts/hydro.pyは、流域のセルのうち範囲の端か NoData の隣にあるものをedge_cellsに数えて警告する。0 になるまで範囲を広げる。小さく出た面積が公表値に偶然近くなることがあるので、公表値との一致を範囲の確認の代わりにしない (pitfalls)。 - CRS を確かめる。面積を正しく数えるため、メートル単位の投影座標系で、回転の無い格子にする。
hydro.pyは、CRS の無いラスタ、経緯度、フィート、回転した格子、面積の尺度が 1 から--max-scale-error(既定 0.02) より離れる投影 (北緯 35 度の Web メルカトルは約 1.5 倍) を止める。止まったら、地域に合った投影 (UTM の帯、平面直角座標系) に変換する。標高の再投影は双線形で行い、そう書く。 - 閉じた盆地を決める。窪地を全部埋めると、外へ川の流れ出ない湖や盆地も、縁を越えて隣の流域へ流れることになる。地図と資料で、流れ出口の無い湖、地下へ抜ける窪地、人工の水路でつながった湖を確かめる。流れ出ない所は
--sinksに点で渡す。渡した点ごとに、そこへ集まる面積が出る。渡した場合と渡さない場合の両方を流し、差を書く。どれを閉じた盆地とするかの根拠 (資料の頁、地図) も書く。 - 流向を決める。
hydro.pyは、窪地を埋め (Wang and Liu 2006 の priority flood)、埋めた面の上で 8 近傍の最急降下 (落差を中心間の距離で割る) を取る。埋めて平らになった所だけ、埋める処理の向きを使う。窪地を削る (breach) 方法は入れていない。削る方法と埋める方法で、大きな流域の面積が数 % 変わることがある (validation)。 - 流出点を川のセルに寄せる。ダムや観測所の座標は、DEM の上の川のセルから数十〜数百 m ずれる。
--snap-mの範囲で、集水面積が--snap-min-km2以上のセルのうち最も近いものに寄せる。範囲の中で集水面積の最大のセルに寄せる方法は、ダムや合流点の下流へ飛ぶので使わない。--snap-min-km2は、期待する集水面積より小さく、近くで合流する支川より大きくする。寄せた距離 (snap_m) と、寄せた先の集水面積を書く。寄せる先が見つからない点は、寄せずに流域を作るのではなく、見つからなかったと報告する。 - 河道網と HAND を作るなら、川とみなす集水面積 (
--stream-km2) を決めて書く。HAND は、各セルから流れに沿って最初に着く川のセルとの高さの差 (埋めた後の DEM で) なので、閾値を変えると値が変わる。閾値を 2 つ以上で流し、結論が変わらないかを見る。 - 公表値と照合する。ダムの集水面積、観測所の流域面積が公表されていれば、流出点の流域の面積と比べ、差を % で書く。差が大きければ、範囲の端、閉じた盆地、流出点の位置、DEM の種類の順に疑う。
- 数える。セルの数 (有効、NoData)、流出口と窪地の数、流出点ごとの寄せたかどうか、端に触れたセルの数を書き、合計が合うことを確かめる。
uvx --python 3.12 --with pyflwdir --with numpy --with rasterio --with pyproj python scripts/hydro.py tmp/dem_utm.tif \
--out tmp/hydro.tif --points tmp/dams.csv --points-crs EPSG:4326 --snap-m 300 --snap-min-km2 50 \
--sinks tmp/closed_lakes.csv --stream-km2 1出力は 5 band の GeoTIFF (float32、NoData は NaN): 1 集水面積 (km²)、2 D8 の向き (pyflwdir の符号: 1 東、2 南東、4 南、8 南西、16 西、32 北西、64 北、128 北東、0 流出口と sink)、3 川 (1 か 0)、4 HAND (m)、5 窪地を埋めた DEM (m)。3 と 4 は --stream-km2 を付けたときだけ。流出点の結果は OUT.points.csv (id、x、y、row、col、snapped、snap_m、upstream_km2、catchment_km2、catchment_cells、edge_cells)。流出点が入れ子 (ダムの上流のダム) なら、それぞれが自分の流域の全体を持つ (重なる)。
テストは uvx --python 3.12 --with pyflwdir --with numpy --with rasterio --with pyproj --with pytest pytest scripts/test_hydro.py。窪地を通って全セルが出口に集まること、窪地が下流の隣の高さまで埋まること、最急降下と pyflwdir の向きの違い、平らな湖が回らずに流れ出ること、閉じた盆地を sink にしても範囲の端が流出口のまま残ること、尾根で分かれた 2 つの谷、尾根に囲まれた流域のセル数と端の警告、最寄りの川のセルに寄せること、寄せる先の無い点、HAND が谷の横で 1 セルあたり 1 m になること、NoData、CRS の検査 (CRS 無し、経緯度、Web メルカトル、フィート)、コマンドの出力を確かめている。対角の距離で割らない、最大の集水面積に寄せる、端の警告を外す、尺度の検査を外す、sink を渡すとき端を外す、最急降下を外す、のそれぞれで落ちることを確かめてある。
外部の実装との照合は uvx --python 3.12 --with pyflwdir --with numpy --with rasterio --with pyproj --with whitebox_workflows --with geopandas --with pytest pytest scripts/test_hydro_crosscheck.py。GEOAI_REALDATA=1 を付けると、AW3D30 で相模川の 3 ダムの集水面積を国土交通省の値と比べる (結果は validation)。
まだできないこと
- 流向は D8 だけ。D∞ や多方向 (MFD) で水を分ける方法は無い。尾根や扇状地では、D8 の 1 方向の流れが実際の広がりを表さない。
- 窪地を削る (breach) 方法、川の線を DEM に焼き込む (stream burning) 方法は無い。市街地の暗渠や水路は、DEM に無ければ流れに入らない。
- 流域の境界をベクタ (面) にして書き出さない。流域はラスタのセルの集まりとして数える。
- 雨、時間、流量は扱わない。HAND は浸水の深さではない (川の水位が分からなければ、浸水の範囲にはならない)。
- 600 万セルで最大メモリ約 1 GB、約 30 秒 (validation)。全体を 1 度にメモリへ読む。
書き出すもの
- DEM の名前、版、DSM か DTM か、解像度、取得日。再投影したなら、変換先の CRS と方法
- 範囲 (経緯度の矩形) と、流出点ごとの
edge_cells(0 であること) - CRS、画素の大きさ (m)、面積の尺度の最大のずれ
- 閉じた盆地として渡した点と、それぞれへ集まる面積。渡さない場合との差。どれを閉じた盆地としたかの根拠
- 流向の規則 (窪地を埋めてから 8 近傍の最急降下)
- 流出点ごとの、元の座標、寄せた距離、寄せる条件 (
--snap-m、--snap-min-km2)、集水面積 - 川の閾値 (
--stream-km2) と、HAND を使うなら閾値を変えたときの変わり方 - 公表値と照合したなら、その出典と差 (%)
- セルの数 (有効、NoData)、流出口と窪地の数
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

