坵塊坡度圖與坡向圖
用 SWC Grid Slope 外掛一次產出

天祥一帶
- 一至七級坡
上一單元的手動坵塊法要十個步驟,方格不能旋轉,交點標註、坡向圖和出圖版面也都得自己做。基地一多或要試不同方格擺法時,手動流程太慢。SWC Grid Slope 是 huangyoshi(黃敏郎)寫的 QGIS 外掛,把坵塊法的計算、坡向、標註與出圖版面包在一起。
外掛基本資料
Section titled “外掛基本資料”| 項目 | 內容(本站查證日: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。
操作步驟(QGIS 4)
Section titled “操作步驟(QGIS 4)”-
安裝:外掛 Plugins ▸ 管理與安裝外掛 Manage and Install Plugins,搜尋「SWC Grid Slope」安裝。完成後工具列會出現圖示,選單在 外掛 Plugins ▸ 坵塊法坡度分析。
-
開啟面板,選擇地形來源(等高線或 DEM)、高程欄位或 Δh、計畫範圍圖層。
-
選坵塊邊長:10 公尺或 25 公尺(只有這兩個選項,對應規範第 25 條)。
-
在地圖上畫分析框(矩形),可以移動、旋轉、縮放。外掛會從分析框左上角開始排方格,分析框會自動擴大到包住計畫範圍,只產生與計畫範圍有交集的方格。
-
選用:指定建築範圍圖層後,可以跑「坵塊自動搜尋」,在 -45° 到 45° 之間試旋轉角度、在一格以內試位移,找出讓建物範圍內高級坡格數最少的擺法(1.4.1 版預設目標是「超過 N 級坡的格數最少」,N 預設 3)。
-
按「產出坵塊並計算坡度及坡向」。
-
檢查結果後,用面板的存檔功能把專案輸出到資料夾:一個新的
.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°、順時針,再歸成八方位箭頭。方格外擴半格仍只有單一高程時,會逐步擴到一格、兩格,還是只有一個高程才標為「平坦」。
和手動流程的對照
Section titled “和手動流程的對照”| 項目 | 手動流程(01 單元) | SWC Grid Slope |
|---|---|---|
| 方格旋轉 | 不行(Create grid 無旋轉參數) | 可,並可自動搜尋角度與位移 |
| 角點計數 | 自己決定並自己去重 | 同格同點只算一次 |
| 坡向 | 要另外做 | 平面擬合,八方位箭頭圖 |
| 標註 | 自己設標籤 | 仿傳統手繪坵塊圖,邊上交點數、格中 n 與 S |
| 出圖 | 自己做版面 | 坡度圖、坡向圖兩個版面,含圖例、比例尺、統計表 |
| 可追溯性 | 每一步的中間圖層都在 | 交點、邊線、方格圖層都會輸出,可抽查 |
自動搜尋要小心用
Section titled “自動搜尋要小心用”自動搜尋會在規範允許的方格大小內,找出讓建物範圍坡度級別最有利的擺法。這在技術上可行,但方格擺放若沒有統一規則,同一塊地可以算出不同結論。
| 症狀 | 原因 | 解法 |
|---|---|---|
| 按下計算沒有反應或跳警告 | 沒選計畫範圍,或分析框沒完整包住計畫範圍(1.2.1 版起強制) | 指定計畫範圍圖層,重新調整分析框 |
| DEM 產生的等高線沿邊界出現假線 | DEM 邊緣或 NoData 處理不當 | 確認 DEM 的 NoData 值有設定;外掛已將裁切範圍限制在 DEM 內,仍有問題就先自行裁切 DEM |
| 坡度結果和手算差一點點 | 圓周率選了 math.pi 而不是規範的 3.14 |
Processing 參數或面板改回 3.14 |
| 存檔後打開專案圖層遺失 | 沒用外掛的存檔功能,記憶體圖層未寫入 | 用外掛面板存成資料夾(.qgz 加 GeoPackage) |


- 用同一組等高線與計畫範圍,分別用 01 單元手動流程和外掛(不旋轉、起點相同)各算一次,比較每格 n 值。
- 檢查方式:n 不同的格子,應該都是等高線通過角點或與邊重合的位置。
- 把圓周率從 3.14 改成
math.pi,看哪些格子級別改變。- 檢查方式:只有 S 落在級距邊界附近(例如 29.9% 到 30.1%)的格子會變。
- 在外掛輸出的 GeoPackage 裡找出方格圖層,用欄位計算機以
n、L、dh欄位重算 S,確認和S_pct欄位一致。- 檢查方式:兩者差值應為 0(或只有浮點誤差)。
- 外掛頁:SWC Grid Slope
- 原始碼與 README:yoshihuang/swc_grid_slope
- 《水土保持技術規範》第 23、25 條:農業部主管法規共用系統
- QGIS 文件:Plugins