Spatial Analyst のライセンスで利用可能。
概要
出力の各セルについて、そのセルが属している接続されたリージョンの ID が記録されます。各リージョンには、一意の数値が割り当てられます。
図
![[リージョン グループ (Region Group)] の図](GUID-9D6F94F5-65E3-47A0-9503-CED99426A274-web.png "[リージョン グループ (Region Group)] の図")
使用法
最初にスキャンされたリージョンは 1、2 番目は 2 というように、すべてのリージョンに値が割り当てられます。スキャンは、左から右、上から下に移動します。スキャン処理で検出された順序に基づき、出力ゾーンに値が割り当てられます。
デフォルトでは、[リンク フィールドを出力データに追加] (Python では ADD_LINK) オプションは有効です。これは、出力ラスターの属性テーブルに LINK というアイテムを作成し、入力ラスターの各セルにある元の値を維持します。
LINK フィールドを使用すると、クエリや解析に使用できるように、新しく作成した各リージョンの親子関係を追跡できます
たとえば、上の図に示した出力ラスターの属性テーブルは、次のようになります。
![属性テーブルの [LINK] アイテムの例](GUID-FBE56199-56D0-4C2E-A0FD-145D5192C6CB-web.png "属性テーブルの [LINK] アイテムの例")
LINK フィールドが作成されていない場合、これにより処理が速度が大幅に向上します。各リージョンの元の値が必要ない場合は、このオプションをオフにします。
環境マスクセットを使用すると、空間構成とリージョンの数が出力ラスターで変化する場合があります。
[リージョン グループ (Region Group)] は、ゾーンではなく、リージョンに対して解析を行う場合に特に便利です。入力ゾーン値は維持されるため、元のゾーン クラスも解析に使用できます。
除外値を含むセル位置は、これらのゾーンが既存の NoData のセル位置と混同されないように、出力でゼロが割り当てられます。[リージョン グループ (Region Group)] は、値 1 から番号を付けるため、リージョン グループから排除されたセルは、背景と見なされます。これらの背景セルは、他の値として再分類や操作ができます。除外値を含む位置は、[Con] ツールを使用して、簡単に NoData に変換できます。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
RegionGroup(in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})| パラメーター | 説明 | データ タイプ |
in_raster | 一意の接続されたリージョンが識別される入力ラスター。 整数タイプでなければいけません。 | Raster Layer |
number_neighbors (オプション) | セル間の接続性の評価に使用される近傍セルの数。
| String |
zone_connectivity (オプション) | 接続性をテストするときにどのセル値を考慮するかを定義します。
| String |
add_link (オプション) | リンク フィールドを出力のテーブルに追加するかどうかを指定します。
| Boolean |
excluded_value (オプション) | セル位置にこの値が含まれている場合は、指定された近傍の数 (FOUR または EIGHT) に関係なく、空間接続性を評価しません。 除外値を持つセルは NoData として扱われ、計算から排除されます。除外値を含むセル位置は、出力ラスターで 0 が割り当てられます。 除外値は、背景値の概念や、このツールを 1 回実行するときの環境内での [マスク] の設定に似ています。CROSS キーワードを指定した場合は、このパラメーターに値を指定する必要があります。 | Long |
戻り値
| 名前 | 説明 | データ タイプ |
| out_raster | 出力リージョン グループ ラスター。 出力は常に整数型になります。 | Raster |
コードのサンプル
RegionGroup (リージョン グループ) の例 1 (Python ウィンドウ)
次の例では、8 方向の接続性で、入力ラスターの各リージョンに一意の数を割り当てています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRgnGrp = RegionGroup("land", "EIGHT", "", "", 5)
outRgnGrp.save("c:/sapyexamples/output/reggrp_ex5")
RegionGroup (リージョン グループ) の例 2 (スタンドアロン スクリプト)
次の例では、除外値のある 8 方向の接続性で、入力ラスターの各リージョンに一意の数を割り当てています。
# Name: RegionGroup_Ex_02.py
# Description: Records, for each cell in the output, the
# identity of the connected region to which
# it belongs within the Analysis window. A
# unique number is assigned to each region.
# 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"
valToIgnore = 5
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS",
"NO_LINK", valToIgnore)
# Save the output
outRegionGrp.save("C:/sapyexamples/output/reggrpout")
環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst
- Standard: 次のものが必要 Spatial Analyst
- Advanced: 次のものが必要 Spatial Analyst