Сводка
Добавляет один или более класс объектов к набору данных terrain.
Использование
Входные объекты должны постоянно храниться в том же наборе классов объектов, что и набор данных terrain.
Набор данных terrain должен уже иметь один или несколько пирамидных слоев.
В зависимости от типа поверхности, связанного с объектами, добавляемыми в набор данных Terrain, может потребоваться перестроение этого набора данных с помощью инструмента Построить Terrain. Необходимость перестроения набора данных terrain можно увидеть в диалоговом окне Свойства dialog box in ArcCatalog набора данных terrain в ArcCatalog и в диалоговом окне Свойства слоя terrain в ArcMap.
Рассмотрите возможность включения опции обзора для типов объектов линии перегиба и полигональная поверхность только в том случае, если объекты содержат упрощенную геометрию и имеют приблизительное визуальное соответствие масштабу изображения. Например, линии перегиба могут быть невидимыми для отображения в окне обзора, и пригодится вырезающий полигон. Если объект-граница детализирован, рассмотрите возможность его генерализации и используйте упрощенное представление для обзорного изображения. Детализированная версия будет использоваться при масштабах, более подходящих для данного разрешения.
For terrain datasets stored in an enterprise geodatabase:
- Целевой набор данных Terrain не может быть зарегистрирован как версионный.
- Входной класс объектов также не должен быть версионным.
Синтаксис
arcpy.3d.AddFeatureClassToTerrain(in_terrain, in_features)
Parameter | Объяснение | Тип данных |
in_terrain | Набор данных Terrain, к которому будет добавлен класс объектов. Набор данных Terrain должен иметь один или несколько пирамидных слоев. | Terrain Layer |
in_features [[in_features, height_field, SF_type, group, min_resolution, max_resolution, overview, embed, embed_name, embed_fields, anchor],...] | Определяет объекты, добавляемые в terrain. Каждый объект должен быть расположен в том же наборе классов объектов, что и набор данных terrain, а также должен иметь роль, заданную с помощью следующих свойств:
| Value Table |
Производные выходные данные
Name | Объяснение | Тип данных |
derived_out_terrain | Обновленная terrain. | Слой Terrain |
Пример кода
В следующем примере показано использование этого инструмента в окне Python.
arcpy.env.workspace = "C:/data"
terrain_data = ["terrain.gdb/terrainFDS/points2", "SHAPE", "masspoints", 2, 0,
10, "true", "false", "points_embed", "<None>", "false"]
arcpy.AddFeatureClassToTerrain_3d("test.gdb/featuredataset/terrain", terrain_data)
В следующем примере показано использование этого инструмента в автономном скрипте Python.
"""****************************************************************************
Name: Create Terrain from TIN
Description: This script demonstrates how to create a terrain dataset using
features extracted from a TIN. It is particularly useful in
situations where the source data used in the TIN is not available,
and the amount of data stored in the TIN proves to be too large
for the TIN. The terrain's scalability will allow improved
display performance and faster analysis. The script is designed
to work as a script tool with 5 input arguments.
****************************************************************************"""
# Import system modules
import arcpy
# Set local variables
tin = arcpy.GetParameterAsText(0) # TIN used to create terrain
gdbLocation = arcpy.GetParameterAsText(1) # Folder that will store terran GDB
gdbName = arcpy.GetParameterAsText(2) # Name of terrain GDB
fdName = arcpy.GetParameterAsText(3) # Name of feature dataset
terrainName = arcpy.GetParameterAsText(4) # Name of terrain
try:
# Create the file gdb that will store the feature dataset
arcpy.management.CreateFileGDB(gdbLocation, gdbName)
gdb = '{0}/{1}'.format(gdbLocation, gdbName)
# Obtain spatial reference from TIN
SR = arcpy.Describe(tin).spatialReference
# Create the feature dataset that will store the terrain
arcpy.management.CreateFeatureDataset(gdb, fdName, SR)
fd = '{0}/{1}'.format(gdb, fdName)
# Export TIN elements to feature classes for terrain
arcpy.AddMessage("Exporting TIN footprint to define terrain boundary...")
boundary = "{0}/boundary".format(fd)
# Execute TinDomain
arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
arcpy.AddMessage("Exporting TIN breaklines...")
breaklines = "{0}/breaklines".format(fd)
# Execute TinLine
arcpy.ddd.TinLine(tin, breaklines, "Code")
arcpy.AddMessage("Exporting TIN nodes...")
masspoints = "{0}/masspoints".format(fd)
# Execute TinNode
arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
arcpy.AddMessage("Creating terrain dataset...")
terrain = "terrain_from_tin"
# Execute CreateTerrain
arcpy.ddd.CreateTerrain(fd, terrainName, 10, 50000, "",
"WINDOWSIZE", "ZMEAN", "NONE", 1)
arcpy.AddMessage("Adding terrain pyramid levels...")
terrain = "{0}/{1}".format(fd, terrainName)
pyramids = ["20 5000", "25 10000", "35 25000", "50 50000"]
# Execute AddTerrainPyramidLevel
arcpy.ddd.AddTerrainPyramidLevel(terrain, "", pyramids)
arcpy.AddMessage("Adding features to terrain...")
inFeatures = "{0} Shape softclip 1 0 10 true false boundary_embed <None> "\
"false; {1} Shape masspoints 1 0 50 true false points_embed "\
"<None> false; {2} Shape softline 1 0 25 false false lines_embed "\
"<None> false".format(boundary, masspoints, breaklines)
# Execute AddFeatureClassToTerrain
arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
arcpy.AddMessage("Building terrain...")
# Execute BuildTerrain
arcpy.ddd.BuildTerrain(terrain, "NO_UPDATE_EXTENT")
arcpy.GetMessages()
except arcpy.ExecuteError:
print(arcpy.GetMessages())
except Exception as err:
print(err)
Environments
Информация о лицензиях
- Basic: Требуется 3D Analyst
- Standard: Требуется 3D Analyst
- Advanced: Требуется 3D Analyst