テレイン → ラスタ(Terrain To Raster) (3D Analyst)
サマリ
テレイン データセットをラスタに変換します。
使用法
-
解像度パラメータは、変換に使用するテレインのピラミッド レベルを指定します。ピラミッド レベルは、Z 許容値またはウィンドウ サイズのピラミッド タイプを使用して定義します。テレイン ピラミッドの詳細については、「テレイン ピラミッド」をご参照ください。
-
テレインのサブセットを抽出するには、ジオプロセシング環境設定を使用して範囲を定義します。
-
内挿オプションには、LINEAR または NATURAL_NEIGHBORS を指定できます。これらは、三角網テレイン サーフェスに適用される TIN ベースの手法です。リニア オプションは、各セルの中心を含む三角形を探し、三角形のノードの加重平均を適用して値を内挿します。Natural Neighbor オプションでは、Voronoi 隣接の面積に基づくウェイトを使用します。
-
出力ラスタは、ファイル ベースにするか、ジオデータベースにラスタ データセットとして作成することができます。ファイル ベースのラスタでは、指定した拡張子でラスタの形式が決まります。たとえば、「.img」の拡張子を使用すると IMAGINE ファイルが生成され、「.tif」の拡張子を使用すると TIFF ファイルが生成されます。ラスタにファイル拡張子が付いていない場合は、Esri GRID が生成されます。
構文
パラメータ | 説明 | データ タイプ |
in_terrain |
入力テレイン データセット。 | Terrain Layer |
out_raster |
出力ラスタの場所と名前。ジオデータベースまたは Esri Grid などのフォルダにラスタ データセットを格納する場合、ラスタ データセットの名前にファイル拡張子は付けません。ラスタをフォルダに格納するときにその形式を定義するためにファイル拡張子を付けることはできます。
ラスタを TIFF ファイルとして、またはジオデータベースに格納する場合は、ジオプロセシング環境設定を使用して、そのラスタ圧縮のタイプと品質を指定できます。 | Raster Dataset |
data_type (オプション) |
出力ラスタのデータ タイプは、以下のキーワードで定義できます。
| String |
method (オプション) |
内挿法を選択します。デフォルトでは、セル値はリニア内挿法を使用して計算されます。
| String |
sample_distance sampling_method distance (オプション) |
出力ラスタのセル サイズを定義するために使用するサンプリング方法と距離。
| String |
pyramid_level_resolution (オプション) |
このツールが使用するテレイン ピラミッド レベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0(最大解像度)です。 | Double |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.TerrainToRaster_3d("sample.gdb/featuredataset/terrain", "terrain.img", "INT", "LINEAR", "CELLSIZE 10", 2.5)
次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''*********************************************************************
Name: TerrainToRaster Example
Description: This script demonstrates how to use the
TerrainToRaster tool.
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set environment setting
env.workspace = "C:/data"
# Set Local Variables
terrain = "sample.gdb/featuredataset/terrain"
bitType = "INT"
method = "LINEAR"
sampling = "CELLSIZE 10"
pyrLvl = 2.5
outRas = arcpy.CreateUniqueName("terrain_level.img")
#Execute TerrainToRaster
arcpy.ddd.TerrainToRaster(terrain, outRas, bitType,
method, sampling, pyrLvl)
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)