The Derive Stream as Line tool generates stream line features from an input surface raster with no prior sink or depression filling required.
The output is a hosted feature layer.
Example
With a digital elevation model (DEM), you can use the tool to delineate a stream network.
Usage notes
Derive Stream as Line includes configurations for input layers, analysis settings, and the result layer.
Input layers
The Input layers group includes the following parameters:
The Input surface raster is the elevation raster that will be used for calculation. It can be a digital elevation model (DEM) with no prior sinks filled or a hydroconditioned DEM.
The tool is not sensitive to errors in the surface raster that can act as depressions or sinks where flow terminates; filling sinks or depressions is not necessary.
If the input surface raster contains real depressions, the locations of the depressions must be specified in the Input depressions raster or features parameter to be considered cells where water can flow into but not out of.
NoData cells in the input surface raster do not have an associated value. These cells are ignored when identifying the direction of the least steep uphill neighbor, as well as the determination of flow direction and accumulation.
- The Optional layers group includes the following parameters:
Input depressions raster or features is the dataset that defines real depressions or sinks, where water can flow into but not out of.
You can choose a layer using the Layer button, or you can create a sketch layer to use as the input using the Draw input features button. For feature inputs, a count of features is displayed below the layer name. The count includes all features in the layer, except features that have been removed using a filter. Environment settings, such as Processing extent, are not reflected in the feature count.
If the input is a raster layer, the depression cells must have a valid value, including zero, and the areas that are not depressions must be assigned NoData.
If the input is a feature layer, it can be point, polyline, or polygon. Feature input will be converted to a raster internally before performing the analysis.
The Input accumulation weight raster parameter defines the fraction of flow that contributes to flow accumulation at each cell.
The weight is only applied to the accumulation of flow.
If a weight raster is applied, specify an appropriate flow accumulation threshold for the Accumulation threshold parameter.
If no accumulation weight raster is provided, a default weight of 1 will be applied to each cell.
Analysis settings
The Analysis settings group includes the following parameters:
The Accumulation threshold parameter specifies the threshold for determining whether a given cell is part of a stream in terms of the total area that flows into such cell.
By default, the tool calculates an area threshold based on the Input surface raster size (0.2 percent of the total number of cells).
If Input depressions raster or features data, Input accumulation weight rasterdata, or data to apply environment settings is used, the default Accumulation threshold value will be recalculated based on the area of intersection between the inputs. However, once you have specified a value for the Accumulation threshold, it will no longer be recalculated based on changes in input selection.
When specifying an Accumulation threshold value, use a value that reflects the complexity of the terrain in the study area or that matches the size of a contributing area of your choice. For example, if the threshold is equal to 20 hectares, only cells with 20 or more hectares of upstream flow will define a stream raster.
The Stream designation method parameter specifies the unique value or order of the stream segments in the output.
-
Constant—The output cell values will all equal 1. This is the default.
Unique—Each stream will have a unique ID between intersections in the output.
Strahler—The Strahler method, in which stream order only increases when streams of the same order intersect, will be used. The intersection of a first-order and second-order link will remain a second-order link, rather than creating a third-order link.
Shreve—The Shreve method, in which stream order is assigned by magnitude, will be used. All links with no tributaries are assigned a magnitude (order) of one. Magnitudes are additive downslope. When two links intersect, their magnitudes are added and assigned to the downslope link.
Hack—The Hack method, in which each stream segment is assigned an order greater than the stream or river to which it discharges, will be used. For example, the main river channel is assigned an order of 1, all stream segments discharging to it are assigned an order of 2, any stream discharging to an order 2 stream is assigned an order of 3, and so on.
All—The output attribute table will show each stream segment designation based on all methods.
-
Simplify features specifies whether the output stream lines will be smoothed into simpler shapes.
- Checked—The output stream line features will be simplified by removing vertices using the Douglas-Peucker algorithm with a tolerance of sqrt(0.5) * cell size. This algorithm retains critical points by identifying and removing relatively redundant vertices. This is the default.
- Unchecked—The output stream line features will not be smoothed.
Result layer
The Result layer group includes the following parameters:
The Output stream features name parameter is the name of the output features that will contain the identified streams.
The name must be unique. If a layer with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.
- Save in folder specifies the name of a folder in My content where the result will be saved.
Environments
Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.
This tool honors the following analysis environments:
- Output coordinate system
- Geographic transformations
- Processing extent
Note:
The default processing extent is Full extent. This default is different from Map Viewer Classic in which Use current map extent is enabled by default.
Credits
This tool consumes credits.
Use Estimate credits to calculate the number of credits that will be required to run the tool. For more information, see Understand credits for spatial analysis.
Output
This tool produces features that contain the identified streams as output.
Usage requirements
This tool requires the following user type and configurations:
- Professional or Professional Plus user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role with the Imagery Analysis privilege
References
Douglas, David H., andThomas K.Peucker. 1973. "Algorithms forthe Reduction ofthe Number of Points Requiredto RepresentaDigit isedLine or its Caricature."The Canadian Cartographer, 10(2): 112-122.
Ehlschlaeger, C. R. 1989. "Using the AT Search Algorithm to Develop Hydrologic Models from Digital Elevation Data." International Geographic Information Systems (IGIS) Symposium 89: 275-281.
Hack, J. T. 1957. "Studies of Longitudinal Stream Profiles in Virginia and Maryland." Geological Survey Professional Paper 294: 45-95.
Jenson, S. K., and Domingue, J. O. 1988. "Extracting Topographic Structure from Digital Elevation Data for Geographic Information System Analysis." Photogrammetric Engineering and Remote Sensing 54 (11): 1593–1600.
Metz, M., Mitasova, H., & Harmon, R. S. 2011. "Efficient extraction of drainage networks from massive, radar-based elevation models with least cost path search." Hydrology and Earth System Sciences 15(2): 667-678.
Shreve, R. 1966. "Statistical Law of Stream Numbers" Journal of Geology.74: 17-35
Strahler, A. N. 1957. "Quantitative analysis of watershed geomorphology" Transactions of the American Geophysical Union8 (6): 913-920
Resources
Use the following resources to learn more:
- Derive Stream As Line in ArcGIS REST API
- Derive Stream As Line in ArcGIS Pro with the Spatial Analyst extension