ラスタのコピー（Copy Raster） (データの管理)
サマリ
ラスタ データセットのコピーを作成したり、ラスタ データセットをラスタ カタログにロードしたりします。
使用法
-
出力は、BIL、BIP、BMP、BSQ、DAT、GIF、GRID、IMG、JPEG、JPEG 2000、PNG、TIFF、または任意のジオデータベース ラスタ データセットに保存することができます。
-
ジオデータベースにラスタ データセットを格納する場合、ラスタ データセットの名前にファイル拡張子は付けません。ラスタ データセットをファイル形式で格納する場合は、ファイル拡張子を指定する必要があります。
- *.bil（Esri BIL）
- *.bip（Esri BIP）
- *.bmp（BMP）
- *.bsq（Esri BSQ）
- *.dat（ENVI DAT）
- *.gif （GIF）
- *.img（ERDAS IMAGINE）
- *.jpg（JPEG）
- *.jp2（JPEG 2000）
- *.png（PNG）
- *.tif（TIFF）
- 拡張子なし（GRID）
-
このツールの出力は、ラスタ データセットがラスタ カタログにロードされていても、必ずラスタ データセットになります。このツールは、入力としてモザイク データセットを使用しますが、出力はラスタ データセットです。モザイク データセットの内容は、ラスタ データセットを作成するためにモザイク化されます。
-
このツールを使用して、ラスタ データセットをラスタ カタログに読み込むことができます。ラスタ データセットをラスタ カタログに読み込むには、出力位置としてラスタ カタログの絶対パスを入力するか、ラスタ カタログを出力テキスト ボックスにドラッグする必要があります。
-
このツールを使用してラスタ データセットをラスタ カタログに読み込む場合は、読み込み完了後に [デフォルト空間グリッド インデックスの計算（Calculate Default Spatial Grid Index）] ツールを実行する必要があります。
-
ファイルベースのラスタおよびパーソナル ジオデータベース ラスタの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。ファイル ジオデータベース ラスタと ArcSDE ラスタについては、この余分の処理を行う必要はありません。
-
ラスタ データセットを JPEG ファイル、JPEG 2000 ファイル、またはジオデータベースに格納するときに、環境設定で [圧縮] タイプと [圧縮品質] を指定できます。
-
GIF 形式がサポートするのは、シングルバンド ラスタ データセットのみです。
-
ピクセル タイプ パラメータによって、出力ラスタ データセットのビット深度が決まります。別のピクセル タイプが選択されたときは、ラスタ値の再調整が行われます。ピクセル タイプが降格された（引き下げられた）場合、そのピクセル深度の有効範囲外のラスタ値は切詰められ、失われます。サポートされているエクスポート形式のビット深度の容量については、「ラスタ データセット形式の技術仕様」をご参照ください。
構文
| パラメータ | 説明 | データ タイプ |
in_raster |
コピーされるラスタ データセットの名前と場所です。 | Raster layer |
out_rasterdataset |
作成するラスタ データセットの名前と場所。 ラスタ データセットをファイル形式で格納する場合は、ファイル拡張子を指定する必要があります。
ジオデータベースにラスタ データセットを格納する場合、ラスタ データセットの名前にファイル拡張子は付けません。 ラスタ データセットを JPEG ファイル、JPEG 2000 ファイル、TIFF ファイル、またはジオデータベースに格納するときに、圧縮タイプと圧縮品質を指定できます。 | Raster Dataset ; Raster Catalog |
config_keyword （オプション） |
ファイル ジオデータベースおよび ArcSDE ジオデータベースの格納パラメータ（コンフィグレーション）を指定します。パーソナル ジオデータベースは、コンフィグレーション キーワードを使用しません。 ArcSDE コンフィグレーション キーワードは、データベース管理者によって設定されます。 | String |
background_value （オプション） |
ラスタ データの周囲に作成された不要な値を削除する場合に、このオプションを使用します。指定した値は、ラスタ データセットの他の有用なデータと区別されます。たとえば、ラスタ データセットの境界に沿ったゼロ値は、ラスタ データセット内のゼロ値と区別されます。 指定したピクセル値は、出力ラスタ データセットでは NoData に設定されます。 ファイルベースのラスタおよびパーソナル ジオデータベース ラスタの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。ArcSDE およびファイル ジオデータベース ラスタについては、この余分の処理を行う必要はありません。 | Double |
nodata_value （オプション） |
指定した値を持つすべてのピクセルが、出力ラスタ データセットでは NoData に設定されます。 | Double |
onebit_to_eightbit （オプション） |
入力の 1 ビット ラスタ データセットを 8 ビット ラスタ データセットに変換するかどうかを選択します。この変換では、入力ラスタ データセットの値 1 が出力ラスタ データセットの 255 に変更されます。これは、1 ビット ラスタ データセットを ArcSDE にインポートするときに便利です。1 ビット ラスタ データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤを持ちますが、ArcSDE では 1 ビット ラスタ データセットは 1 ビット ピラミッド レイヤしか持つことができず、そのために表示が不十分なものになります。このデータを ArcSDE の 8 ビットに変換すると、ピラミッド レイヤが 1 ビットではなく 8 ビットとして作成されるため、本来のラスタ データセットが表示されます。
| Boolean |
colormap_to_RGB （オプション） |
入力ラスタ データセットがカラーマップを持つ場合、出力ラスタ データセットを 3 バンドの出力ラスタ データセットに変換できます。これは、別のカラーマップでラスタをモザイク化するときに役立ちます。
| Boolean |
pixel_type （オプション） |
出力ラスタ データセットのビット深度を決定します。何も指定しない場合、出力ビット深度は入力と同じになります。 別のピクセル タイプが選択されたときに、ラスタ値の再調整は行われません。ピクセル タイプが降格された（引き下げられた）場合、そのピクセル深度の有効範囲外のラスタ値は切詰められ、失われます。
| String |
コードのサンプル
これは、CopyRaster（ラスタのコピー）のための Python サンプルです。
import arcpy
arcpy.CopyRaster_management("c:/data/background.tif",
"c:/fdgb/CpRaster.gdb/fgdbRD","DEFAULTS",
"0","9","","","8_BIT_UNSIGNED")
これは、CopyRaster（ラスタのコピー）のための Python スクリプト サンプルです。
##====================================
##Copy Raster
##Usage: CopyRaster_management in_raster out_rasterdataset {config_keyword} {background_value} {nodata_value} {NONE | OneBitTo8Bit}
## {NONE | ColormapToRGB} {1_BIT | 2_BIT | 4_BIT | 8_BIT_UNSIGNED | 8_BIT_SIGNED | 16_BIT_UNSIGNED
## | 16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT}
try:
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
arcpy.CopyRaster_management("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
##Copy 1 BIT
arcpy.CopyRaster_management("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
except:
print "Copy Raster example failed."
print arcpy.GetMessages()