根据给定的弧段 ID 查找汇，即从给定弧段出发，根据流向查找流出该弧段的下游汇点，并返回给定弧段到达该汇的最小耗费路径所包含的弧段、结点及耗费。

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

语法

C#
public FacilityAnalystResult FindSinkFromEdge(
	int edgeID,
	string weightName,
	bool isUncertainDirectionValid
)

参数

edgeID
Type: System..::.Int32
指定的弧段 ID。
weightName
Type: System..::.String
指定的权值字段信息对象的名称，即设施网络分析环境中指定的权值字段信息集合（WeightFieldInfos）中某一个权值信息对象（WeightFieldInfo）的名称（Name）。
isUncertainDirectionValid
Type: System..::.Boolean
指定不确定流向是否有效。指定为 true，表示不确定流向有效，具有不确定流向的弧段仍然参与分析；指定为 false，分析时遇到不确定流向将停止在该方向上继续查找。流向字段的值为 2 时代表该弧段的流向为不确定流向。详细介绍请参阅 BuildFacilityNetworkDirections 方法的介绍。

返回值

设施网络分析结果。

备注

该方法从给定弧段出发，按照流向，查找流出该弧段的下游汇点，分析的结果为该弧段到达查找到的汇的最小耗费路径所包含的弧段、结点及耗费。如果网络中有多个汇，将查找最远的也就是从给定弧段出发最小耗费最大的那个汇。为了便于理解，可将该功能的实现过程分为三步：

  1. 从给定弧段出发，根据流向，找到该弧段下游所有的汇点；
  2. 分析给定弧段到每个汇的最小耗费路径并计算耗费；
  3. 选择上一步中计算出的耗费中的最大值所对应的路径作为结果，给出该路径上的弧段 ID 数组、结点 ID 数组以及该路径的耗费。

注意：分析结果中的弧段 ID 数组不包括分析弧段本身。

更多介绍还可参阅 FindSinkFromNode 方法，该方法根据给定的结点 ID 查找汇。

示例

请参见 FindSourceFromNode 方法的示例。

版本信息

SuperMap iObjects .NET


请参见