モザイク データセットの NoData の定義(Define Mosaic Dataset NoData) (データの管理)
サマリ
モザイク データセットに対して 1 つ以上の NoData 値を指定できます。
使用法
-
NoData は画像の周囲のピクセル値の定義に使用できます。ただし、フットプリントを再計算してこれらの境界エリアを削除するほうがより効率的にモザイク データセットを作成することができます。フットプリントを再計算するには、フットプリントを手動で編集するか、[フットプリントの構築(Build Footprints)] ツールを使用します。
[NoData 値のバンド] パラメータで複数の NoData 値を指定することができます。NoData として定義する各値をスペースで区切ります。
このツールは、モザイク データセット内の各ラスタ アイテムの関数チェーン内に Mask(マスク)関数を挿入します。
このツールによって挿入される Mask(マスク)関数は、関数チェーン内で Composite Bands(コンポジット バンド)関数の前に挿入されます。したがって、モザイク データセット内の各ラスタの関数チェーンに Composite Bands(コンポジット バンド)関数が含まれているか、各ラスタの関数チェーンに Composite Bands(コンポジット バンド)関数を追加するラスタ タイプのラスタ データが追加されている場合、指定した値がすべてのバンドに適用されます。
構文
パラメータ | 説明 | データ タイプ |
in_mosaic_dataset |
モザイク データセットのパスおよび名前。 | Mosaic Layer |
num_bands |
モザイク データセット内のバンド数を定義します。 この値は、追加されるモザイク データセットに応じて自動的に設定されますが、無効にすることができます。 | Long |
bands_for_nodata_value [band {NoData value},...] (オプション) |
各バンドまたはすべてのバンドに対して値を定義します。各バンドに一意な NoData 値を定義するか、すべてのバンドに対して同じ値を指定できます。各バンド選択に対して複数の NoData 値を定義する場合は、[bands_for_nodata_value] パラメータ内で各 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 |
Composite_nodata_value (オプション) | ピクセルに NoData のタグを付ける際に、すべてのバンドが NoData である必要があるかどうかを選択します。
| Boolean |
コードのサンプル
DefineMosaicDatasetNoData(モザイク データセットの NoData の定義)の Python サンプルを次に示します。
import arcpy
arcpy.DefineMosaicDatasetNodata_management(
"c:/workspace/Nodata.gdb/md", "3", "ALL_BANDS '0 9'", "#",
"OBJECTID=2", "COMPOSITE_NODATA")
DefineMosaicDatasetNoData(モザイク データセットの NoData の定義)の Python スクリプトのサンプルを次に示します。
#Specify multiple Nodata values for all bands in one Catalog item
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "Nodata.gdb/md"
noofbands = "3"
nodataval = "ALL_BANDS '0 9'"
nodatarange = "#"
query = "OBJECTID=2"
mode = "#"
arcpy.DefineMosaicDatasetNoData_management(mdname, noofbands, nodataval,
nodatarange, query, mode)