需要 Spatial Analyst 许可。
摘要
通过线性函数定义水平成本系数和水平相对移动角度之间的关系。 该函数指定水平系数与水平相对移动角度呈线性关系。
插图
说明
此对象用于距离累积和距离分配 Spatial Analyst 工具,以及路径距离、路径距离分配和路径距离回溯链接旧的距离工具。
水平系数 (HF) 由水平相对移动角度 (HRMA)-HF 坐标系中的直线确定。 这条线在 y 轴(表示 HF 系数)上与 zeroFactor 相关联的值处进行截取。 线的斜率可以使用 slope 修饰符进行指定。 如果未确定斜率,则默认值为 0.5/45 或 1/90(指定为 0.01111)。
语法
HfLinear ({zeroFactor}, {cutAngle}, {slope})
参数 | 说明 | 数据类型 |
zeroFactor | zeroFactor 将用于确定线性函数的 y 截距。 (默认值为 0.5) | Double |
cutAngle | cutAngle 用于确定 HRMA 角度阈值,HRMA 大于该角度时会将 HF 设置为无穷大。 (默认值为 181.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 |
代码示例
演示了如何创建 HfLinear 类以及如何在 Python 窗口的 DistanceAccumulation 工具中使用该类。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myHorizFactor = HfLinear(0.5, 181.0, 0.01111)
outDistAccum = DistanceAccumulation("source.shp", "barrier.tif",
"elev.tif", "", "", "",
"horizontalRas.tif", myHorizFactor)
outDistAccum.save("C:/sapyexamples/output/distaccumhfL")
使用 HfLinear 类执行 DistanceAccumulation 分析。
# Name: HfLinear_Ex_02.py
# Description: Uses the HfLinear 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 HfLinear Object
zeroFactor = 0.5
cutAngle = 181.0
slope = 0.01111
myHorizFactor = HfLinear(zeroFactor, cutAngle, slope)
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute PathDistance
outDistAccum = DistanceAccumulation(inSourceData,"", inSurfaceRaster,"","",
"", inHorizontalRaster, myHorizFactor)
# Save the output
outDistAccum.save("C:/sapyexamples/output/distaccumhfl2")