ラベル | 説明 | データ タイプ |
入力ラスター | 新しい投影法に変換するラスター データセット。 | Mosaic Layer; Raster Layer |
出力ラスター データセット | 作成する新しい投影法を含むラスター データセット。 ラスター データセットをファイル形式で格納する場合は、次のようにファイル拡張子を指定します。
ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。 ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、TIFF 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。 | Raster Dataset |
出力座標系 | 新しいラスター データセットの座標系。 | Coordinate System |
リサンプリング手法 (オプション) | 使用するリサンプリング手法を指定します。 デフォルトは [最近隣内挿法] です。 [最近隣内挿法] オプションと [最頻値] オプションは、土地利用分類などのカテゴリ データに使用されます。 [最近隣内挿法] オプションがデフォルトです。 最も高速であり、ピクセル値を変更しません。 これらのオプションを標高サーフェスなどの連続データに使用しないでください。 [共一次内挿法] オプションと [三次たたみ込み内挿法] オプションは、連続データに最も適しています。 ピクセル値が変更される可能性があるため、これらのオプションをカテゴリ データに使用しないことをお勧めします。
| String |
出力セル サイズ (オプション) | 既存のラスター データセットを使用するか、幅 (x) と高さ (y) を指定することによって、新しいラスターのセル サイズを設定します。 | Cell Size XY |
地理座標系変換 (オプション) | 投影法をある地理座標系または測地基準系から別のものに変更するときの地理座標変換。 入力座標系と出力座標系に異なる測地基準系が使用されている場合、地理座標系変換が必要です。 | String |
登録ポイント (オプション) | 出力セルをアンカー位置にするための左下のポイント。 登録ポイントはコーナー座標である必要はなく、ラスター データセット内に収まる必要もありません。 スナップ対象ラスター環境設定は、[登録ポイント] パラメーターよりも優先的に使用されます。 登録ポイントを設定するには、スナップ対象ラスター環境が設定されていないことを確認します。 | Point |
入力データの座標系 (オプション) | 入力ラスター データセットの座標系。 このパラメーターは、入力の座標系が不明の場合にのみ有効になります。 その場合、ラスター レイヤーの現在の座標系を指定します。 | Coordinate System |
鉛直 (オプション) | 鉛直座標変換を適用するかどうかを指定します。 このオプションは、入力および出力座標系が鉛直座標系を持ち、入力ラスターの座標が Z 値を持つ場合に有効です。 このパラメーターがオンの場合、[地理座標系変換] パラメーターは、楕円体変換と、鉛直測地基準系間の変換を含むことができます。 たとえば、~NAD_1983_To_NAVD88_CONUS_GEOID12B_Height + NAD_1983_To_WGS_1984_1 は、NAD 1983 測地基準系と NAVD 1988 の高度で定義されたジオメトリ頂点を、WGS84 楕円体 (楕円体の高さを表す Z 値を持つ) 上の頂点に変換します。 チルド (~) は、変換が反対方向であることを示しています。
多くの鉛直座標変換では、ArcGIS Coordinate Systems Data インストール パッケージを使用して、追加のデータ ファイルがインストールされている必要があります。 | Boolean |
使用法
ラスター データの投影方法は、座標系によって定義されます。 データに同じ座標系を使用して、すべてのデータが同じ投影に含まれるようにすることができます。
ラスター データセットは、共一次内挿近似法を使用して、ラスター データセットを新しい空間参照に投影変換されます。これにより、ピクセルを粗いメッシュ グリッドに投影変換し、ピクセル間に共一次内挿法を使用します。
このツールの誤差範囲は 1/2 ピクセル未満です。
ファイルを作成せずに変換を適用するには、[幾何補正 (Warp)] ツールを使用します。
既存の空間参照を使用、別のデータセットからインポート、または作成ができます。
このツールが出力できるのは、正方形のピクセル サイズのみです。
出力は、BIL、BIP、BMP、BSQ、DAT、Esri Grid、GIF、IMG、JPEG、JPEG 2000、PNG、TIFF、MRF、CRF 形式、または任意のジオデータベース ラスター データセットに保存することができます。
ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。
[最近隣内挿法] オプションは、最近隣内挿法を実行する、4 つの内挿法の中で最も高速の選択肢です。 この方法は、ピクセル値を変更しないため、主に土地利用分類などのカテゴリ データに使用されます。 標高サーフェスなどの連続データに使用することはできません。
[共一次内挿法] オプションは、共一次内挿法を使用し、周囲の最も近い 4 つのセルの加重距離平均に基づいて、ピクセルの新しい値を決定します。 [三次たたみ込み内挿法] オプションは、三次たたみ込み内挿法を使用し、周囲のポイントの間を通る滑らかなカーブを適合して、ピクセルの新しい値を決定します。 これらは連続データに対する最も適切な選択ですが、スムージングが発生する場合があります。 三次たたみ込み内挿法は、入力ラスターの範囲外の値を含んだ出力ラスターを生成することがあります。 望ましくない異なるピクセル値が生じる可能性があるため、これらのオプションをカテゴリ データに使用しないでください。
ラスター データセットのセルは矩形で、マップ座標空間内では等面積ですが、地表面上にセルで表される形状と面積はラスター全体で一定になることはありません。 これは、地図投影では形状と面積の両方を同時に保持できないためです。 セルで表される面積は、ラスター全体では異なります。 そのため、出力ラスター内のセル サイズ、行数および列数が変動することがあります。
球面 (緯度 - 経度) 座標と平面座標系間に投影変換を行う場合と、適当なセル サイズが不明なとき以外は、常に出力セル サイズを指定してください。
出力ラスターのデフォルトのセル サイズは、出力ラスターの中心位置の投影セル サイズに基づいて計算されます。 これは通常、厳密な縮尺における中央子午線と緯度の交差部であり、歪みがもっとも少ない領域です。 入力ラスターの境界を投影変換すると、最小範囲と最大範囲に基づいて出力ラスターのサイズが決まります。 セルの値を計算するために、各セルを元の入力座標系に投影変換します。
入力座標系と出力座標系に同じ測地基準系が使用されている場合、地理座標系変換はオプション パラメーターです。 入力測地基準系と出力測地基準系が異なる場合は、地理座標系変換の指定が必須になります。
登録ポイントを使用して、出力セルを固定する原点に指定することができます。 出力セルはすべて、登録ポイントを基点とするセル サイズに等しい間隔になります。 登録ポイントはコーナー座標である必要はなく、ラスター データセット内に収まる必要もありません。 環境設定でスナップ対象ラスターが設定してある場合、登録ポイントは無視されます。
デフォルト回転楕円面は CLARKE 1866 です。NEWZEALAND_GRID など、投影変換に固有のものでない場合、SPHEROID サブコマンドを使用して別の値を指定してください。
両方が設定されている場合、優先的に使用されるのは、登録ポイントでなくスナップ ラスター設定のほうです。
鉛直座標変換を行うには、ダイアログ ボックスでオプションの [鉛直] パラメーターをオンにします。 デフォルトでは、[鉛直] パラメーターは、入力座標系と出力座標系に鉛直座標系 (VCS) があり、入力フィーチャクラスの座標に Z 値がある場合にのみ使用できます。 また、追加データ (座標系データ) のセットアップをシステムにインストールする必要があります。
出力座標系を指定する場合は、地理または投影座標系と鉛直座標系の両方を指定できます。 入力と出力の鉛直座標系が異なる場合は、適切な鉛直座標変換とオプションの地理座標系 (測地基準系) 変換を使用できます。 定義と反対方向に変換を適用する必要がある場合、名前の前にチルド (~) があるエントリを選択します。
このツールでは多次元ラスター データをサポートします。多次元ラスターの各スライスでこのツールを実行して多次元ラスター出力を生成するには、出力を CRF に保存してください。
サポートされている入力多次元データセット タイプには、多次元ラスター レイヤー、モザイク データセット、イメージ サービスおよび CRF が含まれます。
パラメーター
arcpy.management.ProjectRaster(in_raster, out_raster, out_coor_system, {resampling_type}, {cell_size}, {geographic_transform}, {Registration_Point}, {in_coor_system}, {vertical})
名前 | 説明 | データ タイプ |
in_raster | 新しい投影法に変換するラスター データセット。 | Mosaic Layer; Raster Layer |
out_raster | 作成する新しい投影法を含むラスター データセット。 ラスター データセットをファイル形式で格納する場合は、次のようにファイル拡張子を指定します。
ジオデータベースにラスター データセットを格納する場合、ラスター データセットの名前にファイル拡張子は付けません。 ラスター データセットを JPEG 形式のファイル、JPEG 2000 形式のファイル、TIFF 形式のファイル、またはジオデータベースに格納するときに、ジオプロセシング環境内で [圧縮タイプ] の値と [圧縮品質] の値を指定できます。 | Raster Dataset |
out_coor_system | 新しいラスター データセットの座標系。 このパラメーターの有効値は、次のとおりです。
| Coordinate System |
resampling_type (オプション) | 使用するリサンプリング手法を指定します。 デフォルトは [最近隣内挿法] です。
[最近隣内挿法] オプションと [最頻値] オプションは、土地利用分類などのカテゴリ データに使用されます。 [最近隣内挿法] オプションがデフォルトです。 最も高速であり、ピクセル値を変更しません。 これらのオプションを標高サーフェスなどの連続データに使用しないでください。 [共一次内挿法] オプションと [三次たたみ込み内挿法] オプションは、連続データに最も適しています。 ピクセル値が変更される可能性があるため、これらのオプションをカテゴリ データに使用しないことをお勧めします。 | String |
cell_size (オプション) | 既存のラスター データセットを使用するか、幅 (x) と高さ (y) を指定することによって、新しいラスターのセル サイズを設定します。 | Cell Size XY |
geographic_transform [geographic_transform,...] (オプション) | 投影法をある地理座標系または測地基準系から別のものに変更するときの地理座標変換。 入力座標系と出力座標系に異なる測地基準系が使用されている場合、地理座標系変換が必要です。 | String |
Registration_Point (オプション) | 出力セルをアンカー位置にするための左下のポイント。 登録ポイントはコーナー座標である必要はなく、ラスター データセット内に収まる必要もありません。 スナップ対象ラスター環境設定は、[登録ポイント] パラメーターよりも優先的に使用されます。 登録ポイントを設定するには、スナップ対象ラスター環境が設定されていないことを確認します。 | Point |
in_coor_system (オプション) | 入力ラスター データセットの座標系。 このパラメーターは、入力の座標系が不明の場合にのみ有効になります。 その場合、ラスター レイヤーの現在の座標系を指定します。 | Coordinate System |
vertical (オプション) | 鉛直座標変換を適用するかどうかを指定します。 このパラメーターは、入力および出力座標系が鉛直座標系を持ち、入力フィーチャクラスの座標が z 値を持つ場合に有効になります。 キーワード VERTICAL を使用した場合、geographic_transform パラメーターは、楕円体変換と、鉛直測地基準系間の変換を含むことができます。 たとえば、“~NAD_1983_To_NAVD88_CONUS_GEOID12B_Height + NAD_1983_To_WGS_1984_1” は、NAD 1983 測地基準系と NAVD 1988 の高度で定義されたジオメトリ頂点を、WGS84 楕円体 (楕円体の高さを表す Z 値を持つ) 上の頂点に変換します。 チルド (~) は、変換が反対方向であることを示しています。
多くの鉛直座標変換では、ArcGIS Coordinate Systems Data インストール パッケージを使用して、追加のデータ ファイルがインストールされている必要があります。 | Boolean |
コードのサンプル
以下は、ProjectRaster 関数を実行する Python サンプルです。
import arcpy
from arcpy import env
arcpy.ProjectRaster_management("c:/data/image.tif", "c:/output/reproject.tif",\
"World_Mercator.prj", "BILINEAR", "5",\
"NAD_1983_To_WGS_1984_5", "#", "#")
以下は、ProjectRaster 関数を実行する Python スクリプト サンプルです。
##====================================
##Project Raster
##Usage: ProjectRaster_management in_raster out_raster out_coor_system {NEAREST | BILINEAR
## | CUBIC | MAJORITY} {cell_size} {geographic_transform;
## geographic_transform...} {Registration_Point} {in_coor_system}
import arcpy
arcpy.env.workspace = r"C:/Workspace"
##Reproject a TIFF image with Datumn transfer
arcpy.ProjectRaster_management("image.tif", "reproject.tif", "World_Mercator.prj",\
"BILINEAR", "5", "NAD_1983_To_WGS_1984_5", "#", "#")
##Reproject a TIFF image that does not have a spatial reference
##Set snapping point to the top left of the original image
snapping_pnt = "1942602 304176"
arcpy.ProjectRaster_management("nosr.tif", "project.tif", "World_Mercator.prj", "BILINEAR",\
"5", "NAD_1983_To_WGS_1984_6", snapping_pnt,\
"NAD_1983_StatePlane_Washington_North.prj")
環境
ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes