リニア平均方向の算出（Linear Directional Mean） (空間統計)
図
 |
使用法
-
入力はライン フィーチャクラスでなければなりません。
-
出力ライン フィーチャの属性値には、コンパス角（真北から時計回り）を表す CompassA、平均方向（真東から反時計回り）を表す DirMean、円分散（ラインの方向または向きが平均方向から離れている量を示す）を表す CirVar、地理的中心の XY 座標を表す AveX および AveY、平均長さを表す AveLen が含まれます。[ケース フィールド] を指定した場合は、これも [出力フィーチャクラス] に追加されます。
-
標準偏差の計測と同じように、円分散の値は、平均方向ベクトルが一連の入力ベクタをどのくらい適切に表しているのかを示します。円分散の値の範囲は 0 ～ 1 です。すべての入力ベクタが正確に同じ（またはきわめて類似した）方向である場合、円分散は小さく（0 に近く）なります。入力ベクタの方向がコンパス全体に広がっている場合、円分散は大きく（1 に近く）なります。
-
リニア平均方向を個別に算出するために、[ケース フィールド] を使用してフィーチャをグループ化します。[ケース フィールド] を指定した場合、ケース フィールドの値に基づいて、まず入力ライン フィーチャがグループ化され、次にそのグループごとに出力ライン フィーチャが作成されます。ケース フィールドは、整数型、日付型、または文字列型です。[ケース フィールド] に NULL 値を持つレコードは、分析から除外されます。
-
方向を計測する場合、このツールはラインの最初と最後のポイントのみを考慮します。ラインに沿ってすべての頂点を考慮するわけではありません。
-
マップ レイヤを使用して、入力フィーチャクラスを指定できます。解析対象として指定したレイヤの中で何らかのフィーチャが選択されている場合、選択されているフィーチャだけが解析の対象となります。
-
このツールを ArcMap で実行する場合、デフォルトのレンダリング（方向ベクトル）では、出力フィーチャクラスがコンテンツ ウィンドウに自動的に追加されます。適用されるレンダリングは、<ArcGIS>/ArcToolbox/Templates/Layers にあるレイヤ ファイルによって定義されます。必要に応じて、テンプレート レイヤ シンボルをインポートすれば、デフォルトのレンダリングを再適用できます。
注意:シェープファイルを使用するときは、NULL 値を格納できないため、注意が必要です。シェープファイル以外の入力からシェープファイルを作成するツールまたはその他の方法では、NULL 値がゼロとして格納または解釈される場合があります。場合によっては、NULL 値はシェープファイルに非常に大きな負の値として格納されます。この場合、予期せぬ結果に至ることがあります。詳細については、「ジオプロセシングでのシェープファイル出力の注意事項」をご参照ください。
構文
| パラメータ | 説明 | データ タイプ |
Input_Feature_Class |
平均方向の算出対象となるベクトルを含むフィーチャクラス。 | Feature Layer |
Output_Feature_Class |
入力フィーチャクラスの平均方向を表すフィーチャを格納することになるライン フィーチャクラス。 | Feature Class |
Orientation_Only |
| Boolean |
Case_Field (オプション) |
平均方向を個別に算出するためにフィーチャをグループ化する場合に使用するフィールド。ケース フィールドは、整数型、日付型、または文字列型です。 | Field |
コードのサンプル
次の Python ウィンドウ スクリプトは LinearDirectionalMean（リニア平均方向の算出）ツールを使用する方法を示しています。
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.DirectionalMean_stats("AutoTheft_links.shp", "auto_theft_LDM.shp", "DIRECTION", "#")
次のスタンドアロンの Python ウィンドウ スクリプトは LinearDirectionalMean（リニア平均方向の算出）ツールを使用する方法を示しています。
# 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"
try:
# 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.StandardDistance_stats(locations, standardDistance, "1_STANDARD_DEVIATION", "#", "#")
# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft locations...
arcpy.DirectionalDistribution_stats(locations, standardEllipse, "1_STANDARD_DEVIATION", "#", "#")
# Process: Linear Directional Mean of auto thefts...
arcpy.DirectionalMean_stats(links, linearDirectMean, "DIRECTION", "#")
except:
# If an error occurred while running a tool, print the messages
print arcpy.GetMessages()
環境
- 出力データの座標系
フィーチャ ジオメトリは、解析の前に、出力データの座標系に投影変換されます。