モザイク データセットの NoData の定義 (Define Mosaic Dataset NoData) (データ管理)

概要

NoData として表現される 1 つまたは複数の値を指定します。

使用法

  • NoData は画像の周囲のピクセル値の定義に使用できます。ただし、フットプリントを再計算してこれらの境界エリアを削除するほうがより効率的にモザイク データセットを作成することができます。フットプリントを再計算するには、フットプリントを手動で編集するか、[フットプリントの構築 (Build Footprints)] ツールを使用します。

  • [NoData 値のバンド] パラメーターで複数の NoData 値を指定することができます。NoData として定義する各値をスペースで区切ります。

  • このツールは、モザイク データセット内の各ラスター アイテムの関数チェーン内に Mask (マスク) 関数を挿入します。

構文

arcpy.management.DefineMosaicDatasetNoData(in_mosaic_dataset, num_bands, {bands_for_nodata_value}, {bands_for_valid_data_range}, {where_clause}, {Composite_nodata_value})
パラメーター説明データ タイプ
in_mosaic_dataset

NoData 値を更新するモザイク データセット。

Mosaic Layer
num_bands

モザイク データセット内のバンド数。

Long
bands_for_nodata_value
[band {NoData value},...]
(オプション)

各バンドまたはすべてのバンドに対して値を定義します。各バンドに一意な NoData 値を定義するか、すべてのバンドに対して同じ値を指定できます。各バンド選択に対して複数の NoData 値を定義する場合は、bands_for_nodata_value パラメーター内で各 NoData 値をスペースで区切ります。

このツールによって挿入されるマスク関数は、関数チェーン内でコンポジット バンド関数の前に挿入されます。したがって、モザイク データセット内の各ラスターの関数チェーンにコンポジット バンド関数が含まれているか、各ラスターの関数チェーンにコンポジット バンド関数を追加するラスター タイプのラスター データが追加されている場合、指定した値がすべてのバンドに適用されます。

Value Table
bands_for_valid_data_range
[band {minimum value} {maximum value},...]
(オプション)

各バンドに表示する値の範囲を指定します。この範囲にない値は、NoData として分類されます。コンポジット バンドを操作している場合、範囲はすべてのバンドに適用されます。

Value Table
where_clause
(オプション)

モザイク データセット内の特定のラスターを選択する SQL ステートメント。選択したラスターだけが、NoData 値が変更されます。

SQL Expression
Composite_nodata_value
(オプション)

ピクセルを NoData として分類する際に、すべてのバンドが NoData である必要があるかどうかを選択します。

  • NO_COMPOSITE_NODATAいずれかのバンドに NoData のピクセルがある場合、ピクセルは NoData として分類されます。これがデフォルトです。
  • COMPOSITE_NODATAピクセルを NoData として分類するには、すべてのバンドに NoData のピクセルが必要です。
Boolean

派生した出力

名前説明データ タイプ
out_mosaic_dataset

更新されたモザイク データセット。

モザイク レイヤー

コードのサンプル

DefineMosaicDatasetNoData (モザイク データセットの NoData の定義) の例 1 (Python ウィンドウ)

以下は、DefineMosaicDatasetNoData を実行する Python のサンプルです。

import arcpy
arcpy.DefineMosaicDatasetNodata_management(
     "c:/workspace/Nodata.gdb/md", "3",  "ALL_BANDS '0 9'", "#", 
     "OBJECTID=2",  "COMPOSITE_NODATA")
DefineMosaicDatasetNoData (モザイク データセットの NoData の定義) の例 2 (スタンドアロン スクリプト)

以下は、DefineMosaicDatasetNoData を実行する 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)

環境

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック