提取矢量水系，即将栅格水系转化为矢量水系，并将河流的等级存储到结果数据集的属性表中。

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

语法

C#
public static DatasetVector StreamToLine(
	DatasetGrid streamGrid,
	DatasetGrid directionGrid,
	Datasource targetDatasource,
	string resultGridName,
	StreamOrderType orderType
)

参数

streamGrid
Type: SuperMap.Data..::.DatasetGrid
指定的栅格水系数据。
directionGrid
Type: SuperMap.Data..::.DatasetGrid
指定的流向栅格数据。
targetDatasource
Type: SuperMap.Data..::.Datasource
指定的用于存储结果数据集的数据源。如果设置为 null，则结果数据集将自动存储到 directionGrid 所在的数据源中。
resultGridName
Type: System..::.String
指定的结果栅格数据集的名称。
orderType
Type: SuperMap.Analyst.TerrainAnalyst..::.StreamOrderType
指定的河流分级方法。

返回值

矢量水系数据集，为一个矢量线数据集。如果生成失败，则返回 null。

备注

提取矢量水系是基于流向栅格，将栅格水系转化为矢量水系（一个矢量线数据集）的过程。得到矢量水系后，就可以进行各种基于矢量的计算、处理和空间分析，如构建水系网络。下图为 DEM 数据以及对应的矢量水系。

通过该方法获得的矢量水系数据集，保留了河流的等级和流向信息。

  • 在提取矢量水系的同时，系统计算每条河流的等级，并在结果数据集中自动添加一个名为“StreamOrder”的属性字段来存储该值。分级的方式可通过 orderType 参数设置。
  • 流向信息存储在结果数据集中名为“Direction”的字段中，以0或1来表示，0表示流向与该线对象的几何方向一致，1表示与线对象的几何方向相反。通过该方法获得的矢量水系的流向均与其几何方向相同，即“Direction”字段值都为0。在对矢量水系构建水系网络后，可直接使用（或根据实际需要进行修改）该字段作为流向字段。

版本信息

SuperMap iObjects .NET


请参见