テレインにフィーチャクラスを追加 (Add Feature Class To Terrain) (3D Analyst)

概要

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

使用法

  • 入力フィーチャは、テレイン データセットと同じフィーチャ データセットに置く必要があります。

  • テレイン データセットでは、1 つ以上のピラミッド レベルが定義済みである必要があります。

  • テレインに追加されるフィーチャに関連付けられているサーフェス タイプによっては、[テレインの構築 (Build Terrain)] を使用してテレイン データセットを再構築する必要がある場合があります。データセットの再構築が必要かどうかは、ArcCatalog のテレイン データセットの [プロパティ] ダイアログ ボックスと、ArcMap 内のテレイン レイヤーの [プロパティ] ダイアログ ボックスの両方に表示されます。

  • フィーチャに単純化されたジオメトリが含まれ、予想される表示縮尺で視覚的に関連している場合のみ、ブレークラインとポリゴンのサーフェス フィーチャ タイプの概観図オプションを有効化することを検討します。たとえば、ブレークラインは概観図表示では十分見やすいとは言えないが、クリップ ポリゴンを使うと見やすいという場合です。境界フィーチャが詳細な場合は頂点を間引きして、より低解像度の表示を概観図に使用します。詳細なフィーチャは、詳細な解像度により適した表示縮尺で使用してください。

  • エンタープライズ ジオデータベースに格納されるテレイン データセットの場合:

    • 対象のテレインをバージョン対応登録することはできません。
    • 入力フィーチャクラスをバージョン対応登録することはできません。

構文

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テレインに追加されるフィーチャクラスの名前。
  • Height Fieldフィーチャの高さ情報を含むフィールド。任意の数値フィールドを指定できます。また、Z 対応のフィーチャでは、ジオメトリ フィールドを選択することもできます。<none> オプションが選択されている場合、Z 値はサーフェスから内挿されます。
  • Typeフィーチャのテレインでの使用方法を定義するサーフェス フィーチャ タイプ。標高点は、Z 計測値を提供するフィーチャを表します。ブレークラインは既知の Z 計測値を持つライン フィーチャと、いくつかのポリゴン タイプを表します。ブレークラインおよびポリゴンベースのフィーチャ タイプには、ラスターへのエクスポート時におけるフィーチャのエッジ周辺での内挿時の動作を定義するハードおよびソフト修飾子も存在します。ソフト フィーチャは緩慢な勾配変化を表しますが、ハード フィーチャは鮮明な区切りを表します。
  • Group使用されている各フィーチャのグループを定義します。同じ地理フィーチャを表すブレークラインおよびポリゴン サーフェス フィーチャが異なる詳細レベルにおいて指定されていない場合は、特定の縮尺範囲での表示を目的としています。同じ数値を割り当てることで、同じ地理フィーチャを異なる詳細レベルで表すデータをグループ化できます。たとえば、2 つの境界フィーチャに高い詳細レベルと低い詳細レベルを指定して同じグループに割り当てることで、関連付けられている表示縮尺範囲において重複がなくなります。
  • Min/Max Resolutionテレイン内でフィーチャに適用されているピラミッド解像度の範囲を定義します。標高点には、値の最小の範囲と最大の範囲を使用する必要があります。
  • Overviewフィーチャにテレイン データセットの最も解像度の低い表現を適用するかどうかを指定します。表示パフォーマンスを最大にするには、概観図で表示されるフィーチャクラスに単純化したジオメトリを含めるようにします。標高点以外のフィーチャ タイプにのみ有効です。
  • Embedこのオプションを TRUE に設定すると、ソース フィーチャはテレインが参照し、テレインのみが使用できる非公開のフィーチャクラスにコピーされます。埋め込みフィーチャは直接表示できません。テレイン ツールを通じてのみアクセスできます。マルチポイント フィーチャにのみ有効です。
  • Embed Name埋め込みフィーチャクラスの名前。フィーチャが埋め込まれている場合にのみ適用されます。
  • Embed Fields埋め込みフィーチャクラス内で BLOB フィールド属性を維持するように指定します。これらの属性はテレインのシンボル表示に使用できます。LAS 属性は、[LAS → マルチポイント (LAS to Multipoint)] ツールを通じて、マルチポイント フィーチャの BLOB フィールドに格納できます。
  • Anchorポイント フィーチャクラスが、すべてのテレイン ピラミッド レベルを通じて固定されるかどうかを指定します。アンカー位置は、テレイン サーフェスで保持されるために、フィルター処理および間引きの対象外です。このオプションはシングルポイント フィーチャクラスにのみ適用されます。
Value Table

派生した出力

名前説明データ タイプ
derived_out_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

関連トピック