スタック断面図（Stack Profile） (3D Analyst)
サマリ
1 つ以上のマルチパッチ、ラスタ、TIN、またはテレイン サーフェス上にライン フィーチャの断面図を示すテーブルとオプションのグラフを作成します。
図
使用法
-
[出力グラフ名] パラメータを指定して、ArcMap、ArcScene、または ArcGlobe でツールを実行すると、作成されるグラフが画面上に表示されます。
グラフはメモリに保存されますが、[グラフの保存（Save Graph）] ツールを使用してグラフ ファイルとして保存することもできます。
断面図グラフを生成するために必要な情報は出力テーブルが提供します。各ライン フィーチャは、ラインに沿って新しい頂点を追加することによって、断面図の特性を把握できるようにできるように、重なり合う断面図ターゲットに沿って高密度化されます。この高密度化によって作成される入力ラインに沿った標高と距離は、ライン フィーチャおよび断面図ターゲットに関する追加情報とともに出力テーブルに格納されます。そのフィールドの値は、さまざまな外部アプリケーションでグラフを作成するために使用できます。これらのフィールドは、以下のとおりです。
- FIRST_DIST - 断面図セグメントの 1 つめの頂点までの距離。
- FIRST_Z - 断面図セグメントの 1 つめの頂点の高さ。
- SEC_DIST - 断面図セグメントの 2 つめの頂点までの距離。
- SEC_Z - 断面図セグメントの 2 つめの頂点の高さ。
- LINE_ID - 断面図を定義するために使用されるライン フィーチャの一意の ID。
- SRC_TYPE - 断面図のソースのデータ タイプ。これはサーフェスかマルチパッチのどちらかです。
- SRC_ID - プロファイルされるマルチパッチ フィーチャの一意の ID。サーフェス入力には適用できません。
- SRC_NAME - 断面図のソースの名前とパス。
構文
| パラメータ | 説明 | データ タイプ |
in_line_features |
サーフェス入力上に断面図が作成されるライン フィーチャ。 | Feature Layer |
profile_targets [profile_targets,...] |
プロファイルされるサーフェス モデルに適用する 1 つ以上のマルチパッチ フィーチャおよびラスタ、テレイン、または TIN データセット | Feature Layer; Raster Layer; Terrain Layer; TIN Layer |
out_table |
スタックの対象に対して入力ライン フィーチャを内挿することによって取得される値を含む出力テーブル | Table |
out_graph (オプション) |
[グラフの保存（Save Graph）] ツールを使用してディスクに保存できるオプションの出力グラフのメモリ内の名前 | Graph |
コードのサンプル
次のサンプルは、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')
次のサンプルは、スタンドアロン 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)