モザイク データセット プロパティの設定(Set Mosaic Dataset Properties) (データ管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

モザイク データセットのプロパティを設定します。これらのプロパティの多くは、モザイク データセットを表示するときに使用されるデフォルトの設定や、イメージ サービスとして公開したモザイク データセットの使用方法を定義します。

使用法

構文

SetMosaicDatasetProperties_management (in_mosaic_dataset, {rows_maximum_imagesize}, {columns_maximum_imagesize}, {allowed_compressions}, {default_compression_type}, {JPEG_quality}, {LERC_Tolerance}, {resampling_type}, {clip_to_footprints}, {footprints_may_contain_nodata}, {clip_to_boundary}, {color_correction}, {allowed_mensuration_capabilities}, {default_mensuration_capabilities}, {allowed_mosaic_methods}, {default_mosaic_method}, {order_field}, {order_base}, {sorting_order}, {mosaic_operator}, {blend_width}, {view_point_x}, {view_point_y}, {max_num_per_mosaic}, {cell_size_tolerance}, {cell_size}, {metadata_level}, {transmission_fields}, {use_time}, {start_time_field}, {end_time_field}, {time_format}, {geographic_transform}, {max_num_of_download_items}, {max_num_of_records_returned}, {data_source_type}, {minimum_pixel_contribution})
パラメータ説明データ タイプ
in_mosaic_dataset

プロパティを設定するモザイク データセット。

Mosaic Layer
rows_maximum_imagesize
(オプション)

各要求でモザイク データセットによって生成される、モザイク画像のロウの最大数を設定します。

[リクエストの最大画像サイズの行] および [リクエストの最大画像サイズの列] の値を大きくすると、モザイクの処理時間が長くなります。ただし、非常に大きくて高解像度のプロットを印刷する場合は、この数値を大きくすることをお勧めします。この数値が小さすぎると、画像が表示されない場合があります。たとえば、この数値を 10 に変更すると、画像を表示するための表示ウィンドウの寸法はわずか 10 ピクセル(またはそれ以下)になります。

Long
columns_maximum_imagesize
(オプション)

各要求でモザイク データセットによって生成される、モザイク画像のカラムの最大数を設定します。

[リクエストの最大画像サイズの行] および [リクエストの最大画像サイズの列] の値を大きくすると、モザイクの処理時間が長くなります。ただし、非常に大きくて高解像度のプロットを印刷する場合は、この数値を大きくすることをお勧めします。この数値が小さすぎると、画像が表示されない場合があります。たとえば、この数値を 10 に変更すると、画像を表示するための表示ウィンドウの寸法はわずか 10 ピクセル(またはそれ以下)になります。

Long
allowed_compressions
[allowed_compressions,...]
(オプション)

モザイク データセットの [許可される送信圧縮] プロパティを設定します。モザイク画像をコンピュータからディスプレイ(またはサーバからクライアントに)送信する際に使用する圧縮方法を定義します。

  • None圧縮を使用しません。
  • JPEGJPEG 圧縮を使用します。
  • LZWLZW 圧縮を使用します。
  • LERCLERC(Limited Error Raster Compression)を使用します。
String
default_compression_type
(オプション)

デフォルトの圧縮タイプを設定します。デフォルトの圧縮は、allowed_compressions リストに指定するか、モザイク データセットの [許可される圧縮方法] プロパティに設定しておく必要があります。

String
JPEG_quality
(オプション)

JPEG 圧縮を使用する場合の圧縮品質を設定します。圧縮品質は 1 ~ 100 の範囲です。値が大きいほど画像の品質は高くなりますが、圧縮率は低下します。

Long
LERC_Tolerance
(オプション)

LERC 圧縮方法を使用する場合、LERC 許容値を指定します。許容値は、1 ピクセルあたりに適用可能な最大エラー値を示します(画像の平均ではありません)。この値は、モザイク データセットの単位で指定します。たとえば、エラーが 10 cm でモザイク データセットがメートル単位である場合は、「0.1」と入力します。

LERC は、ピクセル深度が高いデータ(浮動小数点、32 ビット、16 ビット、12 ビットのデータなど)にお勧めの効率的な非可逆圧縮方法です。LERC は、LZ77 に比べ、浮動小数点データの圧縮率に優れ(5 ~ 10 倍)、圧縮速度も速くなります(5 ~ 10 倍)。整数データの圧縮率も向上します。

整数データを使用し、指定された誤差の限界値が 0.99 以下の場合、LERC は可逆圧縮とみなされます。

Double
resampling_type
(オプション)

モザイク画像を表示する際のデフォルトのリサンプリング方法を設定します。

  • NEAREST最近隣内挿法リサンプリング手法が使用されます。
  • BILINEAR共一次内挿法リサンプリング手法が使用されます。
  • CUBIC三次たたみ込み内挿法リサンプリング手法が使用されます。
  • MAJORITY最頻値リサンプリング手法が使用されます。
String
clip_to_footprints
(オプション)

各ラスタの範囲をフットプリントに制限するか、ラスタ全体を使用してモザイク画像を作成するかを指定します。多くの場合、ラスタとフットプリントは同じですが、これらが異なる場合はラスタをクリップするかどうかを指定できます。

  • NOT_CLIPラスタをフットプリントにクリップしません。これはデフォルト設定です。
  • CLIPラスタをフットプリントにクリップします。
Boolean
footprints_may_contain_nodata
(オプション)

モザイク データセットのフットプリントに NoData のピクセルが含まれるかどうかを指定します。

  • FOOTPRINTS_MAY_CONTAIN_NODATAフットプリントに NoData のピクセルが含まれます。モザイク データセットに確実にホールが存在しないようにするには、これをオンにします。これはデフォルト設定です。
  • FOOTPRINTS_DO_NOT_CONTAIN_NODATAフットプリントに NoData のピクセルが含まれません。この設定を指定すると、パフォーマンスが少し向上する可能性があります。ただし、フットプリントに NoData のピクセルが存在すると、モザイク データセットにホールが表示されます。
Boolean
clip_to_boundary
(オプション)

モザイク データセットの画像を境界線でクリップするか、モザイク画像全体を表示するかを指定します。多くの場合、境界線はモザイク データセット全体を表しますが、データセットの一部を除外するように変更できます。

  • CLIP モザイク画像を境界線でクリップします。これはデフォルト設定です。
  • NOT_CLIPモザイク画像を境界線でクリップしません。
Boolean
color_correction
(オプション)

モザイク データセットに対して設定されているカラー補正を有効にするかどうかを選択します。

  • NOT_APPLYカラー補正をオフのままにします。これはデフォルト設定です。
  • APPLYモザイク データセットに対して設定されているカラー補正を使用します。
Boolean
allowed_mensuration_capabilities
[allowed_mensuration_capability,...]
(オプション)

このモザイク データセットで許可する計測機能を選択します。

  • None計測機能を許可しません。
  • Basic距離、ポイント、重心、および面積の計算を許可します。
  • Base-Top Height底面から最上部の高さの計測を許可します。[底面と最上部による高さ] の計測を実行するには、RPC(Rational Polynomial Coefficients)情報が必要です。
  • Base-Top Shadow Height底面と影による高さの計測を許可します。[底面と影による高さ] の計測を実行するには、太陽方位と太陽高度の情報が必要です。
  • Top-Top Shadow Height最上部と影による高さの計測を許可します。この計測を実行するには、太陽方位、太陽高度、および RPC(Rational Polynomial Coefficients)の情報が必要です。
  • 3DDEM が使用可能である場合に、3D 計測を許可します。
String
default_mensuration_capabilities
(オプション)

このモザイク データセットのデフォルトの計測機能を選択します。デフォルトは [allowed_mensuration_capabilities] パラメータ リストに設定するか、モザイク データセットの [計測機能] プロパティに設定しておく必要があります。

String
allowed_mosaic_methods
[allowed_mosaic_method,...]
(オプション)

このモザイク データセットで許可するモザイク手法を選択します。モザイク画像は多数の入力ラスタから作成できます。モザイク手法は、モザイク データセット内の異なるラスタからモザイク画像を作成する方法を定義します。

  • Noneモザイク データセットの属性テーブル内の順序(ObjectID)に基づいてラスタを並べ替えます。
  • 中央デフォルトの順序に基づいてラスタを並べ替えます。中心がビューの中央に最も近いラスタが上に配置されます。
  • 北西ビューとは関係なくラスタを並べ替えます。北西に中心を持つラスタが上に表示されます。
  • ラスタをロックユーザは、ObjectID に基づいて、単一または複数のラスタの表示をロックすることができます。
  • 属性による定義されたメタデータ属性と、基準値からの差異に基づいてラスタを並べ替えることができます。
  • 天底に最も近い天底の位置とビューの中央の間の距離に基づいてラスタを並べ替えます。これは、[中心に最も近い] 手法に似ていますが、ラスタに対する天底の位置を使用します。この位置は、特に傾斜した画像においては中心にならない可能性があります。
  • 観測点[観測点] ツールを使用して、ラスタのユーザ定義位置と天底の位置に基づいてラスタを並べ替えます。
  • Seamline継ぎ目(シーム)に沿ったオプションのフェザリングを使用して、ラスタごとにあらかじめ定義されたシームライン シェープでラスタを切り取ります。この順序は、シームライン生成時にあらかじめ定義されます。このモザイク方法では、[最後] モザイク操作を実行できません。
String
default_mosaic_method
(オプション)

このモザイク データセットのデフォルトのモザイク手法を選択します。デフォルトは allowed_mosaic_methods パラメータ リストに設定するか、モザイク データセットの [許可されるモザイク手法] プロパティに設定しておく必要があります。

String
order_field
(オプション)

[属性による] モザイク手法を使用してラスタを並べ替えるときに使用する、デフォルトのフィールドを選択します。属性テーブル内でタイプがメタデータおよび整数として定義されているフィールドが、リスト表示されます。このリストには次のフィールドが含まれます(これら以外のフィールドが含まれる場合もあります)。

  • Name
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Tag
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

数値または日付フィールドでは、[ベース順序] パラメータを設定する必要があります。

[属性による] モザイク手法が許可されていない場合、このパラメータは必要ありません。

String
order_base
(オプション)

画像は、この値との差に基づいて、または属性テーブルの [順序フィールド] のその他の値に基づいて並べ替えられます。

日付属性を使用する場合、次のいずれかの形式で指定する必要があります。

  • YYYY/MM/DD HH:mm:ss.s
  • YYYY/MM/DD HH:mm:ss
  • YYYY/MM/DD HH:mm
  • YYYY/MM/DD HH
  • YYYY/MM/DD
  • YYYY/MM
  • YYYY

[allowed_mosaic_method] パラメータで [属性による] を指定する場合のみ、このパラメータを指定する必要があります。

String
sorting_order
(オプション)

ラスタを昇順と降順のどちらで並べ替えるかを選択します。

  • ASCENDINGラスタを昇順で並べます。これがデフォルトの設定です。
  • DESCENDINGラスタを降順で並べます。

[allowed_mosaic_method] パラメータで [属性による] を指定する場合のみ、このパラメータを指定する必要があります。

Boolean
mosaic_operator
(オプション)

オーバーラップするセルの解決に使用するモザイク オペレータを選択します。

  • FIRSTオーバーラップ領域には、ソースに表示された最初のラスタ データセットから取得したセルが含まれます。
  • LASTオーバーラップ領域には、ソースに表示された最後のラスタ データセットから取得したセルが含まれます。
  • MINオーバーラップ領域には、重なっているすべてのセルから取得したセルの最小値が含まれます。
  • MAXオーバーラップ領域には、重なっているすべてのセルから取得したセルの最大値が含まれます。
  • MEANオーバーラップ領域には、重なっているすべてのセルから取得したセルの平均値が含まれます。
  • BLENDオーバーラップ領域は、モザイク画像の各ラスタ データセットのエッジに沿って重なるセル値のブレンドになります。デフォルトでは、エッジは各ラスタのフットプリントまたはシームラインによって定義されます。
  • SUMオーバーラップ領域は、重なっているすべてのセルから同時に追加されるすべてのセル値の合計ピクセル値になります。
String
blend_width
(オプション)

[モザイク オペレータ] で [BLEND] を指定するときに使用するピクセル単位の距離を(表示縮尺で)定義します。

Long
view_point_x
(オプション)

表示の中心を計算する際に使用する X オフセットを定義します。この値は、モザイク データセットの空間参照系の単位で計算されます。

この値は、[許可されるモザイク手法] に [観測点] を指定するときのみに使用されます。

Double
view_point_y
(オプション)

表示の中心を計算する際に使用する Y オフセットを定義します。この値は、モザイク データセットの空間参照系の単位で計算されます。

この値は、[許可されるモザイク手法] に [観測点] を指定するときのみに使用されます。

Double
max_num_per_mosaic
(オプション)

モザイク画像の作成に使用できるラスタの最大数。

Long
cell_size_tolerance
(オプション)

許容値ファクタは 0.0 以上である必要があります。

ファクタが 0.1 の場合、ピクセル(セル)サイズを使用するツールおよび操作において、最小のピクセル サイズより 10 パーセント大きいすべての LowPS 値が同一であるとみなされます。

Double
cell_size
(オプション)

セル サイズ テンプレートとしてレイヤを選択するか、実際のセル サイズを指定します。セル サイズを指定する場合は、正方形のセル サイズでは 1 つの値を使用し、長方形のセル サイズでは X および Y 値を使用します。

Cell Size XY
metadata_level
(オプション)

モザイク データセットを公開するときに、サーバからクライアントに公開するメタデータのレベルを選択します。

  • FULL基本的なラスタ データセット情報と関数チェーンの詳細を含む、すべてのメタデータが送信されます。これはデフォルト設定です。
  • NONEメタデータはクライアントに公開されません。
  • BASICラスタ データセット レベルの情報が送信されます。行と列、セル サイズ、空間参照情報などです。
String
transmission_fields
[transmission_field,...]
(オプション)

ユーザがアクセスできるフィールドを選択します。このリストには、デフォルトではモザイク データセットの属性テーブルに追加されないフィールドも含めることができます。デフォルトでは、次のフィールドがリストに含まれます。

  • Name
  • MinPS
  • MaxPS
  • LowPS
  • HighPS
  • Tag
  • GroupName
  • ProductName
  • CenterX
  • CenterY
  • ZOrder
  • Shape_Length
  • Shape_Area

String
use_time
(オプション)

モザイク データセットを時間対応にするかどうかを指定します。時間を有効にする場合は、開始および終了フィールドと、日時形式を指定する必要があります。

  • DISABLEDモザイク データセットを時間対応にしません。これはデフォルト設定です。
  • ENABLEDモザイク データセットを時間対応にします。これにより、クライアントでタイム スライダを使用できるようになります。
Boolean
start_time_field
(オプション)

開始時間として使用する属性テーブルのフィールド。

String
end_time_field
(オプション)

終了時間として使用する属性テーブルのフィールド。

String
time_format
(オプション)

時間フィールドの形式。

  • YYYY
  • YYYYMM年と月
  • YYYY/MM年と月
  • YYYY-MM年と月
  • YYYYMMDD年、月、および日
  • YYYY/MM/DD年、月、および日
  • YYYY-MM-DD年、月、および日
  • YYYYMMDDhhmmss年、月、日、時、分、および秒
  • YYYY/MM/DD hh:mm:ss年、月、日、時、分、および秒
  • YYYY-MM-DD hh:mm:ss年、月、日、時、分、および秒
  • YYYYMMDDhhmmss.s年、月、日、時、分、秒、および 1/10 秒
  • YYYY/MM/DD hh:mm:ss.s年、月、日、時、分、秒、および 1/10 秒
  • YYYY-MM-DD hh:mm:ss.s年、月、日、時、分、秒、および 1/10 秒
String
geographic_transform
[geographic_transform,...]
(オプション)

このモザイク データセットに関連付ける地理座標系変換を選択します。

String
max_num_of_download_items
(オプション)

1 回のリクエストでダウンロードできるアイテムの最大数を選択します。

Long
max_num_of_records_returned
(オプション)

1 回のリクエストで返される最大レコード数を選択します。

Long
data_source_type
(オプション)

モザイク データセットのデータ ソース タイプを選択します。

  • GENERICモザイク データセットのデータ タイプは指定されません。
  • THEMATICモザイク データセットは主題です。主題データの値は不連続です。
  • PROCESSEDモザイク データセットは処理されます。モザイク データセットはすでに色調整されています。
  • ELEVATIONモザイク データセットには、標高データが含まれています。
String
minimum_pixel_contribution
(オプション)

モザイク データセットをモザイク データセットで使用するときに十分有意であるとみなせるために必要な最小ピクセル数を選択します。

このプロパティを使用することで、モザイク データセットは、有意な数のピクセルが使用されていないラスタ アイテムをスキップすることができます。このようなモザイク データセット アイテムをスキップすると、計算や表示を実行するときにモザイク データセットのパフォーマンスが向上します。これは、ほんのわずかなピクセルしか使用されていないラスタが多数重なり合っている場合に特に便利です。

Long

コードのサンプル

SetMosaicDatasetProperties(モザイク データセット プロパティの設定)の例 1(Python ウィンドウ)

以下は、SetMosaicDatasetProperties(モザイク データセット プロパティの設定)を実行する Python サンプルです。

import arcpy
arcpy.SetMosaicDatasetProperties_management(
    "c:/workspace/mdproperties.gdb/md", cell_size="0.2", metadata_level="BASIC", 
    transmission_fields="NAME;MINPS;MAXPS;GROUPNAME;PRODUCTNAME;ZORDER;YEARS;YEARE", 
    use_time="ENABLED", start_time_field="YEARS", end_time_field="YEARE", 
    time_format="YYYYMM", geographic_transform=
    "NAD_1983_HARN_To_WGS_1984_2", max_num_of_download_items="10", 
    max_num_of_records_returned="500", source_type="GENERIC", 
    minimum_pixel_contribution="50")
SetMosaicDatasetProperties(モザイク データセット プロパティの設定)の例 2(スタンドアロン スクリプト)

以下は、SetMosaicDatasetProperties(モザイク データセット プロパティの設定)を実行する Python スクリプト サンプルです。

#Set mosaic dataset imagery properties group

import arcpy
arcpy.env.workspace = "C:/Workspace"

arcpy.SetMosaicDatasetProperties_management(
    "mdproperties.gdb/md", "525340", "3909809", "None;JPEG", "JPEG",
    "85", "0.5", "CUBIC", "CLIP", "FOOTPRINTS_MAY_CONTAIN_NODATA",
    "NOT_CLIP", "APPLY", "Base-Top Height;Top-Top Shadow Height",
    "Base-Top Height")

環境

このツールはジオプロセシング環境を使用していません

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ×
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
7/28/2014