7   校准路由数据集

精确的度量值，才能够保证事件被正确定位，因此精确的路由数据对动态分段是至关重要的。如果路由数据的刻度值可能不准确，或者需要更新路由数据的刻度值，我们可以通过使用可靠的参考点数据对路由数据的刻度值进行校准。尤其是在用这些刻度值连接大量的事件数据时，校准路由数据集更是必不可少的一项工作。

在介绍校准路由的实现过程前，首先来了解校准容限。当参考点到路由的最短距离小于给定的校准容限值时，我们就说该参考点在校准容限范围内。如图 7‑1中的参考点c2，它到路由的最短距离小于校准容限，则c2在校准容限范围内，同理可知c3不在校准容限范围内。

校准路由是读取参考点的刻度值信息来调整路由刻度值的过程：

1.      首先通过路由标识字段值将参考点与路由对应起来（参考点数据和路由数据各有一个路由标识字段，与路由数据路由ID相同的参考点，视为与路由对应的参考点）；

2.      然后，当对应参考点落在路由上并与某一节点重合时，该节点的M值使用该参考点的M值；

3.      路由上未与对应参考点重叠的节点的M，使用位于校准容限范围内的参考点的M值插值获得。并且，这些位于校准容限内的参考点，在对应路由上的垂足位置生成新的节点，并将对应参考点的M值赋予该节点。如图 7‑1中的参考点c1、c2，其到路由的最短距离小于校准容限，因此会在路由上对应位置添加对应节点；

4.      位于校准容限范围之外的参考点将不参与校准。图 7‑1中的参考点c3在校准容限范围外，因此它不会参与校准，也不会在路由上生成新的节点。

7.1     校准模式

SuperMap提供了两种校准模式：按距离校准和按刻度值校准。CalibrateMode枚举类型定义了这两种模式。使用按距离校准的方式可以得到单调的校准结果，即校准后路由的M值是递增或递减的；而按刻度值方式对路由进行校准的特点是，能够保持原始路由数据刻度值的变化规律（如不均匀的增加或减少），因此当被校准的路由的长度与刻度值的比值不同时，这种方法非常适用于对路由的刻度值进行微调。

按距离校准（CalibrateMode.ByDistance）

按距离校准是基于两点间的沿路由的距离来计算M值的。请结合图 7‑2和下面的文字来了解该模式如何对路由进行校准。

校准前路由各节点的坐标和参考点坐标如表 7.1所示：

表 7.1 按照距离校准模式校准前的各点信息

校准步骤如下：

1.      对于节点a1，使用c1和c2来校准。首先计算c1与c2之间的距离d1，然后计算出校准率R1=d1/（200-100）。注意这里提到的距离都是指沿线距离。

2.      然后计算a1和c1间的距离d2，，那么有d2/（100-M_a1）=R1，则a1校准后的M值为100 - d2/R1；

3.      同理，使用c1和c2来校准a2。先计算c1与a2间的距离d3，然后计算校准率R2=d1/（200-100），那么有d3/（M_a2-100)=R1，则a2校准后的M值为：100+d3/R1；

4.      依次类推，使用c2和c3来校准a3，使用c3和c4来校准a4和a5。注意，校准率总是采样离被校准点最近的两个参考点来计算。

5.      校准后路由各节点的M值如图 7‑2下方所示。

按刻度值校准（CalibrateMode.ByMeasure）

按刻度值校准利用参考点对应路由上位置的刻度值来进行校准。当被校准的路由的长度与刻度值的比值不一致时，这种方法非常适用于对路由的刻度值进行微调。请结合图 7‑3和下面的文字来了解该模式如何对路由进行校准。

校准前路由节点和参考点的坐标，及参考点在路由上对应的点的原M值如表 7.2所示：

表 7.2 按照刻度值校准模式校准前的各点的信息

校准步骤如下：

1.      使用参考点c1和c2来校准节点a1。首先计算M值校准率R1=（37.5-10）/（200-100），其中（37.5-10）称为c1和c2所在点在原来线上的线标差；

2.      a1和c1之间准确的线标差为（10-0），那么有（10-0）/（100-M_a1）=R1，则a1点校准后的M值为100 - （10-0）/R1；

3.      同理，使用c1和c2来校准a2。首先计算校准率R2=（37.5-10）/（200-100），a2与c1之间准确的线标差为（20-10），那么有（20-10）/(M_a2-100)=R2，则a2点校准后的M值为100+（20-10）/R2；

4.      以此类推，依次校准其余节点：使用c1和c2校准a2，使用c2和c3校准a3,使用c3和c4校准a4和a5。注意，校准率总是取离被校准最近的两个参考点来计算；

5.      校准后路由各节点的M值如图 7‑3下方所示。

7.2     校准路由的方法和参数设置

LinearReferencing类的CalibrateRoutes方法用于对路由数据集进行校准。

语法：

public static DatasetVector CalibrateRoutes(      DatasetVector referenceLineM,

String routeIDField, DatasetVector calibratePointDataset,  String calibrateRouteID,

String measureField,      CalibrateOptions options,    Datasource outputDatasource,

String outputDatasetName)

参数说明：

referenceLineM：指定的需要被校准的路由数据集。

routeIDField：指定的路由数据集中的路由标识字段。对于路由标识字段，支持的字段类型请参见表 6.2。如果设置的类型不被支持，会导致生成路由数据集失败。

calibratePointDataset：指定的用于校准路由的参考点数据集，该数据集中有表示刻度的字段。

calibrateRouteID：指定的参考点数据集中的路由标识字段。对于路由标识字段，支持的字段类型请参见表 6.2。如果设置的类型不被支持，会导致生成路由数据集失败。

measureField：指定的参考点数据集中用于表示刻度值的字段。支持的字段类型请参见表 6.2。如果设置的类型不被支持，会导致生成路由数据集失败。

options：指定的校准选项。

outputDatasource：指定的结果路由数据集所在的数据源。

outputDatasetName：指定的结果路由数据集的名称。

返回值说明：

校准之后的路由数据集。

调用CalibrateRoutes方法对路由数据集进行校准时，需要指定路由数据集及其路由标识字段，参考点数据集及其路由标识字段和刻度值字段，校准选项，以及结果数据集名称和目标数据源。校准选项（校正过程中涉及的一些参数）是通过CalibrateOptions实例对象来设置的，如表 7.3所示：

表 7.3 CalibrateOptions类的属性列表

子对象之间的间隔（IgnoringGaps）

是否忽略子对象的间隔会影响刻度值的连续性，详细介绍请参见第4章基本概念。这里要强调的是，位于两个子对象之间且在校准容限范围之外的参考点是无效的，不能参与校准。

错误信息（ErrorInfoField）

校准过程中可能会校准不成功，系统会在校准完成后自动在结果路由数据集中根据用户指定的错误信息字段名称添加错误信息字段，包含如表 7.4所示的5种错误信息。字段值为空表示没有错误。

表 7.4 校准错误信息