ラスタ カタログ → ラスタ データセット(Raster Catalog To Raster Dataset) (データの管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

ラスタ カタログのコンテンツを新しいラスタ データセットにモザイク化します。

使用法

構文

RasterCatalogToRasterDataset_management (in_raster_catalog, out_raster_dataset, {where_clause}, {mosaic_type}, {colormap}, {order_by_field}, {ascending}, {pixel_type}, {ColorBalancing}, {MatchingMethod}, {ReferenceRaster}, {OID})
パラメータ説明データ タイプ
in_raster_catalog

ラスタ データセットにモザイク化するラスタ カタログ。

Raster Catalog Layer
out_raster_dataset

出力ラスタ データセット モザイクの名前と拡張子。

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

  • *.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
where_clause
(オプション)

ラスタ カタログ内の特定の行を選択する場合に、該当する SQL ステートメントを入力します。

SQL Expression
mosaic_type
(オプション)

オーバーラップ エリアのモザイク化に使用するメソッド。

  • FIRSTオーバーラップ エリアの出力セル値は、その格納場所にモザイク化される最初のラスタ データセットの値になります。
  • LASTオーバーラップ エリアの出力セル値は、その格納場所にモザイク化される最後のラスタ データセットの値になります。これがデフォルトです。
  • BLENDオーバーラップ エリアの出力セル値は、オーバーラップ エリア内のセル値の水平加重計算値になります。
  • MEANオーバーラップ エリアの出力セル値は、重なり合うセル間の平均値になります。
  • MINIMUMオーバーラップ エリアの出力セル値は、重なり合うセル間の最小値になります。
  • MAXIMUMオーバーラップ エリアの出力セル値は、重なり合うセル間の最大値になります。

各モザイク オペレータの詳細については、「モザイク オペレータ」をご参照ください。

String
colormap
(オプション)

モザイク出力に適用されるカラーマップを入力ラスタから選択する際に使用するメソッド。

  • FIRST一覧にある最初のラスタ データセットのカラーマップを、出力ラスタ モザイクに適用します。これがデフォルトです。
  • LAST一覧にある最後のラスタ データセットのカラーマップを、出力ラスタ モザイクに適用します。
  • MATCHモザイク化の際に、すべてのカラーマップを考慮します。(ビット深度に対して)すべての許容値がすでに使用されている場合、対象の値とそれに最も近い有効な色とのマッチングを試みます。
  • REJECTカラーマップに関連付けられていないラスタ データセットのみを、モザイク化します。

各カラーマップ モードの詳細については、「モザイク カラーマップ モード」をご参照ください。

String
order_by_field
(オプション)

ラスタ カタログ アイテムの並べ替え基準となるフィールドを削除します。

String
ascending
(オプション)

[表示順序の並べ替え] フィールドの昇順値を使用するかどうかを選択します。[昇順] オプションがオフの場合、降順ボタンを使用します。

  • 昇順モザイク プロシージャで行の昇順を適用します。これがデフォルトです。
  • なしモザイク プロシージャで行の降順を適用します。
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
ColorBalancing
(オプション)

ドッジング手法を使用して、ラスタ カタログ アイテムの色を補正するかどうかを選択します。ラスタ カタログ内のすべてのピクセルを使用して、カラー調整アルゴリズムのガンマとコントラストの値が決定されます。

  • NONEモザイク プロシージャでカラー調整を実行しません。これがデフォルトです。
  • ColorBalancingモザイク プロシージャでカラー調整を実行します。
Boolean
MatchingMethod
(オプション)

ラスタに適用するカラー マッチング メソッドを選択します。

  • NONEこのオプションは、ラスタ データセットをモザイク化する際にカラー マッチング操作を使用しません。
  • STATISTICS_MATCHINGこのメソッドは、参照するオーバーラップ エリアとソースのオーバーラップ エリアの間の統計的な差異(最小、最大、平均)をマッチングしてから、ターゲット データセット全体に変換を適用します。
  • HISTOGRAM_MATCHINGこのメソッドは、参照するオーバーラップ エリアのヒストグラムをソースのオーバーラップ エリアとマッチングしてから、ターゲット全体に変換を適用します。
  • LINEARCORRELATION_MATCHINGこのメソッドは、重なり合うピクセルをマッチングして、残りのソースに内挿します。1 対 1 のリレーションシップを持たないピクセルには、加重平均を使用します。
String
ReferenceRaster
(オプション)

カラー マッチングを適用する場合、参照ラスタの指定方法を選択します。

  • CALCULATE_FROM_ALLすべてのラスタ カタログ アイテムに基づいて、使用する最適なラスタ データセットを計算します。
  • SPECIFY_OIDユーザは参照ラスタとして使用するラスタ カタログ アイテムのオブジェクト ID(OID)を入力します。
  • DEFINE_FROM_SELECTION選択されたラスタ カタログ アイテムに基づいて、使用する最適なラスタ データセットを計算します。
レガシーレガシー:

古いスクリプトおよびモデルによっては、引き続き古いキーワードが使用されている場合があります。ArcGIS 10.1 リリースで、このキーワードは「CALCULATE_FROM_ALL」で置換されました。当面は両方のキーワードでの運用を継続しますが、わかりやすいように、新しいキーワードに更新することを推奨します。

String
OID
(オプション)

参照ラスタのオブジェクト ID(OID)。OID はラスタ カタログ内の固有キー フィールドです。

Long

コードのサンプル

RasterCatalogToRasterDataset(ラスタ カタログ → ラスタ データセット)例 1(Python ウィンドウ)

以下は、RasterCatalogToRasterDataset(ラスタ カタログ → ラスタ データセット)ツールを実行する Python サンプルです。

import arcpy
arcpy.RasterCatalogToRasterDataset_management("c:/data/fgdb.gdb/catalog1",
                                              "c:/data/dataset.tif",
                                              "OBJECTID>1", "LAST", "FIRST",
                                              "", "", "8_BIT_UNSIGNED",
                                              "COLOR_BALANCING",
                                              "HISTOGRAM_MATCHING",
                                              "CALCULATE_FROM_ALL", "")
RasterCatalogToRasterDataset(ラスタ カタログ → ラスタ データセット)例 2(スタンドアロン スクリプト)

以下は、RasterCatalogToRasterDataset(ラスタ カタログ → ラスタ データセット)ツールを実行する Python スクリプト サンプルです。

##==================================
##Raster Catalog To Raster Dataset
##Usage: RasterCatalogToRasterDataset_management in_raster_catalog out_raster_dataset {where_clause} {LAST | FIRST | MINIMUM | MAXIMUM 
##                                               | MEAN | BLEND} {FIRST | REJECT | LAST | MATCH} {order_by_field} {NONE | ASCENDING} 
##                                               {8_BIT_UNSIGNED | 1_BIT | 2_BIT | 4_BIT | 8_BIT_SIGNED | 16_BIT_UNSIGNED | 
##                                               16_BIT_SIGNED | 32_BIT_UNSIGNED | 32_BIT_SIGNED | 32_BIT_FLOAT | 64_BIT} 
##                                               {NONE | COLOR_BALANCING} {NONE | STATISTIC_MATCHING | HISTOGRAM_MATCHING 
##                                               | LINEARCORRELATION_MATCHING} {CACULATE_FROM_ALL | SPECIFY_OID | DEFINE_FROM_SELECTION} 
##                                               {OID}
try:
    import arcpy
    arcpy.env.workspace = r"\\MyMachine\PrjWorkspace\RasGP"
    ##Mosaic a Unmanaged Raster Catalog to a TIFF format Raster Dataset with Color Correction
    arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog1","RC2RD\\dataset1.tif", "OBJECTID>1", "LAST", "FIRST", "",  "",\
                                       "8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "CALCULATE_FROM_ALL", "")
    
    ##Mosaic using the According Order of cretain Field 
    arcpy.RasterCatalogToRasterDataset_management("RC2RD\\fgdb.gdb\\catalog2","RC2RD\\dataset2.tif", "", "LAST", "FIRST", "POPULATION", \
                                       "ASCENDING", "8_BIT_UNSIGNED", "COLOR_BALANCING", "HISTOGRAM_MATCHING", "SPECIFY_OID", "2")
except:
    print "Raster Catalog To Raster Dataset example failed."
    print arcpy.GetMessages()

環境

関連トピック

ライセンス情報

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