HfLinear (arcpy.sa)

Резюме

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

Рисунок

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

Обсуждение

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

Горизонтальные факторы (HF) задаются прямой линией в системе координат "Горизонтальный угол относительного перемещения (HRMA) – горизонтальный фактор (HF)". Линия пересекает ось y, соответствующую фактору HF, в точке со значением, связанным с нулевым фактором zeroFactor. Угол наклона линии может быть задан с применением модификатора slope. Если уклон не задан, значение по умолчанию равно 0,5/45 или 1/90 (задается в виде 0,01111).

Синтаксис

HfLinear ({zeroFactor}, {cutAngle}, {slope})

Параметр	Объяснение	Тип данных
zeroFactor	Фактор zeroFactor будет использоваться для определения местоположения точки пересечения с осью y для линейной функции. (Значение по умолчанию — 0.5)	Double
cutAngle	Параметр cutAngle задает пороговое значение угла HRMA, выше которого горизонтальные факторы становятся равными бесконечности. (Значение по умолчанию — 181.0)	Double
slope	Определяет уклон прямой линии в системе координат "HRMA-HF". Значение уклона задается в виде подъема над протяженностью. Например, 30-градусный уклон обозначается 1/30, задается в виде 0,03333 (подъем/протяженность: 1 горизонтальный фактор HF по оси y / 30 градусов по оси x); 90-градусный уклон обозначается 0,011111. (Значение по умолчанию — 0.011111)	Double

Свойства

Свойство	Объяснение	Тип данных
zeroFactor (чтение и запись)	Фактор zeroFactor будет использоваться для определения точки пересечения с осью y для данной функции. Фактор zeroFactor присваивается в качестве горизонтального фактора когда значение HRMA меньше значения порогового угла.	Double
cutAngle (чтение и запись)	Параметр cutAngle задает пороговое значение угла HRMA, выше которого горизонтальные факторы становятся равными бесконечности. Когда величина угла HRMA меньше, чем cutAngle, при задании нулевого фактора и если величина угла HRMA превышает cutAngle, то присваивается значение бесконечности.	Double
slope (чтение и запись)	Определяет уклон прямой линии в системе координат "HRMA-HF". Значение уклона задается в виде подъема над протяженностью. Например, 30-градусный уклон обозначается 1/30, задается в виде 0,03333 (подъем/протяженность: 1 горизонтальный фактор HF по оси y / 30 градусов по оси x).	Double

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myHorizFactor = HfLinear(0.5, 181.0, 0.01111)
outPathDist = PathDistance("source.shp", "costraster", "", "", myHorizFactor)
outPathDist.save("C:/sapyexamples/output/pathdisthfl")

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

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

# Name: HfLinear_Ex_02.py
# Description: Uses the HfLinear 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 HfLinear Object
zeroFactor = 0.5
cutAngle = 181.0
slope = 0.01111
myHorizFactor = HfLinear(zeroFactor, cutAngle, slope)

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

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

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