Видимость (3D Analyst)

Уровень лицензии:BasicStandardAdvanced

Резюме

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

Более подробно об инструменте Видимость (Viewshed)

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

Синтаксис

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

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

Raster Layer
in_observer_features

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

Входными данными могут быть точечные или полилинейные объекты.

Feature Layer
out_raster

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

В выходных данных будет записано только количество, соответствующее подсчёту точек наблюдения (или вершин полилиний), из которых можно видеть каждую точку на входном растре. Частота наблюдения будет записана в поле VALUE таблицы атрибутов выходного растра.

Raster Dataset
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

Пример кода

Видимость. Пример 1 (окно Python)

В этом примере определяются местоположения поверхности, видимые для набора наблюдателей, заданного с помощью шейп-файла.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Viewshed_3d("elevation", "observers.shp", "C:/output/outvwshd01", 2,
                  "CURVED_EARTH", 0.15)
Видимость. Пример 2 (автономный скрипт)

В этом примере определяются местоположения поверхности, видимые для набора наблюдателей, заданного с помощью шейп-файла.

# Name: Viewshed_3d_Ex_02.py
# Description: Determines the raster surface locations visible to a set of
#              observer features.
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inRaster = "elevation"
inObserverFeatures = "observers.shp"
outViewshed = "C:/output/outvwshd02"
zFactor = 2
useEarthCurvature = "CURVED_EARTH"
refractivityCoefficient = 0.15

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

# Execute Viewshed
arcpy.Viewshed_3d(inRaster, inObserverFeatures, outViewshed, zFactor,
                  useEarthCurvature, refractivityCoefficient)

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

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

Информация о лицензировании

ArcGIS for Desktop Basic: Требует 3D Analyst или Spatial Analyst
ArcGIS for Desktop Standard: Требует 3D Analyst или Spatial Analyst
ArcGIS for Desktop Advanced: Требует 3D Analyst или Spatial Analyst
9/10/2013