VfCos (arcpy.sa)

Резюме

Задает отношение между вертикальным фактором стоимости и вертикальным относительным углом движения через функцию косинуса.

Рисунок

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

Обсуждение

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

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

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

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

VF определяется косинусом угла VRMA.

Синтаксис

VfCos ({lowCutAngle}, highCutAngle, {cosPower})

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

Свойства

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

Пример кода

@@@Вертикальный фактор с функцией косинуса@@@. Пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
myVerticalFactor = VfCos(-15, 15, 1.5)
outPathDist = PathDistance("source.shp", "costraster", "", "", "", "",
                           myVerticalFactor)
outPathDist.save("C:/sapyexamples/output/pathdistvfc")

@@@Вертикальный фактор с функцией косинуса@@@. Пример 2 (автономный скрипт)

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

# Name: VfCos_Ex_02.py
# Description: Uses the VfCos 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 VfCos Object
lowCutAngle = -15
highCutAngle = 45
cosPower = 2
myVerticalFactor = VfCos(lowCutAngle, highCutAngle, cosPower)

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