スタック断面図（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,...] |
断面図が作成されるデータ。このデータは、マルチパッチ フィーチャと、ラスタ データセット、TIN データセット、テレイン データセット、LAS データセットなどのサーフェス モデルの任意の組み合わせで構成できます。 | Feature Layer; LAS Dataset Layer; Raster Layer; Terrain Layer; TIN Layer |
out_table |
各断面図の内挿された計測値が格納される出力テーブル。 | Table |
out_graph (オプション) |
ArcMap、ArcScene、または ArcGlobe に表示できる出力グラフの名前。 | 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)