Добавить класс объектов в Terrain (3D Analyst)

Уровень лицензии:BasicStandardAdvanced

Резюме

Добавляет один или более класс объектов к набору данных terrain.

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

Синтаксис

AddFeatureClassToTerrain_3d (in_terrain, in_features)
ПараметрОбъяснениеТип данных
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, а также должен иметь роль, заданную с помощью следующих свойств:

  • Входные объектыИмя класса пространственных объектов, добавляемого в terrain.
  • Поле высотПоле, содержащее информацию о высотах объектов. Можно указать любое числовое поле, для Z-объектов также можно выбрать поле геометрии. Если выбрана опция <none>, Z-значения интерполируются на основе поверхности.
  • SF TypeТип объекта поверхности, который определяет, как объекты участвует в наборе данных terrain. Облака точек обозначают объекты, которые используют Z-измерения; линии перегиба обозначают линейные объекты с известными Z-измерениями и несколькими типами полигонов. Линии перегиба и типы объектов, основанные на полигонах, также имеют мягкие и жесткие квалификаторы, задающее поведение во время интерполяции ребер объектов при экспорте в растр. Мягкие объекты демонстрируют постепенные изменения уклона, жесткие – резкие изменения формы поверхности.
  • ГруппаЗадает группу каждого объекта. Линии перегиба и полигональные объекты поверхности, представляющие одни и те же географические объекты на различных уровнях детализации будут отображаться в конкретных диапазонах масштабов. Данные, отображающие одни и те же географические объекты при разных уровнях детализации, можно сгруппировать, присвоив им одинаковое числовое значение. Например, включение двух граничных объектов с высоким и низким уровнями детализации в одну группу помогает избежать их пересечения при отображении с соответствующими масштабами.
  • Минимальное/Максимальное разрешениеЗадает диапазон разрешений пирамидного слоя, при которых объект принудительно включается в terrain. Облака точек должны использовать наименьший и наибольший диапазоны значений.
  • ОбзорОбозначает, будет ли класс объектов участвовать в наиболее грубом отображении набора данных terrain. Для повышения производительности убедитесь, что классы объектов в окне обзора содержат упрощенную геометрию. Действует для всех типов объектов, кроме облаков точек.
  • ВстроитьОпция TRUE означает, что исходные объекты будут скопированы в скрытый класс объектов, доступный только для terrain, который ссылается на него. Встроенные объекты не отображаются, доступ к ним возможен только через инструменты работы с terrain. Действительно только для мультиточечных объектов.
  • Встроенное имяИмя встроенного класса пространственных объектов. Применяется только к встроенным объектам.
  • Встроенные поляЗадает атрибуты поля Blob для хранения во встроенном классе пространственных объектов. Эти атрибуты могут использоваться для присвоения символов в terrain. Атрибуты LAS можно сохранить в полях Blob мультиточечных объектов с помощью инструмента LAS в Мультиточки.
  • ЯкорьОпределяет, будет ли класс точечных пространственных объектов присутствовать во всех уровнях пирамидных слоев terrain. Точки якоря никогда не фильтруются и не прореживаются, чтобы сохранить их в поверхности типа Terrain. Эта опция применима только к отдельным классам точечных объектов.
Value Table

Пример кода

Пример AddFeatureClassToTerrain 1 (окно Python)

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

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
params = "terrain.gdb/terrainFDS/points2 SHAPE masspoints 2 0 10 true false "\
       "points_embed <None> false"
arcpy.AddFeatureClassToTerrain_3d("test.gdb/featuredataset/terrain", params)
Пример AddFeatureClassToTerrain 2 (автономный скрипт)

В следующем примере показано использование этого инструмента в автономном скрипте 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
import exceptions, sys, traceback
from arcpy import env

# 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:
    arcpy.CheckOutExtension("3D")
    # 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:
    # 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)
finally:
    arcpy.CheckInExtension("3D")

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

Связанные темы

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

ArcGIS for Desktop Basic: Требует 3D Analyst
ArcGIS for Desktop Standard: Требует 3D Analyst
ArcGIS for Desktop Advanced: Требует 3D Analyst
9/10/2013