Схема горизонта (3D Analyst)

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

Вычисляет коэффициент видимости неба и строит дополнительную таблицу и полярную диаграмму.

Иллюстрация

Иллюстрация инструмента Схема горизонта

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

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

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

    • HORIZ_ANG— Арифметический горизонтальный угол, выраженный так, что 0° соответствует направлению на восток, а значения увеличиваются в направлении против часовой стрелки до 360°. Арифметический горизонтальный угол равен 90 градусам минус азимут.
    • ZENITH_ANG— Зенитный угол, где 0° находится прямо вверх по оси z, 90° — на горизонте, а 180° — прямо вниз по оси z. Зенитный угол равен 90 минус вертикальный угол от горизонта.
    • HOR_AN_GEO— Географический горизонтальный угол, где 0° находится на севере проекции, а значения увеличиваются по часовой стрелке до 360°.
    • ZEN_AN_INV— Зенитный угол, где 0° находится на горизонте, 90° — прямо вверх по оси z, а -90° — прямо вниз по оси z.

    Если отмечен параметр Дополнительные поля, выходная таблица также будет содержать следующие поля:

    • FEATURE_ID— уникальный идентификатор объекта, определяющего линию горизонта. Строки, в которых это значение равно -1, обозначают места, где линия горизонта определяется поверхностью, тогда как значение -2 представляет собой переходные линии, которые не влияют на линию горизонта, но используются для соединения сегментов, определяющих линию горизонта.
    • VERTEX_X– координата X вершины.
    • VERTEX_Y– координата Y вершины.
    • VERTEX_Z– координата Z вершины.
    • DIST_2D– горизонтальное расстояние от наблюдателя до вершины.
    • DIST_3D– расстояние по уклону от наблюдателя до вершины.
  • Инструмент сообщает минимальный и максимальный вертикальные углы видимости неба вместе с коэффициентом видимости, который выражается в виде значения от 0 до 1. Коэффициент видимости 0.8 означает, что 80 процентов неба видимо.

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

Параметры

ПодписьОписаниеТип данных
Входные точечные объекты наблюдателей

Входной класс объектов, содержащий одну или несколько точек наблюдения.

Feature Layer
Входные линейные объекты

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

Feature Layer
Базовый угол видимости
(Дополнительный)

Вертикальный угол от базовой линии, который используется для вычисления процента видимости неба. Горизонтальному направлению соответствует 0, направлению вертикально вверх – 90, вертикально вниз – -90. По умолчанию - 0.

Double
Дополнительные поля
(Дополнительный)

Показывает, будут ли дополнительные поля добавлены к таблице углов.

  • Не отмечено – дополнительные поля не добавляются. Это значение по умолчанию
  • Отмечено – дополнительные поля будут добавлены.
Boolean
Выходная таблица углов
(Дополнительный)

Таблица создается для записи выходных горизонтальных и вертикальных углов, от точки наблюдения к каждой вершине линии горизонта.

Table
Имя выходной диаграммы
(Дополнительный)

Этот параметр не поддерживается.

Graph
Изображение выходной диаграммы
(Дополнительный)

Изображение полярной диаграммы, показывающей радиальный вид видимой линии горизонта. Изображение может быть в формате PNG, JPG, JPEG или SVG.

File

Производные выходные данные

ПодписьОписаниеТип данных
Коэффициент видимости

Средний процент видимого небосвода для всех наблюдателей. Значение выражено в диапазоне от 0 до 1, например 0.8 представляет 80% видимости горизонта.

Double

arcpy.ddd.SkylineGraph(in_observer_point_features, in_line_features, {base_visibility_angle}, {additional_fields}, {out_angles_table}, {out_graph}, {out_image_file})
ИмяОписаниеТип данных
in_observer_point_features

Входной класс объектов, содержащий одну или несколько точек наблюдения.

Feature Layer
in_line_features

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

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

Вертикальный угол от базовой линии, который используется для вычисления процента видимости неба. Горизонтальному направлению соответствует 0, направлению вертикально вверх – 90, вертикально вниз – -90. По умолчанию - 0.

Double
additional_fields
(Дополнительный)

Показывает, будут ли дополнительные поля добавлены к таблице углов.

  • NO_ADDITIONAL_FIELDSДополнительные поля не добавляются. Это значение по умолчанию
  • ADDITIONAL_FIELDSДополнительные поля будут добавлены.
Boolean
out_angles_table
(Дополнительный)

Таблица создается для записи выходных горизонтальных и вертикальных углов, от точки наблюдения к каждой вершине линии горизонта.

Table
out_graph
(Дополнительный)

Этот параметр не поддерживается.

Graph
out_image_file
(Дополнительный)

Изображение полярной диаграммы, показывающей радиальный вид видимой линии горизонта. Изображение может быть в формате PNG, JPG, JPEG или SVG.

File

Производные выходные данные

ИмяОписаниеТип данных
out_visibility_ratio

Средний процент видимого небосвода для всех наблюдателей. Значение выражено в диапазоне от 0 до 1, например 0.8 представляет 80% видимости горизонта.

Double

Пример кода

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.SkylineGraph("observers.shp", "skyline_outline.shp", 0, 
                      "ADDITIONAL_FIELDS", "table.dbf")
SkylineGraph, пример 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"
inLines = "skyline_outline.shp"
baseVisibility = 25

# Ensure output table has unique name
outTable = arcpy.CreateUniqueName("angles_table.dbf")

#Execute SkylineGraph
arcpy.ddd.SkylineGraph(inPts, inLines, 0, "ADDITIONAL_FIELDS", outTable)

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