捕捉汇水点。将汇水点捕捉到指定范围内累积流量最大的像元，用于把汇水点数据纠正到河流上。

命名空间： SuperMap.Analyst.TerrainAnalyst
程序集： SuperMap.Analyst.TerrainAnalyst (in SuperMap.Analyst.TerrainAnalyst)
版本: dll

语法

C#
public static DatasetGrid SnapPourPoint( DatasetGrid pourPointDataset, DatasetGrid accumulationGrid, double snapDistance, string pourPointField, Datasource targetDatasource, string resultGridName )

pourPointDataset: Type: SuperMap.Data..::.DatasetGrid
指定的汇水点数据集，仅支持点数据集和栅格数据集。

accumulationGrid: Type: SuperMap.Data..::.DatasetGrid
累积汇水量栅格数据集。可通过FlowAccumulation 方法）得到。

snapDistance: Type: System..::.Double
捕捉距离，捕捉汇水点到该范围内最大汇水量栅格位置上，该距离与指定的汇水点数据集单位一致。

pourPointField: Type: System..::.String
用于为汇水点位置赋值的字段。当汇水点数据集为点数据集时，需指定汇水点栅格值字段。字段类型仅支持整型，如果非整型会强制转为整型。

targetDatasource: Type: SuperMap.Data..::.Datasource
指定的用于存储结果数据集的数据源。如果设置为 null，则结果数据集将自动存储到汇水点数据集所在的数据源中。

结果汇水点栅格数据集。如果生成失败，则返回 null。

备注

汇水点一般可以用于桥梁、桥涵等水利设施的建设，但实际应用中汇水点不一定都是计算得到，即使用（PourPoints 方法），可能通过其他方式，比如矢量地图中的位置转为栅格数据，这时便需要捕捉汇水点功能进行修正，确保累积汇水量最大。

与获得汇水点栅格一样，捕捉汇水点后，可以进一步结合流向栅格来进行流域的分割（Watershed 方法）。