HfLinear (arcpy.sa)

Резюме

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

Рисунок

Изображение горизонтального фактора HfLinear
Горизонтальный фактор 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")

Связанные темы

9/11/2013