向 Terrain 添加要素类 (3D Analyst 工具)

汇总

向 terrain 数据集添加一个或多个要素类。

用法

输入要素必须与 Terrain 数据集位于同一要素数据集中。
Terrain 数据集必须已定义一个或多个金字塔等级。
根据 terrain 中添加的与要素关联的表面类型，可能需要使用 构建 Terrain 重新构建 terrain 数据集。 ArcCatalog 中 terrain 数据集的属性对话框和 ArcMap 中 terrain 图层的属性对话框均提供了是否需要重新构建数据集的指示。
仅当要素包含简化几何且针对预期显示比例具有视觉相关性时，才考虑启用隔断线和面表面要素类型的概览选项。例如，在概览显示中，隔断线可能不够明显以至于无关紧要，而裁剪面则很有用。如果存在详细边界要素，请考虑对其进行概化，并在概览中使用较粗略的制图表达。应在更适合细节分辨率的显示比例下使用详细版本。
对于在企业级地理数据库中存储的 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。 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

派生输出

名称	说明	数据类型
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)

环境

当前工作空间, 自动提交

许可信息

基本: 需要 3D Analyst
标准: 需要 3D Analyst
高级: 需要 3D Analyst

向 Terrain 添加要素类 (3D Analyst 工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题