Доступно с лицензией Spatial Analyst.
Краткая информация
С помощью геодезических методов определяет положения на поверхности растра, которые видимы для набора объектов наблюдателей.
Более подробно о том, как работает инструмент Обоюдная видимость 2
Использование
Этот инструмент может выполнять два типа анализа видимости в зависимости от значения параметра Тип анализа. Для первого типа, FREQUENCYинструмент определяет, какие местоположения растровой поверхности видимы для набора наблюдателей. Для других, OBSERVERSон определяет, какие точки наблюдения видны из каждого положения на поверхности растра.
Этот инструмент может быть ускорен GPU, что означает то, что если графический процессор (GPU) доступен в вашей системе, то он будет использоваться для повышения производительности инструмента.
В настоящее время этот инструмент поддерживает только видеокарту NVIDIA с вычислительными возможностями CUDA 2.0 или OpenCL 1.2 и зависит от того, установлена ли соответствующая видеокарта в вашей системе. Для обеспечения надлежащего выполнения инструмента, см. страницу обновления драйвера NVIDIA
, чтобы найти самый новый драйвер.Возможно возникновение ошибки GPU и несрабатывание инструмента, если значение ключа реестра Windows TdrDelay (обнаружение таймаута и задержка восстановления) будет слишком мало. По умолчанию для TdrDelay установлено значение, равное 2 секундам, но вам может потребоваться увеличить это значение до 60 секунд. На большинстве систем с Windows путь к ключу TdrDelay в Реестре следующий: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GraphicsDrivers. Если ключ TdrDelay не существует, то его необходимо создать в указанном выше расположении и задать для него большое значение. Вы должны перезагрузить компьютер, чтобы внесенные изменения вступили в силу. Более подробная информация о том, как определить ключ реестра TdrDelay, доступна на веб-странице Microsoft TDR Registry Keys
.В отличие от других аналогичных инструментов Обоюдная видимость 2 не имеет параметра Коэффициент Z. Чтобы убедиться в правильности отображения растра, присвойте сфероидальную вертикальную систему координат входному растру, если она еще не используется.
Видимость для каждого центра ячейки определяется тестом линии взгляда между целью и каждым наблюдателем. Если наблюдатель может видеть цель в центре ячейки, то ячейка считается видимой. Этот инструмент всегда учитывает кривизну Земли при определении видимости.
В выходном растре видимости невидимым ячейкам будет присвоено значение NoData.
Для OBSERVERS типа анализа, разрешенное максимальное число входных точек наблюдателей составляет 32.
Если входной растр содержит нежелательные шумы, вызванные погрешностями определений в опорных точках, вы можете выполнить до запуска этого инструмента сглаживание растра с помощью фильтра нижних частот, например с использованием опции Среднее (Mean) функции Фокальная статистика.
Когда возникает необходимость пересчитать входной растр, используется метод Билинейной интерполяции. Пример, когда входной растр может быть пересчитан, – когда выходные система координат, экстент или размер ячеек отличаются от входных.
По умолчанию, видимость будет вычисляться по максимальному экстенту входного набора данных. Для повышения производительности, рекомендуется явно задать для параметра Внешний радиус максимальное расстояние интереса для анализа. Этот параметр позволит инструменту проводить вычисления только по тем ячейкам, которые находятся в пределах указанного расстояния от наблюдателя.
Можно использовать параметр Метод анализа для управления качеством результата и временем, затраченным на его получение. Кнопка PERIMETER_SIGHTLINES метод предназначен для оценочного анализа, т.к. он имеет наивысшую производительность за счет снижения качества. Чтобы получить наиболее точный результат, используйте ALL_SIGHTLINES метод.
Для более подробной информации о технических аспектах реализации данного инструмента, см. следующий ресурс.
http://support.esri.com/en/knowledgebase/techarticles/detail/42804
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Viewshed2 (in_raster, in_observer_features, {out_agl_raster}, {analysis_type}, {vertical_error}, {out_observer_region_relationship_table}, {refractivity_coefficient}, {surface_offset}, {observer_elevation}, {observer_offset}, {inner_radius}, {inner_radius_is_3d}, {outer_radius}, {outer_radius_is_3d}, {horizontal_start_angle}, {horizontal_end_angle}, {vertical_upper_angle}, {vertical_lower_angle}, {analysis_method})| Параметр | Объяснение | Тип данных |
in_raster | Входной растр поверхности. Тип растра может быть целочисленным или с плавающей точкой. Во время расчета видимости входной растр преобразуется в трёхмерную (3D) геоцентрическую систему координат. Ячейки входного растра со значением NoData не блокируют определение видимости. | Raster Layer |
in_observer_features | Входной класс объектов, который идентифицирует местоположения наблюдателей. Это могут быть точечные, мультиточечные или полилинейные объекты. Во время расчета видимости входной класс объектов трансформируется в трёхмерную (3D) геоцентрическую систему координат. Наблюдатели, находящиеся за пределами экстента растра поверхности или помещённые в ячейки со значением NoData, при расчете будут игнорироваться. | Feature Layer |
out_agl_raster (дополнительно) | Выходной растр над уровнем поверхности (AGL). AGL создает растр, в котором значение каждой ячейки является минимальной высотой, которая должна быть добавлена к невидимой ячейке, чтобы сделать ее видимой хотя бы для одного наблюдателя. Ячейки, которые уже были видны, в выходном растре будут иметь значение 0. Когда параметр ошибка по вертикали равен нулю, выходной растр AGL является одноканальным. Когда ошибка по вертикали больше нуля, для учета случайных эффектов от входного растра выходной растр AGL создается как трех-канальный. В первом канале представлены средние значения, во втором – минимальные значения AGL, а в третьем – максимальные значения AGL. | Raster |
analysis_type (дополнительно) | Выберите тип анализа видимости, который вы хотите выполнить, определив либо то, как будет видна наблюдателям каждая из ячеек, либо определив наблюдателей, видимых для каждого из местоположений поверхности.
| String |
vertical_error (дополнительно) | Значение неточности (Среднеквадратическая ошибка или RMSE) в значениях высоты поверхности. Это значение с плавающей точкой, представляющее ожидаемую ошибку входных значений высот. Если данному параметру присваивается значение больше 0, то выходной растр видимости будет представлен значениями с плавающей точкой. В данном случае значение каждой ячейки выходного растра видимости представляет сумму вероятностей того, что ячейка будет видимой для любого из наблюдателей. Когда тип анализа это OBSERVERS или метод анализа PERIMETER_SIGHTLINES, этот параметр не применяется. | Linear unit |
out_observer_region_relationship_table (дополнительно) | Выходная таблица для выявления регионов, которые видимы для каждого наблюдателя. Данная таблица может быть связана с входным классом объектов-наблюдателей и выходным растром видимости для выявления регионов, видимых для данных наблюдателей. Выходные данные создаются только в том случае, когда типом анализа является OBSERVERS. | Table |
refractivity_coefficient (дополнительно) | Коэффициент рефракции видимого диапазона света в воздухе. Значение, предлагаемое по умолчанию, равно 0,13. | Double |
surface_offset (дополнительно) | Это значение определяет вертикальное расстояние (в единицах поверхности), которое должно быть добавлено к z-значению каждой целевой ячейки, в том случае, если этот параметр учитывается в анализе видимости. Его значение должно быть положительным целым числом или числом с плавающей точкой. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра задано какое-то значение, то это значение будет применяться для всех наблюдателей. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Linear unit | Field |
observer_elevation (дополнительно) | Это значение используется для определения высоты точек или вершин наблюдения на поверхности. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если этот параметр не будет указан, то высота наблюдателя будет определена по растру поверхности с использованием билинейной интерполяции. Если для этого параметра задано какое-то значение, то это значение будет применяться для всех наблюдателей. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Linear unit | Field |
observer_offset (дополнительно) | Это значение определяет вертикальное расстояние (в единицах поверхности), которое должно быть добавлено к z-значению высоты наблюдателя. Его значение должно быть положительным целым числом или числом с плавающей точкой. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра задано какое-то значение, то это значение будет применяться для всех наблюдателей. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Linear unit | Field |
inner_radius (дополнительно) | Это значение определяет стартовое (минимальное) расстояние, с которого будет определяться видимость. Ячейки на расстоянии ближе указанного считаются невидимыми в выходных данных, но они все еще могут перекрывать видимость ячеек между внутренним радиусом и внешним радиусом. По умолчанию значение равно 0. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра установлено некоторое значение, то данное значение будет применяться ко всем наблюдателям. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Linear unit | Field |
inner_radius_is_3d (дополнительно) | Тип расстояния для параметра внутреннего радиуса.
| Boolean |
outer_radius (дополнительно) | Это значение определяет максимальное расстояние, от которого определяется видимость. Ячейки за пределами этого радиуса исключаются из анализа. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра установлено некоторое значение, то данное значение будет применяться ко всем наблюдателям. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Linear unit | Field |
outer_radius_is_3d (дополнительно) | Тип расстояния для параметра внешнего радиуса.
| Boolean |
horizontal_start_angle (дополнительно) | Это значение определяет начальный угол диапазона горизонтального сканирования. Это значение задается в градусах от 0 до 360.0; 0 соответствует направлению на север. По умолчанию значение равно 0. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра установлено некоторое значение, то данное значение будет применяться ко всем наблюдателям. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Constant | Field |
horizontal_end_angle (дополнительно) | Это значение определяет конечный угол диапазона горизонтального сканирования. Это значение задается в градусах от 0 до 360.0; 0 соответствует направлению на север. Значение, предлагаемое по умолчанию, равно 360.0. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра установлено некоторое значение, то данное значение будет применяться ко всем наблюдателям. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Constant | Field |
vertical_upper_angle (дополнительно) | Это значение определяет верхнюю границу вертикального угла сканирования над горизонтальной плоскостью. Это значение задается в градусах от 0 до 90.0, целочисленными или с плавающей точкой. Значение, предлагаемое по умолчанию, равно 90.0. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра установлено некоторое значение, то данное значение будет применяться ко всем наблюдателям. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Constant | Field |
vertical_lower_angle (дополнительно) | Это значение определяет нижнюю границу вертикального угла сканирования под горизонтальной плоскостью. Это значение задается в градусах от -90.0 до 0, целочисленными или с плавающей точкой. По умолчанию значение равно -90.0. Это может быть поле во входном наборе данных объектов-наблюдателей или числовое значение. Если для этого параметра установлено некоторое значение, то данное значение будет применяться ко всем наблюдателям. Чтобы задать различные значения для каждого наблюдателя, установите этот параметр на поле во входном наборе данных объектов-наблюдателей. | Constant | Field |
analysis_method (дополнительно) | Выберите метод, который будет использоваться для расчета видимости. Эта опция позволит вам увеличить производительность в обмен на некоторое снижение точности.
| String |
Возвращено значение
| Имя | Объяснение | Тип данных |
| out_raster | Выходной растр. Для FREQUENCY типа анализа, когда параметр вертикальной ошибки равен 0 или не указан, в выходной растр записывается число раз, которое каждое местоположение ячейки входного растра поверхности можно увидеть из входных точек наблюдения. Когда параметр вертикальной ошибки больше 0, в каждую ячейку выходного растра записывается сумма вероятностей того, что ячейка будет видимой для любого из наблюдателей. Для OBSERVERS в выходной растр записываются уникальные ID регионов для видимых областей, которые могут быть связаны обратно с объектами-наблюдателями через выходную таблицу отношений наблюдатель-регион. | Raster |
Пример кода
Viewshed2, пример 1 (окно Python)
Этот пример определяет видимые для ряда наблюдателей местоположения поверхности, не используя никаких параметров наблюдателей.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outViewshed2 = Viewshed2("elevation", "obser1.shp", "", "OBSERVERS", "",
"C:/sapyexamples/output/obstable01.dbf",
analysis_method="ALL_SIGHTLINES")
outViewshed2.save("C:/sapyexamples/output/outvwshd2_01")
Viewshed2, пример 2 (автономный скрипт)
Этот пример определяет видимые для ряда наблюдателей местоположения поверхности, используя атрибуты входного класса объектов в качестве параметров наблюдателей.
# Name: Viewshed2_Ex_02.py
# Description: Determines the raster surface locations visible to a set of
# observer features.
# 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.checkOutExtension("Spatial")
inRaster = "elevation"
inObservers = "obser2.shp"
outAGL = ""
analysisType = "OBSERVERS"
verticalError = ""
outAnalysisRelationTable = "C:/sapyexamples/output/obser_region2.dbf"
refractCoeff = ""
surfaceOffset = "offsetb"
observerElevation = "spot"
observerOffset = "offseta"
innerRadius = "radius1"
innerIs3D = "False"
outerRadius = "radius2"
outerIs3D = "True"
horizStartAngle = "azimuth1"
horizEndAngle = "azimuth2"
vertUpperAngle = "vert1"
vertLowerAngle = "vert2"
analysisMethod = "ALL_SIGHTLINES"
# Execute Viewshed2
outViewshed2 = Viewshed2(inRaster, inObservers, outAGL, analysisType,
verticalError, outAnalysisRelationTable, refractCoeff,
surfaceOffset, observerElevation, observerOffset,
innerRadius, innerIs3D, outerRadius, outerIs3D,
horizStartAngle, horizEndAngle, vertUpperAngle,
vertLowerAngle, analysisMethod)
# Save the output
outViewshed2.save("C:/sapyexamples/output/outvwshd2_02")
Параметры среды
- Автоподтверждение (Auto Commit)
- Размер ячейки (Cell size)
- Сжатие (Compression)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Коэффициент параллельной обработки (Parallel Processing Factor)
- Статистика растра (Raster Statistics)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)