Template:SRP Watersheds from Raster: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(Created page with "__NOINDEX__ __NOTOC__ ===Watershed from Raster=== The ''Watershed from Raster'' tool derives a watershed and its streams locations from an elevation raster and one or more outlet locations. This is actually a workflow that invokes several tools sequentially. The tools that are invoked include: *''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#BreachDepressions Breach Depressions Least Cost]'' *''[https://www.whiteboxgeo.com/manual...")
 
No edit summary
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOINDEX__
__NOINDEX__
__NOTOC__
__NOTOC__
===Watershed from Raster===
===SRP Watersheds from Raster===
The ''Watershed from Raster'' tool derives a watershed and its streams locations from an elevation raster and one or more outlet locations. This is actually a workflow that invokes several tools sequentially. The tools that are invoked include:
The ''SRP Watersheds from Raster'' tool derives a set of watershed and their stream locations from an elevation raster and a set of polygons representing a forest treatment area as shown in the images below.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#BreachDepressions Breach Depressions Least Cost]''
 
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#Rho8Pointer Rho8 Flow Directions]'' or ''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#D8Pointer D8 Flow Directions]'' (Depending on the selected pre-processing engine)
:[[Image:srp_watersheds_from_raster_1.png|thumb|none|500 px| Input raster and treatment area polygon.]]
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#D8FlowAccumulation D8 Flow Accumulation]''
 
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/stream_network_analysis.html#ExtractStreams Extract Streams]''
:[[Image:srp_watersheds_from_raster_2.png|thumb|none|500 px| Watershed polygons containing treatment areas.]]
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/stream_network_analysis.html#RasterStreamsToVector Streams from Raster]''
 
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#JensonSnapPourPoints Snap Outlet Points to Streams]''
This tool uses a workflow that invokes several tools and commands included in the toolbox. The following procedure is used to derive the set of watersheds that correspond to a treatment area:
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#Watershed Watershed Delineation]''
*The depressions are filled using the ''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#FillDepressions Fill Depressions]'' tool.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/data_tools.html#RasterToVectorPolygons Polygons from Index Raster]''
*The treatment area is converted to a single polygon using the ''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/gis_analysis.html#Dissolve Dissolve]'' tool.
After these tools the following operations are performed:
*After filling the depressions and converting the treatment area to a single polygon, the following loop is run until the tool exits:
*The basin boundary is smoothed
**The ''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#Isobasins Isobasins]'' tool is used with a target grid cell size of 5% of the total number of cells on the input raster. The table showing the upstream/downstream connections between the Isobasins is output from this tool.
*The streams are cleaned and trimmed to the basin
**The Isobasins are converted to a polygon coverage using the ''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/data_tools.html#RasterToVectorPolygons Polygons from Index Raster]'' tool.
**The polygons in the Isobasins coverage are joined with the CSV table output from the Isobasins tool to determine the upstream/downstream connections for each polygon using the ''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/data_tools.html#MergeTableWithCsv Merge Table with CSV]'' tool.
**The Isobasins falling inside the boundary of the treatment area are identified by checking if any boundary point on each Isobasin is located inside the treatment area.
**Any Isobasins upstream of the Isobasins containing the treatment area are included in the list of treated Isobasins.
**The most downstream treated Isobasin is determined for each Isobasin in the list.
**The watershed ID of the most downstream treated Isobasin is assigned to each cell of a new raster containing watersheds for the treatment areas.
**This new raster containing the watershed IDs is converted to polygons in a coverage using the ''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/data_tools.html#RasterToVectorPolygons Polygons from Index Raster]'' tool.
**If the number of watershed polygons is less than the user-specified maximum number of models and the percent of untreated area is less than the user-specified maximum percentage of untreated area, a solution has been found and the filled raster, a coverage containing the watershed boundary polygons, and the streams located within the watershed boundaries are returned.
**If both the number of watershed polygons and the percentage of untreated area are both greater than the user-specified values, a solution that satisfies the input data cannot be found.  An error is reported and the tool exits.
**If the number of watershed polygons is LESS THAN the user-specified maximum number of models and the percent of untreated area is GREATER THAN the user-specified maximum percentage of untreated area, the target grid cell size for the Isobasins tool is reduced by half and the Isobasins tool and the following steps are run again.
**If the number of watershed polygons is GREATER THAN the user-specified maximum number of models and the percent of untreated area is LESS THAN the user-specified maximum percentage of untreated area, the target grid cell size for the Isobasins tool is doubled and the Isobasins tool and the following steps are run again.
**If a certain target grid cell size for the Isobasins tool has already been used, a solution cannot be found and the tool exits with an error message.


====Input Parameters====
====Input Parameters====
*''Input raster'' – Select the input elevation raster.
*''Input raster'' – Select the input elevation raster.
*''Outlet coverage'' – Select a coverage containing one or more outlet points close to the watershed and/or sub-basin outlet(s).  These points do not need to be directly on a flow accumulation cell since the algorithm searches for the closest stream to the defined outlet locations.
*''Treatment areas'' – Select a coverage containing one or more polygons containing watershed treatment areas.  The treatment areas should at least be located within the boundaries of the input elevation raster, but it is not guaranteed that the watersheds from this tool will be correct if the final watershed boundaries fall outside the edges of the elevation raster.
*''Threshold area'' – The threshold area to use for stream or ridge generation.
*''Maximum number of models'' – The maximum number of watershed polygons allowed from running the tool (assuming 1 model for each polygon).
*''Pre-processing engine'' – Select which pre-processing engine to use.
*''Maximum percentage of untreated area'' – The maximum percentage of untreated area in the final models.
**"[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#Rho8Pointer rho8]" – Computes flow directions and accumulations using the Rho8 algorithm.
**"[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#FlowAccumulationFullWorkflow Whitebox full workflow]" – Computes flow directions and accumulations using the Whitebox tool full workflow algorithm that uses a standard D8 method for computing flow directions.


====Output Parameters====
====Output Parameters====
*''Output coverage'' – Defines the name of the tool-generated output coverage containing the watershed boundary.
*''Filled raster'' – The name of the pit-filled raster that's output from this tool.
* Coverages containing the modified outlet location(s) and the stream locations are also created with this tool. The name of these coverages are currently hardwired to the original raster names with an extension at the end based on the options selected in the tool.
*''Watershed boundaries'' – The name of the watershed boundary coverage containing polygons that are output from this tool.
* Breached, Flow direction, and Flow accumulation rasters are also generated from this tool. The names of these are currently hardwired to the original raster names ending in ''_breached'', ''_flowdir'', and ''_flowaccum'' respectively. An additional extension is added to the end of the raster name based on the pre-processing engine used.
*''Stream lines'' – The name of the coverage containing stream arcs that are output from this tool.


====Current Location in toolbox====  
====Current Location in toolbox====  
Coverages/Watershed from Raster
Coverages/SRP Watersheds from Raster
{{-}}
{{-}}
<noinclude>[[Category:Tools]][[Category:External Links]]</noinclude>
<noinclude>[[Category:Toolbox Coverages]][[Category:External Links]]</noinclude>

Latest revision as of 19:46, 26 October 2023


SRP Watersheds from Raster

The SRP Watersheds from Raster tool derives a set of watershed and their stream locations from an elevation raster and a set of polygons representing a forest treatment area as shown in the images below.

Input raster and treatment area polygon.
Watershed polygons containing treatment areas.

This tool uses a workflow that invokes several tools and commands included in the toolbox. The following procedure is used to derive the set of watersheds that correspond to a treatment area:

  • The depressions are filled using the Fill Depressions tool.
  • The treatment area is converted to a single polygon using the Dissolve tool.
  • After filling the depressions and converting the treatment area to a single polygon, the following loop is run until the tool exits:
    • The Isobasins tool is used with a target grid cell size of 5% of the total number of cells on the input raster. The table showing the upstream/downstream connections between the Isobasins is output from this tool.
    • The Isobasins are converted to a polygon coverage using the Polygons from Index Raster tool.
    • The polygons in the Isobasins coverage are joined with the CSV table output from the Isobasins tool to determine the upstream/downstream connections for each polygon using the Merge Table with CSV tool.
    • The Isobasins falling inside the boundary of the treatment area are identified by checking if any boundary point on each Isobasin is located inside the treatment area.
    • Any Isobasins upstream of the Isobasins containing the treatment area are included in the list of treated Isobasins.
    • The most downstream treated Isobasin is determined for each Isobasin in the list.
    • The watershed ID of the most downstream treated Isobasin is assigned to each cell of a new raster containing watersheds for the treatment areas.
    • This new raster containing the watershed IDs is converted to polygons in a coverage using the Polygons from Index Raster tool.
    • If the number of watershed polygons is less than the user-specified maximum number of models and the percent of untreated area is less than the user-specified maximum percentage of untreated area, a solution has been found and the filled raster, a coverage containing the watershed boundary polygons, and the streams located within the watershed boundaries are returned.
    • If both the number of watershed polygons and the percentage of untreated area are both greater than the user-specified values, a solution that satisfies the input data cannot be found. An error is reported and the tool exits.
    • If the number of watershed polygons is LESS THAN the user-specified maximum number of models and the percent of untreated area is GREATER THAN the user-specified maximum percentage of untreated area, the target grid cell size for the Isobasins tool is reduced by half and the Isobasins tool and the following steps are run again.
    • If the number of watershed polygons is GREATER THAN the user-specified maximum number of models and the percent of untreated area is LESS THAN the user-specified maximum percentage of untreated area, the target grid cell size for the Isobasins tool is doubled and the Isobasins tool and the following steps are run again.
    • If a certain target grid cell size for the Isobasins tool has already been used, a solution cannot be found and the tool exits with an error message.

Input Parameters

  • Input raster – Select the input elevation raster.
  • Treatment areas – Select a coverage containing one or more polygons containing watershed treatment areas. The treatment areas should at least be located within the boundaries of the input elevation raster, but it is not guaranteed that the watersheds from this tool will be correct if the final watershed boundaries fall outside the edges of the elevation raster.
  • Maximum number of models – The maximum number of watershed polygons allowed from running the tool (assuming 1 model for each polygon).
  • Maximum percentage of untreated area – The maximum percentage of untreated area in the final models.

Output Parameters

  • Filled raster – The name of the pit-filled raster that's output from this tool.
  • Watershed boundaries – The name of the watershed boundary coverage containing polygons that are output from this tool.
  • Stream lines – The name of the coverage containing stream arcs that are output from this tool.

Current Location in toolbox

Coverages/SRP Watersheds from Raster

Retrieved from "https://www.xmswiki.com/index.php?title=Template:SRP_Watersheds_from_Raster&oldid=160922"