Добавить класс объектов в Terrain (Инструменты 3D Analyst)

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

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

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

Входные объекты должны находиться в том же наборе данных объектов, что и набор данных terrain.
Набор данных terrain уже должен иметь один или несколько пирамидных слоев.
В зависимости от типа поверхности, связанного с объектами, добавляемыми в набор данных Terrain, может потребоваться перестроение этого набора данных с помощью инструмента Построить Terrain. Необходимость перестроения набора данных terrain можно увидеть в диалоговом окне Свойства набора данных terrain в ArcCatalog и в диалоговом окне Свойства слоя terrain в ArcMap.
Включение опции обзора рекомендуется только для типов объектов линии перегиба и полигональная поверхность, если эти объекты содержат упрощенную геометрию и визуально соответствуют предполагаемому масштабу изображения. Например, линии перегиба могут быть недостаточно заметны для отображения в окне обзора, тогда как может использоваться вырезающий полигон. Если объект-граница детализирован, рассмотрите возможность его генерализации и используйте упрощенное представление для обзора. Детализированная версия будет использоваться в масштабах, более подходящих для данного разрешения.
Для наборов данных terrain, хранящихся в многопользовательской базе геоданных:
- Целевой набор данных terrain не может быть зарегистрирован как версионный.
- Входной класс объектов также не должен быть версионным.

Подпись	Объяснение	Тип данных
Входной Terrain	Набор данных terrain, к которому будет добавлен класс объектов. Набор данных terrain должен иметь один или несколько пирамидных слоев.	Terrain Layer
Входной класс объектов	Определяет объекты, добавляемые в Terrain. Каждый объект должен находиться в том же наборе классов объектов, что и набор данных Terrain, а также должен иметь роль, заданную с помощью следующих свойств: Столбцы таблицы значений: Input Features–Name of the feature class being added to the terrain. Height Field–Field containing the feature's height information. Type–The way the input future contributes to the terrain surface. Mass Points–Points that are used for triangulation. Hard Line–Linear features that represent sharp discontinuities in elevation. Soft Line–Linear features that represent a gradual discontinuity in elevation. Hard Clip–Polygon feature that defines the interpolation zone with sharp discontinuities at the edges. Soft Clip–Polygon feature that defines the interpolation zone with gradual discontinuities at the edges. Hard Erase–Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. Soft Erase–Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. Hard Replace–Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. Soft Replace–Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. Hard Value Fill–Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. Soft Value Fill–Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. Group–Defines the group of each contributing feature. Min Resolution–The lowest resolution that the surface feature will be enforced. Max Resolution–The highest resolution that the surface feature will be enforced. Overview–Indicates whether the feature is enforced at the coarsest representation of the terrain dataset. Embed–Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain. Embed Name–Name of the embedded feature class. Embed Fields–Specifies Blob field attributes to be retained in the embedded feature class. Anchor–Specifies whether the point feature class will be anchored through all terrain pyramid levels.	Value Table

Подпись

Объяснение

Тип данных

Входной Terrain

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

Terrain Layer

Входной класс объектов

Определяет объекты, добавляемые в Terrain. Каждый объект должен находиться в том же наборе классов объектов, что и набор данных Terrain, а также должен иметь роль, заданную с помощью следующих свойств:

Столбцы таблицы значений:

Input Features–Name of the feature class being added to the terrain.
Height Field–Field containing the feature's height information.
Type–The way the input future contributes to the terrain surface.
- Mass Points–Points that are used for triangulation.
- Hard Line–Linear features that represent sharp discontinuities in elevation.
- Soft Line–Linear features that represent a gradual discontinuity in elevation.
- Hard Clip–Polygon feature that defines the interpolation zone with sharp discontinuities at the edges.
- Soft Clip–Polygon feature that defines the interpolation zone with gradual discontinuities at the edges.
- Hard Erase–Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft Erase–Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hard Replace–Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft Replace–Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hard Value Fill–Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft Value Fill–Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
Group–Defines the group of each contributing feature.
Min Resolution–The lowest resolution that the surface feature will be enforced.
Max Resolution–The highest resolution that the surface feature will be enforced.
Overview–Indicates whether the feature is enforced at the coarsest representation of the terrain dataset.
Embed–Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain.
Embed Name–Name of the embedded feature class.
Embed Fields–Specifies Blob field attributes to be retained in the embedded feature class.
Anchor–Specifies whether the point feature class will be anchored through all terrain pyramid levels.

Value Table

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

Подпись	Объяснение	Тип данных
Обновленная входная Terrain	Обновленная terrain.	Terrain Layer

arcpy.3d.AddFeatureClassToTerrain(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`–Name of the feature class being added to the terrain. `Height Field`–Field containing the feature's height information. `Type`–The way the input future contributes to the terrain surface. `Mass_Points`–Points that are used for triangulation. `Hard_Line`–Linear features that represent sharp discontinuities in elevation. `Soft_Line`–Linear features that represent a gradual discontinuity in elevation. `Hard_Clip`–Polygon feature that defines the interpolation zone with sharp discontinuities at the edges. `Soft_Clip`–Polygon feature that defines the interpolation zone with gradual discontinuities at the edges. `Hard_Erase`–Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. `Soft_Erase`–Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. `Hard_Replace`–Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. `Soft_Replace`–Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. `Hardvalue_Fill`–Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity. `Softvalue_Fill`–Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity. `Group`–Defines the group of each contributing feature. `Min Resolution`–The lowest resolution that the surface feature will be enforced. `Max Resolution`–The highest resolution that the surface feature will be enforced. `Overview`–Indicates whether the feature is enforced at the coarsest representation of the terrain dataset. `Embed`–Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain. `Embed Name`–Name of the embedded feature class. `Embed Fields`–Specifies Blob field attributes to be retained in the embedded feature class. `Anchor`–Specifies whether the point feature class will be anchored through all terrain pyramid levels.	Value Table

in_terrain

Terrain Layer

in_features [[in_features, height_field, SF_type, group, min_resolution, max_resolution, overview, embed, embed_name, embed_fields, anchor],...]

Столбцы таблицы значений:

Input Features–Name of the feature class being added to the terrain.
Height Field–Field containing the feature's height information.
Type–The way the input future contributes to the terrain surface.
- Mass_Points–Points that are used for triangulation.
- Hard_Line–Linear features that represent sharp discontinuities in elevation.
- Soft_Line–Linear features that represent a gradual discontinuity in elevation.
- Hard_Clip–Polygon feature that defines the interpolation zone with sharp discontinuities at the edges.
- Soft_Clip–Polygon feature that defines the interpolation zone with gradual discontinuities at the edges.
- Hard_Erase–Polygon feature that defines the area to be treated as having no data. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft_Erase–Polygon feature that defines the area to be treated as having no data. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hard_Replace–Polygon feature that defines a constant z-value for all mass points within the boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Soft_Replace–Polygon feature that defines a constant z-value for all mass points within the boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
- Hardvalue_Fill–Polygon feature that defines a constant z-value within its boundary. The hard designation indicates the boundary of the polygon represents a sharp discontinuity.
- Softvalue_Fill–Polygon feature that defines a constant z-value within its boundary. The soft designation indicates the boundary of the polygon represents a gradual discontinuity.
Group–Defines the group of each contributing feature.
Min Resolution–The lowest resolution that the surface feature will be enforced.
Max Resolution–The highest resolution that the surface feature will be enforced.
Overview–Indicates whether the feature is enforced at the coarsest representation of the terrain dataset.
Embed–Checking this option indicates the source features will be copied to a hidden feature class that will be referenced by and only available to the terrain.
Embed Name–Name of the embedded feature class.
Embed Fields–Specifies Blob field attributes to be retained in the embedded feature class.
Anchor–Specifies whether the point feature class will be anchored through all terrain pyramid levels.

Value Table

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

Имя	Объяснение	Тип данных
derived_out_terrain	Обновленная terrain.	Terrain Layer

Пример кода

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.ddd.AddFeatureClassToTerrain("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)
    # Run TinDomain
    arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
    arcpy.AddMessage("Exporting TIN breaklines...")
    breaklines = "{0}/breaklines".format(fd)
    # Run TinLine
    arcpy.ddd.TinLine(tin, breaklines, "Code")
    arcpy.AddMessage("Exporting TIN nodes...")
    masspoints = "{0}/masspoints".format(fd)
    # Run TinNode
    arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
    arcpy.AddMessage("Creating terrain dataset...")
    terrain = "terrain_from_tin"
    # Run 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"]
    # Run 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)
    # Run AddFeatureClassToTerrain
    arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
    arcpy.AddMessage("Building terrain...")
    # Run 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

Добавить класс объектов в Terrain (Инструменты 3D Analyst)

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

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

Параметры

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

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

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

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