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

Сводка

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

  • Input FeaturesИмя класса пространственных объектов, добавляемого в terrain.
  • Height FieldПоле, содержащее информацию о высотах объектов. Можно указать любое числовое поле, для Z-объектов также можно выбрать поле геометрии. Если выбрана опция <none>, Z-значения интерполируются на основе поверхности.
  • TypeТип объекта поверхности, который определяет, как объекты участвует в наборе данных terrain. Облака точек обозначают объекты, которые используют Z-измерения; линии перегиба обозначают линейные объекты с известными Z-измерениями и несколькими типами полигонов. Линии перегиба и типы объектов, основанные на полигонах, также имеют мягкие и жесткие квалификаторы, задающее поведение во время интерполяции ребер объектов при экспорте в растр. Мягкие объекты демонстрируют постепенные изменения уклона, жесткие – резкие изменения формы поверхности.
  • GroupЗадает группу каждого объекта. Линии перегиба и полигональные объекты поверхности, представляющие одни и те же географические объекты на различных уровнях детализации будут отображаться в конкретных диапазонах масштабов. Данные, отображающие одни и те же географические объекты при разных уровнях детализации, можно сгруппировать, присвоив им одинаковое числовое значение. Например, включение двух граничных объектов с высоким и низким уровнями детализации в одну группу помогает избежать их пересечения при отображении с соответствующими масштабами.
  • Min/Max ResolutionЗадает диапазон разрешений пирамидного слоя, при которых объект принудительно включается в terrain. Облака точек должны использовать наименьший и наибольший диапазоны значений.
  • OverviewОбозначает, будет ли класс объектов участвовать в наиболее грубом отображении набора данных terrain. Для повышения производительности убедитесь, что классы объектов в окне обзора содержат упрощенную геометрию. Действует для всех типов объектов, кроме облаков точек.
  • EmbedОпция TRUE означает, что исходные объекты будут скопированы в скрытый класс объектов, доступный только для terrain, который ссылается на него. Встроенные объекты не отображаются, доступ к ним возможен только через инструменты работы с terrain. Действительно только для мультиточечных объектов.
  • Embed NameИмя встроенного класса пространственных объектов. Применяется только к встроенным объектам.
  • Embed FieldsЗадает атрибуты поля BLOB хранения во встроенном классе пространственных объектов. Эти атрибуты могут использоваться для присвоения символов в terrain. Атрибуты LAS можно сохранить в полях BLOB мультиточечных объектов с помощью инструмента LAS в Мультиточки.
  • AnchorОпределяет, будет ли класс точечных пространственных объектов присутствовать во всех уровнях пирамидных слоев terrain. Точки якоря никогда не фильтруются и не прореживаются, чтобы сохранить их в поверхности типа Terrain. Эта опция применима только к отдельным классам точечных объектов.
Value Table

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

NameОбъяснениеТип данных
derived_out_terrain

Обновленная terrain.

Слой Terrain

Пример кода

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

В следующем примере показано использование этого инструмента в окне 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)
Пример 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

# 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)

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

  • Basic: Требуется 3D Analyst
  • Standard: Требуется 3D Analyst
  • Advanced: Требуется 3D Analyst

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