| ラベル | 説明 | データ タイプ |
入力ラスター | コピーするラスター データセットまたはモザイク データセット。 | Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service |
出力ラスター データセット | 作成するラスター データの名前および形式。
ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。 ラスター データセットを JPEG 形式、JPEG 2000 形式、TIFF 形式、またはジオデータベースに格納するときに、圧縮タイプと圧縮品質を指定できます。 | Raster Dataset |
コンフィグレーション キーワード (オプション) | ジオデータベースの格納パラメーター (コンフィグレーション)。 コンフィグレーション キーワードは、データベース管理者によって設定されます。 | String |
背景値を除外 (オプション) | ラスター データの周囲に作成された不要な値を削除します。 指定した値は、ラスター データセットの他の有用なデータと区別されます。 たとえば、ラスター データセットの境界に沿ったゼロ値は、ラスター データセット内のゼロ値と区別されます。 指定したピクセル値は、出力ラスター データセットでは NoData に設定されます。 ファイルベースのラスターの場合は、背景値を除外するために、このパラメーターを [NoData 値] パラメーターと同じ値に設定する必要があります。 エンタープライズ ラスターとジオデータベース ラスターについては、この追加の処理を行う必要はありません。 ファイルベースのラスターの場合は、背景値を除外するために、このパラメーターを nodata_value パラメーターと同じ値に設定する必要があります。 エンタープライズ ラスターとジオデータベース ラスターについては、この追加の処理を行う必要はありません。 | Double |
NoData 値 (オプション) | 指定した値を持つすべてのピクセルが、出力ラスター データセットでは [NoData] に設定されます。 | String |
1 ビット データを 8 ビットに変換 (オプション) | 入力の 1 ビット ラスター データセットを 8 ビット ラスター データセットに変換するかどうかを指定します。 この変換では、入力ラスター データセットの値 1 が出力ラスター データセットで 255 に変更されます。 これは、1 ビット ラスター データセットをジオデータベースにインポートするときに便利です。 1 ビット ラスター データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤーを持ちますが、ジオデータベースでは 1 ビット ラスター データセットは 1 ビット ピラミッド レイヤーしか持つことができず、そのために表示品質が低下します。 このデータをジオデータベースの 8 ビットに変換すると、ピラミッド レイヤーが 1 ビットではなく 8 ビットとして作成されるため、本来のラスター データセットが表示されます。
| Boolean |
カラーマップから RGB に変換 (オプション) | 入力ラスター データセットにカラーマップが含まれる場合に、入力ラスター データセットを 3 バンドの出力ラスター データセットに変換するかどうかを指定します。 これは、別のカラーマップでラスターをモザイクするときに役立ちます。
| Boolean |
ピクセル タイプ (オプション) | ラスターまたはモザイク データセットに使用するビット深度 (放射量分解能) を指定します。 定義されない場合、最初のラスター データセットの値が使用されます。
| String |
ピクセル値の変更 (オプション) | ピクセル値を変更するかどうかを指定します。 出力と入力のピクセル タイプが異なる場合 (たとえば、入力が 16 ビットで出力が 8 ビット)、新しい範囲に合わせて値を変更できます。変更しない場合、新しいピクセル範囲に含まれない値は破棄されます。 8 ビットから 16 ビットのように値を拡大する場合は、8 ビット値の最小値と最大値が 16 ビット範囲の最小値と最大値に拡大されます。 16 ビットから 8 ビットのように値を縮小する場合は、16 ビットの最小値と最大値が 8 ビット範囲の最小値と最大値に縮小されます。
| Boolean |
RGB からカラーマップに変換 (オプション) | 8 ビットで 3 バンド (RGB) のラスター データセットをカラーマップを含むシングル バンドのラスター データセットに変換するかどうかを指定します。 この操作は、スキャン画像によく見られるノイズを抑制し、スクリーン キャプチャ、スキャン マップ、またはスキャン ドキュメントに適しています。 衛星画像や航空画像、または主題ラスター データでの使用はおすすめしません。
| Boolean |
形式 (オプション) | 出力ラスターの形式を指定します。
| String |
変換の適用 (オプション) | 入力ラスターに関連付けられている変換を出力に適用するかどうかを指定します。 入力ラスターには、変換を関連付けることができます。これは、ワールド ファイルやジオメトリック関数などとして、入力内には保存されません。
| Boolean |
多次元として処理 (オプション) | 入力モザイク データセットを多次元ラスター データセットとして処理するかどうか指定します。
| Boolean |
多次元転置の構築 (Build Multidimensional Transpose) (オプション) | データ アクセスを最適化するために、入力多次元ラスター データセットの転置を構築するかどうかを指定します。 転置は、多次元データを各ディメンションに沿ってチャンクに分割し、すべてのスライスにわたってピクセル値にアクセスするときのパフォーマンスを最適化します。
| Boolean |
サマリー
ラスター データセットのコピーを保存したり、モザイク データセットを 1 つのラスター データセットに変換したりします。
使用法
出力は、AVIF、BIL、BIP、BMP、BSQ、COG、CRF、ENVI DAT、ERDAS IMAGINE、GIF、JPEG、JPEGXL、JPEG 2000、MRF、NetCDF、PNG、TIFF、WEBP、Zarr、Esri Grid 形式または任意のジオデータベース ラスター データセットに保存することができます。
ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。 ラスター データセットをファイル形式で格納する場合は、以下のようにファイル拡張子を指定します。
- AVIF の場合は .avif
- Esri BIL の場合は .bil
- Esri BIP の場合は .bip
- BMP の場合は .bmp
- Esri BSQ の場合は .bsq
- CRF の場合は .crf
- ENVI DAT の場合は .dat
- ERDAS IMAGINE の場合は .img
- GIF の場合は .gif
- JPEG の場合は .jpg
- JPEGXL の場合は .jxl
- JPEG 2000 の場合は .jp2
- MRF の場合は .mrf
- NetCDF の場合は *.nc
- PNG の場合は .png
- TIFF とクラウド最適化 GeoTIFF 形式の場合は *.tif
- WEBP の場合は .webp
- Zarr の場合は *.zarr
- Esri Grid の場合は拡張子なし
このツールを使用して、ピクセル タイプを別のビット深度に変更することができます。 ピクセル深度を変更する場合、ラスターの表示は変化しませんが、値は指定した新しいビット深度に変更されます。
多次元 Esri クラウド ラスター形式 (CRF) のセル サイズは正方形です。 長方形セル サイズのラスターを CRF に変換した場合、最も小さい幅または高さが出力 CRF のセル サイズになります。
このツールの出力は必ずラスター データセットになります。 このツールは、入力としてモザイク データセットを使用しますが、出力はラスター データセットです。モザイク データセットの内容は、ラスター データセットを作成するためにモザイク化されます。
[ラスターと画像] オプションの [ワールド ファイルを使用してラスターの座標値を定義] をオンにした場合、ワールド ファイルが出力されます。 ワールド テーブルが存在する場合、上書きされます。 また、出力された空間参照で、1/2 ピクセル シフトが発生する場合があります。
ファイルベースのラスターの場合は、背景値を除外するために、[背景値を除外] パラメーターを [NoData 値] パラメーターと同じ値に設定する必要があります。 ファイル ジオデータベース ラスターとエンタープライズ ジオデータベース ラスターについては、この追加の処理を行う必要はありません。
ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。
GIF 形式がサポートするのは、シングルバンド ラスター データセットのみです。
作成後は、.mrf ファイルを ArcGIS AllSource でコピー、名前変更、または削除することはできません。 .mrf ファイルは、他の場所にあるデータをポイントしている可能性があり、ファイルの読み取りまたは書き込みステータスを判別できるとは限りません。
[ピクセル タイプ] パラメーターでは、出力ラスター データセットのビット深度を指定します。 別のピクセル タイプが指定された場合、ラスター値の再調整が行われます。 ピクセル タイプが降格された (引き下げられた) 場合、そのピクセル深度の有効範囲外のラスター値は切詰められ、失われます。 サポートされているエクスポート形式のビット深度の容量については、「サポートされているセンサーのリスト」をご参照ください。
ツールを使って任意のラスターからクラウド最適化 GeoTIFF (COG) 形式ファイルを作成するプロセスは 2 つに分かれており、COG 仕様に沿った GeoTIFF 内部構造の適切な並べ替えが必要です。 最初のステップでは、ピラミッド、統計、その他のメタデータを使って入力ラスターから一時 GeoTIFF 形式ファイルを生成します。 次に、この一時 GeoTIFF 形式ファイルをコピーして COG 形式ファイルを生成します。
COG 形式の生成におけるディスク要件はソース画像のスペースの 2 倍以上ですが、入力ラスターと出力 COG 形式ファイルの圧縮によっても変化します。
出力でサポートされている NetCDF 形式のタイプは、NetCDF CF (Climate and Forecast) メタデータ規約に準拠します。
NetCDF 形式はシングル バンド データのみをサポートします。 衛星データなどの多次元およびマルチバンド データの場合は、最初のバンドが使用されます。
このツールでは、ラスター データを表す ASCII ファイルをラスター データセットに変換できます。 デフォルトでは、[入力ラスター] パラメーターの参照機能では、拡張子 .asc が付いた ASCII ファイルのみが認識されます。 別のファイル拡張子が付いた ASCII ファイルがある場合、次のいずれかの操作を行います。
- ファイル名を変更して拡張子 .asc を付けます。
- [入力ラスター] ダイアログ ボックスで、フィルターを [サポートされているすべてのタイプ] から [ファイル] に変更します。
ファイルの名前を変更することをおすすめします。
[多次元転置の構築] パラメーターは、データ アクセス最適化用です。 デフォルトでは、.crf ファイルは、各多次元スライスを別々のフォルダーに格納し、各スライスがタイルに分割されます。 転置を実行すると、データは、スライスやタイルによってではなく、ディメンションに沿って分割され、時系列プロファイルなどの解析をより高速にします。
ラスター データセットの境界線の外に範囲を指定すると、データを含まないエリアは NoData 値で埋められます。
パラメーター
arcpy.management.CopyRaster(in_raster, out_rasterdataset, {config_keyword}, {background_value}, {nodata_value}, {onebit_to_eightbit}, {colormap_to_RGB}, {pixel_type}, {scale_pixel_value}, {RGB_to_Colormap}, {format}, {transform}, {process_as_multidimensional}, {build_multidimensional_transpose})| 名前 | 説明 | データ タイプ |
in_raster | コピーするラスター データセットまたはモザイク データセット。 | Raster Dataset; Mosaic Dataset; Mosaic Layer; Raster Layer; File; Image Service |
out_rasterdataset | 作成するラスター データの名前および形式。
ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。 ラスター データセットを JPEG 形式、JPEG 2000 形式、TIFF 形式、またはジオデータベースに格納するときに、圧縮タイプと圧縮品質を指定できます。 | Raster Dataset |
config_keyword (オプション) | ジオデータベースの格納パラメーター (コンフィグレーション)。 コンフィグレーション キーワードは、データベース管理者によって設定されます。 | String |
background_value (オプション) | ラスター データの周囲に作成された不要な値を削除します。 指定した値は、ラスター データセットの他の有用なデータと区別されます。 たとえば、ラスター データセットの境界に沿ったゼロ値は、ラスター データセット内のゼロ値と区別されます。 指定したピクセル値は、出力ラスター データセットでは NoData に設定されます。 | Double |
nodata_value (オプション) | 指定した値を持つすべてのピクセルが、出力ラスター データセットでは [NoData] に設定されます。 | String |
onebit_to_eightbit (オプション) | 入力の 1 ビット ラスター データセットを 8 ビット ラスター データセットに変換するかどうかを指定します。 この変換では、入力ラスター データセットの値 1 が出力ラスター データセットで 255 に変更されます。 これは、1 ビット ラスター データセットをジオデータベースにインポートするときに便利です。 1 ビット ラスター データセットは、ファイル システムに格納されたときには 8 ビット ピラミッド レイヤーを持ちますが、ジオデータベースでは 1 ビット ラスター データセットは 1 ビット ピラミッド レイヤーしか持つことができず、そのために表示品質が低下します。 このデータをジオデータベースの 8 ビットに変換すると、ピラミッド レイヤーが 1 ビットではなく 8 ビットとして作成されるため、本来のラスター データセットが表示されます。
| Boolean |
colormap_to_RGB (オプション) | 入力ラスター データセットにカラーマップが含まれる場合に、入力ラスター データセットを 3 バンドの出力ラスター データセットに変換するかどうかを指定します。 これは、別のカラーマップでラスターをモザイクするときに役立ちます。
| Boolean |
pixel_type (オプション) | ラスターまたはモザイク データセットに使用するビット深度 (放射量分解能) を指定します。 定義されない場合、最初のラスター データセットの値が使用されます。
| String |
scale_pixel_value (オプション) | ピクセル値を変更するかどうかを指定します。 出力と入力のピクセル タイプが異なる場合 (たとえば、入力が 16 ビットで出力が 8 ビット)、新しい範囲に合わせて値を変更できます。変更しない場合、新しいピクセル範囲に含まれない値は破棄されます。 8 ビットから 16 ビットのように値を拡大する場合は、8 ビット値の最小値と最大値が 16 ビット範囲の最小値と最大値に拡大されます。 16 ビットから 8 ビットのように値を縮小する場合は、16 ビットの最小値と最大値が 8 ビット範囲の最小値と最大値に縮小されます。
| Boolean |
RGB_to_Colormap (オプション) | 8 ビットで 3 バンド (RGB) のラスター データセットをカラーマップを含むシングル バンドのラスター データセットに変換するかどうかを指定します。 この操作は、スキャン画像によく見られるノイズを抑制し、スクリーン キャプチャ、スキャン マップ、またはスキャン ドキュメントに適しています。 衛星画像や航空画像、または主題ラスター データでの使用はおすすめしません。
| Boolean |
format (オプション) | 出力ラスターの形式を指定します。
| String |
transform (オプション) | 入力ラスターに関連付けられている変換を出力に適用するかどうかを指定します。 入力ラスターには、変換を関連付けることができます。これは、ワールド ファイルやジオメトリック関数などとして、入力内には保存されません。
| Boolean |
process_as_multidimensional (オプション) | 入力モザイク データセットを多次元ラスター データセットとして処理するかどうか指定します。
| Boolean |
build_multidimensional_transpose (オプション) | 入力多次元ラスター データセットの転置を構築するかどうかを指定します。転置は、各ディメンションに沿ってデータをチャンクに分割し、すべてのスライスにわたってピクセル値にアクセスするときのパフォーマンスを最適化します。
| Boolean |
コードのサンプル
以下は、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},
## {NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image |
## BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ |
## Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})
try:
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy Multidimensional Raster Dataset to a new multidimensional dataset in Cloud raster format and with transpose for faster data access
arcpy.management.CopyRaster('SeaSurfaceTemp.nc',"https://s3.amazonaws.com/S3Storage/seasurfacetemp","","","","","","","","", "CRF",'NONE',process_as_multidimensional = 'ALL_SLICES', build_multidimensional_transpose='TRANSPOSE')
##Copy 1 BIT
arcpy.management.CopyRaster("1bit.tif","SDE94.sde\\bit8","DEFAULTS","","","OneBitTo8Bit","","")
##Copy File RasterDataset to GDB Dataset with Background and Nodata setting
arcpy.management.CopyRaster("background.tif","CpRaster.gdb\\background","DEFAULTS","0","9","","","8_BIT_UNSIGNED")
except:
print("Copy Raster example failed.")
print(arcpy.GetMessages())以下は、CopyRaster 関数を実行する Python スクリプト サンプルです。
##====================================
##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},
## {NONE | ScalePixelValue}, {NONE | RGBToColormap}, {TIFF | IMAGINE Image |
## BMP | GIF | PNG | JPEG | JPEG2000 | Esri Grid | Esri BIL | Esri BSQ |
## Esri BIP | ENVI | CRF | MRF}, {NONE | Transform}, {CURRENT_SLICE | ALL_SLICES}, {NO_TRANSPOSE | TRANSPOSE})
import arcpy
arcpy.env.workspace = r"C:\PrjWorkspace"
##Copy to new multidimensional dataset in cloud raster format and with transpose for faster data access
arcpy.management.CopyRaster(
"SeaSurfaceTemp.nc", "SST_Transpose.crf","","",-3.402823e+38,"NONE","NONE","","NONE","NONE", "CRF", "NONE", "ALL_SLICES", "TRANSPOSE")