クリップ(Clip) (データの管理)
サマリ
ラスタ データセット、モザイク データセット、またはイメージ サービス レイヤを含む、ラスタの空間サブセットを作成します。
図
使用法
-
このツールを使用すると、テンプレートの範囲に基づいて、ラスタ データセットの一部を抽出することができます。クリップ出力には、指定したテンプレート範囲を交差するすべてのピクセルが含まれます。フィーチャ データセットの一部を抽出する場合、[解析] ツールボックスにある [クリップ(Clip)] ツールを使用します。
-
クリップする領域は、最小および最大の XY 座標を使用する長方形のエンベロープか、出力範囲ファイルのどちらかを使用して指定します。指定されたクリップ範囲が入力ラスタ データセットに合わない場合は、適切な配置が使用されているかどうかがツールによって確認されます。この結果、出力の範囲がツールに指定した範囲と多少異なる場合があります。
-
クリップ範囲として既存のラスタ レイヤまたはベクタ レイヤを使用することができます。フィーチャクラスを出力範囲として使用する場合は、フィーチャクラスをぴったりと囲む長方形(最小境界ボックス)と、各フィーチャのポリゴン ジオメトリのどちらでラスタをクリップするかを選択できます。クリップ ジオメトリを使用すると、出力のピクセル深度が向上する可能性があります。したがって、出力形式で適切なピクセル深度をサポートできることを確認する必要があります。
-
ArcMap を使用する場合は、選択したフィーチャをクリップ範囲として使用することができます。フィーチャクラス内のフィーチャを選択し、[入力フィーチャをクリップ ジオメトリとして使用] をオンにした場合([clipping_geometry] を [ClippingGeometry] に設定した場合)、選択した領域が出力でクリップされます。フィーチャクラス内のフィーチャを選択し、[入力フィーチャをクリップ ジオメトリとして使用] をオフにした場合は、選択したフィーチャの最小境界ボックスが出力でクリップされます。
-
出力は、BIL、BIP、BMP、BSQ、DAT、GIF、Esri Grid、IMG、JPEG、JPEG 2000、PNG、TIFF、または任意のジオデータベース ラスタ データセットに保存することができます。
-
範囲の値は、ラスタ データセットと同じ空間座標と単位で表す必要があります。
構文
パラメータ | 説明 | データ タイプ |
in_raster |
入力ラスタ データセット | Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer |
rectangle |
クリップする最小境界ボックスを定義する 4 つの座標を、最小 X 座標、最小 Y 座標、最大 X 座標、最大 Y 座標の順に指定します。 指定されたクリップ範囲が入力ラスタ データセットに合わない場合は、適切な配置が使用されているかどうかが [クリップ(Clip)] ツールによって確認されます。この結果、出力の範囲がツールに指定した範囲と多少異なる場合があります。 | Envelope |
out_raster |
出力ラスタ データセット。この出力形式が、適切なピクセル深度をサポートできることを確認してください。 ラスタ データセットをファイル形式で格納する場合は、ファイル拡張子を指定する必要があります。
ジオデータベースにラスタ データセットを格納する場合、ラスタ データセットの名前にファイル拡張子は付けません。 ラスタ データセットを JPEG ファイル、JPEG 2000 ファイル、TIFF ファイル、またはジオデータベースに格納するときに、圧縮タイプと圧縮品質を指定できます。 | Raster Dataset |
in_template_dataset (オプション) |
クリップ範囲として使用できる既存のラスタ レイヤまたはベクタ レイヤ。クリップ出力には、最小境界ボックスを交差するすべてのピクセルが含まれます。 フィーチャクラスが出力範囲として使用され、ポリゴン フィーチャに基づいてラスタをクリップしたい場合は、[clipping_geometry] オプションを使用します。このオプションをオンにすると、出力のピクセル深度が向上する可能性があります。したがって、出力形式で適切なピクセル深度をサポートできることを確認する必要があります。 | Raster Layer; Feature Layer |
nodata_value (オプション) |
指定した値を持つすべてのピクセルが、出力ラスタ データセットでは NoData に設定されます。 | String |
clipping_geometry (オプション) |
フィーチャクラスを出力範囲として使用する場合は、フィーチャクラスの範囲とそのポリゴン周長のどちらでラスタをクリップするかを選択できます。
クリップ ジオメトリを使用すると、出力のピクセル深度が向上する可能性があります。したがって、出力形式で適切なピクセル深度をサポートできることを確認する必要があります。 | Boolean |
コードのサンプル
これは Clip(クリップ)ツールのための Python サンプルです。
import arcpy
arcpy.Clip_management("c:/data/image.tif","1952602 294196 1953546 296176",
"c:/data/clip.gdb/clip01", "#", "#", "NONE")
これは Clip(クリップ)ツールのための Python スクリプト サンプルです。
##====================================
##Clip
##Usage: Clip_management in_raster rectangle out_raster {in_template_dataset} {nodata_value} {NONE | ClippingGeometry}
try:
import arcpy
arcpy.env.workspace = r"C:/Workspace"
##Clip Raster Dataset by known extent - Left Bottom Right Top
arcpy.Clip_management("image.tif","1952602.23 294196.279 1953546.23 296176.279","clip.gdb/clip", "#", "#", "NONE")
##Clip Raster Dataset with feature geometry
arcpy.Clip_management("image.tif", "#", "clip.tif","feature.shp", "0", "ClippingGeometry")
except:
print "Clip example failed."
print arcpy.GetMessages()