Network Analyst のライセンスで利用可能。
サマリー
ネットワーク データセットを用いて空間ウェイト マトリックス ファイル (*.swm) を作成し、基礎となるネットワーク構造におけるフィーチャの空間リレーションシップを定義します。
図
使用法
-
このツールでは空間ウェイト マトリックス ファイル (*.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 ターン規制を指定します。
| String |
Restrictions [Restriction,...] (オプション) | 規制のリスト。空間リレーションシップの計算に適用する規制をオンにします。 | String |
Use_Hierarchy_in_Analysis (オプション) | 分析に階層を使用するかどうかを指定します。
| Boolean |
Search_Tolerance (オプション) | ネットワーク データ セットについて Input_Feature_Class のフィーチャを特定するときに使用する検索閾値。このパラメーターには、計算値、および許容値の単位が含まれます。 | Linear unit |
Conceptualization_of_Spatial_Relationships (オプション) | 各空間関係に関連付けられる加重をどのように指定するかを指定します。
| String |
Exponent (オプション) | INVERSEConceptualization_of_Spatial_Relationships の計算のためのパラメーター。典型的な値は 1 または 2 です。ウェイトは、この指数値が上昇するにつれ、距離とともに下降速度が増します。 | Double |
Row_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
関連トピック
- 空間関係のモデリング ツールセットの概要
- 空間的自己相関分析 (Spatial Autocorrelation (Global Moran's I))
- 高/低クラスター分析 (High/Low Clustering (Getis-Ord General G))
- クラスター/外れ値分析 (Cluster and Outlier Analysis (Anselin Local Moran's I))
- ホット スポット分析 (Hot Spot Analysis (Getis-Ord Gi*))
- グループ分析 (Grouping Analysis)
- 空間ウェイト
- 空間関係のモデリング
- 空間ウェイト マトリックスの生成 (Generate Spatial Weights Matrix)
- ネットワーク データセットとは