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
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. 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#BreachDepressions Breach Depressions Least Cost]''
*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#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)
*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/hydrological_analysis.html#D8FlowAccumulation D8 Flow Accumulation]''
*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.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/stream_network_analysis.html#ExtractStreams Extract Streams]''
*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.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/stream_network_analysis.html#RasterStreamsToVector Streams from Raster]''
*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.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#JensonSnapPourPoints Snap Outlet Points to Streams]''
*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.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/hydrological_analysis.html#Watershed Watershed Delineation]''
*Any Isobasins upstream of the Isobasins containing the treatment area are included in the list of treated Isobasins.
*''[https://www.whiteboxgeo.com/manual/wbt_book/available_tools/data_tools.html#RasterToVectorPolygons Polygons from Index Raster]''
*The most downstream treated Isobasin is determined for each Isobasin in the list.
After these tools the following operations are performed:
*The watershed ID of the most downstream treated Isobasin is assigned to each cell of a new raster containing watersheds for the treatment areas.
*The basin boundary is smoothed
*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.
*The streams are cleaned and trimmed to the basin
*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:Tools]][[Category:External Links]]</noinclude>

Revision as of 19:43, 16 August 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. 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.
  • 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=159891"