Thin Hydro Features (Production Mapping)

Summary

Generalizes input hydrographic stream data into two feature classes: one for hydro polyline features and one for hydro polygon features. The generalized versions are produced using a stream order algorithm. The algorithm removes less significant hydro features based on the number of tributaries.

The following is a sample of a stream network before and after using the Thin Hydro Features geoprocessing tool:

Illustration

Before and after illustration of the thin hydro features process.

Usage

Syntax

ThinHydroFeatures_production (in_hydro_features, out_hydro_line_feature_class, out_hydro_polygon_feature_class, {in_min_hydro_order}, {in_min_feature_size}, {in_aoi_features}, {aoi_field})
ParameterExplanationData Type
in_hydro_features
[in_hydro_features,...]

The input hydro feature class or feature layer that contains the hydrographic features to be thinned.

Feature Layer
out_hydro_line_feature_class

The new or existing output hydro line feature class that contains the hydro line features after the thinning process. When an existing feature class is used, thinning will overwrite the existing hydro line features in the feature class.

Feature Class
out_hydro_polygon_feature_class

The new or existing output hydro polygon feature class that contains the hydro polygon features after the thinning process. When an existing feature class is used, thinning will overwrite the existing hydro polygon features in the feature class.

Feature Class
in_min_hydro_order
(Optional)

The minimum hydro order or stream order value used to eliminate hydro features. The tool will thin hydro features that have a stream order value less than this number. The tool will write stream order values to an ORD field in Output Hydro Line Feature Class and Output Hydro Polygon Feature Class.

Long
in_min_feature_size
(Optional)

The minimum area used in the thinning algorithm to eliminate small, non-main hydro polygons. Units default to the input data unit of measurement.

Double
in_aoi_features
(Optional)

The optional area of interest (AOI) feature class that is used to clip input hydro features. The thinning algorithm is executed on each extent of the AOI feature and the results are written to the output hydro line and polygon feature classes.

Feature Layer
aoi_field
(Optional)

The field that contains a unique identifier for each feature in Input Area of Interest Features .

Field

Code Sample

ThinHydroFeatures example

The following ArcGIS Python window script uses the ThinHydroFeatures function to generalize sample data released with Esri Production Mapping.

import arcpy

# use the WatrcrsL feature class from production mapping sample data
WatrcrsL = "C:\\data\\Foundation_Data_Tutorials\\MPS-Atlas\\GDB\\SoCal.gdb\\SoCal\\WatrcrsL"
WatrcrsL_Layer = "WatrcrsL_Layer"

# these are the output feature classes
WatrcrsL_HydroLine = "C:\\data\\work.gdb\\WatrcrsL_HydroLine"
WatrcrsL_HydroPolygon = "C:\\data\\work.gdb\\WatrcrsL_HydroPolygon"

# import the production mapping toolbox
arcpy.ImportToolbox(r'C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Production Mapping Tools.tbx')

# Make Feature Layer from the watrcrsl feature class
arcpy.MakeFeatureLayer_management(WatrcrsL, WatrcrsL_Layer)

# Exec Thin Hydro Features
arcpy.ThinHydroFeatures_production("WatrcrsL_Layer", WatrcrsL_HydroLine, WatrcrsL_HydroPolygon, "0", "0", "", "")

Environments

This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcView: No
ArcEditor: Requires Production Mapping
ArcInfo: Requires Production Mapping

5/4/2011