需要 Spatial Analyst 许可。
摘要
通过垂直相对移动角度 (VRMA) 负侧或正侧的对称线性函数定义垂直成本系数和 VRMA 之间的关系。这两个线性函数关于 VF (y) 轴对称。
插图
讨论
VfSymLinear 对象用于 Spatial Analyst 工具路径距离、路径距离分配和路径距离回溯链接。
垂直系数 (VF) 对象用于定义垂直成本系数和垂直相对移动角度 (VRMA) 之间的关系。
VF 用于定义从一个像元移至下一像元的垂直阻力。
VRMA 用于确定“起始”像元或处理像元与“终止”像元之间的坡度角。
VfSymLinear 类由两个与 VRMA 相关的线性函数组成，这两个函数关于 VF (y) 轴对称。两条线都在与零系数相关联的 VF 值处截取 y 轴。使用斜率垂直系数参数针对正 VRMA 定义线的斜率，然后将针对负 VRMA 生成一个镜像。
语法
VfSymLinear ({zeroFactor}, {lowCutAngle}, {highCutAngle}, {slope})| 参数 | 说明 | 数据类型 |
zeroFactor | zeroFactor 将用于确定对称线性函数的 y 截距。 (默认值为 1.0) | Double |
lowCutAngle | 用于定义阈值下限的 VRMA 度数，如果低于（小于）该值，则将 VF 设置为无穷大。 (默认值为 -90.0) | Double |
highCutAngle | 用于定义阈值上限的 VRMA 度数，如果高于（大于）该值，则将 VF 设置为无穷大。 (默认值为 90.0) | Double |
slope | 在 VRMA-VF 坐标系中，确定直线的斜率。斜率被指定为垂直增量/水平增量。例如，30 度斜率是 1/30，指定为 0.03333（竖直增量/水平增量：y 轴 1 VF/x 轴 30 度）；90 度斜率为 0.011111。 (默认值为 0.011111) | Double |
属性
| 属性 | 说明 | 数据类型 |
| zeroFactor (读写) | zeroFactor 将用于确定垂直系数类的 y 截距。 | Double |
| lowCutAngle (读写) | 用于定义阈值下限的 VRMA 度数，如果低于（小于）该值，则将 VF 设置为无穷大。 | Double |
| highCutAngle (读写) | 用于定义阈值上限的 VRMA 度数，如果高于（大于）该值，则将 VF 设置为无穷大。 | Double |
| slope (读写) | Identifies the slope of the straight line in the VRMA-VF coordinate system. Slope is specified as the rise over the run. For example, a 30-degree slope is 1/30, specified as 0.03333 (rise/run: 1 VF on the y axis / 30 degrees on the x axis); a 90-degree slope as 0.011111. | Double |
代码实例
VfSymLinear 示例 1（Python 窗口）
演示如何创建 VfSymLinear 类以及如何在 Python 窗口的 PathDistance 工具中使用该类。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myVerticalFactor = VfSymLinear(1.0, -90, 90, -0.01111)
outPathDist = PathDistance("source.shp", "costraster", "", "", "", "",
myVerticalFactor)
outPathDist.save("C:/sapyexamples/output/pathdistvfsl")
VfSymLinear 示例 2（独立脚本）
使用 VfSymLinear 类执行 PathDistance 分析。
# Name: VfSymLinear_Ex_02.py
# Description: Uses the VfSymLinear object to execute the PathDistance 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 = "source.shp"
inCostRaster = "costraster"
# Create the VfSymLinear Object
zeroFactor = 1.0
lowCutAngle = -90
highCutAngle = 90
slope = -0.01111
myVerticalFactor = VfSymLinear(zeroFactor, lowCutAngle, highCutAngle, slope)
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute PathDistance
outPathDist = PathDistance(inSourceData, inCostRaster, "", "", "", "",
myVerticalFactor)
# Save the output
outPathDist.save("C:/sapyexamples/output/pathdistvfsl2")