Upstream Trace

Trace upstream from a point or line feature through a flow network, collecting all upstream features within distance and count constraints. Useful for building drainage basins from stream networks.

ID	vector_upstream_trace
Domain	geo
Category	vector
Type	vector-to-vector
Version	1.0.0

view yaml ◦view github ◦

Parameters

max_distance_km: number · default 20 · Maximum upstream distance to trace (in kilometers)
max_features: integer · default 200 · Maximum number of catchments/features to collect. Features exceeding this limit are considered over-extended.
flow_direction_column: string · default flowdir · Column indicating flow direction in network
network_id_column: string · default comid · Column linking catchments to network features
stop_at_orders: array · default · Stream orders at which to stop tracing (e.g., [4, 5] stops at 4th+ order streams to avoid tracing into major tributaries)
dissolve_output: boolean · default true · If true, dissolve all traced catchments into single polygon