Справка

Точки наблюдения

Доступно с лицензией Spatial Analyst.

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

Определяет, какие точки наблюдения видны из каждого положения на поверхности растра.

Более подробно об инструменте Точки наблюдения (Observer Points)

Использование

  • Определение точек наблюдения – процесс, требующий интенсивной работы процессора. Время на обработку зависит от разрешения растра. Для предварительного изучения территории вы можете воспользоваться более крупным размером ячейки, чтобы уменьшить количество ячеек входного растра. Используйте растр с полным разрешением, когда вы готовы создать растр с окончательными результатами.

  • Если входной растр содержит нежелательные шумы, вызванные погрешностями определений в опорных точках, вы можете выполнить до запуска этого инструмента сглаживание растра с помощью фильтра нижних частот, например с использованием опции Среднее (Mean) функции Фокальная статистика.

  • Видимость центра каждой ячейки определяется путем сравнивания угла высоты до центра ячейки с углом высоты локального горизонта. Локальный горизонт вычисляется с помощью рассмотрения участка поверхности между точкой наблюдения и центром текущей ячейки. Если точка лежит над местным горизонтом, она считается видимой.

  • Инструмент создает дополнительный выходной растр над уровнем поверхности (AGL). Каждая ячейка выходного растра AGL содержит значение минимальной высоты, которое должно быть добавлено к ячейке, чтобы сделать ее видимой хотя бы для одного наблюдателя.

    Если входные объекты-наблюдатели содержат несколько наблюдателей, выходное значение является минимальным из значений AGL от каждого из отдельных наблюдателей.

  • Когда возникает необходимость пересчитать входной растр, используется метод Билинейной интерполяции. Пример, когда входной растр может быть пересчитан, – когда выходные система координат, экстент или размер ячеек отличаются от входных.

  • См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

ObserverPoints (in_raster, in_observer_point_features, {z_factor}, {curvature_correction}, {refractivity_coefficient}, {out_agl_raster})
ПараметрОбъяснениеТип данных
in_raster

Входной растр поверхности.

Raster Layer
in_observer_point_features

Класс точечных объектов, который определяет местоположения наблюдения.

Максимально возможное число точек равно 16.

Feature Layer
z_factor
(дополнительно)

Количество наземных единиц измерения координат x,y в одной единице измерения z-значения поверхности.

Коэффициент z (z-factor) приводит в соответствие единицы измерения z-значений в том случае, если они отличаются от единиц измерения координат x,y входной поверхности. При вычислении результирующей выходной поверхности z-значения входной поверхности умножаются на коэффициент по z.

Если координаты x,y и z-значения приведены в одной и той же системе координат, коэффициент z равен 1. Это значение используется по умолчанию.

Если координаты x,y и z-значения приведены в отличающихся единицах измерения, для коэффициента по z должно быть задано соответствующее значение, или же результаты будут некорректными. Например, если единицы измерения для z-значений – футы, а координаты x,y приведены в метрах, для преобразования z-значений из футов в метры вы должны использовать коэффициент по z, равный 0,3048 (1 фут = 0,3048 метра).

Double
curvature_correction
(дополнительно)

Позволяет выполнять коррекцию на кривизну земли.

  • FLAT_EARTH — Не будет применяться коррекция кривизны. Это значение используется по умолчанию.
  • CURVED_EARTH — Будет применяться коррекция кривизны.
Boolean
refractivity_coefficient
(дополнительно)

Коэффициент рефракции видимого диапазона света в воздухе.

Значение, предлагаемое по умолчанию, равно 0,13.

Double
out_agl_raster
(дополнительно)

Выходной растр над уровнем поверхности (AGL).

AGL создает растр, в котором значение каждой ячейки является минимальной высотой, которая должна быть добавлена к невидимой ячейке, чтобы сделать ее видимой хотя бы для одного наблюдателя.

Ячейки, которые уже были видны, в выходном растре будут иметь значение 0.

Raster

Возвращено значение

ИмяОбъяснениеТип данных
out_raster

Выходной растр.

Выходные данные определяют, какие точки наблюдения видны из каждого положения на поверхности растра.

Raster

Пример кода

ObserverPoints, пример 1 (окно Python)

В этом примере точно определяется, какие точки наблюдения видны из каждого положения на поверхности растра.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outObsPoints = ObserverPoints("elevation","observers.shp", 1, "CURVED_EARTH", 0.13)
outObsPoints.save("C:/sapyexamples/output/outobspnt01")
ObserverPoints, пример 2 (автономный скрипт)

В этом примере точно определяется, какие точки наблюдения видны из каждого положения на поверхности растра.

# Name: ObserverPoints_Ex_02.py
# Description: Identifies exactly which observer points are visible 
#              from each raster surface location.
# 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
inRaster = "elevation"
inObsPoints = "observers.shp"
zFactor = 1
useEarthCurv = "CURVED_EARTH"
refractionVal = 0.13

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

# Execute ObserverPoints
outObsPoints = ObserverPoints(inRaster, inObsPoints, zFactor, 
                              useEarthCurv, refractionVal)

# Save the output 
outObsPoints.save("C:/sapyexamples/output/outobspnt02")

Параметры среды

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

Отзыв по этому разделу?