Профиль стека (Инструменты 3D Analyst)

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

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

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

Каждая входная линия заполняется для интерполяции высоты вдоль перекрывающих ее линий профиля. Высота и расстояние вдоль входных линий, созданных этим уплотнением, сохраняются в выходной таблице вместе с дополнительной информацией о линейных объектах и целях профиля.
В ArcGIS Pro 3.7 выходная таблица была изменена для поддержки создания специализированной линейной диаграммы (диаграмма-график), изображающей профиль. В настоящий момент эту линейную диаграмму можно создать только с помощью этого инструмента. В таблице содержатся следующие поля, которые используются для создания линейной диаграммы:
- DISTANCE—Расстояние от начала профилируемой позиции.
- Z—Высота вершины.
- LINE_ID—Уникальный ID линейного объекта, использующегося для определения профиля.
- SRC_NAME—Имя источника высоты.
- LINE_TARG—Идентификатор для группировки данных в диаграмме.
Выходная таблица прежнего формата также может быть сгенерирована для создания таблицы старых форматов. Хотя эта таблица не может быть использована для создания линейной диаграммы в ArcGIS Pro, она поддерживает рабочие процессы, разработанные вокруг её схемы. Таблица прежнего формата содержит следующие поля:
- FIRST_DIST—Расстояние до первой вершины в сегменте профиля.
- FIRST_Z—Высота первой вершины в сегменте профиля.
- SEC_DIST—Расстояние до второй вершины в сегменте профиля.
- SEC_Z—Высота второй вершины в сегменте профиля.
- LINE_ID—Уникальный ID линейного объекта, использующегося для определения профиля.
- SRC_TYPE—Тип данных источника профиля, это может быть поверхность или мультипатч.
- SRC_ID—Уникальный ID объекта-мультипатча, для которого создается профиль. Не подходит для входных данных в виде поверхности.
- SRC_NAME—Имя и путь к источнику профиля.
Диаграмму профиля можно создать, указав имя выходной диаграммы. Эта диаграмма будет отображаться под таблицей в панели Содержание при загрузке таблицы в карту или сцену, но не будет создана, если генерируется более 100 линейных серий.
При профилировании объекта-мультипатча каждый профильный сегмент имеет строку с позицией вершины на каждом конце сегмента и другую строку с Z-значением NULL, указывающим на наличие зазора между сегментами.

Подпись	Объяснение	Тип данных
Входные линейные объекты	Линейные объекты, для которых будет создан профиль над входными поверхностями.	Feature Layer
Цели профиля	Данные, для которых строится профиль, которые могут состоять из любой комбинации объектов-мультипатчей, растровых данных и наборов данных TIN.	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Выходная таблица	Выходная таблица, которая будет содержать высоту, интерполированную для каждой цели профиля, пересекающей входную линию.	Table
Имя выходной диаграммы (Дополнительный)	Имя выходной линейной диаграммы, которая будет создана. Для создания диаграммы необходимо указать имя.	Graph
Зернистость мультипатча (Дополнительный)	Указывает, как на выходной диаграмме будут определены линейные серии, представляющие объекты мультипатча. Этот параметр доступен только при условии, что как минимум один класс объектов мультипатчей представлен в качестве профиля. Feature Class–All the features in a multipatch feature class will be represented by one line series. This reduces the number of line series created in the chart and is a suitable option when one symbol is acceptable for all features. This is the default. Feature–Each feature in a given feature class will be represented by a unique line series. This provides the flexibility of symbolizing each feature with a different color in the output chart.	String
Выходная таблица прежнего формата (Дополнительный)	Дополнительная таблица, предоставляющая профильную информацию о высоте с полями, использовавшимися до ArcGIS Pro 3.7.	Table

arcpy.3d.StackProfile(in_line_features, profile_targets, out_table, {out_graph}, {multipatch_granularity}, {out_legacy_table})

Имя	Объяснение	Тип данных
in_line_features	Линейные объекты, для которых будет создан профиль над входными поверхностями.	Feature Layer
profile_targets [profile_targets,...]	Данные, для которых строится профиль, которые могут состоять из любой комбинации объектов-мультипатчей, растровых данных и наборов данных TIN.	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_table	Выходная таблица, которая будет содержать высоту, интерполированную для каждой цели профиля, пересекающей входную линию.	Table
out_graph (Дополнительный)	Имя выходной линейной диаграммы, которая будет создана. Для создания диаграммы необходимо указать имя.	Graph
multipatch_granularity (Дополнительный)	Указывает, как на выходной диаграмме будут определены линейные серии, представляющие объекты мультипатча. Этот параметр доступен только при условии, что как минимум один класс объектов мультипатчей представлен в качестве профиля. `FEATURE_CLASS`–All the features in a multipatch feature class will be represented by one line series. This reduces the number of line series created in the chart and is a suitable option when one symbol is acceptable for all features. This is the default. `FEATURE`–Each feature in a given feature class will be represented by a unique line series. This provides the flexibility of symbolizing each feature with a different color in the output chart.	String
out_legacy_table (Дополнительный)	Дополнительная таблица, предоставляющая профильную информацию о высоте с полями, использовавшимися до ArcGIS Pro 3.7.	Table

Пример кода

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

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.StackProfile('profile_line.shp', profile_targets=['dem.tif', 'buildings.shp'],
                      out_table='profile_values.dbf')

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

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

'''**********************************************************************
Name: Save Profiles to Graph Files
Description: Creates profile graphs of multipatch and surface features,
             which are then saved as graph files.
**********************************************************************'''
# Import system modules
import arcpy

# Set Local Variables
profileLine = arcpy.GetParameterAsText(0)
profileTargets = arcpy.GetParameterAsText(1) # input las files
profileTable = arcpy.CreateUniqueName('profile_table', 'in_memory')
graphName = "Sample Graph"
outGraph = arcpy.GetParameterAsText(2) # output graph file

# Run StackProfile
arcpy.ddd.StackProfile(profileLine, profileTargets, profileTable, graphName)

# Run SaveGraph
arcpy.management.SaveGraph(graphName, outGraph)

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

Текущая рабочая область, Экстент

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