ETG_SnapPourPoints

Snap Pour Points

Snaps Pour points (Outlets) to raster cells within a specified distance depending on the selected Snap option.

Input point feature layer.
Output point feature layer
Snap Raster dataset - the raster type depends on the selected Snap Option
Snap Option - three possible values:
- Snap to nearest Stream
- Snap to lowest Elevation
- Snap to highest Flow Accumulation
Snap Distance - input points will be moved if a snap value is found within this distance in Map units.

A Point feature layer with the moved points. A new field is added "ET_Snap" and will contain the distance with which the point was moved in Map units.

An example of Snap Pour Points using the Stream option - initial points in green and after snapping in red.

If the Snap Option is "Nearest Stream" a point will be moved to the center of the nearest cell in the Stream raster with value above 0 within the Snap Distance. If a point is within a Stream cell, it will not be moved.
If the Snap Option is "Lowest Elevation" a point will be moved to the cell with the lowest value in the Elevation raster within the Snap Distance.
If the Snap Option is "Highest Accumulation" a point will be moved to the cell with the highest value in the Flow Accumulation raster within the Snap Distance.
See Hydrological functions for more information on the hydrological functionality.
The input format accepted are file based rasters - ERDAS IMAGINE or Tagged Image File Format (TIFF).
The .NET ToolBox for ArcGIS Desktop accepts also FileGDB Raster inputs.
The InputPoints must have a projected coordinate system.

Parameters

Expression	Explanation
Function Name	SnapPourPoints
<InputPoints>	A String - full path to the Input Points dataset.
<OutputPoints>	A String - the full path to the output point layer.
<ReferenceRaster>	A String - full path to the raster to be used for snapping.
<SnapOption>	A String - possible values are "stream", "elevation" and "accumulation".
<SnapDistance>	A Double representing the Snap Distance in the units of the spatial reference of the input.

ETSPath used in the table below is the full path to ETSRun.exe (E.G. "C:\Program Files\ETSpatial Techniques\ETSurface\ETSRun.exe")

ReferenceRaster

Language	Syntax
Python	subprocess.call([ETSPath, "SnapPourPoints", "InputPoints", "OutputPoints", "ReferenceRaster", "SnapOption", "SnapDistance"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "SnapPourPoints" "InputPoints" "OutputPoints" "ReferenceRaster" "SnapOption"
.NET using ETSOutX.dll	SnapPourPoints(InputPoints, OutputPoints, ReferenceRaster, SnapOption, SnapDistance)
ArcPy	arcpy.SnapPourPoints("InputPoints", "OutputPoints", "ReferenceRaster", "SnapOption", "SnapDistance")

Notes:

<> - required parameter
{} - optional parameter
See examples for Python , .NET or ArcPy
The argument separator for StartInfo.Arguments is space. If a string might contain a space, you need to double quote it.