Подпись | Описание | Тип данных |
Входной класс объектов | Класс объектов, содержащий векторы, для которых будет вычислено среднее направление. | Feature Layer |
Выходной класс пространственных объектов | Класс линейных объектов, который будет содержать объекты, представляющие средние направления входного класса объектов. | Feature Class |
Только направление | Указывает, нужно ли включать информацию о направлении (от и до узла) в анализ.
| Boolean |
Поле группировки (Дополнительный) | Поле, используемое для группировки объектов для отдельных расчетов среднего направления. Поле группировки должно быть типа целое (integer), дата (date) или текст (string). | Field |
Краткая информация
Определяет среднее направление, длину и географический центр для набора линий.
Подробнее о том, как работает Среднее направление линейных объектов
Иллюстрация
Использование
Входные данные должны быть линейным классом объектов.
Этот инструмент учитывает 3D природу точечных данных и использует при вычислениях значения x, y и z, если z-значения доступны. Поскольку полученные результаты являются 3D, их необходимо визуализировать в Сцене. Убедитесь, что анализ выполняется в Сцене, или скопируйте слой результатов в Сцену для правильной визуализации результатов анализа.
При использовании 2D входных объектов, атрибутивные значения выходных линейных объектов включают следующее:
- CompassA– угол компаса (по часовой стрелке от севера)
- DirMean– среднее направление (против часовой стрелки с востока)
- CirVar– круговая дисперсия (измеряет, насколько линейные направления или ориентации отклоняются от среднего направления)
- AveX и AveY – координаты X и Y среднего центра
- AveLen– средняя длина линии
При использовании 3D входных объектов, атрибутивные значения выходных линейных объектов включают следующее:
- CompassA– угол компаса (по часовой стрелке от севера) в XY плоскости среднего направления
- DirMean– среднее направление (против часовой стрелки с востока)
- DirMeanZ– угол между плоскостью XY и вектором среднего направления
- SphVar– сферическая дисперсия (измеряет, насколько линейные направления или ориентации отклоняются от среднего направления)
- AveX, AveY и AveZ – координаты X и Y среднего центра
- AveLen3D– средняя длина линии, вычисленная в трех измерениях
Аналогично измерению по стандартному отклонению, значение круговой дисперсии (CirVar) показывает, насколько хорошо средний направленный вектор представляет набор входных векторов. Круговая дисперсия изменяется от 0 до 1. Если все входные вектора имеют точно одинаковые (или очень схожие) направления, то круговая дисперсия очень мала (около 0). Когда входные векторы направлений охватывают весь компас (360 градусов), круговая дисперсия оказывается большой (около 1). Это измерение дается как SphVar для сферической дисперсии в трех измерениях.
К среднему направлению применяется критерий равномерности Рэлея. Он позволяет узнать, является ли среднее направление значительно отличающимся от равномерного распределения. В 2D, равномерное распределение означает, что линии равномерно распределены по компасным направлениям. В 3D, равномерное распределение означает, что линии равномерно распределены по сфере. ZScore и PValue позволяют узнать, можно ли отказаться от нулевой гипотезы круговой равномерности. RefValue является критическим значением критерия равномерности Рэлея. UnifTest будет содержать текст Nonuniform, если нулевая гипотеза отвергается; в противном случае будет содержать Uniform.
Поле группировки используется для группировки объектов для отдельных вычислений Среднего направления линейных объектов. Когда задано Поле группировки, входные линейные объекты сначала группируются согласно значениям поля группировки, и затем для каждой группы создается выходной линейный объект. Поле группировки должно быть типа целое (integer), дата (date) или текст (string). Записи, имеющие значения NULL в Поле группировки, исключаются из анализа.
Измеряя направление, инструмент рассматривает только первые и последние точки в линии. Инструмент не рассматривает все вершины вдоль линии.
-
Слои карты можно использовать для определения Входного класса объектов. Если в слое есть выборка, только выбранные объекты будут включены в анализ.
Слой выходных объектов автоматически добавляется в таблицу содержания с методом отображения по умолчанию (векторы направлений). Применяемое отображение определяется файлом слоя в <ArcGIS Pro>\Resources\ArcToolBox\Templates\Layers. Способ отображения по умолчанию, если это необходимо, можно применить заново с помощью инструмента Применить символы слоя.
При запуске этого инструмента, выходной класс объектов автоматически добавляется к таблице содержания (TOC) с методом отображения по умолчанию (векторов направлений). Применяемое отображение определяется файлом слоя в <ArcGIS>/ArcToolbox/Templates/Layers. Вы можете заново применить механизм отрисовки по умолчанию, если необходимо, с помощью инструмента Применить символы из слоя.
Внимание:
При использовании шейп-файлов, помните, что в них нельзя хранить нулевые (null) значения. Инструменты или другие процедуры, создающие шейп-файлы из прочих входных данных, могут хранить значения NULL в виде 0 или оперировать ими как нулем. В некоторых случаях нули в шейп-файлах хранятся как очень маленькие отрицательные числа. Это может привести к неожиданным результатам. Дополнительные сведения см. в разделе Рекомендации по геообработке выходных данных шейп-файла.
Параметры
arcpy.stats.DirectionalMean(Input_Feature_Class, Output_Feature_Class, Orientation_Only, {Case_Field})
Имя | Описание | Тип данных |
Input_Feature_Class | Класс объектов, содержащий векторы, для которых будет вычислено среднее направление. | Feature Layer |
Output_Feature_Class | Класс линейных объектов, который будет содержать объекты, представляющие средние направления входного класса объектов. | Feature Class |
Orientation_Only | Указывает, нужно ли включать информацию о направлении (от и до узла) в анализ.
| Boolean |
Case_Field (Дополнительный) | Поле, используемое для группировки объектов для отдельных расчетов среднего направления. Поле группировки должно быть типа целое (integer), дата (date) или текст (string). | Field |
Пример кода
Пример скрипта в окне Python для использования функции LinearDirectionalMean.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.stats.DirectionalMean("AutoTheft_links.shp", "auto_theft_LDM.shp", "DIRECTION")
Следующий автономный 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"
# 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.stats.StandardDistance(locations, standardDistance, "1_STANDARD_DEVIATION")
# Process: Directional Distribution (Standard Deviational Ellipse) of auto
# theft locations...
arcpy.stats.DirectionalDistribution(locations, standardEllipse,
"1_STANDARD_DEVIATION")
# Process: Linear Directional Mean of auto thefts...
arcpy.stats.DirectionalMean(links, linearDirectMean, "DIRECTION")
Параметры среды
Особые случаи
- Выходная система координат
До начала анализа геометрия пространственных объектов проецируется в выходную систему координат. Все математическое вычисления основаны на пространственной привязке выходной системы координат.