Краткая информация
Создает эллипс стандартного отклонения для обобщения пространственных характеристик географических объектов: центральная тенденция, дисперсность и тренды, обладающие направленностью.
Более подробно о работе инструмента Направленное распределение (эллипс стандартных отклонений)
Иллюстрация
Использование
Инструмент Эллипс стандартных отклонений (Standard Deviational Ellipse) создает новый Выходной класс объектов (Output Feature Class), содержащий эллиптические полигоны, один для каждой группировки (параметр Поле группировки (Case Field)). Атрибутивные значения для этих эллиптических полигонов включают координаты X и Y для среднего центра, 2 стандартных расстояния (длинная и короткая оси); ориентацию эллипса. Названия полей – CenterX, CenterY, XStdDist, YStdDist и Rotation. Когда в Поле группировки есть значение, это поле также добавляется к Выходному классу объектов.
В расчетах, основанных на Евклидовом или Манхэттенском расстояниях, необходимо использовать данные, спроецированные на плоскость, для точного измерения расстояний.
Когда пространственная структура объектов сконцентрирована в центре и меньшее число объектов ближе к периферии (пространственное нормальное распределение), 1 эллипс стандартных отклонений покроет приблизительно 68 % всех объектов; 2 стандартных отклонения будут содержать приблизительно 95 % объектов и 3 стандартных отклонения покроют приблизительно 99 % объектов в кластере.
Значение в выходном поле Rotation представляет поворот длинной оси, измеряемый по часовой стрелке.
Поле группировки используется для группировки объектов до начала анализа. Когда в Поле группировки задано значение, входные объекты сначала группируются согласно значениям поля группировки, а затем для каждой группы создается эллипс стандартных отклонений. Поле группировки должно быть типа целое (integer), дата (date) или текст (string). Записи, имеющие значения NULL в Поле группировки (Case Field), исключаются из анализа.
Расчеты эллипса стандартных отклонений могут быть основаны на дополнительном Поле веса (Weight Field) (например, чтобы получить эллипсы транспортных происшествий, взвешенных по тяжести последствий). Поле веса должно быть числовым.
-
Для линейных или полигональных объектов, при расчете расстояний используются центроиды. Для мультиточек, полилиний или полигонов, состоящих их нескольких частей, центроид вычисляется с использованием средневзвешенного центра всех частей объекта. При определении весов точечные объекты имеют равный вес (1). Для линейных объектов это длина сегмента. Для полигональных – площадь.
-
Слои карты можно использовать для определения Входного класса объектов (Input Feature Class). Если в слое есть выборка, только выбранные объекты будут включены в анализ.
Синтаксис
DirectionalDistribution_stats (Input_Feature_Class, Output_Ellipse_Feature_Class, Ellipse_Size, {Weight_Field}, {Case_Field})
Параметр | Объяснение | Тип данных |
Input_Feature_Class | Класс пространственных объектов, содержащий распределение объектов, для которых будет рассчитан эллипс стандартных отклонений. | Feature Layer |
Output_Ellipse_Feature_Class | Класс полигональных пространственных объектов, который будет содержать выходной эллипс. | Feature Class |
Ellipse_Size | Размер выходных эллипсов в стандартных отклонениях. По умолчанию, размер эллипса равен 1; возможный выбор – 1,2 или 3 стандартных отклонения.
| String |
Weight_Field (Дополнительный) | Числовое поле, используемое для взвешивания местоположений согласно их относительной важности. | Field |
Case_Field (Дополнительный) | Поле, используемое для группировки объектов для отдельных расчетов направлений распределения. Поле группировки должно быть типа целое (integer), дата (date) или текст (string). | Field |
Пример кода
Пример Направленного распределения (окно Python)
Следующий скрипт, представленный в Python окне, демонстрирует, как использовать инструмент DirectionalDistribution.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.DirectionalDistribution_stats("AutoTheft.shp", "auto_theft_SE.shp", "1_STANDARD_DEVIATION", "#", "#")
Пример Направленного распределения (автономный скрипт Python)
Следующий автономный скрипт Python демонстрирует, как использовать инструмент DirectionalDistribution.
# 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())
Параметры среды
- Выходная система координат (Output Coordinate System)
- Географические преобразования (Geographic Transformations)
- Текущая рабочая область (Current Workspace)
- Временная рабочая область (Scratch Workspace)
- Стандартизированные имена полей (Qualified Field Names)
- Выходные данные содержат значения M (Output has M values)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Выходные данные содержат Z значения (Output has Z values)
- Выходное значение Z по умолчанию (Default Output Z Value)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
Информация о лицензиях
- ArcGIS Desktop Basic: Да
- ArcGIS Desktop Standard: Да
- ArcGIS Desktop Advanced: Да