VfSymLinear (arcpy.sa)

Резюме

Определяет взаимосвязь между вертикальным фактором стоимости и относительным вертикальным углом движения (VRMA) с помощью симметричной линейной функции либо в отрицательную, либо в положительную стороны VRMA, соответственно. Две линейные функции симметричны относительно оси VF (оси y).

Рисунок

Вертикальный фактор VfSymLinear для функций PathDistance.

Обсуждение

Объект VfSymLinear используется в следующих инструментах Spatial Analyst: Путевое расстояние (Path Distance), Распределение по путевому расстоянию (Path Distance Allocation) и Путевое направление (Path Distance Back Link).

Объект вертикального фактора (VF) задает отношение между вертикальным фактором стоимости и вертикальным относительным углом движения (VRMA).

VF определяет вертикальный уровень трудности при перемещении из одной ячейки в следующую.

VRMA определяет угол уклона между ячейкой ИЗ или обрабатывающей ячейкой и ячейкой В.

Класс VfSymLinear состоит из двух линейных функций по отношению к углам VRMA, которые симметричны относительно оси VF (оси y). Обе линии пересекают ось y при значении фактора VF, связанного с нулевым фактором zeroFactor. Уклон линий задается как единый уклон относительно положительного VRMA с использованием аргумента вертикального фактора slope, зеркально отражающегося на область отрицательных величин углов 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 (подъем/протяженность: 1 вертикальный фактор VF по оси y / 30 градусов по оси x); 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 (подъем/протяженность: 1 вертикальный фактор VF по оси y / 30 градусов по оси x); 90-градусный уклон обозначается 0,011111.	Double

Пример кода

VfSymLinear. Пример 1 (окно Python)

Демонстрирует создание класса VfSymLinear и его использование с инструментом PathDistance в окне Python.

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 (автономный скрипт)

Выполняет анализ PathDistance с использованием класса VfSymLinear.

# 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")