跳到內容

坵塊坡度圖與坡向圖

用 SWC Grid Slope 外掛一次產出

M5進階約 40 分鐘

草稿|尚未在 QGIS 4 實機驗證

天祥一帶 坵塊法坡度圖(25 公尺方格)

天祥一帶 坵塊法坡度圖(25 公尺方格)

  • 一至七級坡
資料:內政部 20 公尺網格數值地形模型(政府資料開放授權),20 公尺網格處理:以本站自寫的坵塊法公式重算,與 SWC Grid Slope 外掛輸出不一定逐格相同;numpy 自算;未經 QGIS 4 實機產出

上一單元的手動坵塊法要十個步驟,方格不能旋轉,交點標註、坡向圖和出圖版面也都得自己做。基地一多或要試不同方格擺法時,手動流程太慢。SWC Grid Slope 是 huangyoshi(黃敏郎)寫的 QGIS 外掛,把坵塊法的計算、坡向、標註與出圖版面包在一起。

項目 內容(本站查證日:2026-11-22)
名稱 SWC Grid Slope(坵塊法坡度分析)
作者 黃敏郎(Min-Lang Huang),外掛庫維護者帳號 yoshihuang
版本 1.4.1
支援 QGIS 最低 3.22、最高 4.99;metadata 標示 supportsQt6=True
授權 GPL-2.0-or-later(原始碼 LICENSE 檔與 GitHub README)
原始碼 github.com/yoshihuang/swc_grid_slope
外掛頁 plugins.qgis.org/plugins/swc_grid_slope

外掛說明明確寫著它是獨立工具,不是農業部農村發展及水土保持署的官方產品;README 也提醒成果應由專業技師確認。

  • 地形:等高線圖層(要有高程欄位,外掛可自動偵測 Δh),或 DEM(外掛用 GDAL 依你指定的 Δh 產生等高線)。
  • 計畫範圍:面圖層,必填。1.2.1 版起沒有計畫範圍或方格未完整涵蓋計畫範圍時,外掛會拒絕計算。
  • 建築範圍(選用):面圖層,用來做方格自動搜尋與建物範圍內的坵塊統計。
  • 坐標系:公尺單位的投影坐標系,例如 EPSG:3826 或 EPSG:3825。
  1. 安裝:外掛 Plugins ▸ 管理與安裝外掛 Manage and Install Plugins,搜尋「SWC Grid Slope」安裝。完成後工具列會出現圖示,選單在 外掛 Plugins ▸ 坵塊法坡度分析。

  2. 開啟面板,選擇地形來源(等高線或 DEM)、高程欄位或 Δh、計畫範圍圖層。

  3. 選坵塊邊長:10 公尺或 25 公尺(只有這兩個選項,對應規範第 25 條)。

  4. 在地圖上畫分析框(矩形),可以移動、旋轉、縮放。外掛會從分析框左上角開始排方格,分析框會自動擴大到包住計畫範圍,只產生與計畫範圍有交集的方格。

  5. 選用:指定建築範圍圖層後,可以跑「坵塊自動搜尋」,在 -45° 到 45° 之間試旋轉角度、在一格以內試位移,找出讓建物範圍內高級坡格數最少的擺法(1.4.1 版預設目標是「超過 N 級坡的格數最少」,N 預設 3)。

  6. 按「產出坵塊並計算坡度及坡向」。

  7. 檢查結果後,用面板的存檔功能把專案輸出到資料夾:一個新的 .qgz 專案和一個包含所有圖層的 GeoPackage。版面可匯出 PDF 或 PNG。

外掛也提供 Processing 演算法(提供者 ID swcgridslope、演算法名稱 gridslope,顯示為「坵塊法坡度分析(Grid method slope analysis)」),可放進 圖形化建模器 Model Designer 批次處理。Processing 版的參數有:等高線或 DEM、Δh、坵塊邊長(10/25 公尺)、圓周率(「3.14(規範)」或 Python 的 math.pi)、計畫範圍(必填)、是否計算坡向。

以下依外掛 1.4.1 版原始碼(core.py,GPL-2.0-or-later)閱讀整理,說明它怎麼算,方便你判斷結果能不能用。本站沒有轉載程式碼。

  • 公式與規範第 25 條相同:S = n × π × Δh / (8L) × 100,π 預設 3.14,可改成完整圓周率。
  • 傾斜角 θ = atan(S / 100),換成度。
  • 分級採規範第 23 條七級,邊界用「≦」歸入較低級(例如 S 剛好 30% 為三級坡),和上一單元的分級表一致。
  • 方格邊長 10 公尺(2.4×1.6 公里視窗)

  • 方格邊長 25 公尺(同一視窗)

  • 每條方格邊與等高線求交點,邊上交點數記在邊上。
  • 每格的 n 是四邊交點中「相異的點」個數:等高線剛好通過方格角點,同一點在同一格只算一次。這是外掛的實作選擇,規範條文沒有明訂,見上一單元的說明。
  • 相鄰兩格共用的邊,交點兩格都算。

外掛標示坡向依規範第 26 條,定義為方格內垂直等高線向下坡的方向。實作上外掛在方格周圍取等高線節點(或 DEM 取樣點),用最小平方法擬合一個平面,平面的下坡方向就是坡向,北為 0°、順時針,再歸成八方位箭頭。方格外擴半格仍只有單一高程時,會逐步擴到一格、兩格,還是只有一個高程才標為「平坦」。

項目 手動流程(01 單元) SWC Grid Slope
方格旋轉 不行(Create grid 無旋轉參數) 可,並可自動搜尋角度與位移
角點計數 自己決定並自己去重 同格同點只算一次
坡向 要另外做 平面擬合,八方位箭頭圖
標註 自己設標籤 仿傳統手繪坵塊圖,邊上交點數、格中 n 與 S
出圖 自己做版面 坡度圖、坡向圖兩個版面,含圖例、比例尺、統計表
可追溯性 每一步的中間圖層都在 交點、邊線、方格圖層都會輸出,可抽查

自動搜尋會在規範允許的方格大小內,找出讓建物範圍坡度級別最有利的擺法。這在技術上可行,但方格擺放若沒有統一規則,同一塊地可以算出不同結論。

症狀 原因 解法
按下計算沒有反應或跳警告 沒選計畫範圍,或分析框沒完整包住計畫範圍(1.2.1 版起強制) 指定計畫範圍圖層,重新調整分析框
DEM 產生的等高線沿邊界出現假線 DEM 邊緣或 NoData 處理不當 確認 DEM 的 NoData 值有設定;外掛已將裁切範圍限制在 DEM 內,仍有問題就先自行裁切 DEM
坡度結果和手算差一點點 圓周率選了 math.pi 而不是規範的 3.14 Processing 參數或面板改回 3.14
存檔後打開專案圖層遺失 沒用外掛的存檔功能,記憶體圖層未寫入 用外掛面板存成資料夾(.qgz 加 GeoPackage)
SWC Grid Slope v1.4.1作者 huangyoshi1.4.1 版功能示範,含自動搜尋與建築範圍統計。
QGIS plugin - SWC Grid Slope作者 huangyoshi外掛完整操作流程。
  1. 用同一組等高線與計畫範圍,分別用 01 單元手動流程和外掛(不旋轉、起點相同)各算一次,比較每格 n 值。
    • 檢查方式:n 不同的格子,應該都是等高線通過角點或與邊重合的位置。
  2. 把圓周率從 3.14 改成 math.pi,看哪些格子級別改變。
    • 檢查方式:只有 S 落在級距邊界附近(例如 29.9% 到 30.1%)的格子會變。
  3. 在外掛輸出的 GeoPackage 裡找出方格圖層,用欄位計算機以 n、L、dh 欄位重算 S,確認和 S_pct 欄位一致。
    • 檢查方式:兩者差值應為 0(或只有浮點誤差)。