The Catchment Merge operation can be directly executed by typing one of the following expressions on the command line of the Main window:
OUTNAME |
= |
MapCatchmentMerge(drainorder_rasmap, flowdir_rasmap, flowacc_rasmap, outlet_pntmap, include_undefs, extract_segments) |
OUTNAME |
= |
MapCatchmentMerge(drainorder_rasmap, flowdir_rasmap, flowacc_rasmap, outlet_pntmap, include_undefs, extract_segments, outsegmap_longestFlow) |
OUTNAME |
= |
MapCatchmentMerge(drainorder_rasmap, flowdir_rasmap, flowacc_rasmap, order_system, stream_order) |
OUTNAME |
= |
MapCatchmentMerge(drainorder_rasmap, flowdir_rasmap, flowacc_rasmap, order_system, stream_order, outsegmap_longestFlow) |
where:
OUTNAME |
is an output name that will be used for the output raster map, the output polygon map and the output attribute table. The output maps will contain all sub-catchments (one for each stream); the attribute table will contain information on each sub-catchment. |
MapCatchmentMerge |
is the command to start the Catchment Merge operation. |
drainorder_rasmap |
is a raster map that is the outcome of the Drainage Network Ordering operation, i.e. a raster map with an Identifier domain. |
flowdir_rasmap |
is a raster that is the outcome of the Flow Direction operation, i.e. a raster map with system domain FlowDirection. |
flowacc_rasmap |
is a raster map that is the outcome of the Flow accumulation operation, i.e. a raster map with a value domain. |
outlet_pntmap |
is a point map that contains the outlet locations; all sub-catchments draining to these outlets will be merged into new catchments. |
include_undefs |
true | false | 1 | 0 specify true or 1 when you wish to include pixels that have value undefined in the DEM into a catchment; this option can only be used when the outlet point map contains only a single point. specify false or 0 to do nothing special. |
extract_segments |
true | false | 1 | 0 optionally, specify whether or not a segment map and related attribute table should be created, similar to the output segment map and attribute table of the Drainage Network Ordering operation. Only segments that fall within the new catchments will remain; any other streams will not appear anymore. |
order_system |
strahler | shreve specify whether you wish to use the Strahler or the Shreve ordering system. |
stream_order |
specify a stream order value (integer value > 0); adjacent sub-catchments that have a value smaller than or equal to the specified value and that drain into the same higher order sub-catchment will be merged. |
outsegmap_longestFlow |
optionally, specify a name for an output segment map and related attribute table, that will contain the longest possible flow path in each new catchment. |
When the definition symbol = is used, a dependent output map is created; when the assignment symbol := is used, the dependency link is immediately broken after the output map has been calculated.
See also: