テレインにフィーチャクラスを追加 (3D Analyst ツール)

サマリー

テレインデータセットに 1 つ以上のフィーチャクラスを追加します。

使用法

入力フィーチャはテレインデータセットと同じフィーチャデータセット内にある必要があります。
テレインデータセットでは、1 つ以上のピラミッドレベルが定義済みである必要があります。
テレインに追加されるフィーチャに関連するサーフェスタイプによっては、テレインの構築 を使用してテレインデータセットを再構築する必要がある場合があります。 ArcCatalog のテレインデータセットの プロパティ ダイアログボックスと、ArcMap のテレインレイヤーの プロパティ ダイアログボックスは、どちらもデータセットを再構築する必要があるかどうかを示します。
ブレークラインおよびポリゴンサーフェスフィーチャタイプのオーバービューオプションを有効にすることは、フィーチャが単純化されたジオメトリーを含み、想定される表示縮尺で視覚的に関連性がある場合にのみ検討してください。たとえば、ブレークラインはオーバービュー表示では重要といえるほど十分に表示されない可能性がありますが、クリップポリゴンは便利です。境界フィーチャが詳細な場合はそれを一般化し、より低解像度の表示をオーバービューに使用することを検討してください。詳細なバージョンは、その詳細度に適した表示縮尺で使用してください。
エンタープライズジオデータベースに格納されているテレインデータセットの場合:
- ターゲットテレインをバージョン対応登録できません。
- 入力フィーチャクラスをバージョン対応登録できません。

ラベル	説明	データタイプ
入力テレイン	フィーチャクラスの追加先となるテレイン。テレインデータセットでは、1 つ以上のピラミッドレベルが作成済みである必要があります。	Terrain Layer
入力フィーチャクラス	テレインに追加されるフィーチャを識別します。各フィーチャは、テレインと同じフィーチャデータセット内に存在し、次のプロパティを使用してそのロールが定義されている必要があります: 値テーブル列: 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

ラベル

説明

データタイプ

入力テレイン

フィーチャクラスの追加先となるテレイン。テレインデータセットでは、1 つ以上のピラミッドレベルが作成済みである必要があります。

Terrain Layer

入力フィーチャクラス

テレインに追加されるフィーチャを識別します。各フィーチャは、テレインと同じフィーチャデータセット内に存在し、次のプロパティを使用してそのロールが定義されている必要があります:

値テーブル列:

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 Layer

arcpy.3d.AddFeatureClassToTerrain(in_terrain, in_features)

名前説明データタイプ

名前	説明	データタイプ
in_terrain	フィーチャクラスの追加先となるテレイン。テレインデータセットでは、1 つ以上のピラミッドレベルが作成済みである必要があります。	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

in_terrain

フィーチャクラスの追加先となるテレイン。テレインデータセットでは、1 つ以上のピラミッドレベルが作成済みである必要があります。

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 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 が必要

テレインにフィーチャクラスを追加 (3D Analyst ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック