Catchment merge

Command line

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: