ヘルプ

リニア平均方向の算出 (Linear Directional Mean)

サマリー

一連のラインの平均方向、長さ、地理的な中心を特定します。

リニア平均方向の算出方法の詳細

図

リニア平均方向の算出 (Linear Directional Mean) の図

使用法

  • 入力はライン フィーチャクラスでなければなりません。

  • 出力ライン フィーチャの属性値は、次のとおりです。

    • CompassA - コンパス角 (真北から時計回り)
    • DirMean - 平均方向 (真東から反時計回り)
    • CirVar - 円周分散 (平均方向からのラインの方向または向きの偏差)
    • AveX および AveY - 地理的中心の XY 座標
    • AveLen - ラインの平均の長さ
    [ケース フィールド] を指定した場合は、これも [出力フィーチャクラス] に追加されます。

  • 標準偏差の計測と同じように、円周分散 (CirVar) の値は、平均方向ベクトルが一連の入力ベクターをどのくらい適切に表しているのかを示します。円周分散の値の範囲は 0 〜 1 です。すべての入力ベクターが正確に同じ (または極めて類似した) 方向である場合、円周分散は小さく (0 に近く) なります。入力ベクターの方向がコンパス全体に広がっている場合、円周分散は大きく (1 に近く) なります。

  • リニア平均方向を個別に算出するために、[ケース フィールド] を使用してフィーチャをグループ化します。[ケース フィールド] を指定した場合、ケース フィールドの値に基づいて、まず入力ライン フィーチャがグループ化され、次にそのグループごとに出力ライン フィーチャが作成されます。ケース フィールドは、整数型、日付型、または文字列型です。[ケース フィールド] に NULL 値を持つレコードは、分析から除外されます。

  • 方向を計測する場合、このツールはラインの最初と最後のポイントのみを考慮します。ラインに沿ってすべての頂点を考慮するわけではありません。

  • マップ レイヤーを使用して、入力フィーチャクラスを指定できます。解析対象として指定したレイヤーの中で何らかのフィーチャが選択されている場合、選択されているフィーチャだけが解析の対象となります。

  • 出力フィーチャ は、デフォルトのレンダリング (方向ベクトル) を使用して自動的に [コンテンツ] ウィンドウに追加されます。適用されるレンダリングは、<ArcGIS>/Desktop10.x/ArcToolbox/Templates/Layers にあるレイヤー ファイルによって定義されます。必要に応じて、テンプレート レイヤー シンボルをインポートすれば、デフォルトのレンダリングを再適用できます。

  • このツールを ArcMap で実行する場合、デフォルトのレンダリング (方向ベクトル) では、出力フィーチャクラスが [コンテンツ] ウィンドウに自動的に追加されます。適用されるレンダリングは、<ArcGIS>/ArcToolbox/Templates/Layers にあるレイヤー ファイルによって定義されます。必要に応じて、テンプレート レイヤー シンボルをインポートすれば、デフォルトのレンダリングを再適用できます。

構文

DirectionalMean_stats (Input_Feature_Class, Output_Feature_Class, Orientation_Only, {Case_Field})
パラメーター説明データ タイプ
Input_Feature_Class

平均方向の算出対象となるベクトルを含むフィーチャクラス。

Feature Layer
Output_Feature_Class

入力フィーチャクラスの平均方向を表すフィーチャを格納することになるライン フィーチャクラス。

Feature Class
Orientation_Only
  • DIRECTION —平均の算出に開始ノードと終了ノードが使用されます (デフォルト)。
  • ORIENTATION_ONLY —開始ノードと終了ノードの情報は無視されます。
Boolean
Case_Field
(オプション)

平均方向を個別に算出するためにフィーチャをグループ化する場合に使用するフィールド。ケース フィールドは、整数型、日付型、または文字列型です。

Field

コードのサンプル

LinearDirectionalMean (リニア平均方向の算出) の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは LinearDirectionalMean (リニア平均方向の算出) ツールを使用する方法を示しています。

import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.DirectionalMean_stats("AutoTheft_links.shp", "auto_theft_LDM.shp", "DIRECTION", "#")
LinearDirectionalMean (リニア平均方向の算出) の例 (スタンドアロン Python スクリプト)

次のスタンドアロンの 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())

環境

ライセンス情報

  • ArcGIS Desktop Basic: はい
  • ArcGIS Desktop Standard: はい
  • ArcGIS Desktop Advanced: はい

関連トピック