VfSymLinear

汇总

通过 VRMA 正侧或负侧的对称线性函数分别定义垂直成本系数和垂直相对移动角度 (VRMA) 之间的关系。 两个线性函数关于 VF (y) 轴对称。

对称线性垂直系数图。

讨论

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

垂直系数 (VF) 对象用于定义垂直成本系数和垂直相对移动角度 (VRMA) 之间的关系。

VF 定义从一个像元移至下一像元时所遇到的垂直阻力。

VRMA 标识“起始”像元或处理像元与“终止”像元之间的坡度角度。

该 VfSymLinear 类由两个相对于 VRMA 的线性函数组成，这两个函数关于 VF (y) 轴对称。 两条线都在与 zeroFactor 相关联的 VF 值处截取 y 轴。 使用 slope 垂直系数参数将线的斜率定义为相对于正 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 （读取和写入）	在 VRMA-VF 坐标系中，确定直线的斜率。斜率被指定为垂直增量与水平增量的比值。例如，30 度斜率是 1/30，指定为 0.03333（竖直增量/水平增量：y 轴 1 VF/x 轴 30 度）；90 度斜率为 0.011111。	Double

代码示例

VfSymLinear 示例 1（Python 窗口）

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myVerticalFactor = VfSymLinear(1.0, -90, 90, -0.01111)
outDistAccum = DistanceAccumulation("Source.shp", "", "elev.tif",
                                   "cost.tif", "elev.tif",
                                    myVerticalFactor)
outDistAccum.save("C:/sapyexamples/output/distAccumVfSL.tif")

VfSymLinear 示例 2（独立脚本）

使用 VfSymLinear 类执行 DistanceAccumulation 分析。

# Name: VfSymLinear_Ex_02.py
# Description: Uses the VfSymLinear 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 = "source.shp"
inCostRaster = "costraster.tif"
inElevation = "elev.tif"

# Create the VfSymLinear Object
zeroFactor = 1.0
lowCutAngle = -90
highCutAngle = 90
slope = -0.01111
myVerticalFactor = VfSymLinear(zeroFactor, lowCutAngle, highCutAngle, slope)

# Run PathDistance
outDistAccum = DistanceAccumulation(inSourceData, "", inElevation,
                                    inCostRaster, inElevation,
                                    myVerticalFactor)

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

相关主题

• Spatial Analyst 类概述
• 垂直系数类概览