テレイン → ラスタ（Terrain To Raster） (3D Analyst)
サマリ
テレイン データセットをラスタに変換します。
使用法
-
解像度パラメータは、変換に使用するテレインのピラミッド レベルを指定します。ピラミッド レベルは、Z 許容値またはウィンドウ サイズのピラミッド タイプを使用して定義します。テレイン ピラミッドの詳細については、「テレイン ピラミッド」をご参照ください。
-
テレインのサブセットを抽出するには、ジオプロセシング環境設定を使用して範囲を定義します。
-
内挿オプションには、LINEAR（リニア）または NATURAL_NEIGHBORS（Natural Neighbor）を指定できます。これらは、三角網テレイン サーフェスに適用される TIN ベースの手法です。リニア オプションは、各セルの中心を含む三角形を探し、三角形のノードの加重平均を適用して値を内挿します。Natural Neighbor オプションでは、Voronoi 隣接の面積に基づくウェイトを使用します。
-
出力ラスタは、ファイル ベースにするか、ジオデータベースにラスタ データセットとして作成することができます。ファイル ベースのラスタでは、指定した拡張子でラスタの形式が決まります。たとえば、「.img」の拡張子を使用すると IMAGINE ファイルが生成され、「.tif」の拡張子を使用すると TIFF ファイルが生成されます。ラスタにファイル拡張子が付いていない場合は、Esri GRID が生成されます。
構文
| パラメータ | 説明 | データ タイプ |
in_terrain |
The input terrain dataset. | Terrain Layer |
out_raster |
The location and name of the output raster. When storing a raster dataset in a geodatabase or in a folder such as an Esri Grid, no file extension should be added to the name of the raster dataset. A file extension can be provided to define the raster's format when storing it in a folder:
If the raster is stored as a TIFF file or in a geodatabase, its raster compression type and quality can be specified using geoprocessing environment settings. | Raster Dataset |
data_type （オプション） |
The data type of the output raster can be defined by the following keywords:
| String |
method （オプション） |
内挿法を選択します。デフォルトでは、セル値はリニア内挿法を使用して計算されます。
| String |
sample_distance sampling_method distance （オプション） |
The sampling method and distance used to define the cell size of the output raster.
| String |
pyramid_level_resolution （オプション） |
The z-tolerance or window size resolution of the terrain pyramid level that will be used by this tool. The default is 0, or full resolution. | Double |
コードのサンプル
The following sample demonstrates the use of this tool in the Python window:
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)
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''*********************************************************************
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)