ニブル (Nibble) (Spatial Analyst)

Spatial Analyst のライセンスで利用可能。

サマリー

最近傍セル値でマスクに対応するラスターのセル値を置換します。

ニブル ツールの詳細

ニブル ツールの図
OutRas = Nibble(InRas1, Mask_Ras)

使用法

  • [ニブル (Nibble)] ツールを使用すると、ラスターのエリアを選択し、そのエリアに最近傍の値を割り当てることができます。 このツールを使用すると、いくつかの個別セルを、最も近い近傍値に置換できます。 マスク エリアが大きくなれば、広範囲のセルを置換できます。

    データがエラーであることが分かっているラスターのエリアを編集するときによく使われる方法です。

  • 入力マスク ラスターで NoData となるセルは、置き換えられるセルを定義します。 マスク エリア内にない入力ラスターのロケーションは置き換えられないため、その出力値は入力値と同じになります。

    マスク内にない入力ラスターの NoData セルは置き換えられません。 そのようなセルは、2 つの NoData パラメーターの設定に関係なく、NoData のままとなります。

  • このツールは、並列処理をサポートしています。 お使いのコンピューターに、複数のプロセッサや、複数のコアを持つプロセッサが搭載されている場合は、特に対象となるデータセットが大きいときにパフォーマンスが向上します。 「Spatial Analyst による並列処理」ヘルプ トピックには、この機能と設定方法の詳細が記載されています。

    並列処理を使用する場合、処理中のデータ チャンクを処理するために一時データが書き込まれます。 デフォルトの一時フォルダーの場所は、ローカルの C ドライブ上です。 このフォルダーの場所は、TempFolders という名前のシステム環境変数を設定し、使用するフォルダーへのパスを指定することで変更できます (例: E:\RasterCache)。 コンピューターに対して管理者権限がある場合は、レジストリ キーも使用できます (例: [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster])。

    デフォルトでは、このツールは使用可能なコアの 50% を使用します。 入力データのサイズが 5,000 セル x 5,000 セルよりも小さい場合、使用されるコア数はそれよりも少なくなります。 並列処理ファクター環境で、ツールが使用するコアの数を制御できます。

  • このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

パラメーター

ラベル説明データ タイプ
入力ラスター

最近傍セル値に置換されるマスクされる位置が含まれている入力ラスター。

入力ラスターは、整数タイプまたは浮動小数点タイプのいずれかになります。

Raster Layer
入力ラスター マスク

入力ラスター内で置換される位置を特定するラスター。

値が NoData のセルは、マスクされるエリアに含まれていると見なされます。 出力ラスターで、これらの位置は [入力ラスター] 値の最も近い近傍値に置換されます。

マスク ラスターは、整数タイプまたは浮動小数点タイプのいずれかになります。

Raster Layer
最も近い近傍値が NoData の時、NoData を使用
(オプション)

入力ラスターの NoData セルが最も近い近傍である場合に、マスクされたエリアのセルを置換できるかどうかを指定します。

  • オン - Nodata とデータ値の両方が、マスクされたエリアのセルを置換できます。 つまり、入力ラスター内の NoData 値は、それが最も近い近傍であれば、マスクで定義されたエリアを置換できます。 これがデフォルトです。
  • オフ - データ値のみが、マスクされたエリアのセルを置換できます。 入力ラスター内の NoData 値は、それが最も近い近傍であっても、マスク ラスターで定義されたエリアを置換できません。
Boolean
NoData セルのニブル
(オプション)

マスクされたエリア内にある入力ラスターの NoData セルを保持するか置換するかを指定します。

  • オフ - マスクされたエリア内にある入力ラスターの NoData セルは、出力で保持されます (NoData のままになります)。 これがデフォルトです。
  • オン - マスクされたエリア内にある入力ラスターの NoData セルを、マスクされたエリア以外の最近傍の値で置換できます。
Boolean
入力ゾーン ラスター
(オプション)

入力ゾーン ラスター。 各ゾーンにつき、マスク内にある入力セルは、同じゾーン内にある最も近い近傍セル値にのみ置換されます。

ゾーンは同じ値を持つラスターのすべてのセルで、連続しているかどうかは関係ありません。 入力ゾーン レイヤーは、ゾーンの形状、値、および位置を指定します。 ゾーン ラスターは、整数タイプまたは浮動小数点タイプのいずれかになります。

Raster Layer

戻り値

ラベル説明データ タイプ
出力ラスター

置き換えられたセルがある出力ラスター。

識別された入力セルは、最も近い近傍セル値で置換されます。

in_raster 値が整数の場合、出力ラスターも整数になります。 入力が浮動小数点値である場合、出力は浮動小数点値になります。

Raster

Nibble(in_raster, in_mask_raster, {nibble_values}, {nibble_nodata}, {in_zone_raster})
名前説明データ タイプ
in_raster

最近傍セル値に置換されるマスクされる位置が含まれている入力ラスター。

入力ラスターは、整数タイプまたは浮動小数点タイプのいずれかになります。

Raster Layer
in_mask_raster

入力ラスター内で置換される位置を特定するラスター。

値が NoData のセルは、マスクされるエリアに含まれていると見なされます。 出力ラスターで、これらの位置は in_raster 値の最も近い近傍値に置換されます。

マスク ラスターは、整数タイプまたは浮動小数点タイプのいずれかになります。

Raster Layer
nibble_values
(オプション)

入力ラスターの NoData セルが最も近い近傍である場合に、マスクされたエリアのセルを置換できるかどうかを指定します。

  • ALL_VALUESNodata とデータ値の両方が、マスクされたエリアのセルを置換できます。 つまり、入力ラスター内の NoData 値は、それが最も近い近傍であれば、マスクで定義されたエリアを置換できます。 これがデフォルトです。
  • DATA_ONLYデータ値のみが、マスクされたエリアのセルを置換できます。 入力ラスター内の NoData 値は、それが最も近い近傍であっても、マスク ラスターで定義されたエリアを置換できません。
Boolean
nibble_nodata
(オプション)

マスクされたエリア内にある入力ラスターの NoData セルを保持するか置換するかを指定します。

  • PRESERVE_NODATAマスクされたエリア内にある入力ラスターの NoData セルは、出力で保持されます (NoData のままになります)。 これがデフォルトです。
  • PROCESS_NODATAマスクされたエリア内にある入力ラスターの NoData セルを、マスクされたエリア以外の最近傍の値で置換できます。
Boolean
in_zone_raster
(オプション)

入力ゾーン ラスター。 各ゾーンにつき、マスク内にある入力セルは、同じゾーン内にある最も近い近傍セル値にのみ置換されます。

ゾーンは同じ値を持つラスターのすべてのセルで、連続しているかどうかは関係ありません。 入力ゾーン レイヤーは、ゾーンの形状、値、および位置を指定します。 ゾーン ラスターは、整数タイプまたは浮動小数点タイプのいずれかになります。

Raster Layer

戻り値

名前説明データ タイプ
out_raster

置き換えられたセルがある出力ラスター。

識別された入力セルは、最も近い近傍セル値で置換されます。

in_raster 値が整数の場合、出力ラスターも整数になります。 入力が浮動小数点値である場合、出力は浮動小数点値になります。

Raster

コードのサンプル

Nibble の例 1 (Python ウィンドウ)

次の例では、マスク入力で識別されるセルを、入力ラスターの最も近い近傍セルで決定される値で置換しています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nibbleOut = Nibble("land", "snow", "DATA_ONLY")
nibbleOut.save("C:/sapyexamples/output/nibbleout")
Nibble の例 2 (スタンドアロン スクリプト)

次の例では、マスク入力で識別されるセルを、入力ラスターの最も近い近傍セルで決定される値で置換しています。

# Name: Nibble_Ex_02.py
# Description: Replaces cells of a raster corresponding to a mask 
#              with the values of the nearest neighbors.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "land"
inMask = "snow"

# Execute Nibble
nibbleOut = Nibble(inRaster, inMask, "ALL_VALUES")

# Save the output 
nibbleOut.save("C:/sapyexamples/output/outnibble")

関連トピック