跳到內容

GDAL、GRASS、SAGA 怎麼啟用

處理工具箱的提供者設定

M0入門約 25 分鐘

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

照著舊教學要做「SAGA 的坡度」或「GRASS 的 r.watershed」,打開處理工具箱卻找不到那一組工具;或是工具找得到,一執行就報「找不到程式」。水保、地質、水文常用的地形與水文演算法很多來自 GRASS 和 SAGA,提供者沒設好,M3、M4、M5 的單元都做不下去。

  • 已安裝的 QGIS(見 01 安裝 QGIS 4)
  • 若要用 SAGA:另外安裝的 SAGA GIS(從 SAGA 官方下載頁或 OSGeo4W 安裝),以及 Processing Saga NextGen Provider 外掛
  • 一份小的 DEM 測試資料,例如從政府資料開放平臺下載的數值地形模型,用來試跑演算法
  1. 開啟 處理 Processing ▸ 工具箱 Toolbox,看清單裡有哪些提供者群組(例如 GDAL、GRASS、QGIS 原生演算法)。

  2. 到 設定 Settings ▸ 選項 Options ▸ 處理 Processing,展開 提供者 Providers。每個提供者都有「啟用」勾選與各自的設定項。

  3. GDAL:隨 QGIS 安裝,通常不需設定。確認已勾選啟用即可。

  4. GRASS:

    • Windows 的獨立安裝檔會自動設定 GRASS;用 OSGeo4W 安裝時,要在安裝程式裡勾選 GRASS。
    • 只有 Windows 使用者可能需要指定 GRASS 資料夾;預設使用隨 QGIS 附帶的 GRASS。
    • 啟用後,工具箱會出現 GRASS 群組,演算法名稱以 r.、v. 開頭。
  5. SAGA:

    • 先安裝 SAGA GIS 本體,記下安裝(或解壓縮)的資料夾。
    • 安裝 Processing Saga NextGen Provider 外掛(安裝方式見 04 外掛管理員)。
    • 回到提供者設定,在 SAGA 的項目中指定 SAGA 資料夾。
    • 工具箱出現 SAGA 群組後,挑一個簡單演算法用測試 DEM 試跑。
  6. 試跑任一演算法時,看「記錄 Log」分頁:外部程式的實際呼叫指令與錯誤訊息都在這裡。

處理工具箱本身只是一個統一的介面。真正執行運算的是各個「提供者」(provider):

提供者 運算由誰執行 安裝方式
QGIS 原生(native) QGIS 本身的 C++ 程式 內建
GDAL GDAL 函式庫與命令列工具 隨 QGIS 安裝
GRASS GRASS GIS 的模組,QGIS 在背景啟動一個暫時的 GRASS 工作區執行 隨 Windows 安裝檔附帶,或 OSGeo4W 勾選
SAGA SAGA GIS 的命令列程式 saga_cmd 自 3.30 起需另裝 SAGA 本體+外掛

外部提供者(GRASS、SAGA)每次執行,QGIS 都要把輸入圖層寫成暫存檔、呼叫外部程式、再讀回結果。所以:

  • 同一個運算,外部提供者通常比原生演算法多一段讀寫時間。
  • 中文路徑、空白、太長的路徑,比較容易在外部程式端出問題。
  • 出錯時,錯誤訊息常來自外部程式本身,要看記錄分頁才知道原因。

SAGA 原本內建在 QGIS。QGIS 開發者在 GitHub 議題 #51041 說明:內建的 SAGA 工具在 3.30 已完全移除,原因是那套提供者已無人維護、也無法配合新版 SAGA。之後改由第三方外掛 Processing Saga NextGen Provider 提供,外掛說明寫明「僅在 SAGA 9.2、9.12 測試過」,且必須另外安裝 SAGA 本體。

這代表兩件事:

  1. SAGA 的演算法名稱、參數,可能和舊教學(3.28 以前)的內建版不同,因為對應的是新版 SAGA。
  2. SAGA 的可用性取決於外掛有沒有人維護。報告或 SOP 若寫死「用 SAGA 某工具」,應同時記下 GRASS 或原生演算法的替代做法。

同一種分析常有多個提供者都能做(例如坡度:原生、GDAL、GRASS、SAGA 都有)。選擇原則:

  • 先用原生或 GDAL:不需外部程式,同事的電腦也一定有。
  • 需要特定方法才用 GRASS/SAGA:例如指定的流向演算法、特定的地形指數。
  • 交付報告時寫清楚:提供者名稱與演算法 ID,不同提供者的同名工具算法可能不同,結果會有差異。
症狀 原因 解法
工具箱沒有 SAGA 群組 3.30 起 SAGA 不再內建 安裝 SAGA 本體與 SAGA NextGen 外掛;外掛不可用時改用 GRASS 或原生演算法
SAGA 演算法一執行就失敗 提供者設定中的 SAGA 資料夾未指定或指錯 在提供者設定指定含 saga_cmd 的資料夾
GRASS 演算法報錯,訊息看不懂 輸入路徑含中文或空白、輸出格式不被支援 把資料放到短的英文路徑,輸出改為 GeoTIFF 或 GeoPackage 再試
舊教學的演算法名稱找不到 演算法改名,或屬於已移除的提供者 在工具箱搜尋框用英文關鍵字(如 slope)搜尋
在QGIS3.34.1中設定SAGA路徑作者 huangyoshi錄製版本 QGIS 3.34示範 3.34 時期設定 SAGA 路徑;QGIS 4 的外掛可用性請先依本頁確認
  1. 打開處理工具箱,列出你的 QGIS 有哪些提供者群組。
    • 檢查方式:至少應有 QGIS 原生與 GDAL;Windows 獨立安裝檔通常也有 GRASS。
  2. 對同一份 DEM,分別用原生演算法與 GDAL 的坡度工具計算坡度,比較兩個結果。
    • 檢查方式:用 點擊識別 Identify Features 在同一點查值,記下差異與兩者的參數差別(例如比例、邊緣處理)。
  3. 在工具箱執行任一 GRASS 演算法後,打開記錄分頁,找出 QGIS 實際呼叫的指令。
    • 檢查方式:記錄中看得到 GRASS 模組名稱(如 r.slope.aspect)與暫存檔路徑。