| ラベル | 説明 | データ タイプ |
入力フィーチャクラス | 標準偏差楕円または楕円体の計算対象となるフィーチャの分布を示すフィーチャクラス。 | Feature Layer |
出力楕円フィーチャクラス | 出力楕円フィーチャが格納されるポリゴン フィーチャクラス。 | Feature Class |
楕円サイズ | 標準偏差における出力楕円のサイズを指定します。
| String |
加重フィールド (オプション) | 相対的重要性に応じて位置に加重を付けるために使用される数値フィールド。 | Field |
ケース フィールド (オプション) | 個々の分布指向性分析の計算式のためのフィーチャのグループ化に使用するフィールド。 ケース フィールドは、整数型、日付型、または文字列型です。 | Field |
図
使用法
このツールは、[ケース フィールド] パラメーターを指定した場合に、各ケースについて楕円ポリゴンまたは 3D 楕円体マルチパッチを含む出力を作成します。 これらの楕円ポリゴンの属性値には、平均中心の X 座標と Y 座標、2 つの標準距離 (長軸と短軸)、楕円の方向などがあります。 Z 対応のポイント データを使用する場合、属性値には、楕円体の平均中心の Z 座標、3 番目の標準距離 (高さ)、および方位測定も含まれます。 入力フィーチャが 2D である場合、フィールド名は CenterX、CenterY、XStdDist、YStdDist、Rotation です。 入力フィーチャが 3D ポイントである場合、出力に CenterZ、ZStdDist、AngleZ、TiltX、RollY、Volume の各フィールドも追加されます。 [ケース フィールド] パラメーター値が指定されている場合、このフィールドも出力に追加されます。
このツールはポイント データの 3D の性質を認識し、Z 値が使用できる場合は、計算で X、Y、Z の値を使用します。 それらの結果は本質的に 3D であるため、シーンで視覚化する必要があります。 解析結果を正しく視覚化するには、必ず解析をシーンで実行するか、結果レイヤーをシーンにコピーしてください。
距離を正確に測定するには、計算に投影データが必要です。
フィーチャの空間パターンが中心に向かって集中しており、周囲に近づくにつれてフィーチャが少なくなる場合 (空間ガウス分布) は、1 標準偏差楕円ポリゴンでフィーチャの約 68 パーセントがカバーされ、2 標準偏差でフィーチャの約 95 パーセントがカバーされ、3 標準偏差でクラスター内のフィーチャの約 99 パーセントがカバーされます。
入力データが Z 対応である場合、出力される AngleZ、TiltX、RollY フィールドの値はオイラー角で、3D 空間における楕円体の方向を記述します。 データが Z 対応でない場合、出力される Rotation フィールドの値は、12 時から時計回りで計測された長軸の回転を表します。
[ジオメトリ属性の計算 (Calculate Geometry Attributes)] ツールを使用して、データの X、Y、Z 座標を表示できます。
分析に先立って、[ケース フィールド] パラメーターを使用してフィーチャをグループ化します。 [ケース フィールド] パラメーター値を指定した場合、ケース フィールドの値に基づいて、まず入力ライン フィーチャがグループ化されます。 次に、そのグループごとに標準偏差楕円または楕円体が算出されます。 ケース フィールドは、整数型、日付型、または文字列型です。 [ケース フィールド] パラメーター値に NULL 値を持つレコードは、分析から除外されます。
標準偏差楕円または楕円体の計算は、(たとえば、交通事故の重大性で加重した楕円を取得する場合など) オプションの [加重フィールド] パラメーターを使用することもできます。 加重フィールドの値は数値でなければなりません。
-
ライン フィーチャとポリゴン フィーチャの場合は、距離の計算にフィーチャの重心が使用されます。マルチポイント、ポリライン、または複数のパートを持つポリゴンの場合は、すべてのフィーチャ パートの加重平均中心を使用して重心が計算されます。加重は、ポイント フィーチャの場合は 1、ライン フィーチャの場合は長さ、ポリゴン フィーチャの場合は面積です。
-
マップ レイヤーを使用して、入力フィーチャクラスを指定できます。解析対象として指定したレイヤーの中で何らかのフィーチャが選択されている場合、選択されているフィーチャだけが解析の対象となります。
注意:
シェープファイルを使用するときは、NULL 値を格納できないため、注意が必要です。シェープファイル以外の入力からシェープファイルを作成するツールまたはその他の方法では、NULL 値がゼロとして格納または解釈される場合があります。場合によっては、NULL 値はシェープファイルに非常に大きな負の値として格納されます。この場合、予期せぬ結果に至ることがあります。詳細については、「ジオプロセシングでのシェープファイル出力の注意事項」をご参照ください。
パラメーター
arcpy.stats.DirectionalDistribution(Input_Feature_Class, Output_Ellipse_Feature_Class, Ellipse_Size, {Weight_Field}, {Case_Field})| 名前 | 説明 | データ タイプ |
Input_Feature_Class | 標準偏差楕円または楕円体の計算対象となるフィーチャの分布を示すフィーチャクラス。 | Feature Layer |
Output_Ellipse_Feature_Class | 出力楕円フィーチャが格納されるポリゴン フィーチャクラス。 | Feature Class |
Ellipse_Size | 標準偏差における出力楕円のサイズを指定します。
| String |
Weight_Field (オプション) | 相対的重要性に応じて位置に加重を付けるために使用される数値フィールド。 | Field |
Case_Field (オプション) | 個々の分布指向性分析の計算式のためのフィーチャのグループ化に使用するフィールド。 ケース フィールドは、整数型、日付型、または文字列型です。 | Field |
コードのサンプル
次の Python ウィンドウ スクリプトは、DirectionalDistribution 関数の使用方法を示しています。
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.stats.DirectionalDistribution("AutoTheft.shp", "auto_theft_SE.shp",
"1_STANDARD_DEVIATION")次のスタンドアロン Python スクリプトで、DirectionalDistribution 関数を使用する方法を示します。
# Measure the geographic distribution of auto thefts.
# Import system modules
import arcpy
# Local variables...
workspace = "C:/data"
locations = "AutoTheft.shp"
links = "AutoTheft_links.shp"
standardDistance = "auto_theft_SD.shp"
stardardEllipse = "auto_theft_SE.shp"
linearDirectMean = "auto_theft_LDM.shp"
# Set the workspace (to avoid having to type in the full path to the data every
# time).
arcpy.env.workspace = workspace
# Process: Standard Distance of auto theft locations
arcpy.stats.StandardDistance(locations, standardDistance, "1_STANDARD_DEVIATION")
# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft
# locations.
arcpy.stats.DirectionalDistribution(locations, standardEllipse,
"1_STANDARD_DEVIATION")
# Process: Linear Directional Mean of auto thefts.
arcpy.stats.DirectionalMean(links, linearDirectMean, "DIRECTION")環境
出力座標系, 地理座標系変換, 現在のワークスペース, テンポラリ ワークスペース, 修飾されたフィールド名, 出力に M 値を含む, M 座標精度, M 許容値, 出力に Z 値を含む, 出力データのデフォルト Z 値, Z 座標精度, Z 許容値, XY 座標精度, XY 許容値, 出力データの Z ドメイン
特殊なケース
- 出力座標系
フィーチャ ジオメトリは、解析の前に、出力データの座標系に投影変換されます。 すべての数学的演算は、出力座標系の空間参照に基づいて実行されます。