ArcMap

ネットワーク空間ウェイトの生成 (Generate Network Spatial Weights)

Network Analyst のライセンスで利用可能。

サマリー

ネットワーク データセットを使用して空間ウェイト マトリックス ファイル (*.swm) を作成し、基礎となるネットワーク構造におけるフィーチャの空間リレーションシップを定義します。

ネットワーク空間ウェイトの生成の詳細

図

[ネットワーク空間ウェイトの生成 (Generate Network Spatial Weights)] の図

使用法

  • このツールでは空間ウェイト マトリックス ファイル (*.swm) が出力されます。[空間リレーションシップのコンセプト] オプションの指定を必要とするツールでは、空間ウェイト マトリックス ファイルが許容されます。[空間リレーションシップのコンセプト] パラメーターについて GET_SPATIAL_WEIGHTS_FROM_FILE を選択し、[ウェイト マトリックス ファイル] パラメーターについてこのツールを使用して作成された空間ウェイト ファイルのフル パスを指定します。

  • このツールは、[入力フィーチャクラス] のポイント データでの操作専用に設計されています。

  • 空間ウェイト マトリックスは、データセットのフィーチャ間に存在する空間リレーションシップを定量化します。[空間統計] ツールボックス の多くのツールは、各フィーチャと近傍フィーチャの関連性を評価します。このような近隣との関係は、空間ウェイト マトリックス ファイルに定義されています。移動が 1 つのネットワークに制限されている場合、このツールでは、近隣との関係がフィーチャ間の時間または距離に基づくことになります (空間ウェイトと空間ウェイト マトリックス ファイルの詳細については、「空間ウェイト」をご参照ください)。

  • 個別値フィールドは、このツールを実行して得られたフィーチャ リレーションシップにリンクしています。そのため、個別値は、すべてのフィーチャについて一意でなければならず、通常はフィーチャクラスとともに保持される永続的なフィールドに置かれます。一意の ID フィールドがない場合は、フィーチャクラス テーブルに新しい整数フィールドを追加して ([フィールドの追加 (Add Field)])、フィールド値が FID または OBJECTID フィールドと等しくなるように計算することで、作成できます (フィールド演算 (Calculate Field))。FID および OBJECTID フィールドの値は、フィーチャクラスをコピーまたは編集するときに変更される場合があります。そのため、これらのフィールド値を [個別値] パラメーターで直接使用することはできません。

  • このツールの [最大近傍数] パラメーターには、各フィーチャに関連付けられる近傍数を数値で指定します。[インピーダンス カットオフ] は、指定した近傍数をカットオフ距離の範囲内に見つけることができない場合、[近傍数] パラメーターをオーバーライドして一部のフィーチャの近傍数が少なくなることを認めます。

  • 空間関係は、ネットワーク データセットに階層があれば、階層で定義できます。この場合は、[解析に階層を使用] パラメーターをオンにします。階層では、ネットワーク エッジが幹線道路、一般道路、生活道路に分類されます。ネットワークの階層を使用してフィーチャ間の空間関係を作成するときには、一般道路よりも幹線道路での移動が優先され、生活道路よりも一般道路での移動が優先されます。

  • Street Map Premium for ArcGIS から入手した事前作成済みのネットワーク データセットで移動モードを使用すると、一部のパラメーター オプションが事前入力された状態のまま変更不可になっていることがあります。

  • このツールでは、[出力座標系] 環境設定は考慮されません。すべてのフィーチャ ジオメトリは、分析の前にネットワーク データセットに関連付けられた空間参照に一致するように投影されます。このツールによって作成される空間ウェイト マトリックス ファイルには、ネットワーク データセットの空間参照で定義される空間関係が反映されます。ネットワーク空間ウェイト マトリックス ファイルを使用して分析を実施するときには、ネットワーク SWM を作成するときに使用するネットワーク データセットの座標系と一致するように入力フィーチャクラスを投影することを推奨します。

構文

GenerateNetworkSpatialWeights_stats (Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Input_Network, Impedance_Attribute, {Impedance_Cutoff}, {Maximum_Number_of_Neighbors}, {Barriers}, {U-turn_Policy}, {Restrictions}, {Use_Hierarchy_in_Analysis}, {Search_Tolerance}, {Conceptualization_of_Spatial_Relationships}, {Exponent}, {Row_Standardization}, {Travel_Mode}, {Time_of_Day})
パラメーター説明データ タイプ
Input_Feature_Class

フィーチャ間のネットワーク空間リレーションシップを評価する対象のポイント フィーチャクラス。

Feature Class
Unique_ID_Field

入力フィーチャクラスのすべてのフィーチャで値が異なる整数フィールドです。個別値フィールドがない場合は、整数フィールドをフィーチャクラス テーブルに追加し、FID/OID フィールドに等しいフィールド値を計算することによって、作成できます。

Field
Output_Spatial_Weights_Matrix_File

出力ネットワーク空間ウェイト マトリックス ファイル (*.swm) ファイル。

File
Input_Network

入力フィーチャクラス内のフィーチャ間の空間関係を定義するネットワーク データセット。ほとんどの場合、ネットワーク データセットは道路ネットワークを表しますが、他の種類の交通ネットワークを表すこともあります。ネットワーク データセットには、少なくとも 1 つの時間ベースのコスト属性と 1 つの距離ベースのコスト属性が必要です。

Network Dataset Layer
Impedance_Attribute

分析でインピーダンスとして使用するコスト単位の種類。

String
Impedance_Cutoff
(オプション)

INVERSE および FIXED の空間リレーションシップのコンセプトについてのカットオフ値を指定します。この値は Impedance_Attribute パラメーターで指定した単位で入力します。

値をゼロにすると、閾値が適用されません。このパラメーターを空欄のままにすると、入力フィーチャクラスの範囲とフィーチャ数に基づきデフォルトの閾値が計算されます。

Double
Maximum_Number_of_Neighbors
(オプション)

各フィーチャについて特定する最大近傍数を表す整数。

Long
Barriers
(オプション)

ブロックされている交差点、道路の閉鎖、事故現場、ネットワーク沿いで移動がブロックされているその他の場所を表すフィーチャを持つポイント フィーチャクラスの名前。

Feature Layer
U-turn_Policy
(オプション)

オプションの U ターン規制を指定します。

  • ALLOW_UTURNS —どこでも U ターンできます。これがデフォルトです。
  • NO_UTURNS —ナビゲーション中の U ターンは禁止されます。
  • ALLOW_DEAD_ENDS_ONLY —行き止まり (つまり、一方向のジャンクション) の場合にのみ U ターンが認められます。
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —行き止まりと交差点の場合にのみ U ターンが認められます。
String
Restrictions
[Restriction,...]
(オプション)

規制のリスト。空間リレーションシップの計算に適用する規制をオンにします。

String
Use_Hierarchy_in_Analysis
(オプション)

分析に階層を使用するかどうかを指定します。

  • USE_HIERARCHY —ヒューリスティック パス アルゴリズムにネットワーク データセットの階層属性を使用して解析速度を上げます。
  • NO_HIERARCHY —正確なパス アルゴリズムを使用します。階層属性がない場合、このオプションは分析に影響を与えません。
Boolean
Search_Tolerance
(オプション)

ネットワーク データ セットについて Input_Feature_Class のフィーチャを特定するときに使用する検索閾値。このパラメーターには、計算値、および許容値の単位が含まれます。

Linear Unit
Conceptualization_of_Spatial_Relationships
(オプション)

各空間関係に関連付けられる加重をどのように指定するかを指定します。

  • INVERSE —遠いフィーチャほど近いフィーチャよりも加重が小さくなります。
  • FIXED —Impendance_Cutoff の範囲内のフィーチャは隣接フィーチャ (ウェイトが 1) です。Impendance_Cutoff の範囲外のフィーチャは加重されません (ウェイトが 0)。
String
Exponent
(オプション)

INVERSE Conceptualization_of_Spatial_Relationships の計算のためのパラメーター。典型的な値は 1 または 2 です。ウェイトは、この指数値が上昇するにつれ、距離とともに下降速度が増します。

Double
Row_Standardization
(オプション)

設計のサンプリングや適用される集約方式のためにフィーチャの分布に偏りがあると考えられる場合は、行を標準化することを推奨します。

  • ROW_STANDARDIZATION —空間ウェイトは行で標準化されます。各ウェイトは行の合計で除されます。
  • NO_STANDARDIZATION —空間ウェイトの標準化は適用されません。
Boolean
Travel_Mode
(オプション)

分析対象の交通モード。Custom は、常に選択肢に含まれています。その他の移動モードを表示するには、[ネットワーク データセット] パラメーターで指定されたネットワーク データセットにこれらのモードが存在していなければなりません。

移動モードは、ネットワーク データセットで定義され、車、トラック、歩行などの移動モードをモデリングする一連のパラメーターをオーバーライドする値を提供します。

String
Time_of_Day
(オプション)

移動時間の計測で交通状況を考慮するかどうかを指定します。特に都市部では、交通状況は、指定した移動時間内にカバーされるエリアに多大な影響を与える場合があります。日付も時間も指定しない場合、指定した移動時間以内にカバーされる距離は交通状況の影響を受けません。

Date

コードのサンプル

GenerateNetworkSpatialWeights (ネットワーク空間ウェイトの生成) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、GenerateNetworkSpatialWeights (ネットワーク空間ウェイトの生成) ツールの使用方法を示しています。

import arcpy
arcpy.env.workspace = "c:/data"
arpcy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID","network6Neighs.swm", 
                                          "Streets_ND","MINUTES", 10, 6, "#", 
                                          "ALLOW_UTURNS","#", "USE_HIERARCHY", 
                                          "#", "INVERSE", 1,"ROW_STANDARDIZATION")
GenerateNetworkSpatialWeights (ネットワーク空間ウェイトの生成) の例 2 (スタンドアロン Python スクリプト)

次のスタンドアロン Python ウィンドウのスクリプトは、GenerateNetworkSpatialWeights (ネットワーク空間ウェイトの生成) ツールの使用方法を示しています。

# Create a Spatial Weights Matrix based on Network Data 
# Import system modules
import arcpy
# Set the geoprocessor object property to overwrite existing output
arcpy.gp.overwriteOutput = True
# Check out the ArcGIS Network Analyst エクステンション (required for the Generate Network Spatial Weights tool)
arcpy.CheckOutExtension("Network")
# Local variables...
workspace = r"C:\Data"
try:
    # Set the current workspace (to avoid having to specify the full path to the feature classes each time)
    arcpy.env.workspace = workspace
    # Create Spatial Weights Matrix based on Network Data 
    # Process: Generate Network Spatial Weights... 
    nwm = arcpy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID",
                        "network6Neighs.swm", "Streets_ND",
                        "MINUTES", 10, 6, "#", "ALLOW_UTURNS",
                        "#", "USE_HIERARCHY", "#", "INVERSE",
                        1, "ROW_STANDARDIZATION")
    # Create Spatial Weights Matrix based on Euclidean Distance
    # Process: Generate Spatial Weights Matrix... 
    swm = arcpy.GenerateSpatialWeightsMatrix_stats("Hospital.shp", "MYID",
                        "euclidean6Neighs.swm",
                        "K_NEAREST_NEIGHBORS",
                        "#", "#", "#", 6) 
    # Calculate Moran's Index of Spatial Autocorrelation for 
    # average hospital visit times using Network Spatial Weights 
    # Process: Spatial Autocorrelation (Morans I)...       
    moransINet = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
                        "NO_REPORT", "GET_SPATIAL_WEIGHTS_FROM_FILE", 
                        "EUCLIDEAN_DISTANCE", "NONE", "#", 
                        "network6Neighs.swm")
    # Calculate Moran's Index of Spatial Autocorrelation for 
    # average hospital visit times using Euclidean Spatial Weights   
    # Process: Spatial Autocorrelation (Morans I)...       
    moransIEuc = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
                        "NO_REPORT", "GET_SPATIAL_WEIGHTS_FROM_FILE", 
                        "EUCLIDEAN_DISTANCE", "NONE", "#", 
                        "euclidean6Neighs.swm")
except:
    # If an error occurred when running the tool, print out the error message.
    print arcpy.GetMessages()

環境

ライセンス情報

  • ArcGIS Desktop Basic: 次のものが必要 Network Analyst
  • ArcGIS Desktop Standard: 次のものが必要 Network Analyst
  • ArcGIS Desktop Advanced: 次のものが必要 Network Analyst

関連トピック