スタック断面図 (Stack Profile)

サマリー

1 つ以上のマルチパッチ、ラスター、TIN、またはテレイン サーフェス上にライン フィーチャの断面図を示すテーブルとオプションのグラフを作成します。

図

使用法

• [出力グラフ名] パラメーターを指定して、ArcMap、ArcScene、または ArcGlobe でツールを実行すると、作成されるグラフが画面上に表示されます。

• 断面図グラフを生成するために必要な情報は出力テーブルが提供します。各ライン フィーチャは、ラインに沿って新しい頂点を追加することによって、断面図の特性を把握できるようにできるように、重なり合う断面図ターゲットに沿って高密度化されます。この高密度化によって作成される入力ラインに沿った標高と距離は、ライン フィーチャおよび断面図ターゲットに関する追加情報とともに出力テーブルに格納されます。そのフィールドの値は、さまざまな外部アプリケーションでグラフを作成するために使用できます。これらのフィールドは、以下のとおりです。

  • FIRST_DIST - 断面図セグメントの 1 つ目の頂点までの距離。
  • FIRST_Z - 断面図セグメントの 1 つ目の頂点の高さ。
  • SEC_DIST - 断面図セグメントの 2 つ目の頂点までの距離。
  • SEC_Z - 断面図セグメントの 2 つ目の頂点の高さ。
  • LINE_ID - 断面図を定義するために使用されるライン フィーチャの一意の ID。
  • SRC_TYPE - 断面図のソースのデータ タイプ。これはサーフェスかマルチパッチのどちらかです。
  • SRC_ID - プロファイルされるマルチパッチ フィーチャの一意の ID。サーフェス入力には適用できません。
  • SRC_NAME - 断面図のソースの名前とパス。

構文

StackProfile_3d (in_line_features, profile_targets, out_table, {out_graph})

パラメーター	説明	データ タイプ
in_line_features	サーフェス入力上に断面図が作成されるライン フィーチャ。	Feature Layer
profile_targets [profile_targets,...]	マルチパッチ フィーチャ モデル、ラスター モデル、およびトライアングル サーフェス モデルの任意の組み合わせで構成できる、断面図が作成されるデータ。	Feature Layer; LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_table	各断面図の内挿された計測値が格納される出力テーブル。	Table
out_graph (オプション)	ArcMap、ArcScene、または ArcGlobe に表示される出力グラフの名前。	Graph

コードのサンプル

StackProfile (スタック断面図) の例 1 (Python ウィンドウ)

次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.StackProfile_3d('profile_line.shp', 'dem.tif; buildings.shp', 
                     'profile_values.dbf', 'Surface Profile')

StackProfile (スタック断面図) の例 2 (スタンドアロン スクリプト)

次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。

'''**********************************************************************
Name: Save Profiles to Graph Files
Description: Creates profile graphs of multipatch and surface features, 
             which are then saved as graph files.
**********************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback

# Set Local Variables
profileLine = arcpy.GetParameterAsText(0)
profileTargets = arcpy.GetParameterAsText(1) # input las files
profileTable = arcpy.CreateUniqueName('profile_table', 'in_memory')
graphName = "Sample Graph"
outGraph = arcpy.GetParameterAsText(2) # output graph file

try:
    arcpy.CheckOutExtension('3D')
    # Execute StackProfile
    arcpy.ddd.StackProfile(profileLine, profileTargets, profileTable, graphName)
    # Execute SaveGraph
    arcpy.management.SaveGraph(graphName, outGraph)
    arcpy.CheckInExtension('3D')
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)

環境

• 現在のワークスペース
• 出力座標系
• 範囲
• 地理座標系変換

ライセンス情報

• ArcGIS Desktop Basic: 次のものが必要 3D Analyst
• ArcGIS Desktop Standard: 次のものが必要 3D Analyst
• ArcGIS Desktop Advanced: 次のものが必要 3D Analyst