Skip to main content

HfInverseLinear

汇总

通过反线性函数定义水平成本系数和水平相对移动角度之间的关系。 该函数指定水平系数是水平相对移动角度的反线性函数。

HfInverseLinear 水平系数图

反线性水平系数图。

讨论

此对象用于 距离累积 和 距离分配 Spatial Analyst 工具，以及 路径距离 、 路径距离分配 和 路径距离回溯链接 旧的距离工具。

水平系数 (HF) 由水平相对移动角度 (HRMA)-HF 坐标系中的直线的倒数确定。 这条线在 y 轴（表示 HF 系数）上与 zeroFactor 相关联的值处进行截取。 线的斜率可以使用 斜率 修饰符进行指定。 如果未确定 slope ，则默认值为 -2/180 或 -1/90（指定为 0.01111）。

语法

HfInverseLinear({zeroFactor}, {cutAngle}, {slope})

名称 说明 数据类型

zeroFactor

（可选）

zeroFactor 将用于确定逆线性函数的 y 截距。

(默认值为 2.0)

Double

cutAngle

（可选）

cutAngle 用于确定 HRMA 角度阈值，HRMA 大于该角度时会将 HF 设置为无穷大。

(默认值为 180.0)

Double

slope

（可选）

确定 HRMA-HF 坐标系中直线的斜率。斜率被指定为垂直增量与水平增量的比值。例如，30 度斜率为 1/30，指定为 0.03333（垂直增量/水平增量：y 轴 1 HF/x 轴 30 度）。

(默认值为 -0.011111)

Double

属性

名称 说明 数据类型

zeroFactor

（读取和写入）

zeroFactor 将用于确定函数的 y 截距。

当 HRMA 小于交角时， zeroFactor 将被指定为水平系数。

Double

cutAngle

（读取和写入）

cutAngle 用于确定 HRMA 角度阈值，HRMA 大于该角度时会将 HF 设置为无穷大。

如果 HRMA 小于交角，则指定零系数；如果 HRMA 大于交角，则指定无穷大。

Double

slope

（读取和写入）

确定 HRMA-HF 坐标系中直线的斜率。斜率被指定为垂直增量与水平增量的比值。例如，30 度斜率为 1/30，指定为 0.03333（垂直增量/水平增量：y 轴 1 HF/x 轴 30 度）。

Double

代码示例

HfInverseLinear 示例 1（Python 窗口）

演示了如何创建 HfInverseLinear 类以及如何在 Python 窗口的 DistanceAccumulation 工具中使用该类。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myHorizFactor = HfInverseLinear(2.0, 181.0, -0.01111)
outPathDist = PathDistance("source.shp", "costraster", "", "", myHorizFactor)
outPathDist.save("C:/sapyexamples/output/pathdisthfil")

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myHorizFactor = HfInverseLinear(2.0, 181.0, -0.01111)
outDistAccum = DistanceAccumulation("source.shp", "barrier.tif",
                                    "elev.tif", "", "", "",
                                    "horizontalRas.tif", myHorizFactor)
outDistAccum.save("C:/sapyexamples/output/distaccumhfil")
HfInverseLinear 示例 2（独立脚本）

使用 HfInverseLinear 类执行 DistanceAccumulation 分析。

# Name: HfInverseLinear_Ex_02.py
# Description: Uses the HfInverseLinear object to run the
#              DistanceAccumulation tool.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inSourceData = "sourcepts.shp"
inSurfaceRaster = "elevation.tif"
inHorizontalRaster = "horizontalRas.tif"

# Create the HfInverseLinear Object
zeroFactor = 2.0
cutAngle = 181.0
slope = -0.01111
myHorizFactor = HfInverseLinear(zeroFactor, cutAngle, slope)

# Run PathDistance
outDistAccum = DistanceAccumulation(inSourceData,"", inSurfaceRaster,"","",
                                    "", inHorizontalRaster, myHorizFactor)

# Save the output
outDistAccum.save("C:/sapyexamples/output/distaccumhfil2")