Линия горизонта (3D Analyst)—ArcGIS Pro

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

Создает класс объектов линий или мультипатчей, содержащий результаты анализа очертаний линии горизонта.

Более подробно о том, как работает инструмент Линия горизонта

Иллюстрация

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

Инструмент Линия горизонта используется для создания объектов-силуэтов, которые могут быть вытянуты в объемы теней при помощи инструмента Граница видимости.
Следующие поля будут добавлены к значению параметра Выходной класс пространственных объектов, содержащему линии горизонта:
- OBSV_PT_ID– FID точки наблюдения, используемой для создания этой линии горизонта.
- ORIGFTR_ID – FID пространственного объекта, например, здания.
Следующие поля будут добавлены к значению параметра Выходной класс пространственных объектов, содержащему очертания:
- OBSV_PT_ID – FID точки наблюдения, используемой для создания этого силуэта.
- ORIGFTR_ID – FID исходного пространственного объекта, например здания, представляемого этим силуэтом.
- DIR_VECT_X – компонент X единичного вектора, представляющего направление световых лучей от наблюдателя.
- DIR_VECT_Y – компонент y единичного вектора, представляющего направление световых лучей от наблюдателя.
- DIR_VECT_Z – компонент z единичного вектора, представляющего направление световых лучей от наблюдателя.
- FEAT_CTR_X – компонент x центра внешней границы исходного пространственного объекта (например, здания).
- FEAT_CTR_Y – компонент y центра внешней границы пространственного объекта.
- FEAT_CTR_Z – компонент z центра внешней границы пространственного объекта.
- BHND_CTR_X – компонент x центра внешней границы пространственного объекта, перемещенной за этот объект.
- BHND_CTR_Y – компонент y центра внешней границы пространственного объекта, перемещенной за этот объект.
- BHND_CTR_Z – компонент z центра внешней границы пространственного объекта, перемещенной за этот объект.
- USED_PARLL – было ли создано очертание при помощи параллельных световых лучей (1 для ответа «да» и 0 для ответа «нет»).
- MADE_VERT – было ли очертание сделано вертикальным, а не перпендикулярным световым лучам (1 для ответа «да» и 0 для ответа «нет»).
- MOVED_BHND – было ли очертание перемещено за пространственный объект, а не оставлено в его центре (1 для ответа «да» и 0 для ответа «нет»).
Атмосферная рефракция и коррекция кривизны земли будут применяться только в том случае, если значение параметра Входная поверхность является набором растровых данных. Если ваша поверхность определяется набором данных TIN, terrain или LAS, используйте один из следующих инструментов для экспорта данных в растр:

Параметры

Подпись	Описание	Тип данных
Входные точечные объекты наблюдателей	3D точки, представляющие наблюдателей. По каждому объекту будут создаваться собственные выходные данные.	Feature Layer
Выходной класс пространственных объектов	3D объекты, которые могут быть линиями, представляющими линию горизонта, или объектами-мультипатч, которые представляют силуэты.	Feature Class
Входная поверхность (Дополнительный)	Топографическая поверхность, используемая для задания горизонта. Если поверхность не задана, будет использована виртуальная поверхность, определенная с помощью параметров Радиус виртуальной поверхности и Высота виртуальной поверхности.	LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer; Terrain Layer
Радиус виртуальной поверхности (Дополнительный)	Радиус виртуальной поверхности, используемой для задания горизонта, если не указана топографическая поверхность. По умолчанию используется значение 1,000 метров.	Linear Unit
Высота виртуальной поверхности (Дополнительный)	Высота виртуальной поверхности, используемая для определения горизонта вместо действительной поверхности. Если действительная поверхность указана, этот параметр игнорируется. По умолчанию - 0.	Linear Unit
Входные объекты (Дополнительный)	Объекты, используемые при определении линии горизонта. Если объекты не заданы, линия горизонта будет состоять только из горизонта, заданного топографической или виртуальной поверхностью.	Feature Layer
Уровень детальности объекта (Дополнительный)	Указывает уровень прорисовки, на котором следует изучить каждый пространственный объект. Полная детализация—Каждое ребро в пределах объекта будет рассматриваться в анализе линии горизонта (рассматриваются только ребра треугольников и внешних колец). Это длительная, но самая точная операция. Она используется по умолчанию. Контур оболочки—В анализе линии горизонта используется верхний периметр замкнутой оболочки, получаемой из контура каждого объекта, вытянутого до самой высокой вершины этого объекта. Конверт—В анализе линии горизонта используется периметр трехмерного конверта объекта. Это самый быстрый метод.	String
Азимут от (Дополнительный)	Азимут в градусах, от которого будет начинаться анализ линии горизонта. Анализ начинается с точки наблюдения и идет направо, от значения параметра Азимут от к значению параметра Азимут до. Значение должно быть больше -360 и меньше 360. По умолчанию - 0.	Double; Field
Азимут до (Дополнительный)	Направление в градусах, в котором будет завершен анализ линии горизонта. Анализ начинается с точки наблюдения и идет направо, от значения параметра Азимут от к значению параметра Азимут до. Это значение не должно быть более, чем на 360 градусов больше, чем значение параметра Азимут от. Значение по умолчанию равно 360.	Double; Field
Приращение азимута (Дополнительный)	Угловой интервал в градусах, при котором будет вычисляться горизонт при проведении анализа линии горизонта между значениями параметров Азимут от и Азимут до. Значение должно быть не больше разницы, которая получается, если из значения параметра Азимут от вычесть Азимут до. Значение по умолчанию равно 1.	Double; Field
Максимальный радиус горизонта (Дополнительный)	Максимальное расстояние от местоположения наблюдателя, на котором будет искаться горизонт. Значение 0 указывает на то, что ограничения не будут применяться. По умолчанию - 0.	Linear Unit
Горизонт сегмента (Дополнительный)	Указывает, будет ли полученная линия горизонта иметь по одному объекту на каждого наблюдателя, или линия горизонта каждого наблюдателя будет сегментирована на уникальные отрезки, вместе составляющие линию горизонта. Этот параметр активен только в том случае, если задан входной объект мультипатч. Если создаются силуэты, этот параметр покажет, должны ли использоваться дивергентные лучи. Для солнечных теней снимите отметку с этого параметра. Не отмечено – каждый объект линии горизонта соответствует одному наблюдателю. Это значение по умолчанию Отмечено – линия горизонта каждого наблюдателя будет сегментирована на уникальные отрезки.	Boolean
Масштаб к процентам (Дополнительный)	Процент исходного вертикального угла (угла над горизонтом, или угла высоты) или высоты каждой вершины линии горизонта должен быть размещен. Если используется значение 0 или 100, масштабирование не произойдет. По умолчанию используется 100.	Double
Масштаб на основании (Дополнительный)	Указывает, как будет определяться масштабирование. Вертикальный угол от наблюдателя—Масштабирование будет выполняться с учетом вертикального угла каждой вершины относительно точки наблюдения. Это значение по умолчанию Высоты—Масштабирование будет выполняться с учетом высоты каждой вершины относительно точки наблюдения.	String
Метод масштаба (Дополнительный)	Указывает вершину, которая будет использоваться для вычисления масштаба. Максимум линии горизонта—Вершины будут масштабированы относительно вертикального угла (или высоты) вершины с наибольшим вертикальным углом (или высотой). Это значение по умолчанию Каждая вершина—Вершины будут масштабированы относительно исходного вертикального угла (или высоты) каждой вершины.	String
Использовать кривизну (Дополнительный)	Указывает, будет ли кривизна земли использоваться при создании контура. Эта опция доступна только в том случае, если для параметра Входная поверхность указана растровая поверхность. Не отмечено — кривизна земли использоваться не будет. Это значение по умолчанию Отмечено - кривизна земли будет использована.	Boolean
Использовать рефракцию (Дополнительный)	Указывает, должна ли во время создания контура из входной поверхности применяться атмосферная рефракция. Эта опция доступна только в том случае, если для параметра Входная поверхность указана растровая поверхность. Не отмечено – атмосферная рефракция не будет применяться. Это значение по умолчанию Отмечено – атмосферная рефракция будет применяться.	Boolean
Коэффициент рефракции (Дополнительный)	Если атмосферная рефракция учитывается, будет применен коэффициент рефракции. Значение по умолчанию равно 0.13.	Double
Разрешение уровня пирамидных слоев (Дополнительный)	Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.	Double
Создать силуэты (Дополнительный)	Задает, будут ли выходные объекты представлять линии горизонта или силуэты. Не отмечено – создаются полилинейные объекты, представляющие линию горизонта. Это значение по умолчанию Отмечено – создаются объекты мультипатч, представляющие силуэты.	Boolean

arcpy.ddd.Skyline(in_observer_point_features, out_feature_class, {in_surface}, {virtual_surface_radius}, {virtual_surface_elevation}, {in_features}, {feature_lod}, {from_azimuth_value_or_field}, {to_azimuth_value_or_field}, {azimuth_increment_value_or_field}, {max_horizon_radius}, {segment_skyline}, {scale_to_percent}, {scale_according_to}, {scale_method}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {create_silhouettes})

Имя	Описание	Тип данных
in_observer_point_features	3D точки, представляющие наблюдателей. По каждому объекту будут создаваться собственные выходные данные.	Feature Layer
out_feature_class	3D объекты, которые могут быть линиями, представляющими линию горизонта, или объектами-мультипатч, которые представляют силуэты.	Feature Class
in_surface (Дополнительный)	Топографическая поверхность, используемая для задания горизонта. Если поверхность не задана, будет использована виртуальная поверхность, определенная с помощью параметров virtual_surface_radius и virtual_surface_elevation.	LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer; Terrain Layer
virtual_surface_radius (Дополнительный)	Радиус виртуальной поверхности, используемой для задания горизонта, если не указана топографическая поверхность. По умолчанию используется значение 1,000 метров.	Linear Unit
virtual_surface_elevation (Дополнительный)	Высота виртуальной поверхности, используемая для определения горизонта вместо действительной поверхности. Если действительная поверхность указана, этот параметр игнорируется. По умолчанию - 0.	Linear Unit
in_features [in_features,...] (Дополнительный)	Объекты, используемые при определении линии горизонта. Если объекты не заданы, линия горизонта будет состоять только из горизонта, заданного топографической или виртуальной поверхностью.	Feature Layer
feature_lod (Дополнительный)	Указывает уровень прорисовки, на котором следует изучить каждый пространственный объект. FULL_DETAIL—Каждое ребро в пределах объекта будет рассматриваться в анализе линии горизонта (рассматриваются только ребра треугольников и внешних колец). Это длительная, но самая точная операция. Она используется по умолчанию. CONVEX_FOOTPRINT—В анализе линии горизонта используется верхний периметр замкнутой оболочки, получаемой из контура каждого объекта, вытянутого до самой высокой вершины этого объекта. ENVELOPE—В анализе линии горизонта используется периметр трехмерного конверта объекта. Это самый быстрый метод.	String
from_azimuth_value_or_field (Дополнительный)	Азимут в градусах, от которого будет начинаться анализ линии горизонта. Анализ начинается с точки наблюдения и идет направо, от значения параметра from_azimuth_value_or_field к значению параметра to_azimuth_value_or_field. Значение должно быть больше -360 и меньше 360. По умолчанию - 0.	Double; Field
to_azimuth_value_or_field (Дополнительный)	Направление в градусах, в котором будет завершен анализ линии горизонта. Анализ начинается с точки наблюдения и идет направо, от значения параметра from_azimuth_value_or_field к значению параметра to_azimuth_value_or_field. Это значение не должно быть более, чем на 360 градусов больше, чем значение параметра from_azimuth_value_or_field. Значение по умолчанию равно 360.	Double; Field
azimuth_increment_value_or_field (Дополнительный)	Угловой интервал в градусах, при котором будет вычисляться горизонт при проведении анализа линии горизонта между значениями параметров from_azimuth_value_or_field и to_azimuth_value_or_field. Значение должно быть не больше разницы, которая получается, если из значения параметра to_azimuth_value_or_field вычесть from_azimuth_value_or_field. Значение по умолчанию равно 1.	Double; Field
max_horizon_radius (Дополнительный)	Максимальное расстояние от местоположения наблюдателя, на котором будет искаться горизонт. Значение 0 указывает на то, что ограничения не будут применяться. По умолчанию - 0.	Linear Unit
segment_skyline (Дополнительный)	Указывает, будет ли полученная линия горизонта иметь по одному объекту на каждого наблюдателя, или линия горизонта каждого наблюдателя будет сегментирована на уникальные отрезки, вместе составляющие линию горизонта. Этот параметр включен только в том случае, если задан входной объект мультипатч. Если создаются силуэты, этот параметр покажет, должны ли использоваться дивергентные лучи. Для солнечных теней отметьте для этого параметра NO_SEGMENT_SKYLINE. NO_SEGMENT_SKYLINE—Каждый объект линии горизонта соответствует одному наблюдателю. Это значение по умолчанию SEGMENT_SKYLINE—Линия горизонта каждого наблюдателя будет сегментирована на уникальные отрезки.	Boolean
scale_to_percent (Дополнительный)	Процент исходного вертикального угла (угла над горизонтом, или угла высоты) или высоты каждой вершины линии горизонта должен быть размещен. Если используется значение 0 или 100, масштабирование не произойдет. По умолчанию используется 100.	Double
scale_according_to (Дополнительный)	Указывает, как будет определяться масштабирование. VERTICAL_ANGLE—Масштабирование будет выполняться с учетом вертикального угла каждой вершины относительно точки наблюдения. Это значение по умолчанию ELEVATION—Масштабирование будет выполняться с учетом высоты каждой вершины относительно точки наблюдения.	String
scale_method (Дополнительный)	Указывает вершину, которая будет использоваться для вычисления масштаба. SKYLINE_MAXIMUM—Вершины будут масштабированы относительно вертикального угла (или высоты) вершины с наибольшим вертикальным углом (или высотой). Это значение по умолчанию EACH_VERTEX—Вершины будут масштабированы относительно исходного вертикального угла (или высоты) каждой вершины.	String
use_curvature (Дополнительный)	Указывает, будет ли кривизна земли использоваться при создании контура из функциональной поверхности. Эта опция доступна только в том случае, если для параметра in_surface указана растровая поверхность. CURVATURE—Кривизна Земли будет использоваться. NO_CURVATURE—Кривизна Земли не будет использоваться. Это значение по умолчанию	Boolean
use_refraction (Дополнительный)	Указывает, должна ли во время создания контура из функциональной поверхности применяться атмосферная рефракция. Эта опция доступна только в том случае, если для параметра in_surface указана растровая поверхность. NO_REFRACTION—Атмосферная рефракция не будет применяться. Это значение по умолчанию REFRACTION—Атмосферная рефракция будет применяться.	Boolean
refraction_factor (Дополнительный)	Если атмосферная рефракция учитывается, будет применен коэффициент рефракции. Значение по умолчанию равно 0.13.	Double
pyramid_level_resolution (Дополнительный)	Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.	Double
create_silhouettes (Дополнительный)	Задает, будут ли выходные объекты представлять линии горизонта или силуэты. NO_CREATE_SILHOUETTES—Итоговые полилинейные объекты будут представлять линию горизонта. Это значение по умолчанию CREATE_SILHOUETTES—Итоговые объекты мультипатча будут представлять силуэты.	Boolean

Пример кода

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

В следующем примере показано использование этого инструмента в окне Python.

arcpy.env.workspace = "C:/data"
arcpy.Skyline_3d("observers.shp", "skyline_output.shp", "sample.gdb/featuredataset/terrain")

Skyline, пример 2 (автономный скрипт)

В следующем примере показано использование этого инструмента в автономном скрипте Python.

'''****************************************************************************
Name: Skyline Example
Description: This script demonstrates how to use the 
             Skyline tool.
****************************************************************************'''
# Import system modules
import arcpy

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

# Set Local Variables
inPts = "observers.shp"

# Make sure output has a unique name
outFC = arcpy.CreateUniqueName("skyline_output.shp")
inSurface = "sample.gdb/featuredataset/terrain"
obstructionFCs = "buildings.shp; billboards.shp"
surfRad = "1000 meters"
surfElev = "100 meters"
LOD = "FULL_DETAIL"
fromAzim = 0
toAzim = 360
incAzim = 1
maxHorizRad = 0
segSky = "SEGMENT_SKYLINE"
scale = 100
scaleAcc = "ELEVATION"
scaleMethod = "SKYLINE_MAXIMUM"

# Execute Skyline
arcpy.Skyline_3d(inPts, outFC, inSurface, surfRad, surfElev, 
                 obstructionFCs, LOD, fromAzim, toAzim, incAzim, 
                 maxHorizRad, segSky, scale, scaleAcc, scaleMethod)

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

Текущая рабочая область, Выходная система координат, Географические преобразования, Разрешение XY, Допуск XY, Выходной XY домен, Разрешение Z, Допуск Z, Выходной домен Z, Выходное ключевое слово CONFIG, Автоматическое подтверждение, Использование памяти Terrain

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

Иллюстрация

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

Параметры

Пример кода

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

Особые случаи

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

Связанные разделы

В этом разделе