ArcMap

Добавить класс объектов к Terrain

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

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

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

  • Входные объекты должны постоянно храниться в том же наборе классов объектов, что и набор данных terrain.

  • Набор данных terrain должен уже иметь один или несколько пирамидных слоев.

  • В зависимости от типа поверхности, связанного с объектами, добавляемыми в набор данных Terrain, может потребоваться перестроение этого набора данных с помощью инструмента Построить Terrain. Необходимость перестроения набора данных terrain можно увидеть в диалоговом окне Свойства dialog box in ArcCatalog набора данных terrain в ArcCatalog и в диалоговом окне Свойства слоя terrain в ArcMap.

  • Рассмотрите возможность включения опции обзора для типов объектов линии перегиба и полигональная поверхность только в том случае, если объекты содержат упрощенную геометрию и имеют приблизительное визуальное соответствие масштабу изображения. Например, линии перегиба могут быть невидимыми для отображения в окне обзора, и пригодится вырезающий полигон. Если объект-граница детализирован, рассмотрите возможность его генерализации и используйте упрощенное представление для обзорного изображения. Детализированная версия будет использоваться при масштабах, более подходящих для данного разрешения.

  • Для наборов данных Terrain, хранимых в SDE:

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

  • Input Features —Имя класса пространственных объектов, добавляемого в terrain.
  • Height Field —Поле, содержащее информацию о высотах объектов. Можно указать любое числовое поле, для Z-объектов также можно выбрать поле геометрии. Если выбрана опция <none>, Z-значения интерполируются на основе поверхности.
  • SF 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

Пример кода

Пример 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 Desktop Basic: Требует 3D Analyst
  • ArcGIS Desktop Standard: Требует 3D Analyst
  • ArcGIS Desktop Advanced: Требует 3D Analyst

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