Template:SRP Watersheds from Raster: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
(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...")
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOINDEX__
__NOINDEX__
__NOTOC__
__NOTOC__
===SRP Watersheds from Raster===
===Watershed 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.
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]''
:[[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#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)
 
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#D8FlowAccumulation D8 Flow Accumulation]''
:[[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#ExtractStreams Extract Streams]''
 
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/stream_network_analysis.html#RasterStreamsToVector Streams from Raster]''
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#JensonSnapPourPoints Snap Outlet Points to Streams]''
*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/hydrological_analysis.html#Watershed Watershed Delineation]''
*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.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/data_tools.html#RasterToVectorPolygons Polygons from Index Raster]''
*After filling the depressions and converting the treatment area to a single polygon, the following loop is run until the tool exits:
After these tools the following operations are performed:
**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 basin boundary is smoothed
**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 streams are cleaned and trimmed to the basin
**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.
*''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.
*''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.
*''Maximum number of models'' – The maximum number of watershed polygons allowed from running the tool (assuming 1 model for each polygon).
*''Threshold area'' – The threshold area to use for stream or ridge generation.
*''Maximum percentage of untreated area'' – The maximum percentage of untreated area in the final models.
*''Pre-processing engine'' – Select which pre-processing engine to use.
**"[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====
*''Filled raster'' – The name of the pit-filled raster that's output from this tool.
*''Output coverage'' – Defines the name of the tool-generated output coverage containing the watershed boundary.
*''Watershed boundaries'' – The name of the watershed boundary coverage containing polygons that are 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.
*''Stream lines'' – The name of the coverage containing stream arcs 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.


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

Revision as of 18:19, 16 August 2023


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:

After these tools the following operations are performed:

  • The basin boundary is smoothed
  • The streams are cleaned and trimmed to the basin

Input Parameters

  • 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.
  • Threshold area – The threshold area to use for stream or ridge generation.
  • Pre-processing engine – Select which pre-processing engine to use.
    • "rho8" – Computes flow directions and accumulations using the Rho8 algorithm.
    • "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 coverage – Defines the name of the tool-generated output coverage containing the watershed boundary.
  • 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.
  • 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.

Current Location in toolbox

Coverages/Watershed from Raster

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