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

Сводка

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

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

Иллюстрация

Линия горизонта

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

  • Инструмент Линия горизонта используется для создания объектов-силуэтов, которые могут быть вытянуты в объемы теней при помощи инструмента Граница видимости. См. дополнительную информацию в разделе Как работает инструмент Линия горизонта.

  • Следующие поля будут добавлены к выходному классу пространственных объектов, содержащему линии горизонта:

    • 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 для ответа «нет»).

Синтаксис

arcpy.3d.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})
ParameterОбъяснениеТип данных
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 метров.

Поддерживаются следующие единицы измерения:

  • UNKNOWNНеизвестно
  • INCHESДюймы
  • FEETФуты
  • YARDSЯрды
  • MILESМили
  • MILLIMETERSМиллиметры
  • CENTIMETERSСантиметры
  • DECIMETERSДециметры
  • METERSМетры
  • KILOMETERSКилометры
Linear Unit
virtual_surface_elevation
(Дополнительный)

Высота виртуальной поверхности для определения горизонта вместо действительной поверхности. Если действительная поверхность указана, игнорируется. Значение по умолчанию равно 0.

Поддерживаются следующие единицы измерения:

  • UNKNOWNНеизвестно
  • INCHESДюймы
  • FEETФуты
  • YARDSЯрды
  • MILESМили
  • MILLIMETERSМиллиметры
  • CENTIMETERSСантиметры
  • DECIMETERSДециметры
  • METERSМетры
  • KILOMETERSКилометры
Linear Unit
in_features
[in_features,...]
(Дополнительный)

Объекты, используемые при определении линии горизонта. Если объекты не заданы, линия горизонта будет состоять только из горизонта, заданного топографической или виртуальной поверхностью.

Feature Layer
feature_lod
(Дополнительный)

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

  • FULL_DETAILКаждое ребро в пределах объекта рассматривается в анализе линии горизонта (рассматриваются только ребра треугольников и внешних колец). Это длительная, но самая точная операция, она также используется по умолчанию.
  • CONVEX_FOOTPRINTВ анализе линии горизонта используется верхний периметр замкнутой оболочки, получаемой из контура каждого объекта, вытянутого до самой высокой вершины этого объекта.
  • ENVELOPE В анализе линии горизонта используется периметр 3-мерного конверта объекта. Это самый быстрый метод.
String
from_azimuth_value_or_field
(Дополнительный)

Азимут в градусах, от которого должен начинаться анализ линии горизонта. Анализ начинается с точки наблюдения и идет направо, от Азимут от к Азимут до. Должен быть больше -360 и меньше 360. Значение по умолчанию равно 0.

Double; Field
to_azimuth_value_or_field
(Дополнительный)

Направление в градусах, в котором должен быть завершен анализ линии горизонта. Анализ начинается с точки наблюдения и идет направо, от Азимут от к Азимут до. Не должен превышать Азимут от более, чем в 360 раз. Значение по умолчанию равно 360.

Double; Field
azimuth_increment_value_or_field
(Дополнительный)

Угловой интервал в градусах, при котором должен быть вычислен горизонт при проведении анализа линии горизонта между Азимут от и Азимут до. Должно быть не больше, чем Азимут до, минус Азимут от. Значение по умолчанию равно 1.

Double; Field
max_horizon_radius
(Дополнительный)

Максимальная дистанция, для которой должен быть найден горизонт из местоположения наблюдателя. Значение 0 указывает на то, что ограничения не должны применяться. Значение по умолчанию равно 0.

Поддерживаются следующие единицы измерения:

  • UNKNOWNНеизвестно
  • INCHESДюймы
  • FEETФуты
  • YARDSЯрды
  • MILESМили
  • MILLIMETERSМиллиметры
  • CENTIMETERSСантиметры
  • DECIMETERSДециметры
  • METERSМетры
  • KILOMETERSКилометры
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
(Дополнительный)

Указывает, должна ли учитываться кривизна Земли во время создания хребта из функциональной поверхности.

  • CURVATUREКривизна земной поверхности учитывается.
  • NO_CURVATUREКривизна земной поверхности не учитывается. Используется по умолчанию.
Boolean
use_refraction
(Дополнительный)

Указывает, должна ли во время создания хребта из функциональной поверхности применяться атмосферная рефракция.

  • 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)

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

  • Basic: Требуется 3D Analyst
  • Standard: Требуется 3D Analyst
  • Advanced: Требуется 3D Analyst

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