网络建模类。该类是网络分析的建模工具,目前提供根据单个线数据集或多个线和点数据集构建网络数据集,根据设施网络分析的对象创建设施网络流向和创建设施网络等级,以及创建转向表等功能。

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

语法

C#
public static class NetworkBuilder

备注

  • 构建网络数据集
  • 网络数据集是进行网络分析的数据基础。网络数据集由两个子数据集(一个线数据集和一个点数据集)构成,分别存储了网络模型的弧段和结点,并且描述了弧段与弧段、弧段与结点、结点与结点间的空间拓扑关系。

    本类提供了三个 BuildNetwork 重载方法用于构建网络数据集:

    1. 通过单个线数据集构建(参见 BuildNetwork 方法);
    2. 通过多个线数据集和点数据集构建(参见 BuildNetwork 方法);
    3. 通过单个线数据集和点数据集及已有的拓扑信息字段构建(参见 BuildNetwork 方法)。

    通过前两种方式构建的网络数据集的属性表中包含了以下必要字段:

    弧段属性表:

    1. 弧段 ID 字段(SMEDGEID):用于唯一标识弧段;
    2. 弧段的起始结点 ID 字段(SMFNODE)和终止结点 ID 字段(SMTNODE):用以描述资源流动的方向性;
    3. 正向阻力字段(SMRESISTANCEA)和反向阻力字段(SMRESISTANCEB):用以描述资源流动的通畅性,初始值均为 1;
    4. 拓扑错误类型字段(SMTOPOERROR):记录检查出的拓扑错误的类型。0 表示无错误,1 表示该弧段的起始结点是悬结点,2 表示该弧段的终止结点是悬结点,3 表示该弧段的起始和终止结点均为悬结点。

    结点属性表:

    1. 结点 ID 字段(SMEDGEID):用于唯一标识结点。

    除构建时系统自动生成的字段外,还可以指定原线和点数据集的一些非系统字段作为保留字段。

    注意:通过第三种方式构建的网络数据集中,虽然也包含以上系统字段,但字段值是无效的。构建时所指定的源数据集中已有的拓扑信息字段,会保留到结果网络数据集中,作为网络数据集的拓扑信息字段。

  • 为网络数据集创建流向和等级
  • 设施网络模型的特点是具有方向,即介质(水流、电流等)会根据网络本身的规则在网络中流动。因此,在进行设施网络分析前必须为网络数据集创建流向。具体介绍请参见 BuildFacilityNetworkDirections 方法。

    如果用于设施分析的网络数据集存在等级,那么就需要在建立流向的基础上,使用 BuildFacilityNetworkHierarchies 方法再为网络数据集建立等级。

  • 创建转向表
  • 转向表用于描述完成转弯(即从一个弧段经过中间结点抵达另一个邻接弧段)所需的花费,用于相关的交通网络分析中。CreateTurnTable 方法可根据网络数据集来创建转向表。

继承层次

System..::.Object
  SuperMap.Analyst.NetworkAnalyst..::.NetworkBuilder

请参见