VfBinary (arcpy.sa)

Резюме

Задает отношение между вертикальным фактором стоимости и вертикальным относительным углом движения через двоичную функцию. Если вертикальный относительный угол движения больше нижнего порогового угла и меньше верхнего порогового угла, значение вертикального фактора устанавливается равным значению, связанному с нулевым фактором; в противном случае значение равно бесконечности.

Рисунок

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

Обсуждение

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

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

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

VRMA определяет угол уклона между изначальной и конечной обрабатываемыми ячейками.

Когда значение VRMA больше значения нижнего порогового угла и меньше значения верхнего порогового угла, значение VF для перемещения между двумя ячейками устанавливается равным значению, связанному с фактором zeroFactor. Если значение VRMA больше значения highCutAngle или меньше значения lowCutAngle, значение VF устанавливается равным бесконечности.

Синтаксис

VfBinary ({zeroFactor}, {lowCutAngle}, {highCutAngle})

Параметр	Объяснение	Тип данных
zeroFactor	Фактор zeroFactor будет использоваться для определения точки пересечения с осью y для двоичной функции. (Значение по умолчанию — 1.0)	Double
lowCutAngle	Значение VRMA, определяющее нижний порог, ниже которого значения VF устанавливаются равными бесконечности. (Значение по умолчанию — -30.0)	Double
highCutAngle	Значение VRMA, определяющее верхний порог, выше которого значения VF устанавливаются равными бесконечности. (Значение по умолчанию — 30.0)	Double

Свойства

Свойство	Объяснение	Тип данных
zeroFactor (чтение и запись)	Нулевой фактор zeroFactor будет использоваться для определения местоположения точки пересечения с осью y для класса вертикального фактора.	Double
lowCutAngle (чтение и запись)	Значение VRMA в градусах, определяющее нижний порог, ниже которого значения VF устанавливаются равными бесконечности.	Double
highCutAngle (чтение и запись)	Значение VRMA в градусах, определяющее верхний порог, выше которого значения VF устанавливаются равными бесконечности.	Double

Пример кода

Пример VfBinary №1 (окно Python)

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

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

Пример VfBinary №2 (автономный скрипт)

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

# Name: VfBinary_Ex_02.py
# Description: Uses the VfBinary 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 VfBinary Object
zeroFactor = 1.0
lowCutAngle = -30
highCutAngle = 30
myVerticalFactor = VfBinary(zeroFactor, lowCutAngle, highCutAngle)

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