VfLinear

需要 Spatial Analyst 许可。

描述

通过线性函数定义垂直成本系数和垂直相对移动角度之间的关系。

插图

路径距离功能的 VfLinear 垂直系数。

讨论

VfLinear 对象用于 Spatial Analyst 工具路径距离、路径距离分配和路径距离回溯链接。

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

VF 用于定义从一个像元移至下一像元的垂直阻力。

VRMA 用于确定“起始”像元或处理像元与“终止”像元之间的坡度角。

VF 由 VRMA-VF 坐标系中的一条直线确定。这条线在 y 轴（表示 VF 系数）上与零系数相关联的值处进行截取。线的斜率可以通过斜率参数指定。

语法

 VfLinear ({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

代码示例

VfLinear 示例 1（Python 窗口）

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myVerticalFactor = VfLinear(1.0, -90.0, 90.0, 0.01111)
outPathDist =  PathDistance("source.shp", "costraster", "", "", "", "",
                            myVerticalFactor)
outPathDist.save("C:/sapyexamples/output/pastdistvfl")

VfLinear 示例 2（独立脚本）

使用 VfLinear 类执行 PathDistance 分析。

# Name: VfLinear_Ex_02.py
# Description: Uses the VfLinear 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 VfLinear Object
zeroFactor = 1.0
lowCutAngle = -90
highCutAngle = 90
slope = 0.01111
myVerticalFactor = VfLinear(zeroFactor, lowCutAngle, highCutAngle, slope)

# Execute PathDistance
outPathDist =  PathDistance(inSourceData, inCostRaster, "", "", "", "",
                            myVerticalFactor)

# Save the output 
outPathDist.save("C:/sapyexamples/output/pastdistvfl2")