Краткая информация
Создает таблицу и дополнительную диаграмму, показывающую профиль линейных объектов над одной или несколькими поверхностями мультипатча, растра, TIN или terrain.
Иллюстрация
Использование
Если вводится параметр Имя выходной диаграммы (Output Graph Name) и инструмент запускается в ArcMap, ArcScene или ArcGlobe, на экран будет выведена полученная диаграмма.
Выходная таблица предоставляет информацию, необходимую для построения диаграммы профиля. Каждый линейный объект уплотнен вдоль перекрывающихся целей профиля таким образом, чтобы собрать характеристики профиля, вставляя новые вершины вдоль линии. Высота и расстояние вдоль входных линий, созданных этим уплотнением, сохраняются в выходной таблице вместе с дополнительной информацией о линейных объектах и целях профиля. Значения из полей этой таблицы могут использоваться для создания диаграмм в большом количестве внешних приложений. Поля представляют:
- FIRST_DIST – Расстояние до первой вершины в сегменте профиля.
- FIRST_Z – Высота первой вершины в сегменте профиля.
- SEC_DIST – Расстояние до второй вершины в сегменте профиля.
- SEC_Z – Высота второй вершины в сегменте профиля.
- LINE_ID – Уникальный ID линейного объекта, использующегося для определения профиля.
- SRC_TYPE – Тип данных источника профиля, это может быть поверхность или мультипатч.
- SRC_ID – Уникальный ID объекта-мультипатча, для которого создается профиль. Не подходит для входных данных в виде поверхности.
- SRC_NAME – Имя и путь к источнику профиля.
Синтаксис
StackProfile_3d (in_line_features, profile_targets, out_table, {out_graph})
Параметр | Объяснение | Тип данных |
in_line_features | Линейные объекты, для которых будет создан профиль над входными поверхностями. | Feature Layer |
profile_targets [profile_targets,...] | Данные, для которых строится профиль, которые могут состоять из любой комбинации объектов-мультипатчей и моделей поверхности, такие как наборы растровых данных, наборов данных TIN, terrain и LAS. | Feature Layer; LAS Dataset Layer; Raster Layer; Terrain Layer; TIN Layer |
out_table | Выходная таблица, в которой будут храниться интерполированные измерения для каждого профиля. | Table |
out_graph (Дополнительный) | Имя выходной диаграммы, которую можно просматривать в ArcMap, ArcScene или ArcGlobe. | Graph |
Пример кода
StackProfile, пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.StackProfile_3d('profile_line.shp', 'dem.tif; buildings.shp',
'profile_values.dbf', 'Surface Profile')
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
import exceptions, sys, traceback
# 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
try:
arcpy.CheckOutExtension('3D')
# Execute StackProfile
arcpy.ddd.StackProfile(profileLine, profileTargets, profileTable, graphName)
# Execute SaveGraph
arcpy.management.SaveGraph(graphName, outGraph)
arcpy.CheckInExtension('3D')
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует 3D Analyst
- ArcGIS Desktop Standard: Требует 3D Analyst
- ArcGIS Desktop Advanced: Требует 3D Analyst