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

ライセンス レベル:BasicStandardAdvanced

サマリ

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

使用法

構文

AddFeatureClassToTerrain_3d (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 値はサーフェスから内挿されます。
  • SF 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

コードのサンプル

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 for Desktop Basic: 次のものが必要 3D Analyst
ArcGIS for Desktop Standard: 次のものが必要 3D Analyst
ArcGIS for Desktop Advanced: 次のものが必要 3D Analyst
9/14/2013