[general]
name=SCIMAP Toolkit
name[de]=SCIMAP Toolkit
name[es]=SCIMAP Toolkit
qgisMinimumVersion=3.28
qgisMaximumVersion=4.99
description=SCIMAP tools for catchment delineation, sediment and FIO risk mapping, network index, and flood risk mapping, with a guided panel, land cover risk weighting, and automatic result styling.
description[de]=SCIMAP-Werkzeuge für Einzugsgebietsabgrenzung, Sediment- und FIO-Risikokartierung, Netzwerkindex und Hochwasserrisikokartierung, mit geführtem Bedienfeld, Landbedeckungs-Risikogewichtung und automatischer Ergebnisdarstellung.
description[es]=Herramientas SCIMAP para delimitación de cuencas, cartografía de riesgo de sedimentos y FIO, índice de red y riesgo de inundación, con panel guiado, ponderación de riesgo por cobertura del suelo y estilo automático de resultados.
version=1.10.0
author=Sim M. Reaney, Durham University
email=sim.reaney@durham.ac.uk
about=Calculates SCIMAP spatial indices including network connectivity, erosion risk, in-channel risk, seasonal FIO delivery risk, and flood mean/stdev outputs using Whitebox Workflows hydrological processing (depression breaching, FD8 and D8 flow routing, D-infinity mass flux, watersheds and downslope distances) and a flow-path trace connectivity approach. Tools: SCIMAP Sediment, SCIMAP FIO, Delineate Catchment, Apply Land Cover Risk Weights, Network Index, SCIMAP Flood, Overland Flow Distance to Point, Export SCIMAP Results, and the three SCIMAP Fitted tools, numbered to be run in order (1 Catchment Statistics, 2 Calibrate Weights, 3 Ensemble Risk Maps), which infer land cover risk weights from observed water quality rather than assuming them. A guided SCIMAP panel mirrors the SCIMAP web application workflow with click-on-map pour points and impact points, an editable risk weight table, and parameter set XML that is interchangeable with the web application. Land cover rasters are reclassified into SCIMAP risk weights in the plugin, so no pre-weighted raster is required. Outputs are styled automatically with percentile-stretched colour ramps and can be exported as GeoPackage, KML, point vectors, or Cloud-Optimised GeoTIFF. Needs Whitebox Workflows, which the plugin offers to install into the QGIS profile; it has builds for Windows (x64), macOS on Apple silicon and Linux (x86-64). https://doi.org/10.1016/j.ecolmodel.2010.08.022
about[de]=Berechnet SCIMAP-Raumindizes einschliesslich Netzwerkkonnektivität, Erosionsrisiko, Risiko im Gewässer, saisonales FIO-Eintragsrisiko und Hochwasser-Mittelwert-/Standardabweichungs-Ausgaben mit hydrologischer Verarbeitung durch Whitebox Workflows (Senkenentfernung, FD8- und D8-Fließwege, D-Unendlich-Massenfluss, Einzugsgebiete und Hangabwärtsdistanzen) und einem Flussweg-Trace-Konnektivitätsansatz. Werkzeuge: SCIMAP Sediment, SCIMAP FIO, Einzugsgebiet abgrenzen, Risikogewichte der Landbedeckung anwenden, Netzwerkindex, SCIMAP Hochwasser, Oberflächenabflussdistanz zum Punkt, Export von SCIMAP-Ergebnissen sowie die drei SCIMAP-Fitted-Werkzeuge, nummeriert in der Reihenfolge ihrer Ausführung (1 Einzugsgebietsstatistik, 2 Gewichte kalibrieren, 3 Ensemble-Risikokarten), die Risikogewichte der Landbedeckung aus gemessener Wasserqualität ableiten, statt sie anzunehmen. Ein geführtes SCIMAP-Bedienfeld bildet den Arbeitsablauf der SCIMAP-Web-Anwendung ab, mit Auslass- und Wirkungspunkten per Mausklick, einer editierbaren Risikogewichtstabelle und Parametersatz-XML, das mit der Web-Anwendung austauschbar ist. Landbedeckungsraster werden im Plugin in SCIMAP-Risikogewichte umklassifiziert, ein vorgewichtetes Raster ist nicht erforderlich. Ausgaben werden automatisch mit perzentilgestreckten Farbverläufen dargestellt und lassen sich als GeoPackage, KML, Punktvektor oder Cloud-optimiertes GeoTIFF exportieren. Benötigt Whitebox Workflows, das das Plugin im QGIS-Profil installieren kann; es gibt Builds für Windows (x64), macOS auf Apple Silicon und Linux (x86-64). https://doi.org/10.1016/j.ecolmodel.2010.08.022
about[es]=Calcula índices espaciales SCIMAP, incluida la conectividad de red, el riesgo de erosión, el riesgo en cauce, el riesgo estacional de aporte de FIO y las salidas de media/desviación estándar de inundación, mediante el procesamiento hidrológico de Whitebox Workflows (eliminación de depresiones, rutas de flujo FD8 y D8, flujo de masa D-infinito, cuencas y distancias pendiente abajo) y un enfoque de conectividad por trazado de flujo. Herramientas: SCIMAP Sedimento, SCIMAP FIO, Delimitar cuenca, Aplicar ponderaciones de riesgo de cobertura del suelo, Índice de red, SCIMAP Inundación, Distancia de flujo superficial al punto, Exportar resultados de SCIMAP y las tres herramientas SCIMAP Fitted, numeradas según el orden de ejecución (1 Estadísticas de cuenca, 2 Calibrar ponderaciones, 3 Mapas de riesgo de conjunto), que infieren las ponderaciones de riesgo de cobertura del suelo a partir de la calidad del agua observada en lugar de suponerlas. Un panel guiado reproduce el flujo de trabajo de la aplicación web SCIMAP, con puntos de desagüe y de impacto seleccionables en el mapa, una tabla editable de ponderaciones de riesgo y XML de conjuntos de parámetros intercambiable con la aplicación web. Los rásteres de cobertura del suelo se reclasifican en ponderaciones de riesgo SCIMAP dentro del complemento, por lo que no se requiere un ráster preponderado. Las salidas se estilizan automáticamente con rampas de color ajustadas por percentiles y pueden exportarse como GeoPackage, KML, vectores de puntos o GeoTIFF optimizado para la nube. Necesita Whitebox Workflows, que el complemento puede instalar en el perfil de QGIS; hay versiones para Windows (x64), macOS con Apple silicon y Linux (x86-64). https://doi.org/10.1016/j.ecolmodel.2010.08.022
tracker=https://github.com/simreaney/SCIMAP-QGIS/issues
repository=https://github.com/simreaney/SCIMAP-QGIS
category=Processing
hasProcessingProvider=yes
homepage=https://scimap.org.uk
tags=scimap,hydrology,erosion,diffuse pollution,risk,flood,catchment,watershed,fio,water quality,land cover
icon=icons/icon.svg
changelog=1.10.0 - The hydrology now runs in Whitebox Workflows instead of the WhiteboxTools program, which is no longer developed. You no longer download whitebox_tools or point the plugin at it: when it loads, the plugin offers to install Whitebox Workflows into the QGIS profile (also in the SCIMAP panel under Settings, Python packages, Install…), and the WhiteboxTools executable parameter and setting are gone. Whitebox Workflows has builds for Windows (x64), macOS on Apple silicon and Linux (x86-64) only, so Intel Macs and ARM Linux are no longer supported. Results match WhiteboxTools to within single-precision rounding, except where the DEM's depressions are removed: Whitebox Workflows has no BreachDepressions, so the default now breaches them along the least-cost route and fills whatever it cannot breach. On 5 m LiDAR the flow directions this gives agree with the old ones on 87 to 95%% of cells, so results from the default settings change. A DEM compressed with a TIFF predictor, which Whitebox Workflows would read as wrong values, is given to it as a plain copy, and a DEM stored south-up is refused with how to fix it. SCIMAP Sediment and SCIMAP FIO now also write the critical source areas as a polygon layer, so you no longer have to build a web dashboard to get them: the same ten areas, ranked and with the same drivers as the dashboard's Where to act first list, in the DEM's coordinate system. Each area records its rank, whether erosion, connectivity or both puts it there, its area in hectares, its share of the catchment's erosion risk times connectivity, and its mean scores, and is outlined on the map in its driver's colour and numbered by rank. The new Critical Source Areas output is made by default and can be switched off in the Processing dialog; the SCIMAP panel adds it to the map after each run. You can now choose how the DEM's depressions are removed, from every Whitebox Workflows method that does it on its own: least-cost breaching then filling what remains (the default, as before), filling by priority flood, by Wang and Liu or by Planchon and Darboux, least-cost breaching alone, breaching or filling single-cell pits only, the SCIMAP web application's sequence, or none, for a DEM you have conditioned yourself. The choice is a new DEM pre-processing parameter of every tool that routes flow over a DEM: SCIMAP Sediment, SCIMAP FIO, Network Index, Delineate Catchment, Overland Flow Distance to Point and SCIMAP Fitted 1 and 3. In the SCIMAP panel it is on a new Settings tab, shown as a spanner, with the Python packages that used to sit at the bottom of the Results tab; it applies to every run from the panel and replaces the Catchment tab's Breach depressions tick box, so a catchment and the risk mapping run on it always route flow the same way. The panel is also shorter: the Flood tab picks its rainfall pattern and overland flow distance rasters from drop-down tick lists, which follow the layers in the project, so the Refresh raster lists button is gone, and its tallest tab is now about 170 pixels shorter. Fixed the web dashboard's 3D terrain, and the 3D models exported from it, covering the whole DEM rather than the catchment: given a catchment boundary, Create Web Dashboard now clips the DEM to it, which also spends the dashboard's detail on the catchment and puts the clipped DEM in the download bundle. A new option turns this off. The SCIMAP panel now gives the dashboard the catchment the run was clipped to, which it had left out unless that catchment was delineated in the same session.
 1.9.1 -The SCIMAP tools now need about a quarter of the memory they did, so larger catchments run on the same computer. Each model works through its rasters a block of rows at a time instead of holding them all in memory, and the connectivity calculation keeps its grids in single rather than double precision. On a DEM of 4000 by 4000 cells, SCIMAP Sediment's peak memory falls from 2.1 GB to 0.6 GB, SCIMAP Flood's from 2.4 GB to 0.6 GB, and SCIMAP Fitted's catchment statistics from 2.6 GB to 0.7 GB. Results are the same as before to within single-precision rounding, and run times are unchanged. A run that fails part of the way through now removes the outputs it had already written.
 1.9.0 - The plugin can now install its optional Python packages for you: numba, which makes the connectivity and flood calculations many times faster on large rasters, and matplotlib for the SCIMAP Fitted plots. It offers when numba is missing, and the panel's Settings group has an Install button. pip puts them in a folder in the QGIS profile rather than in QGIS's own Python, keeps the NumPy QGIS ships, and picks the newest numba that supports it. Restart QGIS after installing numba to start using it. The SCIMAP panel opens a quarter wider, and can be dragged to any width, which it remembers; it used to be fixed at 340 pixels, which cut off the longer labels. In the web dashboard, the layer and feature tick boxes and opacity sliders now drive the 3D terrain as well as the 2D map, replacing the separate 3D button that draped one layer at a time: the 3D view shows every ticked layer, and now also draws the catchment boundary, pour point and stream risk points. Where layers overlap, the one higher in the list is drawn on top in both views and in saved map images, rather than whichever was ticked last. The dashboard can save the 3D model as USDZ, which opens in AR Quick Look on an iPhone or iPad at the printed size; the exported models are also smaller, with each vertex of the base stored once. The dashboard's Analysis tab now opens with Where to act first: the critical source areas, which are contiguous patches of the catchment's top 5%% of land by erosion risk times connectivity. The ten largest are listed with whether erosion, connectivity or both puts them there, outlined on the map and the 3D terrain, and offered as a GeoJSON download. SCIMAP Sediment and Apply Land Cover Risk Weights now ask which classification the land cover map uses, as the SCIMAP Fitted tools do: CEH LCM 2015+, CEH LCM 2007 (the default, as before), ESA WorldCover, land cover already in SCIMAP classes, or a custom remap table, which is read only for Custom. This replaces the "Land cover already uses SCIMAP classes" tick box. ESA WorldCover is built in and adds two SCIMAP classes, 8 Snow and 9 Water, each with a default risk weight of 0.5, the same as Other. The SCIMAP models, the KML stream network export and the web dashboard now accept a DEM or other layer whose file records its coordinate system by name only, with no datum or projection, as some NZTM (EPSG:2193) GeoTIFFs do. GDAL reads such a layer as a local coordinate system that cannot be reprojected, so aligning a rainfall map in another coordinate system failed with "Cannot find coordinate operations". The name is now looked up in the EPSG database, and a name it does not recognise gives a clear message asking you to assign the layer's coordinate system. WhiteboxTools cannot read GeoTIFFs compressed with LERC, ZSTD or LZMA, such as LINZ's LiDAR COGs, or written with the floating-point predictor, nor GDAL virtual rasters; it stopped with "only supports PACKBITS, LZW, and DEFLATE compression". It is now given a readable copy of such a DEM for the run, which is deleted afterwards.
 1.8.0 - The SCIMAP models now come from pySCIMAP, a Python package bundled inside the plugin and shared with the SCIMAP web application, so both give the same answers from the same data. Fixed mass-flux routing on recent GDAL (3.13): the plugin wrote its loading and absorption rasters in a way GDAL read back with zeros turned into nodata, which corrupted SCIMAP risk concentration, the stream network risk values and stream risk points, the SCIMAP Fitted dilution factor and the Fitted ensemble maps. SCIMAP Fitted 3 can now route on the breached DEM that SCIMAP Fitted 1 writes; WhiteboxTools could not read it before. The SCIMAP land cover class raster now records 0 as no data. Land cover resampled onto a coarser DEM grid now takes the majority class rather than the nearest cell, and continuous rasters resampled onto a coarser grid are averaged rather than interpolated. The progress bar no longer steps back during the connectivity calculation.
 1.7.0 - Added SCIMAP Fitted, which infers land cover risk weights from observed water quality instead of assuming them, in three tools numbered to be run in order. Catchment Statistics delineates the catchment upstream of each monitoring site and summarises risk per land cover class inside it. Calibrate Weights searches weight space by Latin hypercube for the weights that rank the sites in the same order the observations do, scored by Spearman rank correlation; it can cross-validate, which is the check on whether a high correlation is real or an artefact of searching a large space with few observations. Ensemble Risk Maps propagates the best weight sets back onto the grid as mean/standard deviation, median/IQR and 'no regrets' priority rasters - the last showing, per cell, how many weight sets put it in their top tier, so you can see what is worth acting on whichever calibration turns out to be right. Routing runs once per land cover class rather than once per weight set, which is what makes the ensemble affordable. Fitted weights export as a parameter set XML that loads straight into Apply Land Cover Risk Weights and SCIMAP Sediment. The land cover classification scheme is now chosen explicitly: UKCEH changed its class list at LCM2015, and reading a 2015-or-later raster with the older 23-class table silently mapped Urban and Suburban to 'Other'.
 1.6.7 - Exported 3D models are now scaled to a chosen printed size (200 mm by default), centred and standing on zero, which also removes the near-coincident faces that printing services flagged: at catchment scale a single-precision step is about a millimetre, at 200 mm it is about 8 nanometres. Fixed the drape coming out upside down in glTF exports, caused by a bug in three.js r147's GLTFExporter, which sets a flip transform on its canvas and then writes DataTextures with putImageData, which ignores it. Fixed the exported model coming out smaller than asked for and off centre, because the terrain geometry holds grid vertices outside the catchment that no triangle uses.
 1.6.6 - Fixed a crash at the end of every panel run: recording the run details for the dashboard treated the land-cover class list as a dictionary. The analysis itself had already finished and its layers were loaded, but the panel reported a Python error and skipped any dashboard build. Recording run details can no longer fail a finished run.
 1.6.5 - Exported 3D models are now closed, watertight solids that 3D printing slicers accept without repair. The underside is added on export, and the sides now follow the outline of the terrain triangles rather than the grid of cells with data, which had left every diagonal along the catchment boundary open.
 1.6.4 - The dashboard can now save the 2D map as a PNG at screen or print size with a scale bar, and export the 3D terrain as glTF (.glb, keeping the draped colours), STL for 3D printing, or OBJ. Fixed the 3D controls being pushed off the bottom of the rail by the layer list, which made them look absent on a laptop screen; they now sit at the top whenever the 3D view is open. Adds the vendored three.js r147 exporters.
 1.6.3 - The dashboard risk-concentration chart now covers the whole landscape rather than only the channel network, answering how much of the catchment produces how much of the risk: the highest-risk 1/5/10/25/50%% of the ground against the risk it carries, the area needed to capture 50/80/95%% of the risk, and a Gini coefficient. It follows the layer chosen for the histogram. Added an optional slow automatic orbit to the 3D view, and fixed the animated flow so its risk colouring is actually visible - it was brightened by a per-channel offset that saturated two channels at every risk level.
 1.6.2 - Fixed result layers staying invisible in the web dashboard when switched on: any layer not shown by default was created fully transparent, so ticking it did nothing while its opacity slider still read 100%%. Added a choice of background map in the 2D view - shaded relief, Esri Street Map, Esri Dark Gray and Esri Satellite - as proper base layers with attribution; online basemaps are now offered by default, with the offline relief still selected on opening.
 1.6.1 - Fixed an error on unload when a second copy of the plugin is installed. QGIS deletes a Processing provider whose id is already taken, so the duplicate now detects this, leaves the algorithms and menus to the copy that registered first, and says so in the Log Messages panel.
 1.6.0 - Added Create Web Dashboard: exports results as a self-contained folder with a zoomable 2D map, a 3D terrain view with draped risk and animated flow, interactive charts, run provenance and a download bundle. Opens offline by double-clicking index.html; no web server or GIS needed. Available from the Results tab of the SCIMAP panel, the Processing toolbox, and optionally after every run. Adds vendored Leaflet 1.9.4 and three.js r147, which grows the plugin download from about 100 KB to about 400 KB.
 1.5.1 - Added SCIMAP FIO, catchment delineation, land cover risk weighting with parameter set XML, result export tools, automatic colour-ramp styling, a guided SCIMAP panel with click-on-map point picking, cancellable runs, and automatic input grid alignment. Refactored into core/algorithms/gui packages. Fix issue with Whitebox Tools on Windows.
