| ラベル | 説明 | データ タイプ |
入力包含確率ラスター | このラスターは、対象地域内の各位置の包含確率を定義します。 位置の値の範囲は、0 (包含確率が低い) 〜 1 (包含確率が高い) です。 | Raster Layer; Mosaic Layer |
出力ポイント数 | 生成するサンプル位置の数を指定します。 | Long |
出力ポイント フィーチャクラス | 出力フィーチャクラスには、選択したサンプル位置とその包含確率が含まれます。 | Feature Class |
Geostatistical Analyst のライセンスで利用可能。
サマリー
包含確率に基づいたサンプル ポイント セットを生成し、空間的にバランス調整されたサンプル設計を生成します。 このツールは、一般的にサンプルを取得する場所を提案することで監視ネットワークを設計する際に使用され、特定の位置に対する優先度を包含確率ラスターを使用して定義できます。
使用法
入力確率ラスターには、0 〜 1 の値のみが含まれている必要があります。 値が高いほど、そのセルがサンプル設計に含まれる可能性が高くなります。
分析範囲内のすべての値に 0 以上の包含確率が設定され、分析範囲外のすべてのエリアには NULL 値が設定されている必要があります。
包含確率ラスターのセル サイズによって、サンプルを生成する際の最も細かい座標精度が決まります。 言い換えると、このツールが作成するポイントは、常にラスター セルの中心に位置します。 包含確率ラスターのセル サイズを小さくすると、作成されるポイントの候補地が増えます。
ポイント、ライン、またはポリゴン フィーチャをラスターに変換する場合 (入力確率ラスターを取得する場合) は、次の点に考慮します。
- セル サイズ (座標精度) は、母集団のすべての重要なフィーチャを識別できる程度に小さくする必要があります。 そのためには、セル サイズをフィーチャ間の最小距離の半分未満に設定します。 この距離は、[近接テーブルの生成 (Generate Near Table)] ツールで計算できます。
- ラインおよびポリゴン フィーチャの場合、生成されるラスターでフィーチャ (蛇行する小川など) が適切に表現されるようにセル サイズを設定する必要があります。 たとえば、ラスターのセル サイズが大きい場合、複雑な河川を表現できないことがあります。また、セル サイズが大きすぎると、河川の曲線がスムージングされることがあります。
- また、フィールドでサンプル位置を特定できる精度も考慮する必要があります。 たとえば、位置正確度が 10 メートルの GPS を使用して位置を検索する場合、セル サイズを 10 メートルに設定する必要があります。
- セル数が増加すると処理時間も長くなるため、包含確率ラスターのサイズにご注意ください。
空間的にバランス調整されていないように見える出力を避けるため、サンプル位置の数は包含確率ラスターのセル数の 1% 未満にすることをお勧めします。
このツールは、操作時に乱数ジェネレーターを使用します。 使用するシード値は、乱数ジェネレーター環境で制御できます。
- シード値 0 (デフォルト値) を使用すると、ツールを実行するたびに異なる乱数セットが使用され、異なる出力が生成されます。
- 乱数シードが 0 を超える固定数に設定されている場合、シード値を変更するまで、ツールを実行するたびに同じサンプル位置セットが生成されます。 サンプリング ネットワーク候補を生成する際、乱数シード値を 0 を超える固定値に設定すると、ニーズに最適なネットワークを選択できるようになるため有効です。
注意:
[メルセンヌ ツイスター] 乱数ジェネレーター タイプのみがサポートされています。[ACM 収集アルゴリズム 599] または [標準 C Rand] が選択されている場合、代わりに [メルセンヌ ツイスター] が使用されます。
パラメーター
arcpy.ga.CreateSpatiallyBalancedPoints(in_probability_raster, number_output_points, out_feature_class)
| 名前 | 説明 | データ タイプ |
in_probability_raster | このラスターは、対象地域内の各位置の包含確率を定義します。 位置の値の範囲は、0 (包含確率が低い) 〜 1 (包含確率が高い) です。 | Raster Layer; Mosaic Layer |
number_output_points | 生成するサンプル位置の数を指定します。 | Long |
out_feature_class | 出力フィーチャクラスには、選択したサンプル位置とその包含確率が含まれます。 | Feature Class |
コードのサンプル
入力包含確率ラスターに基づき、空間的にバランス調整されたポイント セットを作成します。
import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.CreateSpatiallyBalancedPoints_ga("ca_prob", "10", "C:/gapyexamples/output/csbp")入力包含確率ラスターに基づき、空間的にバランス調整されたポイント セットを作成します。
# Name: CreateSpatiallyBalancedPoints_Example_02.py
# Description: This tool generates a set of sample points based on inclusion
# probabilities. The resulting sample design is spatially balanced, meaning
# that the spatial independence between samples is maximized, making the
# design more efficient than sampling the study area at random.
# Requirements: Geostatistical Analyst Extension
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"
# Set local variables
inProb = "ca_prob"
numberPoints = 10
outPoints = "C:/gapyexamples/output/csbp"
# Execute CreateSpatiallyBalancedPoints
arcpy.CreateSpatiallyBalancedPoints_ga(inProb, numberPoints, outPoints)環境
ライセンス情報
- Basic: 次のものが必要 Geostatistical Analyst
- Standard: 次のものが必要 Geostatistical Analyst
- Advanced: 次のものが必要 Geostatistical Analyst