モザイク データセットの NoData の定義（Define Mosaic Dataset NoData） (データの管理)
サマリ
モザイク データセットに対して 1 つ以上の NoData 値を指定できます。
使用法
-
NoData は画像の周囲のピクセル値の定義に使用できます。ただし、フットプリントを再計算してこれらの境界エリアを削除するほうがより効率的にモザイク データセットを作成することができます。フットプリントを再計算するには、フットプリントを手動で編集するか、[フットプリントの構築 （Build Footprints）] ツールを使用します。
このツールは、モザイク データセット内の各ラスタ アイテムの関数チェーン内に Mask（マスク）関数を挿入します。
このツールによって挿入される Mask（マスク）関数は、関数チェーン内で Composite Bands（コンポジット バンド）関数の前に挿入されます。したがって、モザイク データセット内の各ラスタの関数チェーンに Composite Bands（コンポジット バンド）関数が含まれているか、各ラスタの関数チェーンに Composite Bands（コンポジット バンド）関数を追加するラスタ タイプのラスタ データが追加されている場合、指定した値がすべてのバンドに適用されます。
構文
| パラメータ | 説明 | データ タイプ |
in_mosaic_dataset |
モザイク データセットのパスおよび名前。 | Mosaic Layer |
num_bands |
モザイク データセット内のバンド数を定義します。 この値は、追加されるモザイク データセットに応じて自動的に設定されますが、無効にすることができます。 | Long |
bands_for_nodata_value [band {value},...] （オプション） |
各バンドまたはすべてのバンドに対して 1 つの値を定義します。各バンドに一意な NoData 値を定義するか、すべてのバンドに対して同じ値を指定できます。 このツールによって挿入される Mask（マスク）関数は、関数チェーン内で Composite Bands（コンポジット バンド）関数の前に挿入されます。したがって、モザイク データセット内の各ラスタの関数チェーンに Composite Bands（コンポジット バンド）関数が含まれているか、各ラスタの関数チェーンに Composite Bands（コンポジット バンド）関数を追加するラスタ タイプのラスタ データが追加されている場合、指定した値がすべてのバンドに適用されます。 | Value Table |
bands_for_valid_data_range [band {minimum value} {maximum value},...] （オプション） |
有効なデータのバンド数と最小および最大ピクセル値。NoData 値は、この範囲外の値ということになります。たとえば、8 ビットの画像の場合に band1=10 ～ 200 と指定すると、0 ～ 9 の値と 201 ～ 255 の値が NoData と定義されます。 このツールによって挿入される Mask（マスク）関数は、関数チェーン内で Composite Bands（コンポジット バンド）関数の前に挿入されます。したがって、モザイク データセット内の各ラスタの関数チェーンに Composite Bands（コンポジット バンド）関数が含まれているか、各ラスタの関数チェーンに Composite Bands（コンポジット バンド）関数を追加するラスタ タイプのラスタ データが追加されている場合、指定した値がすべてのバンドに適用されます。 | Value Table |
where_clause （オプション） |
SQL を使用してクエリを定義するか、[検索条件設定] を使用してクエリを作成できます。 | SQL Expression |
コードのサンプル
DefineMosaicDatasetNoData（モザイク データセットの NoData の定義）の Python サンプルを次に示します。
import arcpy
arcpy.DefineMosaicDatasetNoData_management("c:/workspace/fgdb.gdb/NoData", \
"OBJECTID=2", "3", \
"ALL_BANDS 0 9", #")
DefineMosaicDatasetNoData（モザイク データセットの NoData の定義）の Python スクリプトのサンプルを次に示します。
##===========================
##Define Mosaic Dataset Nodata
##Usage: DefineMosaicDatasetNodata_management in_mosaic_dataset num_bands
## {Band {Value};Band {Value}...} {Band {Minimum
## Value} {Maximum Value};Band {Minimum Value}
## {Maximum Value}...} {where_clause}
try:
import arcpy
arcpy.env.workspace = "C:/Workspace"
# Specify multiple Nodata values for all bands in one Catalog item
arcpy.DefineMosaicDatasetNoData_management("Nodata.gdb/md", "3", "ALL_BANDS 0 9",\
"#", "OBJECTID=2")
# Specify Nodata values for each individual band
arcpy.DefineMosaicDatasetNodata_management("Nodata.gdb/md", "3",\
"BAND_1 0;BAND_2 10;BAND_3 255", "#",\
"#")
# Specify valid value range for each band
arcpy.DefineMosaicDatasetNodata_management("Nodata.gdb/md", "3", "", \
"BAND_1 0 255;BAND_2 10 100;BAND_3 1 200",\
"#")
except:
print "Define Mosaic Dataset Nodata example failed."
print arcpy.GetMessages()