Построить матрицу пространственных весов (Пространственная статистика)

Уровень лицензии:BasicStandardAdvanced

Резюме

Создает файл с матрицей пространственных весов (с расширением SWM) для отображения пространственных отношений между объектами в наборе данных.

Подробнее о том, как работает инструмент Построить матрицу пространственных весов

Рисунок

Пространственные веса на основе примыкания полигонов
Пространственные отношения, основанные на примыкании полигонов, случай "ферзя": общие ребра или узлы.

Использование

Синтаксис

GenerateSpatialWeightsMatrix_stats (Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Conceptualization_of_Spatial_Relationships, {Distance_Method}, {Exponent}, {Threshold_Distance}, {Number_of_Neighbors}, {Row_Standardization}, {Input_Table}, {Date_Time_Field}, {Date_Time_Interval_Type}, {Date_Time_Interval_Value})
ПараметрОбъяснениеТип данных
Input_Feature_Class

Класс пространственных объектов, для которого пространственные отношения объектов будут оценены.

Feature Class
Unique_ID_Field

Целое поле, содержащее разное значение для каждого объекта во Входном классе объектов.

Field
Output_Spatial_Weights_Matrix_File

Полный путь к создаваемому файлу матрицы пространственных весов (SWM).

File
Conceptualization_of_Spatial_Relationships

Определяет, как представлены отношения между объектами.

  • INVERSE_DISTANCE (Обратное расстояние)Влияние одного объекта на другой уменьшается с ростом расстояния.
  • FIXED_DISTANCE (Фиксированное расстояние)Все объекты в пределах указанного критического расстояния от каждого объекта включаются в анализ; все объекты вне критического расстояния — исключаются.
  • K_NEAREST_NEIGHBORS (Ближайшая окрестность K)Ближайшие K объектов включаются в анализ, где K — определенный числовой параметр.
  • CONTIGUITY_EDGES_ONLY (Примыкание только ребрами)Соседями считаются полигональные объекты, имеющие общую границу.
  • CONTIGUITY_EDGES_CORNERS (Примыкание ребрами и углами)Соседями считаются полигональные объекты, имеющие общую границу и/или общий узел.
  • DELAUNAY_TRIANGULATION (Триангуляция Делоне)На основе центроидов объектов создается сеть неперекрывающихся треугольников; соседями считаются объекты, связанные с узлами треугольников, которые имеют общие ребра.
  • SPACE_TIME_WINDOW (Окно пространства-времени)Соседями считаются объекты, расположенные друг от друга в пределах указанного критического расстояния и в указанном временном интервале.
  • CONVERT_TABLE (Преобразовать таблицу)Пространственные отношения определены в таблице.

Примечание: методы Примыкания полигонов доступны только с уровнем лицензии ArcGIS for Desktop Advanced.

String
Distance_Method
(дополнительно)

Определяет, как рассчитываются расстояния от одного объекта до соседнего объекта.

  • ЭВКЛИДОВЫЙ (EUCLIDEAN)Расстояние по прямой линии между двумя точками (как ворона летает)
  • МАНХЭТТЕНСКОЕ (MANHATTAN)Расстояние между двумя точками, измеренное вдоль осей (городских кварталов); рассчитывается суммированием абсолютных разностей между координатами х и у
String
Exponent
(дополнительно)

Параметр для расчета обратного расстояния. Типичные значения - 1 или 2.

Double
Threshold_Distance
(дополнительно)

Определяет предельное расстояние для концептуализации пространственных отношений Обратного или Фиксированного расстояний. Введите это значение, используя единицы, определенные во входящей системе координат. Задаёт размер пространственного окна при концептуализации пространственных отношений Пространственно-временное окно.

Значение 0 указывает на то, что пороговое расстояние не применяется. Когда этот параметр остается пустым, пороговое значение по умолчанию будет вычислено исходя из экстента и количества объектов во Входном классе объектов.

Double
Number_of_Neighbors
(дополнительно)

Целое число, показывающее или минимально или точное количество соседей. В случае типа определения отношений K ближайших соседей каждый объект будет иметь число соседей, в точности равное указанному. В случае Обратного расстояния или Фиксированного расстояния каждый объект будет иметь количество соседей, равное указанному значению или превышающее его (для этого, если потребуется, пороговое расстояние будет временно увеличено). Когда имеются островные полигоны, и в качестве Концептуализации пространственных отношений выбран один из типов Примыкания, тогда указанное количество ближайших полигонов будет связано с этими островными полигонами.

Long
Row_Standardization
(дополнительно)

Нормализация ряда (Row standardization) рекомендуется, независимо от того, распределены ли объекты потенциально предвзято в зависимости от дизайна примера или от установленной схемы агрегации.

  • ROW_STANDARDIZATION (Нормализация ряда)Пространственные веса нормализуются по ряду. Каждый вес делится на сумму его ряда.
  • NO_STANDARDIZATION (Нет нормализации)Нормализация пространственных весов не применяется.
Boolean
Input_Table
(дополнительно)

Таблица, содержащая числовые веса, связывающие объекты друг с другом во Входном классе объектов. Требуемые поля - Входной Класс Объектов, Уникальный ID поля, NID (соседний ID) и WEIGHT.

Table
Date_Time_Field
(дополнительно)

Поле даты с временной отметкой для каждого объекта.

Field
Date_Time_Interval_Type
(дополнительно)

Единицы измерения времени.

  • SECONDSСекунды (Seconds)
  • MINUTESМинуты (Minutes)
  • HOURSЧасы (Hours)
  • DAYSДни (Days)
  • WEEKSНедели
  • MONTHSМесяцы
  • YEARSГоды
String
Date_Time_Interval_Value
(дополнительно)

Целое число единиц измерения времени, составляющее временной диапазон.

К примеру, если в качестве Типа интервала даты/времени выбраны Часы, а значение интервала равно 3, то временной диапазон составит 3 часа; объекты, попадающие в указанный временной диапазон и в указанный пространственный диапазон, будут считаться соседями.

Long

Пример кода

Построение матрицы пространственных весов (GenerateSpatialWeightsMatrix) — пример 1 (окно Python)

Следующий скрипт, представленный в окне Python, демонстрирует применение инструмента GenerateSpatialWeightsMatrix.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID","euclidean6Neighs.swm","K_NEAREST_NEIGHBORS","#", "#", "#", 6,"NO_STANDARDIZATION")
Построение матрицы пространственных весов (GenerateSpatialWeightsMatrix) — пример 2 (автономный скрипт Python)

Следующий автономный Python скрипт демонстрирует, как использовать инструмент GenerateSpatialWeightsMatrix.

# Analyze the spatial distribution of 911 calls in a metropolitan area
# using the Hot-Spot Analysis Tool (Local Gi*)

# Import system modules
import arcpy

# Set geoprocessor object property to overwrite existing output, by default
arcpy.gp.overwriteOutput = True

# Local variables...
workspace = "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

    # Copy the input feature class and integrate the points to snap
    # together at 500 feet
    # Process: Copy Features and Integrate
    cf = arcpy.CopyFeatures_management("911Calls.shp", "911Copied.shp",
                         "#", 0, 0, 0)

    integrate = arcpy.Integrate_management("911Copied.shp #", "500 Feet")

    # Use Collect Events to count the number of calls at each location
    # Process: Collect Events
    ce = arcpy.CollectEvents_stats("911Copied.shp", "911Count.shp", "Count", "#")

    # Add a unique ID field to the count feature class
    # Process: Add Field and Calculate Field
    af = arcpy.AddField_management("911Count.shp", "MyID", "LONG", "#", "#", "#", "#",
                     "NON_NULLABLE", "NON_REQUIRED", "#",
                     "911Count.shp")
    
    cf = arcpy.CalculateField_management("911Count.shp", "MyID", "[FID]", "VB")

    # Create Spatial Weights Matrix for Calculations
    # Process: Generate Spatial Weights Matrix... 
    swm = arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID",
                        "euclidean6Neighs.swm",
                        "K_NEAREST_NEIGHBORS",
                        "#", "#", "#", 6,
                        "NO_STANDARDIZATION") 

    # Hot Spot Analysis of 911 Calls
    # Process: Hot Spot Analysis (Getis-Ord Gi*)
    hs = arcpy.HotSpots_stats("911Count.shp", "ICOUNT", "911HotSpots.shp", 
                     "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()

Параметры среды

Выходная система координат (Output Coordinate System)

До начала анализа геометрия пространственных объектов проецируется в Выходную систему координат (Output Coordinate System).

Связанные темы

Информация о лицензировании

ArcGIS for Desktop Basic: Да
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
9/11/2013