HfBinary (arcpy.sa)

Краткая информация

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

Рисунок

Горизонтальный коэффициент HfBinary для функций PathDistance.

Обсуждение

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

Если угол отклонения от горизонтали (HRMA) меньше порогового угла, значение горизонтального коэффициента (HF) для отклонения от среза ячейки устанавливается равным значению, связанному со значением zeroFactor. Если HRMA больше, чем cutAngle, HF для части ячейки устанавливается равным бесконечности.

Синтаксис

HfBinary ({zeroFactor}, {cutAngle})

Параметр	Объяснение	Тип данных
zeroFactor	Фактор zeroFactor будет использоваться для определения точки пересечения с осью y для двоичной функции. (Нулевой фактор zeroFactor присваивается в качестве горизонтального фактора, когда величина угла HRMA меньше, чем cutAngle.) (Значение по умолчанию — 1.0)	Double
cutAngle	Параметр cutAngle задает пороговое значение угла HRMA, выше которого горизонтальные факторы становятся равными бесконечности. (Когда величина угла HRMA меньше, чем cutAngle, горизонтальному фактору присваивается нулевой фактор zeroFactor; если величина угла HRMA превышает cutAngle, горизонтальному фактору присваивается значение бесконечности). (Значение по умолчанию — 45)	Double

Свойства

Свойство	Объяснение	Тип данных
zeroFactor (чтение и запись)	Фактор zeroFactor будет использоваться для определения точки пересечения с осью y для данной функции. Фактор zeroFactor присваивается в качестве горизонтального фактора когда значение HRMA меньше значения порогового угла.	Double
cutAngle (чтение и запись)	Параметр cutAngle задает пороговое значение угла HRMA, выше которого горизонтальные факторы становятся равными бесконечности. Когда величина угла HRMA меньше, чем cutAngle, при задании нулевого фактора и если величина угла HRMA превышает cutAngle, то присваивается значение бесконечности.	Double

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myHfBinary = HfBinary(1.5, 45.5)
outPathDist = PathDistance("source.shp", "elevation", "", "", myHfBinary)
outPathDist.save("C:/sapyexamples/output/pathdisthfb")

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

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

# Name: HfBinary_Ex_02.py
# Description: Uses the HFBinary 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 = "sourcepts.shp"
inCostRaster = "elevation"

# Create the HfBinary Object
zeroFactor = 1.0
cutAngle = 45.0
myHorizFactor = HfBinary(zeroFactor, cutAngle)

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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