路径距离函数

考虑表面距离以及水平和垂直成本因素的情况下，为每个像元计算与最小成本源之间的最小累积成本距离。

旧版本：

此函数已弃用。

距离累积函数提供了增强的功能或性能。

此为全局栅格函数。

注释

“路径距离”函数与“成本距离”函数相比较而言，两者都可以确定距离栅格表面上各位置的源的最小累积行程成本。 然而，通过考虑实际表面距离及其他水平和垂直因素，“路径距离”函数可将更多的复杂因素添加到此分析。

包含 NoData 的像元在“路径距离”函数中充当障碍。 NoData 值后面的像元成本距离通过围绕 NoData 障碍移动所需的累积成本进行计算。 在任意输入栅格上被分配 NoData 的任何像元位置都会在所有输出栅格上接收到 NoData。

最大距离以与成本栅格相同的成本单位指定。

对于输出栅格，至一组源位置的像元的最小成本距离（或最小累积成本距离）是从该像元至全部源位置的最小成本距离范围的下限。

水平系数修饰属性的默认值如下：

Keywords         Zero factor   Cut angle     Slope   Side value
--------------   -----------   -----------   -----   ---------
Binary           1.0            45           ~       ~
Forward          0.5            45 (fixed)   ~       1.0
Linear           0.5           181            1/90   ~
Inverse linear   2.0           180           -1/90   ~

垂直系数修饰属性的默认值如下：

Keyword                   Zero    Low    High   Slope  Power  Cos    Sec
                          factor  cut    cut                  power  power
                                  angle  angle                             
------------------------  ------  -----  -----  -----  -----  -----  -----
Binary                    1.0     -30    30     ~      ~      ~      ~
Linear                    1.0     -90    90      1/90  ~      ~      ~
Symmetric linear          1.0     -90    90      1/90  ~      ~      ~
Inverse linear            1.0     -45    45     -1/45  ~      ~      ~
Symmetric inverse linear  1.0     -45    45     -1/45  ~      ~      ~
Cos                       ~       -90    90     ~      1.0    ~      ~
Sec                       ~       -90    90     ~      1.0    ~      ~
Cos_sec                   ~       -90    90     ~      ~      1.0    1.0
Sec_cos                   ~       -90    90     ~      ~      1.0    1.0
Hiking time               ~       -70    70     ~      ~      ~      ~
Bidirectional hiking time ~       -70    70     ~      ~      ~      ~

坡向函数的输出可以用作水平栅格参数的输入。

源的特征或与源之间的通信可由特定参数进行控制。 源成本倍数参数可确定行程模式或源的量级，源开始成本设置移动开始前的开始成本，源阻力比率是一种关于累计成本影响的动态调整，例如，模拟徒步者会有多么疲劳，源容量设置源在到达极限前可同化多少成本。 行驶方向可确定移动是否从源开始并移动至非源位置，或从非源位置移动回源。

如果使用字段指定任一源特征参数，则根据给定源数据字段的信息，源特征将应用于各个源。 当给定关键字或常量值，将应用于所有源。

如果指定了源开始成本，则输出成本距离表面上的源位置将被设置为源开始成本的值；否则，输出成本距离表面上的源位置将被设置为零。

参数

参数名称	描述
源栅格 （必填）	输入源位置。 此为栅格数据集，用于标识计算每个输出像元位置的最小积累成本距离所依据的像元或位置。 它可以是整型或浮点型。
成本栅格 （必填）	定义以平面测量的经过每个像元所需的成本或阻抗。 每个像元位置上的值表示经过像元时移动每单位距离所需的成本。 每个像元位置值乘以像元分辨率，同时也会补偿对角线移动来获取经过像元的总成本。 成本栅格的值可以是整型或浮点型，但不可以为负值或零。
表面栅格	定义每个像元位置的高程值的栅格。 这些值用于计算经过两个像元时所涉及的实际表面距离。
水平栅格	定义每个像元的水平方向的栅格。 在栅格上的这些值必须是整数，以北纬 0 度（或朝向屏幕顶部）为起始值，范围为 0 至 360，顺时针增加。 平坦区域应赋值为 -1。 每个位置上的值与水平系数参数结合使用，用来确定在相邻像元之间移动时产生的水平成本。
水平系数	定义水平成本系数和水平相对移动角度 (HRMA) 之间的关系。 有若干个带有修饰属性的系数可用于标识定义的垂直系数图。 此外，可使用表格来创建自定义图表。 这些图表用于标识在计算移动到相邻像元的总成本时的垂直系数。 在下面的说明中，将使用两个英文首字母缩写：HF 和 HRMA。 HF 表示水平系数，用于定义从一个像元移动到下一像元时所遇到的水平阻力。 HRMA 表示水平相对移动角度，用于定义像元的水平方向与移动方向之间的角度。 水平系数类型包括如下： 二进制 - 指示如果 HRMA 小于交角，则将 HF 设置为与零系数相关联的值；否则为无穷大。 前向 - 只允许建立向前的移动。 HRMA 必须大于等于 0 度且小于 90 度 (0 <= HRMA < 90)。 如果 HRMA 大于 0 度且小于 45 度，则将像元的 HF 设置为与零系数相关联的值。 如果 HRMA 大于等于 45 度，则使用边值修饰属性值。 对于 HRMA 值等于或大于 90 度的任何情况，均将 HF 设置为无穷大。 线性 - 指定 HF 是 HRMA 的线性函数。 逆线性 - 指定 HF 是 HRMA 的逆线性函数。 表 - 标识将用于定义水平系数图（确定 HF）的表文件。 水平系数的修饰属性包括以下： 零系数 - HRMA 为零时要使用的水平系数。 该系数可确定任意水平系数函数的 y 截距。 交角 - 定义一个 HRMA 角度，大于该角度时 HF 将被设置为无穷大。 斜率 - 与线性和逆线性水平系数关键字相结合使用，确定直线斜率。 斜率被指定为垂直增量与水平增量的比值（例如，45 百分比坡度是 1/45，以 0.02222 的方式输入）。 边值 - 在指定了前向水平系数关键字的情况下，确定 HRMA 大于或等于 45 度且小于 90 度时的 HF。 表名 - 标识定义 HF 的表名称。
垂直栅格	定义垂直成本系数和垂直相对移动角度 (VRMA) 之间的关系。 这些 z 值用于计算坡度，而坡度用于标识在不同的像元之间移动时产生的垂直系数。
垂直系数	定义垂直成本系数和垂直相对移动角度 (VRMA) 之间的关系。 有若干个带有修饰属性的系数可用于标识定义的垂直系数图。 此外，可使用表格来创建自定义图表。 这些图表用于标识在计算移动到相邻像元的总成本时的垂直系数。 在下面的说明中，将使用两个英文首字母缩写：VF 和 VRMA。 VF 表示垂直系数，用于定义从一个像元移至下一像元时所遇到的垂直阻力。 VRMA 表示垂直相对移动角度，用于定义“起始”像元或处理像元与“终止”像元之间的坡度角度。 垂直系数类型如下： 二进制 - 指定如果 VRMA 大于交角的下限且小于交角的上限，则将 VF 设置为与零系数相关联的值；否则为无穷大。 线性 - 指示 VF 是 VRMA 的线性函数。 对称线性 - 指定无论在 VRMA 正侧还是负侧，VF 均为 VRMA 的线性函数，并且这两个线性函数关于 VF (y) 轴对称。 逆线性 - 指示 VF 是 VRMA 的逆线性函数。 对称逆线性 - 指定无论在 VRMA 正侧还是负侧，VF 均为 VRMA 的逆线性函数，并且这两个线性函数关于 VF (y) 轴对称。 Cos - 将 VF 标识为 VRMA 的余弦函数。 Sec - 将 VF 标识为 VRMA 的正割函数。 Cos-Sec - 指定当 VRMA 为负时，VF 为 VRMA 的余弦函数；当 VRMA 为非负时，VF 为 VRMA 的正割函数。 Sec-Cos - 指定当 VRMA 为负时，VF 为 VRMA 的正割函数；当 VRMA 为非负时，VF 为 VRMA 的余弦函数。 徒步时间 - 指定 VRMA 徒步时间功能的VF。 双向徒步时间 - 指定 VRMA 双向徒步时间功能的 VF。 表 - 标识将用于定义垂直系数图（确定 VF）的表文件。 垂直关键字的修饰属性如下： 零系数 - 确定 VRMA 为零时要使用的垂直系数。 该系数可确定指定函数的 y 截距。 按照定义，零系数对于任意三角垂直函数（COS、SEC、COS-SEC 或 SEC-COS）都不适用。 y 截距由以上函数定义。 交角下限 - 定义一个 VRMA 角度，小于该角度时 VF 将被设置为无穷大。 交角上限 - 定义一个 VRMA 角度，大于该角度时 VF 将被设置为无穷大。 斜率 - 与线性和逆线性垂直系数关键字相结合使用，确定直线斜率。 斜率被指定为垂直增量与水平增量的比值（例如，45 百分比坡度是 1/45，以 0.02222 的方式输入）。 表名 - 标识定义 VF 的表名称。
最大距离	累积成本值不能超过的阈值。 如果累积的成本距离超过该值，则像元位置的输出值将为 NoData。 最大距离定义计算累积成本距离适用的范围。 默认距离是到输出栅格的范围。
要应用于成本的乘数	要应用于成本值的乘数。 此参数可用于控制源的出行或放大模式。 乘数越大，在每个像元间移动的成本将越大。 值必须大于零。 默认值为 1。 可将数值（双精度型）或源栅格中的字段用于此参数。
起始成本	用于开始计算成本的起始成本。 此参数适用于与源相关的固定成本规范。 成本算法将从指定的值开始，而非从 0 成本开始。 该值必须大于等于零。 默认值为 0。
累积成本阻力比率	此参数将模拟累积成本增加时所耗费成本的增加情况。 用于为旅行者的疲劳程度建模。 利用到达某个像元的累积成本的增长量乘以阻力比率，再加上移动至下一个像元的成本。 这是修改后版本的用于计算移动经过像元的显性成本混合利率公式。 随着阻力比率的值增加，之后访问的像元成本也随之增加。 阻力比率越大，到达下一个像元的成本也越多，将针对每个后续移动进行复合。 由于阻力比率与复利率相似且累积成本值通常会很大，因此建议采用较小的阻力比率，如 0.005 或更小，具体取决于累积成本值。 值必须大于零。 默认容量是到输出栅格边的容量。
容量	定义源的行驶者的成本容量。 每个源的成本计算将在达到指定容量后停止。 值必须大于零。 默认容量是到输出栅格边的容量。
行驶方向	应用源阻力比率时定义行驶者的方向。 来自源 - 源阻力比率将应用于开始于输入源并移动至非源像元的情况。 这是默认设置。 到源 - 源阻力比率将应用于开始于每个非源像元并移动回输入源的情况。 指定将应用于所有源的来自源或到源关键字，或指定包含用于确定各个源行驶方向关键字的源栅格字段。 该字段必须包含字符串 FROM_SOURCE 或 TO_SOURCE。