| ラベル | 説明 | データ タイプ |
入力サーフェス ラスター | コンター ポリゴンが計算される入力ラスターです。 連続ラスターである必要があります。 入力ラスターのデータ タイプでは、整数または浮動小数点を使用できます。 | Raster Layer |
出力コンター ポリゴン | 出力コンター ポリゴン フィーチャです。 出力には、指定されたすべてのパーセンタイル値のコンター ポリゴンが含まれます。 | Feature Class |
パーセンタイル値 (オプション) | コンターが計算されるパーセンタイル値です。 デフォルトは 90 で、90 番目のパーセンタイルを示します。 値の範囲は 0 ～ 100 です。 | Double |
方法 (オプション) | 平面 (平面地球) と測地線 (楕円体) のどちらの方法に基づいて計算するかを指定します。 平面による方法は、正しい距離と面積が維持される投影法で、ローカル エリアに使用するのに適しています。 これは、エリアの都市、郡、小さな州などのエリアをカバーする解析に適しています。 測地線による方法では、より正確な結果が生成されますが、処理時間が増加する可能性があります。
| String |
負の値を無視 (オプション) | 体積パーセンタイル計算で負の値を無視するかどうかを指定します。
| Boolean |
Spatial Analyst のライセンスで利用可能。
サマリー
ランク付けされたセルをボリューム閾値まで累積することで、総量 (値 × セル面積) の p パーセントを含む最小のエリアを区分するコンターが作成されます。
図
使用法
パーセンタイル値は 0 から 100 の範囲で任意の値を取ることができます。 値を 0 にすると、空またはごく小さい結果になる場合があります。 値を 100 にすると、有効なフットプリント全体が返されます。
セルを値の降順でランク付けし、累積合計がラスター全体の体積の p パーセントに達するまで、セルごとの体積 (体積 × セル面積) を累積します。 エリアは、[平面] または [測地線] の [メソッド] パラメーター値によって計算されます。 パーセンタイル体積の閾値はカットオフ時の値です。 出力では、この閾値以上のセルが選択されます。
出力コンター ポリゴンで囲まれたエリアは、パーセンタイル値を使用して計算された体積の合計に対する割合に相当するエリアを示します。 出力ポリゴンの面積は物理的なフットプリントを示します。体積と等しいわけではなく、体積の p パーセントが存在するエリアです。
体積の閾値に繰り返された値が複数ある場合、その閾値にあるすべての値が含まれます。 その結果、出力体積が指定したパーセンタイルを下回ることはありません。 このため、隣接するパーセンタイルは類似する場合があります。
複数のパーセンタイル値が指定された場合、出力ポリゴンは入れ子になります。 最も内側のポリゴンは最大の値に対応し、最も外側のポリゴンはより小さい値をカバーします。
ポリゴン形状の面積は、その極端なバンドに含まれる地表の広さを示します。
正しい距離と面積を正確に維持する投影法を使用してローカル縮尺で解析を実行する場合は、[方法] パラメーターの [平面] オプションが適しています。
[測地線] オプションを使用すると、地域的な縮尺または大縮尺で (たとえば、Web メルカトルや任意の地理座標系を使用して) 解析を実行できます。 このオプションでは、回転楕円体の曲率を考慮して、極と日付変更線の近くのデータを正確に処理します。
[負の値を無視] パラメーターをオフにすると、解析に負の入力セル値が含まれます。 これは体積計算の累積合計に影響する場合があります。
入力サーフェス ラスターは、シングルバンド ラスターである必要があります。
セル値のランクのみに基づいてポリゴンを作成する場合は、[値のパーセンタイル コンター (Value Percentile Contours)] ツールを使用します。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
パラメーター
VolumePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values})| 名前 | 説明 | データ タイプ |
in_surface_raster | コンター ポリゴンが計算される入力ラスターです。 連続ラスターである必要があります。 入力ラスターのデータ タイプでは、整数または浮動小数点を使用できます。 | Raster Layer |
out_contour_polygons | 出力コンター ポリゴン フィーチャです。 出力には、指定されたすべてのパーセンタイル値のコンター ポリゴンが含まれます。 | Feature Class |
percentile_values [percentile_values,...] (オプション) | コンターが計算されるパーセンタイル値です。 デフォルトは 90 で、90 番目のパーセンタイルを示します。 値の範囲は 0 ～ 100 です。 | Double |
method (オプション) | 平面 (平面地球) と測地線 (楕円体) のどちらの方法に基づいて計算するかを指定します。 平面による方法は、正しい距離と面積が維持される投影法で、ローカル エリアに使用するのに適しています。 これは、エリアの都市、郡、小さな州などのエリアをカバーする解析に適しています。 測地線による方法では、より正確な結果が生成されますが、処理時間が増加する可能性があります。
| String |
ignore_negative_values (オプション) | 体積パーセンタイル計算で負の値を無視するかどうかを指定します。
| Boolean |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
VolumePercentileContours("CrimeEventsDensity.tif", "VolP_CrimeDensity_Out.shp",
[50, 75, 90, 95, 99], method = "Planar",
ignore_negative_values = "USE_ALL_VALUES")次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
## Name: VolumePercentileContours_Ex_standalone.py
## Description: Delineate areas of different magnitudes from density surface
## Requirements: Spatial Analyst Extension
## Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
## Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
## Set environment settings
env.workspace = "C:/sapyexamples/data"
# To allow overwriting outputs change overwriteOutput option to True.
env.overwriteOutput = False
## Set local variables
in_surface_raster = "CrimeEventsDensity.tif"
percentile_values = [25, 50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"
## Execute: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
out_volP_contour,
percentile_values, method,
ignore_negative_values)環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst
- Standard: 次のものが必要 Spatial Analyst
- Advanced: 次のものが必要 Spatial Analyst