ラスタのコピー(Copy Raster) (データの管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

ラスタ データセットのコピーの作成、ラスタ カタログへのラスタ データセットの読み込み、またはモザイク データセットのラスタ データセットへの変換を行います。

使用法

構文

CopyRaster_management (in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap})
パラメータ説明データ タイプ
in_raster

コピーされるラスタ データセットの名前と場所です。

Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer
out_rasterdataset

作成するラスタ データセットの名前と場所。

ラスタ データセットをファイル形式で格納する場合は、ファイル拡張子を指定する必要があります。

  • *.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)
  • 拡張子なし(Esri GRID)

ジオデータベースにラスタ データセットを格納する場合、ラスタ データセットの名前にファイル拡張子は付けません。

ラスタ データセットを JPEG ファイル、JPEG 2000 ファイル、TIFF ファイル、またはジオデータベースに格納するときに、圧縮タイプと圧縮品質を指定できます。

Raster Dataset; Raster Catalog
config_keyword
(オプション)

ファイル ジオデータベースおよび ArcSDE ジオデータベースの格納パラメータ(コンフィグレーション)を指定します。パーソナル ジオデータベースは、コンフィグレーション キーワードを使用しません。

ArcSDE コンフィグレーション キーワードは、データベース管理者によって設定されます。

String
background_value
(オプション)

ラスタ データの周囲に作成された不要な値を削除する場合に、このオプションを使用します。指定した値は、ラスタ データセットの他の有用なデータと区別されます。たとえば、ラスタ データセットの境界に沿ったゼロ値は、ラスタ データセット内のゼロ値と区別されます。

指定したピクセル値は、出力ラスタ データセットでは NoData に設定されます。

ファイルベースのラスタおよびパーソナル ジオデータベース ラスタの場合は、背景値を除外するために、[背景値を除外] を NoData と同じ値に設定する必要があります。ArcSDE およびファイル ジオデータベース ラスタについては、この余分の処理を行う必要はありません。

Double
nodata_value
(オプション)

指定した値を持つすべてのピクセルが、出力ラスタ データセットでは NoData に設定されます。

String
onebit_to_eightbit
(オプション)

入力の 1 ビット ラスタ データセットを 8 ビット ラスタ データセットに変換するかどうかを選択します。この変換では、入力ラスタ データセットの値 1 が出力ラスタ データセットの 255 に変更されます。これは、1 ビット ラスタ データセットを ArcSDE にインポートするときに便利です。1 ビット ラスタ データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤを持ちますが、ArcSDE では 1 ビット ラスタ データセットは 1 ビット ピラミッド レイヤしか持つことができず、そのために表示が不十分なものになります。このデータを ArcSDE の 8 ビットに変換すると、ピラミッド レイヤが 1 ビットではなく 8 ビットとして作成されるため、本来のラスタ データセットが表示されます。

  • NONE変換を実行しません。これがデフォルトです。
  • OneBitTo8Bit入力ラスタが変換されます。
Boolean
colormap_to_RGB
(オプション)

入力ラスタ データセットがカラーマップを持つ場合、出力ラスタ データセットを 3 バンドの出力ラスタ データセットに変換できます。これは、別のカラーマップでラスタをモザイク化するときに役立ちます。

  • NONE変換は行われません。これがデフォルトです。
  • ColormapToRGB入力データセットが変換されます。
Boolean
pixel_type
(オプション)

出力ラスタ データセットのビット深度を決定します。何も指定しない場合、出力ビット深度は入力と同じになります。

別のピクセル タイプが選択されたときに、ラスタ値の再調整は行われません。ピクセル タイプが降格された(引き下げられた)場合、そのピクセル深度の有効範囲外のラスタ値は切詰められ、失われます。

  • 1_BIT1 ビット符号なし整数。値は 0 または 1 です。
  • 2_BIT2 ビット符号なし整数。サポートされる値は 0 〜 3 です。
  • 4_BIT4 ビット符号なし整数。サポートされる値は 0 〜 15 です。
  • 8_BIT_UNSIGNED8 ビット符号なしデータ タイプ。サポートされる値は 0 〜 255 です。
  • 8_BIT_SIGNED8 ビット符号付きデータ タイプ。サポートされる値は -128 〜 127 です。
  • 16_BIT_UNSIGNED16 ビット符号なしデータ タイプ。値の範囲は 0 〜 65,535 です。
  • 16_BIT_SIGNED16 ビット符号付きデータ タイプ。値の範囲は -32,768 〜 32,767 です。
  • 32_BIT_UNSIGNED32 ビット符号なしデータ タイプ。値の範囲は 0 〜 4,294,967,295 です。
  • 32_BIT_SIGNED32 ビット符号付きデータ タイプ。値の範囲は -2,147,483,648 〜 2,147,483,647 です。
  • 32_BIT_FLOAT小数点をサポートする 32 ビット データ タイプ。
  • 64_BIT小数点をサポートする 64 ビット データ タイプ。
String
scale_pixel_value
(オプション)

出力と入力のピクセル タイプが異なる場合(たとえば、入力が 16 ビットで出力が 8 ビット)、新しい範囲に合わせて値を変更するように選択できます。変更しない場合、新しいピクセル範囲に含まれない値は破棄されます。

8 ビットから 16 ビットのように値を拡大する場合は、8 ビット値の最小値と最大値が 16 ビット範囲の最小値と最大値に拡大されます。16 ビットから 8 ビットのように値を縮小する場合は、16 ビットの最小値と最大値が 8 ビット範囲の最小値と最大値に縮小されます。

  • NONEピクセル値は同じままで変更されません。値の範囲に含まれない値は破棄されます。これがデフォルトです。
  • ScalePixelValueピクセル値を新しいピクセル タイプに変更します。ピクセル深度を変更する場合、ラスタの表示は変化しませんが、値は指定した新しいビット深度に変更されます。
Boolean
RGB_to_Colormap
(オプション)

8 ビットで 3 バンド(RGB)のラスタ データセットを、カラーマップを含むシングル バンド ラスタ データセットに変換できます。

ラスタ データセットの統計情報を調査して、値を 255 の等量に分類することで、スキャンした画像で発生しやすいカラー ノイズを抑制します。

スクリーン キャプチャ、スキャン マップ、またはスキャン ドキュメントに適しています。衛星画像や航空画像、または主題ラスタ データでの使用はお勧めしません。

  • NONE出力は 3 バンド(RGB)ラスタ データセットのままです。カラーマップへの変換は行われません。これがデフォルトです。
  • RGBToColormap255 色のカラーマップを使用するシングル バンド ラスタ データセットを作成します。
Boolean

コードのサンプル

CopyRaster(ラスタのコピー)の例 1(Python ウィンドウ)

これは、CopyRaster(ラスタのコピー)のための Python サンプルです。

import arcpy
arcpy.CopyRaster_management("c:/data/background.tif",
                           "c:/fdgb/CpRaster.gdb/fgdbRD","DEFAULTS",
                           "0","9","","","8_BIT_UNSIGNED")
CopyRaster(ラスタのコピー)の例 2(スタンドアロン スクリプト)

これは、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()

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
9/14/2013